CidadeIA — Sistema Operacional Inteligente para Gestão Municipal

Projeto real (Next.js + banco de dados + autenticação), separado do site de vendas. Este é o produto de verdade — login, cadastro de prefeitura, dashboard e IA Central conectada.

Stack

• Next.js 16 (App Router, TypeScript)
• Tailwind CSS v4 — visual alinhado com a marca (creme + verde institucional)
• Drizzle ORM + libSQL (SQLite) — banco local em arquivo, sem precisar instalar servidor de banco. Troca para Turso (libSQL remoto) em produção só mudando uma variável de ambiente — nenhum código muda. (Usamos libSQL em vez de Prisma porque o Prisma precisa baixar um binário de um domínio que pode estar bloqueado em ambientes com rede restrita — libSQL evita esse problema.)
• Autenticação própria: sessão via cookie JWT assinado (jose), senha com hash bcrypt. Sem dependência de serviço de terceiro.
• IA Central: @anthropic-ai/sdk, respondendo com base SOMENTE nos dados reais cadastrados (nunca inventa números).

Como rodar localmente

npm install
cp .env.example .env

Edite o .env:

• AUTH_SECRET: gere com node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
• ANTHROPIC_API_KEY: opcional para rodar o site, mas necessária pra IA Central responder de verdade. Gere em https://console.anthropic.com/settings/keys Sem essa chave, a IA Central mostra uma mensagem explicando que precisa ser configurada — o resto do site funciona normalmente.

Depois:

npx drizzle-kit migrate   # cria as tabelas no banco local.db
npm run dev               # http://localhost:3000

Acesse http://localhost:3000 → você será redirecionado para /login → clique em Cadastrar Prefeitura para criar sua primeira conta.

Estrutura do projeto

src/
├── app/                    # Next.js App Router
│   ├── api/               # API routes (server-side)
│   ├── dashboard/         # Dashboard autenticado
│   ├── login/            # Página de login
│   ├── cadastro/         # Onboarding de prefeituras
│   ├── globals.css       # Estilos globais com Tailwind v4
│   └── layout.tsx        # Layout raiz
├── components/           # Componentes React reutilizáveis
├── db/                  # Schema Drizzle ORM
├── lib/                 # Funções e utilitários
│   ├── sessao.ts       # Gerenciamento de sessão JWT
│   ├── ia.ts           # Integração com IA Anthropic
│   ├── planos.ts       # Lógica de planos e add-ons
│   └── ...             # Outros utilitários
└── proxy.ts            # Middleware de proxy/autenticação

Segurança

• Autenticação: JWT assinado via jose, senhas com hash bcrypt
• Sessões: cookie seguro, httpOnly, sameSite=strict
• CORS: Server Actions limitadas a origens conhecidas
• Headers: Content-Type-Options, X-Frame-Options, etc.
• Banco: SQLite local + Turso (libSQL) em produção

Deploy em produção

1. Banco de dados: crie um banco gratuito em https://turso.tech (libSQL hospedado) e configure DATABASE_URL e DATABASE_AUTH_TOKEN no seu provedor de hospedagem.

2. Variáveis de ambiente em produção:

   • Gere uma AUTH_SECRET segura: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
   • Defina ANTHROPIC_API_KEY se usar IA Central
   • Atualize NEXT_PUBLIC_APP_URL com seu domínio em produção

3. Deploy no Vercel:

   npm i -g vercel
   vercel
   

   Adicione as variáveis no painel do Vercel antes de fazer deploy.

4. Hospedagem: Vercel é o caminho mais simples para Next.js (vercel.com → importar o repositório → configurar as variáveis de ambiente do .env no painel do projeto).

5. Rode npx drizzle-kit migrate apontando pro banco de produção antes do primeiro deploy (ou configure isso como parte do seu processo de build).

O que já está pronto (Fase 1 + Fase 2 + Fase 3)

