rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
workspace-v1/projects/erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-001-fundamentos/historias-usuario/US-MMD001-009-dashboard-uso.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4 
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

3.8 KiB
Raw Permalink Blame History

US-MMD001-009: Ver Dashboard de Uso del Sistema

Metadata

Campo Valor
ID US-MMD001-009
Epica EPIC-MMD-001 - Fundamentos
Modulo fundamentos
Prioridad P2
Story Points 3
Sprint Sprint 2
Estado Backlog
Asignado a Por asignar

Historia de Usuario

Como administrador del taller, quiero ver un dashboard con metricas de uso del sistema, para entender como se esta utilizando y detectar areas de mejora.

Descripcion Detallada

El dashboard de uso muestra metricas basicas de adopcion y utilizacion del sistema: usuarios activos, ordenes procesadas, modulos mas usados, etc. Esto ayuda al administrador a evaluar el ROI del sistema.

Criterios de Aceptacion

Escenario 1: Ver metricas de usuarios

DADO que accedo al dashboard de uso
CUANDO veo la seccion de usuarios
ENTONCES veo:
  | Metrica | Valor |
  | Usuarios registrados | 8 |
  | Usuarios activos (hoy) | 5 |
  | Usuarios activos (semana) | 7 |
  | Ultimo login | Hace 5 minutos |

Escenario 2: Ver metricas de ordenes

DADO que veo el dashboard
CUANDO reviso la seccion de ordenes
ENTONCES veo:
  | Metrica | Valor |
  | Ordenes hoy | 12 |
  | Ordenes esta semana | 45 |
  | Ordenes este mes | 180 |
  | Promedio diario | 6 |

Escenario 3: Ver actividad por modulo

DADO que veo el dashboard
CUANDO reviso uso por modulo
ENTONCES veo grafica de barras con:
  | Modulo | Accesos |
  | Ordenes | 450 |
  | Inventario | 230 |
  | Vehiculos | 180 |
  | Cotizaciones | 95 |

Escenario 4: Filtrar por periodo

DADO que quiero ver metricas del mes pasado
CUANDO selecciono "Ultimo mes" en el filtro
ENTONCES las metricas se actualizan con datos del mes anterior

Metricas a Mostrar

Usuarios

Metrica Descripcion
Total registrados Usuarios en el sistema
Activos hoy Con al menos 1 accion hoy
Activos semana Con al menos 1 accion esta semana
Tasa de adopcion Activos / Registrados

Operaciones

Metrica Descripcion
Ordenes creadas Total en periodo
Ordenes completadas Cerradas exitosamente
Cotizaciones generadas Total cotizaciones
Diagnosticos registrados Total diagnosticos

Sistema

Metrica Descripcion
Uptime Disponibilidad del sistema
Errores Errores registrados
Tiempo respuesta Promedio de respuesta API

Tareas Tecnicas

Backend:

  • BE-032: Crear tabla activity_log para tracking
  • BE-033: Middleware para registrar actividad
  • BE-034: Endpoint GET /api/analytics/usage
  • BE-035: Queries agregadas para metricas

Frontend:

  • FE-029: Crear UsageDashboardPage
  • FE-030: Crear MetricCard component
  • FE-031: Integrar grafica de barras (recharts)
  • FE-032: Selector de periodo

Dependencias

Depende de:

  • US-MMD001-001: Configurar taller
  • US-MMD001-002: Configurar roles

Bloquea:

  • Ninguno (funcionalidad de monitoreo)

Notas Tecnicas

Endpoints:

Metodo Endpoint Descripcion
GET /api/analytics/usage Metricas generales
GET /api/analytics/usage/users Metricas de usuarios
GET /api/analytics/usage/modules Uso por modulo

Estructura activity_log:

interface ActivityLog {
  id: string;
  user_id: string;
  workshop_id: string;
  module: string;
  action: string;
  entity_type?: string;
  entity_id?: string;
  created_at: Date;
}

Definition of Done (DoD)

  • Dashboard con metricas basicas
  • Filtro por periodo
  • Graficas de uso
  • Datos en tiempo real
  • Tests pasando

Creada por: Requirements-Analyst Fecha: 2025-12-06