Skip to content

Commit 93ed3f8

Browse files
committed
feat: v1.2.0 - Analytics dashboard & comprehensive docs
Dashboard: - Personal baselines section with rolling averages, ranges, status - Detected patterns section with correlations, trends, risk scores - Empty state guidance for analytics requirements Documentation: - New Integration Guide for Laravel/SaaS consumers - LLM-friendly llms.txt for AI tools - Mermaid diagrams replacing ASCII art - Updated index with all links Version bump to 1.2.0 Stu Mason + AI <me@stumason.dev>
1 parent e92c691 commit 93ed3f8

File tree

10 files changed

+1051
-8
lines changed

10 files changed

+1051
-8
lines changed

CHANGELOG.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
99

1010
---
1111

12+
## [1.2.0] - 2026-01-13
13+
14+
### Added
15+
16+
**Admin Dashboard Analytics**
17+
- Personal Baselines section displaying:
18+
- All calculated baselines (HRV, sleep score, resting HR, training load, etc.)
19+
- Rolling averages (7-day, 30-day) with percentage change from baseline
20+
- Min/max range and sample counts
21+
- Status indicators (ready, partial, insufficient)
22+
- Detected Patterns section displaying:
23+
- Correlations (sleep-HRV, training-recovery, activity-sleep)
24+
- Composite scores (overtraining risk, recovery readiness)
25+
- Trends (HRV, sleep, fitness)
26+
- Statistical significance levels (high/medium/low)
27+
- Pattern interpretations and contributing factors
28+
- Empty state guidance explaining analytics requirements (7+ days of data)
29+
30+
### Documentation
31+
- This release makes analytics features visible in the admin dashboard
32+
- Analytics power the `/users/{user_id}/insights` API endpoint for downstream consumers
33+
34+
---
35+
1236
## [1.1.0] - 2026-01-13
1337

1438
### Added
@@ -140,6 +164,7 @@ First stable release of polar-flow-server - a self-hosted health analytics serve
140164
- Database models for Polar data types
141165
- Sync service foundation
142166

167+
[1.2.0]: https://github.com/StuMason/polar-flow-server/compare/v1.1.0...v1.2.0
143168
[1.1.0]: https://github.com/StuMason/polar-flow-server/compare/v1.0.0...v1.1.0
144169
[1.0.0]: https://github.com/StuMason/polar-flow-server/compare/v0.2.0...v1.0.0
145170
[0.2.0]: https://github.com/StuMason/polar-flow-server/compare/v0.1.0...v0.2.0

docs/index.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,10 +37,14 @@ Polar devices collect health data: sleep, HRV, activity, exercises. The Polar AP
3737

3838
## Architecture
3939

40-
```
41-
Polar API → polar-flow-sdk → Sync Service → Database → Analytics → REST API
42-
43-
Dashboard/App
40+
```mermaid
41+
flowchart LR
42+
A[Polar API] --> B[polar-flow SDK]
43+
B --> C[Sync Service]
44+
C --> D[(Database)]
45+
D --> E[Analytics Engine]
46+
E --> F[REST API]
47+
F --> G[Dashboard/App]
4448
```
4549

4650
Python data analytics engine:
@@ -107,7 +111,9 @@ curl -X POST \
107111
## Links
108112

109113
- [Quick Start Guide](quickstart.md)
114+
- [Integration Guide](integration.md) - Laravel/SaaS integration
110115
- [Architecture](architecture.md)
111116
- [API Reference](api/overview.md)
112117
- [GitHub Repository](https://github.com/StuMason/polar-flow-server)
113118
- [polar-flow SDK](https://stumason.github.io/polar-flow/)
119+
- [LLM-Friendly Docs](https://raw.githubusercontent.com/StuMason/polar-flow-server/main/llms.txt) - Aggregated text for AI tools

0 commit comments

Comments
 (0)