# benomads/trailmate architecture

> Architecture diagram of the GitHub repository benomads/trailmate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/benomads/trailmate
- Repository: https://github.com/benomads/trailmate

## Overview

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: [`trailmate-backend/src/main/java/com/trailmate/controller`](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/controller) (HTTP controllers), [`trailmate-backend/src/main/java/com/trailmate/repository`](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/repository) (Data repositories), [`trailmate-admin/src/App.jsx`](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/App.jsx) (Admin routing), [`trailmate-admin/src/pages`](https://github.com/benomads/trailmate/tree/main/trailmate-admin/src/pages) (Management screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin console"]
  node_admin_app["Admin routing<br/>[App.jsx]"]
  node_admin_auth["Admin auth<br/>[AuthContext.jsx]"]
  node_admin_i18n["Translations<br/>[LangContext.jsx]"]
  node_admin_strings["Language strings<br/>[translations.js]"]
  node_admin_pages["Management screens"]
  node_admin_widgets["Admin widgets"]
  node_client["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_backend["HTTP controllers"]
end

subgraph group_domain["Hiking services"]
  node_identity["Accounts and profiles"]
  node_trail_history["Trails and history"]
  node_group_hikes["Group hikes"]
  node_community["Community and partners"]
  node_catalog["Products and admin<br/>[AdminService.java]"]
  node_extras["AI and weather"]
end

subgraph group_persistence["Persistence"]
  node_models["Domain entities"]
  node_repositories["Data repositories"]
  node_database[("Relational database")]
end

node_admin_user(("Admin"))

node_admin_user -->|"uses"| node_admin_app
node_admin_app -->|"provides auth"| node_admin_auth
node_admin_app -->|"provides language"| node_admin_i18n
node_admin_app -->|"routes to"| node_admin_pages
node_admin_i18n -->|"looks up"| node_admin_strings
node_admin_pages -.->|"uses"| node_admin_widgets
node_admin_pages -.->|"requests data"| node_client
node_client -.->|"calls API"| node_backend
node_backend -.->|"delegates"| node_identity
node_backend -.->|"delegates"| node_trail_history
node_backend -->|"delegates"| node_group_hikes
node_backend -->|"delegates"| node_community
node_backend -->|"delegates"| node_catalog
node_backend -.->|"delegates"| node_extras
node_backend -->|"updates profile"| node_identity
node_backend -->|"reads history"| node_trail_history
node_backend -->|"reads traveler data"| node_community
node_identity -->|"uses users"| node_repositories
node_group_hikes -->|"uses hike stores"| node_repositories
node_catalog -->|"uses domain stores"| node_repositories
node_trail_history -->|"reads history"| node_repositories
node_community -->|"reads traveler stats"| node_repositories
node_repositories -.->|"persists entities"| node_database
node_repositories -->|"maps entities"| node_models

click node_admin_app "https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/App.jsx"
click node_admin_auth "https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/context/AuthContext.jsx"
click node_admin_i18n "https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/context/LangContext.jsx"
click node_admin_strings "https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/i18n/translations.js"
click node_admin_pages "https://github.com/benomads/trailmate/tree/main/trailmate-admin/src/pages"
click node_admin_widgets "https://github.com/benomads/trailmate/tree/main/trailmate-admin/src/components"
click node_client "https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/api.js"
click node_backend "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/controller"
click node_identity "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service"
click node_trail_history "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service"
click node_group_hikes "https://github.com/benomads/trailmate/blob/main/trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java"
click node_community "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service"
click node_catalog "https://github.com/benomads/trailmate/blob/main/trailmate-backend/src/main/java/com/trailmate/service/AdminService.java"
click node_extras "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service"
click node_models "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/entity"
click node_repositories "https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/repository"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin_app,node_admin_auth,node_admin_i18n,node_admin_strings,node_admin_pages,node_admin_widgets,node_client toneBlue
class node_backend toneAmber
class node_identity,node_trail_history,node_group_hikes,node_community,node_catalog,node_extras toneMint
class node_models,node_repositories,node_database toneRose
class node_admin_user toneIndigo
```

## Components

### Admin console

- [Admin routing](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/App.jsx): `trailmate-admin/src/App.jsx`
- [Admin auth](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/context/AuthContext.jsx): `trailmate-admin/src/context/AuthContext.jsx`
- [Translations](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/context/LangContext.jsx): `trailmate-admin/src/context/LangContext.jsx`
- [Language strings](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/i18n/translations.js): `trailmate-admin/src/i18n/translations.js`
- [Management screens](https://github.com/benomads/trailmate/tree/main/trailmate-admin/src/pages): `trailmate-admin/src/pages`
- [Admin widgets](https://github.com/benomads/trailmate/tree/main/trailmate-admin/src/components): `trailmate-admin/src/components`
- [API client](https://github.com/benomads/trailmate/blob/main/trailmate-admin/src/api.js): `trailmate-admin/src/api.js`

### Backend API

- [HTTP controllers](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/controller): `trailmate-backend/src/main/java/com/trailmate/controller`

### Hiking services

- [Accounts and profiles](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service): `trailmate-backend/src/main/java/com/trailmate/service`
- [Trails and history](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service): `trailmate-backend/src/main/java/com/trailmate/service`
- [Group hikes](https://github.com/benomads/trailmate/blob/main/trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java): `trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java`
- [Community and partners](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service): `trailmate-backend/src/main/java/com/trailmate/service`
- [Products and admin](https://github.com/benomads/trailmate/blob/main/trailmate-backend/src/main/java/com/trailmate/service/AdminService.java): `trailmate-backend/src/main/java/com/trailmate/service/AdminService.java`
- [AI and weather](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/service): `trailmate-backend/src/main/java/com/trailmate/service`

### Persistence

- [Domain entities](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/entity): `trailmate-backend/src/main/java/com/trailmate/entity`
- [Data repositories](https://github.com/benomads/trailmate/tree/main/trailmate-backend/src/main/java/com/trailmate/repository): `trailmate-backend/src/main/java/com/trailmate/repository`
- **Relational database**

### Other components

- **Admin**

## Connections

- Admin → Admin routing: uses (evidence: `trailmate-admin/src/App.jsx`)
- Admin routing → Admin auth: provides auth (evidence: `trailmate-admin/src/App.jsx`)
- Admin routing → Translations: provides language (evidence: `trailmate-admin/src/App.jsx`)
- Admin routing → Management screens: routes to (evidence: `trailmate-admin/src/App.jsx`)
- Translations → Language strings: looks up (evidence: `trailmate-admin/src/context/LangContext.jsx`)
- Management screens → Admin widgets: uses (evidence: `trailmate-admin/src/pages/Partners.jsx`)
- Management screens → API client: requests data (evidence: `trailmate-admin/src/pages/Partners.jsx`)
- API client → HTTP controllers: calls API
- HTTP controllers → Accounts and profiles: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- HTTP controllers → Trails and history: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- HTTP controllers → Group hikes: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/AdminController.java`)
- HTTP controllers → Community and partners: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java`)
- HTTP controllers → Products and admin: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/AdminController.java`)
- HTTP controllers → AI and weather: delegates (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- HTTP controllers → Accounts and profiles: updates profile (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- HTTP controllers → Trails and history: reads history (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- HTTP controllers → Community and partners: reads traveler data (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java`)
- Accounts and profiles → Data repositories: uses users (evidence: `trailmate-backend/src/main/java/com/trailmate/service/UserService.java`)
- Group hikes → Data repositories: uses hike stores (evidence: `trailmate-backend/src/main/java/com/trailmate/service/GroupHikeService.java`)
- Products and admin → Data repositories: uses domain stores (evidence: `trailmate-backend/src/main/java/com/trailmate/service/AdminService.java`)
- Trails and history → Data repositories: reads history (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/ProfileController.java`)
- Community and partners → Data repositories: reads traveler stats (evidence: `trailmate-backend/src/main/java/com/trailmate/controller/PartnerController.java`)
- Data repositories → Relational database: persists entities
- Data repositories → Domain entities: maps entities (evidence: `trailmate-backend/src/main/java/com/trailmate/repository/HikingHistoryRepository.java`)
