# deadcool23/autotracker architecture

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

- Interactive diagram: https://gitdiagram.com/deadcool23/autotracker
- Repository: https://github.com/deadcool23/autotracker

## Overview

AutoTracker tracks vehicle movements recorded by road cameras. Users authenticate and view routes for their own cars; operators search cars and passage records, while auditors can inspect tracking searches. The map shows the mobile client, API, business logic, and persistence as the principal path, plus account and camera capabilities documented or exposed by the repository. Backend relationships are limited to those visible in the source index or README; unsampled internals are not assumed to call one another.

Main entry points: [`backend/api/src/api/src/paths.rs`](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/paths.rs) (Route definitions), [`backend/api/src/data_access/src/repositories`](https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories) (Data repositories), [`frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift`](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift) (Search requests), [`frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift`](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift) (Sign in / register)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile client"]
  node_mobile_auth["Sign in / register"]
  node_auth_api["Auth requests"]
  node_main_views["Role dashboards"]
  node_search_manager["Search requests"]
  node_results["Search results"]
  node_route_view["Route view"]
  node_route_api["Route requests"]
  node_mobile_models["Domain models<br/>[Car.swift]"]
end

subgraph group_api["HTTP API"]
  node_api_server["Axum API server<br/>[main.rs]"]
  node_api_routes["Route definitions<br/>[paths.rs]"]
  node_auth_handlers["Auth handlers<br/>[auth_service.rs]"]
  node_search_handlers["Search handlers"]
  node_route_handler["Route handler"]
  node_camera_handlers["Camera handlers"]
end

subgraph group_logic["Business logic"]
  node_business_auth["Authentication service<br/>[auth_service.rs]"]
  node_business_search["Search service<br/>[search_service.rs]"]
  node_business_route["Route service<br/>[route_service.rs]"]
  node_business_camera["Camera data service"]
  node_repo_traits["Repository contracts<br/>[services_traits.rs]"]
end

subgraph group_data["Data access"]
  node_repositories["Data repositories"]
  node_postgres[("PostgreSQL")]
  node_clickhouse[("ClickHouse")]
  node_redis[("Redis")]
end

node_user(("User"))
node_auditor(("Auditor"))
node_camera_source(("Road cameras"))

node_user -->|"uses"| node_mobile_auth
node_mobile_auth -->|"requests auth"| node_auth_api
node_auth_api -.->|"sends credentials"| node_auth_handlers
node_mobile_auth -->|"opens dashboard"| node_main_views
node_main_views -->|"submits searches"| node_search_manager
node_search_manager -.->|"sends search"| node_search_handlers
node_search_handlers -.->|"delegates"| node_business_search
node_business_search -->|"uses contracts"| node_repo_traits
node_repo_traits -.->|"implemented by"| node_repositories
node_repositories -.->|"queries"| node_postgres
node_repositories -.->|"queries"| node_clickhouse
node_repositories -.->|"uses cache"| node_redis
node_search_manager -->|"returns results"| node_results
node_auditor -->|"reviews searches"| node_main_views
node_results -->|"opens route"| node_route_view
node_route_view -->|"requests route"| node_route_api
node_route_api -.->|"sends route query"| node_route_handler
node_route_handler -.->|"delegates"| node_business_route
node_business_route -.->|"uses contracts"| node_repo_traits
node_camera_source -.->|"provides captures"| node_camera_handlers
node_camera_handlers -.->|"delegates"| node_business_camera
node_auth_handlers -.->|"delegates"| node_business_auth
node_api_server -->|"configures paths"| node_api_routes
node_api_routes -.->|"defines endpoints"| node_auth_handlers
node_api_routes -.->|"defines endpoints"| node_search_handlers
node_api_routes -.->|"defines endpoint"| node_route_handler
node_mobile_models -->|"shapes search data"| node_search_manager

