[frapercan]

Por que

Lo pide el autor el 2026-11-10, despues de corregirme dos veces por nombrarle las cosas con prefijos hexadecimales. No es una cuestion de estilo: para una ventana de evaluacion la plataforma no tiene otra cosa que ofrecer. evaluation_set lleva los dos conjuntos de anotaciones, el job, las estadisticas, el uri y la huella de la verdad, el papel de la ventana, tres snapshots, el perfil de verdad, la regla de terminos y la revision. Todo eso son propiedades; ninguna es un nombre. Y ADR-D56 ya cerro que el par de versiones no sirve, porque 62 de 69 pares cargan mas de una ventana.

El hueco, medido sobre el esquema entero

De las 20 entidades que se citan en una frase, solo 5 llevan los dos descriptores (embedding_config, query_set, model_weights, scoring_config, experiment_run).

les falta	cuantas	cuales
los dos	10	evaluation_set (87 filas), annotation_set (75), ontology_snapshot (66), prediction_set (26), evaluation_result (21), information_accretion_set (18), evaluation_frame (8), swissprot_release (3), reference_reproduction (1), interpro_go_mapping (0)
el largo	4	dataset, reranker_model, exploration, external_reference
el breve	1	job, con 778 filas

Las cinco decisiones

1. El alcance es lo que se cita, no lo que se cuenta. protein_go_annotation son 663.408.837 filas y go_prediction 33.423.682: un descriptor por fila ahi es texto que nadie leera, y peor, invita a una etiqueta por fila que contradiga la del conjunto.
2. El breve es un nombre, o sea unico por tabla y estable una vez escrito. Una etiqueta que cambia no es un nombre: dos frases sobre la misma fila parecerian frases sobre dos filas.
3. El largo nombra todos los campos que varian entre hermanas. Las tres ventanas largas son el ejemplo trabajado porque son el caso que provoco el registro: dos cierran sobre los terminos del pivote con 39.885 y 63.734 delta, y la tercera toma los vivos en los dos extremos con 40.531 y verdad proyectada. "La ventana larga de validacion" seria verdad de tres poblaciones distintas.
4. Los dos se escriben en el flush que crea la fila, por la operacion que la midio, y el relleno de lo ya existente deriva de columnas que ya estan o se niega. Donde no se pueda derivar, la fila se queda en NULL y la operacion lo informa: para un nombre, "no puedo decirlo" es mejor que uno equivocado.
5. Un guardia, con la forma de check_sets.py, que ya camina los metadatos del ORM con cuatro criterios por conjunto. Este anade el quinto sobre una lista mas ancha, en modo informe, y --strict bloquea cuando entre la ultima migracion. La lista vive en el guardia, asi que una entidad citada nueva es un fallo hasta que se declare ahi.

Lo que NO decide, y es del autor

• Si go_term lleva la definicion del OBO como descriptor largo: son 3.118.456 filas de dato real, no de texto inventado, y el coste es suyo.
• En que idioma van los nombres que se leen en los dos sitios, dado que el codigo va en ingles y la conversacion en castellano.
• Si el frontend pasa a mostrar el breve en lugar del uuid donde hoy muestra una fila.

El defecto que encontre al registrarlo

Las filas D54, D55 y D56 del indice tenian 2 celdas en una tabla de 4 columnas, asi que docutils no renderizaba la tabla entera del registro de decisiones: row 53 does not contain the same number of items as row 1 (2 vs 4). CI no lo veia porque .github/workflows/docs.yml corre make html sin -W. Cada fila recupera su Estado y su Fase leidos de su propio ADR. Comprobado con docutils antes y despues: de un error de tabla a ninguno.

Comprobado

check_no_em_dashes (143 ficheros), check_doc_refs, check_autodoc_coverage (59 patrones), check_sets, el lint de tokens vN sobre docs y README.md, y el parseo del indice y del ADR nuevo con docutils. Solo documentacion: ni esquema ni codigo en este PR.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.93%. Comparing base (d8bc801) to head (c8b9209).
⚠️ Report is 273 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #1174      +/-   ##
===========================================
+ Coverage    87.85%   87.93%   +0.07%     
===========================================
  Files          306      406     +100     
  Lines        23414    31667    +8253     
===========================================
+ Hits         20570    27845    +7275     
- Misses        2844     3822     +978     

see 170 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.