# DeepScan: Engenharia do Modelo de Negócios e Matemática de Split

O desenvolvimento das futuras integrações (Gateways como Pagar.me Connect, Stripe Split ou Asaas) deve seguir este manifesto matemático estrito implementado a nível de servidor, sem delegar a matemática frágil ao cliente React SPA. O Client envia inputs em Inteiros (Centavos), o server recalcula, confere e autoriza.

## 1. Padrão Monetário: Centavos (Int)
- Na arquitetura do BD do LogiSplit, um produto de `R$ 49,95` será sempre guardado como `4995` (`INT`). NUNCA armazene em Floats no Banco de dados pois perde-se precisão. A formatação para `R$ / , ` ocorre apenas no último milissegundo de renderização React na Tela.

## 2. As 3 Topologias de Links de Pagamento

O Vendedor, via UI, pode escolher os Modos de Frete (Type de Link):
- `NONE` (Produto Virtual ou Retirada Fixa).
- `FIXED` (Preço de frete setado arbitrariamente e fixado no banco pelo Lojista).
- `CEP_DYNAMIC` (O frete não é sabido até que o pagante coloque o destino em um checkout provido, sendo este dinamicamente obtido por uma integração com empresas como Kangu/Correios/ViaCep).

### 2.1 Formulações de Comissionamento e Encargos
A Plataforma LogiSplit deve ser lucrativa. Logo, existe uma *Take Rate* ou *Fee*. Todo Gateway de Pagamento também possui seu Taxa Nominal (ex. `3.99% + R$ 0,39`). O Acordo na LogiSplit é de que o lojista absorve completamente a taxa de uso do Gateway, além da própria Margem base do Logisplit (digamos, `+ 1.00%` fixa).

Aviso Importante: O valor do FRETE é IMUNE a taxas do LogiSplit e deve passar límpido e integral para proteger o modelo do transportador parceiro. A Taxa incide pesando pro Vendedor.

## 3. Matemática Escrita e Receivers
Dado uma variável de Produto `P` e Frete `F` e um Logisplit_Fee `L`

### Venda de Exemplo de Camisa (R$ 100) + Correios Fixo (R$ 20)
- `P` = 10.000 centavos ($100.00)
- `F` =  2.000 centavos ($20.00)
- Total Charged na API Gateway = `P + F` = **12.000 centavos** (Valor cobrado na maquininha web do pagante).

No ato do API Request de Creation Transfer do Stripe:
- **Receiver_Logistica_ID** = `F` = **2.000 centavos** cravados.
- **Receiver_LogiSplitMaster_ID** = `L` % de 10.000 = ($5.00) = **500 centavos**.
- **Receiver_Lojista_ID** = `P - L - GatewayFee_Of_Total` = (100.00 - 5.00 - 5.18 taxado gateway) = **R$ 89,82** (8982 centavos líquidos).

A lógica acima garante que a LogiSplit sempre tenha spread positivo para pagar suas taxas operacionais de Nuvem e lucro gerencial exposto no `/admin`, e blinda o parceiro logístico. O Backend dev deve programar `Receivers Rules` nestes percentuais dinâmicos. 

## 4. Regras de Custódia e Estornos (Chargebacks e Refunds)

**Cenário problemático:** O cliente recebeu a camisa e pediu cancelamento do cartão / alegou Fraude (Chargeback) 3 dias depois. A transportadora JÁ havia feito o serviço.
 - **Ação no Backend Logisplit:** Na chegada do webhook de disputa do gateway, o sistema congela saldos do Lojista (pois originou o dano). O Transportador parceiro **mantém** o frete recebido no balance blindado, pois cumpriu a corrida real física. 
 - **Conclusão de Estado Logístico:** O risco da transação online cai para a empresa Lojista original da transação, mantendo a honra sistêmica dos hubs logísticos, incentivando a adoção ao App.