tech.transparencia.document.mxdof.note.enrichment

Sidecar record carrying the full enrichment of a single DOF nota. One nota can have multiple enrichments (different models, different analysts, different languages); all of them reference the same tech.transparencia.document.mxdof.note record via strongRef.

Details · record, key tid
Kindrecord
Record keytid
Authoritynote.mxdof.document.transparencia.tech
Indexed

Record

record · key tid

Properties

Structured compliance tasks derived from the publication when the nota sets actionable requirements. Empty array when the document does not contain clear actions.

  • maxLength: 50
itemsref
Reference

contentDomain

requiredstring

Cross-domain classification aligned with the existing TransparencIA news taxonomy (IPTC Media Topics) for mixed analysis across DOF and news.

  • maxLength: 64
  • knownValues: arts-culture-entertainment | crime-law-justice | disaster-accident | economy-business-finance | education | environment | health | human-interest | labour | lifestyle-leisure | politics | religion | science-technology | society | sport | conflict-war-peace | weather

costUsd

string

Cost of this inference in USD as a decimal string (AT Protocol does not support floats). Example: '0.00123456'.

  • maxLength: 32

createdAt

requiredstring · datetime

When this enrichment was generated.

documentClass

requiredstring

Broad publication family used for cross-type analysis while preserving the more specific tipoActo field.

  • maxLength: 64
  • knownValues: normative | judicial | procurement | intergovernmental | planning | administrative | informational | other

effectiveDate

string · datetime

Normalized effective date/time when the act takes effect, if recoverable with confidence from the text. Distinct from tech.transparencia.document.item.effectiveAt (which is from source metadata).

Original textual expression of vigencia when a normalized date is unavailable or lossy (e.g., 'al día siguiente al de su publicación en el Diario Oficial de la Federación').

  • maxLength: 2048
  • maxGraphemes: 512

eventType

requiredstring

Cross-domain event/action category for shared analytics. Common DOF values: policy-legislation, regulatory-action, court-ruling-legal, announcement, data-report-study, appointment-resignation, investigation-audit, infrastructure-project. Open set.

  • maxLength: 64
  • knownValues: policy-legislation | regulatory-action | court-ruling-legal | announcement | data-report-study | appointment-resignation | investigation-audit | infrastructure-project | diplomatic-relations | environmental-incident | other

Free-text spatial scope when finer legal phrasing matters (e.g., 'Estado de México', 'República Mexicana', 'puertos nacionales', 'Jalisco').

  • maxLength: 1024
  • maxGraphemes: 256

impactLevel

requiredinteger

Estimated relevance and severity for public analysis. 1 = routine procedural notice, 3 = limited administrative or regulatory act, 5 = clear sectoral or intergovernmental change, 7 = significant reform / national program / major institutional decision, 10 = constitutional change or extraordinary structural transformation.

  • minimum: 1
  • maximum: 10

Brief justification for the impactLevel score.

  • maxLength: 5000
  • maxGraphemes: 1000

Tokens consumed by the LLM prompt for this enrichment.

  • minimum: 0

language

requiredstring · language

Language of this enrichment's free-text fields (BCP-47, e.g., 'es-MX', 'es', 'en'). Independent of the document's own language; multiple language enrichments can coexist for the same nota.

Normalized verbs or phrases describing what the act does in legal or administrative terms. Open set; only include effects substantiated by the text.

  • maxLength: 30
itemsstring
  • maxLength: 256
  • maxGraphemes: 64
  • knownValues: reforma | adiciona | deroga | abroga | declara_invalidez | convoca | emplaza | notifica | da_a_conocer | autoriza | establece_plazo | asigna_recursos | coordina | crea_mecanismo | aprueba_metodologia | publica_programa | modifica_cartografia | otro

locations

requiredarray

Geographic references: states, municipalities, ciudades, puertos, circuitos judiciales, or the territorial scope of the act. Empty array when no specific location is recoverable.

  • maxLength: 50

