feat(0036b): NodeGroups admite kind=Group + loader entities
NodeGroupsWindowState gana un discriminador `kind` (Table | Group) y
un flag `focus_request` (lo consumira 0036c). Por defecto Table, asi
que el flujo historico (DuckDB rows tras expand de un nodo Table) no
cambia.
kind=Group lee directamente operations.db consultando
`entities WHERE group_id = container_id` con columnas fijas
(id, name, type_ref, status, updated_at) ordenadas por updated_at DESC.
Los nuevos loaders viven en node_groups.cpp:
- node_groups_count_for_group -> SELECT count(*) ...
- node_groups_page_for_group -> SELECT id,name,type_ref,status,
updated_at ... LIMIT ? OFFSET ?
Para columnas, opcion (A) del issue: pre-popular meta.columns con la
lista fija al abrir kind=Group, asi el render se mantiene generico.
NodeGroupsRow.values guarda los 5 campos en ese orden y row.id es la
key natural (= entity_id de la fila — al ser ya entidad, no hace falta
promocionarla).
Render en views.cpp ramifica por kind:
- Table: layout original [id_col + columns + promoted] con doble
click -> promote/focus.
- Group: layout [columns fijas] sin promoted. Doble click sobre la
fila ya pone want_focus_entity = id (los flujos posteriores 0036c-e
afinan UX). Right click ofrece "Focus in Inspector".
main.cpp dispatcha por kind al refrescar paginas y, al cerrar via X,
solo llama a node_groups_set_expanded para kind=Table (Group no usa
ese flag).
views_node_groups_windows_sync se hace kind-aware: solo reconcilia
entries kind=Table contra el set de Tables expandidas; no toca las
entries kind=Group (las gestiona views_node_groups_open).
Nueva API publica:
views_node_groups_open(app, container_id, kind, ops_db)
Crea o reusa la entry, setea focus_request=true y para kind=Group
pre-popula meta.columns + intenta leer `name` del Group para el
titulo. Sin caller todavia — la consume 0036c.
Tests:
- tests/test_node_groups_loader.py (6 tests) verifica el contrato
SQL via gx-cli. Nuevo subcomando `gx-cli group page <id>` espejea
el loader C++ exactamente (mismo SQL); tambien expuesto como tool
MCP `group_page` para que Echo pueda inspeccionar Groups.
Resultado:
- WSL: 89 -> 95 passed
- Windows: 78+11 -> 84+11 passed
- Build C++ Windows limpio, sin warnings nuevos.
- Regresion kind=Table: comportamiento identico (mismo render,
mismo loader DuckDB).
Refs: issues/0036b-kind-discriminator-and-group-loader.md
This commit is contained in:
@@ -0,0 +1,83 @@
|
||||
---
|
||||
id: 0036b
|
||||
title: NodeGroups window con kind (Table | Group) y loader para Groups
|
||||
status: pending
|
||||
priority: high
|
||||
created: 2026-05-04
|
||||
parent: 0036
|
||||
depends_on: [0036a]
|
||||
---
|
||||
|
||||
## Objetivo
|
||||
|
||||
Que la NodeGroups window admita dos kinds: `Table` (DuckDB-backed,
|
||||
comportamiento actual) y `Group` (entidades hijas con `group_id` set).
|
||||
La window se elige por el `type_ref` del contenedor; el loader y las
|
||||
columnas mostradas se ramifican por kind.
|
||||
|
||||
## Cambios
|
||||
|
||||
### `NodeGroupsWindowState` extendido
|
||||
|
||||
Anyadir campo:
|
||||
|
||||
```cpp
|
||||
enum class NodeGroupsKind { Table, Group };
|
||||
NodeGroupsKind kind = NodeGroupsKind::Table;
|
||||
```
|
||||
|
||||
### Loaders por kind (en `node_groups.cpp`)
|
||||
|
||||
- **kind = Table**: comportamiento actual (`node_groups_load_metadata`
|
||||
+ `node_groups_page_rows` sobre DuckDB).
|
||||
- **kind = Group**: nuevo loader que hace
|
||||
`SELECT id, name, type_ref, status, updated_at FROM entities
|
||||
WHERE group_id = ? ORDER BY updated_at DESC LIMIT ? OFFSET ?`
|
||||
+ `SELECT count(*)` para `total_rows`.
|
||||
Las columnas que se renderizan son fijas:
|
||||
`id, name, type_ref, status, updated_at`.
|
||||
|
||||
Convertir el dispatch en un metodo o switch dentro de
|
||||
`node_groups_load_metadata` y `node_groups_page_rows` que mire `kind`.
|
||||
|
||||
### Columnas dinamicas en el render
|
||||
|
||||
Hoy `views.cpp` (en la pintura de la window) asume las columnas
|
||||
DuckDB. Adaptar para que cuando `kind == Group` use las columnas
|
||||
fijas listadas arriba.
|
||||
|
||||
### Apertura programatica
|
||||
|
||||
Para que 0036c pueda abrir una window de Group, exponer una API
|
||||
limpia tipo:
|
||||
|
||||
```cpp
|
||||
NodeGroupsWindowState* node_groups_open(AppState& app,
|
||||
const std::string& container_id,
|
||||
NodeGroupsKind kind);
|
||||
```
|
||||
|
||||
Que crea la entrada en `app.node_groups_windows[container_id]` si no
|
||||
existe, le pone el kind, y retorna puntero. El caller puede setear
|
||||
`focus_request = true` antes de devolver el control al render.
|
||||
|
||||
## Acceptance criteria
|
||||
|
||||
- Tests pytest siguen verdes.
|
||||
- Manual: insertar via SQL un nodo `Group` con 5 entidades hijas
|
||||
(`group_id = <ese group>`), luego en la app llamar a
|
||||
`node_groups_open(app, "<group_id>", Group)` (o disparar via test
|
||||
unitario en C++ si se incluye), recargar render → la window
|
||||
muestra las 5 entidades con columnas id/name/type_ref/status/
|
||||
updated_at correctas.
|
||||
- Apertura de un Table existente (kind=Table) sigue funcionando
|
||||
identico (regresion).
|
||||
|
||||
## TBD
|
||||
|
||||
Branch `issue/0036b-kind-and-group-loader`, merge `--no-ff` a master.
|
||||
|
||||
## Out of scope
|
||||
|
||||
- Disparar drill-in desde doble click sobre Group (es 0036c).
|
||||
- Promote / row click (0036d-e).
|
||||
Reference in New Issue
Block a user