Files
service_manager/scripts/README.md
icamarillo ceea67eb2b feat: Version 1.11.0 - Mejoras en auditoría, SLA, frontend y correcciones de sincronización
- Refactorización de endpoints de auditoría y helpers
- Mejoras en esquemas de auditoría (audit.py)
- Correcciones en endpoint SLA
- Actualizaciones en múltiples rutas del frontend interno:
  layout, tickets, usuarios, tenants, categorías, sistemas,
  SLA (at-risk, violations), auditoría (main + security), login, perfil
- Actualización de tailwind.config.js
- Eliminación de docs de versiones anteriores (CAMBIOS_v1.10.0, v1.8.0, OPTIMIZACIONES)
- Nuevos scripts de prueba: generate_security_test_data.py, generate_sla_test_data.py
- Script de prueba de sincronización crítica (test_critical_sync.ps1)
- README actualizado en scripts/
2026-02-20 10:53:53 -07:00

152 lines
3.3 KiB
Markdown

# ServiceManagerWeb - Scripts de Utilidad
Este directorio contiene scripts para desarrollo y despliegue del sistema.
## 🔒 Scripts de Seguridad y Testing
### security-test-data.ps1
```powershell
# Generar datos de prueba para análisis de seguridad
.\scripts\security-test-data.ps1
# Limpiar datos de prueba
.\scripts\security-test-data.ps1 limpiar
```
**¿Qué hace?**
- Genera 105 logs de auditoría en Docker (backend container)
- Simula 3 amenazas: 1 CRITICAL (55 eliminaciones) + 2 HIGH (25 logins fallidos + 5 cambios privilegios)
- Permite probar toda la funcionalidad del análisis de seguridad
- Ver página: http://localhost:3001/audit/security
**Escenarios:**
- Sin parámetro o `generar`: Crea amenazas de prueba
- `limpiar`: Elimina TODOS los logs de las últimas 24h ⚠️
**Comandos equivalentes en Docker:**
```powershell
# Generar
docker exec servicemanager-backend python scripts/generate_security_test_data.py
# Limpiar
docker exec servicemanager-backend python scripts/generate_security_test_data.py cleanup
```
### 📊 Datos de Prueba SLA Management
```powershell
# Generar tickets con diferentes estados de SLA
docker exec servicemanager-backend python scripts/generate_sla_test_data.py
# Limpiar tickets de prueba
docker exec servicemanager-backend python scripts/generate_sla_test_data.py cleanup
```
**¿Qué genera?**
- 71 tickets totales con diferentes estados de SLA
- **Response SLA**: 15 cumplidos + 8 violados + 10 en riesgo
- **Resolution SLA**: 20 cumplidos + 6 violados + 12 en riesgo
- Distribuidos por categorías (Soporte, Facturación, Incidentes, Consultas)
- Distribuidos por prioridades (LOW, MEDIUM, HIGH, URGENT)
- Ver resultados: http://localhost:3001/sla
## Scripts de Desarrollo
### setup-dev.sh / setup-dev.ps1
```bash
# Linux/Mac
./scripts/setup-dev.sh
# Windows
./scripts/setup-dev.ps1
```
Configura el entorno de desarrollo:
- Copia .env.example a .env
- Genera claves secretas seguras
- Levanta servicios con Docker Compose
- Ejecuta migraciones iniciales
- Carga datos de prueba
### db-migrate.sh / db-migrate.ps1
```bash
# Ejecutar migraciones pendientes
./scripts/db-migrate.sh
# Crear nueva migración
./scripts/db-migrate.sh "add_user_preferences"
```
### test-all.sh / test-all.ps1
```bash
# Ejecutar todos los tests
./scripts/test-all.sh
# Solo backend
./scripts/test-all.sh backend
# Con coverage
./scripts/test-all.sh --coverage
```
### lint-fix.sh / lint-fix.ps1
```bash
# Linting y formateo automático
./scripts/lint-fix.sh
```
## Scripts de Producción
### deploy.sh
```bash
# Despliegue en producción
./scripts/deploy.sh production
# Con backup automático
./scripts/deploy.sh production --backup
```
### backup.sh
```bash
# Backup completo
./scripts/backup.sh
# Solo base de datos
./scripts/backup.sh --db-only
```
### health-check.sh
```bash
# Verificar estado de servicios
./scripts/health-check.sh
```
## Scripts de Mantenimiento
### cleanup.sh
```bash
# Limpiar logs antiguos y archivos temporales
./scripts/cleanup.sh
# Limpiar containers e imágenes sin usar
./scripts/cleanup.sh --docker
```
### seed-data.sh
```bash
# Cargar datos de prueba
./scripts/seed-data.sh
# Cargar datos específicos
./scripts/seed-data.sh --fixture=users
```
## Uso
Todos los scripts incluyen help integrado:
```bash
./scripts/script-name.sh --help
```
Los scripts están disponibles tanto para Unix (sh) como Windows (ps1).