Descrição do Projeto:
Já temos 14 telas em HTML (layouts prontos, interligados) de um sistema web para transportadora. Precisamos finalizar o produto: deixá-lo responsivo, implementar validações, integrar com o backend (ou ajustar o backend existente), criar banco de dados e publicar em ambiente de produção com documentação e testes básicos.
Objetivo
Entregar um MVP estável e utilizável do sistema, com as 14 telas funcionando ponta a ponta (CRUDs, autenticação, relatórios básicos, permissões de usuário e fluxo operacional da transportadora) e deploy realizado.
Escopo (o que precisa ser feito)
Revisão e refino do Front-end:
• Tornar as 14 telas responsivas (mobile/desktop) e acessíveis (boas práticas ARIA).
• Padronização de componentes (botões, inputs, tabelas, modais, toasts) e tema (tipografia, cores, espaçamentos).
• Validações de formulário: máscaras, required, tipos, feedback de erro.
• Melhorias de UX (loading states, paginação, ordenação, busca, filtros).
Arquitetura e Back-end:
• Implementar (ou ajustar) API REST com autenticação (JWT/session) e controle de acesso (Admin, Empresa, Transportadora, Motorista).
• Modelagem e criação do banco de dados (PostgreSQL/MySQL) com migrações e seed inicial.
• Endpoints para os módulos abaixo (mínimo):
• Autenticação e Perfis: login, recuperação de senha, convite/ativação.
• Cadastro de Fretes: criação, edição, status (aberto, em coleta, em trânsito, entregue), anexos (CT-e/romaneio).
• Motoristas e Veículos: CNH, documentos, tipos de veículo/conjunto, disponibilidade.
• Agendamento/YMS (janelas): docas, horários, check-in/check-out.
• Transportadoras/Clientes: dados cadastrais, tabela de preços, contatos.
• Rastreamento básico: status, timeline, ocorrências.
• Relatórios simples: fretes por período, SLA de janelas, ranking de ocorrências (CSV/PDF).
Integração do Front com a API:
• Consumir endpoints (fetch/axios), tratar erros e sessões expiradas.
• Upload e download de arquivos (com limite e checagem de tipo).
Qualidade, Segurança e LGPD:
• Política de senhas, logs de auditoria simples (quem criou/editou).
• Sanitização de entradas, CORS, rate limit básico.
• Termos de uso/privacidade (template) e segregação de dados entre contas.
DevOps e Deploy:
• Dockerfile + docker-compose.
• Deploy (Render/Vercel/Netlify + Railway/Neon/AWS/RDS) ou servidor indicado pelo contratante.
• Integração Contínua (GitHub Actions) para build/test/lint.
Documentação & Handover:
• README de setup, .env.example, scripts de migração.
• Swagger/OpenAPI da API.
• Guia rápido de uso (PDF/MD) e vídeo curto de walkthrough (opcional).
O que já temos:
• 14 telas HTML puras (sem framework) interligadas.
• Fluxo esperado do usuário (rascunho) e nomenclatura de campos.
• Identidade visual básica (pode ser aprimorada).
Entregáveis:
• 14 telas finalizadas e responsivas, consumindo API real.
• API funcional com autenticação, módulos listados e banco provisionado.
• Scripts de migração + seed.
• Testes básicos (Jest para serviços, testes de fluxo crítico; opcional e2e com Cypress/Playwright).
• Documentação (README + Swagger) e deploy online do MVP.
Critérios de Aceite (exemplos):
• Login/Logout: expira sessão inativa, remember-me opcional.
• Cadastro de Frete: cria/edita/exclui; valida campos obrigatórios; anexa PDF/JPG até 5MB; timeline de status.
• YMS: impede overbooking de doca/horário; permite reagendamento; exporta CSV.
• Relatórios: filtro por período e status; exporta CSV; paginação.
• Responsividade: largura 360px a 1440px sem quebra.
Stack (sugestão; aberta a propostas):
• Front: manter HTML/CSS/JS, com componentização leve ou adaptação para React/Vue sem reescrever do zero (progressive enhancement). Build com Vite.
• Back: Node.js (NestJS/Express) + PostgreSQL + Prisma.
• Autenticação: JWT + refresh token, cookies httpOnly.
• Docs: Swagger (OpenAPI).
• DevOps: Docker, GitHub Actions, Deploy em Render/Vercel + Neon/Railway.
Se o proponente preferir outra stack (Laravel, Django, .NET), justificar benefícios e impacto no prazo.
Prazo:
Estimado: 4–6 semanas para MVP completo (com marcos abaixo). Aberto a negociação conforme proposta.
Marcos de Entrega:
• M1 – Diagnóstico & Plano (20%): revisão das 14 telas, arquitetura e cronograma.
• M2 – Front responsivo & componentes (15%).
• M3 – API + BD (25%): autenticação, cadastros base.
• M4 – Integrações & fluxos críticos (20%): frete, YMS, ocorrências.
• M5 – QA, Documentação & Deploy (20%).
Orçamento:
Faixa: R$ 6.000 a R$ 14.000 (PJ) conforme escopo final, stack e nível de automação de testes/DevOps. Propostas fora da faixa serão consideradas com justificativa.
Requisitos do(a) Freelancer:
• Portfólio comprovando SaaS ou sistemas web B2B com login/CRUD/report.
• Experiência com autenticação, RBAC e boas práticas de segurança.
• Vivência com deploy e banco de dados relacional.
• Boa comunicação e disponibilidade para alinhamentos curtos (assíncronos) 2–3x/semana.
Diferenciais:
• Experiência prévia com logística/transportes/YMS.
• Implementação de testes e2e e monitoramento (Sentry/Healthchecks).
• Noções de LGPD e auditoria.