# leoandreson77-lgtm/kradind architecture

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

- Interactive diagram: https://gitdiagram.com/leoandreson77-lgtm/kradind
- Repository: https://github.com/leoandreson77-lgtm/kradind

## Overview

KRADIND Adventures is a trekking discovery and booking platform, with a separate Express API service. The main customer journey is finding and comparing treks, reviewing itineraries and trail conditions, then requesting a departure booking; the README also describes a trek-matching wizard. The tree shows public pages and a substantial admin/CMS area. API route-to-data relationships below are evidenced in sampled source; links from the Next.js application to its APIs and from its pages to particular capabilities are not shown in the excerpts, so those relationships are omitted or marked unverified.

Main entry points: [`artifacts/api-server/src/routes/index.ts`](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/index.ts) (API Router), [`artifacts/api-server/src/lib/travel-data.ts`](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/lib/travel-data.ts) (Travel Data), [`artifacts/api-server/src/app.ts`](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/app.ts) (Express App), [`artifacts/kradind-adventures/src/components/booking-modal.tsx`](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/booking-modal.tsx) (Booking UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Trek Discovery"]
  node_trek_pages["Trek Pages<br/>[page.tsx]"]
  node_trek_catalog["Trek Catalog<br/>[treks-catalog.tsx]"]
  node_trip_matcher["Trip Matcher<br/>[page.tsx]"]
  node_trail_radar["Trail Radar<br/>[live-radar.tsx]"]
  node_itinerary["Itinerary View"]
end

subgraph group_booking["Booking Journey"]
  node_booking_ui["Booking UI<br/>[booking-modal.tsx]"]
  node_booking_page["Booking Endpoint<br/>[route.ts]"]
end

subgraph group_admin["Admin and Content"]
  node_admin_ui["Admin Console<br/>[page.tsx]"]
  node_admin_api["Admin APIs<br/>[route.ts]"]
  node_crm["CRM APIs<br/>[route.ts]"]
  node_content_admin["Content Management<br/>[route.ts]"]
end

subgraph group_service["API Service"]
  node_api_app["Express App<br/>[app.ts]"]
  node_api_router["API Router<br/>[index.ts]"]
  node_trek_routes["Trek Routes<br/>[treks.ts]"]
  node_radar_routes["Radar Route<br/>[radar.ts]"]
  node_booking_routes["Booking Route<br/>[bookings.ts]"]
  node_travel_data["Travel Data<br/>[travel-data.ts]"]
  node_logger["Request Logger<br/>[logger.ts]"]
end

node_traveler(("Traveler"))

node_traveler -.->|"browses"| node_trek_pages
node_traveler -.->|"discovers"| node_trek_catalog
node_traveler -.->|"matches trips"| node_trip_matcher
node_traveler -.->|"checks conditions"| node_trail_radar
node_traveler -.->|"reviews"| node_itinerary
node_traveler -.->|"requests booking"| node_booking_ui
node_booking_ui -.->|"submits booking"| node_booking_page
node_api_app -->|"mounts /api"| node_api_router
node_api_app -->|"configures logging"| node_logger
node_api_router -->|"registers"| node_trek_routes
node_api_router -->|"registers"| node_radar_routes
node_api_router -->|"registers"| node_booking_routes
node_trek_routes -->|"reads treks"| node_travel_data
node_radar_routes -->|"reads reports"| node_travel_data
node_booking_routes -->|"checks departures"| node_travel_data

click node_trek_pages "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/treks/%5Bslug%5D/page.tsx"
click node_trek_catalog "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/treks-catalog.tsx"
click node_trip_matcher "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/plan-your-trip/page.tsx"
click node_trail_radar "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/live-radar.tsx"
click node_itinerary "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/treks/%5Bslug%5D/trek-detail-client.tsx"
click node_booking_ui "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/booking-modal.tsx"
click node_booking_page "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/bookings/route.ts"
click node_admin_ui "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/admin/bookings/page.tsx"
click node_admin_api "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/bookings/route.ts"
click node_crm "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/crm/customers/route.ts"
click node_content_admin "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/treks/route.ts"
click node_api_app "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/app.ts"
click node_api_router "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/index.ts"
click node_trek_routes "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/treks.ts"
click node_radar_routes "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/radar.ts"
click node_booking_routes "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/bookings.ts"
click node_travel_data "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/lib/travel-data.ts"
click node_logger "https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/lib/logger.ts"

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_trek_pages,node_trek_catalog,node_trip_matcher,node_trail_radar,node_itinerary toneBlue
class node_booking_ui,node_booking_page toneAmber
class node_admin_ui,node_admin_api,node_crm,node_content_admin toneMint
class node_api_app,node_api_router,node_trek_routes,node_radar_routes,node_booking_routes,node_travel_data,node_logger toneRose
class node_traveler toneIndigo
```

## Components

### Trek Discovery

- [Trek Pages](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/treks/%5Bslug%5D/page.tsx): `artifacts/kradind-adventures/src/app/treks/[slug]/page.tsx`
- [Trek Catalog](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/treks-catalog.tsx): `artifacts/kradind-adventures/src/components/treks-catalog.tsx`
- [Trip Matcher](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/plan-your-trip/page.tsx): `artifacts/kradind-adventures/src/app/plan-your-trip/page.tsx`
- [Trail Radar](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/live-radar.tsx): `artifacts/kradind-adventures/src/components/live-radar.tsx`
- [Itinerary View](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/treks/%5Bslug%5D/trek-detail-client.tsx): `artifacts/kradind-adventures/src/app/treks/[slug]/trek-detail-client.tsx`

### Booking Journey

- [Booking UI](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/components/booking-modal.tsx): `artifacts/kradind-adventures/src/components/booking-modal.tsx`
- [Booking Endpoint](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/bookings/route.ts): `artifacts/kradind-adventures/src/app/api/bookings/route.ts`

### Admin and Content

- [Admin Console](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/admin/bookings/page.tsx): `artifacts/kradind-adventures/src/app/admin/bookings/page.tsx`
- [Admin APIs](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/bookings/route.ts): `artifacts/kradind-adventures/src/app/api/admin/bookings/route.ts`
- [CRM APIs](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/crm/customers/route.ts): `artifacts/kradind-adventures/src/app/api/admin/crm/customers/route.ts`
- [Content Management](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/kradind-adventures/src/app/api/admin/treks/route.ts): `artifacts/kradind-adventures/src/app/api/admin/treks/route.ts`

### API Service

- [Express App](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API Router](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Trek Routes](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/treks.ts): `artifacts/api-server/src/routes/treks.ts`
- [Radar Route](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/radar.ts): `artifacts/api-server/src/routes/radar.ts`
- [Booking Route](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/routes/bookings.ts): `artifacts/api-server/src/routes/bookings.ts`
- [Travel Data](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/lib/travel-data.ts): `artifacts/api-server/src/lib/travel-data.ts`
- [Request Logger](https://github.com/leoandreson77-lgtm/kradind/blob/main/artifacts/api-server/src/lib/logger.ts): `artifacts/api-server/src/lib/logger.ts`

### Other components

- **Traveler**

## Connections

- Traveler → Trek Pages: browses
- Traveler → Trek Catalog: discovers
- Traveler → Trip Matcher: matches trips
- Traveler → Trail Radar: checks conditions
- Traveler → Itinerary View: reviews
- Traveler → Booking UI: requests booking
- Booking UI → Booking Endpoint: submits booking
- Express App → API Router: mounts /api (evidence: `artifacts/api-server/src/app.ts`)
- Express App → Request Logger: configures logging (evidence: `artifacts/api-server/src/app.ts`)
- API Router → Trek Routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- API Router → Radar Route: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- API Router → Booking Route: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Trek Routes → Travel Data: reads treks (evidence: `artifacts/api-server/src/routes/treks.ts`)
- Radar Route → Travel Data: reads reports (evidence: `artifacts/api-server/src/routes/radar.ts`)
- Booking Route → Travel Data: checks departures (evidence: `artifacts/api-server/src/routes/bookings.ts`)
