# Fluxo financeiro solidário — Juntos pelo Limber

## Contexto aprovado
- Campanha única de ajuda para Limber Arizaca Mena, residente na Bolívia.
- Meta pública inicial: R$ 5.000.
- Recebimento previsto em conta pessoal brasileira do organizador.
- Uma transferência internacional ao beneficiário após o encerramento.
- Doadores anônimos publicamente; identidade e dados financeiros não devem ser publicados.

## Gate obrigatório antes de ativar pagamentos
Não ativar cobranças reais até que o banco e o provedor de pagamentos confirmem por escrito que aceitam:
1. Campanha pessoal e não comercial de arrecadação solidária.
2. Recebimento de contribuições de terceiros na conta indicada.
3. A finalidade declarada de ajudar uma pessoa na Bolívia.
4. Uso da API e webhooks para confirmação de pagamento.

A disponibilidade de uma API PIX não significa que o provedor aceite esta finalidade. As condições do fornecedor e as regras do banco devem ser verificadas para o cadastro específico.

## Fluxo operacional
1. Organizador obtém autorização do beneficiário para divulgar a campanha e reúne documentação de apoio.
2. Provedor/banco confirma a adequação da conta e da finalidade.
3. Servidor cria uma cobrança PIX individual por doação.
4. Webhook é autenticado; o servidor consulta/valida o estado no provedor e aplica idempotência.
5. Apenas pagamentos confirmados entram no total público.
6. No encerramento, o organizador reconcilia a soma do sistema com o extrato bancário.
7. Antes de enviar ao exterior, o organizador confirma com uma instituição autorizada a operar em câmbio a disponibilidade do corredor para a Bolívia, os documentos exigidos e o Valor Efetivo Total (VET).
8. Após a remessa, registra valor bruto, tarifa, IOF se aplicável, taxa de câmbio, valor líquido entregue e comprovante redigido.
9. Publica um relatório final sem nomes de doadores, números de conta, documentos, endereço ou outros dados pessoais.

## Modelo de dados recomendado
- `donations`: id interno, valor solicitado, moeda, estado interno, referência do provedor, data de criação e confirmação.
- `payment_events`: id do evento externo, doação associada, tipo, data, resultado da validação; chave única para impedir duplicidade.
- `expenses`: descrição, categoria, valor, data, referência do documento e estado de publicação.
- `remittances`: beneficiário interno, país, data, valor enviado em BRL, taxas, IOF, taxa de câmbio, valor recebido na moeda de destino e referência privada do comprovante.
- `audit_log`: administrador, ação, objeto, data e metadados mínimos necessários.
- `campaign_settings`: meta, estado da campanha, texto público, consentimentos e datas.

## Regras de privacidade e integridade
- O total público é calculado a partir de pagamentos confirmados e lançamentos aprovados; não aceitar valor vindo do navegador como fonte de verdade.
- Nunca publicar nomes, e-mails, CPF, telefone, identificadores bancários ou referência completa do pagamento.
- Não guardar tokens do provedor no frontend. Usar variáveis de ambiente apenas no servidor.
- Validar a autenticidade do webhook e consultar a transação no provedor quando necessário.
- Processar eventos de forma idempotente; eventos repetidos não podem aumentar o total duas vezes.
- Proteger o painel com autenticação, autorização no servidor, limitação de tentativas e MFA quando possível.
- Manter cópias privadas dos documentos e publicar apenas versões redigidas.
- Não declarar a campanha pronta para receber dinheiro antes de concluir revisão operacional, legal, de privacidade e testes.

## Remessa internacional
O envio do Brasil para a Bolívia deve ser realizado por instituição autorizada a operar em câmbio ou por canal legalmente permitido. A instituição poderá pedir documentação sobre origem e finalidade dos recursos. Comparar o Valor Efetivo Total (VET), que considera taxa de câmbio, IOF e tarifas. Confirmar os requisitos diretamente com a instituição escolhida.

## Estado atual
O projeto fornecido é apenas uma base de interface. Ainda não implementa base de dados, autenticação real, cobranças PIX, webhooks, registo de despesas nem remessa internacional.