Pular para conteúdo

Ubiquitous Language

Objetivo

Este documento define a linguagem oficial utilizada em toda a CoreFlow Platform.

Toda documentação, código-fonte, APIs, banco de dados, interfaces e comunicação entre equipes deverão utilizar exatamente esta terminologia.

Não são permitidos sinônimos para conceitos de domínio.


Regras Gerais

Uma palavra representa um único conceito.

Um conceito possui um único nome.

Todo novo termo deverá ser documentado antes de ser utilizado.


Plataforma

Termo Definição
Platform Ecossistema completo da CoreFlow
Product Aplicação construída sobre a plataforma
Core Serviços compartilhados
Module Unidade funcional de um produto
Feature Funcionalidade específica
Service Serviço de domínio
Integration Comunicação com sistemas externos

Organização

Termo Definição
Company Empresa (Tenant)
Branch Filial
Department Departamento
Team Equipe
User Usuário
Role Papel
Permission Permissão

CRM

Termo Definição
Lead Potencial cliente ainda não qualificado
Contact Pessoa vinculada a uma empresa
Account Empresa ou cliente
Opportunity Negociação comercial
Pipeline Fluxo comercial
Stage Etapa do funil
Activity Tarefa, ligação, reunião ou ação registrada

ERP

Termo Definição
Product Produto
Supplier Fornecedor
Purchase Order Pedido de Compra
Sales Order Pedido de Venda
Invoice Nota Fiscal
Warehouse Armazém
Inventory Estoque

Finance

Termo Definição
Payable Conta a Pagar
Receivable Conta a Receber
Cash Flow Fluxo de Caixa
Cost Center Centro de Custo
Financial Transaction Lançamento Financeiro

RH

Termo Definição
Employee Funcionário
Contract Contrato
Payroll Folha
Attendance Ponto
Vacation Férias

Arquitetura

Termo Definição
Entity Entidade
Aggregate Agregado
Value Object Objeto de Valor
Repository Repositório
Domain Service Serviço de Domínio
Domain Event Evento de Domínio

APIs

Termo Definição
Resource Recurso REST
Endpoint URL da API
Request Requisição
Response Resposta
Payload Corpo da mensagem

Inteligência Artificial

Termo Definição
Agent Agente de IA
Prompt Prompt versionado
Context Contexto enviado ao modelo
Tool Ferramenta disponível ao agente
Workflow Fluxo composto por agentes
RAG Recuperação aumentada por geração

Convenções

Sempre utilizar:

  • Company (não Client Company)
  • User (não Operator)
  • Lead (não Prospect)
  • Opportunity (não Deal)
  • Role (não Profile)
  • Permission (não Access)
  • Activity (não Task, quando tratar CRM)

Objetivo Final

Garantir que todos os profissionais, produtos e agentes de IA utilizem exatamente a mesma linguagem de domínio, eliminando ambiguidades e mantendo consistência em toda a CoreFlow Platform.