05. Descomposición Modular Funcional

Fase: 03 — Ingeniería de Requisitos
Entregable: 05 de 09
Proyecto: NoteVault (PC Windows, macOS, Linux, Android, iOS / iPhone)
Estado: Formalizado y Certificado

1. Matriz Canónica de los 15 Módulos Funcionales

NoteVault descompone su dominio en 15 módulos funcionales de alta cohesión y bajo acoplamiento. Cada módulo gobierna su propia lógica de negocio y encapsula su almacenamiento dentro de la bóveda bajo una convención estricta:

Módulo ID	Nombre Oficial	Bounded Context	Alcance Funcional Clave	Subdirectorio en Bóveda
MOD-NOTES	Notas y Markdown	`CoreNoteVault`	Edición WYSIWYG, KaTeX, backlinks bidireccionales `[[...]]`, tags, outline y adjuntos.	Raíz de la bóveda (`*.md`)
MOD-HOME	Vista General y Hub Diario	`DailyProductivityHub`	Morning alignment, resumen de hoy, atajos rápidos, estado de hábitos y timeline.	En memoria / `.notevault/home/`
MOD-CANVAS	Lienzo Infinito 2D	`SpatialKnowledge`	Nodos texto, markdown y grupos, aristas dirigidas, entregables y mapas conceptuales.	Raíz y carpetas (`*.canvas`)
MOD-CALENDAR	Calendario de Repaso y Agenda	`TimeSchedule`	Calendario mensual/semanal, tarjetas SRS debidas, deadlines de tareas y sesiones mentor.	En memoria / `.notevault/calendario/`
MOD-HABITS	Hábitos y Journaling	`BehaviorTracker`	Checklists diarios, cálculo riguroso de rachas continuas, matriz semanal y diario.	`.notevault/habits/` y `1.PERSONAL/Diario/`
MOD-EXERCISE	Ejercicio y Rutinas	`PhysicalTraining`	Series de pesas (peso/reps/RPE), 1RM Epley, tonelaje, rest timer y videos técnicos.	`.notevault/ejercicio/`
MOD-NUTRITION	Alimentación y Macronutrientes	`NutritionalIntake`	Desglose P, C, G, Kcal por comida, catálogo local de alimentos y contador de agua.	`.notevault/alimentacion/`
MOD-TASKS	Tareas y Agenda	`TaskExecution`	Prioridades P1-P4, estados (todo, doing, done), subtareas, fechas límite y recurrencias.	`.notevault/tareas/`
MOD-PROJECTS	Proyectos Fullstack SDLC	`SoftwareMethodology`	Tablero Kanban, gestión de las 12 fases del SDLC, quality gates y entregables.	`.notevault/proyectos/` y `2.PROYECTOS/`
MOD-GOALS	Metas y OKRs	`StrategicAlignment`	Visión anual, trimestres Q1-Q4, resultados clave cuantitativos y alineación.	`.notevault/metas/`
MOD-FINANCE	Finanzas Personales	`PersonalAccounting`	Transacciones de ingresos/gastos, balances multicuenta, presupuestos y semáforos.	`.notevault/finanzas/`
MOD-STUDY	Estudio y Matemáticas Puras	`SpacedLearning`	Repetición espaciada SM-2, tríada matemática (c., t., e.), práctica de demostraciones.	`.notevault/estudio/` y `Matematicas/`
MOD-ENGLISH	Reproductor y Shadowing	`LanguageAcquisition`	Audio/video con subtítulos interactivos (.srt/.vtt), loop de frase y Mini-Player.	`Ingles/` y `.notevault/english/`
MOD-MENTOR	Mentor IA y Planes	`AdaptiveMentorship`	Generador mensual (`together`/`phased`), Pomodoro superior y evaluación reflexiva.	`.notevault/mentor/`
MOD-WEB	Navegador y Enfoque	`FocusBrowser`	Sesión aislada `persist:nvweb`, bloqueo de distracciones y Web Clipper a Markdown.	`.notevault/web/`

