# vladglass0/pervye-lenrayon-main architecture

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

- Interactive diagram: https://gitdiagram.com/vladglass0/pervye-lenrayon-main
- Repository: https://github.com/vladglass0/pervye-lenrayon-main

## Overview

Портал объединяет публичный каталог и административное управление контентом с Express API, PostgreSQL/Prisma и отдельным VK worker. Основной путь: посетитель открывает каталог или карточку → веб-клиент запрашивает опубликованные данные у API → API обслуживает запросы через БД. Редакторы и модераторы входят в админку, редактируют материалы либо обрабатывают VK-источники; worker синхронизирует публикации и фото участников. Граф сохраняет документированные направления и связи, явно видимые в индексированных или excerpt-файлах; прочие внутренние маршруты API не реконструируются.

Main entry points: [`apps/web/src/api.ts`](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/api.ts) (API-клиент сессий), [`apps/web/src/admin/AdminRoutes.tsx`](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/AdminRoutes.tsx) (Админ-маршруты), [`apps/web/src/App.tsx`](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/App.tsx) (Маршрутизация сайта), [`apps/worker/src/sync.ts`](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/sync.ts) (Импорт VK-постов)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Публичный портал"]
  node_portal["Маршрутизация сайта<br/>[App.tsx]"]
  node_home["Главная<br/>[HomePage.tsx]"]
  node_catalog["Каталоги<br/>[CatalogPage.tsx]"]
  node_detail["Карточки материалов<br/>[DetailPage.tsx]"]
  node_contentplan["План публикаций"]
end

subgraph group_admin["Редакторская админка"]
  node_adminroutes["Админ-маршруты<br/>[AdminRoutes.tsx]"]
  node_adminauth["Вход и роли<br/>[Auth.tsx]"]
  node_contentmanager["Управление контентом<br/>[ContentManager.tsx]"]
  node_moderation["Очередь модерации<br/>[Moderation.tsx]"]
  node_vksources["VK-источники<br/>[VkSources.tsx]"]
  node_users["Управление пользователями<br/>[Users.tsx]"]
  node_search["Поиск админки<br/>[Search.tsx]"]
end

subgraph group_backend["API и данные"]
  node_clientapi["API-клиент сессий<br/>[api.ts]"]
  node_api["HTTP API<br/>[app.ts]"]
  node_authlogic["Токены и пароли<br/>[auth.ts]"]
  node_database[("PostgreSQL / Prisma<br/>[index.ts]")]
end

subgraph group_vk["VK синхронизация"]
  node_workerentry["Планировщик worker<br/>[index.ts]"]
  node_sync["Импорт VK-постов<br/>[sync.ts]"]
  node_normalize["Нормализация постов<br/>[normalize.ts]"]
  node_vkclient["VK API-клиент<br/>[vk.ts]"]
  node_teamphotos["Фото участников<br/>[team-photos.ts]"]
end

node_visitor(("Посетитель"))
node_adminuser(("Редактор / модератор"))
node_vkservice["VK API"]