modelUsed

requiredstring

AI model or analyst profile identifier that produced the enrichment (e.g., 'claude-3-5-sonnet', 'gemini-2.0-flash', 'manual-analyst-v1').

  • maxLength: 256

Model version or checkpoint.

  • maxLength: 256

Optional plain-language rewrite of the official title, useful when the DOF title is formulaic or excessively legalistic.

  • maxLength: 4096
  • maxGraphemes: 1024

note

requiredref

Strong reference to the tech.transparencia.document.mxdof.note record being enriched. Consumers can hop to the underlying tech.transparencia.document.item via note.item.

Concrete obligations, duties, deadlines, restrictions, or compliance actions extracted from the nota as Spanish free-text statements. For more structured tasks, use complianceItems.

  • maxLength: 50
itemsstring
  • maxLength: 8000
  • maxGraphemes: 2000

Institutions, tribunals, secretarías, organismos autónomos, empresas públicas, entes convocantes, or other organizations referenced in the publication.

  • maxLength: 50

Tokens generated by the LLM response.

  • minimum: 0

people

requiredarray

People materially relevant to the nota: titulares del acto, ministros firmantes, gobernadores, autoridades responsables, litigantes, terceros interesados. Only natural persons.

  • maxLength: 50
itemsref

Approximate reading level of the document content, useful for UX surfacing of legalistic vs accessible texts.

  • maxLength: 32
  • knownValues: basic | intermediate | advanced

region

string

Geographic scope of the publication's effects or relevance.

  • maxLength: 32
  • knownValues: local | state | national | regional | global

relatedReferences

requiredarray

References to prior or related legal/administrative materials that the nota cites, modifies, abrogates, complements, or depends on (leyes, reglamentos, acuerdos, decretos, expedientes, acciones de inconstitucionalidad, tratados, programas, etc.).

  • maxLength: 100
itemsref
Reference

sector

requiredstring

Main affected policy or institutional sector. Spanish lowercased tokens. Open set.

  • maxLength: 128
  • maxGraphemes: 64
  • knownValues: salud | justicia | seguridad | energia | transporte | hacienda | educacion | medio_ambiente | telecomunicaciones | agropecuario | trabajo | cultura | comercio | defensa | administracion_publica | vivienda | relaciones_exteriores | otro

Normalized authority tier, mirrored from tech.transparencia.document.mxdof.note.authorityLevel for analytical convenience.

  • maxLength: 64
  • knownValues: federal_executive | federal_judicial | federal_legislative | autonomous_constitutional_body | state_judicial | state_executive | state_legislative | municipal | state_owned_enterprise | decentralized_body | procurement_section | judicial_notices_section | other

structuredRefs

requiredarray

Typed references useful for graph navigation across laws, cases, programs, regulations, treaties, procurement IDs, and related objects.

  • maxLength: 100

summary

requiredstring

Plain-language explanation in 2–4 sentences of what the nota publishes, who issues it, what it changes or orders, and who it affects. Prioritize substance over formalities.

  • maxLength: 10000
  • maxGraphemes: 2500

Who the act directly affects or addresses: proveedores interesados, terceros interesados, secretarías coordinadas, gobiernos estatales, instituciones de salud, concesionarios, sujetos regulados, población beneficiaria, etc. Free-form Spanish strings.

  • maxLength: 30
itemsstring
  • maxLength: 2048
  • maxGraphemes: 512

Chronological events or milestones described by the publication.

  • maxLength: 30
itemsref
Reference

tipoActo

requiredstring

Specific legal-administrative act type observed or inferred from the nota. Lowercased except for acronyms or proper names. Open set; consumers should tolerate unknown values.

  • maxLength: 128
  • maxGraphemes: 64
  • knownValues: decreto | acuerdo | acuerdo-secretarial | sentencia | edicto | aviso-judicial | aviso | licitacion | convocatoria | convenio | convenio-modificatorio | circular | lineamientos | manual | programa | declaratoria | resolucion | calendario | oficio | nota-aclaratoria | extracto-de-acuerdo | otro

