Skip to content

Instantly share code, notes, and snippets.

View jluisflo's full-sized avatar
🚀
Learning every day

Luis Flores jluisflo

🚀
Learning every day
View GitHub Profile
@jluisflo
jluisflo / plan-apelacion-cec.md
Created January 20, 2026 19:36
Plan: Flujo de Apelación CEC (Solución Simplificada)

Plan: Flujo de Apelación CEC (Solución Simplificada)

Design Doc - High Level

Problema

Los usuarios sin historial crediticio o con crédito denegado necesitan poder apelar, subiendo documentos de soporte. MPay ya expone esta funcionalidad via su WebView y nuevos estados en su API, pero issuing no los reconoce.

Solución

Approach: Aprovechar el WebView de MPay para todo el flujo de apelación. Issuing solo parsea estados y muestra información.

@jluisflo
jluisflo / MPAY_INTEGRATION_GUIDE.md
Last active January 20, 2026 02:49
N1co Issuing ↔ MPAY Integration Guide - Complete technical documentation for Buy Now Pay Later (BNPL) integration

Guía de Integración: N1co Issuing ↔ MPAY (Buy Now Pay Later)

Versión: 1.0 Fecha: Enero 2026 Propósito: Documentación técnica completa de la integración entre N1co Issuing y MercanduPay (MPAY) para funcionalidad Buy Now Pay Later (BNPL)


📋 Tabla de Contenidos

@jluisflo
jluisflo / guia-simulacion-eventos-vencimiento.md
Created January 14, 2026 19:34
Guía: Simulación de Eventos de Vencimiento en Fineract (LoanRepaymentDueBusinessEvent / LoanRepaymentOverdueBusinessEvent)

Guía: Simulación de Eventos de Vencimiento en Fineract

Esta guía explica cómo simular los eventos LoanRepaymentDueBusinessEvent y LoanRepaymentOverdueBusinessEvent en un ambiente de desarrollo sin modificar la fecha del sistema.


Índice

  1. Resumen de Eventos
  2. Configuración del Producto
@jluisflo
jluisflo / PLAN_ONBOARDING_FLUTTER_BFF.md
Created January 14, 2026 02:20
Plan BFF Gateway para Onboarding Flutter - MPAY

Plan BFF Gateway para Onboarding Flutter - MPAY

Versión: 1.0 | Fecha: Enero 2025 | Autor: Tech Lead


1. Resumen Ejecutivo

Crear un Backend for Frontend (BFF) en .NET 8.0 que actúe como proxy inteligente entre Flutter y los servicios existentes de MPAY, permitiendo:

@jluisflo
jluisflo / fineract-event-bridge-design.md
Last active January 7, 2026 02:54
Fineract Event Bridge - Design Document

Design Document: Fineract Event Bridge

Status: Implemented Author: Engineering Team Date: 2025-01-06 Version: 1.0


1. Overview

@jluisflo
jluisflo / fineract-loan-business-events.md
Created January 6, 2026 19:44
Fineract Business Events para Vencimientos y Mora de Préstamos

Fineract Business Events para Vencimientos y Mora

Resumen

Fineract emite eventos de negocio via Kafka/ActiveMQ para notificar cambios en el ciclo de vida de préstamos. Este documento detalla los eventos relevantes para:

  • Próximo a vencer: Recordatorios antes del vencimiento
  • Vencido: Alertas post-vencimiento
  • En mora: Clasificación y cambios de estado de morosidad
@jluisflo
jluisflo / design-doc-kyc-redirect-flow.md
Created January 5, 2026 20:00
Design Doc: KYC Approval Direct Redirect to Document Acceptance - Credits Module

Design Document: KYC Approval Direct Redirect to Document Acceptance

Author: Jose Flores Date: 2026-01-05 Status: Proposed Module: Credits Module App


1. Overview

@jluisflo
jluisflo / hashed-shimmying-barto.md
Last active December 23, 2025 03:53
Plan: IVA Proporcional en Pagos Parciales de Comisiones - Fineract

Plan: IVA Proporcional en Pagos Parciales de Comisiones

Problema

Cuando un pago solo cubre parcialmente el fee moratorio ($100), se necesita calcular y registrar el IVA proporcional (13% de los $50 pagados = $6.50). Actualmente Fineract trata cada charge como independiente.


OPCIÓN A: Charges Vinculados (parent_charge_id)

Decisiones Confirmadas

@jluisflo
jluisflo / MPAY_ACCOUNTING_SYSTEM.md
Created December 22, 2025 21:35
Sistema de Contabilidad y Pagos MPAY - Guía para Desarrolladores

Sistema de Contabilidad y Pagos - MPAY

Guía para Desarrolladores: Entendimiento, Riesgos y Mantenimiento

Versión: 1.0 Fecha: 2025-12-22 Audiencia: Desarrolladores Backend, DevOps, QA


@jluisflo
jluisflo / MPAY_ARCHITECTURE_ANALYSIS.md
Created December 20, 2025 00:22
Análisis Arquitectónico Completo: Plataforma MPAY - C4 Model + Event Storming

Análisis Arquitectónico Completo: Plataforma MPAY

Resumen Ejecutivo

MPAY (Mercandu Pay / n1co) es una plataforma Buy Now Pay Later (BNPL) completa para El Salvador y Honduras. Es un monorepo con 5 proyectos independientes que trabajan en conjunto mediante una arquitectura orientada a eventos.

Aspecto Detalle
Tipo Plataforma BNPL (Compra Ahora, Paga Después)
Stack Principal Laravel 10 (PHP 8.2), Next.js 14, Python 3.13