• Login por CPF/CNPJ + senha (com hash bcrypt)
• Cadastro de prefeitura em 4 etapas (dados → sistemas → plano → maior problema)
• Proteção de rotas /dashboard/* (redireciona pra login se não autenticado)
• Dashboard com saudação dinâmica, indicadores (inserção manual) e alertas
• CRUD de alertas (criar, listar, resolver)
• Página de configurações com dados da prefeitura e status dos sistemas
• IA Central real: chat que responde com base nos dados reais do banco (indicadores, alertas e agora também Saúde/Educação/Obras/ Licitações), nunca inventando números.
• Secretaria da Saúde: unidades de saúde (UBS/posto/hospital/SAMU) + indicadores (tempo de atendimento, médicos ativos, faltas, estoque)
• Secretaria da Educação: escolas + indicadores (frequência, nota média, transporte, professores), com destaque visual pra evasão alta
• Obras: cadastro com progresso atual vs. esperado, status, alerta automático (cálculo simples, não é IA) quando o progresso está muito abaixo do esperado
• Licitações: processos com modalidade, valor, status e observação de risco manual, com destaque para processos sinalizados
• Múltiplos usuários por secretaria: o prefeito (Configurações → Usuários) cria contas de secretário vinculadas a uma secretaria específica. Um secretário só enxerga a própria área — sem acesso ao financeiro geral, outras secretarias, alertas gerais ou configurações. A restrição vale na navegação (proxy.ts) e também na IA Central (o contexto que a IA recebe já vem filtrado pelo cargo de quem pergunta).
• Mapa geográfico de verdade (Saúde, Educação, Obras): usando Leaflet + OpenStreetMap (gratuito, sem chave de API). Cada unidade de saúde, escola e obra pode receber latitude/longitude no cadastro; se tiver coordenadas, aparece como marcador no mapa da secretaria, com popup mostrando nome e detalhes. Itens sem coordenadas continuam listados normalmente, só não aparecem no mapa. Se as imagens do mapa não carregarem (bloqueio de rede/firewall), um aviso explica isso em vez de deixar tudo cinza sem explicação.

O que ainda falta (próximas fases)

• Integrações reais (E-SUS, SIAFI, TCE, Portal da Transparência etc.): todos os dados das secretarias hoje são inseridos manualmente pela prefeitura. Integração de verdade depende de credenciais/API de cada sistema, que só a prefeitura consegue liberar.
• IA preditiva / Gêmeo Digital de verdade: construímos a base honesta disso — histórico real acumulado + calculadora financeira simples (ver item acima). Uma previsão de verdade (ex: "risco de superlotação em 18 dias", "evasão escolar vai aumentar X%") exige um modelo estatístico treinado com meses/anos de dados históricos reais, que este sistema ainda não acumulou. Conforme os indicadores forem sendo atualizados ao longo do tempo pela prefeitura, dá para evoluir isso para projeções estatísticas reais (ex: regressão linear simples sobre a tendência real) — mas ainda não há dados suficientes para isso ter significado.
• Recuperação de senha por e-mail: hoje é só uma tela avisando que não está pronta.
• Geocodificação automática: hoje quem cadastra precisa saber a latitude/longitude manualmente. Um próximo passo natural é converter endereço/bairro em coordenadas automaticamente (ex: via Nominatim, que também é gratuito).

Estrutura do projeto

src/
  app/
    login/            → tela de login + esqueci senha
    cadastro/          → wizard de 4 etapas
    dashboard/
      page.tsx         → Visão Geral
      ia/              → IA Central (chat real)
      alertas/         → CRUD de alertas
      configuracoes/   → dados da prefeitura
      secretarias/     → Saúde, Educação, Obras, Licitações (Fase 3)
  db/
    schema.ts          → todas as tabelas (Drizzle)
  lib/
    sessao.ts          → JWT em cookie httpOnly
    senha.ts           → hash/verificação bcrypt
    documento.ts       → validação de CPF/CNPJ
    ia.ts              → lógica da IA Central (contexto real + chamada à Anthropic)
    dados-prefeitura.ts → funções de leitura do banco
  proxy.ts             → protege rotas /dashboard/* (antigo "middleware")