Viação Hoffmann — Sistema de Viagens (protótipo)

Site estático (index.html) + API serverless (api/) + Postgres (Neon) na Vercel.

Protótipo demonstrativo. Nenhuma passagem real é emitida e nenhum pagamento é processado. Horários, preços e vagas são ilustrativos.

Arquitetura

• index.html — front-end (HTML/CSS/JS puro, sem build). Fala com a API em /api/*.
• api/index.js — todas as rotas da API (um único handler com roteador interno).
• lib/db.js — conexão Postgres; cria o schema e os dados de exemplo sozinho na primeira requisição.
• lib/crypto.js — criptografia de campos pessoais (AES-256-GCM) e hash cego de e-mail.
• lib/auth.js — sessão por cookie assinado (HttpOnly, SameSite=Lax), hash de códigos, limite de tentativas de login.
• lib/trips.js — regras de viagens, poltronas e horários ilustrativos.
• dev-server.js — servidor local (estáticos + API). tests/api-test.js — testes da API.

Variáveis de ambiente (Vercel → Settings → Environment Variables)

Nome	Para quê
DATABASE_URL	String de conexão do Postgres (Neon).
SESSION_SECRET	Segredo (≥ 32 caracteres) que assina cookies e protege os códigos dos motoristas.
ADMIN_PASSWORD	Senha do administrador. Para trocar, edite a variável e faça redeploy.
DATA_ENCRYPTION_KEY	Chave (≥ 32 caracteres; use 64 hex) que criptografa telefone e e-mail dos candidatos. Guarde uma cópia: sem ela esses dados não podem ser lidos.

O que fica no banco

Reservas (com controle de poltronas no servidor — dois clientes não pegam a mesma poltrona), candidaturas e códigos de motoristas (só o hash do código é guardado, e ele é exibido uma única vez ao aprovar), escalas, solicitações de viagem, status da frota e das viagens.

Segurança

• Telefone e e-mail dos candidatos a motorista são criptografados (AES-256-GCM) antes de ir ao banco; a checagem de e-mail duplicado usa um hash com chave (HMAC). Sem DATA_ENCRYPTION_KEY o servidor recusa novos cadastros em vez de gravar em texto puro. Nome e cidade ficam legíveis.
• Rotas de administrador/motorista exigem sessão válida; revogar um motorista derruba a sessão dele na hora.
• Login com limite de tentativas por IP (8 falhas em 15 min bloqueiam por 15 min).
• Toda escrita exige Content-Type: application/json (proteção CSRF) e valida os dados no servidor.
• Todo texto exibido passa por escape de HTML.
• "Minhas reservas" é por navegador (um identificador aleatório guardado no aparelho), pois não há conta de passageiro.

Rodar localmente

npm install
DATABASE_URL=postgres://usuario@localhost:5432/vh SESSION_SECRET=um-segredo-bem-grande-1234567890 \
ADMIN_PASSWORD=minha-senha DATA_ENCRYPTION_KEY=$(openssl rand -hex 32) node dev-server.js 3000
# testes da API (servidor rodando):
BASE=http://localhost:3000 ADMIN_PASSWORD=minha-senha node tests/api-test.js

Regras de negócio

• Viagens de hoje que já partiram (horário de Brasília) não aparecem na busca e não aceitam reserva; reservas só até 180 dias à frente.
• O passageiro pode cancelar a própria reserva (libera a poltrona) até a saída da viagem.
• O status de uma viagem (Programada/Em andamento/…) vale por dia, já que as viagens são diárias.
• O administrador pode excluir o cadastro de um candidato/motorista (apagamento de dados pessoais).