# zhantaibek/kfb architecture

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

- Interactive diagram: https://gitdiagram.com/zhantaibek/kfb
- Repository: https://github.com/zhantaibek/kfb

## Overview

Кыргызская фондовая биржа — публичный сайт Next.js с административной CMS на Express/PostgreSQL. Посетитель открывает разделы сайта, которые получают опубликованный контент и биржевые снимки через API; администратор входит, редактирует коллекции и загружает медиа. README описывает также периодическую синхронизацию торговых данных с kse.kg и сохранение последних успешных снимков. Основные потоки опираются на показанные маршруты и вызовы; связи к фронтенду и несэмплированным подсистемам, где нет прямого свидетельства, не добавлены.

Main entry points: [`backend/src/modules/cms/cms.routes.ts`](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.routes.ts) (CMS endpoints), [`backend/src/modules/kse-sync/sync.ts`](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/sync.ts) (Синхронизация рынка), [`backend/src/modules/auth/auth.service.ts`](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.service.ts) (Сессии и вход), [`frontend/src/lib/market-data.ts`](https://github.com/zhantaibek/kfb/blob/main/frontend/src/lib/market-data.ts) (Загрузка котировок)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Публичный сайт"]
  node_site["Страницы сайта"]
  node_proxy["API proxy<br/>[route.ts]"]
  node_adminui["Админка"]
  node_marketui["Рыночные страницы"]
  node_gcbui["Раздел ГЦБ"]
  node_membersui["Участники рынка"]
  node_marketdata["Загрузка котировок<br/>[market-data.ts]"]
end

subgraph group_api["API и доступ"]
  node_api["Express API<br/>[app.ts]"]
  node_routes["API маршруты<br/>[routes.ts]"]
  node_authroutes["Auth endpoints<br/>[auth.routes.ts]"]
  node_authctl["Auth controller<br/>[auth.controller.ts]"]
  node_auth["Сессии и вход<br/>[auth.service.ts]"]
  node_cmsroutes["CMS endpoints<br/>[cms.routes.ts]"]
  node_cmsctl["CMS controller<br/>[cms.controller.ts]"]
  node_searchroutes["Search endpoint<br/>[search.routes.ts]"]
  node_kseroutes["Market endpoint<br/>[kse-sync.routes.ts]"]
end

subgraph group_content["CMS и данные"]
  node_cms["CMS операции<br/>[cms.service.ts]"]
  node_repo["CMS repository<br/>[cms.repository.ts]"]
  node_prisma["PostgreSQL ORM<br/>[prisma.ts]"]
  node_pg[("PostgreSQL")]
  node_media["Загрузка медиа<br/>[media.service.ts]"]
  node_search["Полнотекстовый поиск<br/>[search.service.ts]"]
end

subgraph group_market["Биржевые данные"]
  node_sync["Синхронизация рынка<br/>[sync.ts]"]
  node_parse["Парсер kse.kg<br/>[parse.ts]"]
  node_exchange["kse.kg"]
  node_snapshots[("Снимки рынка")]
end

node_visitor(("Посетитель"))
node_edu["Учебный центр"]

node_visitor -->|"открывает"| node_site
node_site -.->|"вызывает API"| node_proxy
node_adminui -.->|"вызывает API"| node_proxy
node_proxy -.->|"пересылает запрос"| node_api
node_api -->|"монтирует"| node_routes
node_routes -->|"монтирует"| node_authroutes
node_authroutes -->|"маршрутизирует"| node_authctl
node_authctl -->|"вызывает"| node_auth
node_auth -->|"читает пользователя"| node_repo
node_auth -->|"читает учётки"| node_prisma
node_routes -->|"монтирует"| node_cmsroutes
node_cmsroutes -->|"маршрутизирует"| node_cmsctl
node_cmsctl -->|"проверяет сессию"| node_auth
node_cmsctl -->|"вызывает операции"| node_cms
node_cms -->|"читает и меняет"| node_repo
node_repo -->|"читает и пишет"| node_prisma
node_prisma -.->|"хранит данные"| node_pg
node_cms -->|"использует загрузку"| node_media
node_cmsroutes -->|"маршрутизирует"| node_searchroutes
node_searchroutes -->|"вызывает"| node_search
node_search -->|"собирает индекс"| node_prisma
node_cmsroutes -->|"маршрутизирует"| node_kseroutes
node_kseroutes -->|"получает снимок"| node_sync
node_sync -->|"разбирает данные"| node_parse
node_sync -->|"забирает данные"| node_exchange
node_sync -->|"сохраняет снимки"| node_snapshots
node_marketui -->|"показывает рынок"| node_marketdata
node_gcbui -->|"показывает рынок"| node_marketdata
node_membersui -->|"показывает рынок"| node_marketdata
node_marketdata -.->|"запрашивает снимки"| node_kseroutes
node_site -->|"перенаправляет"| node_edu

click node_site "https://github.com/zhantaibek/kfb/tree/main/frontend/src/app"
click node_proxy "https://github.com/zhantaibek/kfb/blob/main/frontend/src/app/api/%5B...path%5D/route.ts"
click node_adminui "https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/admin"
click node_api "https://github.com/zhantaibek/kfb/blob/main/backend/src/app.ts"
click node_routes "https://github.com/zhantaibek/kfb/blob/main/backend/src/routes.ts"
click node_authroutes "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.routes.ts"
click node_authctl "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.controller.ts"
click node_auth "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.service.ts"
click node_cmsroutes "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.routes.ts"
click node_cmsctl "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.controller.ts"
click node_cms "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.service.ts"
click node_repo "https://github.com/zhantaibek/kfb/blob/main/backend/src/db/repositories/cms.repository.ts"
click node_prisma "https://github.com/zhantaibek/kfb/blob/main/backend/src/db/prisma.ts"
click node_media "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/media/media.service.ts"
click node_searchroutes "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/search/search.routes.ts"
click node_search "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/search/search.service.ts"
click node_kseroutes "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/kse-sync.routes.ts"
click node_sync "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/sync.ts"
click node_parse "https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/parse.ts"
click node_marketui "https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/market"
click node_gcbui "https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/gcb"
click node_membersui "https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/members"
click node_marketdata "https://github.com/zhantaibek/kfb/blob/main/frontend/src/lib/market-data.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_site,node_proxy,node_adminui,node_marketui,node_gcbui,node_membersui,node_marketdata toneBlue
class node_api,node_routes,node_authroutes,node_authctl,node_auth,node_cmsroutes,node_cmsctl,node_searchroutes,node_kseroutes toneAmber
class node_cms,node_repo,node_prisma,node_pg,node_media,node_search toneMint
class node_sync,node_parse,node_exchange,node_snapshots toneRose
class node_visitor,node_edu toneIndigo
```

## Components

### Публичный сайт

- [Страницы сайта](https://github.com/zhantaibek/kfb/tree/main/frontend/src/app): `frontend/src/app`
- [API proxy](https://github.com/zhantaibek/kfb/blob/main/frontend/src/app/api/%5B...path%5D/route.ts): `frontend/src/app/api/[...path]/route.ts`
- [Админка](https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/admin): `frontend/src/app/admin`
- [Рыночные страницы](https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/market): `frontend/src/app/market`
- [Раздел ГЦБ](https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/gcb): `frontend/src/app/gcb`
- [Участники рынка](https://github.com/zhantaibek/kfb/tree/main/frontend/src/app/members): `frontend/src/app/members`
- [Загрузка котировок](https://github.com/zhantaibek/kfb/blob/main/frontend/src/lib/market-data.ts): `frontend/src/lib/market-data.ts`

### API и доступ

- [Express API](https://github.com/zhantaibek/kfb/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [API маршруты](https://github.com/zhantaibek/kfb/blob/main/backend/src/routes.ts): `backend/src/routes.ts`
- [Auth endpoints](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.routes.ts): `backend/src/modules/auth/auth.routes.ts`
- [Auth controller](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.controller.ts): `backend/src/modules/auth/auth.controller.ts`
- [Сессии и вход](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [CMS endpoints](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.routes.ts): `backend/src/modules/cms/cms.routes.ts`
- [CMS controller](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.controller.ts): `backend/src/modules/cms/cms.controller.ts`
- [Search endpoint](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/search/search.routes.ts): `backend/src/modules/search/search.routes.ts`
- [Market endpoint](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/kse-sync.routes.ts): `backend/src/modules/kse-sync/kse-sync.routes.ts`

### CMS и данные

- [CMS операции](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/cms/cms.service.ts): `backend/src/modules/cms/cms.service.ts`
- [CMS repository](https://github.com/zhantaibek/kfb/blob/main/backend/src/db/repositories/cms.repository.ts): `backend/src/db/repositories/cms.repository.ts`
- [PostgreSQL ORM](https://github.com/zhantaibek/kfb/blob/main/backend/src/db/prisma.ts): `backend/src/db/prisma.ts`
- **PostgreSQL**
- [Загрузка медиа](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/media/media.service.ts): `backend/src/modules/media/media.service.ts`
- [Полнотекстовый поиск](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/search/search.service.ts): `backend/src/modules/search/search.service.ts`

### Биржевые данные

- [Синхронизация рынка](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/sync.ts): `backend/src/modules/kse-sync/sync.ts`
- [Парсер kse.kg](https://github.com/zhantaibek/kfb/blob/main/backend/src/modules/kse-sync/parse.ts): `backend/src/modules/kse-sync/parse.ts`
- **kse.kg**
- **Снимки рынка**

### Other components

- **Посетитель**
- **Учебный центр**

## Connections

- Посетитель → Страницы сайта: открывает
- Страницы сайта → API proxy: вызывает API
- Админка → API proxy: вызывает API
- API proxy → Express API: пересылает запрос
- Express API → API маршруты: монтирует (evidence: `backend/src/app.ts`)
- API маршруты → Auth endpoints: монтирует (evidence: `backend/src/routes.ts`)
- Auth endpoints → Auth controller: маршрутизирует (evidence: `backend/src/modules/auth/auth.routes.ts`)
- Auth controller → Сессии и вход: вызывает (evidence: `backend/src/modules/auth/auth.controller.ts`)
- Сессии и вход → CMS repository: читает пользователя (evidence: `backend/src/modules/auth/auth.service.ts`)
- Сессии и вход → PostgreSQL ORM: читает учётки (evidence: `backend/src/modules/auth/auth.service.ts`)
- API маршруты → CMS endpoints: монтирует (evidence: `backend/src/routes.ts`)
- CMS endpoints → CMS controller: маршрутизирует (evidence: `backend/src/modules/cms/cms.routes.ts`)
- CMS controller → Сессии и вход: проверяет сессию (evidence: `backend/src/modules/cms/cms.controller.ts`)
- CMS controller → CMS операции: вызывает операции (evidence: `backend/src/modules/cms/cms.controller.ts`)
- CMS операции → CMS repository: читает и меняет (evidence: `backend/src/modules/cms/cms.service.ts`)
- CMS repository → PostgreSQL ORM: читает и пишет (evidence: `backend/src/db/repositories/cms.repository.ts`)
- PostgreSQL ORM → PostgreSQL: хранит данные
- CMS операции → Загрузка медиа: использует загрузку (evidence: `backend/src/modules/cms/cms.service.ts`)
- CMS endpoints → Search endpoint: маршрутизирует (evidence: `backend/src/modules/cms/cms.routes.ts`)
- Search endpoint → Полнотекстовый поиск: вызывает (evidence: `backend/src/modules/search/search.routes.ts`)
- Полнотекстовый поиск → PostgreSQL ORM: собирает индекс (evidence: `backend/src/modules/search/search.service.ts`)
- CMS endpoints → Market endpoint: маршрутизирует (evidence: `backend/src/modules/cms/cms.routes.ts`)
- Market endpoint → Синхронизация рынка: получает снимок (evidence: `backend/src/modules/kse-sync/kse-sync.routes.ts`)
- Синхронизация рынка → Парсер kse.kg: разбирает данные (evidence: `backend/src/modules/kse-sync/sync.ts`)
- Синхронизация рынка → kse.kg: забирает данные
- Синхронизация рынка → Снимки рынка: сохраняет снимки
- Рыночные страницы → Загрузка котировок: показывает рынок
- Раздел ГЦБ → Загрузка котировок: показывает рынок
- Участники рынка → Загрузка котировок: показывает рынок
- Загрузка котировок → Market endpoint: запрашивает снимки
- Страницы сайта → Учебный центр: перенаправляет
