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? Empieza 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 UI
- Credit UI: 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 cartera: integración con BitGo/Komainu, gestión de garantías
Infraestructura y operaciones
- Servicios de infraestructura: dependencias externas y capas de servicio
- Observabilidad: OpenTelemetry, trazabilidad, Honeycomb
- Sistema de auditoría: registro de autorizaciones y cumplimiento normativo
- Configuración: sistema de configuración de dominio y macros