Add the Stage 12 parallel v2 simulation path
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
Línea de trabajo
El issue no nombra archivos de implementación del repositorio, pruebas ni puntos de entrada; sí identifica archivos bundle .py de PolicyEngine.py y el comprobante privado reports/comparison.json. Empieza revisando la dependencia de deployment de PolicyEngine/policyengine-api#3842 y la validación de deployment existente. La tarea estará terminada cuando estén verificadas las comprobaciones de aceptación, los recursos v2 enumerados, la ruta aislada de dispatch y comparación, y la autoridad de producción sin cambios.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Objective
Add the Stage 12 v2 comparison path alongside the existing simulation services without replacing the current production calculation path or making v2 output authoritative.
Scope
- Deploy a separately named Modal v2 application.
- Run one report coordinator that starts baseline and reform as independent simulation functions before waiting for either result.
- Publish and consume a v2 version manifest that is separate from the existing v1 manifest.
- Resolve country-package and dataset versions exclusively from reviewed PolicyEngine.py
.pybundle files. - Provide a temporary authenticated direct Stage 12 runner for qualification.
- When
STAGE12_ENABLED=1, automatically start one Stage 12 comparison run after a supported production annual society-wide report is accepted. - Wait no more than five seconds for Modal to acknowledge the coordinator invocation, then return the unchanged production response without waiting for Stage 12 calculation or comparison.
- After Stage 12 aggregation, retrieve the production Modal result, compare the complete aggregate result objects exactly, and write a private
reports/comparison.jsonreceipt containing result digests and every differing scalar leaf. - Isolate Stage 12 dispatch, calculation, comparison, artifact, and persistence failures from the production result.
- Remove the shared runtime-control object, process-local dispatch queue, and periodic PostgreSQL cleanup function.
Deployment dependency
PolicyEngine/policyengine-api#3842 adds the comparison-result columns consumed by this runtime. That PR must merge and its v2 Alembic revision must run before this simulation PR merges. The production restricted PostgreSQL URL secret and environment configuration must also be present and pass the existing deployment validation.
The beta and prod GitHub environments both define STAGE12_ENABLED=0. Merging this PR therefore deploys the separate Modal application, separate v2 manifest, Cloud Run configuration, and temporary authenticated direct endpoint without automatically sending normal report submissions to Stage 12. Setting one environment value to 1 and deploying Cloud Run enables automatic runs in that environment; it does not change the existing production forwarding destination or result authority.
Acceptance criteria
- Existing v1 routing and user-visible result authority are unchanged.
- Baseline and reform simulations execute independently and are aggregated by the report coordinator.
- V1 and v2 manifests use distinct storage objects.
- Stage 12 resources deploy in both staging and production after prerequisites exist.
- Automatic runs remain disabled in both environments after the initial deployment.
- The five-second Modal-acknowledgement wait is the only Stage 12 work on the production request path.
- Direct Stage 12-only execution remains available independently of
STAGE12_ENABLEDwhen resources are configured. - No periodic Stage 12 function runs.
- Private artifacts expire through the existing 30-day storage lifecycle; temporary PostgreSQL rows remain until Stage 14.
- Local tests, formatting, focused type checks, container-import validation, and deployment-contract checks pass.
- Lenguaje dominante
- Python
- Estrellas
- 1
- Forks
- 1
- Merge medio
- 9 h 14 min
- PR fusionados (30 d)
- 8
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de PolicyEngine/policyengine-sim-api
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 45/100
PolicyEngine/policyengine-sim-api#674 · 3 comentarios ·
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
Todos los issues de PolicyEngine/policyengine-sim-api
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100