How benomads/trailmate works
TrailMate combines a hiking-community backend with a browser-based admin console. The backend exposes account, trail, hike-history, group-hike, messaging, partner, product, preference, weather, and AI capabilities; the admin console provides protected management screens for several of those domains. The supplied tree has Flutter platform shells but no Dart application source, so its product behavior cannot be traced here. Backend and admin relationships are limited to those visible in excerpts or SOURCE INDEX references.
Main entry points: controller HTTP controllers · repository Data repositories · App.jsx Admin routing · pages Management screens
Components 18
Admin console
- Admin routing
trailmate-admin/src/App.jsx - Admin auth
trailmate-admin/src/context/AuthContext.jsx - Translations
trailmate-admin/src/context/LangContext.jsx - Language strings
trailmate-admin/src/i18n/translations.js - Management screens
trailmate-admin/src/pages - Admin widgets
trailmate-admin/src/components - API client
trailmate-admin/src/api.js
Backend API
- HTTP controllers
trailmate-backend/src/main/java/com/trailmate/controller
Hiking services
- Accounts and profiles
trailmate-backend/src/main/java/com/trailmate/service - Trails and history
trailmate-backend/src/main/java/com/trailmate/service - Group hikes
trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java - Community and partners
trailmate-backend/src/main/java/com/trailmate/service - Products and admin
trailmate-backend/src/main/java/com/trailmate/service/AdminService.java - AI and weather
trailmate-backend/src/main/java/com/trailmate/service
Persistence
- Domain entities
trailmate-backend/src/main/java/com/trailmate/entity - Data repositories
trailmate-backend/src/main/java/com/trailmate/repository - Relational database
Other components
- Admin
Connections 24
- Admin → Admin routing: uses
trailmate-admin/src/App.jsx - Admin routing → Admin auth: provides auth
trailmate-admin/src/App.jsx - Admin routing → Translations: provides language
trailmate-admin/src/App.jsx - Admin routing → Management screens: routes to
trailmate-admin/src/App.jsx - Translations → Language strings: looks up
trailmate-admin/src/context/LangContext.jsx - Management screens → Admin widgets: uses
trailmate-admin/src/pages/Partners.jsx - Management screens → API client: requests data
trailmate-admin/src/pages/Partners.jsx - API client → HTTP controllers: calls API
- HTTP controllers → Accounts and profiles: delegates
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - HTTP controllers → Trails and history: delegates
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - HTTP controllers → Group hikes: delegates
trailmate-backend/src/main/java/com/trailmate/controller/AdminController.java - HTTP controllers → Community and partners: delegates
trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java - HTTP controllers → Products and admin: delegates
trailmate-backend/src/main/java/com/trailmate/controller/AdminController.java - HTTP controllers → AI and weather: delegates
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - HTTP controllers → Accounts and profiles: updates profile
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - HTTP controllers → Trails and history: reads history
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - HTTP controllers → Community and partners: reads traveler data
trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java - Accounts and profiles → Data repositories: uses users
trailmate-backend/src/main/java/com/trailmate/service/UserService.java - Group hikes → Data repositories: uses hike stores
trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java - Products and admin → Data repositories: uses domain stores
trailmate-backend/src/main/java/com/trailmate/service/AdminService.java - Trails and history → Data repositories: reads history
trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java - Community and partners → Data repositories: reads traveler stats
trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java - Data repositories → Relational database: persists entities
- Data repositories → Domain entities: maps entities
trailmate-backend/src/main/java/com/trailmate/repository/HikingHistoryRepository.java