Data PlatformZoom level 3
Who calls what: world
Every class, function and method in the world package, with who calls it. Found by reading the code. A call written as object.method() is matched by the method's name, so a same-named method elsewhere can appear: those rows say by name.
196 definitions in 12 modules. Jump to a module: clock.py · __init__.py · clinical.py · clinical_gold.py · clinical_oracle.py · tyre.py · tyre_gold.py · tyre_oracle.py · dwd.py · engine.py · oracle.py · shop.py
world/clock.py
The simulated clock (DPC-0032: jobs read time only through the clock port). A world day is one business day in the business time zone; day 1 starts at the DWD's clock.start. The simulated company
world/domains/__init__.py
Domain models: how one simulated company's source systems behave. The DWD's `name` picks the model. The simulated company
| Definition | What it does (its own first sentence) | Called by | Named in tests |
|---|---|---|---|
model_forfunction, line 14 | main · scripts/run_platform.py:444main · scripts/run_world.py:175Harness.build · twin/runner.py:87 | test_ingest_world.py, test_semantic_metrics.py and 5 more | |
gold_judge_forfunction, line 27 | The domain's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns. | _duckdb · scripts/platform_binding.py:72_table_port · scripts/platform_binding.py:102_legacy · scripts/platform_binding.py:117 | test_world_clinical.py |
models_folderfunction, line 41 | The folder of the domain's gold build models, under the repo's models/ (named by the platform domain). | _duckdb · scripts/platform_binding.py:72_table_port · scripts/platform_binding.py:101_legacy · scripts/platform_binding.py:116 | test_world_clinical.py |
world/domains/clinical.py
The clinical trial (data-platform-catalog slices/03-clinical/world.yaml): six source systems, day by day. The simulated company
world/domains/clinical_gold.py
The clinical trial's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns. The simulated company
world/domains/clinical_oracle.py
The clinical trial's oracle: per simulated day, what a correct platform holds at bronze, silver and gold, and what each certified metric must say. Computed only from the world's own truth (R9, SIM-01). The simulated company
world/domains/tyre.py
The tyre company (data-platform-catalog slices/02-tyre/world.yaml): six source systems, day by day. The simulated company
world/domains/tyre_gold.py
The tyre world's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns. The simulated company
world/domains/tyre_oracle.py
The tyre world's oracle: per simulated day, what a correct platform holds at bronze, silver and gold, and what each certified metric must say. Computed only from the world's own truth (R9, SIM-01). The simulated company
| Definition | What it does (its own first sentence) | Called by | Named in tests |
|---|---|---|---|
day_oraclefunction, line 22 | TyreCompany.oracle · world/domains/tyre.py:800 | no test names it | |
measuresfunction, line 42 | The dataset manifest's own reconciliation measures, so the oracle and the platform count the same things. | _silver · world/domains/tyre_oracle.py:62 | test_semantic_governance.py, gold_helpers.py and 17 more |
_silverfunction, line 52 | day_oracle · world/domains/tyre_oracle.py:32 | no test names it | |
_local_datefunction, line 91 | _hit · world/domains/tyre_oracle.py:148_sales · world/domains/tyre_oracle.py:204 | no test names it | |
_otiffunction, line 95 | day_oracle · world/domains/tyre_oracle.py:24 | no test names it | |
_hitfunction, line 147 | _otif · world/domains/tyre_oracle.py:104 | no test names it | |
_scrapfunction, line 152 | day_oracle · world/domains/tyre_oracle.py:25 | no test names it | |
_salesfunction, line 191 | day_oracle · world/domains/tyre_oracle.py:26 | no test names it | |
_sales.cellfunction, line 198 | _sales · world/domains/tyre_oracle.py:206 | no test names it | |
_sales.reported_byfunction, line 222 | _sales · world/domains/tyre_oracle.py:226 | no test names it | |
_wherefunction, line 246 | `region = 'south' AND promised month = 2026-11` -> {"region": "south", "promised month": "2026-11"}. | known_answers · world/domains/tyre_oracle.py:264 | no test names it |
known_answersfunction, line 255 | Every known answer the metric views carry (ADR-022), beside what the world produced for the same question. The questions and values are read from the metric view files, so the oracle never restates them. | day_oracle · world/domains/tyre_oracle.py:35 | test_semantic_governance.py, test_end_to_end.py and 3 more |
_pctfunction, line 281 | _otif · world/domains/tyre_oracle.py:127_scrap · world/domains/tyre_oracle.py:169 | no test names it |
world/dwd.py
Reads a DWD world (dwd/v0) and the specification it cites: dataset manifests and their ODCS contracts. The simulated company
| Definition | What it does (its own first sentence) | Called by | Named in tests |
|---|---|---|---|
DwdErrorclass, line 20 | apply_calendar · world/dwd.py:73_set_paths · world/dwd.py:111load · world/dwd.py:132 | test_world_calendar.py, test_world_clinical.py | |
Datasetclass, line 25 | load · world/dwd.py:138module level · world/dwd.py:41 (value) | test_postgres_to_delta.py, test_adf_generator.py and 2 more | |
Dataset.table_namemethod, line 33 | read_back · scripts/run_world.py:129 (value)World.write · world/engine.py:137 (value) | test_obs_pipeline_events.py, test_bronze_to_silver.py and 4 more | |
Dwdclass, line 38 | load · world/dwd.py:124 | no test names it | |
Dwd.systemsmethod, line 45 | none found in the code | test_world_calendar.py | |
Dwd.kind_ofmethod, line 48 | change_feeds · scripts/run_platform.py:228 (by name)mover.move · scripts/run_platform.py:240 (by name)main.live_rows · scripts/run_platform.py:481 (by name)read_back · scripts/run_world.py:115 (by name)World.prepare · world/engine.py:81 (by name)World._check · world/engine.py:111 (by name) | test_gold_harness.py, test_hop_reports.py and 4 more | |
Dwd.in_systemmethod, line 51 | World.prepare · world/engine.py:82 (by name) | no test names it | |
_yamlfunction, line 55 | load · world/dwd.py:120 | no test names it | |
apply_calendarfunction, line 67 | A named calendar from the world's `calendars:` block moves incidents to other days (for a short run that still meets every incident). Every incident must be moved, a moved key must be `day` or one of its day params, and the order of days mu | load · world/dwd.py:122 | test_world_calendar.py, test_world_clinical.py |
_set_pathsfunction, line 97 | `world:` in a calendar changes existing settings by dotted path (systems.partner_drop.file_window_days); a path that is not already in the world, or a value of another type, is an error. | apply_calendar · world/dwd.py:93 | no test names it |
loadfunction, line 118 | none found in the code | no test names it | |
_tablefunction, line 147 | load · world/dwd.py:138 | no test names it |
world/engine.py
The world engine: runs the clock a day at a time, asks the domain model what its source systems did that day, writes it into the mock sources through their ports, and saves the oracle's totals for the day. The simulated company
world/oracle.py
The oracle: what silver must hold, computed from the world's own record, never from the platform's logs. The simulated company
| Definition | What it does (its own first sentence) | Called by | Named in tests |
|---|---|---|---|
expected_currentfunction, line 10 | Current orders after applying every change the platform should have accepted, newest change sequence wins. | run_checks · realms/databricks/tasks/checks.py:32 | test_slice1_local.py |
judge_silverfunction, line 26 | oracle silver-agrees-with-world: count, keys, amount total and status per order. | run_checks · realms/databricks/tasks/checks.py:32 | test_slice1_local.py |
world/shop.py
The clothing shop's orders database, as a change feed, for slice 1 (data-platform-catalog slices/01-orders/world.yaml). The simulated company