Detalha alinhamento inicial e plano de ação B2B

This commit is contained in:
Tiago Yamamoto 2026-02-07 08:49:19 -03:00
parent 3f3834018c
commit a2f4cff567

View file

@ -1,5 +1,7 @@
# Lacunas e requisitos pendentes (Marketplace B2B) # Lacunas e requisitos pendentes (Marketplace B2B)
> **Local do documento:** `docs/GAPS_ANALISE_B2B.md`
## Status (pronto x faltando) ## Status (pronto x faltando)
**Pronto** **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 regra de taxa** (12% buyer + 6% seller ou modelo único).
- [ ] **Definir termos legais** (taxa invisível, transparência fiscal para vendedor). - [ ] **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. - [ ] **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.