M GAP (Gestión de Activos y Permisos)
M GAP es una plataforma integral de Gestión de Riesgos, Activos y Control de Acceso, diseñada para cumplimiento normativo (ISO 27001, PCI-DSS, BCRA). Centraliza la gestión de activos, identifica vulnerabilidades asociadas a amenazas y aplica controles para mitigar riesgos operativos y de ciberseguridad.
Características Principales
- Gestión de Activos (Recursos): Inventario, clasificación por tipo e impacto, asignación a áreas y usuarios con trazabilidad histórica.
- Gestión de Amenazas: Registro de amenazas con nivel de amenaza, clasificación por tipo y vinculación a vulnerabilidades.
- Gestión de Vulnerabilidades: Control de vulnerabilidades con severidad y vinculación a recursos y amenazas.
- Gestión de Riesgos: Cálculo automático del riesgo inherente y residual según la metodología documentada en Cálculo de Riesgo.
- Controles Mitigantes: Asignación histórica de controles a riesgos, con nivel de control y estados de vida (Planificado / En revisión / Implementado).
- Control de Acceso: Autorización de la aplicación mediante cuatro roles de sistema fijos, independiente del modelo de permisos del dominio GRC.
- Auditoría: Registro histórico de cambios con trazabilidad de usuario, dirección IP y timestamp.
- Notificaciones: Alertas automáticas por vencimiento de permisos y asignaciones para el usuario autenticado.
- Dashboards y Reportes: Dashboard principal, dashboards temáticos, reportes de permisos y cobertura, exportación a Excel/PDF y exportación CSV en listados.
- Backups: Copias de seguridad generadas con compresión y cifrado, además de carga, descarga y restauración.
Stack Tecnológico
| Capa | Tecnología |
|---|---|
| Backend | Laravel 11 (PHP 8.2+) |
| Frontend | React 18 + Inertia.js v2 |
| UI | Material UI (MUI) v5 + Tailwind CSS |
| Build | Vite |
| Base de datos | MySQL (principal) |
| Autorización | spatie/laravel-permission con tablas auth_* |
| Rutas frontend | Ziggy (route() global) |
Requisitos previos
Para ejecutar M-GAP en Windows se requiere:
- Windows 10/11
- XAMPP
- PHP 8.2 o superior
- MySQL/MariaDB
- Composer
- Node.js y npm
- Git
- 7-Zip (requerido para la funcionalidad de backups)
Verificar instalación
Abrir una terminal y ejecutar:
php -v
composer -V
node -v
npm -v
git --version
### XAMPP
Instalar XAMPP y abrir el panel de control.
Para M-GAP es necesario iniciar:
- MySQL
Apache no es necesario para ejecutar la aplicación, ya que Laravel utiliza
su propio servidor de desarrollo mediante `php artisan serve`.
Se puede utilizar phpMyAdmin para crear y administrar la base de datos.
## Instalación
```bash
git clone <URL_DEL_REPOSITORIO>
cd m-gap
composer install
npm install
cp .env.example .env
php artisan key:generate
# Configurar las variables DB_* de MySQL en .env
php artisan migrate --seed
npm run dev
# En otra terminal:
php artisan serve
# La aplicación estará disponible en http://localhost:8000
MySQL es la base de datos principal del proyecto. El archivo .env.example incluye SQLite como configuración inicial de ejemplo; al copiarlo, completar las variables DB_* con la conexión MySQL correspondiente. Los tests utilizan SQLite en memoria mediante phpunit.xml.
Para levantar el stack completo de desarrollo (servidor Laravel, worker de cola, logs de Pail y Vite):
composer run dev
Seeders
php artisan db:seed # Ejecuta DatabaseSeeder completo
php artisan db:seed --class=GrcDemoSeeder # Datos demo GRC base
php artisan db:seed --class=DatosDemoSeeder # Ampliación de datos demo
php artisan db:seed --class=RolesSistemaSeeder # Roles y usuarios del sistema
php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder # Dataset masivo alternativo
php artisan migrate:refresh --seed # Reconstruye la base y carga DatabaseSeeder
DatabaseSeeder ejecuta, en este orden:
- Crea
test@example.comsi todavía no existe. - Ejecuta
GrcDemoSeedercon los datos GRC base. - Ejecuta
DatosDemoSeedercon datos demo adicionales y relaciones históricas. - Ejecuta
RolesSistemaSeedercon los roles de autenticación y usuarios de ejemplo.
DatosDemoSeeder requiere los datos base que aporta GrcDemoSeeder; para evitar dependencias incompletas, se recomienda ejecutar php artisan db:seed mediante DatabaseSeeder en lugar de invocarlo de forma aislada. DashboardMassiveSeeder es un dataset alternativo, requiere una base de negocio vacía y se ejecuta una sola vez por ciclo de migraciones. Los seeders demo solo están habilitados en entornos local y testing; en otros entornos DatabaseSeeder se limita a crear los roles del sistema sin cuentas demo.
Credenciales de desarrollo por defecto, todas con contraseña Password@1:
| Usuario | Rol del sistema |
|---|---|
test@example.com |
administrador |
visor@example.com |
visor |
consultor@example.com |
consultor |
pendiente@example.com |
pendiente |
Los usuarios registrados mediante el formulario público reciben el rol consultor por defecto.
Los seeders coordinan sus asignaciones históricas para no duplicar a Roberto Fernández como responsable de Sistemas y Ciberseguridad.
Los seeders son idempotentes dentro de un mismo ciclo de migraciones. Repetir php artisan db:seed sin refrescar la base no duplica pivotes históricos ni sobrescribe cambios manuales sobre registros existentes. También se preservan las contraseñas y los roles de sistema ya asignados. RolesSistemaSeeder solo asigna el rol predeterminado correspondiente a cada cuenta demo que todavía no tenga ningún rol.
La tabla seeder_runs registra las cargas no repetibles: protege los eventos demo de GrcDemoSeeder y DatosDemoSeeder, marca el dataset estándar como excluyente del masivo y protege la carga completa de DashboardMassiveSeeder. Al ejecutar php artisan migrate:refresh --seed, todas las tablas se reconstruyen, seeder_runs vuelve a crearse vacía y se cargan nuevamente todos los datos incluidos en DatabaseSeeder. Para usar el dataset masivo en lugar del demo estándar, ejecutar php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder. Ambos datasets calculan sus riesgos con la metodología documentada después de crear las relaciones históricas y los controles.
Comandos Disponibles
| Comando | Descripción |
|---|---|
php artisan serve |
Servidor de desarrollo local |
composer run dev |
Laravel server + queue + Pail + Vite en paralelo |
npm run dev |
Servidor de desarrollo Vite |
npm run build |
Build de producción |
php artisan migrate:refresh --seed |
Reconstruir la base y volver a cargar DatabaseSeeder |
php artisan db:seed |
Ejecutar DatabaseSeeder de forma idempotente |
php artisan migrate:refresh --seed --seeder=DashboardMassiveSeeder |
Reconstruir la base con el dataset masivo alternativo para dashboards |
php artisan test |
Ejecutar todos los tests PHPUnit |
php artisan test --filter=RiesgoManagementTest |
Tests específicos de riesgos |
php artisan riesgos:recalcular |
Recalcular los scores de riesgos activos |
php artisan backup:create {--frequency=} |
Crear un backup cifrado de la base de datos |
php artisan backup:restore {backupId} |
Restaurar un backup desde CLI |
php artisan permission:cache-reset |
Limpiar la caché de roles y permisos |
vendor/bin/pint |
Formatear código PHP con Laravel Pint |
Los comandos riesgos:recalcular y backup:create están programados en routes/console.php. El primero se ejecuta diariamente y el segundo cada minuto. backup:create lee la configuración de backup_settings (frecuencia, is_active, run_time, run_day) y ejecuta el backup solo cuando coincide el día y la hora configurados. Las invocaciones manuales con --frequency=manual siempre se ejecutan ignorando la configuración.
Para que las tareas programadas se ejecuten, algo tiene que invocar php artisan schedule:run cada minuto. En este proyecto se usa una tarea del Programador de tareas de Windows (M-GAP Backup Scheduler) que ejecuta backup-scheduler.bat cada minuto a través de un launcher oculto (backup-scheduler-hidden.vbs). En Linux se usaría cron ejecutando el mismo comando.
La run_time se interpreta en la zona horaria de APP_TIMEZONE (definida en .env).
Cálculo de Riesgo ISO 27001
El sistema calcula automáticamente el nivel de riesgo inherente y residual para cada riesgo registrado.
Fórmula
P_inherente = A + V
P_residual = max(0, P_inherente - C)
R_inherente = P_inherente × I
R_residual = P_residual × I
Donde:
| Variable | Descripción | Escala |
|---|---|---|
| A | Nivel de amenaza | 1-4 |
| V | Severidad de vulnerabilidad | 0-4 |
| C | Efectividad total de controles implementados | 1-4, con máximo 4 |
| I | Impacto del recurso | 1-4 |
Nivel de Amenaza (A)
| Nivel | Valor |
|---|---|
| Bajo | 1 |
| Medio | 2 |
| Alto | 3 |
| Crítico | 4 |
Severidad de Vulnerabilidad (V)
| Severidad | Valor |
|---|---|
| Baja | 1 |
| Media | 2 |
| Alta | 3 |
| Crítica | 4 |
Regla V=0: cuando la relación histórica recurso-vulnerabilidad no está vigente (la fecha de fin fue alcanzada o no existe la relación), la severidad de vulnerabilidad se considera 0.
Impacto del Recurso (I)
| Impacto | Valor |
|---|---|
| Bajo | 1 |
| Medio | 2 |
| Alto | 3 |
| Crítico | 4 |
Efectividad de Controles (C)
La efectividad se obtiene desde controles.nivel_de_control, no desde un valor independiente en el pivot:
| Nivel de control | Valor |
|---|---|
| Débil | 1 |
| Parcial | 2 |
| Fuerte | 4 |
- Solo se contabilizan controles con estado Implementado y sin
fecha_finen la asignaciónriesgo_control. - Si hay múltiples controles activos, se suman sus valores y el total se limita a un máximo de 4.
- El calculador aplica
LOWER()antes de comparar, por lo que acepta cualquier capitalización (fuerte,FUERTE,Fuerte, etc.).
Clasificación del Resultado (R)
| Rango de R | Nivel de Riesgo |
|---|---|
| 0 - 4 | Bajo |
| 5 - 9 | Medio |
| 10 - 19 | Alto |
| 20 - 32 | Crítico |
El rango máximo teórico es 32 (A=4, V=4, C=0, I=4).
Ejemplo Práctico
Recurso: Base de Datos Tarjetas (Impacto = Crítico -> I=4)
Amenaza: Exposición de PAN (Nivel = Crítico -> A=4)
Vulnerabilidad: DB sin cifrado en reposo (Severidad = Crítica -> V=4)
Control: Tokenización PCI-DSS (Implementado, nivel Fuerte -> C=4)
P_inherente = 4 + 4 = 8
P_residual = max(0, 8 - 4) = 4
R_inherente = 8 x 4 = 32 -> Crítico
R_residual = 4 x 4 = 16 -> Alto
Recálculo Automático
Los scores se recalculan cuando:
- Se crea un nuevo riesgo.
- Se edita un riesgo mediante sus operaciones de gestión.
- Se asocia, actualiza o desasocia un control del riesgo.
- Se actualiza el nivel de una amenaza; se recalculan inmediatamente todos sus riesgos activos relacionados.
- Se actualiza la severidad de una vulnerabilidad; se recalculan inmediatamente todos sus riesgos activos relacionados.
- Se ejecuta
php artisan riesgos:recalcular, programado diariamente.
El comando php artisan riesgos:recalcular mantiene su función como recálculo global y mecanismo de reconciliación para todos los riesgos activos.
Validación de Enums Canónicos
Los campos enumerados están validados en backend (Laravel Rule::in / in:) y frontend (Yup .oneOf). Valores no canónicos rechazan con error de validación. Las opciones de combo se centralizan en resources/js/constants/enums.js (módulo compartido) para ESTADOS_CONTROL y NIVELES_CONTROL.
| Campo | Valores válidos | Archivos backend | Archivos frontend |
|---|---|---|---|
controles.estado |
Implementado | En revisión | Planificado |
ControlController, ControlGestionController |
Controles/Create.jsx, Edit.jsx, Gestionar.jsx |
controles.nivel_de_control |
fuerte | parcial | debil |
ControlController, ControlGestionController |
Controles/Create.jsx, Edit.jsx, Gestionar.jsx |
amenazas.nivel_de_amenaza |
Bajo | Medio | Alto | Crítico |
AmenazaController, AmenazaGestionController |
Amenazas/Create.jsx, Gestionar.jsx |
amenazas.fuente |
Interna | Externa |
AmenazaController, AmenazaGestionController |
Amenazas/Create.jsx, Gestionar.jsx |
amenazas.origen |
Humana | Natural | Ambiental | Tecnológica |
AmenazaController, AmenazaGestionController |
Amenazas/Create.jsx, Gestionar.jsx |
vulnerabilidades.severidad |
Baja | Media | Alta | Crítica |
StoreVulnerabilidadRequest, VulnerabilidadGestionController |
Vulnerabilidades/Create.jsx, Gestionar.jsx |
vulnerabilidades.fuente |
Interna | Externa | Ambas |
StoreVulnerabilidadRequest, VulnerabilidadGestionController |
Vulnerabilidades/Create.jsx, Gestionar.jsx |
recursos.impacto |
Bajo | Medio | Alto | Crítico |
RecursoController, RecursoGestionController |
Recursos/Create.jsx, Gestionar.jsx |
permisos.estado |
1 | 0 |
PermisoController, PermisoGestionController |
Permisos/Create.jsx |
Longitudes Máximas Canónicas
Los campos de texto tienen longitudes máximas validadas en backend (max:) y frontend (.max() + inputProps maxLength). Se aplican tanto al alta (store) como a la edición (update).
| Campo | Límite | Archivos principales |
|---|---|---|
nombre, apellido |
35 | Controllers, Create.jsx, Edit.jsx, Gestionar.jsx |
correo, telefono |
35 | AreaController, UsuarioController, Create.jsx, Edit.jsx, Gestionar.jsx |
descripcion, justificacion, accion |
185 | Controllers, Create.jsx, Edit.jsx, Gestionar.jsx |
documento |
20 | UsuarioController, Usuarios/Create.jsx |
direccion, motivo_alta |
35 | AreaController, Areas/Create.jsx |
Control de Acceso
M GAP tiene dos modelos de roles independientes:
- Roles del sistema: autorizan acciones en la aplicación y se implementan con
spatie/laravel-permissionsobreusers. - Roles del dominio GRC: forman el modelo de negocio Usuario -> Rol -> Perfil -> Permiso mediante las tablas
usuarios,roles,perfilesypermisos. No controlan el login ni la autorización de rutas.
Las tablas de Spatie utilizan el prefijo auth_ (auth_roles, auth_permissions, auth_model_has_roles, entre otras) para evitar colisiones con las tablas de dominio.
Roles del Sistema
| Rol | Acceso |
|---|---|
administrador |
Acceso total, incluyendo escritura, parametría, backups y seguridad. |
visor |
Lectura de módulos permitidos, exportación CSV, dashboards y reportes. Sin auditorías, notificaciones, backups, tipos ni seguridad. |
consultor |
Dashboards y reportes. |
pendiente |
Pantalla de bienvenida. Sin acceso a módulos. Se asigna a nuevos registros y al cambiar el rol desde administración. |
- Las rutas utilizan el alias
role:deRoleMiddleware, registrado enbootstrap/app.php. - Los errores HTTP 403 renderizan
resources/js/Pages/Error.jsxmediante Inertia. - La gestión de roles del sistema se realiza en
/seguridad/usuarios, solo para administradores. - Un administrador no puede quitarse a sí mismo el rol
administrador. HandleInertiaRequestscomparteauth.rolescon el frontend.resources/js/utils/permissions.jsexponeuseRoles()yuseCanWrite().Sidebar.jsxfiltra las opciones visibles según el rol, pero la autorización efectiva siempre se valida en el backend.- Después de cambiar roles o permisos en código, ejecutar
php artisan permission:cache-reset.
Dashboards y Reportes
Dashboards
| Ruta | Descripción |
|---|---|
/tablero |
Tablero General: métricas generales, distribución de riesgos inherentes/residuales, cobertura de controles y matriz vulnerabilidad × impacto. |
/tablero/accesos |
Métricas de accesos y permisos: usuarios, roles, perfiles por permisos y perfiles por rol. |
/tablero/riesgos |
Análisis de riesgos. |
/tablero/cumplimiento |
Indicadores de cumplimiento: controles, cobertura, treemap con drilldown de recursos por tipo y estado de revisiones. |
/tablero/catalogo-activos |
Catálogo de activos: inventario, distribución por tipo, impacto, áreas y asignaciones. |
Los dashboards están disponibles para los tres roles del sistema.
Reportes
| Ruta | Descripción |
|---|---|
/reportes |
Panel principal de reportes. |
/reportes/permisos-efectivos |
Matriz de permisos efectivos Usuario -> Rol -> Perfil -> Permiso vigente. |
/reportes/permisos-nuevos |
Permisos otorgados en un rango de fechas. |
/reportes/permisos-baja |
Permisos dados de baja. |
/reportes/permisos-expiran |
Permisos próximos a vencer. |
/reportes/acceso-recursos |
Acceso a recursos, usuarios y perfiles, incluyendo recursos sin asignar. |
/reportes/relaciones-cobertura |
Matriz recursos x perfiles y distribución por tipo. |
Los reportes contienen filtros interactivos y posibilidad de exportan a Excel y PDF.
Notificaciones
NotificacionService genera alertas bajo demanda al cargar páginas Inertia autenticadas, deduplicadas sin repetir el mismo título dentro de siete días, para:
- Permisos de perfiles vencidos o próximos a vencer.
- Asignaciones de recursos, áreas y perfiles vencidas o próximas a vencer.
- Relaciones cuya fecha de vencimiento está dentro de los próximos siete días.
Las notificaciones se vinculan al usuario de login mediante la correspondencia users.email = usuarios.correo. El contador y las notificaciones recientes se comparten a todo usuario autenticado; la página de notificaciones está disponible solo para administrador.
Endpoints principales:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /notificaciones |
Colección completa filtrada y ordenada en el servidor, con búsqueda local y paginación en el navegador de 10 filas. |
| GET | /notificaciones/count |
Contador y notificaciones recientes. |
| POST | /notificaciones/{id}/leer |
Marcar una notificación como leída. |
| POST | /notificaciones/leer-todas |
Marcar todas como leídas. |
Auditoría
El trait App\Traits\LogsAuditoria registra automáticamente operaciones de creación, actualización y eliminación en auditorias.
- Guarda acción, tabla, identificador, valores anterior y nuevo en JSON, usuario e IP.
- Se utiliza en los modelos de dominio de áreas, amenazas, controles, perfiles, permisos, recursos, riesgos, roles, tipos, usuarios y vulnerabilidades.
- Si no hay usuario autenticado, utiliza
user_id = 1como fallback. - El listado y los endpoints de exportación están disponibles solo para
administrador. En la interfaz, CSV, XLSX y PDF exportan todos los registros filtrados localmente con las columnas, el orden y los valores formateados visibles en la tabla, sin controles de acciones.
Backups
Requisito para Backups
Las funciones de backup utilizan 7-Zip para generar archivos comprimidos con cifrado AES-256.
Instalar 7-Zip y verificar que el ejecutable esté disponible según la configuración utilizada por el proyecto.
Por defecto el proyecto busca C:/Program Files/7-Zip/7z.exe. Si 7-Zip
se instaló en otra ubicación, configurar BACKUP_7ZIP_PATH en .env.
El password de cifrado (BACKUP_PASSWORD) debe estar definido en .env;
sin este valor, el comando backup:create rechaza la operación.
El módulo de backups está disponible únicamente para administrador.
backup:creategenera un dump de MySQL, lo comprime y lo cifra mediante 7-Zip AES-256.- Los backups generados por el comando se registran como backups completados; los archivos subidos desde la interfaz se aceptan como ZIP con SQL y la interfaz no verifica que estén cifrados.
- La frecuencia puede configurarse como diaria, semanal o mensual desde
/backups, incluyendo la hora (run_time) y el día de la semana/mes (run_day). - El scheduler invoca
backup:createcada minuto. El comando consultabackup_settingsy solo ejecuta cuando coinciden el día y la hora configurados. La tareaM GAP Backup Schedulerejecutaphp artisan schedule:runcada minuto víabackup-scheduler.bat(lanzado oculto porbackup-scheduler-hidden.vbs). - Se conservan hasta 15 copias exitosas por defecto (
BACKUP_RETENTIONen.env). Al superar el límite, la copia más antigua se elimina automáticamente. La interfaz muestra un aviso antes de crear o subir una nueva copia cuando ya se alcanzó el límite. - La interfaz permite listar, crear, subir, descargar, restaurar y eliminar backups.
php artisan backup:restore {backupId}restaura un backup desde CLI e intenta crear antes un dump temporal de seguridad. Ese dump no se registra como backup persistente y la restauración continúa aunque no pueda crearse.
Rutas principales:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /backups |
Listado y configuración. |
| POST | /backups |
Crear backup. |
| POST | /backups/upload |
Subir backup. |
| POST | /backups/{backup}/restore |
Restaurar backup desde la interfaz. |
| GET | /backups/{backup}/download |
Descargar backup. |
| DELETE | /backups/{backup} |
Eliminar backup. |
| PUT | /backups/settings |
Actualizar configuración. |
Estructura del Proyecto
m-gap/
├── app/
│ ├── Console/Commands/ # RecalculateRiesgos, BackupCreateCommand, BackupRestoreCommand
│ ├── Http/Controllers/ # CRUD, gestión, dashboards y reportes
│ ├── Http/Middleware/ # HandleInertiaRequests
│ ├── Http/Requests/ # Validaciones FormRequest
│ ├── Http/Resources/ # Resources API
│ ├── Models/ # Modelos Eloquent
│ ├── Services/ # Servicios como NotificacionService
│ ├── Support/ # RiskCalculator, HistoricalPeriod, AreaResponsibilityHistory, BackupRetention
│ └── Traits/ # LogsAuditoria
├── config/permission.php # Configuración de Spatie y tablas auth_*
├── database/
│ ├── migrations/ # Incluye 2026_08_20_000002_create_seeder_runs_table.php
│ └── seeders/ # DatabaseSeeder, GrcDemoSeeder, DatosDemoSeeder, RolesSistemaSeeder, DashboardMassiveSeeder y Concerns/SeedsSafely
├── resources/js/
│ ├── Components/ # Componentes reutilizables y combos
│ ├── constants/ # enums.js (ESTADOS_CONTROL, NIVELES_CONTROL)
│ ├── Layouts/ # AuthenticatedLayout
│ ├── Pages/ # Páginas Inertia
│ ├── context/ # AlertContext
│ ├── service/ # api.js y fetchers de combos
│ ├── theme/ # MGAP-Theme.js
│ └── utils/ # permissions, exportUtils, date y filtros
├── routes/
│ ├── web.php # Rutas principales
│ ├── api.php # Endpoints JSON auxiliares
│ ├── auth.php # Rutas de autenticación (Breeze)
│ └── console.php # Programación de comandos
└── tests/
├── Feature/ # Tests de integración
└── Unit/ # Tests unitarios
Convenciones
- Los módulos CRUD suelen utilizar
Index.jsxpara listados,Create.jsxpara altas yGestionar.jsxpara fichas editables y relaciones históricas. - Algunos módulos incluyen también
Edit.jsx; los módulos de tipos compartenGeneric/Gestionar.jsxcuando corresponde. - Las relaciones many-to-many utilizan pivots con fechas históricas (
fecha_inicio,fecha_identificacionyfecha_fin). - Las relaciones históricas se finalizan conservando el registro del pivot, en lugar de eliminarlo.
- El índice de áreas muestra un único responsable vigente. Una responsabilidad está vigente cuando
fecha_inicio <= ahorayfecha_fines nula o posterior a ahora; si existen períodos históricos superpuestos, el vigente con lafecha_iniciomás reciente es el canónico. - Las entidades con historial siguen una política de preservación: se rechaza la eliminación cuando existen registros asociados (protegido por constraints FK). No se utilizan SoftDeletes ni se marca la entidad como inactiva.
- Los formularios de alta no incluyen campos de riesgo inherente o residual; esos valores se calculan en backend.
Rutas
Las rutas web se agrupan por autenticación y rol. Los módulos de lectura suelen estar disponibles para administrador y visor; las operaciones de escritura, backups y seguridad requieren administrador. Auditorías y notificaciones son exclusivas de administrador.
Módulos de Dominio
Los siguientes módulos comparten el patrón general: áreas, amenazas, controles, vulnerabilidades, permisos, roles, perfiles, usuarios y recursos.
Operaciones de lectura:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /{modulo} |
Colección completa filtrada y ordenada en el servidor, con búsqueda local y paginación en el navegador de 10 filas. |
| GET | /{modulo}/export |
Exportación CSV del servidor en los módulos que exponen este endpoint; el CSV local exporta todos los registros filtrados con las columnas y el formato de la tabla visible, sin acciones. |
| GET | /{modulo}/{entidad}/gestionar |
Ficha de la entidad y relaciones históricas. |
Operaciones de escritura, solo para administradores:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /{modulo}/create |
Formulario de alta. |
| POST | /{modulo} |
Crear entidad. |
| PUT / DELETE | /{modulo}/{entidad} |
Actualizar o eliminar entidad, cuando aplica. |
| PUT | /{modulo}/{entidad}/campo |
Actualizar un campo individual. |
| POST | /{modulo}/{entidad}/{relacion} |
Asociar una relación histórica. |
| PUT | /{modulo}/{entidad}/{relacion}/{pivotId} |
Actualizar una asignación. |
| DELETE | /{modulo}/{entidad}/{relacion}/{pivotId} |
Finalizar una asignación conservando el historial. |
Relaciones gestionadas por módulo:
| Módulo | Relaciones |
|---|---|
areas |
usuarios, recursos |
amenazas |
vulnerabilidades |
controles |
riesgos |
vulnerabilidades |
amenazas, recursos |
permisos |
perfiles |
roles |
usuarios, perfiles |
perfiles |
roles, permisos, recursos |
usuarios |
areas, roles, recursos |
recursos |
usuarios, areas, perfiles, vulnerabilidades |
Riesgos
Riesgos utiliza una edición específica porque sus puntajes se calculan automáticamente:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /riesgos |
Listado de riesgos. |
| GET | /riesgos/create |
Formulario de alta. |
| POST | /riesgos |
Crear riesgo y calcular sus puntajes. |
| GET | /riesgos/{riesgo}/gestionar |
Ficha del riesgo y controles asociados. |
| PUT | /riesgos/{riesgo}/campo |
Actualizar un campo individual. |
| DELETE | /riesgos/{riesgo} |
Eliminar o preservar según las reglas del módulo. |
| POST | /riesgos/{riesgo}/controles |
Asociar control. |
| PUT | /riesgos/{riesgo}/controles/{pivotId} |
Actualizar asignación de control. |
| DELETE | /riesgos/{riesgo}/controles/{pivotId} |
Finalizar asignación de control. |
Riesgos no tiene ruta update general ni endpoint de exportación CSV en el servidor; su listado sí exporta CSV local. La edición se realiza campo a campo.
Parametros, auditoría y operaciones especiales
| Módulo | Rutas principales | Acceso |
|---|---|---|
| Tipos | /tipos-usuarios, /tipos-recursos, /tipos-controles, /tipos-amenazas, /tipos-vulnerabilidades |
Solo administrador; CRUD, gestionar y campo. tipos-vulnerabilidades no tiene update general. |
| Auditorías | /auditorias, /auditorias/export |
Solo administrador. |
| Notificaciones | /notificaciones, /notificaciones/count, /notificaciones/{id}/leer, /notificaciones/leer-todas |
Solo administrador. |
| Catálogo | /tablero/catalogo-activos |
Los tres roles. |
| Asignación de usuarios | /asignar-usuario y endpoints store/detach + update |
Lectura para administrador y visor; escritura solo administrador. |
| Seguridad | /seguridad/usuarios, PUT /seguridad/usuarios/{user}/rol |
Solo administrador. |
| Perfil | /profile |
Usuario autenticado: consultar, actualizar o eliminar su perfil. |
API Auxiliar
Los endpoints de API requieren auth:sanctum y son consumidos principalmente desde resources/js/service/api.js:
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/user |
Usuario autenticado. |
| GET | /api/combos/areas |
Combo de áreas. |
| GET | /api/combos/roles |
Combo de roles. |
| GET | /api/combos/perfiles |
Combo de perfiles. |
| GET | /api/combos/tipos-usuarios |
Combo de tipos de usuario. |
| GET | /api/combos/tipos-recursos |
Combo de tipos de recurso. |
| GET | /api/combos/tipos-controles |
Combo de tipos de control. |
| GET | /api/combos/tipos-amenazas |
Combo de tipos de amenaza. |
| GET | /api/combos/amenazas |
Combo de amenazas. |
| GET | /api/combos/recursos |
Combo de recursos. |
| GET | /api/combos/vulnerabilidades |
Combo de vulnerabilidades. |
| GET | /api/combos/controles |
Combo de controles. |
| GET | /api/usuarios/buscar |
Búsqueda de usuarios del dominio. |
Desarrollado por Mauro Joannas y Rodrigo Legoff - Matriz de gestion para los activos y permisos (M GAP)