click node_mobile_auth "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift"
click node_auth_api "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/AuthAPIManager.swift"
click node_main_views "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Main/EmployeeMainViewController.swift"
click node_search_manager "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift"
click node_results "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Info/FindedViewController.swift"
click node_route_view "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Info/RouteViewController.swift"
click node_route_api "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/RouteGetAPIManager.swift"
click node_mobile_models "https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Models/Car.swift"
click node_api_server "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/main.rs"
click node_api_routes "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/paths.rs"
click node_auth_handlers "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/auth_services/auth_service.rs"
click node_search_handlers "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/search_services/car_search_service.rs"
click node_route_handler "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/route_get_service.rs"
click node_camera_handlers "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v1/camera_service/camera_get_by_id_service.rs"
click node_business_auth "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/auth_service.rs"
click node_business_search "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/search_service.rs"
click node_business_route "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/route_service.rs"
click node_business_camera "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/camera_data_get_service.rs"
click node_repo_traits "https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services_traits.rs"
click node_repositories "https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories"
click node_postgres "https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/postgres"
click node_clickhouse "https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/clickhouse"
click node_redis "https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/redis"

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_mobile_auth,node_auth_api,node_main_views,node_search_manager,node_results,node_route_view,node_route_api,node_mobile_models,node_user toneBlue
class node_api_server,node_api_routes,node_auth_handlers,node_search_handlers,node_route_handler,node_camera_handlers toneAmber
class node_business_auth,node_business_search,node_business_route,node_business_camera,node_repo_traits toneMint
class node_repositories,node_postgres,node_clickhouse,node_redis toneRose
class node_auditor,node_camera_source toneIndigo
```

## Components

### Mobile client

- [Sign in / register](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift): `frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift`
- [Auth requests](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/AuthAPIManager.swift): `frontend/mobile/AutoTracker/Managers/APIManagers/AuthAPIManager.swift`
- [Role dashboards](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Main/EmployeeMainViewController.swift): `frontend/mobile/AutoTracker/Controllers/Main/EmployeeMainViewController.swift`
- [Search requests](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift): `frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift`
- [Search results](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Info/FindedViewController.swift): `frontend/mobile/AutoTracker/Controllers/Info/FindedViewController.swift`
- [Route view](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Controllers/Info/RouteViewController.swift): `frontend/mobile/AutoTracker/Controllers/Info/RouteViewController.swift`
- [Route requests](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Managers/APIManagers/RouteGetAPIManager.swift): `frontend/mobile/AutoTracker/Managers/APIManagers/RouteGetAPIManager.swift`
- [Domain models](https://github.com/deadcool23/autotracker/blob/main/frontend/mobile/AutoTracker/Models/Car.swift): `frontend/mobile/AutoTracker/Models/Car.swift`

### HTTP API

- [Axum API server](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/main.rs): `backend/api/src/api/src/main.rs`
- [Route definitions](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/paths.rs): `backend/api/src/api/src/paths.rs`
- [Auth handlers](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/auth_services/auth_service.rs): `backend/api/src/api/src/handlers/v2/auth_services/auth_service.rs`
- [Search handlers](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/search_services/car_search_service.rs): `backend/api/src/api/src/handlers/v2/search_services/car_search_service.rs`
- [Route handler](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v2/route_get_service.rs): `backend/api/src/api/src/handlers/v2/route_get_service.rs`
- [Camera handlers](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/api/src/handlers/v1/camera_service/camera_get_by_id_service.rs): `backend/api/src/api/src/handlers/v1/camera_service/camera_get_by_id_service.rs`

### Business logic

- [Authentication service](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/auth_service.rs): `backend/api/src/business_logic/src/services/auth_service.rs`
- [Search service](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/search_service.rs): `backend/api/src/business_logic/src/services/search_service.rs`
- [Route service](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/route_service.rs): `backend/api/src/business_logic/src/services/route_service.rs`
- [Camera data service](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services/camera_data_get_service.rs): `backend/api/src/business_logic/src/services/camera_data_get_service.rs`
- [Repository contracts](https://github.com/deadcool23/autotracker/blob/main/backend/api/src/business_logic/src/services_traits.rs): `backend/api/src/business_logic/src/services_traits.rs`

### Data access

- [Data repositories](https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories): `backend/api/src/data_access/src/repositories`
- [PostgreSQL](https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/postgres): `backend/api/src/data_access/src/repositories/postgres`
- [ClickHouse](https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/clickhouse): `backend/api/src/data_access/src/repositories/clickhouse`
- [Redis](https://github.com/deadcool23/autotracker/tree/main/backend/api/src/data_access/src/repositories/redis): `backend/api/src/data_access/src/repositories/redis`

### Other components

- **User**
- **Auditor**
- **Road cameras**

## Connections

- User → Sign in / register: uses
- Sign in / register → Auth requests: requests auth (evidence: `frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift`)
- Auth requests → Auth handlers: sends credentials
- Sign in / register → Role dashboards: opens dashboard (evidence: `frontend/mobile/AutoTracker/Controllers/Auth/AuthViewController.swift`)
- Role dashboards → Search requests: submits searches (evidence: `frontend/mobile/AutoTracker/Controllers/Main/EmployeeMainViewController.swift`)
- Search requests → Search handlers: sends search
- Search handlers → Search service: delegates
- Search service → Repository contracts: uses contracts (evidence: `backend/api/src/business_logic/src/services/search_service.rs`)
- Repository contracts → Data repositories: implemented by
- Data repositories → PostgreSQL: queries
- Data repositories → ClickHouse: queries
- Data repositories → Redis: uses cache
- Search requests → Search results: returns results (evidence: `frontend/mobile/AutoTracker/Controllers/Main/EmployeeMainViewController.swift`)
- Auditor → Role dashboards: reviews searches
- Search results → Route view: opens route (evidence: `frontend/mobile/AutoTracker/Controllers/Info/FindedViewController.swift`)
- Route view → Route requests: requests route (evidence: `frontend/mobile/AutoTracker/Controllers/Info/RouteViewController.swift`)
- Route requests → Route handler: sends route query
- Route handler → Route service: delegates
- Route service → Repository contracts: uses contracts
- Road cameras → Camera handlers: provides captures
- Camera handlers → Camera data service: delegates
- Auth handlers → Authentication service: delegates
- Axum API server → Route definitions: configures paths (evidence: `backend/api/src/api/src/main.rs`)
- Route definitions → Auth handlers: defines endpoints (evidence: `backend/api/src/api/src/handlers/v2/auth_services/auth_service.rs`)
- Route definitions → Search handlers: defines endpoints (evidence: `backend/api/src/api/src/handlers/v2/search_services/car_search_service.rs`)
- Route definitions → Route handler: defines endpoint
- Domain models → Search requests: shapes search data (evidence: `frontend/mobile/AutoTracker/Managers/APIManagers/SearchAPIManager.swift`)
