# petrov-kirill-241-321/twitchcopybackend architecture

> Architecture diagram of the GitHub repository petrov-kirill-241-321/twitchcopybackend, 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/petrov-kirill-241-321/twitchcopybackend
- Repository: https://github.com/petrov-kirill-241-321/twitchcopybackend

## Overview

This repository implements a NestJS backend for a live-streaming community: users authenticate and manage profiles, discover channels and streams, interact through chat and follows, and use sponsorship and notification features. The runtime starts in `main.ts`, which creates the application and configures sessions; `CoreModule` assembles the API and product modules. Sampled services show persistence through Prisma, session storage through Redis, and stream-thumbnail storage and LiveKit token generation. Several modules are represented from the tree and index; their internal call paths were not inspected.

Main entry points: [`src/core/core.module.ts`](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/core.module.ts) (Module assembly), [`src/core/prisma/prisma.service.ts`](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/prisma/prisma.service.ts) (Prisma persistence), [`src/modules/cron/cron.service.ts`](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/cron/cron.service.ts) (Scheduled tasks), [`src/modules/libs/storage/storage.service.ts`](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/storage/storage.service.ts) (Object storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Runtime and API"]
  node_bootstrap["App bootstrap<br/>[main.ts]"]
  node_core["Module assembly<br/>[core.module.ts]"]
end

subgraph group_identity["Identity and accounts"]
  node_auth["Account and sessions<br/>[session.service.ts]"]
  node_profile["Profile management<br/>[profile.service.ts]"]
  node_verification["Email verification"]
end

subgraph group_community["Streaming community"]
  node_category["Categories"]
  node_channel["Channels<br/>[channel.service.ts]"]
  node_stream["Streams<br/>[stream.service.ts]"]
  node_ingress["Stream ingress<br/>[ingress.service.ts]"]
  node_chat["Chat<br/>[chat.service.ts]"]
  node_follow["Follows<br/>[follow.service.ts]"]
  node_notifications["Notifications"]
end

subgraph group_monetization["Sponsorship"]
  node_plans["Sponsorship plans<br/>[plan.service.ts]"]
  node_subscriptions["Subscriptions"]
  node_transactions["Transactions"]
end

subgraph group_platform["Infrastructure and integrations"]
  node_webhooks["Webhooks<br/>[webhook.service.ts]"]
  node_cron["Scheduled tasks<br/>[cron.service.ts]"]
  node_prisma[("Prisma persistence<br/>[prisma.service.ts]")]
  node_redis[("Redis sessions<br/>[redis.service.ts]")]
  node_storage["Object storage<br/>[storage.service.ts]"]
  node_mail["Email delivery<br/>[mail.service.ts]"]
  node_telegram["Telegram bot"]
  node_livekit["LiveKit service<br/>[livekit.service.ts]"]
  node_stripe["Stripe integration<br/>[stripe.service.ts]"]
end

node_client(("API client"))
node_livekit_ext["LiveKit"]
node_s3["S3-compatible storage"]

node_client -.->|"sends requests"| node_bootstrap
node_bootstrap -->|"creates app"| node_core
node_core -->|"registers module"| node_auth
node_core -->|"registers module"| node_profile
node_core -->|"registers module"| node_verification
node_core -->|"registers module"| node_category
node_core -->|"registers module"| node_channel
node_core -->|"registers module"| node_stream
node_core -->|"registers module"| node_ingress
node_core -->|"registers module"| node_chat
node_core -->|"registers module"| node_follow
node_core -->|"registers module"| node_notifications
node_core -->|"registers module"| node_plans
node_core -->|"registers module"| node_subscriptions
node_core -->|"registers module"| node_transactions
node_core -->|"registers module"| node_webhooks
node_core -->|"registers module"| node_cron
node_core -->|"registers module"| node_prisma
node_core -->|"registers module"| node_redis
node_core -->|"registers module"| node_storage
node_core -->|"registers module"| node_mail
node_core -->|"registers module"| node_telegram
node_core -->|"registers module"| node_livekit
node_core -->|"registers module"| node_stripe
node_auth -->|"queries users"| node_prisma
node_auth -->|"reads sessions"| node_redis
node_auth -->|"requests verification"| node_verification
node_verification -->|"reads and writes"| node_prisma
node_verification -->|"sends email"| node_mail
node_profile -->|"reads and writes"| node_prisma
node_profile -->|"uses storage"| node_storage
node_stream -->|"reads and writes"| node_prisma
node_stream -->|"uploads thumbnails"| node_storage
node_stream -->|"creates access token"| node_livekit_ext
node_storage -->|"uploads and deletes"| node_s3
node_follow -->|"reads and writes"| node_prisma
node_follow -->|"creates notifications"| node_notifications
node_follow -->|"sends updates"| node_telegram
node_notifications -->|"reads and writes"| node_prisma
node_chat -->|"reads and writes"| node_prisma
node_channel -->|"queries channels"| node_prisma
node_cron -->|"queries records"| node_prisma
node_cron -->|"sends email"| node_mail
node_cron -->|"uses storage"| node_storage
node_cron -->|"sends messages"| node_telegram
node_cron -->|"creates notifications"| node_notifications
node_telegram -->|"queries users"| node_prisma

click node_bootstrap "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/main.ts"
click node_core "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/core.module.ts"
click node_auth "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/auth/session/session.service.ts"
click node_profile "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/auth/profile/profile.service.ts"
click node_verification "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/verification/verification.service.ts"
click node_category "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/category/category.service.ts"
click node_channel "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/channel/channel.service.ts"
click node_stream "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/stream/stream.service.ts"
click node_ingress "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/stream/ingress/ingress.service.ts"
click node_chat "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/chat/chat.service.ts"
click node_follow "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/follow/follow.service.ts"
click node_notifications "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/notification/notification.service.ts"
click node_plans "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/plan/plan.service.ts"
click node_subscriptions "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/subscription/subscription.service.ts"
click node_transactions "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/transaction/transaction.service.ts"
click node_webhooks "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/webhook/webhook.service.ts"
click node_cron "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/cron/cron.service.ts"
click node_prisma "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/prisma/prisma.service.ts"
click node_redis "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/redis/redis.service.ts"
click node_storage "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/storage/storage.service.ts"
click node_mail "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/mail/mail.service.ts"
click node_telegram "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/telegram/telegram.service.ts"
click node_livekit "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/livekit/livekit.service.ts"
click node_stripe "https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/stripe/stripe.service.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_bootstrap,node_core,node_client toneBlue
class node_auth,node_profile,node_verification,node_s3 toneAmber
class node_category,node_channel,node_stream,node_ingress,node_chat,node_follow,node_notifications toneMint
class node_plans,node_subscriptions,node_transactions toneRose
class node_webhooks,node_cron,node_prisma,node_redis,node_storage,node_mail,node_telegram,node_livekit,node_stripe,node_livekit_ext toneIndigo
```

## Components

### Runtime and API

- [App bootstrap](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/main.ts): `src/main.ts`
- [Module assembly](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/core.module.ts): `src/core/core.module.ts`

### Identity and accounts

- [Account and sessions](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/auth/session/session.service.ts): `src/modules/auth/session/session.service.ts`
- [Profile management](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/auth/profile/profile.service.ts): `src/modules/auth/profile/profile.service.ts`
- [Email verification](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/verification/verification.service.ts): `src/verification/verification.service.ts`

### Streaming community

- [Categories](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/category/category.service.ts): `src/modules/category/category.service.ts`
- [Channels](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/channel/channel.service.ts): `src/modules/channel/channel.service.ts`
- [Streams](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/stream/stream.service.ts): `src/modules/stream/stream.service.ts`
- [Stream ingress](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/stream/ingress/ingress.service.ts): `src/modules/stream/ingress/ingress.service.ts`
- [Chat](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/chat/chat.service.ts): `src/modules/chat/chat.service.ts`
- [Follows](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/follow/follow.service.ts): `src/modules/follow/follow.service.ts`
- [Notifications](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/notification/notification.service.ts): `src/modules/notification/notification.service.ts`

### Sponsorship

- [Sponsorship plans](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/plan/plan.service.ts): `src/modules/sponsorship/plan/plan.service.ts`
- [Subscriptions](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/subscription/subscription.service.ts): `src/modules/sponsorship/subscription/subscription.service.ts`
- [Transactions](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/sponsorship/transaction/transaction.service.ts): `src/modules/sponsorship/transaction/transaction.service.ts`

### Infrastructure and integrations

- [Webhooks](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/webhook/webhook.service.ts): `src/modules/webhook/webhook.service.ts`
- [Scheduled tasks](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/cron/cron.service.ts): `src/modules/cron/cron.service.ts`
- [Prisma persistence](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/prisma/prisma.service.ts): `src/core/prisma/prisma.service.ts`
- [Redis sessions](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/core/redis/redis.service.ts): `src/core/redis/redis.service.ts`
- [Object storage](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/storage/storage.service.ts): `src/modules/libs/storage/storage.service.ts`
- [Email delivery](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/mail/mail.service.ts): `src/modules/libs/mail/mail.service.ts`
- [Telegram bot](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/telegram/telegram.service.ts): `src/modules/libs/telegram/telegram.service.ts`
- [LiveKit service](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/livekit/livekit.service.ts): `src/modules/libs/livekit/livekit.service.ts`
- [Stripe integration](https://github.com/petrov-kirill-241-321/twitchcopybackend/blob/main/src/modules/libs/stripe/stripe.service.ts): `src/modules/libs/stripe/stripe.service.ts`

### Other components

- **API client**
- **LiveKit**
- **S3-compatible storage**

## Connections

- API client → App bootstrap: sends requests
- App bootstrap → Module assembly: creates app (evidence: `src/main.ts`)
- Module assembly → Account and sessions: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Profile management: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Email verification: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Categories: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Channels: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Streams: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Stream ingress: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Chat: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Follows: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Notifications: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Sponsorship plans: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Subscriptions: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Transactions: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Webhooks: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Scheduled tasks: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Prisma persistence: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Redis sessions: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Object storage: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Email delivery: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Telegram bot: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → LiveKit service: registers module (evidence: `src/core/core.module.ts`)
- Module assembly → Stripe integration: registers module (evidence: `src/core/core.module.ts`)
- Account and sessions → Prisma persistence: queries users (evidence: `src/modules/auth/session/session.service.ts`)
- Account and sessions → Redis sessions: reads sessions (evidence: `src/modules/auth/session/session.service.ts`)
- Account and sessions → Email verification: requests verification (evidence: `src/modules/auth/session/session.service.ts`)
- Email verification → Prisma persistence: reads and writes (evidence: `src/verification/verification.service.ts`)
- Email verification → Email delivery: sends email (evidence: `src/verification/verification.service.ts`)
- Profile management → Prisma persistence: reads and writes (evidence: `src/modules/auth/profile/profile.service.ts`)
- Profile management → Object storage: uses storage (evidence: `src/modules/auth/profile/profile.service.ts`)
- Streams → Prisma persistence: reads and writes (evidence: `src/modules/stream/stream.service.ts`)
- Streams → Object storage: uploads thumbnails (evidence: `src/modules/stream/stream.service.ts`)
- Streams → LiveKit: creates access token (evidence: `src/modules/stream/stream.service.ts`)
- Object storage → S3-compatible storage: uploads and deletes (evidence: `src/modules/libs/storage/storage.service.ts`)
- Follows → Prisma persistence: reads and writes (evidence: `src/modules/follow/follow.service.ts`)
- Follows → Notifications: creates notifications (evidence: `src/modules/follow/follow.service.ts`)
- Follows → Telegram bot: sends updates (evidence: `src/modules/follow/follow.service.ts`)
- Notifications → Prisma persistence: reads and writes (evidence: `src/modules/notification/notification.service.ts`)
- Chat → Prisma persistence: reads and writes (evidence: `src/modules/chat/chat.service.ts`)
- Channels → Prisma persistence: queries channels (evidence: `src/modules/channel/channel.service.ts`)
- Scheduled tasks → Prisma persistence: queries records (evidence: `src/modules/cron/cron.service.ts`)
- Scheduled tasks → Email delivery: sends email (evidence: `src/modules/cron/cron.service.ts`)
- Scheduled tasks → Object storage: uses storage (evidence: `src/modules/cron/cron.service.ts`)
- Scheduled tasks → Telegram bot: sends messages (evidence: `src/modules/cron/cron.service.ts`)
- Scheduled tasks → Notifications: creates notifications (evidence: `src/modules/cron/cron.service.ts`)
- Telegram bot → Prisma persistence: queries users (evidence: `src/modules/libs/telegram/telegram.service.ts`)
