Files
graph_explorer/issues/0036b-kind-discriminator-and-group-loader.md
T
egutierrez d6e13fddc3 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
2026-05-04 00:52:25 +02:00

84 lines
2.5 KiB
Markdown

---
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).