Descrição do Projeto:
Estamos migrando nossa operação interna de cotações - hoje em planilhas Google + executáveis Python desktop + MySQL - para um sistema web único.
Procuramos desenvolvedor(a) Laravel sênior para construir o sistema do zero, com codebase no nosso GitHub desde o commit inicial.
STACK
Laravel + Blade + MySQL + Tailwind + Vite, em cPanel. Mesmo padrão do nosso Portal Cliente já em produção. JS moderno (Livewire, Alpine ou Vue). Sistema standalone, com modelo de dados desenhado para integração futura sem refatoração.
Não é greenfield
Pipeline operacional roda há anos em Python, com regras validadas. O trabalho é migrar lógica comprovada para Laravel, não inventá-la:
- Envio de e-mails humanizados (composição estocástica, PT/EN, ID único por envio)
- Reconhecimento de respostas (correlação via ID)
- Matching tem/nao tem que cruza descrição do item contra mais de mil regras já refinadas na operação real, retornando família e fornecedores
- Histórico em MySQL com sliding window de 10 cotações por descrição e autopreenchimento
- ~13 mil itens + cadastros disponíveis em CSV/XLSX para importação inicial
Documentação no kickoff: 8 dossiês com modelo de 24 tabelas, 45 regras em pseudo-código, arquitetura, backlog. Você recebe a especificação funcional pronta - executa técnica e arquiteturalmente.
Princípio inegociável - zero hardcoded
Nenhum valor mutável no código. Credenciais via .env, configurações operacionais (SMTP, templates, parâmetros) em tabela editável via painel admin, constantes em config/*.php, textos em lang/pt_BR. O sistema atual sofre exatamente desse problema; a reconstrução elimina 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 e configurações operacionais editáveis. Tabela tenant seeded via migration com as 5 empresas - sem cadastro de empresas via UI.
- Logs operacionais com UI: histórico das ações importantes visível no frontend (envios, respostas, mudanças de status, uploads), com filtros.
- Notificações in-app: sino com contador, destaque para resposta de fornecedor, link direto ao item.
- Pipeline operacional:
- Tela principal estilo planilha (célula editável, navegação por teclado, filtros, copy-paste) - AG Grid, Handsontable, Tabulator ou equivalente
- CRUDs de fornecedores, famílias, regras
- Reimplementação em PHP do matching e do envio humanizado
- Webhook inbound (Postmark, SES ou SendGrid Inbound) substituindo IMAP polling
- Laravel Queue (Redis) para jobs assíncronos
- Importação inicial via Artisan (1x no kickoff)
- Upload recorrente de novas licitações via planilha (XLSX/XLS/CSV) com drag-and-drop: 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 chave natural (processo + item) com opção pular/atualizar/criar
- Interface de fila para microserviços Python futuros (Selenium + extrator NLP) - fora deste contrato
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 (Petronect, regras, operação), você com o stack.
- Reuniões semanais de alinhamento
- Code review conjunto dos PRs
- Testes operacionais conjuntos ao longo do desenvolvimento contra dados reais - parte do processo
- Comunicação técnica clara, sem "caixa preta"
Propriedade do código é nossa desde o primeiro commit.
REQUISITOS
Obrigatórios:
- Laravel sênior (10+), produção
- Blade + JS moderno (Livewire, Alpine ou Vue)
- MySQL com modelagem sólida, índices compostos
- UI estilo planilha (AG Grid, Handsontable, Tabulator ou equivalente) com portfólio comprovado
- Laravel Queue (Redis/database)
- Auth Laravel (Breeze, Fortify ou Sanctum)
- Zero tolerância a hardcoded: domínio de .env, config/*.php, tabelas de configurações
- Git/GitHub avançado, PRs, code review
Diferenciais: webhook inbound de e-mail, PhpSpreadsheet ou equivalente, Tailwind, integração com microserviços externos.
NA SUA PROPOSTA, INCLUA:
- Stack proposto (versão, biblioteca de grid, Livewire vs Alpine vs Vue, provedor de e-mail, parser de planilha) - 2-3 linhas por escolha
- Como você organiza configurações em Laravel (.env, config, banco, lang/pt_BR) - 3-5 linhas
- 2-3 cases reais de Laravel - link de repositório público ou print de painel - preferencialmente com UI tipo planilha ou tabelas dinâmicas
- Disponibilidade semanal e horário para reunião recorrente
- Data de início