Atualizar taxas e plano de go-live B2B

This commit is contained in:
Tiago Yamamoto 2026-02-07 09:06:34 -03:00
parent b93e897cb2
commit cc439831d1

View file

@ -15,18 +15,18 @@
Este documento descreve o que **falta** para cumprir o cenário solicitado: Este documento descreve o que **falta** para cumprir o cenário solicitado:
- **Comprador só descobre o vendedor no final** do fluxo. - **Comprador só descobre o vendedor no final** do fluxo.
- **Taxa invisível de 12%** (não pode ser mostrada ao comprador). - **Taxa invisível de 6%** (não pode ser mostrada ao comprador).
- **Comissão do vendedor de 6%** (sugestão do usuário: “vai ficar 6% para vendedor”; confirmar regra de negócio e origem dos 6%). - **Comissão do vendedor de 6%** (conforme documentação atual do backend; confirmar regra de negócio se houver mudança).
> Observação: a regra atual citada na documentação do backend indica taxa invisível de **12%** para compradores. > Observação: a regra atual citada na documentação do backend indica taxa invisível de **6%** para compradores.
> Antes de implementar, alinhar o **modelo final** de taxas (12% buyer fee + 6% seller fee? 12% total? split?). > Antes de implementar, alinhar o **modelo final** de taxas (6% buyer fee + 6% seller fee? modelo único? split?).
--- ---
## 1) Backend (Go API) ## 1) Backend (Go API)
### 1.1 Regras de negócio / taxas ### 1.1 Regras de negócio / taxas
- [ ] **Definir modelo final de taxas** (12% para comprador, 6% para vendedor): - [ ] **Definir modelo final de taxas** (6% para comprador, 6% para vendedor):
- esclarecer se são **duas taxas distintas** ou **partes de uma taxa total**. - esclarecer se são **duas taxas distintas** ou **partes de uma taxa total**.
- documentar em `config` (ex.: `BUYER_FEE_RATE`, `SELLER_FEE_RATE`) e no Swagger. - documentar em `config` (ex.: `BUYER_FEE_RATE`, `SELLER_FEE_RATE`) e no Swagger.
- [ ] **Normalizar cálculo de preços**: - [ ] **Normalizar cálculo de preços**:
@ -90,7 +90,7 @@ Este documento descreve o que **falta** para cumprir o cenário solicitado:
### 4.1 Administração de taxas ### 4.1 Administração de taxas
- [ ] **Tela e endpoints** para configurar: - [ ] **Tela e endpoints** para configurar:
- `buyer_fee_rate` (ex.: 12%). - `buyer_fee_rate` (ex.: 6%).
- `seller_fee_rate` (ex.: 6%). - `seller_fee_rate` (ex.: 6%).
- [ ] **Histórico de alterações** e auditoria. - [ ] **Histórico de alterações** e auditoria.
@ -106,7 +106,7 @@ Este documento descreve o que **falta** para cumprir o cenário solicitado:
## 5) Alinhamentos necessários (negócio + produto) ## 5) Alinhamentos necessários (negócio + produto)
- [ ] **Definir “momento final”** de revelação do vendedor. - [ ] **Definir “momento final”** de revelação do vendedor.
- [ ] **Definir regra de taxa** (12% buyer + 6% seller ou modelo único). - [ ] **Definir regra de taxa** (6% 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.
@ -117,7 +117,7 @@ Este documento descreve o que **falta** para cumprir o cenário solicitado:
### 6.1 Revisar lacunas no documento ### 6.1 Revisar lacunas no documento
**Objetivo:** validar e ajustar as lacunas descritas neste documento com as áreas de Produto, Negócios e Tech. **Objetivo:** validar e ajustar as lacunas descritas neste documento com as áreas de Produto, Negócios e Tech.
**Passos:** **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%”. 1. **Revisão guiada do cenário**: confirmar com stakeholders o fluxo “comprador só descobre vendedor no final” e a “taxa invisível de 6%”.
2. **Conferir impactos por domínio**: 2. **Conferir impactos por domínio**:
- Backend: preço final x base, auditoria, controle de acesso. - Backend: preço final x base, auditoria, controle de acesso.
- Frontend(s): ocultação de vendedor e taxa invisível. - Frontend(s): ocultação de vendedor e taxa invisível.
@ -192,3 +192,32 @@ Este documento descreve o que **falta** para cumprir o cenário solicitado:
**Semana 3** **Semana 3**
- Integração com frontend(s) e backoffice. - Integração com frontend(s) e backoffice.
- Testes de segurança/anonimato pré-compra. - Testes de segurança/anonimato pré-compra.
---
## 8) Plano de ação para colocar no ar (go-live)
**Objetivo:** preparar o rollout do fluxo B2B com taxas corretas (6% buyer + 6% seller), anonimato pré-compra e auditoria.
### 8.1 Pré-lançamento (D-7 a D-1)
1. **Confirmar taxas finais** com Negócio/Produto e alinhar comunicação interna.
2. **Validar ambiente**:
- Variáveis `BUYER_FEE_RATE=0.06` e `SELLER_FEE_RATE=0.06` aplicadas no backend.
- Backoffice com auditoria habilitada e acesso restrito.
3. **Teste completo do fluxo**:
- Simular compra ponta-a-ponta com vendedor oculto até o evento final.
- Conferir cálculo: preço base → preço final → payout.
4. **Checklist de UX/Legal**:
- Comprador não vê taxa explícita.
- Vendedor recebe transparência fiscal e extrato de taxas.
### 8.2 Lançamento (D0)
1. **Deploy coordenado** (backend → frontend(s) → backoffice).
2. **Monitoramento em tempo real**:
- Logs de auditoria (base/fee/payout).
- Alertas de divergência de cálculo.
3. **Canal de suporte ativo** para incidentes (pagamento, identidade de vendedor, cálculo de taxas).
### 8.3 Pós-lançamento (D+1 a D+7)
1. **Auditoria de pedidos** para validar 100% dos cálculos.
2. **Coleta de feedback** de compradores e vendedores (anonimato e transparência).
3. **Ajustes rápidos** em contratos, UI e regras de negócio conforme necessidade.