{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://datacultura.org/atlas/api/v1/esquema/eventos.schema.json","title":"Atlas de eventos, versión 1","description":"Series (el evento que se repite) y ediciones (cada realización) del Atlas Cultural de Data Cultura. Cada campo trae su valor (v) y el identificador del documento fuente (f), que dice la URL, la fecha de consulta y el sha256 de la captura guardada. Un campo que la fuente no trae no existe: nunca se deduce.","type":"object","required":["version","documentos","series","ediciones"],"additionalProperties":false,"properties":{"version":{"const":"1"},"documentos":{"type":"array","items":{"$ref":"#/$defs/documento"}},"series":{"type":"array","items":{"$ref":"#/$defs/serie"}},"ediciones":{"type":"array","items":{"$ref":"#/$defs/edicion_del_lote"}}},"$defs":{"fecha":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"cut":{"type":"string","pattern":"^\\d{4,5}$"},"id_documento":{"type":"string","pattern":"^doc-[a-z0-9-]{1,80}$"},"documento":{"description":"Una página o un archivo de una fuente de acceso público, leída por una persona y guardada con captura fechada.","type":"object","required":["id","url","consultado","sha256","terminos"],"additionalProperties":false,"properties":{"id":{"$ref":"#/$defs/id_documento"},"url":{"type":"string","pattern":"^https?://"},"consultado":{"$ref":"#/$defs/fecha"},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"sha256 de la captura de la página guardada el día de la consulta."},"captura":{"type":"string","description":"Ruta de la captura en el archivo de respaldo de Data Cultura."},"medio":{"type":"string","description":"Quien publica la página, como se lee en ella."},"evidencia":{"type":"string","pattern":"^ev-[0-9]{8}-[0-9]{6}-[0-9a-f]{8}$","description":"Id de la evidencia recortada en el registro de Data Cultura (conocimiento/datos/eventos/evidencias.jsonl). Obligatoria cuando el documento se tomó de una captura de aGoCapture: el registro la tiene aprobada y su sha256 es el de este documento (V-5)."},"terminos":{"enum":["sin_restriccion","no_comercial","solo_curacion_manual"],"description":"Clasificación de los términos de la fuente (V-4, L3; solo_curacion_manual es la de C4: prohíbe solo la recolección automatizada, como Meta). Las fuentes que prohíben reproducir o reflejar no entran como documento: quedan solo como enlace."}}},"campo":{"type":"object","required":["v","f"],"additionalProperties":false,"properties":{"v":{},"f":{"$ref":"#/$defs/id_documento"},"cita":{"type":"string","minLength":1,"description":"Fragmento literal del documento de donde sale el valor. Opcional en la versión 1; lo llevan las ediciones curadas desde el 14-11-2026."},"procedencia":{"type":"string","minLength":1,"description":"Cómo se obtuvo el valor cuando no es copia directa de la cita, por una regla aprobada (por ejemplo, el año de una fecha sin año por su día de la semana)."}}},"campo_texto":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"string","minLength":1}}}]},"campo_entero":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"integer","minimum":1}}}]},"campo_fecha":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"$ref":"#/$defs/fecha"}}}]},"campo_organizacion":{"description":"Vínculo con una ficha de organización del atlas. Solo con una de las tres evidencias de V-4.","type":"object","required":["v","f","evidencia"],"additionalProperties":false,"properties":{"v":{"type":"string","pattern":"^(org|pcc):[A-Z]{3}-\\d{5}$"},"f":{"$ref":"#/$defs/id_documento"},"cita":{"type":"string","minLength":1},"evidencia":{"enum":["la_fuente_la_nombra","su_sitio_lo_publica","la_declara_la_organizacion"]}}},"serie":{"type":"object","required":["registro_id","nombre","disciplina","comuna_cut"],"additionalProperties":false,"properties":{"registro_id":{"type":"string","pattern":"^evt:EVT-\\d{5}$","description":"Identificador estable de la serie en el atlas; es el que usa el puente con Tcultura."},"nombre":{"$ref":"#/$defs/campo_texto"},"disciplina":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"string","pattern":"^[a-z-]+$"}}}]},"comuna_cut":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"$ref":"#/$defs/cut"}}}]},"organizacion":{"$ref":"#/$defs/campo_organizacion"},"wikidata":{"type":"string","pattern":"^Q\\d+$","description":"Elemento de Wikidata de la serie, como pista; ningún valor se toma de ahí sin confirmarlo en la fuente primaria."}}},"edicion":{"type":"object","required":["registro_id","serie","titulo","anio","comunas"],"properties":{"registro_id":{"type":"string","pattern":"^edi:EDI-\\d{5}$"},"serie":{"type":"string","pattern":"^evt:EVT-\\d{5}$"},"titulo":{"$ref":"#/$defs/campo_texto","description":"Nombre literal de la edición en la fuente."},"anio":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"integer","minimum":1900,"maximum":2100}}}]},"fecha_inicio":{"$ref":"#/$defs/campo_fecha"},"fecha_fin":{"$ref":"#/$defs/campo_fecha"},"comunas":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/cut"}}}}]},"lugar":{"$ref":"#/$defs/campo_texto","description":"El lugar tal como lo escribe la fuente."},"espacio":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"type":"string","pattern":"^esp:[A-Z]{3}-\\d{5}$"}}}]},"numero_edicion":{"$ref":"#/$defs/campo_entero","description":"Solo si la fuente lo dice."},"gratuidad":{"allOf":[{"$ref":"#/$defs/campo"},{"properties":{"v":{"enum":["gratuita","pagada","mixta"]}}}],"description":"Solo si la fuente lo dice."},"estado":{"$ref":"#/$defs/campo_texto","description":"El estado de la edición copiado literal de la fuente (por ejemplo, una cancelación). Sin fuente, no existe: un anuncio no prueba que la edición se realizó."},"origen":{"enum":["curacion","agenda_tcultura"]},"wikidata":{"type":"string","pattern":"^Q\\d+$","description":"Elemento de Wikidata de la edición, como pista."}}},"revision":{"description":"Revisión a mano de cada alta (V-4, consecuencia 2). No se publica.","type":"object","required":["titulo_con_nombre","sensible","menor","revisado"],"additionalProperties":false,"properties":{"titulo_con_nombre":{"type":"boolean","description":"El título literal nombra a una persona: se ve en su página y queda fuera de toda descarga."},"sensible":{"type":"boolean","description":"El título revela un dato sensible de una persona identificable (art. 2 g): la edición no entra."},"menor":{"type":"boolean","description":"El título nombra a alguien que se sabe menor de 18 años: la edición no entra."},"revisado":{"$ref":"#/$defs/fecha"}}},"edicion_del_lote":{"allOf":[{"$ref":"#/$defs/edicion"}],"required":["revision","origen"],"properties":{"revision":{"$ref":"#/$defs/revision"}},"unevaluatedProperties":false},"edicion_publicada":{"allOf":[{"$ref":"#/$defs/edicion"}],"unevaluatedProperties":false}}}