Initial scaffold: docs, data manifest, and static dashboard

This commit is contained in:
2026-03-17 12:49:08 -04:00
commit dbbe0bae66
8 changed files with 299 additions and 0 deletions

13
docs/data-structure.md Normal file
View File

@@ -0,0 +1,13 @@
# Data Structure
## Data Sources
- CSV exports (source of truth)
- DAX exports (measure definitions)
## Storage
- `/data/*.csv` — raw CSV exports
- `/data/manifest.json` — list of CSV files loaded by the app
## Notes
- No database yet; app loads CSVs directly via fetch.
- Column types and relationships will be documented here once data lands.

8
docs/kpi-definitions.md Normal file
View File

@@ -0,0 +1,8 @@
# KPI Definitions
> This file will map each KPI to its exact formula and validation notes.
## Template
| KPI Name | Definition | Source Tables | Filters | Notes |
|---|---|---|---|---|
| Example KPI | SUM(Table[Amount]) | Table | DateRange | Match Power BI card |

22
docs/migration-plan.md Normal file
View File

@@ -0,0 +1,22 @@
# Migration Plan
## Phase 1 — Intake & Inventory
- [ ] Collect CSV/DAX exports and source report screenshots
- [ ] Document data model + relationships
- [ ] Identify all KPIs and filters
## Phase 2 — KPI Definition
- [ ] Translate each DAX measure into deterministic formulas
- [ ] Validate calculations against source data
## Phase 3 — Backend Logic (Local)
- [ ] Implement KPI calculations in JS (no database yet)
- [ ] Build reusable aggregation utilities
## Phase 4 — UI Buildout
- [ ] Recreate filters, charts, and tables
- [ ] Match layout/visual hierarchy
## Phase 5 — Validation
- [ ] Compare KPI outputs to Power BI values
- [ ] Iterate until exact match