30d40de7cf
- Turborepo + pnpm workspaces with catalog for shared dependency versions - TypeScript strict config (base + per-package extends) - Tailwind CSS v4 via @tailwindcss/vite plugin - ESLint + Prettier shared config - Planner app scaffolded with React Router 7 (port 3001) - Journal app scaffolded with React Router 7 (port 3000) - Both apps build and start successfully via turbo Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
114 lines
7 KiB
Markdown
114 lines
7 KiB
Markdown
## 1. Monorepo Toolchain Setup
|
|
|
|
- [x] 1.1 Install pnpm and Turborepo, configure workspaces
|
|
- [x] 1.2 Set up TypeScript config (base tsconfig, per-package extends)
|
|
- [x] 1.3 Set up Tailwind CSS (shared config, content paths for monorepo)
|
|
- [x] 1.4 Set up ESLint and Prettier (shared config)
|
|
- [x] 1.5 Scaffold Planner app with React Router 7 (`apps/planner`)
|
|
- [x] 1.6 Scaffold Journal app with React Router 7 (`apps/journal`)
|
|
- [x] 1.7 Verify `turbo dev` starts both apps and `turbo build` succeeds
|
|
|
|
## 2. Shared Packages
|
|
|
|
- [ ] 2.1 Implement `@trails-cool/types` — Route, Activity, Waypoint, RouteVersion, RouteMetadata interfaces
|
|
- [ ] 2.2 Implement `@trails-cool/gpx` — GPX parser (XML → waypoints/tracks/elevation) and GPX generator (waypoints/tracks → XML)
|
|
- [ ] 2.3 Implement `@trails-cool/map` — MapView React component (Leaflet + OSM), RouteLayer component (GeoJSON polyline), layer switcher (OSM/OpenTopoMap/CyclOSM)
|
|
- [ ] 2.4 Implement `@trails-cool/ui` — Button, Input, Card, Layout components with Tailwind styling
|
|
- [ ] 2.5 Implement `@trails-cool/i18n` — react-i18next config, English + German translation files, LanguageSwitcher component
|
|
- [ ] 2.6 Verify all packages are importable from both apps
|
|
|
|
## 3. Infrastructure
|
|
|
|
- [ ] 3.1 Create Terraform config for Hetzner CX21 with Docker installed
|
|
- [ ] 3.2 Create Docker Compose for all services (Journal, Planner, BRouter, PostgreSQL+PostGIS, Garage)
|
|
- [ ] 3.3 Create BRouter Dockerfile with segment volume mount
|
|
- [ ] 3.4 Create segment download script (Germany: E5_N45, E5_N50, E10_N45, E10_N50)
|
|
- [ ] 3.5 Configure DNS for trails.cool and planner.trails.cool with TLS (Caddy or Traefik)
|
|
- [ ] 3.6 Set up GitHub Actions CI pipeline (build, typecheck, lint)
|
|
- [ ] 3.7 Set up GitHub Actions CD pipeline (build Docker images, push to ghcr.io, deploy to Hetzner)
|
|
- [ ] 3.8 Set up PostgreSQL backup cron (daily pg_dump to Hetzner Storage Box)
|
|
|
|
## 4. Planner — Session Management
|
|
|
|
- [ ] 4.1 Set up Yjs with y-websocket in Planner backend (WebSocket endpoint at /sync)
|
|
- [ ] 4.2 Implement Yjs persistence to PostgreSQL (planner schema, sessions table)
|
|
- [ ] 4.3 Implement session creation endpoint (POST /api/sessions → returns session ID)
|
|
- [ ] 4.4 Implement session creation with initial GPX (parse GPX → Yjs document with waypoints)
|
|
- [ ] 4.5 Implement session join page (GET /session/:id → connect to Yjs document)
|
|
- [ ] 4.6 Implement session expiry (garbage collection cron, configurable TTL)
|
|
- [ ] 4.7 Implement manual session close (owner action, notify participants)
|
|
- [ ] 4.8 Implement user presence display (Yjs awareness, colors, names)
|
|
|
|
## 5. Planner — BRouter Integration
|
|
|
|
- [ ] 5.1 Implement BRouter HTTP proxy endpoint (POST /api/route → forward to BRouter)
|
|
- [ ] 5.2 Implement rate limiting middleware (60 requests/session/hour)
|
|
- [ ] 5.3 Implement routing host election via Yjs awareness (host/participant roles)
|
|
- [ ] 5.4 Implement routing host failover (detect disconnect, elect new host by join timestamp)
|
|
- [ ] 5.5 Implement route computation trigger (host watches waypoint changes, debounce 500ms, call BRouter)
|
|
- [ ] 5.6 Implement route broadcast (host stores GeoJSON result in Y.Map, syncs to all)
|
|
- [ ] 5.7 Implement profile selection (sync profile choice via Y.Map, trigger recompute)
|
|
|
|
## 6. Planner — Map UI
|
|
|
|
- [ ] 6.1 Integrate MapView component in Planner with full-screen layout
|
|
- [ ] 6.2 Implement waypoint add (click map → add to Y.Array)
|
|
- [ ] 6.3 Implement waypoint drag (move marker → update Y.Array)
|
|
- [ ] 6.4 Implement waypoint delete (right-click → remove from Y.Array)
|
|
- [ ] 6.5 Implement waypoint list sidebar (draggable reorder, synced with Y.Array)
|
|
- [ ] 6.6 Implement route polyline display (render GeoJSON from Y.Map)
|
|
- [ ] 6.7 Implement elevation profile chart (parse elevation from route GeoJSON, render chart)
|
|
- [ ] 6.8 Implement profile selector UI (dropdown, synced via Y.Map)
|
|
- [ ] 6.9 Implement GPX export button (generate GPX from current waypoints and route)
|
|
|
|
## 7. Journal — Auth
|
|
|
|
- [ ] 7.1 Set up PostgreSQL schema (journal.users table with id, email, password_hash, username, bio, created_at)
|
|
- [ ] 7.2 Implement registration page and API (POST /api/auth/register)
|
|
- [ ] 7.3 Implement login page and API (POST /api/auth/login, session cookie)
|
|
- [ ] 7.4 Implement logout (POST /api/auth/logout, invalidate session)
|
|
- [ ] 7.5 Implement session middleware (validate cookie, load user in loader context)
|
|
- [ ] 7.6 Implement user profile page (GET /users/:username)
|
|
- [ ] 7.7 Store federated identity format (@user@domain) in user record
|
|
|
|
## 8. Journal — Route Management
|
|
|
|
- [ ] 8.1 Set up PostgreSQL schema (journal.routes table with PostGIS geometry column, journal.route_versions table)
|
|
- [ ] 8.2 Implement route creation page (form: name, description, optional GPX upload)
|
|
- [ ] 8.3 Implement route detail page (map, metadata, version history)
|
|
- [ ] 8.4 Implement route edit page (update name, description)
|
|
- [ ] 8.5 Implement route deletion (with confirmation dialog)
|
|
- [ ] 8.6 Implement GPX import (parse GPX, extract geometry for PostGIS, compute stats)
|
|
- [ ] 8.7 Implement GPX export (generate GPX from stored data, download)
|
|
- [ ] 8.8 Implement route versioning (create new version on each GPX update)
|
|
- [ ] 8.9 Implement route list page (user's routes, sorted by last updated)
|
|
- [ ] 8.10 Implement route metadata computation (distance, elevation gain/loss from GPX)
|
|
|
|
## 9. Planner-Journal Handoff
|
|
|
|
- [ ] 9.1 Implement JWT token generation in Journal (scoped to route_id, with expiry)
|
|
- [ ] 9.2 Implement "Edit in Planner" button on Journal route detail page (redirect with callback + token + GPX)
|
|
- [ ] 9.3 Implement callback URL handling in Planner (store callback URL in session metadata)
|
|
- [ ] 9.4 Implement "Save to Journal" button in Planner (POST GPX + JWT to callback URL)
|
|
- [ ] 9.5 Implement callback endpoint in Journal (POST /api/routes/:id/callback — validate JWT, save new version)
|
|
- [ ] 9.6 Implement "Return to Journal" link after successful save
|
|
|
|
## 10. Journal — Activity Feed
|
|
|
|
- [ ] 10.1 Set up PostgreSQL schema (journal.activities table with route_id FK, gpx, stats)
|
|
- [ ] 10.2 Implement activity creation page (GPX upload, description, optional route link)
|
|
- [ ] 10.3 Implement activity detail page (map with GPS trace, stats, description)
|
|
- [ ] 10.4 Implement activity feed page (chronological list of own activities)
|
|
- [ ] 10.5 Implement "Link to Route" action (select existing route to link)
|
|
- [ ] 10.6 Implement "Create Route from Activity" action (create route from activity GPX)
|
|
|
|
## 11. Testing & Polish
|
|
|
|
- [ ] 11.1 End-to-end test: Create route in Journal → Edit in Planner → Save back to Journal
|
|
- [ ] 11.2 End-to-end test: Two users collaboratively edit waypoints in Planner
|
|
- [ ] 11.3 End-to-end test: Import GPX → view route on map → export GPX
|
|
- [ ] 11.4 Test BRouter routing with Germany segments (Berlin → Munich route)
|
|
- [ ] 11.5 Test session expiry and manual close
|
|
- [ ] 11.6 Verify i18n works (English and German)
|
|
- [ ] 11.7 Basic responsive layout testing (desktop, tablet)
|
|
- [ ] 11.8 Deploy to Hetzner and verify production setup
|