# rgbittencourt/fechamento-portfolio-tedpro architecture

> Architecture diagram of the GitHub repository rgbittencourt/fechamento-portfolio-tedpro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rgbittencourt/fechamento-portfolio-tedpro
- Repository: https://github.com/rgbittencourt/fechamento-portfolio-tedpro

## Overview

O produto fecha o portfólio TEDPRO: o professor seleciona uma turma, reúne as avaliações P1–P6 por estudante, consulta fatos calculados e gera dossiês e relatórios, com uma etapa final opcional de conferência das versões publicadas no Padlet. O grafo destaca as etapas de domínio e as camadas internas de API, análise, IA e persistência. As ligações de módulos seguem as referências e trechos fornecidos; capacidades descritas apenas no README são identificadas por essa evidência.

Main entry points: [`server.js`](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js) (API e fluxo), [`public/app.js`](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/app.js) (App web), [`fatos.js`](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/fatos.js) (Fatos e métricas), [`dados.js`](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/dados.js) (Busca e junção)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interface do professor"]
  node_webapp["App web<br/>[app.js]"]
  node_charts["Gráficos<br/>[graficos.js]"]
  node_ai_selector["Seletor de IA<br/>[seletor-ia.js]"]
end

subgraph group_workflow["Fechamento e análise"]
  node_api["API e fluxo<br/>[server.js]"]
  node_source_config["Ps e rubricas<br/>[fontes.js]"]
  node_rubrics["Critérios de avaliação<br/>[rubricas.json]"]
  node_data_join["Busca e junção<br/>[dados.js]"]
  node_facts["Fatos e métricas<br/>[fatos.js]"]
  node_profiles["Perfis de trajetória<br/>[perfis.js]"]
  node_prompts["Prompts e validação<br/>[prompts.js]"]
  node_ai_layer["Camada de IA<br/>[ia.js]"]
  node_dossier["Dossiê de banca<br/>[server.js]"]
  node_class_report["Relatório da turma<br/>[server.js]"]
end

subgraph group_padlet["Conferência Padlet"]
  node_padlet_input["Links e conteúdo Padlet<br/>[server.js]"]
  node_padlet_check["Leitura e conferência<br/>[padlet.js]"]
  node_final_versions["Versões finais<br/>[padlet.js]"]
end

subgraph group_infra["Dados e persistência"]
  node_source_repos[("Repositórios P1–P6")]
  node_state_store[("Estado do fechamento<br/>[db.js]")]
  node_backup["Backup GitHub<br/>[github-backup.js]"]
end

node_professor(("Professor orientador"))
node_ai_services["OpenAI ou Anthropic"]

node_professor -->|"inicia fechamento"| node_webapp
node_webapp -->|"faz requisições"| node_api
node_ai_selector -.->|"seleciona provedor"| node_api
node_webapp -->|"usa gráficos"| node_charts
node_api -->|"busca e reúne"| node_data_join
node_api -->|"lê e grava"| node_state_store
node_data_join -->|"lê avaliações"| node_source_repos
node_data_join -->|"usa configuração"| node_source_config
node_source_config -->|"carrega critérios"| node_rubrics
node_api -->|"calcula fatos"| node_facts
node_facts -->|"usa Ps e temas"| node_source_config
node_facts -->|"usa guia de perfis"| node_profiles
node_api -->|"prepara análises"| node_prompts
node_prompts -->|"fornece prompts"| node_ai_layer
node_api -->|"solicita geração"| node_ai_layer
node_ai_layer -->|"chama provedor"| node_ai_services
node_api -->|"gera dossiê"| node_dossier
node_api -->|"gera relatório"| node_class_report
node_webapp -->|"envia links"| node_padlet_input
node_api -->|"solicita conferência"| node_padlet_check
node_padlet_check -->|"extrai versões"| node_final_versions
node_padlet_check -->|"compara entregas"| node_facts
node_api -->|"salva resultados"| node_state_store
node_state_store -->|"sincroniza cópia"| node_backup

