Diagramas — studyAI

Índice central de todos os diagramas do projeto. Útil para apresentações, onboarding e documentação externa.

---

Índice

1. Visão geral do produto
2. Jornada do utilizador
3. Arquitetura de alto nível
4. Camadas do sistema
5. Grafo de agentes
6. Pipeline RAG
7. Fluxo de chat (QA)
8. Fluxo de geração de conteúdo
9. Fluxo de ingestão
10. Fluxo de avaliação
11. Estados (file, document)
12. Ciclo de vida de jobs
13. Multi-tenant e isolamento
14. Auth flow
15. Deploy produção
16. Modelo de dados (ER)
17. Learning Loop
18. Observabilidade

---

1. Visão geral do produto

Localização: README.md

A carregar diagrama…

---

2. Jornada do utilizador

Localização: README.md, FLOWS.md

A carregar diagrama…

---

3. Arquitetura de alto nível

Localização: ARCHITECTURE.md

A carregar diagrama…

---

4. Camadas do sistema

Localização: ARCHITECTURE.md

Diagrama ASCII detalhado em ARCHITECTURE.md.

---

5. Grafo de agentes

Localização: AGENTS.md, README.md

A carregar diagrama…

---

6. Pipeline RAG

Localização: RAG_DESIGN.md

Retrieval (3 estágios: hybrid + RRF + rerank)

A carregar diagrama…

---

7. Fluxo de chat (QA)

Localização: FLOWS.md

A carregar diagrama…

---

8. Fluxo de geração de conteúdo

Localização: FLOWS.md

A carregar diagrama…

---

9. Fluxo de ingestão

Localização: FLOWS.md

A carregar diagrama…

---

10. Fluxo de avaliação

Localização: FLOWS.md

A carregar diagrama…

---

11. Estados (file, document)

Localização: FLOWS.md

File status

A carregar diagrama…

Document status

A carregar diagrama…

---

12. Ciclo de vida de jobs

Localização: JOBS_ASYNC.md

A carregar diagrama…

Retry e backoff

A carregar diagrama…

---

13. Multi-tenant e isolamento

Localização: SECURITY.md

A carregar diagrama…

Regras:

• Todas as pesquisas vetoriais: project_id = X obrigatório
• Validação de ownership antes de retrieval/index/delete
• Sem partilha de dados entre projetos

---

14. Auth flow

Localização: FLOWS.md, API_SPEC.md

A carregar diagrama…

---

15. Deploy produção

Localização: DEPLOYMENT.md

A carregar diagrama…

---

16. Modelo de dados (ER)

Localização: DATA_MODEL.md

A carregar diagrama…

---

17. Learning Loop

Localização: LEARNING_LOOP.md

A carregar diagrama…

---

18. Observabilidade

Localização: ARCHITECTURE.md

A carregar diagrama…

---

19. Fases e sprints

Localização: ROADMAP.md

A carregar diagrama…

---

20. Controlo de custos

Localização: COST_CONTROL.md

A carregar diagrama…

---

Resumo por documento