# WD04.5 — Trazabilidad de acciones

| Acción de menú | Entidad / servicio real | Composición existente | Efecto y caché |
| --- | --- | --- | --- |
| Abrir activo | Asset | BrowserLink → AssetDetailPage | Navegación, no escribe |
| Editar activo | Asset / saveAsset | AssetEditorDialog → AssetForm | Revisión de Asset; inventario de compañía y conexiones remotas |
| Historial del activo | Asset y eventos relacionados | AssetHistory en modal de Assets | Solo lecturas de historial, infraestructura y soporte |
| Gestionar equipamiento | Workstation / saveWorkstation | Editor actual de Workstation | Composición/principal e historial, If-Match; inventario de compañía |
| Gestionar software | SoftwareInstallation | WorkstationSoftwareDialog → SoftwareInstallationsPanel | Operaciones y confirmaciones del panel actual |
| Gestionar soporte | AssetSupport | AssetSupportManagementDialog → AssetSupport | Operaciones y caché por activo existentes |
| Editar instalación | SoftwareInstallation / softwareApi.save | SoftwareInstallationEditorDialog → SoftwareInstallationForm | Instalaciones, referencias/candidatos/capacidades de software de esa compañía |
| Historial de instalación | SoftwareInstallation | SoftwareHistoryDialog | Solo lectura del historial recibido |
| Abrir producto | Resource particular/global o SO global | softwareReferenceHref + BrowserLink | Navegación a ficha pública según referencia; no administra catálogo |
| Abrir licencia | Resource particular | BrowserLink a ficha de la licencia resuelta | Navegación, no consume ni modifica licencia |

El adaptador workplaceNodeActions y la composición WorkplaceNodeActionDialogs implementan esta matriz, sin nuevos endpoints, esquemas, migraciones ni permisos. Los nodos decorativos no tienen entradas. Las decisiones excluidas constan en 02-matriz-acciones.md. Los resultados ejecutados, capturas y límites se incorporan al apartado WD04.5 de docs/mapa-visual-del-puesto.md.


## Implementación y evidencias

- `helpers/workplace-node-actions.ts`: descriptores discriminados de navegación/comando, orden, contexto de compañía, pertenencia, principal, estados y disponibilidad. Resuelve UUID reales; no analiza nombres para atribuir capacidades.
- `controllers/use-workplace-node-actions.ts`: incorpora descriptores a los datos de presentación y mantiene operación, contexto y retorno de foco efímeros. No modifica el modelo persistido ni el layout.
- `ui/workplace-node-actions-menu.tsx`: DropdownMenu/Tabler con portal y teclado, común a tarjetas de React Flow y compacto.
- `WorkplaceNodeActionDialogs`, `WorkplaceAssetActionDialog`, `WorkplaceSoftwareActionDialog` y `WorkplaceInstallationEditorDialog`: composición de diálogos existentes. `WorkplaceNodeUnavailableDialog` conserva una salida cuando desaparece el registro.
- `AssetHistoryDialog`: contenedor modal del historial existente del módulo Assets, exportado junto con sus editores y soporte.
- `useSoftwareInstallationEditorData` y `softwareInstallationOptions`: lecturas con las claves actuales y adaptación compartida con la gestión completa. El editor reutilizado añade únicamente estado de carga/error y retorno de foco opcionales.

La auditoría se completó antes de estos componentes. No se añadieron operaciones de servidor, dependencias, contratos HTTP ni permisos. Las mutaciones conservan invalidaciones y confirmaciones anteriores. La comprobación de revisión de Workstation se reutiliza; Asset y SoftwareInstallation no disponen del mismo protocolo optimista y no se les atribuye una garantía nueva.

Resultados técnicos y del navegador, capturas y límites: [informe WD04.5](../../mapa-visual-del-puesto.md#wd045--acciones-contextuales-en-nodos). Los fallos globales previos se consignan allí por separado.