Portal de Documentación: MDX-Cloud

Bienvenido al centro de documentación técnica y de arquitectura para MDX-Cloud. Este espacio contiene las especificaciones detalladas del sistema de administración multisucursal, diseñado bajo un esquema de Monolito Modular con capacidades Offline-First.

---

Mapa de la Documentación

Explore los módulos de arquitectura, bases de datos y cronogramas de desarrollo utilizando el siguiente índice estructurado:

📁 01. Visión y Contexto

• 01. Visión y Restricciones Técnicas: Metas de negocio, alcance del sistema y limitantes tecnológicas de desarrollo.
• 02. Vista de Contexto del Sistema: Diagrama C4 Nivel 1 y definición de actores (incluyendo mostrador, agentes y almacén).

📁 02. Arquitectura de Software

• 03. Arquitectura del Sistema: Definición detallada de los 5 límites de dominio (wms, comercial, credito, facturacion, personal) y diagrama C4 de Contenedores.
• 04. Arquitectura de Datos: Persistencia en PostgreSQL y motor de base de datos local en IndexedDB (Dexie.js).
• 05. Arquitectura de Frontend: Estructura Clean Architecture de la aplicación SPA en React con Service Workers.
• 06. Infraestructura y Despliegue: Entornos de ejecución en Docker, topología física con Cloudflare y políticas de respaldos.

📁 03. Requisitos y Seguridad

• 07. Especificación de Roles y Permisos: Matriz de control de acceso basada en roles (RBAC) y definición de políticas en .NET 10.
• 08. Requisitos Detallados: Catálogo atómico de Requisitos Funcionales (RF) y No Funcionales (RNF) del sistema.
• 09. Diseño de Interfaz: Mapa del sitio, pantallas dinámicas y lineamientos de usabilidad (UX) industrial.
• 10. Seguridad y Cumplimiento: Autenticación híbrida (JWT + Cookies HttpOnly), CORS y buenas prácticas de hardening.

📁 04. Procesos y Datos

• 11. Lógica Algorítmica y Procesos: Algoritmos críticos de surtido FEFO, división de folios, dispersión FIFO de abonos y colas con Hangfire.
• 12. Modelo de Datos: Script DDL PostgreSQL físico completo, esquemas y control de condiciones de carrera.

📁 05. Cronograma de Desarrollo

• README / Contracts-First: Filosofía de desarrollo en paralelo backend-frontend.
• Fase 1: Scaffolding e Infraestructura: Cascarón del monolito modular y base de datos local IndexedDB.
• Fase 2: Identidad y Sincronización: Seguridad de sesiones y descarga de catálogos estáticos.
• Fase 3: Operación Crítica e Idempotencia: Kardex inmutable, bloqueo pesimista y UUIDs de control de duplicidad.
• Fase 4: Auditoría y Despliegue: Trazabilidad forense con JSONB, Jobs asíncronos de facturación y Cloudflare Pages.

📁 06. Calidad y Pruebas

• 13. Estrategia de Pruebas y QA: Metodología estricta de validación (Pruebas Unitarias, Integración, E2E Offline y Estrés con k6) y Automatización (CI/CD).

📁 07. Operación y Soporte

• 14. Ciclo Operativo y Soporte: Estrategia de despliegue sin ventanas de caída (Blue/Green), Mantenimiento preventivo automatizado y matriz de SLAs de soporte.