Descrição do Projeto:
Estamos migrando nossa operação interna de pedidos - hoje em planilha Excel de 27 abas e robôs Python que sobem vendas para o SIGE Cloud - para um Mini ERP web em Laravel.
Procuramos desenvolvedor(a) Laravel sênior para construir do zero, com codebase no nosso GitHub desde o primeiro commit.
## STACK
Laravel + Blade + MySQL + Tailwind + Vite, em cPanel. Mesmo padrão do nosso Portal Cliente já em produção e do nosso Sistema de Cotação Petronect (em desenvolvimento paralelo, mesmo time técnico). JS moderno (Livewire, Alpine ou Vue). Sistema standalone, com modelo de dados desenhado para integração futura com os demais sistemas FacilitAí sem refatoração.
## NÃO É GREENFIELD
A operação roda há anos via planilha Excel + 2 robôs Python (`registrar_pedidos_V14` e `faturar_pedidos_V8`), com regras de negócio validadas e documentadas. O trabalho é migrar essa lógica para Laravel, não reinventá-la:
- Pipeline completo de venda Petrobras - PO Ariba - registro de venda - controle de itens - fretes - faturamento - pagamento
- Integração SIGE Cloud via API REST (fase 1 do MVP - para emissão de NFe enquanto NFe própria não é desenvolvida)
- Cadastros operacionais: clientes, fornecedores, produtos, vendedores, ~131 unidades Petrobras
- Mapeamento completo de 56 colunas da planilha 2023 para o schema novo, já documentado
- 2 documentos de análise dos robôs Python existentes, com toda a lógica extraída
Documentação no kickoff: Briefing Técnico consolidado + análise técnica dos robôs legados + documento de conhecimento resgatado + planilha original com histórico de pedidos. Você recebe a especificação funcional pronta e executa técnica e arquiteturalmente em Laravel.
## PRINCÍPIO INEGOCIÁVEL - ZERO HARDCODED
Nenhum valor mutável no código. Credenciais (incluindo SIGE) via `.env`; configurações operacionais (CFOPs padrão, NCMs, alíquotas, regras de validação, templates) em tabela editável via painel admin; constantes em `config/*.php`; textos em `lang/pt_BR`. Os robôs legados sofrem desse problema (senha SIGE em texto puro nos executáveis); a reconstrução elimina isso por desenho.
## ESCOPO DO MVP
Autenticação: login (Breeze/Fortify), recuperação por e-mail, política forte, bloqueio por tentativas. Dois níveis fixos (Admin/Operador) por flag, sem tela de gestão de papéis.
Cadastros internos: CRUD de funcionários, configurações operacionais editáveis (credenciais SIGE por empresa criptografadas no banco, CFOPs, NCMs, alíquotas). Tabela `tenant` seeded via migration com as 4 empresas - sem cadastro de empresas via UI.
Logs operacionais com UI: histórico das ações importantes visível no frontend (criação/edição de pedido, envios SIGE, NFes emitidas, erros de integração, uploads), com filtros.
Notificações in-app: sino com contador, destaque para NFe emitida e erros de integração SIGE, link direto ao pedido.
Pipeline operacional:
- Tela principal estilo planilha (substituta da planilha Excel de 27 abas atual): célula editável, navegação por teclado, filtros, copy-paste, frozen columns, export Excel
- Bibliotecas: Tabulator, AG Grid Community, Handsontable ou equivalente
- Tela de detalhe de pedido (drilldown: itens, fretes, NFe, anexos, histórico)
- CRUDs de clientes, fornecedores, produtos, vendedores, unidades Petrobras
- Máquina de estado do pedido (RASCUNHO - PRONTO_PARA_SIGE - ENVIADO_AO_SIGE - FATURADO/CANCELADO)
- Integração SIGE Cloud via HTTP Client Laravel (Guzzle) contra a API REST do SIGE - sem robô Python intermediário. Envio assíncrono via Laravel Queue, consulta periódica de NFes emitidas, captura e armazenamento local de XMLs e PDFs.
- Upload drag-and-drop de novas POs Ariba via planilha (XLSX/XLS/CSV): mapeamento de colunas configurável e persistido, preview antes da gravação, validação linha a linha com relatório de erros, deduplicação por número da PO
- Importação inicial via Artisan dos dados históricos da planilha 2023 (1x no kickoff)
- Anexos de pedido (PDF da PO Ariba, NFes) armazenados localmente - sem Google Drive
Mínimo legal: HTTPS, termos de uso e privacidade no rodapé, rate limiting, backup automático, footer com versão.
Infra: cPanel para o web + VPS auxiliar para Redis/workers. Deploy via GitHub Actions. Repositório privado.
## METODOLOGIA - PAR DE DESENVOLVIMENTO
Não é entrega caixa-preta. Trabalhamos como par técnico: nós com o domínio (operação Petrobras, comportamento dos compradores Ariba, fluxo comercial, regras fiscais com nuances), você com o stack Laravel.
- Reuniões semanais de alinhamento
- Code review conjunto dos PRs
- Testes operacionais conjuntos ao longo do desenvolvimento contra dados reais (planilha 2023 + sandbox SIGE) - parte do processo
- Comunicação técnica clara, sem "caixa preta"
Propriedade do código é nossa desde o primeiro commit.