cd ~/

Do papel à produção: o CRM que roda a Costa Maritime

Como uma pessoa construiu em 4 meses, com IA no processo, o sistema que atende comercial, operações, financeiro e suprimentos de uma empresa marítima.

O que é o Costa Maritime Hub

Costa Maritime Hub é o nome que o sistema ganhou dentro da empresa: uma plataforma operacional única onde cotação vira proposta, proposta aprovada vira ordem de serviço e ordem executada vira faturamento.

Nasceu como um CRM de propostas. Antes dele, proposta era montada no Excel, o total do mês era controlado numa conversa fixa do ChatGPT que recebia prints das quotes, e relatório de vendas seguia pelo Teams. Conforme as outras áreas entraram, o CRM virou Hub: hoje é a tela aberta o dia inteiro no comercial, na operação, no financeiro e em suprimentos.

O problema

A Costa Maritime atende navios em portos brasileiros, e todo o caminho da cotação ao faturamento vivia espalhado em planilhas, caixas de entrada e documentos soltos.

Cada área tinha seu pedaço da informação: o comercial não via a execução, a operação não via o que foi vendido, o financeiro cobrava atrás dos dois. Retrabalho, follow-ups perdidos e zero visão de funil.

A solução: 7 módulos, um fluxo

modulo: dashboard
Tela do módulo Dashboard do CRM

Dashboard

Metas mensais ao vivo (MTD), comparativo produtos vs serviços e extração de vendas a partir de um print: a IA lê a imagem e lança os dados.

modulo: propostas
Tela do módulo Propostas do CRM

Propostas

Kanban do rascunho à aprovação, com follow-up progressivo (24h a 30 dias), markups por tipo de cliente e importação colando do Excel.

modulo: documentos
Tela do módulo Documentos do CRM

Documentos

Proposta aprovada dispara a esteira sem toque humano: PDF gerado, arquivado no OneDrive, e-mail ao financeiro e card criado na operação.

modulo: operacional
Tela do módulo Operacional do CRM

Operacional

Kanban de execução com ordens de serviço (fainas) tarefa a tarefa: anexos, tags, controle do que foi executado e do que vai para faturamento.

modulo: contatos
Tela do módulo Contatos do CRM

Contatos

Empresas, contatos e histórico de interações: a base que alimenta propostas e campanhas de prospecção.

modulo: port costs
Tela do módulo Port Costs do CRM

Port Costs

Tabela de custos portuários em duas camadas (serviços e fornecedores), com câmbio USD/BRL atualizado automaticamente.

modulo: shipserv
Tela do módulo ShipServ do CRM

ShipServ

RFQs que chegam por e-mail são monitoradas e viram proposta com um clique: a caixa de entrada deixou de ser gargalo.

Stack e integrações

arquitetura.txt

# decisões

  • Frontend em JavaScript puro, decisão deliberada: zero dependências npm no núcleo, carregamento instantâneo e manutenção simples.
  • Proxy em Node.js faz a ponte segura com a Microsoft Graph API.
  • Supabase (PostgreSQL, região São Paulo) com 23 tabelas e migrações versionadas.
  • Frontend na Vercel, proxy no Railway, deploy contínuo via GitHub.

# integrações

  • Microsoft Graph planilha de IDs no SharePoint, PDFs no OneDrive, e-mails do financeiro e operacional
  • Claude Vision extração de dados de imagens de cotações: print vira registro estruturado
  • ShipServ monitoramento de RFQs via parsing de e-mails
  • E-mail de prospecção campanhas direto pela Azure/Graph via proxy, sem ESP: remetente real, supressão de bounces e relatórios de rotina automáticos
  • AwesomeAPI cotação USD/BRL em tempo real

IA no processo

O sistema foi construído em fases documentadas entre abril e julho de 2026: cada uma com spec, implementação e validação com os usuários.

Vibe coding aqui não é gerar código às cegas: é usar IA para transformar conversa com usuário em spec, spec em tela funcionando, feedback em iteração, tudo no mesmo dia. É o que faz uma pessoa dar conta do que normalmente pediria uma equipe.

  • 28 fases de desenvolvimento em 4 meses
  • ~30 documentos internos de especificação
  • Testes unitários nos fluxos críticos
  • Extração por IA (Claude Vision) embutida no produto final

O que mudou, área por área

Comercial

O funil saiu do Excel: cada proposta tem etapa, follow-up automático e meta acompanhada ao longo do mês.

Operações

A planilha paralela morreu: a operação acompanha as fainas, com anexos e status, num quadro só.

Financeiro

O financeiro parou de cobrar as outras áreas: aprovação entrega PDF e aviso automático, e cada item executado chega pronto pra faturar.

Suprimentos

RFQ vira proposta no mesmo dia, com custos portuários e câmbio atualizados na mesma tela.

Hoje, o Hub concentra comercial, operação, financeiro e suprimentos da Costa num sistema só. E o site institucional saiu do mesmo fluxo de trabalho. Ver o site da Costa Maritime (abre em nova aba)

Falar com João