Visión General de Arquitectura
Yuruary es una plataforma SaaS Híbrida y Sincronizada que revoluciona la administración de condominios al unir la potencia de la nube con la fiabilidad de un sistema local. Su arquitectura garantiza operatividad total en la oficina (Offline-First) y acceso global para los residentes.
Arquitectura del Sistema
El siguiente diagrama detalla la interacción entre los componentes Web (React + Vite), el Backend Local (NestJS) y el túnel seguro de conectividad.
Ecosistema Tecnológico
El proyecto se distribuye en 4 repositorios principales, optimizados para compartir código y tipos:
| Repositorio | Stack Tecnológico | Rol |
|---|---|---|
yuruary-backend-core | NestJS, PostgreSQL, TypeORM | Monolito Modular. Núcleo de lógica y sincronización. |
yuruary-desktop-client | Electron, React + Vite | Aplicación de escritorio para el Staff administrativo. |
yuruary-web-portal | React + Vite (Hosting Estático) | PWA para Residentes. Pagos y Reservas. |
yuruary-shared-lib | TypeScript | Librería de Interfaces y Tipos compartidos. |
Principios de Diseño
- Offline-First: La Oficina (LocalDB) es la "Fuente de la Verdad". Si cae internet, el personal sigue trabajando sin interrupciones y los datos se sincronizan al volver la conexión.
- Escritura Diferida: El Portal Web NO escribe directamente en la base de datos. Encola las solicitudes (Pagos, Reservas) en SQS/CloudQueue para ser procesadas y validadas por el servidor local.
- Seguridad Zero-Trust: Todo el tráfico entrante hacia la oficina pasa exclusivamente por Cloudflare Tunnel. No se abren puertos en el router local ni se expone la IP pública.
Vite en el Ecosistema
El uso unificado de Vite tanto en el Web Portal como en el Desktop Client (Electron) nos permite compartir configuraciones de build, plugins y, lo más importante, componentes de UI de nuestra librería de diseño.