10. Tooling y Ecosistema de Desarrollo
Fase: 02 — Project Kickoff
Entregable: 10
Proyecto: NoteVault (PC, Mac, Android, iPhone)
1. Herramientas Oficiales y Pinning de Versiones
| Herramienta | Versión Fijada | Rol en el Ecosistema |
|---|---|---|
| Node.js | v20.x / v22.x LTS |
Runtime del proceso principal y compilador de frontend. |
| npm | v10.x |
Gestor de paquetes de Node. |
| TypeScript | 5.9.x |
Compilador de tipos estáticos para Desktop. |
| Electron | 44.x |
Shell nativo de escritorio para PC (Windows, macOS, Linux). |
| Vite | 8.x |
Bundler y servidor de desarrollo HMR ultrarrápido. |
| Flutter SDK | 3.24.x (Dart 3.5.x) |
Framework multiplataforma móvil (Android e iOS). |
| Vitest | 5.x |
Test runner ultrarrápido compatible con Vite. |
| Python | 3.12 / 3.13 |
Ejecución de herramientas de Canvas y compilador MkDocs. |
| MkDocs Material | 9.5.x+ |
Generador de documentación técnica interactiva. |
2. Marco Conceptual: Herramienta de Construcción Oficial
1. **Entidad principal e independiente.**
2. **Es la entidad líder del conjunto de datos:** posee un identificador global único que fija la versión del toolchain (`tooling_pin_id`: `TOOL-NODE22-FLUTTER3`) consultado por los entornos de CI y local.
3. **Existe por sí misma en el manifiesto del proyecto sin depender de configuraciones globales de la máquina**, y es la única responsable de garantizar la reproducibilidad de los binarios ejecutables en cualquier computadora.
4. **Punto de entrada y límite de consistencia:** El uso de versiones no compatibles arroja un error de advertencia en el paso de instalación.