mirror of
https://github.com/Pandipipas/scoreko-electron-dev.git
synced 2026-06-05 21:22:07 +00:00
Pandipipas
25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
# 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`.
|