# nurkenspashev92/bookit architecture

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

- Interactive diagram: https://gitdiagram.com/nurkenspashev92/bookit
- Repository: https://github.com/nurkenspashev92/bookit

## Overview

Bookit is a property-rental API: clients authenticate, discover and manage listings, and use booking, engagement, content, subscription, and analytics features. The API server initializes dependencies and registers versioned routes; those routes dispatch to domain handlers. The graph preserves documented route groups and the sampled server wiring, plus the required property, analytics, identity, and seed modules. Most service-to-repository behavior was not sampled, so those internal links are omitted. Seed relationships are limited to calls visible in its entry point.

Main entry points: [`app/cmd/router/router.go`](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/router/router.go) (Route registration), [`app/cmd/seed/main.go`](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/main.go) (Seed orchestration), [`app/cmd/apiserver/main.go`](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/apiserver/main.go) (API server), [`app/internal/property/repository/house.go`](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/repository/house.go) (House persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["API server<br/>[main.go]"]
  node_router["Route registration<br/>[router.go]"]
end

subgraph group_property["Property discovery"]
  node_properties["Property routes<br/>[routes.go]"]
  node_house_data[("House persistence<br/>[house.go]")]
  node_house_schema["House model<br/>[house.go]"]
  node_locations["Location routes<br/>[routes.go]"]
end

subgraph group_accounts["Accounts and engagement"]
  node_auth["Authentication routes<br/>[routes.go]"]
  node_token_guard["Token guard<br/>[auth.go]"]
  node_interactions["Likes routes<br/>[routes.go]"]
end

subgraph group_services["Platform services"]
  node_bookings["Booking routes<br/>[routes.go]"]
  node_content["Content routes<br/>[routes.go]"]
  node_subscriptions["Subscription routes<br/>[routes.go]"]
  node_analytics["Analytics routes<br/>[routes.go]"]
  node_stats_data[("Analytics storage<br/>[stats.go]")]
end

subgraph group_seeding["Data seeding"]
  node_seed["Seed orchestration<br/>[main.go]"]
  node_seed_faq["FAQ seed data<br/>[faq.go]"]
  node_seed_houses["House seed data<br/>[houses.go]"]
end

node_clients(("API clients"))
node_database[("PostgreSQL")]
node_object_store[("S3 storage")]

node_clients -.->|"sends requests"| node_server
node_server -->|"registers routes"| node_router
node_router -->|"registers routes"| node_auth
node_router -->|"registers routes"| node_properties
node_router -->|"registers routes"| node_locations
node_router -->|"registers routes"| node_bookings
node_router -->|"registers routes"| node_interactions
node_router -->|"registers routes"| node_content
node_router -->|"registers routes"| node_subscriptions
node_router -->|"registers routes"| node_analytics
node_router -->|"configures guards"| node_token_guard
node_token_guard -.->|"validates tokens"| node_auth
node_house_data -.->|"persists houses"| node_database
node_stats_data -.->|"queries statistics"| node_database
node_seed -->|"seeds FAQs"| node_seed_faq
node_seed -->|"builds house rows"| node_seed_houses
node_seed -->|"writes seed data"| node_database
node_seed -->|"uploads images"| node_object_store
node_house_schema -.->|"models persisted houses"| node_house_data

click node_server "https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/apiserver/main.go"
click node_router "https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/router/router.go"
click node_auth "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/identity/handler/routes.go"
click node_token_guard "https://github.com/nurkenspashev92/bookit/blob/main/app/pkg/middleware/auth.go"
click node_properties "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/handler/routes.go"
click node_house_data "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/repository/house.go"
click node_house_schema "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/schema/house.go"
click node_locations "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/location/handler/routes.go"
click node_bookings "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/booking/handler/routes.go"
click node_interactions "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/interaction/handler/routes.go"
click node_content "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/content/handler/routes.go"
click node_subscriptions "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/subscription/handler/routes.go"
click node_analytics "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/analytics/handler/routes.go"
click node_stats_data "https://github.com/nurkenspashev92/bookit/blob/main/app/internal/analytics/repository/stats.go"
click node_seed "https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/main.go"
click node_seed_faq "https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/faq.go"
click node_seed_houses "https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/houses.go"

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_server,node_router,node_clients toneBlue
class node_properties,node_house_data,node_house_schema,node_locations,node_database,node_object_store toneAmber
class node_auth,node_token_guard,node_interactions toneMint
class node_bookings,node_content,node_subscriptions,node_analytics,node_stats_data toneRose
class node_seed,node_seed_faq,node_seed_houses toneIndigo
```

## Components

### API runtime

- [API server](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/apiserver/main.go): `app/cmd/apiserver/main.go`
- [Route registration](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/router/router.go): `app/cmd/router/router.go`

### Property discovery

- [Property routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/handler/routes.go): `app/internal/property/handler/routes.go`
- [House persistence](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/repository/house.go): `app/internal/property/repository/house.go`
- [House model](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/property/schema/house.go): `app/internal/property/schema/house.go`
- [Location routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/location/handler/routes.go): `app/internal/location/handler/routes.go`

### Accounts and engagement

- [Authentication routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/identity/handler/routes.go): `app/internal/identity/handler/routes.go`
- [Token guard](https://github.com/nurkenspashev92/bookit/blob/main/app/pkg/middleware/auth.go): `app/pkg/middleware/auth.go`
- [Likes routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/interaction/handler/routes.go): `app/internal/interaction/handler/routes.go`

### Platform services

- [Booking routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/booking/handler/routes.go): `app/internal/booking/handler/routes.go`
- [Content routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/content/handler/routes.go): `app/internal/content/handler/routes.go`
- [Subscription routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/subscription/handler/routes.go): `app/internal/subscription/handler/routes.go`
- [Analytics routes](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/analytics/handler/routes.go): `app/internal/analytics/handler/routes.go`
- [Analytics storage](https://github.com/nurkenspashev92/bookit/blob/main/app/internal/analytics/repository/stats.go): `app/internal/analytics/repository/stats.go`

### Data seeding

- [Seed orchestration](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/main.go): `app/cmd/seed/main.go`
- [FAQ seed data](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/faq.go): `app/cmd/seed/faq.go`
- [House seed data](https://github.com/nurkenspashev92/bookit/blob/main/app/cmd/seed/houses.go): `app/cmd/seed/houses.go`

### Other components

- **API clients**
- **PostgreSQL**
- **S3 storage**

## Connections

- API clients → API server: sends requests
- API server → Route registration: registers routes (evidence: `app/cmd/apiserver/main.go`)
- Route registration → Authentication routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Property routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Location routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Booking routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Likes routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Content routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Subscription routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Analytics routes: registers routes (evidence: `app/cmd/router/router.go`)
- Route registration → Token guard: configures guards (evidence: `app/cmd/router/router.go`)
- Token guard → Authentication routes: validates tokens
- House persistence → PostgreSQL: persists houses
- Analytics storage → PostgreSQL: queries statistics
- Seed orchestration → FAQ seed data: seeds FAQs (evidence: `app/cmd/seed/main.go`)
- Seed orchestration → House seed data: builds house rows (evidence: `app/cmd/seed/main.go`)
- Seed orchestration → PostgreSQL: writes seed data (evidence: `app/cmd/seed/main.go`)
- Seed orchestration → S3 storage: uploads images (evidence: `app/cmd/seed/main.go`)
- House model → House persistence: models persisted houses
