Documento activo

Operacion Tecnica y Soporte

Mantenimiento, respaldo, soporte e incidencias.

Volver al indice

Operacion Tecnica, Mantenimiento y Soporte

1. Objetivo

Este documento sirve como guia para personal tecnico, soporte o mantenimiento del sistema.

2. Puntos de revision rapida

Ante una incidencia, revisar primero:

  • config/config.php
  • config/database.php
  • logs/php_errors.log
  • conectividad a base de datos
  • permisos de uploads y logs

3. Archivos y zonas criticas

Configuracion

  • config/
  • kiosko/config/

Logica transversal

  • helpers/
  • models/

Datos y evidencia

  • logs/
  • assets/uploads/
  • sql/

4. Mantenimiento preventivo

Diario

  • revisar logs/php_errors.log
  • revisar expedientes o pagos atascados si se reportan incidentes

Semanal

  • revisar integridad de uploads
  • revisar espacio en disco
  • validar que cron jobs corran

Mensual

  • generar respaldo completo
  • validar restauracion en entorno controlado
  • revisar permisos por rol y seguridad

5. Respaldos

Se detecta soporte para backups y evidencia de respaldos en:

  • logs/backups/
  • helpers/BackupService.php

Recomendacion

Respaldar:

  • base de datos
  • assets/uploads
  • configuraciones externas
  • cualquier archivo de pasarela o credenciales fuera del repo

6. Logs y diagnostico

Logs nativos

  • logs/php_errors.log

Logs funcionales

  • logs_actividad en base de datos
  • eventos de correo
  • eventos de pagos y kiosko segun modulo

7. Cron y tareas programadas

Detectadas

  • cron/notificar_calendario.php
  • cron/limpiar_tokens.php

Recomendacion de operacion

  • ejecutarlos con usuario restringido
  • registrar salida y errores
  • no depender de ejecucion manual salvo emergencia

8. Soporte de incidencias comunes

No inicia sesion

Revisar:

  • DB conectada
  • bloqueo por IP
  • credenciales
  • expiracion o bloqueo temporal
  • errores de sesion

No carga archivos

Revisar:

  • permisos de carpeta
  • tamano maximo
  • extensiones permitidas
  • rutas normalizadas

No aparecen modulos

Revisar:

  • rol_id
  • nivel_acceso
  • permisos_modulo
  • datos base sincronizados

Fallan pagos o kiosko

Revisar:

  • configuracion de pasarela
  • webhook
  • saldo
  • stock
  • tablas del kiosko

Fallan reportes o PDFs

Revisar:

  • dependencia TCPDF
  • permisos de escritura temporal
  • datos incompletos en institucion o alumno

9. Validacion minima despues de cambios

Cuando se toque codigo o configuracion, probar como minimo:

  • login
  • dashboard admin
  • portal publico
  • una pagina de biblioteca
  • una pagina de aula
  • mesa de partes
  • un flujo basico de pagos si el modulo esta activo

10. Observaciones finales

Este proyecto tiene bastante logica en archivos PHP de pagina y muchos comportamientos guiados por datos en base de datos. Por eso, el soporte efectivo necesita combinar:

  • lectura de logs
  • verificacion de permisos
  • revision de datos institucionales
  • pruebas funcionales reales