Initial commit: BodySpec Insights - comprehensive DEXA analytics tool

data/.gitkeep

@@ -0,0 +1,3 @@
+# This file ensures the data directory structure is preserved in git
+# while keeping the actual PDF and results files private (see .gitignore)
+

data/pdfs/README.md

@@ -0,0 +1,17 @@
+# PDFs Directory
+
+Place your BodySpec DEXA scan PDF reports in this directory.
+
+## Example
+
+```
+data/pdfs/
+├── 2025-01-15-scan.pdf
+├── 2025-04-20-scan.pdf
+└── 2025-10-06-scan.pdf
+```
+
+## Note
+
+⚠️ **PDF files are gitignored** - They won't be committed to version control to protect your personal health information.
+

data/results/README.md

@@ -0,0 +1,18 @@
+# Results Directory
+
+Your extracted DEXA data will be saved here by default.
+
+## Output Files
+
+When you run the extraction script with `--outdir data/results`, you'll get:
+
+- `overall.csv` - Time-series data (one row per scan)
+- `regional.csv` - Regional body composition
+- `muscle_balance.csv` - Left/right limb comparison
+- `overall.json` - Structured JSON format
+- `summary.md` - Human-readable summary
+
+## Note
+
+⚠️ **Result files are gitignored** - They contain your personal health data and won't be committed to version control.
+