🔌 FADAP PROTOCOL — O Motor de Sincronização

O FADAP Protocol (Fastapp Data & Architecture Protocol) rege a sincronia entre as três camadas do sistema: Metadados, Manifesto e Storage.

---

🧩 O Problema das Três Camadas

1. Desejo (Metadata Layer): O JSON editado no Schema Manager (App.objects).
2. Percepção (Manifest Layer): O arquivo estático static-manifest.ts para performance.
3. Realidade (Storage Layer): As tabelas físicas e colunas no PostgreSQL.

O FADAP garante que a Realidade siga o Desejo.

---

🔄 O Ciclo de Sincronização (Fadap Sync)

Sempre que uma mudança estrutural ocorre, o motor executa:

1. Metadados (Desejo - Sovereign Patch): O JSON editado via PATCH /api/app/[id]. É a semente de toda mudança.
2. Manifesto (Percepção - Snapshot Sync): Gerado via POST /api/system/snapshot. O motor bloqueia execuções de DDL se o manifesto não estiver em sincronia.
3. Storage (Realidade - DDL Automation): O motor Nuxt analisa a tabela física e executa migrações (ALTER TABLE). Este passo ocorre automaticamente através da API, nunca manualmente.

[!WARNING]
A Realidade deve sempre seguir o Desejo através da API. Edições manuais no banco ou no manifesto causam "Esquizofrenia de Arquitetura", onde o motor não consegue mais prever o comportamento do dado.

---

🛠️ Heurísticas de Mapeamento (DDL Generator)

O motor traduz tipos de metadados para tipos SQL reais:

Tipo Meta	SQL (Postgres)	Motivo
string, enum	TEXT	Flexibilidade máxima.
number	DOUBLE PRECISION	Precisão decimal.
boolean	BOOLEAN	Nativo.
array / json	JSONB	Performance em dados semi-estruturados.
date / datetime	TIMESTAMP TZ	Melhor prática global.

---

🧬 Ontologia v3 e o FADAP

Com a Ontologia v3, o FADAP sincroniza não apenas campos e tabelas, mas também:

• Semântica de campo (semantic: asset | money | phone): persistida no JSON de objects
• Topologia de módulo (topology: focal | connected): persistida no JSON de modules
• Temporal type (temporal_type: event): persistida para ativar agendas automáticas

[!TIP]
O FADAP garante que as extensões semânticas da Ontologia v3 viagem do Agent → Architect → Snapshot → Motor sem perda de informação. É o protocolo que habilita a Auto-Evolução.

---

"O Protocolo Fadap é a garantia de que o sistema é evoluível sem medo de quebra de banco de dados. Ele é o elo entre a intenção (Agent) e a realidade (Storage)."