/validation-and-release/index.html Capture what validation is enforced, how builds are produced, and how common failures should be diagnosed. Hugo en-gb /validation-and-release/validation-contract/index.html Mon, 01 Jan 0001 00:00:00 +0000 /validation-and-release/validation-contract/index.html This page separates what is enforced now from what is intended later. Enforced Now Current validation checks: required market files exist config.yml loads required top-level config keys exist week_start is one of the allowed values required functions can be sourced forbidden local-environment patterns are blocked in committed scripts Planned Next Not fully enforced yet: /validation-and-release/validation-and-build/index.html Mon, 01 Jan 0001 00:00:00 +0000 /validation-and-release/validation-and-build/index.html Validation is not optional in this repository. The purpose of validation is to catch the kinds of failures that historically appeared only after packaging or deployment. Run commands from the repository root. Validation Entry Points Validate all migrated markets: Rscript scripts/validate_all.R Validate one migrated market: Rscript scripts/validate_market.R markets/CN/store_visits Build Entry Point Build one market/KPI: /validation-and-release/build-and-release/index.html Mon, 01 Jan 0001 00:00:00 +0000 /validation-and-release/build-and-release/index.html Builds should be reproducible from the repository state. Current Build Entry Point Rscript scripts/build_market.R markets/CN/store_visits Current State The build scaffold exists, but real market build logic still needs to be migrated into each market folder. Intended Build Outcome Each build should eventually produce: /validation-and-release/troubleshooting/index.html Mon, 01 Jan 0001 00:00:00 +0000 /validation-and-release/troubleshooting/index.html This page captures common failure modes that this repo is intended to prevent. Transform Works Locally But Fails In API Typical causes: hidden package dependencies un-namespaced function calls local helper scripts not committed local data reads embedded in transform logic Model And Transform Are Out Of Sync Typical symptom: