How zhantaibek/kfb works
Кыргызская фондовая биржа — публичный сайт Next.js с административной CMS на Express/PostgreSQL. Посетитель открывает разделы сайта, которые получают опубликованный контент и биржевые снимки через API; администратор входит, редактирует коллекции и загружает медиа. README описывает также периодическую синхронизацию торговых данных с kse.kg и сохранение последних успешных снимков. Основные потоки опираются на показанные маршруты и вызовы; связи к фронтенду и несэмплированным подсистемам, где нет прямого свидетельства, не добавлены.
Main entry points: cms.routes.ts CMS endpoints · sync.ts Синхронизация рынка · auth.service.ts Сессии и вход · market-data.ts Загрузка котировок
Components 28
Публичный сайт
- Страницы сайта
frontend/src/app - API proxy
frontend/src/app/api/[...path]/route.ts - Админка
frontend/src/app/admin - Рыночные страницы
frontend/src/app/market - Раздел ГЦБ
frontend/src/app/gcb - Участники рынка
frontend/src/app/members - Загрузка котировок
frontend/src/lib/market-data.ts
API и доступ
- Express API
backend/src/app.ts - API маршруты
backend/src/routes.ts - Auth endpoints
backend/src/modules/auth/auth.routes.ts - Auth controller
backend/src/modules/auth/auth.controller.ts - Сессии и вход
backend/src/modules/auth/auth.service.ts - CMS endpoints
backend/src/modules/cms/cms.routes.ts - CMS controller
backend/src/modules/cms/cms.controller.ts - Search endpoint
backend/src/modules/search/search.routes.ts - Market endpoint
backend/src/modules/kse-sync/kse-sync.routes.ts
CMS и данные
- CMS операции
backend/src/modules/cms/cms.service.ts - CMS repository
backend/src/db/repositories/cms.repository.ts - PostgreSQL ORM
backend/src/db/prisma.ts - PostgreSQL
- Загрузка медиа
backend/src/modules/media/media.service.ts - Полнотекстовый поиск
backend/src/modules/search/search.service.ts
Биржевые данные
- Синхронизация рынка
backend/src/modules/kse-sync/sync.ts - Парсер kse.kg
backend/src/modules/kse-sync/parse.ts - kse.kg
- Снимки рынка
Other components
- Посетитель
- Учебный центр
Connections 31
- Посетитель → Страницы сайта: открывает
- Страницы сайта → API proxy: вызывает API
- Админка → API proxy: вызывает API
- API proxy → Express API: пересылает запрос
- Express API → API маршруты: монтирует
backend/src/app.ts - API маршруты → Auth endpoints: монтирует
backend/src/routes.ts - Auth endpoints → Auth controller: маршрутизирует
backend/src/modules/auth/auth.routes.ts - Auth controller → Сессии и вход: вызывает
backend/src/modules/auth/auth.controller.ts - Сессии и вход → CMS repository: читает пользователя
backend/src/modules/auth/auth.service.ts - Сессии и вход → PostgreSQL ORM: читает учётки
backend/src/modules/auth/auth.service.ts - API маршруты → CMS endpoints: монтирует
backend/src/routes.ts - CMS endpoints → CMS controller: маршрутизирует
backend/src/modules/cms/cms.routes.ts - CMS controller → Сессии и вход: проверяет сессию
backend/src/modules/cms/cms.controller.ts - CMS controller → CMS операции: вызывает операции
backend/src/modules/cms/cms.controller.ts - CMS операции → CMS repository: читает и меняет
backend/src/modules/cms/cms.service.ts - CMS repository → PostgreSQL ORM: читает и пишет
backend/src/db/repositories/cms.repository.ts - PostgreSQL ORM → PostgreSQL: хранит данные
- CMS операции → Загрузка медиа: использует загрузку
backend/src/modules/cms/cms.service.ts - CMS endpoints → Search endpoint: маршрутизирует
backend/src/modules/cms/cms.routes.ts - Search endpoint → Полнотекстовый поиск: вызывает
backend/src/modules/search/search.routes.ts - Полнотекстовый поиск → PostgreSQL ORM: собирает индекс
backend/src/modules/search/search.service.ts - CMS endpoints → Market endpoint: маршрутизирует
backend/src/modules/cms/cms.routes.ts - Market endpoint → Синхронизация рынка: получает снимок
backend/src/modules/kse-sync/kse-sync.routes.ts - Синхронизация рынка → Парсер kse.kg: разбирает данные
backend/src/modules/kse-sync/sync.ts - Синхронизация рынка → kse.kg: забирает данные
- Синхронизация рынка → Снимки рынка: сохраняет снимки
- Рыночные страницы → Загрузка котировок: показывает рынок
- Раздел ГЦБ → Загрузка котировок: показывает рынок
- Участники рынка → Загрузка котировок: показывает рынок
- Загрузка котировок → Market endpoint: запрашивает снимки
- Страницы сайта → Учебный центр: перенаправляет