# daniely-marcon/ia-2026-02-tp-chatbot architecture

> Architecture diagram of the GitHub repository daniely-marcon/ia-2026-02-tp-chatbot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/daniely-marcon/ia-2026-02-tp-chatbot
- Repository: https://github.com/daniely-marcon/ia-2026-02-tp-chatbot

## Overview

Este repositório é uma base de trabalho para um chatbot universitário que classifica mensagens em etapas e, para intenções do tema, recupera documentos oficiais para embasar respostas. O grupo configura o tema, fornece dados e treina os classificadores; a conversa é então orquestrada pelo grafo, com respostas fixas disponíveis e redação opcional por LLM. Há também geração assistida de frases de treino e avaliação padronizada. As relações de execução refletem os trechos e referências fornecidos; subsistemas não amostrados aparecem apenas onde o README documenta suas capacidades.

Main entry points: [`chatbot/grafo.py`](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py) (Orquestrador), [`chatbot/config.py`](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/config.py) (Configuração), [`chatbot/conhecimento.py`](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/conhecimento.py) (Busca RAG), [`chatbot/avaliacao.py`](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/avaliacao.py) (Métricas padronizadas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversation["Chat e roteamento"]
  node_config["Configuração<br/>[config.py]"]
  node_chatgraph["Orquestrador<br/>[grafo.py]"]
  node_scope["Classificação de escopo<br/>[grafo.py]"]
  node_intent["Classificação de tema<br/>[grafo.py]"]
  node_reply["Respostas e rotas<br/>[grafo.py]"]
  node_llm["Cliente OpenRouter<br/>[llm.py]"]
end

subgraph group_knowledge["Conhecimento e modelos"]
  node_documents["Documentos oficiais"]
  node_rag["Busca RAG<br/>[conhecimento.py]"]
  node_representations["Representações<br/>[representacoes.py]"]
  node_text["Pré-processamento<br/>[texto.py]"]
  node_models[("Classificadores")]
  node_model_io["Contrato de modelos<br/>[modelos.py]"]
end

subgraph group_data["Dados e geração"]
  node_training_data["Dados rotulados"]
  node_data_io["Leitura e validação<br/>[dados.py]"]
  node_generation["Geração de frases<br/>[geracao.py]"]
end

subgraph group_quality["Avaliação"]
  node_evaluation["Métricas padronizadas<br/>[avaliacao.py]"]
  node_eval_data["Dados de teste<br/>[teste.csv]"]
end

node_student(("Estudante"))
node_group(("Grupo de desenvolvimento"))

node_student -->|"envia mensagem"| node_chatgraph
node_config -->|"configura"| node_chatgraph
node_chatgraph -->|"classifica escopo"| node_scope
node_chatgraph -->|"classifica tema"| node_intent
node_chatgraph -->|"encaminha rota"| node_reply
node_chatgraph -->|"busca trechos"| node_rag
node_chatgraph -->|"redige resposta"| node_llm
node_rag -->|"lê documentos"| node_documents
node_rag -->|"usa vetorização"| node_representations
node_representations -->|"usa normalização"| node_text
node_group -->|"prepara exemplos"| node_training_data
node_training_data -->|"carrega e valida"| node_data_io
node_group -->|"treina classificadores"| node_models
node_model_io -->|"salva e carrega"| node_models
node_group -->|"define tema"| node_config
node_config -->|"define base e busca"| node_rag
node_config -->|"define parâmetros"| node_llm
node_group -->|"solicita frases"| node_generation
node_generation -->|"pede frases"| node_llm
node_group -->|"avalia desempenho"| node_evaluation
node_eval_data -->|"fornece teste"| node_evaluation
node_evaluation -->|"invoca conversas"| node_chatgraph
node_model_io -->|"fornece classificadores"| node_chatgraph

click node_config "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/config.py"
click node_chatgraph "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py"
click node_scope "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py"
click node_intent "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py"
click node_reply "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py"
click node_llm "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/llm.py"
click node_documents "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/documentos"
click node_rag "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/conhecimento.py"
click node_representations "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/representacoes.py"
click node_text "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/texto.py"
click node_training_data "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/dados"
click node_data_io "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/dados.py"
click node_models "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/modelos"
click node_model_io "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/modelos.py"
click node_generation "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/geracao.py"
click node_evaluation "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/avaliacao.py"
click node_eval_data "https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/dados/teste.csv"

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_config,node_chatgraph,node_scope,node_intent,node_reply,node_llm toneBlue
class node_documents,node_rag,node_representations,node_text,node_models,node_model_io toneAmber
class node_training_data,node_data_io,node_generation toneMint
class node_evaluation,node_eval_data toneRose
class node_student,node_group toneIndigo
```

## Components

### Chat e roteamento

- [Configuração](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/config.py): `chatbot/config.py`
- [Orquestrador](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py): `chatbot/grafo.py`
- [Classificação de escopo](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py): `chatbot/grafo.py`
- [Classificação de tema](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py): `chatbot/grafo.py`
- [Respostas e rotas](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/grafo.py): `chatbot/grafo.py`
- [Cliente OpenRouter](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/llm.py): `chatbot/llm.py`

### Conhecimento e modelos

- [Documentos oficiais](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/documentos): `documentos`
- [Busca RAG](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/conhecimento.py): `chatbot/conhecimento.py`
- [Representações](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/representacoes.py): `chatbot/representacoes.py`
- [Pré-processamento](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/texto.py): `chatbot/texto.py`
- [Classificadores](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/modelos): `modelos`
- [Contrato de modelos](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/modelos.py): `chatbot/modelos.py`

### Dados e geração

- [Dados rotulados](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/tree/main/dados): `dados`
- [Leitura e validação](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/dados.py): `chatbot/dados.py`
- [Geração de frases](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/geracao.py): `chatbot/geracao.py`

### Avaliação

- [Métricas padronizadas](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/chatbot/avaliacao.py): `chatbot/avaliacao.py`
- [Dados de teste](https://github.com/daniely-marcon/ia-2026-02-tp-chatbot/blob/main/dados/teste.csv): `dados/teste.csv`

### Other components

- **Estudante**
- **Grupo de desenvolvimento**

## Connections

- Estudante → Orquestrador: envia mensagem (evidence: `README.md`)
- Configuração → Orquestrador: configura (evidence: `README.md`)
- Orquestrador → Classificação de escopo: classifica escopo (evidence: `chatbot/grafo.py`)
- Orquestrador → Classificação de tema: classifica tema (evidence: `chatbot/grafo.py`)
- Orquestrador → Respostas e rotas: encaminha rota (evidence: `chatbot/grafo.py`)
- Orquestrador → Busca RAG: busca trechos (evidence: `chatbot/grafo.py`)
- Orquestrador → Cliente OpenRouter: redige resposta (evidence: `chatbot/grafo.py`)
- Busca RAG → Documentos oficiais: lê documentos (evidence: `README.md`)
- Busca RAG → Representações: usa vetorização (evidence: `chatbot/conhecimento.py`)
- Representações → Pré-processamento: usa normalização (evidence: `chatbot/representacoes.py`)
- Grupo de desenvolvimento → Dados rotulados: prepara exemplos (evidence: `README.md`)
- Dados rotulados → Leitura e validação: carrega e valida (evidence: `chatbot/dados.py`)
- Grupo de desenvolvimento → Classificadores: treina classificadores (evidence: `README.md`)
- Contrato de modelos → Classificadores: salva e carrega (evidence: `chatbot/modelos.py`)
- Grupo de desenvolvimento → Configuração: define tema (evidence: `README.md`)
- Configuração → Busca RAG: define base e busca (evidence: `chatbot/conhecimento.py`)
- Configuração → Cliente OpenRouter: define parâmetros (evidence: `chatbot/llm.py`)
- Grupo de desenvolvimento → Geração de frases: solicita frases (evidence: `README.md`)
- Geração de frases → Cliente OpenRouter: pede frases (evidence: `chatbot/geracao.py`)
- Grupo de desenvolvimento → Métricas padronizadas: avalia desempenho (evidence: `README.md`)
- Dados de teste → Métricas padronizadas: fornece teste (evidence: `chatbot/avaliacao.py`)
- Métricas padronizadas → Orquestrador: invoca conversas (evidence: `chatbot/avaliacao.py`)
- Contrato de modelos → Orquestrador: fornece classificadores (evidence: `README.md`)
