/layers-domain
Pressupõe que /layers-intro foi carregado para contexto do framework.
A camada de domínio mapeia o que existe no mundo real, independentemente de qualquer produto: os conceitos, terminologia, processos, relacionamentos e modelos mentais que os usuários trazem consigo. Isto é observação, não design.
Distinção crítica: Não resolva contradições nesta camada. A linguagem de domínio contraditória, confusa e inconsistente são dados — eles sinalizam onde diferentes comunidades de usuários divergiram e onde o produto precisará fazer escolhas deliberadas. A resolução acontece na camada de modelo conceitual.
Decisões que esta camada precisa tomar:
- Quais são os conceitos-chave neste domínio e como eles se relacionam?
- Que linguagem as pessoas usam — e onde essa linguagem conflita ou diverge?
- Onde estão as costuras naturais onde diferentes comunidades usam as mesmas palavras de forma diferente?
- Que eventos e processos estruturam a atividade do domínio ao longo do tempo?
Métodos:
| Método | Quando |
|---|---|
| Mapas conceituais / diagramas de bolhas | O domínio é complexo e mal compreendido. Nós e linhas informais mostram como os conceitos se relacionam sem forçar uma estrutura prematura. |
| Event storming de domínio (Brandolini) | O domínio é intensivo em processos. Comece por coisas significativas que acontecem (passado) — eventos revelam costuras naturais. |
| Entrevistas com especialistas | O conhecimento do domínio vive em pessoas, não em documentos. Conversas revelam conhecimento tácito e terminologia contestada. |
| Análise de documentos e artefatos | O domínio produz artefatos (contratos, formulários, faturas) que revelam estrutura e vocabulário naturais. |
| Análise competitiva | Entrando em um domínio estabelecido. Produtos existentes revelam como outros o modelaram — e onde discordam. |
| Observação (shadowing) | O domínio envolve fluxos de trabalho difíceis de articular. Observar pessoas trabalhando revela o que elas realmente fazem. |
Padrão: mapeamento conceitual e auditoria de terminologia.
Sinais de qualidade — como é o bom resultado:
- Contradições são documentadas, não resolvidas
- Sinônimos são registrados (mesma coisa, nomes diferentes)
- Polissemia é sinalizada (mesmo nome, coisas diferentes em contextos diferentes)
- Contextos delimitados são nomeados onde comunidades usam a linguagem de forma coerente dentro do seu grupo, mas inconsistente entre grupos
- A colheita de substantivos é uma lista bruta completa de candidatos — não filtrada, não pré-organizada em objetos e atributos
Sessão guiada
Diga-me qual domínio você está mapeando e o que sabe sobre ele, ou diga "guia-me" para iniciar uma sessão estruturada.
Pergunte: "Onde devo capturar o trabalho desta sessão?" (veja /layers-intro para opções)
Pergunte: "Você está trabalhando a partir de pesquisa e conhecimento de domínio, ou a partir do que a equipe atualmente acredita sobre o domínio?" Se estiver mapeando crenças, sinalize durante todo o processo que o que está sendo capturado é o modelo da equipe, não necessariamente como os usuários vivenciam o domínio.
Fase 1 — Enquadrar o domínio
- Qual domínio estamos mapeando? (O contexto do mundo real — não o produto.)
- Quem são as pessoas que operam neste domínio? (Papéis, tipos de usuário, stakeholders.)
- O que elas estão tentando realizar, antes do seu produto entrar em cena?
Continue redirecionando para o mundo real se as respostas tenderem para decisões de produto.
Fase 2 — Superficiar os conceitos
"Explique como [domínio] funciona. Quais são as principais coisas, como elas se relacionam, o que acontece?"
Ouça por substantivos (conceitos), verbos (processos) e vocabulário natural. Tome notas de tudo — bruto, sem filtro. Depois, provoque:
- "Como as pessoas realmente chamam essas coisas? Múltiplos nomes para a mesma coisa?"
- "Que regras existem — políticas explícitas ou convenções compreendidas?"
- "O que muda ao longo do tempo? O que tem um ciclo de vida?"
Fase 3 — Mapa conceitual
Construa um mapa conceitual: nós conectados por relacionamentos rotulados. Informal — sem hierarquia ou orientação obrigatória; siga o que parece natural para o domínio. Em Mermaid: graph TD ou graph LR.
Pergunte: "Isso parece com o domínio, ou com um diagrama de banco de dados? O que está faltando ou errado?"
Fase 4 — Auditoria de terminologia
Para cada conceito: todos neste domínio usam esta palavra da mesma forma? Existem outras palavras para a mesma coisa? Esta palavra significa algo diferente em outro contexto?
Documente:
Conceito: [coisa]
Nomes usados: [todas as variantes]
Contexto: [quem usa qual e quando]
Tipo de conflito: sinônimos (mesma coisa, nomes diferentes) / polissemia (mesmo nome, coisas diferentes)
Não escolha um vencedor.
Fase 5 — Contextos delimitados
Observe os conflitos de terminologia: existem comunidades de pessoas que compartilham vocabulário internamente, mas divergem de outros grupos? Nomeie e descreva cada um. Essas costuras importarão quando o modelo conceitual for definido — o produto precisará decidir como navegar ou fazer a ponte entre elas.
Fase 6 — Eventos de domínio (opcional)
Se o domínio for intensivo em processos: "Quais são as coisas significativas que acontecem neste domínio? Nomeie-as no passado."
Liste eventos em uma linha do tempo. Pergunte o que desencadeia cada um e o que acontece como resultado. Objetos com eventos significativos ao redor deles provavelmente precisarão de diagramas de transição de estado na camada de modelo conceitual.
Fase 7 — Colheita de substantivos
Compile todos os substantivos superficiados na sessão. Marque cada um:
- Objeto potencial — significativo independentemente, pode ter atributos e relacionamentos
- Atributo potencial — uma propriedade de outra coisa
- Incerto — precisa de mais reflexão
Não filtre agressivamente. A camada de modelo conceitual faz a triagem.
Conclusão
Produza:
- Mapa conceitual — Mermaid
graph TD - Conflitos de terminologia — variantes de nomes documentadas e contextos delimitados
- Eventos de domínio — se explorados, linha do tempo de eventos-chave
- Colheita de substantivos — lista completa de candidatos
Encerre com: "Este mapa de domínio é matéria-prima para o seu modelo conceitual. Execute /layers-conceptual-model para definir objetos, relacionamentos e vocabulário — a colheita de substantivos é o seu ponto de partida."