Compras de Cotas — Crowdfunding

Pré-requisitos de acesso

• Permissão (módulo): viewCrowdfunding (para abrir a tela). Aprovar/cancelar uma ordem exige adicionalmente o módulo approveTransactions.
• Licença/Feature: CROWDFUNDING
• Contêiner do menu: GERAL → grupo Investimentos / Distribuições Financeiras

O que é / quando usar

Crowdfunding é financiamento coletivo: vários investidores aportam recursos em um projeto e recebem cotas proporcionais. Esta tela lista todas as ordens de compra de cota feitas pelos usuários, por projeto. O operador usa-a para aprovar ou cancelar ordens pendentes, investigar o perfil do investidor (dados de adequação/suitability) e exportar a base para conciliação ou compliance.

Pré-condições

• Permissão: viewCrowdfunding para visualizar; approveTransactions para aprovar/cancelar (ambas duplas — enum CPM no backend + módulo no DB). Sem approveTransactions, as ações de aprovação/cancelamento no detalhe da ordem ficam indisponíveis.
• Licença/Feature: CROWDFUNDING habilitada na licença do tenant (Vault); senão o item não aparece no menu.
• Dependências: projetos de crowdfunding já cadastrados; ordens criadas pelos investidores.

Passo a passo

1. Acesse Investimentos → Compras de Cotas - Crowdfunding (rota /manage-crowdfunding-orders).
2. Use a busca (por nome/sobrenome/ID do usuário) e o filtro de projeto para localizar as ordens.
3. Clique numa ordem para abrir os detalhes.
4. No detalhe, com permissão approveTransactions, aprove ou cancele a ordem.
5. Opcionalmente, exporte o CSV para conciliação.

Filtros e colunas

Filtro / Coluna	O que mostra	Origem do dado
Busca (texto)	Filtra por ID, nome ou sobrenome do usuário (debounce 300 ms)	Cruzamento local → userIds na query
Projeto	Filtra por projeto de crowdfunding (Todos por padrão)	projectIds na query
Data/hora	Quando a ordem foi criada	created_at
Nome / E-mail	Identificação do investidor	Cruzamento com a lista de usuários
Projeto	Projeto da cota comprada	Cruzamento com a lista de projetos
Valor	Montante aportado	amount da ordem (BigNumber)
Status	CREATED/FINISHED/CANCELLED etc.	status da ordem

Ações e modais

• Abrir detalhes: mostra dados do investidor (documento, endereço, banco) e os campos de adequação ao investimento (investidor qualificado, renda mensal, patrimônio, percentual em crowdfunding etc.).
• Aprovar / Cancelar (no detalhe): disponível com approveTransactions. Confirma em bottom-sheet e chama updateCrowdfundingOrder mudando o status (APPROVED/CANCELLED). Em caso de sucesso, a página é recarregada.
• Exportar CSV: gera um arquivo com data, nome, e-mail, documento, endereço, banco, valor, status e os campos de suitability (investidor qualificado, grandes investimentos, renda mensal, ativos reais, aplicações financeiras, imóveis, bens móveis, outros).

Regras de negócio / cuidados

Atenção

• As ações de aprovar/cancelar dependem do módulo approveTransactions — sem ele a tela é apenas de consulta.
• O CSV inclui dados de adequação ao investimento (suitability), usados para compliance da oferta — trate o arquivo como dado sensível.

Irreversível

• A aprovação consolida a participação do investidor na captação. Após confirmada, o cancelamento implica estorno conforme regras do projeto.

• Valores financeiros: amount é tratado como BigNumber, sem arredondamento.
• Invariante captado ↔ cotas: a emissão das cotas (NFTs) de um projeto de crowdfunding é exclusiva do job de crowdfunding — aprovar a ordem aqui não minta NFT diretamente. Isso garante por construção que o valor captado corresponda à soma das cotas emitidas; a conciliação ordem × cota é responsabilidade do job, não de emissão manual via BackOffice.
• Status APPROVED: a aprovação pressupõe usuário-investidor aprovado para operar financeiramente.

Telas relacionadas

• Solicitações de Empréstimos
• Distribuição
• Financeiro