109 lines
4.2 KiB
Markdown
109 lines
4.2 KiB
Markdown
---
|
|
id: "0043"
|
|
title: "Estandarizar shell de las 4 apps C++ (About + Settings + paneles + tokens)"
|
|
status: completado
|
|
type: refactor
|
|
domain:
|
|
- cpp-stack
|
|
scope: multi-app
|
|
priority: alta
|
|
depends: []
|
|
blocks: []
|
|
related: []
|
|
created: 2026-05-17
|
|
updated: 2026-05-17
|
|
tags: []
|
|
---
|
|
# 0043 — Estandarizar shell de las 4 apps C++ (About + Settings + paneles + tokens)
|
|
|
|
## Metadata
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **ID** | 0043 |
|
|
| **Estado** | pendiente |
|
|
| **Prioridad** | alta |
|
|
| **Tipo** | refactor — `cpp/apps/*` y `projects/fn_monitoring/apps/registry_dashboard` |
|
|
|
|
## Dependencias
|
|
|
|
Bloquea-por: **0041** (AppConfig extendido), **0042** (layout_storage publico).
|
|
|
|
---
|
|
|
|
## Objetivo
|
|
|
|
Que las 4 apps C++ con GUI (`shaders_lab`, `chart_demo`, `primitives_gallery`, `registry_dashboard`) sigan el mismo patron de inicializacion documentado en `cpp/PATTERNS.md` (issue 0041): About + Settings + paneles + tokens, sin reinventar boilerplate.
|
|
|
|
## Contexto
|
|
|
|
Auditoria muestra que cada app arranca distinto: solo `shaders_lab` aprovecha menubar con paneles, solo `registry_dashboard` registra About + Settings, `primitives_gallery` llama `apply_dark_theme()` + `gl_loader_init()` a mano. Tras 0041 y 0042, se puede unificar.
|
|
|
|
## Arquitectura
|
|
|
|
```
|
|
cpp/apps/
|
|
├── shaders_lab/main.cpp # MOD — usa layout_storage publico, About, init via AppConfig
|
|
├── chart_demo/main.cpp # MOD — registra About, simplifica
|
|
├── primitives_gallery/main.cpp # MOD — gl_loader_init via AppConfig, About
|
|
└── text_editor_smoke/ # SIN CAMBIOS (test CLI)
|
|
|
|
projects/fn_monitoring/apps/registry_dashboard/
|
|
└── main.cpp # MOD — usa AppConfig.about en lugar de about_window_set_info inline
|
|
```
|
|
|
|
## Tareas
|
|
|
|
### Fase 1 — chart_demo (mas simple, validacion temprana)
|
|
|
|
1.1 Cambiar a:
|
|
```cpp
|
|
return fn::run_app({
|
|
.title="chart_demo", .width=1280, .height=800,
|
|
.about={.name="chart_demo", .version="0.1.0",
|
|
.description="Demo de primitivos viz: line, scatter, bar, heatmap"}
|
|
}, render);
|
|
```
|
|
1.2 Quitar la llamada manual a `app_menubar(nullptr,0,nullptr)` del render — `run_app` la invoca por nosotros si hay panels/layouts; en este caso sin panels, dejar render limpio (o llamar `app_menubar(nullptr,0,nullptr)` solo si hace falta menubar para Settings).
|
|
1.3 Build OK.
|
|
|
|
### Fase 2 — primitives_gallery
|
|
|
|
2.1 Quitar `apply_dark_theme()` y `gl_loader_init()` del init manual (l. 129-134). Pasar `init_gl_loader=true` y `theme=ThemeMode::FnDark` en `AppConfig`.
|
|
2.2 Anadir About (`name="Primitives Gallery"`, version, description).
|
|
2.3 Mantener `app_menubar(nullptr,0,nullptr)` solo si la menubar la quiere la app — opcionalmente delegar a `run_app` extendido.
|
|
2.4 Build OK.
|
|
|
|
### Fase 3 — registry_dashboard
|
|
|
|
3.1 Reemplazar la llamada manual `about_window_set_info(...)` (l. 121-127) por `AppConfig::about={...}`. La seccion `Status` se queda como `settings_window_add_section` (no cambia).
|
|
3.2 Build OK.
|
|
|
|
### Fase 4 — shaders_lab
|
|
|
|
4.1 Reemplazar el bloque de layouts inline por `fn_ui::layout_storage_open("shaders_lab.db")` + `layout_storage_make_callbacks` (consume issue 0042).
|
|
4.2 Anadir About (`name="shaders_lab"`, version, description).
|
|
4.3 Pasar `panels` y `layouts_cb` via `AppConfig` (issue 0041) — quitar la llamada manual a `app_menubar`.
|
|
4.4 Build OK.
|
|
|
|
### Fase 5 — Verificacion cross
|
|
|
|
5.1 Build Linux y Windows de las 4 apps.
|
|
5.2 Run rapido en Linux para confirmar que About y Settings/Status aparecen en el menubar de cada una.
|
|
|
|
## Decisiones de diseno
|
|
|
|
- Tocar registry_dashboard para que sea consistente con el patron, aunque hoy ya tenia About/Settings via APIs sueltas.
|
|
- text_editor_smoke se queda igual (es un test CLI).
|
|
|
|
## Riesgos
|
|
|
|
- Si `run_app` invoca `app_menubar` y la app tambien lo llama, salen dos menubars. Verificar que cada main.cpp solo llama `app_menubar` si NO esta declarado en AppConfig.
|
|
- shaders_lab: la migracion a `layout_storage` debe preservar layouts existentes — ver riesgo de 0042.
|
|
|
|
## Validacion
|
|
|
|
- Las 4 apps abren y muestran menu Settings con Settings… + About… (mas Status… donde aplique).
|
|
- shaders_lab guarda/carga layouts despues de la migracion.
|
|
- `cmake --build` pasa para todas. Cross-compile Windows OK.
|