metis-desk/docs/funcionalidades-archivadas.md

65 lines
3.8 KiB
Markdown
Raw Permalink Normal View History

# Funcionalidades archivadas
## Tickets e intervenciones
El 15 de octubre de 2026 se retiran tickets, intervenciones y plantillas de intervención,
incluidos sus catálogos globales y de compañía. Se conservan compañías, personas,
procesos, inventario, configuraciones y soporte remoto de activos.
El código está en [archive/tickets-and-interventions](../archive/tickets-and-interventions/):
- `source/`: 167 archivos originales de dominio, aplicación, HTTP, persistencia,
contratos, frontend y pruebas, incluido el panel de trabajo pendiente.
- `integration/`: versiones anteriores de los archivos compartidos que componían estas
funcionalidades: módulo, dashboard, rutas, navegación, traducciones, scripts y documentación.
Son referencias para reintegrar, no archivos que deban sobrescribirse.
- `manifest.json`: ruta original y SHA-256 de cada archivo conservado.
La comprobación documental del 15 de octubre de 2026 detecta dos entradas cuyo SHA-256
no coincide con el fichero conservado: `integration/modules/companies/src/common/locales/es.json`
y `integration/modules/companies/src/common/locales/en.json`. Ambos ficheros coinciden con
su versión en Git; la discrepancia del manifiesto ya existía y esta revisión no modifica
el archivo. Las otras 253 entradas coinciden. Revisar esas dos entradas antes de utilizar
el manifiesto como comprobación íntegra de una recuperación.
El archivo queda fuera de los workspaces de PNPM, del ámbito TypeScript y de Biome y
ESLint. Ningún archivo activo lo importa. No es un paquete ejecutable ni un flag.
## Aplicación activa
Se retiran menús, rutas, formularios, exportaciones, endpoints y consultas de estas
entidades. Las direcciones antiguas muestran página no encontrada; los endpoints devuelven
404. El dashboard conserva inventario, alertas, actividad y acciones disponibles.
Las utilidades SQL que también usan accesos, procesos y snapshots se conservan en
`relational-sql.ts`, sin dependencia del archivo.
## Base de datos
[removeArchivedSupportTables](../modules/companies/src/api/infrastructure/persistence/remove-archived-support-tables.ts)
se ejecuta desde el composition root de Companies al arrancar. Retira una lista explícita
de 19 tablas: raíces, revisiones, destinos, pasos, procedimientos, plantillas y contadores.
Las migraciones antiguas de creación se archivan y dejan de ejecutarse.
Antes de borrar, comprueba que ninguna tabla activa tenga claves foráneas hacia las
tablas retiradas. Elimina hijos antes que padres sin desactivar la integridad referencial.
MariaDB confirma cada operación DDL; ante una interrupción, la siguiente ejecución
continúa con las tablas restantes. La operación es idempotente.
La retirada elimina los datos de estas funcionalidades. Archivar código no conserva
registros de negocio: recuperarlos requiere una copia previa de la base. La recarga
automática de desarrollo también puede ejecutar la migración al detectar los cambios.
## Reincorporación futura
1. Restaurar las fuentes necesarias bajo sus rutas originales, consultando el manifiesto.
2. Reintegrar composición, contratos, consultas, rutas y traducciones usando `integration/`
como referencia y respetando los cambios posteriores del proyecto.
3. Sustituir la migración de retirada por una migración explícita de creación o restauración.
Restaurar archivos o un dump mientras siga activa la retirada no recupera la funcionalidad.
4. Recuperar registros desde una copia previa, si existe, y reactivar las pruebas archivadas.
5. Ejecutar las comprobaciones completas y verificar los flujos en navegador.
La integración activa prueba tablas pobladas con claves foráneas, referencias externas,
idempotencia y conservación de compañías, activos, recursos y usuarios. Las pruebas web
comprueban la ausencia de destinos retirados y los resúmenes restantes en es/en.