node_visitor -->|"открывает"| node_portal
node_portal -->|"маршрутизирует"| node_home
node_portal -->|"маршрутизирует"| node_catalog
node_portal -->|"маршрутизирует"| node_contentplan
node_adminuser -->|"открывает"| node_adminroutes
node_adminroutes -->|"защищает разделы"| node_adminauth
node_adminroutes -->|"показывает разделы"| node_contentmanager
node_adminroutes -->|"показывает разделы"| node_moderation
node_adminroutes -->|"показывает разделы"| node_vksources
node_adminroutes -->|"показывает разделы"| node_users
node_adminroutes -->|"встраивает поиск"| node_search
node_adminauth -->|"входит и обновляет сессию"| node_clientapi
node_contentmanager -->|"запрашивает и изменяет"| node_clientapi
node_moderation -->|"запрашивает API"| node_clientapi
node_vksources -->|"запрашивает API"| node_clientapi
node_users -->|"запрашивает API"| node_clientapi
node_search -->|"ищет через API"| node_clientapi
node_home -->|"запрашивает данные"| node_clientapi
node_catalog -->|"запрашивает данные"| node_clientapi
node_detail -->|"запрашивает данные"| node_clientapi
node_clientapi -->|"HTTP-запросы"| node_api
node_api -->|"проверяет токены"| node_authlogic
node_api -->|"читает и записывает"| node_database
node_workerentry -->|"запускает синхронизацию"| node_sync
node_workerentry -->|"запускает сбор фото"| node_teamphotos
node_sync -->|"нормализует посты"| node_normalize
node_sync -->|"получает записи"| node_vkclient
node_sync -->|"сохраняет посты"| node_database
node_vkclient -.->|"читает wall API"| node_vkservice
node_teamphotos -.->|"получает фото профилей"| node_vkservice
node_workerentry -->|"обновляет heartbeat и очередь"| node_database

