metis-desk/docs/auditorias/workplace-node-actions/04-trazabilidad.md

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. Los fallos globales previos se consignan allí por separado.