diff --git a/docs/GAPS_ANALISE_B2B.md b/docs/GAPS_ANALISE_B2B.md index ab9b354..5895c41 100644 --- a/docs/GAPS_ANALISE_B2B.md +++ b/docs/GAPS_ANALISE_B2B.md @@ -1,5 +1,7 @@ # Lacunas e requisitos pendentes (Marketplace B2B) +> **Local do documento:** `docs/GAPS_ANALISE_B2B.md` + ## Status (pronto x faltando) **Pronto** @@ -107,3 +109,86 @@ Este documento descreve o que **falta** para cumprir o cenário solicitado: - [ ] **Definir regra de taxa** (12% buyer + 6% seller ou modelo único). - [ ] **Definir termos legais** (taxa invisível, transparência fiscal para vendedor). - [ ] **Definir experiência de suporte** (ex.: disputa, devolução) sem expor vendedor antes da compra. + +--- + +## 6) Alinhamento Inicial (Semana 1) — Plano detalhado + +### 6.1 Revisar lacunas no documento +**Objetivo:** validar e ajustar as lacunas descritas neste documento com as áreas de Produto, Negócios e Tech. +**Passos:** +1. **Revisão guiada do cenário**: confirmar com stakeholders o fluxo “comprador só descobre vendedor no final” e a “taxa invisível de 12%”. +2. **Conferir impactos por domínio**: + - Backend: preço final x base, auditoria, controle de acesso. + - Frontend(s): ocultação de vendedor e taxa invisível. + - Backoffice: gestão e auditoria de taxas. +3. **Validar riscos de compliance**: alinhar transparência fiscal para vendedor e registros de auditoria. +4. **Atualizar este documento** com decisões finais. +**Entregáveis da semana:** documento revisado + decisões registradas em seção 5. + +### 6.2 Definir MVP do backend e critérios de aceite por módulo +**Objetivo:** fechar o escopo mínimo do backend para suportar o fluxo B2B sem quebrar o modelo atual. + +#### MVP Backend (escopo mínimo) +1. **Taxas e precificação** + - Configurar taxas (`buyer_fee_rate`, `seller_fee_rate`) via config/DB. + - Calcular preço final (buyer) e payout (seller) com rastreabilidade. +2. **Ocultação do vendedor** + - Listagem e detalhes **sem identificação do vendedor** até o evento final. + - Endpoint pós-compra para revelar vendedor. +3. **Auditoria e segurança** + - Logs de auditoria e campos internos para backoffice/admin. + - Regras de acesso garantindo anonimato pré-compra. +4. **Contratos de API** + - Swagger atualizado com campos pré e pós-compra. + +#### Critérios de aceite por módulo (backend) +**Módulo 1 — Taxas e precificação** +- [ ] Dado um produto, o preço final exibido ao comprador **já inclui** a taxa invisível. +- [ ] Os campos de taxa **não aparecem** para o comprador. +- [ ] A auditoria registra base, taxas e payout do vendedor. + +**Módulo 2 — Ocultação do vendedor** +- [ ] Endpoints de catálogo e carrinho **não retornam** dados identificáveis do vendedor. +- [ ] Existe endpoint de revelação pós-compra com dados completos. +- [ ] Testes confirmam que não há vazamento indireto (id, slug). + +**Módulo 3 — Segurança e controle de acesso** +- [ ] Rotas de auditoria são restritas a admin/backoffice. +- [ ] Logs registram decisões de preço e ocultação. + +**Módulo 4 — Contratos de API** +- [ ] Swagger documenta claramente os campos pré-compra e pós-compra. +- [ ] Versionamento definido caso haja breaking change. + +### 6.3 Atualizar backlog e priorizar dependências críticas +**Objetivo:** ordenar entregas e identificar bloqueios. + +#### Backlog priorizado (ordem de execução) +1. **Definir regra final de taxas (Negócio + Produto)** +2. **Modelo de dados e auditoria (Backend)** +3. **Ocultação do vendedor (Backend + Frontend)** +4. **Endpoint de revelação pós-compra (Backend + Frontend)** +5. **Swagger/contratos e versionamento (Backend)** +6. **Backoffice: gestão de taxas e auditoria (Backoffice)** + +#### Dependências críticas +- **Regra final de taxa** (bloqueia cálculo de preço, auditoria e UI). +- **Definição do evento “final”** (bloqueia endpoint de revelação). +- **Modelo de dados de pedido** com campos de auditoria (bloqueia backoffice). + +--- + +## 7) Plano de ação (resumido) +**Semana 1** +- Validar regras de negócio e evento final. +- Revisar e atualizar este documento. +- Definir MVP backend e critérios de aceite. + +**Semana 2** +- Implementar cálculo de taxas, auditoria e mascaramento. +- Atualizar Swagger e contratos. + +**Semana 3** +- Integração com frontend(s) e backoffice. +- Testes de segurança/anonimato pré-compra.