Gerador de Diagrama de Banco de Dados D2 para EF Core

Quando Usar

Use esta habilidade quando o usuário quiser gerar um diagrama de banco de dados / ERD a partir de um codebase do Entity Framework Core.

Solicitações típicas:

• Gerar um diagrama de banco de dados D2 a partir de entidades EF Core.
• Visualizar tabelas, colunas, chaves primárias, chaves estrangeiras e relacionamentos.
• Analisar DbContext, DbSet<T>, IEntityTypeConfiguration<T>, Fluent API e migrações.
• Produzir um arquivo .d2 renderizável para SVG/PNG com a CLI d2.
• Documentar o modelo de banco de dados de um projeto ASP.NET Core / .NET.

Objetivo

Criar um diagrama de relacionamento de entidade D2 legível que reflita o modelo de persistência EF Core real, não apenas a forma bruta da classe C#.

O diagrama deve priorizar:

1. Tabelas e relacionamentos do banco de dados.
2. Chaves primárias, chaves estrangeiras, colunas obrigatórias/opcionais.
3. Tipos possuídos (owned types) e objetos de valor (value objects).
4. Relacionamentos muitos-para-muitos e tabelas de junção.
5. Índices, restrições únicas e nomes de tabelas.
6. Convenções do EF Core apenas quando o mapeamento explícito estiver ausente.

A saída é código fonte .d2. Ele pode ser renderizado para SVG ou PNG através da CLI d2.

Ferramentas

• CLI d2: renderiza arquivos .d2 para SVG/PNG.
  • d2 input.d2 output.svg
  • d2 --layout=elk input.d2 output.svg
• d2 fmt: formata arquivos D2.
  • d2 fmt input.d2
• Nenhum servidor MCP é necessário. A habilidade gera código fonte D2 como texto.

Fluxo de Trabalho Recomendado

1. Leia a estrutura do projeto EF Core.
2. Localize todas as classes DbContext.
3. Localize todas as declarações DbSet<T>.
4. Localize classes de entidade, tipos possuídos, tipos enum e objetos de valor.
5. Leia OnModelCreating e todas as classes IEntityTypeConfiguration<T>.
6. Leia as migrações quando disponíveis para confirmar nomes de tabelas, tabelas de junção, índices e comportamentos de exclusão.
7. Construa um modelo de banco de dados normalizado antes de escrever D2.
8. Faça o questionário obrigatório do diagrama antes da geração.
9. Gere o arquivo .d2 usando o modelo de banco de dados, não o aninhamento bruto de classes.
10. Valide a sintaxe D2 com d2 fmt antes da entrega.
11. Renderize com d2 --layout=elk schema.d2 schema.svg quando possível.
12. Se estiver regenerando, releia primeiro os mapeamentos e migrações do EF Core.

Perguntas Obrigatórias Antes da Geração do Diagrama

Faça estas perguntas para cada novo diagrama e cada regeneração, a menos que o usuário já as tenha respondido na mesma solicitação.

1. Which DbContext should be diagrammed? (auto-detect/all/specific name)
2. Display columns? (all/key-only/none)
3. Display column types? (Yes/No)
4. Display nullable/required markers? (Yes/No)
5. Display indexes and unique constraints? (Yes/No)
6. Display enum values? (Yes/No)
7. Display owned types? (inline/separate/hide)
8. Display many-to-many join tables? (explicit/compact/hide)
9. Display audit/technical tables? (Yes/No)
10. Display migration-only tables not present as entities? (Yes/No)
11. Which grouping mode? (bounded-context/schema/namespace/flat)
12. Which layout engine? (elk/dagre/tala)
13. Which output format? (d2/svg/png)

Valores padrão, quando o usuário pede uma geração rápida:

• DbContext: auto-detect
• Colunas: key-only
• Tipos de coluna: Yes
• Marcadores de nulidade: Yes
• Índices: Yes
• Enums: No
• Tipos possuídos: inline
• Tabelas de junção: explicit
• Tabelas de auditoria/técnicas: No
• Tabelas apenas de migração: Yes
• Agrupamento: bounded-context
• Layout: elk
• Saída: d2

Documentos de Referência

Carregue estes sob demanda quando necessário:

Regras de Extração do EF Core

Prioridade da Fonte

Use esta ordem de prioridade quando as fontes discordarem:

1. Última migração aplicada / snapshot de migração.
2. Configuração da Fluent API em OnModelCreating ou IEntityTypeConfiguration<T>.
3. Data annotations.
4. Convenções do EF Core.
5. Forma bruta da classe C#.

Conceitos Essenciais do EF Core a Detectar

Detecte e represente:

• DbContext e DbSet<T>.
• Nomes de classes de entidade e nomes reais de tabelas de ToTable.
• Nomes de schema de ToTable("Table", "schema").
• Chaves primárias de HasKey, [Key], convenções e migrações.

…