> [-SOHA ]_
Sistema de Organización Hospitalaria Administrativo
❯ // 01. El contexto
SOHA nace de un problema concreto en el Hospital Dr. Miguel Oraá de Guanare, Estado Portuguesa: la gestión del inventario farmacéutico se hacía de forma completamente manual. Recepción, almacenamiento, dispensación, devoluciones y reportes dependían de cuadernos físicos, tarjetas de estante y formularios en papel.
Cada movimiento requería validación manual, no existía trazabilidad por lote, los vencimientos se controlaban revisando estante por estante, y generar un reporte diario tomaba horas de trabajo administrativo. La información crítica para la toma de decisiones simplemente no estaba disponible en tiempo real.
- Registro manual con errores frecuentes de tipeo y cálculo en cada transacción
- Documentación en papel, difícil de rastrear y propensa a pérdidas o daños
- Sin historial digital de movimientos: imposible saber quién hizo qué, cuándo y con qué lote
- Vencimientos no controlados: pérdida de insumos por falta de alertas tempranas
- Sin control FEFO (First Expiry, First Out): los lotes más antiguos no siempre se despachaban primero
- Reportes gerenciales inexistentes: consolidado diario, kardex y proformas se armaban a mano
- Sin auditoría: no había registro resiliente de las operaciones
- Sin respaldos: la información podía perderse ante cualquier incidente
- Stock mínimo sin alertar: el desabastecimiento se detectaba cuando ya era tarde
SOHA es una aplicación de escritorio offline-first que digitaliza el ciclo completo de gestión de inventario farmacéutico hospitalario: recepción, dispensación, inventario, devoluciones, reportes y auditoría.
Su núcleo operativo combina:
- Trazabilidad por lote: cada movimiento queda asociado a medicamento, lote, cantidad, usuario, servicio destino y tipo de operación
- Motor FEFO: al despachar, el sistema prioriza automáticamente los lotes más próximos a vencer
- Alertas de vencimiento: notificaciones visuales para lotes próximos a vencer y ya vencidos
- Reportes regulatorios: consolidado diario, kardex, inventario totalizado, proforma mensual, movimientos y auditoría en PDF con un clic
- Control de stock mínimo: alertas automáticas cuando un medicamento está por debajo del umbral configurado
- Auditoría resiliente: registro de eventos con trazabilidad de quién, qué, cuándo, desde dónde y contra qué lote
- Respaldos automáticos cifrados: backup cifrado (AES-256-GCM / ChaCha20Poly1305) con verificación de integridad y restauración
- Modo offline total: operación local sin depender de conexión a internet
❯ // 04. Métricas destacadas
| Proceso | Antes | Con SOHA |
|---|---|---|
| Localizar medicamento | 5–15 min | < 3 seg |
| Generar reporte diario | 2–4 horas | 1 clic |
| Dispensación por receta | 10–20 min | 2–3 min |
| Inventario físico | 2–3 días | Tiempo real |
| Control de vencimientos | Revisión manual | Alertas automáticas |
| Trazabilidad operativa | Inexistente | Por lote, usuario y fecha |
| Respaldos de datos | Ninguno | Automático · Cifrado · Verificable |
❯ // 04.1 Capturas del sistema
❯ // 04.2 Demo en vivo
Haz clic en la pantalla de abajo para interactuar con el sistema. Todos los datos son ficticios.
Para una experiencia completa, abre la demo en una nueva pestaña: soha-demo.vercel.app ↗
❯ // 05. Funcionalidades principales
- Recepción — entrada de medicamentos con lote, vencimiento, ubicación y proveedor
- Inventario — stock actual con filtros por vencimiento, stock bajo, categoría y ubicación
- Despacho FEFO — carrito de salida con validación de stock y prioridad por lote más próximo a vencer
- Devoluciones — gestión de sobrantes con clasificación de estado y reintegro controlado
- Dashboard — indicadores de stock, salidas, vencimientos, stock crítico y actividad del usuario
- Catálogos — medicamentos, proveedores, bloques hospitalarios con importación CSV
- Diccionario farmacológico — fichas con búsqueda, categorías, indicaciones y contraindicaciones
- Reportes — consolidado diario, proforma mensual, kardex, inventario totalizado, movimientos, auditoría y MAICA, todos en PDF
- Auditoría — registro resiliente de eventos con trazabilidad completa
- Respaldos — backup cifrado, restauración y verificación de integridad
- Usuarios — roles: administrador, asistente, secretaria, cuenta administrativa
- Configuración — datos del hospital, servicios, preferencias del sistema
- Licenciamiento — activación vinculada al hardware con modo emergencia
❯ // 06. Arquitectura técnica
| Capa | Tecnología |
|---|---|
| Frontend | Svelte 5 + TypeScript + SvelteKit + TailwindCSS + Vite |
| Backend nativo | Rust — Tauri 2 |
| Persistencia | SQLite local embebida |
| Reportes | jsPDF + jsPDF-AutoTable |
| Gráficos | ApexCharts |
| Autenticación | bcrypt + JWT + sesión local |
| Licenciamiento | Supabase + hardware fingerprint |
| Seguridad | AES-256-GCM / ChaCha20Poly1305 |
| Compresión | Zstandard |
| Distribución | Tauri: NSIS (Windows), DEB + AppImage (Linux) |
❯ // 07. Arquitectura de datos
La aplicación opera en modo offline-first: toda la lógica de negocio y persistencia corre localmente. La base de datos SQLite embebida almacena el inventario, movimientos, usuarios y configuración. Los respaldos se generan cifrados con AES-256-GCM o ChaCha20Poly1305 y comprimidos con Zstandard, verificables mediante suma de verificación.
Supabase se utiliza únicamente para la validación remota de licencias, asociando cada instalación a un hardware fingerprint. No hay dependencia de conexión para la operación diaria del sistema.
❯ // 08. Resultado
SOHA reemplazó procesos manuales de papel y cuaderno por un sistema digital trazable, auditable y resistente. Las mejoras más significativas:
- Trazabilidad completa: cada medicamento, lote y movimiento tiene una pista de auditoría digital
- Reducción de pérdidas: alertas de vencimiento y motor FEFO minimizan el desperdicio de insumos
- Reportes en segundos: lo que antes tomaba horas ahora se resuelve con un clic
- Operación ininterrumpida: el modo offline garantiza que la farmacia nunca se detenga por falta de internet
- Datos seguros: respaldos automáticos cifrados con verificación de integridad