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 problema

A Costa Maritime atende navios em portos brasileiros — cotações chegam por e-mail, viram propostas, propostas aprovadas viram ordens de serviço, e tudo precisa ser faturado. Esse fluxo 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

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

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

Documentos

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

modulo: operacional

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

Contatos

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

modulo: port costs

Port Costs

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

modulo: shipserv

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
  • SendPulse campanhas de prospecção segmentadas
  • AwesomeAPI cotação USD/BRL em tempo real

IA no processo

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

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 permite uma pessoa entregar o 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

Funil de propostas com follow-up automático progressivo e metas acompanhadas ao vivo no dashboard.

Operações

Ordens de serviço tarefa a tarefa, com anexos e status — o kanban substituiu a planilha paralela.

Financeiro

Aprovação de proposta gera PDF e e-mail automaticamente; faturamento rastreado item a item.

Suprimentos

RFQs do ShipServ viram propostas em um clique; custos portuários centralizados e sempre atualizados.

Hoje, mais de seis pessoas usam o sistema todos os dias. Além do CRM, o site institucional da Costa Maritime também foi construído com vibe coding. A presença digital da empresa, de ponta a ponta, saiu do mesmo processo. Ver o site da Costa Maritime (abre em nova aba)

Falar com João