Merge pull request #68 from rede5/codex/create-project-plan-for-marketplace-backend

docs: add backend completion plan
This commit is contained in:
Tiago Yamamoto 2026-02-07 08:44:37 -03:00 committed by GitHub
commit 3f3834018c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -52,6 +52,7 @@ SaveInMed é uma solução completa que oferece:
- [Lacunas e requisitos pendentes (Marketplace B2B)](./docs/GAPS_ANALISE_B2B.md)
- [Roadmap de Tasks](./docs/ROADMAP.md)
- [Matriz de Testes](./docs/TESTES.md)
- [Plano de Conclusão do Backend](#-plano-de-conclusão-do-backend)
---
@ -102,6 +103,82 @@ SaveInMed é uma solução completa que oferece:
---
## 🧭 Plano de Conclusão do Backend
Como gerente de projetos, o objetivo é fechar o backend do marketplace B2B garantindo alinhamento com os **3 pilares**: **Escopo**, **Prazo** e **Custo/Recursos**. O plano abaixo é um passo a passo enxuto para execução e acompanhamento.
### ✅ Pilares de Gestão
1. **Escopo (o que será entregue)**
- Funcionalidades mínimas do marketplace B2B: cadastro de empresas/usuários, catálogo, carrinho/pedido, pagamento, logística, e compliance.
- Integrações críticas (Mercado Pago, notificações, webhooks).
- Observabilidade e segurança (logs, auditoria, LGPD).
2. **Prazo (quando será entregue)**
- Trabalhar em **sprints quinzenais** com metas claras.
- Entregas contínuas por módulo para validação antecipada.
3. **Custo/Recursos (quem e quanto)**
- Times mínimos: 1 backend sênior, 1 backend pleno, 1 QA, 1 PO/PM.
- Infra de dev/qa com banco PostgreSQL e serviços externos mockados.
---
### 📌 Passo a Passo (Plano Executivo)
1. **Alinhamento Inicial (Semana 1)**
- Revisar lacunas no documento [GAPS_ANALISE_B2B](./docs/GAPS_ANALISE_B2B.md).
- Definir o **MVP do backend** e critérios de aceite por módulo.
- Atualizar backlog e priorizar dependências críticas.
2. **Base Técnica & Observabilidade (Semana 1-2)**
- Garantir estrutura de projeto, padrões de logging e métricas.
- Definir versionamento de APIs (OpenAPI/Swagger).
- Configurar ambientes (dev/stage) e pipeline CI básico.
3. **Modelagem de Dados & Core Domínio (Semana 2-3)**
- Validar e ajustar schema do banco ([docs/database-schema.md](./docs/database-schema.md)).
- Finalizar entidades core: empresas, usuários, produtos, pedidos.
- Implementar validações de domínio e regras de negócio.
4. **Catálogo & Estoque (Semana 3-4)**
- CRUD de produtos, lotes, validades e preços.
- Regras de disponibilidade e visibilidade por empresa.
5. **Carrinho & Pedido (Semana 4-5)**
- Fluxo completo: carrinho → pedido → status.
- Regras de frete, endereços e múltiplos fornecedores.
6. **Pagamentos & Comissionamento (Semana 5-6)**
- Integração Mercado Pago com split.
- Webhooks, antifraude básico e reconciliação.
7. **Logística & Notificações (Semana 6-7)**
- Integração de tracking, status de entrega.
- Notificações por email e eventos internos.
8. **Segurança & Compliance (Semana 7-8)**
- Revisão de autenticação/autorização.
- Auditoria de ações e políticas LGPD.
9. **Testes & Hardening (Semana 8-9)**
- Cobertura mínima: unit/integration tests.
- Testes de carga nos endpoints críticos.
- Correções finais e documentação.
10. **Go-live Preparação (Semana 9-10)**
- Checklist de release e rollback.
- Monitoramento e plano de suporte pós-lançamento.
---
### 📊 Indicadores de Sucesso (KPIs)
- **Cobertura de testes** mínima (>= 70% endpoints críticos).
- **SLA** de resposta: < 500ms em endpoints principais.
- **Erros críticos** < 1% por release.
- **Tempo de ciclo** por módulo: <= 2 semanas.
## 📦 Componentes do Projeto
### 1. **backend** - API de Alta Performance (Go)