DER Builder — Especificação de Modelagem, Notação de Peter Chen e Sintaxe do Editor

Bem-vindo à documentação oficial do DER Builder. Este documento é a Especificação Técnica e Referência Definitiva da aplicação, cobrindo a teoria dos modelos ER (Entidade-Relacionamento) e EER (ER Estendido), a notação gráfica formal proposta por Peter Chen (1976), a Sintaxe do Editor e o conjunto rigoroso de Regras de Validação implementadas pelo software.

---

📚 Sumário Executivo

1. Visão Geral do Modelo ER / EER
2. Notação Oficial de Peter Chen vs. Sintaxe do DER Builder
3. Entidades
   • 3.1 Entidades Fortes (Regulares)
   • 3.2 Entidades Fracas
   • 3.3 Chaves Primárias e Chaves Compostas
4. Atributos
   • 4.1 Atributos Simples (Atômicos)
   • 4.2 Atributos Compostos (Hierárquicos / Multinível)
   • 4.3 Atributos Multivalorados
   • 4.4 Atributos Derivados
   • 4.5 Atributos de Relacionamento
5. Relacionamentos
   • 5.1 Relacionamentos Binários
   • 5.2 Relacionamentos Recursivos (Auto-relacionamentos e Role Names)
   • 5.3 Relacionamentos Ternários e N-ários
   • 5.4 Cardinalidades em Relacionamentos N-ários
   • 5.5 Relacionamentos Identificadores (Fracos)
6. Restrições Estruturais (Cardinalidade e Participação)
   • 6.1 Cardinalidade Máxima (1 e N)
   • 6.2 Participação Mínima (0 e 1 — Parcial vs. Total)
   • 6.3 Notação de Intervalo Limite (min, max)
   • 6.4 Participação Especificada por Lado do Relacionamento
7. Modelo ER Estendido (EER)
   • 7.1 Especialização vs. Generalização
   • 7.2 Herança de Atributos e Relacionamentos
   • 7.3 Restrição de Disjunção (Disjunta d vs. Sobreposta o)
   • 7.4 Restrição de Completude (Total vs. Parcial)
   • 7.5 Categorias / Uniões (u)
8. Sintaxe e Convenções do DER Builder
9. Regras de Validação Estrutural do Software
10. Regras de Modelagem Conceitual (Entidade Associativa vs. Relacionamento)
11. Exemplos Práticos e Scripts Completos
12. Casos Inválidos e Erros Frequentes
13. Tabela de Compatibilidade com a Notação de Peter Chen
14. Recursos do Parser & Exportador
15. Tipos de Dado e Mapeamento Relacional
16. API Designer (REST, OpenAPI e Mock)
17. Desenvolvimento e Testes

---

1. Visão Geral do Modelo ER / EER

O Modelo Entidade-Relacionamento (DER) foi introduzido por Peter Pin-Shan Chen em seu artigo seminal de 1976 ("The Entity-Relationship Model — Toward a Unified View of Data"). Trata-se de uma modelagem de nível conceitual alta, independente de implementação em bancos de dados relacionais ou NoSQL.

Diferenciação entre ER Clássico e EER

• ER Clássico de Chen: Foca nos conceitos primitivos universais: Entidades (fortes e fracas), Atributos (simples, chave, multivalorados, derivados, compostos), Relacionamentos (binários, n-ários, identificadores), Cardinalidade e Participação.
• EER (Extended Entity-Relationship): Expansão desenvolvida na década de 1980 para incorporar abstrações de Orientação a Objetos: Especialização, Generalização, Herança de Atributos/Relacionamentos, Restrições de Disjunção/Completude e Categorias (Uniões).

---

2. Notação Oficial de Peter Chen vs. Sintaxe do DER Builder

É fundamental distinguir os símbolos gráficos formais da notação Chen das palavras-chave e prefixos textuais criados pelo DER Builder para permitir a geração de diagramas via código.

This is the beginning of the README. Read the rest at the original. Read the full README ↗