Pandipipas/scoreko-electron-dev
1
0
Fork 0
mirror of https://github.com/Pandipipas/scoreko-electron-dev.git synced 2026-06-06 05:32:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Translate Spanish text to English across docs and code

Browse Source
This commit is contained in:
Pandipipas
2026-02-24 00:37:48 +01:00
parent fdc013bdb7
commit 12b85e6579
13 changed files with 262 additions and 282 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/architecture.md
+18 -18
View File
@@ -1,24 +1,24 @@
# Arquitectura del proceso principal
# Main process architecture
## Flujo de arranque
## Startup flow
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.
1. `src/main/main.ts` loads `appConfig` from `config/runtime-config.ts`.
2. Creates windows (`windows/window-factory.ts`).
3. Starts NodeCG with `nodecg/process-manager.ts`.
4. Waits for HTTP readiness and shows loading -> main dashboard.
5. On shutdown, runs a single graceful-stop flow to avoid orphan processes.
## Módulos principales
## Main modules
- `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`).
- `config/runtime-config.ts`: read/validate env vars.
- `nodecg/process-manager.ts`: start, readiness, and stop for NodeCG; install/permission/port validation.
- `windows/window-factory.ts`: window creation and navigation policy.
- `windows/navigation-security.ts`: internal navigation allowlist and safe external schemes.
- `errors/error-presenter.ts`: fatal error presentation.
- `errors/logger.ts`: structured logging (`info/warn/error/debug`).
## Principios
## Principles
- Refactors mecánicos primero.
- Hardening incremental con fallback conservador.
- Validación automática por `typecheck`, `build`, `test`, `doctor`, `lint`.
- Mechanical refactors first.
- Incremental hardening with conservative fallback.
- Automated validation via `typecheck`, `build`, `test`, `doctor`, `lint`.