Skip to content
alauberPublic

About

AI Champion Xperiun

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Solara OS

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, investigador e consolidador estã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.

Documentos de referência

  • 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).

Stack

  • Next.js 16 (App Router) + TypeScript
  • Supabase: Auth (e-mail e senha), Postgres, Realtime
  • @supabase/ssr e @supabase/supabase-js
  • API da Anthropic (SDK oficial, modelo claude-sonnet-4-6), a partir da seção Motor
  • Deploy previsto na Vercel

Pré-requisitos

  • 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 de dados/, quando as seções Vendas e Financeiro forem construídas.

Configuração

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 Motor

Onde 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

Como rodar

npm install
npm run dev

Abra 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 tipos

Como entrar

Não há cadastro público. Para criar o primeiro usuário:

  1. No painel do Supabase, vá em Authentication → Users → Add user.
  2. Informe e-mail e senha e marque a confirmação automática.
  3. 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 /.

Estrutura

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.

Decisões técnicas

  • Cache Components ativo. Por isso a leitura da sessão fica dentro de <Suspense> e começa com await connection(). A sessão depende do momento da requisição, então não é pré-renderizada.
  • Proteção em duas camadas. O proxy.ts só renova o token. O redirecionamento é feito nas próprias páginas, que checam o usuário com supabase.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.

Próximas seções (SPEC)

  1. Casca: tabela perfis, menu de áreas e página /admin para cadastrar usuários.
  2. Motor: função agente(), registro em execucoes_agentes, organograma em tempo real e fila de aprovação.
  3. Vendas: kanban de pedidos de orçamento e orquestrador de Vendas.
  4. Financeiro: importação de extrato, casamento com títulos e relatório de conciliação.

Regras de trabalho

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.

About

AI Champion Xperiun

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages