metis-desk/docs/plan-de-desarrollo.md
2026-10-07 13:26:59 +02:00

10 KiB

Plan de desarrollo

Metis Desk es una aplicación interna para técnicos que dan soporte a pequeñas empresas. El proyecto es independiente de factuges-erp y comparte sus convenciones de programación.

Entrega 0: base técnica

Incluye monorepo PNPM y Turborepo, TypeScript estricto, Biome, Express, React, Vite, Tailwind, TanStack Query, shadcn/ui con Base UI, Zod y traducciones es/en. La página inicial muestra la conexión real con la API. No contiene datos ficticios de clientes.

Acceso y usuarios: implementado

MariaDB, Sequelize v6, migraciones iniciales, configuración única del administrador, login, sesiones y gestión de usuarios sin catálogo de roles. React Hook Form y componentes shadcn/ui para estos formularios.

Entrega 1: compañías clientes, implementado

Crear, consultar, editar y buscar compañías; activar o desactivar compañías y contactos; crear y editar sedes con dirección opcional. Formularios con React Hook Form, listado con TanStack Table y componentes shadcn/ui. Consultar Compañías, contactos y sedes.

Distinguir:

  • Organización que presta el soporte: contexto de acceso.
  • Cliente atendido: empresa sobre la que se registran datos.
  • Técnico: usuario autenticado de Metis Desk.
  • Contacto: persona del cliente.
  • Usuario de un equipo: persona asignada a un puesto; no implica acceso a la aplicación.

La adopción de una sola organización o de varias se decidirá antes del modelo persistente. No crear un sistema multiempresa complejo sin necesidad, companyId identifica a la compañía cliente; no se utiliza como identificador de tenant.

Personas y departamentos: implementado

Personas sin acceso a Metis Desk, contactos como clasificación, puesto general y pertenencia a varios departamentos con puestos específicos, un principal, periodos e historial. Datos existentes e identificadores preservados. Consultar Personas y departamentos.

Cuentas, grupos y recursos: implementado

Catálogos globales con adiciones por compañía, entornos, cuentas con uso fijo y caducidad opcional, relaciones con personas, plantillas globales de grupos, pertenencias sin anidación, recursos y permisos configurables, necesidades y cobertura calculada. Las autorizaciones y configuraciones se registran por separado, con historial, actor y avisos de revisión. Consultar Cuentas, grupos y recursos.

Campos y plantillas de activos: implementado

Catálogo global con 30 campos y 12 plantillas de serie protegidas, cinco tipos de dato, copias personalizables, adiciones por compañía y ajustes locales de disponibilidad. Características opcionales por defecto, modales con ayuda y alta rápida de campos desde las plantillas. Consultar Campos y plantillas de activos.

Perfiles de usuario: base implementada

Persona y dispositivo fijos, cuenta de inicio de sesión opcional, perfiles vigentes y archivados, múltiples personas/dispositivos, historial y avisos de revisión. Consultar Perfiles de usuario. La ficha Entorno actual reúne las configuraciones implementadas; el mapa visual queda aplazado.

Buzones y correo por perfil: implementado

Buzones independientes corporativos o externos, cuenta informática opcional, periodos de uso por persona, configuraciones POP/IMAP por perfil y avisos de revisión. Los registros anteriores mantienen UUID e historial y se vinculan explícitamente. Consultar Buzones y correo por perfil.

Recursos con campos y plantillas: base implementada

Catálogo independiente de activos, 20 campos y seis plantillas de serie, adiciones globales y por compañía, disponibilidad local y recursos con especificación capturada e historial. Los buzones y recursos básicos anteriores están migrados, conservando UUID, historial y relaciones. La gestión anterior se ha retirado; sus tablas se mantienen como proyecciones para permisos y configuraciones existentes. Consultar Recursos, campos y plantillas.

Impresoras por perfil: implementado

Configuraciones USB o red sobre activos de la compañía, una predeterminada por perfil, estados de preparación y retirada, historial y avisos de revisión. Disponible desde la compañía y cada perfil. Modales, ayuda inferior y altas rápidas. Consultar Impresoras del perfil.

Aplicaciones por perfil: implementado

Recursos de plantilla Aplicación o plantilla personalizada con uso Aplicación, instaladas o de acceso web, versión opcional, estados de preparación y retirada, historial y revisión. Modales y altas rápidas de recurso/perfil. Consultar Aplicaciones del perfil.

Certificados por perfil: implementado

Recursos de plantilla Certificado digital o plantilla personalizada con ese uso, ubicación opcional, estados de preparación y retirada, historial y revisión por inactividad o caducidad. Modales y altas rápidas de recurso/perfil. Consultar Certificados del perfil.

