Condominio App
PWA para Administración, Inmuebles y Control Financiero de Condominios
Aplicación Progresiva (PWA) diseñada para el control administrativo de condominios y edificios residenciales. Permite gestionar inmuebles (edificios, pisos, apartamentos), propietarios, registro de gastos comunes, emisión de cuotas y conciliación de pagos con cálculo de balances en tiempo real.
Tecnologías clave
- Next.js 16
- React 19
- TypeScript
- Supabase (PostgreSQL)
- Supabase Auth
- Tailwind CSS v4
- PWA (Serwist)
- Server Actions
- Vitest
Ingeniería & Diseño
Arquitectura del Sistema
Arquitectura Server-Driven con Next.js 16 App Router y Supabase. Utiliza Server Components para renderizado ultraligero, Server Actions para operaciones transaccionales y Serwist como Service Worker para capacidades PWA e instalación en dispositivos móviles.
┌─ PWA CLIENTE (Next.js 16 + React 19 + Tailwind v4) ────────────────────┐
│ Instalable como PWA + Service Worker (@serwist/next) │
└───────────────────────────────────┬────────────────────────────────────┘
│ Server Actions / Server Components
▼
┌─ SERVIDOR NEXT.JS (Runtime Node) ──────────────────────────────────────┐
│ - Autenticación y control de sesión con Supabase Auth │
│ - Validación de datos en servidor con esquemas Zod │
│ - Lógica de prorrateo, cálculo de alícuotas y estados de cuenta │
└───────────────────────────────────┬────────────────────────────────────┘
│ Consultas SQL Transaccionales
▼
┌─ SUPABASE (PostgreSQL 16) ─────────────────────────────────────────────┐
│ - Tablas: edificios, pisos, apartamentos, propietarios │
│ - Transacciones: gastos, cuotas_emision, pagos_recibos │
│ - Vistas calculadas: v_saldos_apartamentos, v_historico_balances │
└────────────────────────────────────────────────────────────────────────┘Puntos clave de la arquitectura
- Arquitectura Server-First: Menor payload de JavaScript en el cliente y validaciones seguras en el servidor mediante Server Actions y Zod.
- Soporte PWA Completo: Configuración con @serwist/next con Service Worker y manifiesto para uso directo como app móvil o de escritorio.
- Consistencia contable en PostgreSQL: Vistas SQL especializadas para saldos y deudas, evitando desfaces de concurrencia y simplificando consultas complejas.
- Autenticación segura: Flujo de inicio de sesión con Supabase Auth y cookies de sesión HttpOnly.
- Suite de pruebas: Cobertura de pruebas unitarias con Vitest para validar algoritmos de cálculo de cuotas y saldos.
Ecosistema
Stack Tecnológico Detallado
Next.js 16 + React 19 + TypeScript
Renderizado en servidor, Server Actions y navegación instantánea.
Serwist (@serwist/next)
Service worker, caching inteligente e instalabilidad nativa PWA.
Supabase (PostgreSQL 16) + Supabase Auth
Base de datos relacional, vistas calculadas y control de sesiones seguras.
Tailwind CSS v4
Diseño moderno, adaptativo y enfocado en usabilidad táctil y móvil.
Vitest + Playwright
Pruebas unitarias de cálculos financieros y pruebas E2E.
Capacidades
Características Principales
Administración jerárquica de inmuebles: edificios, pisos, alícuotas y apartamentos.
Registro de propietarios con historial de contacto y unidades asociadas.
Carga y distribución de gastos operativos ordinarios y fondos de reserva.
Registro de pagos con soporte para comprobantes y conciliación de saldos.
Cálculo automatizado de saldos a favor, deudas y morosidad por apartamento.
Instalabilidad PWA offline-ready para acceso ágil desde teléfonos inteligentes.
Decisiones de Ingeniería
¿Cómo se creó este proyecto?
Nació como respuesta a la necesidad de modernizar la gestión manual en papel o Excel que muchos administradores de condominios llevan a cabo.
Se eligió una PWA para ofrecer la inmediatez de una app móvil sin los costes de publicación en tiendas de aplicaciones ni duplicación de código.
¿Quieres revisar el código fuente completo?
El repositorio público contiene el historial de commits, pruebas e instrucciones de ejecución.