# Peclic - Sistema de Gestion de Prestamos

> Peclic es un sistema completo de gestion de prestamos (Loan Management System) disenado para negocios de prestamos personales y empresariales en Republica Dominicana y Latinoamerica.

## Que es Peclic?

Peclic es una plataforma SaaS multi-tenant que permite a prestamistas gestionar todo el ciclo de vida de un prestamo: desde la solicitud y aprobacion, pasando por la generacion automatica de contratos y calendarios de pago, hasta el seguimiento de cobros, moras, y reportes financieros.

## Funcionalidades principales

- **Gestion de clientes**: Registro de personas fisicas y empresas con validacion de cedula dominicana (11 digitos), RNC, y documentos de identidad.
- **Prestamos**: Creacion de prestamos con calculo automatico de cuotas (interes fijo, nivelado, bullet), frecuencias personalizables (semanal, quincenal, mensual), y moras automaticas.
- **Calendario de pagos**: Visualizacion interactiva del calendario de cuotas con estados (pendiente, pagada, vencida, mora).
- **Contratos PDF**: Generacion automatica de contratos legales con plantillas personalizables usando variables @variable. Editor visual con autocompletado.
- **Pagos y recibos**: Registro de pagos parciales o completos, generacion de comprobantes, evidencia fotografica, y reversion de pagos.
- **Reportes**: Dashboard con KPIs financieros, reportes de cartera, morosidad, y proyecciones.
- **WhatsApp**: Integracion para envio de recordatorios de pago, confirmaciones, y mensajes personalizados.
- **Seguridad**: Autenticacion JWT con MFA (TOTP), WebAuthn/Passkeys, roles y permisos granulares, cifrado de datos sensibles.
- **Multi-tenant**: Aislamiento completo por tenant con base de datos independiente por organizacion.
- **Backups**: Sistema automatizado de respaldos con cifrado AES-256-GCM, compresion, y retencion configurable.

## Stack tecnologico

- **Frontend**: React 18 + Vite 5, Context API, Lucide icons
- **Backend**: Node.js + Express, API RESTful
- **Base de datos**: PostgreSQL 17 con JSONB
- **Infraestructura**: Docker multi-stage, Nginx TLS reverse proxy
- **Autenticacion**: JWT + bcrypt, Google OIDC, TOTP MFA, WebAuthn/Passkeys

## API

La API RESTful esta disponible en `/api/` con los siguientes modulos principales:

- `/api/auth` - Autenticacion, MFA, Passkeys, Google OIDC
- `/api/clients` - CRUD de clientes
- `/api/loans` - Gestion de prestamos y calendarios
- `/api/payments` - Registro y reversion de pagos
- `/api/reports` - Reportes y exportaciones
- `/api/settings` - Configuracion de empresa y sistema
- `/api/document-templates` - Plantillas de contratos
- `/api/roles` - Roles y permisos
- `/api/audit` - Registro de auditoria
- `/api/backups` - Gestion de respaldos

## Contacto

- Web: https://peclic.ipmtechops.com
- GitHub: https://github.com/idalbertopeguero-boop/peclic