Ahyzen POS
ERP + POS Offline First
- Rol
- Desarrollador Full Stack / Arquitecto de software
- Cliente
- Ahautech
- Duración
- 15-07-2026 — En desarrollo
- Año
- 2026
- Equipo
- 1 persona
Problema
¿Qué había que resolver?
La gestión de operaciones de venta, caja, inventario y compras es compleja y propensa a errores en entornos offline, especialmente en entornos con alta volumetría de transacciones.
Solución
¿Cómo se resolvió?
Implementar una solución offline-first que garantice la consistencia de datos y la funcionalidad completa sin conexión a internet.
Características
Lo que hace
- Arquitectura Offline First con cola de eventos de sincronización
- Módulo de ventas con reglas de negocio configurables (RN-V01–RN-V05)
- Gestión de caja: apertura, cierre y movimientos
- Inventario y reportes con consultas directas a base de datos
- CRM de clientes con historial de compras
- Módulo de compras: órdenes de compra, autorización y recepción de proveedores
- Catálogo de productos con importación masiva vía CSV/Excel
- Panel administrativo multi-tenant (empresas, sucursales, usuarios, parámetros del sistema)
- Control de acceso basado en roles: 38 permisos en 9 grupos
- Búsqueda de productos con autocompletado y navegación por teclado
- Gestión de presentaciones de producto y apertura de paquetes
Responsabilidades
Mi rol en el proyecto
- Diseño e implementación de la arquitectura offline-first y el sistema de sincronización
- Desarrollo del modelo de dominio y migraciones de base de datos
- Implementación de servicios de negocio (ventas, caja, inventario, CRM, compras, catálogo)
- Desarrollo de la interfaz de usuario multiplataforma con PySide6
- Diseño del sistema de roles y permisos multi-tenant
- Escritura de pruebas y scripts de datos semilla (seed)
- Empaquetado y entrega incremental del proyecto por fases
Retos técnicos
Lo que no fue trivial
Arquitectura offline-first
Diseñar una arquitectura offline-first robusta que garantice consistencia de datos al sincronizar con la nube
Serialización de datos
Serialización de tipos especiales (Decimal) en eventos de sincronización JSON
Multi-tenant integrity
Manejo correcto de tenant_id/branch_id en un entorno multi-tenant para evitar violaciones de integridad referencial
Configuración de migraciones
Resolución de rutas de configuración para migraciones de Alembic en distintos entornos de ejecución
Resultado
Qué se logró
- Sistema funcional cubriendo 10 fases de desarrollo (F0–F9b), desde el modelo de dominio hasta módulos avanzados de presentaciones de producto
- Arquitectura multi-tenant y multiplataforma lista para producción en Windows, macOS y Linux
- Sistema de roles y permisos completo con 38 permisos y 9 grupos
- La creación de archivos vía heredoc con verificación inmediata de compilación es más confiable que depender de herramientas automáticas de escritura de archivos
- La entrega incremental por fases (delta de archivos) simplifica la integración y reduce el riesgo de romper código existente
- Las pruebas headless con xvfb-run permiten validar interfaces gráficas en entornos de CI/CD sin entorno visual
Documentos