90b37fe4c2
- Delete 4 empty, unreferenced orphan scripts in dev/scripts/ (find_databricks_workspace, scrape_bls_data, generate_bls_express, test_databricks_connection). - Remove the unconditionally-skipped TestFixFields.test_runs in tests/zot/test_ops.py — fix_fields is already exercised end-to-end by test_ops_deep.py::test_fix_fields_remap_and_delete (which builds the itemTypeFieldsCombined view the stub said it needed). - Remove the empty .github/workflows/ orphan left from the Gitea move (CI lives entirely in .gitea/workflows/). - Drop two dead locals in dev/scripts (F841): an unused authors_section loop and a `tags` assignment immediately overwritten by fresh_tags. - docs/docs/intro.md listed only 9 of 17 modules — sync the packages table and src/ tree with the actual module set.
2.6 KiB
2.6 KiB
slug, sidebar_position
| slug | sidebar_position |
|---|---|
| / | 1 |
Stack
Python-first data platform for healthcare analytics, replacing dbt with narwhals DataFrame-agnostic expression functions backed by DuckDB.
Packages
| Package | Description |
|---|---|
| aco | ACO REACH analytics — express functions, pipe layer, lake |
| api | FastAPI service — pipelines, lineage, schema, bib, auth, health |
| bcda | Beneficiary Claims Data API client and pipeline |
| bib | Bibliography store — CMS rules, regulations, manuals |
| bls | Bureau of Labor Statistics data access |
| ccw | Chronic Conditions Warehouse documentation codex |
| cli | Typer CLI aggregating the module sub-apps |
| cms | CMS table models, logging, and shared utilities |
| conf | stack.toml loader + context switching (local/lake/cloud) |
| Touchless mail-server automation for the domain | |
| opps | Outpatient PPS models, rules, and payment calcs |
| perf | OpenTelemetry telemetry (opt-in) |
| pfs | Physician Fee Schedule pipeline and rules |
| prisma | LLM-driven PRISMA systematic-review screening |
| rec | Payment reconciliation engine vs CMS ground-truth |
| rex | Record expression engine — copybook parsing, storage |
| sem | AST-based semantic coverage / test-target ranking |
Architecture
src/
├── aco/ # ACO REACH express functions + pipe layer
│ ├── express/ # narwhals DataFrame functions
│ ├── pipe/ # pipeline runner + step modules
│ └── lake/ # multi-backend lakehouse engine
├── api/ # FastAPI service (routes, auth, health)
├── bcda/ # BCDA API client + CCLF pipeline
├── bib/ # bibliography store (SQLite)
├── bls/ # BLS data loader
├── ccw/ # CCW documentation codex
├── cli/ # Typer CLI (aggregates module sub-apps)
├── cms/ # shared CMS models + logging
├── conf/ # config loader + context switching
├── mail/ # mail-server automation
├── opps/ # Outpatient PPS models + calcs
├── perf/ # OpenTelemetry telemetry (opt-in)
├── pfs/ # Physician Fee Schedule
├── prisma/ # LLM PRISMA screening
├── rec/ # payment reconciliation engine
├── rex/ # record expression engine
└── sem/ # semantic coverage tooling
Links
- Library — searchable bibliography of CMS rules, regulations, and manuals
- API Reference — auto-generated from docstrings