6. Versioning e Reprocessamento

---

Estratégia de Versioning

Documentos

SQL

Graph

Índices

Também versionar:

• chunking_version
• embedding_version
• retrieval_view_version

---

Estratégia de Reprocessamento

Full Rebuild

Usar quando:

• Mudaste schema radicalmente
• Mudaste embedding model
• Mudaste chunking logic
• Mudaste canonical schema

Partial Rebuild

Usar quando:

• Mudou só um documento
• Mudaram só algumas rows
• Mudaram só algumas relações

Regra Prática

Preferir incremental sempre que possível, mas com possibilidade de full rebuild controlado.

---

Decisão: Full vs Partial

Mudança detectada
       |
       v
+------+------+
| Qual tipo?  |
+------+------+
       |
       +-- Schema/model/config → Full rebuild
       |
       +-- Um documento → Partial (doc pipeline)
       |
       +-- Linhas SQL → Partial (upsert/SCD)
       |
       +-- Edges → Partial (graph pipeline)

---

Controlo de Versões nos Índices

Quando mudar embedding model:

1. Criar nova coleção ou embedding_version
2. Re-embed total ou progressivo
3. Manter traço de qual versão cada chunk usa