Konexya
Assistente imobiliário com IA — MVP. Regras do projeto em CLAUDE.md; escopo e plano em docs/.
Rodar localmente
Requer Node 22.
npm install
cp .env.example .env.local # preencha com o projeto Supabase de teste
npm run dev # http://localhost:3000
/referencia — componentes base (não existe em produção)/api/saude — ambiente atual e status da conexão com o Supabase
Verificações
npm run check # lint + typecheck + testes
npm run build
O CI (.github/workflows/ci.yml) roda as mesmas verificações e o build em cada push para main e em cada pull request.
Ambientes
| Ambiente | Vercel | Supabase | NEXT_PUBLIC_APP_ENV |
|---|
| Local | npm run dev | projeto de teste (ou supabase start) | local |
| Teste | Preview (qualquer branch fora da main) | projeto konexya teste | teste |
| Produção | Production (main) | projeto konexya producao | producao |
Configuração inicial (uma vez)
- Supabase: na organização
konexya, dois projetos na região São Paulo: konexya teste e konexya producao. Em ambos: Enable Data API ligado, Automatically expose new tables desligado (cada migração concede o acesso explicitamente) e Enable automatic RLS ligado. Em cada um, copie de Project Settings → API a URL e a publishable key.
- A etiqueta "main · PRODUCTION" que o painel do Supabase mostra é o nome do banco principal de qualquer projeto, não o nosso ambiente. O ambiente é definido pelo projeto (
konexya teste ou konexya producao).
- Vercel: importe este repositório do GitHub. Em Settings → Environment Variables, cadastre:
NEXT_PUBLIC_APP_ENV: teste em Preview, producao em Production.NEXT_PUBLIC_SUPABASE_URL e NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY: valores do projeto de teste em Preview e do projeto de produção em Production.
- Faça um push numa branch e abra
/api/saude no link de Preview: deve responder {"ambiente":"teste","supabase":"ok"}.
As migrações do banco ficam em supabase/migrations. O workflow Banco (.github/workflows/banco.yml) as aplica junto com a configuração de login de supabase/config.toml: no projeto de teste a cada push numa branch de trabalho que mude supabase/, e na produção só no merge para a main. Ele precisa de quatro segredos no GitHub (Settings → Secrets and variables → Actions):
SUPABASE_ACCESS_TOKEN: token pessoal criado em supabase.com → Account → Access Tokens.SUPABASE_DB_PASSWORD_TESTE e SUPABASE_DB_PASSWORD_PRODUCAO: a senha do banco de cada projeto (Database → Settings → Reset database password, se não tiver anotado).RESEND_API_KEY: chave do Resend com permissão de envio no domínio mail.konexya.com.br. O Supabase usa essa chave como SMTP para mandar o código de login (o plano gratuito não aceita o modelo de e-mail com código sem SMTP próprio).
Nenhuma chave vai para o repositório. A lista completa de variáveis, por etapa, está em .env.example.
