Enhance orchestration, refactor chat interface, and improve tests

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest pytest-cov
+
+      - name: Run tests with coverage gate
+        run: pytest

.gitignore

@@ -102,6 +102,7 @@ ipython_config.py
 #   commonly ignored for libraries.
 #   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
 *.lock
+!uv.lock
 
 # pdm
 #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.

Dockerfile

@@ -4,13 +4,14 @@ ENV PYTHONUNBUFFERED=1 \
     PORT=8080 \
     HOST=0.0.0.0 \
     SERVER_PORT=3000 \
-    SERVER_HOST=0.0.0.0
+    SERVER_HOST=0.0.0.0 \
+    UV_PROJECT_ENVIRONMENT=/usr/local
 
 WORKDIR /app
 
-COPY requirements.txt requirements.txt
-RUN pip install --upgrade pip \
-    && pip install --no-cache-dir -r requirements.txt
+COPY pyproject.toml uv.lock ./
+RUN pip install --no-cache-dir uv \
+    && uv sync --frozen --no-dev --no-install-project
 
 COPY . .
 

README.md

@@ -10,12 +10,18 @@ Este projeto é um chat em tempo real desenvolvido em Python utilizando a biblio
 ---
 
 ## Requisitos
-Antes de executar o projeto, certifique-se de ter o Python instalado e instale as dependências necessárias:
+Antes de executar o projeto, certifique-se de ter o Python e o [uv](https://docs.astral.sh/uv/) instalados, então sincronize as dependências definidas no `pyproject.toml` (fonte única de verdade):
 
 ```bash
-pip install -r requirements.txt
+uv sync --frozen
 ```
 
+> Se precisar de `requirements.txt` para algum ambiente de deploy legado, gere automaticamente a partir do lockfile:
+>
+> ```bash
+> uv export --frozen --no-dev --format requirements-txt -o requirements.txt
+> ```
+
 ## Como Executar
 ### Iniciar o Chat
 Para iniciar a interface do chat, execute o seguinte comando:
@@ -46,3 +52,14 @@ Isso disponibilizará os arquivos compartilhados no chat através de um endpoint
 - **Flet**: Framework para construção da interface gráfica
 - **Uvicorn**: Servidor ASGI para disponibilizar os arquivos compartilhados
 - **OpenAI API**: Para responder mensagens com o assistente virtual
+
+## Documentação
+- Índice geral: [`docs/README.md`](docs/README.md)
+- Domínios:
+  - [Architecture](docs/architecture/README.md)
+  - [Agents](docs/agents/README.md)
+  - [Tasks](docs/tasks/README.md)
+  - [Testing](docs/testing/README.md)
+  - [Decisions](docs/decisions/README.md)
+  - [Recommendations](docs/recommendations/README.md)
+  - [Evidence](docs/evidence/README.md)

docs/README.md

@@ -0,0 +1,51 @@
+# Documentação por Domínio
+
+Este diretório organiza a documentação do projeto por domínio, com índices navegáveis, templates reutilizáveis e versionamento semântico de documentos.
+
+## Índices por domínio
+
+- [Architecture](architecture/README.md)
+- [Agents](agents/README.md)
+- [Tasks](tasks/README.md)
+- [Testing](testing/README.md)
+- [Decisions](decisions/README.md)
+- [Recommendations](recommendations/README.md)
+- [Evidence](evidence/README.md)
+
+## Templates mínimos
+
+- [ADR template](templates/adr-template.md)
+- [Task spec template](templates/task-spec-template.md)
+- [Evidence template](templates/evidence-template.md)
+- [Test plan template](templates/test-plan-template.md)
+
+## Convenções de versionamento semântico de documentos
+
+Todos os documentos em `docs/` devem incluir metadados no topo com o campo `doc_version` no formato SemVer (`MAJOR.MINOR.PATCH`).
+
+### Regras
+
+- **MAJOR**: mudanças incompatíveis (estrutura, significado, ou contratos documentais).
+- **MINOR**: adição de conteúdo retrocompatível (novas seções, exemplos ou critérios).
+- **PATCH**: ajustes editoriais, correções de links, ortografia e clarificações sem alteração de intenção.
+
+### Metadados recomendados
+
+```yaml
+---
+title: Nome do Documento
+doc_version: 1.0.0
+status: draft | active | deprecated
+owners:
+  - @time-ou-pessoa
+last_updated: YYYY-MM-DD
+---
+```
+
+## Convenções de nomenclatura
+
+- Preferir nomes em `kebab-case` para arquivos.
+- Para ADRs: `ADR-XXXX-titulo-curto.md`.
+- Para tarefas: `TASK-XXXX-titulo-curto.md`.
+- Para evidências: `EVID-XXXX-titulo-curto.md`.
+- Para planos de teste: `TESTPLAN-XXXX-titulo-curto.md`.

docs/agents/README.md

@@ -0,0 +1,11 @@
+# Agents
+
+## Objetivo
+Documentar comportamento, responsabilidades e contratos de assistentes/agentes no projeto.
+
+## Conteúdo
+- Definições de papéis de agentes.
+- Fluxos de interação e limites de responsabilidade.
+
+## Navegação
+- Voltar para o [índice de documentação](../README.md).