2.0.0 Beta : Self-hosted Release

database/README.md

@@ -22,6 +22,9 @@ This directory separates four different responsibilities:
 8. Missing metrics are stored as `NULL`, not fabricated zero values.
 9. `Admin -> Data Integrity` is the operational source of truth.
 10. Web schema changes increment `Config.WEB_SCHEMA_VERSION`.
+11. `YRTV_DATA_DIR` owns runtime databases; code schemas always stay in Git.
+12. Container and production deployments must keep runtime data outside the
+    image and source checkout.
 
 ## Entry Points
 
@@ -31,11 +34,16 @@ make l2          # Rebuild normalized facts
 make l3          # Rebuild active-roster features
 make pipeline    # Run L1 -> L2 -> L3 with backup and validation
 make check       # Compile and run tests
+make bootstrap   # Initialize an empty runtime data root
+make prepare-data # Copy legacy data into runtime-data
 ```
 
 ## Directory Policy
 
-- `L1/`, `L2/`, `L3/`, `Web/`: active code, schema and database.
+- Without `YRTV_DATA_DIR`, `L1/`, `L2/`, `L3/`, `Web/` remain the compatible
+  development runtime.
+- With `YRTV_DATA_DIR`, those folders provide code and schemas while databases
+  live under the configured external directory.
 - `backups/`: generated rollback snapshots; ignored by Git.
 - `schema_bkp/`: historical schema research only; not used at runtime.
 - `L1B/`: reserved demo-parser integration; not used at runtime.