# Gold conceptual (Vía 1) — anclaje de contenido con autoría humana

Andamiaje para anclar las dimensiones "concepto" y "explicación" del feedback a explicación
canónica de autoría humana publicada (literatura libre). **NO** ancla la dimensión "sugerencia
personalizada", porque los libros explican conceptos y errores típicos, no el código de un aprendiz concreto.

## Estado
- `gold_conceptual_template.json` contiene 157 conceptos reales del EKG (derivados del grafo, no inventados),
  cada uno con sus etiquetas es/en, fuentes candidatas y `explicacion_canonica` **VACÍA**.
- Cada entrada está en estado `PENDIENTE_EXTRACCION_MANUAL`. Cero explicaciones fabricadas (regla de
  integridad). La extracción del texto canónico de los libros se hace después, con atribución y ShareAlike.
- Regenerar con `python sistema-rag/scripts/construir_gold_conceptual.py`.

## Fuentes y licencias (verificadas en fuente primaria — Anexo A de la estrategia)
| Fuente | Licencia | Comercial | Rol |
|---|---|---|---|
| **A Byte of Python** (Swaroop C. H.) | **CC BY-SA 4.0** (texto) + BSD-3 (código) | Sí | **Núcleo** (la más permisiva) |
| Composing Programs (DeNero) | CC BY-SA 3.0 | Sí | Conceptos avanzados (recursión, orden superior) |
| Dive Into Python 3 (Pilgrim) | CC BY-SA 3.0 | Sí | Explicación técnica intermedia |
| Think Python 2e (Downey) | CC BY-NC 3.0 | **No** | Taxonomía de errores/debugging (solo si TFM no comercial) |
| Python for Everybody (Severance) | CC BY-NC-SA 3.0/4.0 | **No** | Gold en **español** (traducción oficial); NC+SA contamina derivado |

Recomiendo usar A Byte of Python (CC BY-SA 4.0) como núcleo para no contaminar el
derivado; los recursos NC (Think Python, PY4E) solo si el TFM se declara no comercial, manteniendo la
cláusula NC documentada. PyTips (Uniandes) queda no verificado, así que no usar sin confirmación directa.

## Procedimiento de extracción pendiente (para una fase posterior con acceso de red a las fuentes)
1. Para cada concepto, localizar en la fuente recomendada la explicación canónica del concepto y/o su
   error típico; copiar con atribución (autor, título, licencia, URL/localizador) en `explicacion_canonica`,
   `fuente_usada`, `licencia_fuente`, `url_localizador`; cambiar `estado` a `EXTRAIDA`.
2. Mantener ShareAlike. El dataset derivado hereda CC BY-SA; documentar la licencia compuesta.
3. No mezclar fuentes NC si el TFM es comercial.
