Sistema Integral de Gestion Institucional
Plataforma empresarial multiplataforma construida bajo Clean Architecture para digitalizar la gestion administrativa y medica de una institucion social con 34 residentes. Diseñada con separacion estricta de capas, autenticacion JWT con 2FA, control de roles granular y estrategia de testing integral (Unit + E2E).
Desafio de Negocio
Una institucion social responsable de 34 residentes operaba con procesos manuales fragmentados: registros medicos en papel, control de medicamentos sin trazabilidad, y gestion administrativa sin centralizacion. Los riesgos operativos incluian perdida de informacion critica de salud, errores en la administracion de medicamentos y ausencia total de auditoria sobre las acciones del personal.
Solucion de Ingenieria
Se diseño una plataforma empresarial multiplataforma bajo Clean Architecture, con separacion estricta entre las capas de dominio, aplicacion e infraestructura. El sistema implementa autenticacion JWT con segundo factor (2FA), control de acceso basado en roles con permisos granulares, y una capa de persistencia desacoplada. La arquitectura frontend sigue el patron de componentes reutilizables con estado centralizado, mientras que el backend expone una API REST documentada con validaciones a nivel de dominio.
Arquitectura y Decisiones Tecnicas
Patron: Clean Architecture (Frontend) + Arquitectura Hexagonal (Backend NestJS). El backend implementa inyeccion de dependencias nativa de NestJS con modulos desacoplados por dominio. La capa de presentacion se construyo como aplicacion Electron multiplataforma con React y TypeScript, permitiendo despliegue en Windows, macOS y Linux desde un unico codebase. La comunicacion entre capas se realiza mediante interfaces y DTOs tipados, garantizando contratos claros entre frontend y backend.
Testing y Aseguramiento de Calidad
Estrategia de testing en dos niveles: pruebas unitarias con Vitest para logica de negocio y servicios, y pruebas End-to-End con Playwright para validar flujos criticos del usuario (autenticacion, gestion de residentes, administracion de medicamentos). La cobertura de testing se enfoco en los caminos criticos del sistema donde un error podria impactar directamente la salud de los residentes.
Gestion del Proyecto
Proyecto ad-honorem liderado como arquitecto y desarrollador principal. Se establecio la estructura del repositorio, las convenciones de codigo, la estrategia de branching y los estandares de calidad. Coordinacion directa con el personal administrativo de la institucion para levantamiento de requerimientos y validacion iterativa.
Impacto y Resultados
El sistema permitio centralizar la gestion medica y administrativa de la institucion, eliminando registros en papel y reduciendo errores en la administracion de medicamentos. Se implemento trazabilidad completa de acciones del personal mediante auditorias automaticas, mejorando la rendicion de cuentas y la seguridad operativa de la institucion.
Artefactos de Ingenieria
Puntos clave
- Clean Architecture con separacion de dominio, aplicacion e infraestructura
- Aplicacion desktop multiplataforma con Electron
- Autenticacion segura: JWT + 2FA + Control de Roles
- Testing automatizado: Vitest (unitario) + Playwright (E2E)
- Impacto social real: digitalizacion de procesos criticos
Stack tecnologico
NestJS Vitest Playwright TailwindCSS