2. Grafo de Dependencias e Interacción entre Módulos

El siguiente diagrama formaliza el flujo de datos y dependencias unidireccionales del sistema. Nótese la ausencia total de dependencias circulares (Acyclic Dependencies Principle):

graph TD
    %% Módulos Agregadores de Alto Nivel
    M_HOME["MOD-HOME<br/>(Hub Diario)"]
    M_CAL["MOD-CALENDAR<br/>(Calendario y Agenda)"]
    M_MEN["MOD-MENTOR<br/>(Mentor y Planes)"]

    %% Módulos de Conocimiento y Aprendizaje
    M_NOT["MOD-NOTES<br/>(Editor Markdown)"]
    M_CNV["MOD-CANVAS<br/>(Lienzo Espacial 2D)"]
    M_STU["MOD-STUDY<br/>(SRS y Matemáticas)"]
    M_ENG["MOD-ENGLISH<br/>(Shadowing e Idiomas)"]
    M_WEB["MOD-WEB<br/>(Navegador y Clipper)"]

    %% Módulos de Ejecución y Productividad
    M_TSK["MOD-TASKS<br/>(Tareas y Agenda)"]
    M_PRJ["MOD-PROJECTS<br/>(Proyectos SDLC)"]
    M_GOL["MOD-GOALS<br/>(Metas y OKRs)"]

    %% Módulos de Salud y Estilo de Vida
    M_HBT["MOD-HABITS<br/>(Hábitos y Journal)"]
    M_EXE["MOD-EXERCISE<br/>(Gimnasio y Rutinas)"]
    M_NUT["MOD-NUTRITION<br/>(Alimentación y Macros)"]
    M_FIN["MOD-FINANCE<br/>(Finanzas y Presupuesto)"]

    %% Dependencias del Hub y Calendario
    M_HOME -.->|Consulta Estado| M_TSK
    M_HOME -.->|Consulta Estado| M_HBT
    M_HOME -.->|Consulta Sesión| M_MEN

    M_CAL -.->|Agrega Deadlines| M_TSK
    M_CAL -.->|Agrega Tarjetas Due| M_STU
    M_CAL -.->|Agrega Bloques| M_MEN

    %% Mentor orquesta estudio y tareas
    M_MEN -->|Programa Bloques| M_STU
    M_MEN -->|Programa Tareas| M_TSK
    M_MEN -->|Supervisa| M_ENG

    %% Relaciones de Conocimiento
    M_WEB -->|Recorta Artículos a| M_NOT
    M_CNV -->|Incrusta Nodos| M_NOT
    M_STU -->|Lee/Escribe Notas| M_NOT
    M_STU -->|Genera Vistas| M_CNV

    %% Relaciones de Metodología y Metas
    M_GOL -->|Se Descompone en| M_PRJ
    M_PRJ -->|Genera Tareas Operativas| M_TSK
    M_PRJ -->|Genera Entregables Canvas| M_CNV

    %% Relaciones Fisiológicas
    M_EXE -.->|Informa Demanda Proteica| M_NUT
    M_HBT -->|Vincula Nota Diaria| M_NOT

3. Marco Conceptual: Descomposición en Contextos Delimitados

1. **Entidad principal e independiente.** 2. **Es la entidad líder del conjunto de datos:** posee un identificador global único que aísla un subsistema funcional autónomo (`functional_module_id`: `MOD-NOTES`, `MOD-STUDY`, `MOD-EXERCISE`), consultado por el enrutador de la aplicación y la inyección de dependencias. 3. **Existe por sí misma en el diseño de arquitectura sin acoplamiento circular con otros módulos**, y es la única responsable de gobernar sus propias entidades de dominio, validaciones de archivo y esquemas de persistencia. 4. **Punto de entrada y límite de consistencia:** Cada módulo opera exclusivamente sobre su propio subdirectorio en `.notevault/` o sus notas asignadas, garantizando que un fallo o corrupción en un módulo jamás contamine los datos de los demás.