click node_webapp "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/app.js"
click node_charts "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/graficos.js"
click node_ai_selector "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/seletor-ia.js"
click node_api "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js"
click node_source_config "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/fontes.js"
click node_rubrics "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/rubricas.json"
click node_data_join "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/dados.js"
click node_facts "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/fatos.js"
click node_profiles "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/perfis.js"
click node_prompts "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/prompts.js"
click node_ai_layer "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/ia.js"
click node_dossier "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js"
click node_class_report "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js"
click node_padlet_input "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js"
click node_padlet_check "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/padlet.js"
click node_final_versions "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/padlet.js"
click node_state_store "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/db.js"
click node_backup "https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/github-backup.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_charts,node_ai_selector toneBlue
class node_api,node_source_config,node_rubrics,node_data_join,node_facts,node_profiles,node_prompts,node_ai_layer,node_dossier,node_class_report toneAmber
class node_padlet_input,node_padlet_check,node_final_versions toneMint
class node_source_repos,node_state_store,node_backup toneRose
class node_professor,node_ai_services toneIndigo
```

## Components

### Interface do professor

- [App web](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/app.js): `public/app.js`
- [Gráficos](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/graficos.js): `public/graficos.js`
- [Seletor de IA](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/public/seletor-ia.js): `public/seletor-ia.js`

### Fechamento e análise

- [API e fluxo](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js): `server.js`
- [Ps e rubricas](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/fontes.js): `fontes.js`
- [Critérios de avaliação](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/rubricas.json): `rubricas.json`
- [Busca e junção](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/dados.js): `dados.js`
- [Fatos e métricas](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/fatos.js): `fatos.js`
- [Perfis de trajetória](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/perfis.js): `perfis.js`
- [Prompts e validação](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/prompts.js): `prompts.js`
- [Camada de IA](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/ia.js): `ia.js`
- [Dossiê de banca](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js): `server.js`
- [Relatório da turma](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js): `server.js`

### Conferência Padlet

- [Links e conteúdo Padlet](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/server.js): `server.js`
- [Leitura e conferência](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/padlet.js): `padlet.js`
- [Versões finais](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/padlet.js): `padlet.js`

### Dados e persistência

- **Repositórios P1–P6**
- [Estado do fechamento](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/db.js): `db.js`
- [Backup GitHub](https://github.com/rgbittencourt/fechamento-portfolio-tedpro/blob/main/github-backup.js): `github-backup.js`

### Other components

- **Professor orientador**
- **OpenAI ou Anthropic**

## Connections

- Professor orientador → App web: inicia fechamento (evidence: `README.md`)
- App web → API e fluxo: faz requisições (evidence: `public/app.js`)
- Seletor de IA → API e fluxo: seleciona provedor
- App web → Gráficos: usa gráficos (evidence: `public/app.js`)
- API e fluxo → Busca e junção: busca e reúne (evidence: `server.js`)
- API e fluxo → Estado do fechamento: lê e grava (evidence: `server.js`)
- Busca e junção → Repositórios P1–P6: lê avaliações (evidence: `dados.js`)
- Busca e junção → Ps e rubricas: usa configuração (evidence: `dados.js`)
- Ps e rubricas → Critérios de avaliação: carrega critérios (evidence: `fontes.js`)
- API e fluxo → Fatos e métricas: calcula fatos (evidence: `server.js`)
- Fatos e métricas → Ps e rubricas: usa Ps e temas (evidence: `fatos.js`)
- Fatos e métricas → Perfis de trajetória: usa guia de perfis (evidence: `fatos.js`)
- API e fluxo → Prompts e validação: prepara análises (evidence: `server.js`)
- Prompts e validação → Camada de IA: fornece prompts (evidence: `README.md`)
- API e fluxo → Camada de IA: solicita geração (evidence: `server.js`)
- Camada de IA → OpenAI ou Anthropic: chama provedor (evidence: `ia.js`)
- API e fluxo → Dossiê de banca: gera dossiê (evidence: `README.md`)
- API e fluxo → Relatório da turma: gera relatório (evidence: `README.md`)
- App web → Links e conteúdo Padlet: envia links (evidence: `public/app.js`)
- API e fluxo → Leitura e conferência: solicita conferência (evidence: `server.js`)
- Leitura e conferência → Versões finais: extrai versões (evidence: `padlet.js`)
- Leitura e conferência → Fatos e métricas: compara entregas (evidence: `padlet.js`)
- API e fluxo → Estado do fechamento: salva resultados (evidence: `server.js`)
- Estado do fechamento → Backup GitHub: sincroniza cópia (evidence: `db.js`)