Entorno actual: implementado

Ficha de consulta por perfil con equipo, características registradas, composición de los puestos vigentes, cuenta de inicio y configuraciones abiertas de correo, carpetas, impresoras, aplicaciones y certificados. Resumen de preparación, retirada y revisión; filtro de atención y acceso a cada gestión. Consultar Entorno actual.

Teletrabajo: autorización implementada

Autorización por persona, fechas opcionales inclusivas, revocación y renovación con historial, consulta desde Entorno actual y modales con alta rápida de persona. No modifica los permisos ni las conexiones reales. Consultar Teletrabajo.

Accesos remotos de personas: implementado

Origen corporativo o personal sin inventario detallado, herramienta libre, destino red/sede/equipo/recurso, requisito VPN, preparación y retirada, historial y revisión según autorización y disponibilidad. Consulta desde Entorno actual. Documenta accesos; no actúa sobre conexiones reales. Consultar Accesos remotos.

Procesos de personas: implementado

Plantillas globales de alta/cambio/salida, copias de instrucciones por ejecución, seguimiento por persona con tareas UUID, resultados, cierres, historial y revisión de registros actuales. Cambio y salida incorporan revisiones de cuentas, configuraciones, activos asignados y accesos remotos personales. Modales, altas rápidas y protección frente a ediciones concurrentes. Consultar Procesos de personas.

Asistencia técnica remota: implementada

Varios métodos por activo, catálogo global ampliable con herramientas de serie, destino opcional, requisito VPN, estados, preferido opcional e historial. Modales en ficha del activo y Entorno actual. Consultar Asistencia técnica remota.

Siguientes entregas: orden actualizado

  1. Vinculación explícita entre un acceso remoto y su VPN previa, si resulta necesaria.

Este orden se concreta antes de cada entrega. El registro de licencias como recursos está implementado; sus asignaciones y relaciones con cuentas, personas, equipos y aplicaciones quedan pendientes.

Inventario: implementado

Activos por compañía, plantilla capturada, sede y persona opcionales, cuatro estados, características tipadas y revisiones con actor y fecha. Altas rápidas y consulta del historial mediante modales. Consultar Inventario de activos.

Las relaciones entre activos están implementadas: catálogo global y local, cinco tipos de serie, vínculos en ambos sentidos y retirada con auditoría. Los puestos de trabajo están implementados, sin anidación, con sede y persona opcionales, composición exclusiva, recursos compartidos entre puestos vigentes e historial.

Tickets: implementados

Tickets por compañía y consulta global con búsqueda/filtros, referencia corta global además de UUID, solicitante y responsable opcionales, canales, estados, prioridades y varios elementos afectados. Modales, altas rápidas, historial, altas idempotentes y protección de edición concurrente. Consultar Tickets.

Intervenciones: implementadas

Consulta global y por compañía, técnico, tiempos, diagnóstico, trabajo realizado, resultado y elementos afectados. Varias intervenciones por ticket o actuaciones internas sin ticket. Pasos opcionales, procedimientos versionados, comprobaciones obligatorias al finalizar, historial, idempotencia y control de concurrencia. Consultar Intervenciones y plantillas.

Licencias de software: registro implementado

Plantilla global protegida, siete campos nuevos y cuatro reutilizados del catálogo de recursos. Registro por compañía, características opcionales, modalidades, criterio de licenciamiento, cantidad contratada, caducidad, renovación e historial. Modales con ayuda específica. Pendientes las asignaciones, capacidad disponible, vínculos con aplicaciones y avisos. Consultar Recursos, campos y plantillas.

Servicios y documentación: pendiente

Gestión de asignaciones de licencias, Microsoft 365, ERP, antivirus, cloud, dominios, DNS, certificados, contratos y documentación. Las credenciales se resolverán con una solución específica; no almacenarlas como texto libre.

Decisiones pendientes

Permisos por técnico si llegan a necesitarse, despliegue, backups, recuperación administrativa y modelo de organización. El acceso y los usuarios ya están implementados; la base de compañías clientes, personas, departamentos, asignaciones y sedes está implementada. El inventario está implementado; los tickets están implementados; las intervenciones están implementadas.

Plantillas de intervención

Implementadas las plantillas globales y propias por compañía con pasos ordenados, historial y seis procedimientos iniciales. Véase Intervenciones y plantillas. Las intervenciones concretas y la ejecución de los pasos están implementadas; las actuaciones sencillas admiten registro sin plantilla.