portfolio-index-builder

Lección **11-02 — Crea un índice HTML**

## Objetivo
Generar tarjetas desde JSON.

## Conceptos
- JSON

• HTML

• escaping

• static generation

  Librerías

  • json

• pathlib

• html

  Estructura

  01-start/      reconstrucción
  03-complete/   referencia funcional
  04-challenge/  extensión
  05-solution/   solución de comparación
  screenshots/   evidencia para portafolio
  

  Ejecutar

  python -m venv .venv
  # Windows: .venv\Scripts\activate
  # macOS/Linux: source .venv/bin/activate
  pip install -r 03-complete/requirements.txt
  python 03-complete/main.py
  

  En FastAPI:

  fastapi dev 03-complete/main.py
  

  Ingeniería inversa

  1. Ejecuta la referencia.
  2. Identifica entrada, proceso y salida.
  3. Modifica un dato.
  4. Provoca el error controlado.
  5. Repara.
  6. Reconstruye en 01-start.
  7. Completa el desafío.

  Error controlado

  Introduce HTML en el nombre y comprueba que se escape.

  Cursor

  Explica este proyecto como tutor. Describe entrada, procesamiento y salida. Revisa una función por vez. No cambies código sin mi autorización.

  GitHub

  Incluye captura, problema, solución, instalación, arquitectura, aprendizaje y mejoras futuras.