BALCÃO
BALCÃO - OpenAI Hackathon Brasil 2026 O BALCÃO é um agente operacional para pequenos negócios que transforma pedidos em linguagem natural em planos claros, verificáveis e executáveis.
Core trick
Codex turns natural-language orders into a plan, checks inventory deterministically, then creates orders atomically with idempotency after human approval.
Description
BALCÃO - OpenAI Hackathon Brasil 2026
O BALCÃO é um agente operacional para pequenos negócios que transforma pedidos em linguagem natural em planos claros, verificáveis e executáveis.
Nesta demonstração, o Codex interpreta a intenção do usuário e o sistema verifica deterministicamente o estoque antes de qualquer ação. Somente após aprovação humana, o BALCÃO cria o pedido, reserva o estoque e registra a cobrança.
O MVP também bloqueia operações quando não há estoque suficiente e implementa execução atômica e idempotência para evitar ações duplicadas.
Construído do zero durante o período oficial do OpenAI Hackathon Brasil 2026.
Tecnologias principais: Codex, Next.js, TypeScript e Zod.
README excerpt
# BALCÃO ## Built during the hackathon O BALCÃO foi construído do zero durante o período oficial do OpenAI Hackathon Brasil 2026, em 19 de agosto de 2026. - interpretação em linguagem natural com Codex - planejamento estruturado validado com Zod - `check_inventory` - aprovação humana - `create_order` - `reserve_inventory` - `create_payment` - execução atômica - idempotência - bloqueio por estoque insuficiente O histórico de commits documenta o desenvolvimento realizado durante o evento. MVP criado para o OpenAI Hackathon Brasil 2026. O BALCÃO transforma uma solicitação em linguagem natural em um plano operacional revisável e só executa ações que alteram estado depois da aprovação humana. ## Rodar localmente Requisitos: Node.js 20.9 ou superior e npm. ```bash npm install npm run dev ``` Acesse `http://localhost:3000`. No Windows, prepare e autentique uma vez o runtime local do Codex: ```bash npm run codex:setup npm run codex:login ``` Copie `.env.example` para `.env.local` e mantenha `BALCAO_AI_PROVIDER=codex`. Esse modo usa a autenticação local do Codex e não exige `OPENAI_API_KEY`. A chave e `OPENAI_MODEL` ficam disponíveis somente para o provider futuro `openai`. ## Arquitetura mínima - `app/`: interface única do MVP, sem dashboard ou autenticação. - `app/api/plan/`: endpoint de planejamento com o Codex local autenticado. - `app/api/execute/`: execução determinística e idempotente após aprovação. - `lib/domain/`: schemas Zod do plano, aprovação e eventos de ex