click node_portal "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/App.tsx"
click node_home "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/HomePage.tsx"
click node_catalog "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/CatalogPage.tsx"
click node_detail "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/DetailPage.tsx"
click node_contentplan "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/ContentPlanPage.tsx"
click node_adminroutes "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/AdminRoutes.tsx"
click node_adminauth "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Auth.tsx"
click node_contentmanager "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/ContentManager.tsx"
click node_moderation "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Moderation.tsx"
click node_vksources "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/VkSources.tsx"
click node_users "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Users.tsx"
click node_search "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Search.tsx"
click node_clientapi "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/api.ts"
click node_api "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/api/src/app.ts"
click node_authlogic "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/api/src/auth.ts"
click node_database "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/packages/db/src/index.ts"
click node_workerentry "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/index.ts"
click node_sync "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/sync.ts"
click node_normalize "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/normalize.ts"
click node_vkclient "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/vk.ts"
click node_teamphotos "https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/team-photos.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_portal,node_home,node_catalog,node_detail,node_contentplan toneBlue
class node_adminroutes,node_adminauth,node_contentmanager,node_moderation,node_vksources,node_users,node_search toneAmber
class node_clientapi,node_api,node_authlogic,node_database,node_vkservice toneMint
class node_workerentry,node_sync,node_normalize,node_vkclient,node_teamphotos toneRose
class node_visitor,node_adminuser toneIndigo
```

## Components

### Публичный портал

- [Маршрутизация сайта](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Главная](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/HomePage.tsx): `apps/web/src/HomePage.tsx`
- [Каталоги](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/CatalogPage.tsx): `apps/web/src/pages/CatalogPage.tsx`
- [Карточки материалов](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/DetailPage.tsx): `apps/web/src/pages/DetailPage.tsx`
- [План публикаций](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/pages/ContentPlanPage.tsx): `apps/web/src/pages/ContentPlanPage.tsx`

### Редакторская админка

- [Админ-маршруты](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/AdminRoutes.tsx): `apps/web/src/admin/AdminRoutes.tsx`
- [Вход и роли](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Auth.tsx): `apps/web/src/admin/Auth.tsx`
- [Управление контентом](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/ContentManager.tsx): `apps/web/src/admin/ContentManager.tsx`
- [Очередь модерации](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Moderation.tsx): `apps/web/src/admin/Moderation.tsx`
- [VK-источники](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/VkSources.tsx): `apps/web/src/admin/VkSources.tsx`
- [Управление пользователями](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Users.tsx): `apps/web/src/admin/Users.tsx`
- [Поиск админки](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/admin/Search.tsx): `apps/web/src/admin/Search.tsx`

### API и данные

- [API-клиент сессий](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/web/src/api.ts): `apps/web/src/api.ts`
- [HTTP API](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Токены и пароли](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/api/src/auth.ts): `apps/api/src/auth.ts`
- [PostgreSQL / Prisma](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/packages/db/src/index.ts): `packages/db/src/index.ts`

### VK синхронизация

- [Планировщик worker](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/index.ts): `apps/worker/src/index.ts`
- [Импорт VK-постов](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/sync.ts): `apps/worker/src/sync.ts`
- [Нормализация постов](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/normalize.ts): `apps/worker/src/normalize.ts`
- [VK API-клиент](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/vk.ts): `apps/worker/src/vk.ts`
- [Фото участников](https://github.com/vladglass0/pervye-lenrayon-main/blob/main/apps/worker/src/team-photos.ts): `apps/worker/src/team-photos.ts`

### Other components

- **Посетитель**
- **Редактор / модератор**
- **VK API**

## Connections

- Посетитель → Маршрутизация сайта: открывает (evidence: `apps/web/src/App.tsx`)
- Маршрутизация сайта → Главная: маршрутизирует (evidence: `apps/web/src/App.tsx`)
- Маршрутизация сайта → Каталоги: маршрутизирует (evidence: `apps/web/src/App.tsx`)
- Маршрутизация сайта → План публикаций: маршрутизирует (evidence: `apps/web/src/App.tsx`)
- Редактор / модератор → Админ-маршруты: открывает
- Админ-маршруты → Вход и роли: защищает разделы (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Админ-маршруты → Управление контентом: показывает разделы (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Админ-маршруты → Очередь модерации: показывает разделы (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Админ-маршруты → VK-источники: показывает разделы (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Админ-маршруты → Управление пользователями: показывает разделы (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Админ-маршруты → Поиск админки: встраивает поиск (evidence: `apps/web/src/admin/AdminRoutes.tsx`)
- Вход и роли → API-клиент сессий: входит и обновляет сессию (evidence: `apps/web/src/admin/Auth.tsx`)
- Управление контентом → API-клиент сессий: запрашивает и изменяет (evidence: `apps/web/src/admin/ContentManager.tsx`)
- Очередь модерации → API-клиент сессий: запрашивает API (evidence: `apps/web/src/admin/Moderation.tsx`)
- VK-источники → API-клиент сессий: запрашивает API (evidence: `apps/web/src/admin/VkSources.tsx`)
- Управление пользователями → API-клиент сессий: запрашивает API (evidence: `apps/web/src/admin/Users.tsx`)
- Поиск админки → API-клиент сессий: ищет через API (evidence: `apps/web/src/admin/Search.tsx`)
- Главная → API-клиент сессий: запрашивает данные (evidence: `apps/web/src/HomePage.tsx`)
- Каталоги → API-клиент сессий: запрашивает данные (evidence: `apps/web/src/pages/CatalogPage.tsx`)
- Карточки материалов → API-клиент сессий: запрашивает данные (evidence: `apps/web/src/pages/DetailPage.tsx`)
- API-клиент сессий → HTTP API: HTTP-запросы (evidence: `apps/web/src/api.ts`)
- HTTP API → Токены и пароли: проверяет токены (evidence: `apps/api/src/app.ts`)
- HTTP API → PostgreSQL / Prisma: читает и записывает (evidence: `apps/api/src/app.ts`)
- Планировщик worker → Импорт VK-постов: запускает синхронизацию (evidence: `apps/worker/src/index.ts`)
- Планировщик worker → Фото участников: запускает сбор фото (evidence: `apps/worker/src/index.ts`)
- Импорт VK-постов → Нормализация постов: нормализует посты (evidence: `apps/worker/src/sync.ts`)
- Импорт VK-постов → VK API-клиент: получает записи (evidence: `apps/worker/src/sync.ts`)
- Импорт VK-постов → PostgreSQL / Prisma: сохраняет посты (evidence: `apps/worker/src/sync.ts`)
- VK API-клиент → VK API: читает wall API
- Фото участников → VK API: получает фото профилей
- Планировщик worker → PostgreSQL / Prisma: обновляет heartbeat и очередь (evidence: `apps/worker/src/index.ts`)
