Estructura y modelo mínimo propuestos
Estado: borrador técnico para revisión; no contrato editorial definitivo. Esquema JSON Schema 2020-12.
Solo se crean carpetas con archivos útiles: docs, schemas, tools y tests. La carpeta pública aleman-sin-miedo/ contiene la web de seguimiento autorizada posteriormente por el usuario. Se incorporarán curriculum, content, agents, validators, exporters y audio al iniciar sus respectivas fases. No se genera contenido de las 160 lecciones.
Entidades
| Entidad | Campos y relación |
|---|---|
| Competencia | id, nivel, habilidad, descriptor observable, source_refs |
| Concepto | id, nombre, definición, función, ejemplo español, ejemplo alemán opcional, primera lección, conceptos previos, referencias posteriores |
| Lección | id, nivel, número, estado, minutos orientativos, objetivos, competencias, prerrequisitos, conceptos introducidos/usados, actividades y recursos |
| Actividad | id, tipo, consigna, competencias, conceptos, respuesta o rúbrica, retroalimentación y recursos |
| Recurso | id, tipo, URI relativa/HTTPS, transcripción opcional, procedencia, licencia y estado de revisión |
| Fuente | id, título, URL verificable y fecha de consulta |
Habilidades: comprensión escrita/auditiva, producción escrita/oral, interacción y mediación. Los nombres de campos son estables en inglés; textos para edición y documentación en español. Se propone JSON para datos y Markdown para prosa; vincularlos sin duplicar manualmente versiones digitales e imprimibles. La representación final de bloques de lección se resolverá en el contrato editorial.
Integridad futura
El esquema expresa tipos, campos requeridos y rangos; no puede demostrar por sí solo estas reglas entre entidades:
- Identificadores únicos; todas las referencias resuelven al tipo correcto.
- Prerrequisitos y conceptos sin ciclos ni referencias a aprendizaje posterior inadvertidas.
- Primera aparición y referencias del glosario coherentes con el orden curricular.
- Competencias con fuentes verificadas, objetivos observables y actividades que los ejercitan.
- Ejercicios cerrados con respuesta, tareas abiertas con rúbrica; todas con retroalimentación suficiente.
- Soluciones correspondientes a actividades; recursos presentes y revisados.
- PED-01 a PED-04 con revisión humana además de controles estructurales.
- Transiciones editoriales trazables, aprobación humana y publicación controlada.
Estas reglas requieren un futuro validador semántico y auditoría humana. No están implementadas en esta primera entrega. El script actual solo comprueba integridad documental y consistencia básica de la definición del esquema; no valida instancias de contenido contra JSON Schema.
Versionado y audio
El contenedor lleva schema_version. Cada lección propone estado draft, review, approved o published; el esquema no autoriza cambios de estado. Git registrará revisiones y el flujo futuro deberá registrar responsable y evidencia de aprobación.
Recursos de audio son referencias a artefactos, nunca secretos. No almacenar grabaciones de estudiantes en Git. Los resultados de intentos y progreso pertenecen a un modelo separado pendiente de política de datos; no inventar ahora una base de datos de estudiantes.