================================================================================
INSTRUCCIONES PARA SOLUCIONAR LOS 2 PROBLEMAS PENDIENTES
================================================================================

RESUMEN DE LOS PROBLEMAS:
-------------------------
1. Los trámites derivados/finalizados siguen apareciendo en "Trámites Recibidos"
2. Los archivos marcados como "visible público" no se muestran en seguimiento.php


SOLUCIONES APLICADAS:
---------------------

✓ FRONTEND YA CORREGIDO:
  - Archivo: public/js/menu.js
  - Cambio: Ahora muestra botón de descarga para archivos visibles en CUALQUIER
    estado (DERIVADO, PENDIENTE o FINALIZADO), no solo FINALIZADO
  - El botón aparecerá si el SP devuelve un archivo en el campo mov_archivo


⚠ BACKEND - REQUIERE EJECUTAR SQL:
  - Los procedimientos almacenados necesitan actualizarse
  - Ejecutar el script: soluciones_finales.sql


PASOS A SEGUIR:
---------------

PASO 1: Diagnosticar el estado actual
   a) Abrir en navegador:
      http://localhost/mesapartes.moralesmuni.gob.pe/diagnostico_completo.php

   b) Este script mostrará:
      - Definición actual de SP_LISTAR_TRAMITE_AREA
      - Definición actual de SP_CARGAR_SEGUIMIENTO_TRAMITE_DETALLE
      - Estructura de la tabla movimiento
      - Datos de prueba

   c) Revisar si:
      ✓ La tabla tiene el campo mov_visible_publico
      ✓ Los procedimientos incluyen filtros correctos


PASO 2: Ejecutar el script de solución
   a) Abrir phpMyAdmin: http://localhost/phpmyadmin

   b) Seleccionar la base de datos: munimor9_bdmoralestramite

   c) Ir a la pestaña "SQL"

   d) Copiar TODO el contenido del archivo:
      soluciones_finales.sql

   e) Pegar en el área de texto de phpMyAdmin

   f) Click en "Ejecutar" (botón inferior derecho)

   g) Verificar que aparezcan mensajes de éxito:
      - "SP_LISTAR_TRAMITE_AREA actualizado correctamente"
      - "SP_CARGAR_SEGUIMIENTO_TRAMITE_DETALLE actualizado correctamente"


PASO 3: Probar las soluciones
   a) Limpiar caché del navegador (Ctrl + F5)

   b) Iniciar sesión en el sistema

   c) Ir a "Trámites Recibidos"

   d) Derivar o finalizar un trámite CON archivo adjunto y marcando el checkbox
      "Mostrar este archivo en el seguimiento público"

   e) Verificar que:
      ✓ El trámite derivado/finalizado YA NO aparece en la lista
      ✓ La tabla se actualiza automáticamente

   f) Abrir en otra ventana (sin sesión):
      http://localhost/mesapartes.moralesmuni.gob.pe/seguimiento.php

   g) Buscar el trámite usando:
      - Número de expediente
      - DNI del remitente
      - Año

   h) Verificar que:
      ✓ Aparece el botón "Ver Documento Adjunto" en el paso correspondiente
      ✓ Al hacer click, descarga el archivo correctamente


QUÉ HACE CADA SOLUCIÓN:
------------------------

1. SP_LISTAR_TRAMITE_AREA (actualizado):
   - Ahora SOLO lista trámites con mov_estatus = 'PENDIENTE'
   - Filtra documentos que no están finalizados globalmente
   - Resultado: Los trámites derivados/finalizados desaparecen de la lista

2. SP_CARGAR_SEGUIMIENTO_TRAMITE_DETALLE (actualizado):
   - Usa CASE para devolver mov_archivo solo si mov_visible_publico = 1
   - Si mov_visible_publico = 0 o NULL, devuelve NULL en lugar del archivo
   - Resultado: Solo archivos marcados como visibles aparecen en seguimiento público

3. public/js/menu.js (ya corregido):
   - Verifica si dataDetalle[i][8] tiene valor (mov_archivo filtrado por el SP)
   - Si tiene valor, muestra botón de descarga con URL segura
   - Aplica a CUALQUIER estado, no solo FINALIZADO


ARCHIVOS CREADOS:
-----------------
✓ diagnostico_completo.php    - Para verificar estado actual
✓ soluciones_finales.sql      - Script SQL con las correcciones
✓ verificar_sp_listar.php     - Diagnóstico de SP_LISTAR_TRAMITE_AREA
✓ ver_sp_seguimiento.php      - Diagnóstico de SP_CARGAR_SEGUIMIENTO_TRAMITE_DETALLE
✓ INSTRUCCIONES_SOLUCION.txt  - Este archivo


ARCHIVOS MODIFICADOS:
---------------------
✓ public/js/menu.js
  - Líneas 431-451: Lógica de botón de descarga actualizada


DESPUÉS DE PROBAR:
------------------
Puedes eliminar los archivos de diagnóstico:
- diagnostico_completo.php
- verificar_sp_listar.php
- ver_sp_seguimiento.php
- diagnostico_sp.php (si existe)
- verificar_estructura_documento.php (si existe)
- soluciones_finales.sql (guardar como respaldo antes de borrar)


SOPORTE:
--------
Si después de ejecutar el script SQL los problemas persisten:

1. Verificar en phpMyAdmin que los procedimientos se actualizaron:
   - Ir a la pestaña "Rutinas"
   - Buscar SP_LISTAR_TRAMITE_AREA y SP_CARGAR_SEGUIMIENTO_TRAMITE_DETALLE
   - Click en "Editar" para ver su código

2. Verificar en la consola del navegador (F12) si hay errores JavaScript

3. Verificar en los logs de PHP si hay errores:
   - C:\xampp\apache\logs\error.log


================================================================================
