Appearance
Arquitectura Modular -- Tu Magistral
| Campo | Valor |
|---|---|
| Estado | Borrador |
| Última actualización | 2026-03-25 |
| Reuniones vinculadas | 2026-03-05, 2026-03-09, 2026-03-10, 2026-03-10-p2, 2026-03-24 |
1. Principio de modularidad
Tu Magistral se construye sobre una arquitectura modular donde cada módulo es una unidad funcional independiente que puede activarse, desactivarse o evolucionar sin romper el resto del sistema.
Esto no significa que los módulos están aislados: se conectan entre sí a través de fronteras bien definidas, donde fluye información específica y controlada. La clave es que ninguna funcionalidad de un módulo depende del estado interno de otro.
Razón de ser: El mercado magistral tiene actores con necesidades muy distintas. Un recetario grande necesita producción y costeo; una farmacia pequeña solo necesita cotizar. La modularidad permite activar lo justo para cada cliente sin imponer complejidad innecesaria.
2. Diagrama de módulos, fronteras e integraciones
3. Tabla de fronteras entre módulos
Cada frontera define qué información fluye de un módulo a otro y en qué dirección. Ninguna frontera permite acceso al estado interno del módulo emisor.
| Origen | Destino | Información que fluye | Tipo de conexión |
|---|---|---|---|
| M06 Costeo | M02 Cotización | Precio base por fórmula (costo + margen configurado) | Consulta (línea punteada) |
| M06 Costeo | M03 B2B | Precio base por convenio (puede tener descuento pactado) | Consulta (línea punteada) |
| M02 Cotización | M03 B2B | Cotización confirmada: datos de receta, paciente, farmacia, fórmula solicitada | Evento (línea sólida) |
| M03 B2B | M04 Producción | Orden de trabajo: fórmula a producir, plazo comprometido, destino de despacho, farmacéutico solicitante | Evento (línea sólida) |
| M04 Producción | M07 Seguimiento | Registro post-entrega: lote producido, farmacéutico responsable, fecha, QR dinámico | Evento (línea sólida) |
| M05 Marketplace | M04 Producción | Orden directa: receta validada, farmacia de origen, recetario seleccionado, condiciones de despacho | Evento (línea sólida) |
4. Principios de arquitectura
4.1 Separación de fronteras
Cada módulo tiene un perímetro funcional claro. Lo que ocurre dentro de un módulo no es visible para los demás; solo se expone la información que cruza la frontera.
4.2 Estructura central antes de escalar
El sistema parte de una base de datos y estados consistente. No se agregan funcionalidades por parches ni se resuelven excepciones antes de consolidar el flujo principal.
4.3 Trazabilidad útil
Cada evento importante queda registrado con actor, timestamp y contexto. No se busca registrar todo, sino lo que tiene valor para operación, fiscalización o decisión comercial.
4.4 Configuración por recetario/cliente
No existe una configuración rígida única. Cada recetario puede definir sus tarifas, tiempos, formas farmacéuticas disponibles y condiciones de convenio. Cada farmacia puede configurar sus sucursales y preferencias.
5. Reglas de frontera
Las siguientes reglas explicitan lo que cada módulo NO hace. Esto evita que las fronteras se diluyan con el tiempo.
| Módulo | NO hace | Eso lo hace |
|---|---|---|
| M02 Cotización | NO valida recetas médicas ni verifica convenios | M03 B2B valida convenios; la validación de receta es responsabilidad del farmacéutico |
| M02 Cotización | NO registra producción ni asigna lotes | M04 Producción |
| M03 B2B | NO produce preparados ni gestiona insumos | M04 Producción |
| M03 B2B | NO calcula costos de fórmula | M06 Costeo |
| M04 Producción | NO cotiza ni negocia precios | M02 Cotización y M06 Costeo |
| M04 Producción | NO gestiona la relación comercial con la farmacia | M03 B2B |
| M05 Marketplace | NO produce; solo conecta demanda con oferta | M04 Producción recibe la orden |
| M06 Costeo | NO genera cotizaciones al cliente | M02 Cotización consume el precio base |
| M07 Seguimiento | NO modifica el registro de producción | M04 Producción es la fuente de verdad del lote |
6. Estrategia de implementación incremental
Tu Magistral sigue un enfoque Lean Startup: valor temprano + aprendizaje real, no producto completo en primera versión.
Criterios para avanzar de fase:
- Salir con capacidades accionables de corto plazo.
- Validar con clientes reales (piloto Reccius + farmacias).
- Capturar feedback operativo en terreno.
- Refinar antes de escalar complejidad.
Cada fase se valida antes de activar la siguiente. No se avanza a Fase 2 sin haber consolidado los módulos de Fase 1.
7. Métricas transversales mínimas
Todo el sistema debe permitir medir, al menos:
- Volumen por canal (B2B, marketplace, directo).
- Tiempos de ciclo (cotización a entrega).
- Cuellos de botella en producción.
- Tasa de observaciones e incidencias.
- Cumplimiento de compromisos de plazo.
- Desempeño por cliente/convenio (cuando aplique).
8. Riesgos arquitectónicos
| Riesgo | Descripción | Mitigación |
|---|---|---|
| Mezclar fronteras entre módulos | Agregar funcionalidad de un módulo dentro de otro por urgencia o conveniencia, diluyendo la separación. | Respetar las reglas de frontera documentadas. Revisar en cada sprint que no se violen. |
| Diseñar desde la excepción | Construir funcionalidades para casos borde antes de consolidar el flujo principal. | Resolver primero el flujo feliz (happy path). Las excepciones se documentan y priorizan aparte. |
| Subestimar gestión del cambio | Los equipos operativos de recetarios y farmacias tienen hábitos arraigados. Implementar tecnología sin acompañar el cambio genera rechazo. | Plan de onboarding gradual. Piloto con Reccius como entorno controlado antes de escalar. |
| Crecer sin base de datos/estados consistente | Agregar módulos sin un modelo de datos central genera inconsistencias y datos huérfanos. | Definir modelo de datos central antes de cada nuevo módulo. Los estados deben ser compartidos y coherentes. |
| Depender de procesos manuales sin plan de transición | Automatizar parcialmente y dejar islas manuales genera confusión sobre qué es fuente de verdad. | Cada módulo debe definir explícitamente qué reemplaza y cuál es el plan de transición desde el proceso manual. |
9. Historial de cambios
| Fecha | Reunión | Cambio |
|---|---|---|
| 2026-03-05 | 2026-03-05 | Definición inicial de módulos y visión modular |
| 2026-03-09 | 2026-03-09 | Separación explícita de fronteras y reglas entre módulos |
| 2026-03-10 | 2026-03-10 | Detalle de flujos de cotización y fronteras con B2B |
| 2026-03-10 | 2026-03-10-p2 | Fronteras del módulo de producción y trazabilidad |
| 2026-03-24 | 2026-03-24 | Consolidación de arquitectura, priorización de fases y estrategia incremental |
Volver al Índice general | Ver Visión del proyecto | Ver Glosario