# Lacunas e requisitos pendentes (Marketplace B2B)

## Status (pronto x faltando)

**Pronto**
- Nenhum item confirmado como concluído nesta análise de lacunas.

**Faltando**
- Itens listados nas seções abaixo.

---


Este documento descreve o que **falta** para cumprir o cenário solicitado:
- **Comprador só descobre o vendedor no final** do fluxo.
- **Taxa invisível de 12%** (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%).

> Observação: a regra atual citada na documentação do backend indica taxa invisível de **12%** para compradores.
> Antes de implementar, alinhar o **modelo final** de taxas (12% buyer fee + 6% seller fee? 12% total? split?).

---

## 1) Backend (Go API)

### 1.1 Regras de negócio / taxas
- [ ] **Definir modelo final de taxas** (12% para comprador, 6% para vendedor):
  - 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.
- [ ] **Normalizar cálculo de preços**:
  - guardar preços **base** (seller price) e **final** (buyer price) com rastreabilidade.
  - garantir que a taxa **não aparece** em payloads do comprador.
- [ ] **Auditoria de taxas**:
  - registrar no pedido: `base_price`, `buyer_fee_rate`, `buyer_fee_amount`, `seller_fee_rate`, `seller_fee_amount`, `payout_amount`.
  - expor esses campos **somente** para backoffice/admin.

### 1.2 Ocultação do vendedor
- [ ] **Mascarar dados do vendedor** nos endpoints públicos do catálogo/pesquisa:
  - retornar apenas atributos neutros (ex.: distância, categoria, SLA, estoque, validade) sem identidade.
- [ ] **Revelar vendedor somente no final**:
  - definir claramente qual evento é “final” (ex.: confirmação do pagamento, confirmação do pedido).
  - criar endpoint específico para **revelação pós-compra**.

### 1.3 Contratos de API
- [ ] **Revisar schemas** do Swagger para refletir:
  - campos mascarados antes da compra;
  - campos completos após compra;
  - campos financeiros internos (somente backoffice/admin).
- [ ] **Versionar mudanças** (ex.: `/api/v1` → `/api/v2` se necessário para evitar breaking change).

### 1.4 Segurança e compliance
- [ ] **Garantir controle de acesso**:
  - comprador não pode inferir vendedor por `id`, `slug` ou dados indiretos.
- [ ] **Logs de auditoria** para preço final vs. preço base.
- [ ] **Testes automatizados** garantindo que vendedor não aparece em respostas pré-compra.

---

## 2) Frontend (Marketplace React)

### 2.1 Ocultação do vendedor no fluxo
- [ ] **Remover nome/identidade do vendedor** das telas de catálogo/listagem/carrinho.
- [ ] **Substituir por informações neutras**:
  - faixa de SLA, localização genérica (ex.: “Região Metropolitana”), disponibilidade, avaliações agregadas.
- [ ] **Bloquear UI que revele vendedor** antes do “evento final”.

### 2.2 Exibição de preços
- [ ] **Mostrar somente preço final** (com taxa invisível aplicada), sem linha de “taxa”.
- [ ] **Texto/tooltip neutro** (ex.: “preço final do produto”).

### 2.3 Ponto de revelação
- [ ] **Tela pós-compra** com dados completos do vendedor.
- [ ] **Estados intermediários** (checkout, pagamento pendente) sem revelar vendedor.

---

## 3) Frontend principal (saveinmed-frontend)

> Se este frontend também for usado por compradores/vendedores finais, as mesmas regras acima precisam ser espelhadas.

- [ ] **Revisar listagens** para garantir que vendedor não aparece antes da compra.
- [ ] **Revisar preços** para exibir apenas valor final (taxa invisível).
- [ ] **Revelação pós-compra** na área de pedidos.

---

## 4) Backoffice (NestJS)

### 4.1 Administração de taxas
- [ ] **Tela e endpoints** para configurar:
  - `buyer_fee_rate` (ex.: 12%).
  - `seller_fee_rate` (ex.: 6%).
- [ ] **Histórico de alterações** e auditoria.

### 4.2 Visibilidade e auditoria
- [ ] **Dashboard financeiro** com:
  - preço base, preço final, taxas, payout do vendedor.
- [ ] **Exportação** para contabilidade (CSV/Excel).

### 4.3 Compliance
- [ ] **Logs de decisão** (por pedido) demonstrando que comprador não viu taxa.

---

## 5) Alinhamentos necessários (negócio + produto)
- [ ] **Definir “momento final”** de revelação do vendedor.
- [ ] **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.