Sistema operacional interno da Solara Distribuidora (peças e insumos industriais, Betim/MG). Agentes de IA fazem a parte repetitiva de Vendas e Financeiro, e uma pessoa aprova cada resultado antes de ele sair.
Estado atual: Fundação, Casca, Motor, Vendas e Financeiro construídos. Os agentes
triador,pesquisador,redator,revisor,investigadoreconsolidadorestão implementados nas áreas que os usam, mas ainda não foram validados com a API real.
Antes da primeira execução, rode no SQL Editor do Supabase, nesta ordem: supabase/motor.sql, supabase/vendas.sql e supabase/financeiro.sql.
- PRD.md: o problema de negócio e o resultado esperado, em linguagem não técnica.
- SPEC.md: o que construir, tabela por tabela e tela por tela.
- CLAUDE.md: regras de trabalho do projeto (idioma, stack, como os agentes são chamados).
- Next.js 16 (App Router) + TypeScript
- Supabase: Auth (e-mail e senha), Postgres, Realtime
@supabase/ssre@supabase/supabase-js- API da Anthropic (SDK oficial, modelo
claude-sonnet-4-6), a partir da seção Motor - Deploy previsto na Vercel
- Node.js 20 ou superior e npm
- Um projeto no Supabase com:
- Authentication por e-mail e senha habilitado. O cadastro público fica desligado: usuários são criados pelo painel.
- As tabelas do ERP (
clientes,produtos,pedidos_orcamento,titulos_receber,extrato_bancario) importadas dos CSVs dedados/, quando as seções Vendas e Financeiro forem construídas.
Crie o arquivo .env.local na raiz do projeto (ele é ignorado pelo git e nunca deve ser commitado):
NEXT_PUBLIC_SUPABASE_URL=https://<seu-projeto>.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_...
SUPABASE_SECRET_KEY=sb_secret_... # só para rotas de API (service role)
ANTHROPIC_API_KEY=sk-ant-... # usada a partir da seção MotorOnde encontrar: no painel do Supabase, em Project Settings → API Keys.
| Variável | Onde é usada | Exposta no navegador? |
|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
navegador e servidor | sim (é pública por natureza) |
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY |
navegador e servidor | sim, protegida por RLS |
SUPABASE_SECRET_KEY |
lib/supabase/admin.ts, só em rotas de API |
não. Nunca use em componente de cliente |
ANTHROPIC_API_KEY |
lib/agente.ts (seção Motor) |
não |
npm install
npm run devAbra http://localhost:3000. Sem sessão, a página inicial redireciona para /login.
Outros comandos:
npm run build # build de produção (também faz o prerender)
npm start # sobe o build de produção
npm run lint # ESLint
npx tsc --noEmit # checagem de tiposNão há cadastro público. Para criar o primeiro usuário:
- No painel do Supabase, vá em Authentication → Users → Add user.
- Informe e-mail e senha e marque a confirmação automática.
- Entre em http://localhost:3000/login com esse usuário.
Usuários sem sessão que acessam / vão para /login. Quem já está logado e acessa /login vai para /.
app/
layout.tsx layout raiz (idioma pt-BR, título)
page.tsx página inicial protegida (mostra o e-mail do usuário)
login/page.tsx página de login (redireciona quem já está logado)
globals.css estilos simples, com suporte a tema escuro
components/
FormularioLogin.tsx formulário de e-mail e senha (componente de cliente)
lib/supabase/
config.ts leitura e validação das variáveis de ambiente
admin.ts cliente com service role (só para rotas de API)
utils/supabase/
client.ts cliente Supabase para o navegador
server.ts cliente Supabase para Server Components (usa cookies)
middleware.ts renova a sessão a cada requisição
proxy.ts entrada do middleware (no Next 16 o arquivo se chama proxy.ts)
prompts/
vendas/ system prompts: triador, pesquisador, redator, revisor
financeiro/ system prompts: investigador, consolidador, revisor
PRD.md, SPEC.md, CLAUDE.md
Os arquivos de prompts/ já existem, mas ainda não são usados: quem os lê é a função agente(), que será criada na seção Motor.
- Cache Components ativo. Por isso a leitura da sessão fica dentro de
<Suspense>e começa comawait connection(). A sessão depende do momento da requisição, então não é pré-renderizada. - Proteção em duas camadas. O
proxy.tssó renova o token. O redirecionamento é feito nas próprias páginas, que checam o usuário comsupabase.auth.getUser(). - Sem bibliotecas de UI. CSS simples em
app/globals.css, conforme o CLAUDE.md. - Dados do ERP não vão para o repositório. A pasta
dados/tem exportações reais de clientes e do extrato bancário.
- Casca: tabela
perfis, menu de áreas e página/adminpara cadastrar usuários. - Motor: função
agente(), registro emexecucoes_agentes, organograma em tempo real e fila de aprovação. - Vendas: kanban de pedidos de orçamento e orquestrador de Vendas.
- Financeiro: importação de extrato, casamento com títulos e relatório de conciliação.
Definidas em CLAUDE.md. Resumo:
- Nomes de tabelas, colunas, componentes e mensagens em português, sem acentos em identificadores.
- Nomes de agentes exatamente como no SPEC:
triador,pesquisador,redator,revisor,investigador,consolidador. - Toda chamada a modelo passa por
agente(). Limpeza de arquivo e casamento de valores são código, não IA. - Rotas que chamam agentes têm
export const maxDuration = 60.