Joaquimdacosta1999/KwanzaJ-

Motor core para plataformas de BNPL (Buy Now, Pay Later) e crédito digital em Angola. Suporte nativo a parcelamento em Kwanzas (AOA), integração com Multicaixa Express e Referências Multicaixa, scoring alternativo e portal para lojistas. # KwanzaFlex BNPL (Buy Now, Pay Later) Core Plataforma open-source de concessão de crédito digital e parcelamento de compras (BNPL - _Buy Now, Pay Later_) desenhada especificamente para a infraestrutura financeira e regulatória de Angola. O sistema opera no modelo **Private Label (Closed-Loop)**, permitindo que retalhistas e lojistas ofereçam financiamento próprio ou garantido no ponto de venda (POS) e e-commerce, com suporte nativo à rede Multicaixa. --- ## 🎯 Objetivo do Projeto Fornecer uma infraestrutura de crédito flexível, segura e escalável para o mercado angolano, cobrindo o ciclo completo de concessão de crédito em 3 etapas: 1. **Onboarding & KYC:** Verificação de identidade e scoring alternativo. 2. **Originação & Ledger:** Criação de contratos de crédito e agendamento de parcelas em Kwanzas (AOA). 3. **Liquidação Automatizada:** Integração com a rede EMIS para recebimento via **Multicaixa Express (MCX)** e **Referências Multicaixa**. --- ## 🛠️ Arquitetura e Tecnologias - **Backend / Services:** Node.js (TypeScript) / Go - **Frontend / Portais:** React / Next.js - **Base de Dados:** PostgreSQL (Ledger e Transações) + Redis (Cache e Filas) - **Integrações Financeiras:** - API ProxyPay (Geração e conciliação de Referências Multicaixa) - MCX Express (Push de Pagamentos) - CIR - Banco Nacional de Angola (Consulta de Risco - _Fase 2_) --- ## 🚀 Módulos Principais ### 1. `kyc-identity` Responsável pela validação do Bilhete de Identidade (BI), recolha de prova de vida e ingestão de extratos bancários em PDF/API para análise preliminar. ### 2. `credit-scoring` Motor de regras de crédito ajustado para a realidade local. Avalia histórico de transações, validações de rendimento estimado e atribui um limite pré-aprovado por cliente. ### 3. `ledger-core` O motor financeiro do sistema. Gere os contratos de parcelamento, calcula o valor de entrada (Pay-in-3 / Pay-in-4), aplica taxas de juro em AOA e regista o estado das amortizações. ### 4. `payment-gatew …