🚛 PROMPT: Sistema de Controle de Custos - Logística

📋 RESUMO EXECUTIVO (Contexto)

🗄️ DADOS REAIS DO BANCO EXISTENTE REAL

🔧 MELHORIAS SUGERIDAS NO DESIGN E LÓGICA

🏗️ ARQUITETURA

🔒 REPOSITÓRIO GIT SEGURANÇA

git init
git add .
git commit -m "Initial commit - Fase 1"

# Adicionar remote sem credenciais
git remote add origin https://git.xenserver.com.br/[USUARIO]/logistica-controle-custos.git

# Cache de credenciais (pede senha uma vez)
git config --global credential.helper cache
git config --global credential.helper 'cache --timeout=3600'

# Primeiro push (digitar usuário/senha manualmente)
git push -u origin main

# CREDENCIAIS — NUNCA versionar
.env
.env.local
.env.*.local
config/application.yml
config/database.yml
docker-compose.override.yml
*.pem
*.key
*.p12

# Rails
/log/*
/tmp/*
!/log/.keep
!/tmp/.keep
/storage/*
!/storage/.keep
/public/assets
/node_modules
/yarn-error.log
.byebug_history
/config/master.key
/config/credentials/*.key

# Docker
.env.docker

# IDEs
.idea/
.vscode/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

👥 PERFIL DE USUÁRIOS E PERMISSÕES

💰 PILARES DE PREÇO (Configuráveis na tela Configurações)

📐 ESTRUTURA DE TELAS

🔐 TELA DE LOGIN

• Campos: email, senha (admin/gerente/operador)
• Alternativa motorista: PIN de 4 dígitos ou QR Code
• Botão grande "Entrar" com ícone
• Esqueci minha senha → link mágico por email
• Fundo preto, botão laranja, texto branco

🖥️ PAINEL ADMIN / GERENTE / OPERADOR

1. DASHBOARD

• Cards grandes (preto/laranja/branco):
  • 🟠 Entregas OK — total de entregas completed no período
  • ⚫ Pendentes — entregas não consolidadas ainda
  • ⚪ Descontos — total de descontos aplicados
  • 🟠 Bônus — total de bônus concedidos
• Gráfico comparativo: barras lado a lado Estimado (cinza) vs Consolidado (laranja) por operação/route_id
• Lista últimas 5 consolidações com status e link
• Barra de progresso: "% do mês consolidado"
• Atualização em tempo real ao carregar + job de 1h para histórico

2. CONSOLIDAÇÃO

• Lista de consolidações com filtros (nome, período, motorista, status, route_id)
• Botão "Nova Consolidação" → modal:
  • Nome (ex: UBS SUL e LESTE Junho 2026)
  • Período (date range: planned_date)
  • Selecionar Motoristas (multi-select com busca — lista única de driver do banco)
  • Selecionar Rotas/Operações (multi-select de route_id)
• Wizard de Validação (3 passos):
  1. Passo 1: Selecionar motorista da lista (com foto/nome e total de entregas no período)
  2. Passo 2: Classificar entregas com Toggle Switches coloridos:
     • 🟠 Laranja = Entrega Normal (padrão)
     • ⚫ Preto = Desconto
     • ⚪ Branco = Bônus
     • 🟠 Laranja Escuro = Retirada de Equipamento
     + Ações em massa + filtro "não classificadas"
  3. Passo 3: Revisar resumo do motorista → "Próximo Motorista" ou "Finalizar Tudo"
• Barra de progresso: "85% classificado — 340 de 400 entregas"
• Botões: "Salvar Rascunho" | "Finalizar Consolidação" (modal de confirmação)
• Após finalizar: Preview do Holerite em modal HTML → "Gerar PDF"

3. CONFIGURAÇÕES

• Usuários: CRUD de logins com foto, role, status ativo/inativo
• Pilares de Preço: campos editáveis com máscara de moeda (R$), cores da marca
• Notificações: ligar/desligar WhatsApp/email, configurar Twilio
• Geral: nome da empresa, upload de logo, tema padrão
• Auditoria: log de quem criou/editou/finalizou o quê e quando

🛵 PAINEL MOTORISTA

• 2 Cards grandes:
  • 🟠 Valor Estimado (laranja) — cálculo ao vivo: entregas completed × preço_entrega
  • ⚪ Valor Consolidado (branco com borda laranja) — validado pelo operador
• Lista de consolidações em que o motorista aparece (nome, período, valor, botão PDF)
• Botão de tema: ☀️/🌙 no canto superior
• Design mobile-first: cards empilhados, fonte grande (min 18px), botões de dedo (min 48px)
• Fundo preto, cards cinza escuro, destaques em laranja

🗄️ MODELO DE DADOS

-- Já existe no PostgreSQL 15, atualizada a cada 1h
-- Nome: public.db_reem_simplerout_2026
-- Colunas principais usadas pelo sistema:
--   tracking_id (PK lógico)
--   reference_id (número da NF)
--   planned_date (data da entrega)
--   driver (nome do motorista)
--   vehicle (placa/ID veículo)
--   title (descrição da entrega)
--   checkin, checkout (horários reais)
--   status ('completed', 'pending', 'cancelled', etc.)
--   route_id (UUID da operação/rota)
--   contact_name (nome do local: UBS, EMAD, STS, SAD)
--   load, load_2, load_3 (quantidade de cargas)
--   nota_fiscal, relatorio_de_visita (URLs S3)
--   latitude, longitude, checkout_latitude, checkout_longitude

users (id, email, encrypted_password, pin_code, role, nome, telefone, ativo, tema_preferido, created_at, updated_at)
  role: enum [admin, gerente, operador, motorista]
  pin_code: string (4 dígitos, apenas motoristas)

configuracoes (id, chave, valor, descricao, updated_at, updated_by)
  chaves: 'preco_entrega', 'preco_retirada', 'preco_bonus', 'preco_desconto',
         'notificacao_whatsapp', 'notificacao_email', 'empresa_nome'

consolidacoes (id, nome, data_inicio, data_fim, status, valor_total,
               created_by, finalizado_por, finalizado_em, created_at, updated_at, deleted_at)
  status: enum [rascunho, finalizada, arquivada]

consolidacao_motoristas (id, consolidacao_id, motorista_nome, valor_total, created_at, updated_at)
  -- motorista_nome = driver do banco existente

consolidacao_entregas (id, consolidacao_id, tracking_id, motorista_nome,
                       tipo, valor_aplicado, created_at, created_by)
  tipo: enum [entrega_normal, retirada, bonus, desconto]
  -- tracking_id referencia db_reem_simplerout_2026.tracking_id

historico_estimados (id, data_hora, valor_total_estimado, entregas_contadas, created_at)
  -- atualizado a cada 1h pelo job

auditoria_logs (id, user_id, acao, entidade, entidade_id, dados_anteriores, dados_novos, created_at)
  -- log de todas as ações críticas

🐳 DOCKER + CONFIGURAÇÃO (YAML)

# docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports: ["3000:3000"]
    env_file: .env
    environment:
      DATABASE_URL: ${DATABASE_URL}
      DB_HOST: ${DB_HOST}
      DB_PORT: ${DB_PORT}
      DB_NAME: ${DB_NAME}
      DB_USER: ${DB_USER}
      DB_PASSWORD: ${DB_PASSWORD}
      SECRET_KEY_BASE: ${SECRET_KEY_BASE}
      REDIS_URL: ${REDIS_URL}
    volumes: [".:/app"]
    depends_on: [db, redis]
  db:
    image: postgres:15
    environment:
      POSTGRES_DB: ${DB_NAME}
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - "pg_data:/var/lib/postgresql/data"
      # Se o banco existente estiver em outro servidor, remover esta seção
      # e apontar DB_HOST para o servidor correto
  redis:
    image: redis:alpine
volumes:
  pg_data:

# .env (NUNCA versionar — adicionar no .gitignore)
# ================================================
DATABASE_URL="postgresql://user:pass@host:5432/db"
DB_HOST="db"                    # ou IP do servidor PostgreSQL existente
DB_PORT="5432"
DB_NAME="logistica_db"
DB_USER="postgres"
DB_PASSWORD="senha_segura"
SECRET_KEY_BASE="gerar_com_rails_secret"
REDIS_URL="redis://redis:6379/0"

# Twilio (opcional — Fase 8)
TWILIO_ACCOUNT_SID=""
TWILIO_AUTH_TOKEN=""
TWILIO_WHATSAPP_FROM=""

# Configuração do banco existente
DB_EXISTING_TABLE="db_reem_simplerout_2026"
DB_EXISTING_SCHEMA="public"

🎨 DIRETRIZES DE DESIGN (UX para baixo nível tech)

📊 JOB DE ATUALIZAÇÃO ESTIMADA (a cada 1h)

# Gemfile: gem 'whenever', require: false
# config/schedule.rb
every 1.hour do
  runner "HistoricoEstimado.atualizar!"
end

# app/models/historico_estimado.rb
class HistoricoEstimado < ApplicationRecord
  def self.atualizar!
    preco = Configuracao.valor('preco_entrega').to_f
    # Buscar entregas do dia com status 'completed' e checkin IS NOT NULL
    entregas = DbReemSimplerout2026
      .where(status: 'completed')
      .where.not(checkin: nil)
      .where(planned_date: Date.current)
      .count
    total = entregas * preco
    create!(
      data_hora: Time.current,
      valor_total_estimado: total,
      entregas_contadas: entregas
    )
  end
end

# O Dashboard calcula em tempo real na hora do acesso:
# SELECT COUNT(*) FROM db_reem_simplerout_2026
# WHERE status = 'completed' AND checkin IS NOT NULL
# AND planned_date BETWEEN :inicio AND :fim
# O job serve apenas para manter histórico de gráficos.

📄 GERADOR DE PDF (Holerite)

• Cabeçalho: logo da empresa (preto + laranja), nome da consolidação, período, data de geração
• Dados do motorista: nome, período trabalhado, total de entregas
• Corpo: tabela com entregas (data, NF, local/contact_name, tipo, valor unitário, valor total)
• Resumo: total de entregas normais, retiradas, bônus, descontos, valor final a pagar
• Rodapé: "Documento gerado automaticamente em [data]", QR code para validação
• Estilo: limpo, fonte legível, cores preto/laranja/branco

🔧 FASES DE IMPLEMENTAÇÃO (Checkpoint obrigatório ao final de cada uma)

💡 DICAS PARA O CLAUDE (Instruções de Otimização)

📝 EXEMPLO DE COMANDO PARA INICIAR CADA FASE

# No início de cada conversa com o Claude, cole:
"Execute a FASE [NÚMERO] do prompt de Sistema de Controle de Custos Logística.
A fase anterior foi concluída. Aqui está o CHECKPOINT da fase anterior: [COLE AQUI]"

# Comandos Git a cada fase:
git add .
git commit -m "Fase X - [descricao]"
git push origin main