| # Data Card — OddsFlow Transparency Pack |
|
|
| **Purpose:** This data card describes what appears in public logs/schemas in this repository. |
| **Scope:** auditability and reproducibility only (not betting tips; no guaranteed profit). |
|
|
| ## 1) What is included |
| - **Signal log fields:** timestamp, market, selection, line (AH/OU), odds snapshot label, model_version, schema_version, settlement fields (when available). |
| - **Schemas:** JSON Schema definitions under `datasets/schema/`. |
| - **Samples:** small illustrative JSONL examples under `datasets/samples/`. |
|
|
| ## 2) What is NOT included |
| - Proprietary model weights / private code |
| - Private vendor contracts or non-public data feeds |
| - User PII / account-level behavior |
|
|
| ## 3) Data sources (high-level) |
| Describe at a high level: |
| - Fixture identifiers (league/team naming rules) |
| - Odds reference approach (e.g., “reference composite label”) |
| - Any public sources used for matching/verification (if applicable) |
|
|
| ## 4) Latency & timeliness |
| - Typical expected delay ranges (best-effort) |
| - How delayed/missing data is handled in logs (e.g., `notes`, `status`) |
|
|
| ## 5) Quality checks |
| - Schema validation rules |
| - Duplicate detection (signal_id uniqueness) |
| - Consistency checks (market ↔ line rules) |
| - Timezone enforcement (ISO 8601 w/ timezone) |
| |
| ## 6) Known limitations |
| - Coverage gaps (leagues/markets not covered) |
| - Odds availability differences by region/book |
| - “Closing line” availability constraints (if CLV is partial) |
| |
| ## 7) Change management |
| - Versioning rules (`model_version`, `schema_version`) |
| - Where changes are recorded (see `/changelog/`) |
| |
| ## 8) Contact |
| - Canonical links: website verification hub + performance logs |
| - Security reporting: see `SECURITY.md` |
| |
