How dkj121/runner works
RUNNER is a running and running-group web app. Its main workflow captures a user’s GPS track, sends sequenced points and pause/resume/stop events to run APIs, then confirms and stores a calculated run for history and analysis. Playground membership, invitations, and leaderboards are a separate social branch. The graph focuses on these documented capabilities and sampled runtime paths; unsampled UI and API internals are represented at their exact enclosing paths, with no inferred links where wiring was not shown.
Main entry points: gps-cache.ts Live run cache · route.ts Run detail API · prisma.ts Database access · create-route.ts Route wrapper
Components 25
Run tracking
- Run screens
src/app/(dashboard)/run/page.tsx - Run tracker
src/hooks/use-run-tracker.ts - GPS tracking
src/hooks/use-gps-tracking.ts - Map display
src/components/map-loader.tsx
Run services
- Run APIs
src/app/api/runs/route.ts - Run detail API
src/app/api/runs/[runId]/route.ts - Completion API
src/app/api/runs/[runId]/complete/route.ts - Route wrapper
src/lib/create-route.ts
Run processing
- Run lifecycle
src/lib/run-lifecycle.ts - Live run cache
src/lib/gps-cache.ts - Timeline processing
src/lib/run-timeline.ts - Track validation
src/lib/track-point-validation.ts - Track calculations
src/lib/track-calc.ts - Run confirmation
src/lib/confirmed-run.ts - Run data contract
src/lib/run-contract.ts - Run queries
src/lib/run-query.ts
Running groups
- Group screens
src/app/(dashboard)/playground - Group APIs
src/app/api/playgrounds/route.ts - Leaderboards
src/app/api/playgrounds/[id]/leaderboard/route.ts
Identity and storage
- Sign-in screens
src/app/(auth)/login/page.tsx - Auth client
src/lib/auth-client.ts - Auth service
src/lib/auth.ts - Database access
src/lib/prisma.ts - Redis cache
src/lib/redis.ts
Other components
- Runner
Connections 43
- Runner → Run screens: uses
- Run screens → Run tracker: starts tracking
- Run tracker → GPS tracking: uses GPS
src/hooks/use-run-tracker.ts - Run tracker → Track calculations: calculates track
src/hooks/use-run-tracker.ts - Run tracker → Track validation: validates points
src/hooks/use-run-tracker.ts - Run tracker → Timeline processing: uses events
src/hooks/use-run-tracker.ts - Map display → Timeline processing: groups segments
src/components/map-loader.tsx - Map display → Run data contract: uses types
src/components/map-loader.tsx - Run screens → Map display: renders map
- Run screens → Run APIs: requests runs
- Run APIs → Route wrapper: wraps handlers
src/app/api/runs/route.ts - Run APIs → Run lifecycle: expires sessions
src/app/api/runs/route.ts - Run APIs → Database access: writes run records
src/app/api/runs/route.ts - Run APIs → Live run cache: creates session
src/app/api/runs/route.ts - Run detail API → Route wrapper: wraps handlers
src/app/api/runs/[runId]/route.ts - Run detail API → Run lifecycle: enforces lifecycle
src/app/api/runs/[runId]/route.ts - Run detail API → Database access: reads records
src/app/api/runs/[runId]/route.ts - Run detail API → Live run cache: reads live data
src/app/api/runs/[runId]/route.ts - Run detail API → Timeline processing: calculates duration
src/app/api/runs/[runId]/route.ts - Run detail API → Track calculations: calculates distance
src/app/api/runs/[runId]/route.ts - Completion API → Route wrapper: wraps handler
src/app/api/runs/[runId]/complete/route.ts - Completion API → Run confirmation: calculates result
src/app/api/runs/[runId]/complete/route.ts - Completion API → Live run cache: reads and clears
src/app/api/runs/[runId]/complete/route.ts - Completion API → Database access: stores completion
src/app/api/runs/[runId]/complete/route.ts - Run confirmation → Track calculations: calculates metrics
src/lib/confirmed-run.ts - Run confirmation → Timeline processing: uses timeline
src/lib/confirmed-run.ts - Run confirmation → Run data contract: uses types
src/lib/confirmed-run.ts - Live run cache → Redis cache: stores live data
src/lib/gps-cache.ts - Live run cache → Track validation: validates points
src/lib/gps-cache.ts - Live run cache → Timeline processing: validates events
src/lib/gps-cache.ts - Live run cache → Run data contract: uses types
src/lib/gps-cache.ts - Run lifecycle → Database access: updates status
src/lib/run-lifecycle.ts - Run lifecycle → Live run cache: reads and clears
src/lib/run-lifecycle.ts - Run lifecycle → Route wrapper: used by routes
- Group screens → Group APIs: uses group APIs
- Group APIs → Database access: reads and writes
src/app/api/playgrounds/route.ts - Group APIs → Route wrapper: wraps handlers
src/app/api/playgrounds/route.ts - Leaderboards → Database access: queries groups
src/app/api/playgrounds/[id]/leaderboard/route.ts - Leaderboards → Run queries: filters runs
src/app/api/playgrounds/[id]/leaderboard/route.ts - Sign-in screens → Auth client: uses auth
- Auth client → Auth service: auth requests
- Route wrapper → Auth service: checks session
src/lib/create-route.ts - Auth service → Database access: uses database
src/lib/auth.ts