# rkomp9802-prog/- architecture

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

- Interactive diagram: https://gitdiagram.com/rkomp9802-prog/-
- Repository: https://github.com/rkomp9802-prog/-

## Overview

Постовой — браузерный генератор постов для Telegram, YouTube и Instagram. Пользователь задаёт тему и параметры, получает до трёх вариантов с потоковым выводом, может перегенерировать их и создать изображение, а затем находит сохранённые посты в истории. Основной поток проходит через Studio и API-роуты к Gemini; история и изображения хранятся в браузере. Связи основаны на README и указанных в SOURCE INDEX вызовах и зависимостях; реализация image route и часть UI-логики не excerpted, поэтому детали их внутреннего потока опущены.

Main entry points: [`src/components/Studio.tsx`](https://github.com/rkomp9802-prog/-/blob/main/src/components/Studio.tsx) (Studio), [`src/components/HistoryView.tsx`](https://github.com/rkomp9802-prog/-/blob/main/src/components/HistoryView.tsx) (Просмотр истории), [`src/components/VariantCard.tsx`](https://github.com/rkomp9802-prog/-/blob/main/src/components/VariantCard.tsx) (Карточка варианта), [`src/app/api/generate/route.ts`](https://github.com/rkomp9802-prog/-/blob/main/src/app/api/generate/route.ts) (API генерации поста)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Интерфейс приложения"]
  node_studio["Studio<br/>[Studio.tsx]"]
  node_composer["Параметры поста<br/>[Composer.tsx]"]
  node_sidebar["Навигация<br/>[Sidebar.tsx]"]
  node_history_view["Просмотр истории<br/>[HistoryView.tsx]"]
  node_variant_card["Карточка варианта<br/>[VariantCard.tsx]"]
  node_toolbar["Панель действий<br/>[Toolbar.tsx]"]
  node_segmented["Сегментированный выбор<br/>[Segmented.tsx]"]
  node_copy_button["Копирование<br/>[CopyButton.tsx]"]
  node_icons["Иконки<br/>[Icons.tsx]"]
  node_media_query["Адаптивность<br/>[useMediaQuery.ts]"]
  node_smooth_text["Плавный вывод<br/>[useSmoothText.ts]"]
end

subgraph group_generation["Генерация контента"]
  node_gemini_client["Клиент Gemini<br/>[gemini.ts]"]
  node_prompt_builder["Промпты и правила<br/>[prompts.ts]"]
  node_post_parser["Разбор поста<br/>[post.ts]"]
  node_options["Параметры генерации<br/>[options.ts]"]
end

subgraph group_api["Серверные API"]
  node_generate_api["API генерации поста<br/>[route.ts]"]
  node_image_api["API генерации изображения<br/>[route.ts]"]
end

subgraph group_persistence["История и хранение"]
  node_history_store[("История и изображения<br/>[history.ts]")]
  node_browser_storage[("Хранилище браузера")]
end

node_user(("Пользователь"))
node_gemini_service{{"Google Gemini"}}

node_user -->|"задаёт запрос"| node_studio
node_studio -->|"показывает настройки"| node_composer
node_studio -->|"показывает навигацию"| node_sidebar
node_studio -->|"показывает историю"| node_history_view
node_studio -->|"показывает варианты"| node_variant_card
node_studio -->|"показывает действия"| node_toolbar
node_composer -->|"использует контролы"| node_segmented
node_composer -->|"читает справочники"| node_options
node_sidebar -->|"использует иконки"| node_icons
node_toolbar -->|"использует иконки"| node_icons
node_variant_card -->|"плавно показывает"| node_smooth_text
node_variant_card -->|"разбирает поток"| node_post_parser
node_variant_card -->|"предлагает копирование"| node_copy_button
node_history_view -->|"предлагает копирование"| node_copy_button
node_history_view -->|"загружает изображения"| node_history_store
node_studio -->|"адаптирует интерфейс"| node_media_query
node_studio -->|"запрашивает генерацию"| node_generate_api
node_studio -->|"запрашивает изображение"| node_image_api
node_generate_api -->|"строит запрос модели"| node_prompt_builder
node_generate_api -->|"проверяет параметры"| node_options
node_generate_api -->|"открывает поток"| node_gemini_client
node_image_api -->|"использует клиент"| node_gemini_client
node_gemini_client -->|"вызывает API"| node_gemini_service
node_studio -->|"разбирает ответ"| node_post_parser
node_studio -->|"сохраняет историю"| node_history_store
node_history_view -->|"форматирует пост"| node_post_parser
node_history_store -->|"читает и записывает"| node_browser_storage

click node_studio "https://github.com/rkomp9802-prog/-/blob/main/src/components/Studio.tsx"
click node_composer "https://github.com/rkomp9802-prog/-/blob/main/src/components/Composer.tsx"
click node_sidebar "https://github.com/rkomp9802-prog/-/blob/main/src/components/Sidebar.tsx"
click node_history_view "https://github.com/rkomp9802-prog/-/blob/main/src/components/HistoryView.tsx"
click node_variant_card "https://github.com/rkomp9802-prog/-/blob/main/src/components/VariantCard.tsx"
click node_toolbar "https://github.com/rkomp9802-prog/-/blob/main/src/components/Toolbar.tsx"
click node_segmented "https://github.com/rkomp9802-prog/-/blob/main/src/components/Segmented.tsx"
click node_copy_button "https://github.com/rkomp9802-prog/-/blob/main/src/components/CopyButton.tsx"
click node_icons "https://github.com/rkomp9802-prog/-/blob/main/src/components/Icons.tsx"
click node_media_query "https://github.com/rkomp9802-prog/-/blob/main/src/lib/useMediaQuery.ts"
click node_smooth_text "https://github.com/rkomp9802-prog/-/blob/main/src/lib/useSmoothText.ts"
click node_generate_api "https://github.com/rkomp9802-prog/-/blob/main/src/app/api/generate/route.ts"
click node_image_api "https://github.com/rkomp9802-prog/-/blob/main/src/app/api/image/route.ts"
click node_gemini_client "https://github.com/rkomp9802-prog/-/blob/main/src/lib/gemini.ts"
click node_prompt_builder "https://github.com/rkomp9802-prog/-/blob/main/src/lib/prompts.ts"
click node_post_parser "https://github.com/rkomp9802-prog/-/blob/main/src/lib/post.ts"
click node_options "https://github.com/rkomp9802-prog/-/blob/main/src/lib/options.ts"
click node_history_store "https://github.com/rkomp9802-prog/-/blob/main/src/lib/history.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_studio,node_composer,node_sidebar,node_history_view,node_variant_card,node_toolbar,node_segmented,node_copy_button,node_icons,node_media_query,node_smooth_text toneBlue
class node_gemini_client,node_prompt_builder,node_post_parser,node_options toneAmber
class node_generate_api,node_image_api toneMint
class node_history_store,node_browser_storage toneRose
class node_user,node_gemini_service toneIndigo
```

## Components

### Интерфейс приложения

- [Studio](https://github.com/rkomp9802-prog/-/blob/main/src/components/Studio.tsx): `src/components/Studio.tsx`
- [Параметры поста](https://github.com/rkomp9802-prog/-/blob/main/src/components/Composer.tsx): `src/components/Composer.tsx`
- [Навигация](https://github.com/rkomp9802-prog/-/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Просмотр истории](https://github.com/rkomp9802-prog/-/blob/main/src/components/HistoryView.tsx): `src/components/HistoryView.tsx`
- [Карточка варианта](https://github.com/rkomp9802-prog/-/blob/main/src/components/VariantCard.tsx): `src/components/VariantCard.tsx`
- [Панель действий](https://github.com/rkomp9802-prog/-/blob/main/src/components/Toolbar.tsx): `src/components/Toolbar.tsx`
- [Сегментированный выбор](https://github.com/rkomp9802-prog/-/blob/main/src/components/Segmented.tsx): `src/components/Segmented.tsx`
- [Копирование](https://github.com/rkomp9802-prog/-/blob/main/src/components/CopyButton.tsx): `src/components/CopyButton.tsx`
- [Иконки](https://github.com/rkomp9802-prog/-/blob/main/src/components/Icons.tsx): `src/components/Icons.tsx`
- [Адаптивность](https://github.com/rkomp9802-prog/-/blob/main/src/lib/useMediaQuery.ts): `src/lib/useMediaQuery.ts`
- [Плавный вывод](https://github.com/rkomp9802-prog/-/blob/main/src/lib/useSmoothText.ts): `src/lib/useSmoothText.ts`

### Генерация контента

- [Клиент Gemini](https://github.com/rkomp9802-prog/-/blob/main/src/lib/gemini.ts): `src/lib/gemini.ts`
- [Промпты и правила](https://github.com/rkomp9802-prog/-/blob/main/src/lib/prompts.ts): `src/lib/prompts.ts`
- [Разбор поста](https://github.com/rkomp9802-prog/-/blob/main/src/lib/post.ts): `src/lib/post.ts`
- [Параметры генерации](https://github.com/rkomp9802-prog/-/blob/main/src/lib/options.ts): `src/lib/options.ts`

### Серверные API

- [API генерации поста](https://github.com/rkomp9802-prog/-/blob/main/src/app/api/generate/route.ts): `src/app/api/generate/route.ts`
- [API генерации изображения](https://github.com/rkomp9802-prog/-/blob/main/src/app/api/image/route.ts): `src/app/api/image/route.ts`

### История и хранение

- [История и изображения](https://github.com/rkomp9802-prog/-/blob/main/src/lib/history.ts): `src/lib/history.ts`
- **Хранилище браузера**

### Other components

- **Пользователь**
- **Google Gemini**

## Connections

- Пользователь → Studio: задаёт запрос (evidence: `README.md`)
- Studio → Параметры поста: показывает настройки (evidence: `src/components/Studio.tsx`)
- Studio → Навигация: показывает навигацию (evidence: `src/components/Studio.tsx`)
- Studio → Просмотр истории: показывает историю (evidence: `src/components/Studio.tsx`)
- Studio → Карточка варианта: показывает варианты (evidence: `src/components/Studio.tsx`)
- Studio → Панель действий: показывает действия (evidence: `src/components/Studio.tsx`)
- Параметры поста → Сегментированный выбор: использует контролы (evidence: `src/components/Composer.tsx`)
- Параметры поста → Параметры генерации: читает справочники (evidence: `src/components/Composer.tsx`)
- Навигация → Иконки: использует иконки (evidence: `src/components/Sidebar.tsx`)
- Панель действий → Иконки: использует иконки (evidence: `src/components/Toolbar.tsx`)
- Карточка варианта → Плавный вывод: плавно показывает (evidence: `src/components/VariantCard.tsx`)
- Карточка варианта → Разбор поста: разбирает поток (evidence: `src/components/VariantCard.tsx`)
- Карточка варианта → Копирование: предлагает копирование (evidence: `src/components/VariantCard.tsx`)
- Просмотр истории → Копирование: предлагает копирование (evidence: `src/components/HistoryView.tsx`)
- Просмотр истории → История и изображения: загружает изображения (evidence: `src/components/HistoryView.tsx`)
- Studio → Адаптивность: адаптирует интерфейс (evidence: `src/components/Studio.tsx`)
- Studio → API генерации поста: запрашивает генерацию (evidence: `README.md`)
- Studio → API генерации изображения: запрашивает изображение (evidence: `README.md`)
- API генерации поста → Промпты и правила: строит запрос модели (evidence: `src/app/api/generate/route.ts`)
- API генерации поста → Параметры генерации: проверяет параметры (evidence: `src/app/api/generate/route.ts`)
- API генерации поста → Клиент Gemini: открывает поток (evidence: `src/app/api/generate/route.ts`)
- API генерации изображения → Клиент Gemini: использует клиент (evidence: `src/app/api/image/route.ts`)
- Клиент Gemini → Google Gemini: вызывает API (evidence: `src/lib/gemini.ts`)
- Studio → Разбор поста: разбирает ответ (evidence: `src/components/Studio.tsx`)
- Studio → История и изображения: сохраняет историю (evidence: `src/components/Studio.tsx`)
- Просмотр истории → Разбор поста: форматирует пост (evidence: `src/components/HistoryView.tsx`)
- История и изображения → Хранилище браузера: читает и записывает (evidence: `src/lib/history.ts`)
