app.services.usage_service¶
Métricas de uso del producto, calculadas SOLO con datos persistidos en la base interna: - execution_history (cada caso ejecutado deja una fila) - test_cases / test_suites / connection_profiles / projects (altas y totales) - usage_events (importar/exportar Excel y otras acciones que no son ejecuciones)
No hay datos inventados ni estimaciones: si no hay registros, el resultado lo dice (hay_datos = False).
Las fechas están en UTC. El uso por persona sale de «ejecutado por» (existe desde que hay usuarios con rol).
MAX_ROWS = 100000
module-attribute
¶
ORIGENES = {'UI': 'Módulos Casos y Suites (interfaz web)', 'INICIO': 'Recorrido guiado de Inicio', 'CLI': 'Línea de comandos (CLI)', 'GITHUB_ACTIONS': 'GitHub Actions', 'SIN_REGISTRAR': 'Origen no registrado (anterior a la Fase 4)'}
module-attribute
¶
EVENTOS = {'excel_import_cases': 'Intentos de importar casos desde Excel (incluye los rechazados por errores)', 'excel_validate_cases': 'Validaciones de un Excel (sin importar)', 'excel_export_cases': 'Exportaciones de casos a Excel', 'excel_export_results': 'Exportaciones de resultados a Excel', 'excel_template': 'Descargas de la plantilla de Excel', 'demo_scenario_loaded': 'Cargas del escenario de demostración', 'demo_guided_run': 'Demostraciones guiadas ejecutadas', 'account_requested': 'Solicitudes de cuenta enviadas desde la pantalla de ingreso', 'table_analyzed': 'Tablas analizadas con «Analizar una tabla»', 'table_analysis_saved': 'Suites creadas desde «Analizar una tabla»'}
module-attribute
¶
DEFINICIONES = {'total_ejecuciones': 'Cantidad de registros de ejecución en el periodo. Un caso ejecutado una vez cuenta 1; una suite de 5 casos ejecutada una vez cuenta 5.', 'corridas_de_suite': 'Veces que se ejecutó una suite completa (se agrupan las filas que comparten el identificador de corrida; en registros antiguos sin identificador se agrupan por suite y minuto, de forma aproximada).', 'tasa_pass': 'Porcentaje de ejecuciones del periodo que terminaron en PASS. FAIL = se ejecutó pero no coincidió con lo esperado; ERROR = no se pudo ejecutar o evaluar.', 'casos_distintos': 'Casos guardados distintos que se ejecutaron al menos una vez en el periodo (las pruebas rápidas no se cuentan porque no son casos guardados).', 'proyectos_activos': 'Proyectos con al menos una ejecución en el periodo.', 'por_fecha': 'Ejecuciones por día (UTC), separadas por resultado. Los días sin ejecuciones aparecen en cero.', 'top_casos': 'Casos con más ejecuciones en el periodo, con su resultado más reciente.', 'top_suites': 'Suites con más corridas en el periodo.', 'por_origen': 'Desde dónde se lanzaron las ejecuciones (interfaz, recorrido guiado, CLI o GitHub Actions).', 'por_usuario': 'Quién lanzó las ejecuciones (usuario de la aplicación, «cli» o «github-actions»).', 'altas': 'Casos, suites y conexiones creados en el periodo (según su fecha de creación guardada).', 'eventos': 'Acciones que no son ejecuciones: importaciones y exportaciones de Excel, etc.'}
module-attribute
¶
LIMITACIONES = ['El uso por persona solo cuenta ejecuciones con usuario: las anteriores a las cuentas individuales o hechas sin control de acceso aparecen como «sin usuario».', 'Las fechas y los días se calculan en UTC.', 'Los registros anteriores a la Fase 4 no tienen origen: aparecen como «origen no registrado».', 'Solo cuenta lo que quedó guardado en la base interna; las ejecuciones desde la CLI con otra base no aparecen aquí.', 'El panel no distingue datos de demostración de uso real: las suites «Demo: …» y las pruebas de ejemplo cuentan igual que cualquier ejecución.', '«Importaciones» de Excel cuenta intentos, incluidos los archivos rechazados por errores.']
module-attribute
¶
build_summary(db, days=30, project_id=None, now=None)
¶
record_event(db, event_type, project_id=None, source='API', detail=None)
¶
Registra un evento de uso (sin datos personales ni contenido de archivos).