scoreko-electron-dev/docs/architecture.md

Arquitectura del proceso principal

Flujo de arranque

1. src/main/main.ts carga appConfig desde config/runtime-config.ts.
2. Crea ventanas (windows/window-factory.ts).
3. Arranca NodeCG con nodecg/process-manager.ts.
4. Espera readiness HTTP y muestra loading -> dashboard principal.
5. En cierre, ejecuta un único flujo de stop graceful para evitar procesos huérfanos.

Módulos principales

• config/runtime-config.ts: lectura/validación de env vars.
• nodecg/process-manager.ts: start, readiness y stop de NodeCG, validaciones de instalación/permisos/puerto.
• windows/window-factory.ts: creación de ventanas y política de navegación.
• windows/navigation-security.ts: allowlist de navegación interna y esquemas externos seguros.
• errors/error-presenter.ts: presentación de errores fatales.
• errors/logger.ts: logging estructurado (info/warn/error/debug).

Principios

• Refactors mecánicos primero.
• Hardening incremental con fallback conservador.
• Validación automática por typecheck, build, test, doctor, lint.