Instrucciones — Mapa de Trámites

1. Qué es esto

Es un panel visual (KPIs, gráficas, un diagrama de flujo y una tabla) que muestra los trámites de licenciamiento urbanístico de Bogotá a partir de un archivo Excel. Todo corre en el navegador de quien lo visita: no hay ningún servidor especial ni base de datos detrás.

Este sitio es 100% estático. No hay servidor, no hay "programación" que usted deba tocar. Su única tarea habitual será reemplazar el archivo Excel cuando quiera actualizar los datos.

2. Qué NO tocar / qué SÍ puede tocar

Archivo o carpeta	¿Se puede tocar?
`datos/tramites.xlsx`	Sí — es el único archivo que usted debe reemplazar para actualizar datos.
`contenido/hero-landing.html`	Con cuidado — solo el texto entre las etiquetas, no borre las etiquetas mismas.
Todo lo demás (`index.html`, `assets/`)	No — es el código del sitio; editarlo puede romper el panel completo.

3. Cómo actualizar los datos (paso a paso)

Descargue una copia del Excel actual desde su hosting y guárdela en su computador con la fecha en el nombre, como respaldo (por ejemplo tramites_respaldo_2026-08-09.xlsx).
Edite el Excel: puede agregar filas, quitar filas o cambiar valores, pero:
- No cambie los nombres de los encabezados (la primera fila con títulos como FUENTE, ETAPA, TRÁMITE, ENTIDAD, etc.).
- No inserte una fila de título nueva por encima del encabezado.
- No fusione celdas.
- No deje una fila completamente vacía en medio de la tabla de datos.
- Los valores de las columnas que dicen VERDADERO/FALSO deben seguir escritos exactamente así (en mayúsculas, en español).
Guarde el archivo en formato .xlsx (no .xls, no .csv) con el nombre exacto tramites.xlsx.
Suba el archivo por FTP o por el administrador de archivos de su hosting, reemplazando el que está en la carpeta datos/.
Visite el sitio y refresque la página con Ctrl+F5 (o Cmd+Shift+R en Mac) para asegurarse de ver la versión más reciente.

4. Cómo embeber el panel en su sitio (iframe)

Copie y pegue este código en la página de su sitio donde quiera mostrar el panel, cambiando la URL por la dirección real donde subió esta carpeta:

<iframe
  src="https://www.su-dominio.com/ruta/al/mapa-tramites/index.html"
  width="100%"
  height="1600"
  style="border:0;"
  loading="lazy"
></iframe>

La altura (height) es fija en esta primera versión (no se autoajusta al contenido). Si ve una barra de scroll adicional dentro del iframe, aumente ese número. Use siempre la URL directa del sitio del panel (no la de la página que lo va a envolver).

5. Cómo probarlo antes de subirlo

Si abre index.html con doble clic en su computador, es posible que no vea los datos cargados: los navegadores bloquean por seguridad la lectura de archivos locales de esa forma. Esto es normal y no significa que algo esté roto. La forma correcta de probarlo es subiéndolo a una carpeta de prueba en su propio hosting (o pidiéndole a su desarrollador que lo sirva con un servidor local de pruebas).

6. Preguntas frecuentes

Actualicé el Excel pero no veo los datos nuevos.
Verifique que el archivo se llame exactamente tramites.xlsx y esté en la carpeta datos/. Luego refresque con Ctrl+F5: el sitio guarda una copia rápida en el navegador y a veces hay que forzar la actualización.

Veo un mensaje de error o el panel no carga.
Revise que no haya roto el encabezado del Excel (ver sección 3). Si el error persiste, contacte a quien le entregó este sitio con el mensaje exacto que ve en pantalla.

¿Qué es el "modo diagnóstico" o "modo administrador"?
Es un panel oculto (se activa agregando ?admin=1 al final de la URL del sitio, fuera del iframe, o con la combinación de teclas Ctrl+Alt+D) que muestra información técnica de cómo se leyó el Excel. No es un mecanismo de seguridad: cualquier persona que conozca el enlace o la combinación de teclas puede verlo. No coloque ahí información confidencial.

7. Límites de soporte

El código de este sitio es HTML/CSS/JavaScript estándar, documentado en NOTAS_TECNICAS.md, para que cualquier desarrollador web pueda tomarlo sin depender de quien lo construyó originalmente.

[Espacio para que quien le entregó este sitio indique aquí a quién contactar en caso de que algo se rompa.]