Skip to content

docs(h5): addendum de revisión SRS — reconciliar criterios con ADRs (H-04)#33

Merged
Jacket-69 merged 1 commit into
mainfrom
docs/h5-srs-addendum
Jun 3, 2026
Merged

docs(h5): addendum de revisión SRS — reconciliar criterios con ADRs (H-04)#33
Jacket-69 merged 1 commit into
mainfrom
docs/h5-srs-addendum

Conversation

@Jacket-69
Copy link
Copy Markdown
Owner

Resumen

Resuelve la decisión H-04 de FTR-03 (revisión del primer entregable): cómo tratar los criterios numéricos del SRS que cambiaron por evidencia durante el desarrollo (ADRs 0011/0016/0019/0021). Tras una auditoría de tres frentes (SRS, ADRs, entregables presentados), se eligió addendum + arreglar el espejo: no se reescribe la historia del entregable; se documenta la reconciliación.

Hallazgos de la revisión

  • Solo 2 desviaciones numéricas reales vs el SRS: CP-01 (duration ≤5%/≥95, inalcanzable sin reimplementar OSRM) y CP-12 (≤1000 ms → ajustado a ≤2000 ms p95). El resto son reformulaciones, ajustes técnicos o criterios cumplidos.
  • docs/SRS.md tenía un bug real: declaraba performance ≤1000 ms (§2.7/§2.13/§2.15) — criterio que el sistema no cumple — y omitía CP-01c'.
  • Entregables presentados (Segunda Eval): dicen ±20% para CP-01, pero son históricos (anteriores a ADR-0011) y coherentes para su fecha → no se editan.

Cambios (este PR — solo docs/SRS.md)

  • §2.13: CP-12 → ≤2000 ms p95 (ADR-0019); nuevas filas CP-01c' (duration ±30%/≥75, ADR-0021) y CP-01a-95 (IC95 inf 0.860, P=100%, ADR-0016).
  • §2.7 (RN-05), §2.10 (Rendimiento), §2.15 (ítem 5): performance a ≤2000 ms p95.
  • Nota CP-01 ampliada con CP-01c'/CP-01a-95.
  • Nuevo §2.17 "Addendum de revisión post-implementación": tabla de reconciliación original→vigente con ADR y causa, anclada en la nota §2.12.

Fuera de este PR (ya aplicado en el vault, no versionado)

  • SRS LaTeX congelado (Entregables/SRS/SRS_Sentinel-Dispatch.tex): mismo §2.17 con los criterios originales intactos en su cuerpo (registro histórico). PDF regenerado con tectonic (19 páginas, addendum presente); versión previa archivada en Entregables/SRS/Archivo/.

DoD

  • Cambio de contrato/documentación → doc actualizada (es el cambio mismo).
  • No toca código ni tests (docs-only); CI debe pasar sin cambios.
  • Decisión costosa de revertir documentada (H-04 resuelto vía addendum, no reescritura).
  • Sin secretos.
  • Auto-revisión documentada (Fernando Godoy no disponible).

…H-04)

Resuelve la decisión H-04 de FTR-03 (revisión del primer entregable):
cómo tratar los criterios numéricos del SRS que cambiaron por evidencia.
Enfoque elegido: addendum + arreglar espejo (no se reescribe la historia).

docs/SRS.md (espejo vivo):
- §2.13: CP-12 → ≤2000 ms p95 (ADR-0019); nuevas filas CP-01c' (±30%/≥75,
  ADR-0021) y CP-01a-95 (IC95 inf 0.860, P=100%, ADR-0016).
- §2.7 RN-05, §2.10 Rendimiento, §2.15 ítem 5: performance ≤2000 ms p95.
- Nota CP-01 ampliada con CP-01c'/CP-01a-95.
- Nuevo §2.17 'Addendum de revisión post-implementación': tabla de
  reconciliación original→vigente con ADR y causa, anclada en la nota §2.12.

El SRS LaTeX del vault (entregable congelado) recibe el mismo §2.17 con los
criterios originales intactos en su cuerpo; PDF regenerado, versión previa
archivada. Los entregables ya presentados (Segunda Eval) no se editan.
@Jacket-69 Jacket-69 merged commit b278009 into main Jun 3, 2026
6 checks passed
@Jacket-69 Jacket-69 deleted the docs/h5-srs-addendum branch June 3, 2026 03:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant