# denis-rubtsov/wolfsquotes architecture

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

- Interactive diagram: https://gitdiagram.com/denis-rubtsov/wolfsquotes
- Repository: https://github.com/denis-rubtsov/wolfsquotes

## Overview

Vlk is a Telegram quote bot. Users browse and rate quotes, submit suggestions for admin moderation, and—when enabled—request AI-generated quotes; admins also manage the quote collection. BotService handles commands, callbacks, moderation and Telegram Stars payments, while InlineHandler serves inline queries. QuoteService and AiQuoteService provide quote logic and generation; DataService persists bot state in JSON. The graph follows the README and shown source/index references; unsampled handler details are represented at the BotService level.

Main entry points: [`Vlk/BotService.cs`](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs) (Commands and callbacks), [`Vlk/DataService.cs`](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/DataService.cs) (Data access), [`Vlk/Program.cs`](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/Program.cs) (Application setup), [`Vlk/InlineHandler.cs`](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/InlineHandler.cs) (Inline queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Telegram interaction"]
  node_commands["Commands and callbacks<br/>[BotService.cs]"]
  node_inline["Inline queries<br/>[InlineHandler.cs]"]
  node_user_state["Conversation state<br/>[UserState.cs]"]
  node_program["Application setup<br/>[Program.cs]"]
end

subgraph group_quotes["Quotes and moderation"]
  node_quote_ops["Quote operations<br/>[QuoteService.cs]"]
  node_moderation["Suggestions and moderation<br/>[BotService.cs]"]
  node_suggestion_model["Suggestion model<br/>[Suggestion.cs]"]
  node_rating_model["Quote ratings<br/>[QuoteRating.cs]"]
end

subgraph group_generation["AI and payments"]
  node_ai["AI quote generation<br/>[AiQuoteService.cs]"]
  node_limiter["Generation rate limit<br/>[RateLimiter.cs]"]
  node_payments["Stars payments<br/>[BotService.cs]"]
end

subgraph group_storage["State and storage"]
  node_data_service["Data access<br/>[DataService.cs]"]
  node_json_store[("JSON data file")]
  node_data_model["Bot data model<br/>[BotData.cs]"]
end

node_users(("Users"))
node_admins(("Admins"))
node_telegram["Telegram API"]
node_openai["OpenAI Chat API"]

node_users -->|"send commands"| node_commands
node_admins -->|"manage bot"| node_commands
node_users -->|"query inline"| node_inline
node_commands -->|"send responses"| node_telegram
node_inline -->|"answer queries"| node_telegram
node_commands -->|"request quotes"| node_quote_ops
node_commands -->|"read and mutate"| node_data_service
node_commands -->|"process suggestions"| node_moderation
node_inline -->|"read quotes"| node_data_service
node_inline -->|"request generation"| node_ai
node_commands -->|"request generation"| node_ai
node_commands -->|"check allowance"| node_limiter
node_inline -->|"check allowance"| node_limiter
node_commands -->|"handle payments"| node_payments
node_payments -->|"process Stars"| node_telegram
node_commands -->|"track conversation"| node_user_state
node_quote_ops -->|"read and rate"| node_data_service
node_ai -->|"read examples"| node_data_service
node_ai -->|"complete chat"| node_openai
node_data_service -->|"load and save"| node_json_store
node_data_service -->|"maintain"| node_data_model
node_data_model -->|"stores"| node_suggestion_model
node_data_model -->|"stores"| node_rating_model
node_program -->|"constructs"| node_data_service
node_program -->|"constructs"| node_quote_ops
node_program -->|"constructs"| node_ai
node_program -->|"constructs"| node_limiter
node_program -->|"constructs"| node_inline
node_program -->|"starts service"| node_commands

click node_commands "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs"
click node_inline "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/InlineHandler.cs"
click node_quote_ops "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/QuoteService.cs"
click node_moderation "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs"
click node_ai "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/AiQuoteService.cs"
click node_limiter "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/RateLimiter.cs"
click node_payments "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs"
click node_user_state "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/UserState.cs"
click node_data_service "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/DataService.cs"
click node_data_model "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotData.cs"
click node_suggestion_model "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/Suggestion.cs"
click node_rating_model "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/QuoteRating.cs"
click node_program "https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/Program.cs"

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_commands,node_inline,node_user_state,node_program,node_users toneBlue
class node_quote_ops,node_moderation,node_suggestion_model,node_rating_model toneAmber
class node_ai,node_limiter,node_payments,node_telegram,node_openai toneMint
class node_data_service,node_json_store,node_data_model toneRose
class node_admins toneIndigo
```

## Components

### Telegram interaction

- [Commands and callbacks](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs): `Vlk/BotService.cs`
- [Inline queries](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/InlineHandler.cs): `Vlk/InlineHandler.cs`
- [Conversation state](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/UserState.cs): `Vlk/UserState.cs`
- [Application setup](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/Program.cs): `Vlk/Program.cs`

### Quotes and moderation

- [Quote operations](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/QuoteService.cs): `Vlk/QuoteService.cs`
- [Suggestions and moderation](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs): `Vlk/BotService.cs`
- [Suggestion model](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/Suggestion.cs): `Vlk/Suggestion.cs`
- [Quote ratings](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/QuoteRating.cs): `Vlk/QuoteRating.cs`

### AI and payments

- [AI quote generation](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/AiQuoteService.cs): `Vlk/AiQuoteService.cs`
- [Generation rate limit](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/RateLimiter.cs): `Vlk/RateLimiter.cs`
- [Stars payments](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotService.cs): `Vlk/BotService.cs`

### State and storage

- [Data access](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/DataService.cs): `Vlk/DataService.cs`
- **JSON data file**
- [Bot data model](https://github.com/denis-rubtsov/wolfsquotes/blob/main/Vlk/BotData.cs): `Vlk/BotData.cs`

### Other components

- **Users**
- **Admins**
- **Telegram API**
- **OpenAI Chat API**

## Connections

- Users → Commands and callbacks: send commands (evidence: `README.md`)
- Admins → Commands and callbacks: manage bot (evidence: `README.md`)
- Users → Inline queries: query inline (evidence: `README.md`)
- Commands and callbacks → Telegram API: send responses (evidence: `Vlk/BotService.cs`)
- Inline queries → Telegram API: answer queries (evidence: `Vlk/InlineHandler.cs`)
- Commands and callbacks → Quote operations: request quotes (evidence: `Vlk/BotService.cs`)
- Commands and callbacks → Data access: read and mutate (evidence: `Vlk/BotService.cs`)
- Commands and callbacks → Suggestions and moderation: process suggestions (evidence: `README.md`)
- Inline queries → Data access: read quotes (evidence: `Vlk/InlineHandler.cs`)
- Inline queries → AI quote generation: request generation (evidence: `Vlk/InlineHandler.cs`)
- Commands and callbacks → AI quote generation: request generation (evidence: `Vlk/BotService.cs`)
- Commands and callbacks → Generation rate limit: check allowance (evidence: `Vlk/BotService.cs`)
- Inline queries → Generation rate limit: check allowance (evidence: `Vlk/InlineHandler.cs`)
- Commands and callbacks → Stars payments: handle payments (evidence: `README.md`)
- Stars payments → Telegram API: process Stars (evidence: `Vlk/BotService.cs`)
- Commands and callbacks → Conversation state: track conversation (evidence: `Vlk/BotService.cs`)
- Quote operations → Data access: read and rate (evidence: `Vlk/QuoteService.cs`)
- AI quote generation → Data access: read examples (evidence: `Vlk/AiQuoteService.cs`)
- AI quote generation → OpenAI Chat API: complete chat (evidence: `Vlk/AiQuoteService.cs`)
- Data access → JSON data file: load and save (evidence: `Vlk/DataService.cs`)
- Data access → Bot data model: maintain (evidence: `Vlk/DataService.cs`)
- Bot data model → Suggestion model: stores (evidence: `Vlk/BotData.cs`)
- Bot data model → Quote ratings: stores (evidence: `Vlk/BotData.cs`)
- Application setup → Data access: constructs (evidence: `Vlk/Program.cs`)
- Application setup → Quote operations: constructs (evidence: `Vlk/Program.cs`)
- Application setup → AI quote generation: constructs (evidence: `Vlk/Program.cs`)
- Application setup → Generation rate limit: constructs (evidence: `Vlk/Program.cs`)
- Application setup → Inline queries: constructs (evidence: `Vlk/Program.cs`)
- Application setup → Commands and callbacks: starts service (evidence: `Vlk/Program.cs`)