topics

requiredarray

Primary topical tags. Spanish or English free-form.

  • maxLength: 15
itemsstring
  • maxLength: 1024
  • maxGraphemes: 256

#complianceItem

object

A structured compliance task derived from a DOF nota: deadline, requirement, restriction, payment, appearance, reporting obligation, or similar actionable item.

Properties

Monetary or quantitative amount as expressed in the text (e.g., 'multa de hasta 10,000 UMA', '500,000 pesos').

  • maxLength: 1024
  • maxGraphemes: 256

Who benefits or is the counterparty, when applicable.

  • maxLength: 2048
  • maxGraphemes: 512

dueDate

string · datetime

Normalized due date when recoverable with confidence.

Original textual expression of the deadline when a normalized datetime is unavailable or lossy.

  • maxLength: 2048
  • maxGraphemes: 512

kind

string

Category of compliance task.

  • maxLength: 64
  • knownValues: deadline | requirement | restriction | payment | appearance | reporting | other

Who must perform or comply (institution, person, role, regulated party).

  • maxLength: 2048
  • maxGraphemes: 512

text

requiredstring

Plain-language description of the task in Spanish (matching the enrichment language).

  • maxLength: 8000
  • maxGraphemes: 2000

#relatedReference

object

A reference to a prior or related legal/administrative material cited, modified, abrogated, complemented, or depended upon by this nota.

Properties

Original date text for the referenced item as extracted from the publication.

  • maxLength: 2048
  • maxGraphemes: 512

Kind of referenced material when clearly identifiable.

  • maxLength: 32
  • knownValues: law | regulation | decree | agreement | judgment | case | program | notice | treaty | procurement | other

relationType

requiredstring

How the nota relates to the referenced item. Open set; typical Spanish verbs.

  • maxLength: 64
  • knownValues: cita | modifica | reforma | fundamento | antecedente | aclara | complementa | abroga | invalida | implementa | deriva_de | otro

Resolved DOF nota identifier if the reference can be linked to another nota in the corpus. Pipelines should leave this empty when not resolved with confidence; the LLM must never invent it.

  • minimum: 1

title

requiredstring

Title or label of the referenced act, law, case, decree, agreement, regulation, or proceeding.

  • maxLength: 8192
  • maxGraphemes: 2048

url

string · uri

URL to the referenced item, only when explicitly present in the source text.

#timelineEntry

object

A chronological event or milestone described by the publication. DOF variant requires startDateText because many legal dates are expressed non-numerically (e.g., 'al día siguiente al de su publicación') and may not be normalizable.

Properties

endDate

string · datetime

End date/time for ranged events.

Original textual expression of the end date when applicable.

  • maxLength: 2048
  • maxGraphemes: 512

event

requiredstring

Description of the event or milestone.

  • maxLength: 4096
  • maxGraphemes: 1024

startDate

string · datetime

Start date/time in ISO 8601 format when normalizable with confidence.

startDateText

requiredstring

Original textual expression of the start date or moment as it appears in the publication.

  • maxLength: 2048
  • maxGraphemes: 512

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • DOF-specific sidecar for a Diario Oficial de la Federación (México) nota. Captures gazette-specific identifiers, edition, section, and authority hierarchy that don't fit the universal tech.transparencia.document.item record. Each nota in the DOF SIDOF feed maps to one record of this lexicon plus one underlying document.item record.

  • A canonical public-interest document record. Represents one official publication, report, filing, act, submission, or other source document before structural parsing or AI enrichment.

  • AI-generated structured metadata for a news article. Uses the sidecar pattern — references the article via strongRef so multiple enrichments (from different models or analysts) can coexist.