Saltar al contenido
Julián Bayer//
Volver a proyectos
// En desarrollo

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.