# egor-abramov/avitowinter25 architecture

> Architecture diagram of the GitHub repository egor-abramov/avitowinter25, 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/egor-abramov/avitowinter25
- Repository: https://github.com/egor-abramov/avitowinter25

## Overview

AvitoWinter25 is a Go HTTP service for user authentication and virtual-coin commerce. The visible runtime workflow accepts login or authenticated requests, routes them through handlers and services, and uses PostgreSQL-backed repositories for account, coin, and merchandise operations. Coin transfers and merchandise purchases run through a transaction manager. The source also registers an information endpoint; its detailed composition is not established by the shown excerpts. The README gives no further capability detail, so relationships beyond the visible wiring and calls are omitted.

Main entry points: [`internal/app/app.go`](https://github.com/egor-abramov/avitowinter25/blob/main/internal/app/app.go) (Router and app), [`internal/service/merch/merch.go`](https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/merch/merch.go) (Merchandise), [`internal/repo/coin.go`](https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/coin.go) (Coin repository), [`internal/repo/user.go`](https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/user.go) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP runtime"]
  node_app["Router and app<br/>[app.go]"]
  node_auth_handler["Auth handler<br/>[auth.go]"]
  node_coin_handler["Coin handler<br/>[coin.go]"]
  node_merch_handler["Merch handler<br/>[merch.go]"]
  node_info_handler["Info handler<br/>[info.go]"]
  node_jwt["JWT middleware<br/>[jwt.go]"]
end

subgraph group_commerce["Domain services"]
  node_auth_service["Authentication<br/>[auth.go]"]
  node_coin_service["Coin transfers<br/>[coin.go]"]
  node_merch_service["Merchandise<br/>[merch.go]"]
  node_info_service["Account info<br/>[info.go]"]
end

subgraph group_storage["Persistence"]
  node_user_repo["User repository<br/>[user.go]"]
  node_coin_repo["Coin repository<br/>[coin.go]"]
  node_merch_repo["Merch repository<br/>[merch.go]"]
  node_database[("PostgreSQL")]
end

subgraph group_platform["Application setup"]
  node_config["Configuration<br/>[config.go]"]
  node_postgres_setup["Pool setup<br/>[setup.go]"]
  node_main["Process entry<br/>[main.go]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"routes auth"| node_auth_handler
node_app -->|"routes transfers"| node_coin_handler
node_app -->|"routes purchases"| node_merch_handler
node_app -->|"routes info"| node_info_handler
node_app -->|"protects routes"| node_jwt
node_auth_handler -->|"calls login"| node_auth_service
node_auth_service -->|"reads and creates users"| node_user_repo
node_app -->|"constructs"| node_auth_service
node_app -->|"constructs"| node_coin_service
node_app -->|"constructs"| node_merch_service
node_app -->|"constructs"| node_info_service
node_app -->|"constructs"| node_user_repo
node_app -->|"constructs"| node_coin_repo
node_app -->|"constructs"| node_merch_repo
node_coin_service -->|"reads and updates"| node_coin_repo
node_coin_service -->|"checks and reads users"| node_user_repo
node_merch_service -->|"reads and records merch"| node_merch_repo
node_merch_service -->|"deducts coins"| node_coin_repo
node_merch_service -->|"reads user"| node_user_repo
node_coin_repo -->|"queries"| node_database
node_main -->|"loads settings"| node_config
node_main -->|"starts and stops"| node_app
node_app -->|"opens pool"| node_postgres_setup
node_postgres_setup -->|"connects"| node_database

click node_app "https://github.com/egor-abramov/avitowinter25/blob/main/internal/app/app.go"
click node_auth_handler "https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/auth.go"
click node_coin_handler "https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/coin.go"
click node_merch_handler "https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/merch.go"
click node_info_handler "https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/info.go"
click node_jwt "https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/middleware/jwt.go"
click node_auth_service "https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/auth/auth.go"
click node_coin_service "https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/coin/coin.go"
click node_merch_service "https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/merch/merch.go"
click node_info_service "https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/info/info.go"
click node_user_repo "https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/user.go"
click node_coin_repo "https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/coin.go"
click node_merch_repo "https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/merch.go"
click node_config "https://github.com/egor-abramov/avitowinter25/blob/main/internal/config/config.go"
click node_postgres_setup "https://github.com/egor-abramov/avitowinter25/blob/main/internal/infrastructure/postgres/setup.go"
click node_main "https://github.com/egor-abramov/avitowinter25/blob/main/cmd/main.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_app,node_auth_handler,node_coin_handler,node_merch_handler,node_info_handler,node_jwt,node_client toneBlue
class node_auth_service,node_coin_service,node_merch_service,node_info_service toneAmber
class node_user_repo,node_coin_repo,node_merch_repo,node_database toneMint
class node_config,node_postgres_setup,node_main toneRose
```

## Components

### HTTP runtime

- [Router and app](https://github.com/egor-abramov/avitowinter25/blob/main/internal/app/app.go): `internal/app/app.go`
- [Auth handler](https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/auth.go): `internal/handler/auth.go`
- [Coin handler](https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/coin.go): `internal/handler/coin.go`
- [Merch handler](https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/merch.go): `internal/handler/merch.go`
- [Info handler](https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/info.go): `internal/handler/info.go`
- [JWT middleware](https://github.com/egor-abramov/avitowinter25/blob/main/internal/handler/middleware/jwt.go): `internal/handler/middleware/jwt.go`

### Domain services

- [Authentication](https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/auth/auth.go): `internal/service/auth/auth.go`
- [Coin transfers](https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/coin/coin.go): `internal/service/coin/coin.go`
- [Merchandise](https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/merch/merch.go): `internal/service/merch/merch.go`
- [Account info](https://github.com/egor-abramov/avitowinter25/blob/main/internal/service/info/info.go): `internal/service/info/info.go`

### Persistence

- [User repository](https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/user.go): `internal/repo/user.go`
- [Coin repository](https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/coin.go): `internal/repo/coin.go`
- [Merch repository](https://github.com/egor-abramov/avitowinter25/blob/main/internal/repo/merch.go): `internal/repo/merch.go`
- **PostgreSQL**

### Application setup

- [Configuration](https://github.com/egor-abramov/avitowinter25/blob/main/internal/config/config.go): `internal/config/config.go`
- [Pool setup](https://github.com/egor-abramov/avitowinter25/blob/main/internal/infrastructure/postgres/setup.go): `internal/infrastructure/postgres/setup.go`
- [Process entry](https://github.com/egor-abramov/avitowinter25/blob/main/cmd/main.go): `cmd/main.go`

### Other components

- **API client**

## Connections

- API client → Router and app: sends requests (evidence: `internal/app/app.go`)
- Router and app → Auth handler: routes auth (evidence: `internal/app/app.go`)
- Router and app → Coin handler: routes transfers (evidence: `internal/app/app.go`)
- Router and app → Merch handler: routes purchases (evidence: `internal/app/app.go`)
- Router and app → Info handler: routes info (evidence: `internal/app/app.go`)
- Router and app → JWT middleware: protects routes (evidence: `internal/app/app.go`)
- Auth handler → Authentication: calls login (evidence: `internal/handler/auth.go`)
- Authentication → User repository: reads and creates users (evidence: `internal/service/auth/auth.go`)
- Router and app → Authentication: constructs (evidence: `internal/app/app.go`)
- Router and app → Coin transfers: constructs (evidence: `internal/app/app.go`)
- Router and app → Merchandise: constructs (evidence: `internal/app/app.go`)
- Router and app → Account info: constructs (evidence: `internal/app/app.go`)
- Router and app → User repository: constructs (evidence: `internal/app/app.go`)
- Router and app → Coin repository: constructs (evidence: `internal/app/app.go`)
- Router and app → Merch repository: constructs (evidence: `internal/app/app.go`)
- Coin transfers → Coin repository: reads and updates (evidence: `internal/service/coin/coin.go`)
- Coin transfers → User repository: checks and reads users (evidence: `internal/service/coin/coin.go`)
- Merchandise → Merch repository: reads and records merch (evidence: `internal/service/merch/merch.go`)
- Merchandise → Coin repository: deducts coins (evidence: `internal/service/merch/merch.go`)
- Merchandise → User repository: reads user (evidence: `internal/service/merch/merch.go`)
- Coin repository → PostgreSQL: queries (evidence: `internal/repo/coin.go`)
- Process entry → Configuration: loads settings (evidence: `cmd/main.go`)
- Process entry → Router and app: starts and stops (evidence: `cmd/main.go`)
- Router and app → Pool setup: opens pool (evidence: `internal/app/app.go`)
- Pool setup → PostgreSQL: connects (evidence: `internal/infrastructure/postgres/setup.go`)
