Initial commit from Specify template

This commit is contained in:
2025-10-09 06:38:23 -07:00
commit d0e29fbeb4
26 changed files with 13015 additions and 0 deletions

33
initialspec.md Normal file
View File

@@ -0,0 +1,33 @@
## 2. GarminSync Service
### Feature Name: IntialSpecV2
### Purpose
Manage synchronization with Garmin Connect and other fitness platforms
### Core Requirements
- **Platform Integration**
- Garmin Connect OAuth2 authentication
- Activity download (FIT.GPX/TCX files) stored in CentralDB
- Health metrics synchronization
- Workout upload to Garmin
- Fitbit weight data sync (future)
- this is a single user app
- default listen port 8001
- configuration should accept yaml or environment vars
-
- **API Endpoints**
- `POST /api/sync/garmin/activities` - Trigger activity sync
- `GET /api/sync/status` - Check sync status
- **Technical**
- Background job processing
- Rate limiting for API calls
- Error handling and retry logic
- Sync history and conflict resolution (using CentralDB database)
- **Existing Code**
- Use @GarminAnalyser.md to pull code from the existing implementation. This is a working version, reuse as much as possible.
- Use CentralDB for storage (incl. refresh tokens etc)
- CentralDB API is in @DB_API_SPEC.json - you cna refresh the spec at curl http://localhost:8000/openapi.json