Guía Interna para Desarrolladores

Bienvenido a la documentación interna para desarrolladores de Lana. Esta sección cubre todo lo que necesitas para trabajar en el código base de lana-bank: configuración local, arquitectura interna, desarrollo frontend y patrones de servicios de dominio.

Primeros Pasos

¿Nuevo en el código base? Comienza aquí:

• Configuración de Desarrollo Local — Configura un entorno de desarrollo funcional en minutos
• Autenticación (Local) — Reinos de Keycloak, flujos de inicio de sesión, credenciales de prueba
• Autorización — Modelo RBAC de Casbin, roles y permisos

Desarrollo Frontend

Construye y amplía el panel de administración y el portal del cliente:

• Aplicaciones Frontend — Stack tecnológico, patrones y estructura del proyecto
• Panel de Administración — Arquitectura y desarrollo del panel de administración
• Portal del Cliente — Arquitectura del portal del cliente
• Componentes Compartidos — Biblioteca de componentes de interfaz
• Interfaz de Crédito — Interfaz de gestión de líneas de crédito
• Desarrollo GraphQL — Configuración de Apollo Client, generación de código y endpoints locales

Arquitectura de Dominio

Comprende el diseño interno de cada módulo:

• Servicios de Dominio — Estructura de módulos DDD e interacciones
• Sistema de Eventos — Event sourcing, patrón outbox, eventos públicos vs privados
• Trabajos en Segundo Plano — Procesamiento de trabajos, programación y trabajos específicos
• Integración con Cala Ledger — Motor de contabilidad de doble entrada
• Custodia y Portafolio — Integración con BitGo/Komainu, gestión de colateral
• Prueba de Auto-Custodia en Signet — Monederos Signet locales, configuración de xpub y financiamiento de líneas pendientes

Infraestructura y Operaciones

• Servicios de Infraestructura — Dependencias externas y capas de servicio
• Observabilidad — OpenTelemetry, rastreo, Honeycomb
• Sistema de Auditoría — Registro de autorizaciones y cumplimiento normativo
• Configuración — Sistema de configuración de dominio y macros