Lukas
Las cuentas claras del hogar, sin Excel: app de finanzas del hogar para Colombia, local-first en Android, con backend reactivo en Spring Boot WebFlux.
- Rol
- Autor único · Producto, arquitectura y desarrollo
- Estado
- En desarrollo
- 14ADRs
- 26migraciones Flyway
- 127archivos de test de backend
- 155archivos de test unitario Android
- Java
- Spring Boot
- WebFlux
- R2DBC
- PostgreSQL
- Redis
- Keycloak
- Kotlin
- Jetpack Compose
- Room
- SQLCipher
- Angular
- Astro
- Docker Compose
Aspectos destacados
- App Android local-first con base de datos local cifrada (Room + SQLCipher) y sincronización offline.
- Un único endpoint de sincronización con ids generados por el cliente, versionado y conflictos visibles.
- Autenticación con Keycloak: PKCE en Android y BFF con cookie HttpOnly en la web.
- 19 tests E2E de backend con Testcontainers (Postgres y Keycloak) y 6 flujos E2E con Maestro.
Contexto
Lukas es una app de finanzas del hogar para Colombia: «las cuentas claras del hogar, sin Excel». Soy su único autor: producto, arquitectura y desarrollo.
- Hogares compartidos: roles, códigos de invitación y transferencia de propiedad.
- Cuentas y movimientos: efectivo, ahorros y tarjetas de crédito colombianas con cuotas de manejo; ingresos, gastos, transferencias y división de gastos entre miembros.
- Planeación: categorías, presupuestos, pagos recurrentes e ingresos esperados.
- Deudas y metas: préstamos y deudas, y metas de ahorro con votación del hogar para los retiros.
- Cuentas entre miembros: saldos y liquidaciones.
- Sin conexión: sincronización offline.
Arquitectura
Monolito modular reactivo, con arquitectura hexagonal por feature (puertos y adaptadores dentro de cada paquete de feature). El repositorio es un monorepo con cuatro apps (android, backend, frontend, landing) más infraestructura y documentación.
- Backend: Java 25, Spring Boot 4.1 con WebFlux, R2DBC sobre PostgreSQL 18, Redis y Flyway, con almacenamiento compatible con S3.
- Seguridad: OAuth2 Resource Server con Keycloak; PKCE en Android y BFF con cookie HttpOnly en la web.
- Clientes: Android con Kotlin 2.4, Jetpack Compose, Hilt, Room con SQLCipher, WorkManager y Retrofit; web en Angular 22; landing en Astro.
- Sincronización: un único endpoint con ids generados por el cliente, versionado y conflictos visibles.
- Operación: Docker Compose y Cloudflare Tunnel.
Las decisiones están documentadas en 14 ADRs: WebFlux con R2DBC, hexagonal por feature, rate limiting e idempotencia con Redis, almacenamiento S3, Keycloak como resource server, Gitflow con Conventional Commits, SonarQube local con cero issues, presupuesto de servidor de 2 núcleos y 4 GB, propiedad y aislamiento de datos, manejo seguro de tokens, sincronización local-first, hosting por etapas y un único monorepo.
Ingeniería y calidad
- Backend: 127 archivos de test, 19 de ellos E2E con Testcontainers (Postgres y Keycloak), y 26 migraciones Flyway.
- Android: 155 archivos de test unitario, 4 instrumentados y 6 flujos E2E con Maestro (además de Robolectric).
- Calidad y seguridad: ArchUnit para las reglas de arquitectura, SonarQube, gitleaks y GitHub Actions.
Estado y hoja de ruta
Proyecto en desarrollo: la app Android va por la versión 0.5.2 y el backend por la 0.4.1. El código principal es privado; el repositorio showcase (botón «Ver código») documenta arquitectura, decisiones y estado.
Aún no hay una demo pública con interfaz: el backend está desplegado como API y las demos se irán publicando de forma progresiva. La captura automática con IA está planificada para el futuro y todavía no existe.