GLV

README excerpt

# Canal Agente — OpenAI Hackathon Brasil 2026

Fluxo agentic de procurement para transformar uma necessidade em linguagem
natural em sourcing verificável, RFQs reais, propostas comparáveis, aprovação
humana, award e reserva de capacidade.

## Arquitetura integrada

- **Dev 3 — Agent/Buyer Workflow:** interpreta o briefing com Structured
  Outputs da OpenAI (ou interpretador local), esclarece campos bloqueantes,
  aplica elegibilidade, seleciona fornecedores e orquestra o plano.
- **Dev 4 — Execution Workflow:** congela requisitos e policy, entrega RFQs,
  valida propostas, calcula score deterministicamente, registra aprovação,
  award, aceite, reserva e auditoria.
- **Runtime live:** PostgreSQL, estado cifrado, links individuais enviados por
  um operador real e portais server-rendered para fornecedor e aprovador.

No runtime live, `POST /api/v1/procurement-requests/messages` recebe o briefing
com autenticação Bearer. A confirmação do plano executa o sourcing do Dev 3,
cria a rodada no Dev 4 e prepara os links manuais de RFQ de forma idempotente.

## Instalação e validação

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe -m ruff check backend scripts
```

## Desenvolvimento local do fluxo comprador

```powershell
.\.venv\Scripts\python.exe -m uvicorn app.main:app --app-dir backend --reload
```

Abra [http://127.0.0.1:8000](http://127.0.0.1:8000). Por padrão, a
interpr