mirror of
https://github.com/sstent/FitTrack_GarminSync.git
synced 2026-01-25 16:41:41 +00:00
Initial commit from Specify template
This commit is contained in:
33
initialspec.md
Normal file
33
initialspec.md
Normal 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
|
||||
Reference in New Issue
Block a user