Internal Developer Guide
Welcome to the Lana internal developer documentation. This section covers everything you need to work on the lana-bank codebase — local setup, architecture internals, frontend development, and domain service patterns.
Getting Started
New to the codebase? Start here:
- Local Development Setup — Get a working dev environment in minutes
- Authentication (Local) — Keycloak realms, login flows, test credentials
- Authorization — Casbin RBAC model, roles, and permissions
Frontend Development
Build and extend the admin panel:
- Frontend Applications — Tech stack, patterns, and project structure
- Admin Panel — Admin panel architecture and development
- Shared Components — UI component library
- Credit UI — Credit facility management interface
- GraphQL Development — Apollo Client setup, codegen, and local endpoints
Domain Architecture
Understand the internal design of each module:
- Domain Services — DDD module structure and interactions
- Event System — Event sourcing, outbox pattern, public vs private events
- Background Jobs — Job processing, scheduling, and specific jobs
- Cala Ledger Integration — Double-entry accounting engine
- Custody & Portfolio — BitGo/Komainu integration, collateral management
- Testing Self-Custody on Signet — Local Signet wallets, xpub setup, and funding pending facilities
Infrastructure & Operations
- Infrastructure Services — External dependencies and service layers
- Observability — OpenTelemetry, tracing, Honeycomb
- Audit System — Authorization logging and compliance
- Configuration — Domain config system and macros