# kiyoshi-work/app-server architecture

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

- Interactive diagram: https://gitdiagram.com/kiyoshi-work/app-server
- Repository: https://github.com/kiyoshi-work/app-server

## Overview

1. This is a NestJS backend composed as a modular monolith. `src/main.ts` boots a single application, while `src/app.module.ts` composes domain modules that expose multiple entrypoints: REST, GraphQL, JSON-RPC, WebSocket, and a Telegram bot listener.

2. The access layer lives mainly under `src/modules/api`, `graphql`, `jrpc`, `websocket`, and `telegram-bot`. These modules are responsible for request parsing, auth, validation, exception mapping, response shaping, and transport-specific concerns. The API layer includes JWT/RBAC guards, throttling, cache, and context/device interceptors; GraphQL and JSON-RPC have their own guards and resolvers/handlers; WebSocket uses Socket.IO gateways.

3. The business layer is split into feature-oriented modules: `ai`, `blockchain`, `crawler`, `game`, `business`, `sync-contract`, `worker`, `listen-socket`, and `worker-thread`. This is where the actual domain behavior sits: AI orchestration, blockchain interactions, contract synchronization, game lifecycle commands, notification/auth workflows, data scraping, scheduled jobs, and CPU-bound offloading.

4. The data layer is polyglot. `database` is the primary relational store with entities and repositories; `timescale-db` stores price/time-series data; `redis-cache` is used for caching and session/state; `milvus-db` and `vectorstore-db` provide vector search / document retrieval; `elasticsearch` supports full-text search; `firebase` and `upload-file` cover Firestore/Storage-backed persistence; `onesignal` is used for push notification delivery rather than primary storage.

5. There is a clear async boundary around messaging and background work. `transporter` abstracts RabbitMQ, Redis MQ, and Google Pub/Sub. `queue` and `worker` handle job consumption and scheduled execution. The worker side includes consumers for Telegram bot and user flows, plus a scheduler service for recurring tasks.

6. Real-time and streaming concerns are separated from request/response APIs. `websocket/gateways` exposes chat and price channels, with a Redis adapter for horizontal scaling. `listen-socket` appears to subscribe to external market feeds (for example BingX prices) and feed them into the real-time pipeline and/or time-series storage.

7. The Telegram bot is a stateful conversation subsystem, not just a thin adapter. It has command chains, handler pipelines, session storage, UI/page rendering, verification flows, and i18n content under `src/i18n/telebot`. It likely interacts with queues and workers for deferred processing and persistent user state.

8. Blockchain support is centered in `blockchain` and `sync-contract`. The module contains chain/token/contract configuration, Solana service integration, ERC20/USDC contract wrappers, and an orderbook SDK. The sync services suggest a pipeline that listens to on-chain events, normalizes them, and persists them into database entities such as `smc-event` and transaction logs.

9. AI and retrieval capabilities are isolated in `ai`, `milvus-db`, `vectorstore-db`, and `crawler`. Crawler services aggregate external market/social data from providers like CoinGecko, DexScreener, Birdeye, LunarCrush, and Twitter APIs. That data can be stored/indexed in vector stores and then used by the AI module and tools for retrieval-augmented workflows and function calling.

10. Cross-cutting infrastructure is centralized under `shared`, `logger`, `sentry`, and the custom JSON-RPC library in `shared/libs/json-rpc`. `shared` holds decorators, exceptions, pagination, validation, injection symbols, and common constants so feature modules stay thin. Logger and Sentry provide observability and error capture across all entrypoints.

11. The repo is built for multi-service deployment. The Docker files and compose stack include specialized containers for Nest, Postgres, TimescaleDB, Milvus, SearxNG, and CUDA-based AI runtimes, with Cloud Build configs for CI/CD. This indicates the application is expected to run as a coordinated stack rather than a single process with local-only dependencies.

12. In diagram terms, the main flow is: external clients and bots enter through transport adapters; those adapters call domain services; domain services read/write through repositories and integration clients; background workers and event handlers process deferred work; and shared infrastructure modules provide auth, logging, caching, and error handling across the whole system.

Main entry points: [`src/app.module.ts`](https://github.com/kiyoshi-work/app-server/blob/main/src/app.module.ts) (app module), [`src/modules/database/database.module.ts`](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/database/database.module.ts) (Database), [`src/shared`](https://github.com/kiyoshi-work/app-server/tree/main/src/shared) (Shared), [`src/modules/ai/ai.module.ts`](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/ai/ai.module.ts) (AI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_app["Bootstrap"]
  node_node_main["main<br/>Nest bootstrap<br/>[main.ts]"]
  node_node_app_module["app module<br/>Module composer<br/>[app.module.ts]"]
end

subgraph group_group_access["Access layer"]
  node_node_api["API<br/>REST adapter<br/>[api.module.ts]"]
  node_node_graphql["GraphQL<br/>[graphql.module.ts]"]
  node_node_jrpc["JSON-RPC<br/>RPC adapter<br/>[jrpc.module.ts]"]
  node_node_websocket["WebSocket<br/>Socket.IO gateway"]
  node_node_telegram["Telegram bot<br/>Conversation adapter"]
end

subgraph group_group_domain["Domain modules"]
  node_node_ai["AI<br/>LLM orchestration<br/>[ai.module.ts]"]
  node_node_blockchain["Blockchain<br/>Chain integration"]
  node_node_sync_contract["Sync contract<br/>Event sync"]
  node_node_business["Business<br/>Workflow services<br/>[business.module.ts]"]
  node_node_crawler["Crawler<br/>External ingestion<br/>[crawler.module.ts]"]
  node_node_game["Game<br/>[game.module.ts]"]
end

subgraph group_group_data["Data layer"]
  node_node_database[("Database<br/>Relational store<br/>[database.module.ts]")]
  node_node_timescale[("Timescale DB<br/>Time-series store")]
  node_node_redis[("Redis cache<br/>Cache/session store")]
  node_node_milvus[("Milvus<br/>Vector index<br/>[milvus.module.ts]")]
  node_node_vectorstore[("Vector store<br/>Document store")]
  node_node_elasticsearch[("Search<br/>Full-text index")]
  node_node_firebase[("Firebase<br/>Firestore wrapper<br/>[module.ts]")]
  node_node_upload["Upload file<br/>Storage adapter"]
  node_node_onesignal["OneSignal<br/>Push delivery"]
end

subgraph group_group_async["Async & events"]
  node_node_transporter["Transporter<br/>Message transport"]
  node_node_queue["Queue<br/>[queue.module.ts]"]
  node_node_worker["Worker<br/>Background jobs<br/>[worker.module.ts]"]
  node_node_listen_socket["Listen socket<br/>Market feed"]
  node_node_worker_thread["Worker thread<br/>CPU offload"]
end

subgraph group_group_shared["Shared infra"]
  node_node_shared["Shared<br/>Common kernel"]
  node_node_jsonrpc_lib["JSON-RPC lib<br/>RPC framework<br/>[json-rpc.module.ts]"]
  node_node_logger["Logger<br/>Observability<br/>[logger.module.ts]"]
  node_node_sentry["Sentry<br/>Error capture<br/>[sentry.module.ts]"]
end

node_node_main -->|"boots"| node_node_app_module
node_node_app_module -->|"imports"| node_node_api
node_node_app_module -->|"imports"| node_node_graphql
node_node_app_module -->|"imports"| node_node_jrpc
node_node_app_module -->|"imports"| node_node_websocket
node_node_app_module -->|"imports"| node_node_telegram
node_node_app_module -->|"imports"| node_node_ai
node_node_app_module -->|"imports"| node_node_blockchain
node_node_app_module -->|"imports"| node_node_sync_contract
node_node_app_module -->|"imports"| node_node_business
node_node_app_module -->|"imports"| node_node_crawler
node_node_app_module -->|"imports"| node_node_game
node_node_app_module -->|"imports"| node_node_database
node_node_app_module -->|"imports"| node_node_timescale
node_node_app_module -->|"imports"| node_node_redis
node_node_app_module -->|"imports"| node_node_milvus
node_node_app_module -->|"imports"| node_node_vectorstore
node_node_app_module -->|"imports"| node_node_elasticsearch
node_node_app_module -->|"imports"| node_node_firebase
node_node_app_module -->|"imports"| node_node_upload
node_node_app_module -->|"imports"| node_node_onesignal
node_node_app_module -->|"imports"| node_node_transporter
node_node_app_module -->|"imports"| node_node_queue
node_node_app_module -->|"imports"| node_node_worker
node_node_app_module -->|"imports"| node_node_listen_socket
node_node_app_module -->|"imports"| node_node_worker_thread
node_node_api -->|"uses"| node_node_shared
node_node_graphql -->|"uses"| node_node_shared
node_node_jrpc -->|"uses"| node_node_jsonrpc_lib
node_node_jrpc -->|"uses"| node_node_shared
node_node_websocket -->|"uses"| node_node_redis
node_node_telegram -->|"uses"| node_node_queue
node_node_telegram -->|"uses"| node_node_worker
node_node_ai -->|"uses"| node_node_milvus
node_node_ai -->|"uses"| node_node_vectorstore
node_node_ai -->|"uses"| node_node_crawler
node_node_sync_contract -->|"uses"| node_node_blockchain
node_node_sync_contract -->|"writes"| node_node_database
node_node_business -->|"uses"| node_node_database
node_node_business -->|"uses"| node_node_onesignal
node_node_crawler -->|"uses"| node_node_shared
node_node_game -->|"publishes"| node_node_websocket
node_node_game -->|"uses"| node_node_database
node_node_database -->|"uses"| node_node_shared
node_node_timescale -->|"uses"| node_node_shared
node_node_queue -->|"uses"| node_node_transporter
node_node_worker -->|"consumes"| node_node_queue
node_node_worker -->|"uses"| node_node_database

click node_node_main "https://github.com/kiyoshi-work/app-server/blob/main/src/main.ts"
click node_node_app_module "https://github.com/kiyoshi-work/app-server/blob/main/src/app.module.ts"
click node_node_api "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/api/api.module.ts"
click node_node_graphql "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/graphql/graphql.module.ts"
click node_node_jrpc "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/jrpc/jrpc.module.ts"
click node_node_websocket "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/websocket/websocket.module.ts"
click node_node_telegram "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/telegram-bot/telegram-bot.module.ts"
click node_node_ai "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/ai/ai.module.ts"
click node_node_blockchain "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/blockchain/blockchain.module.ts"
click node_node_sync_contract "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/sync-contract/sync-contract.module.ts"
click node_node_business "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/business/business.module.ts"
click node_node_crawler "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/crawler/crawler.module.ts"
click node_node_game "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/game/game.module.ts"
click node_node_database "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/database/database.module.ts"
click node_node_timescale "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/timescale-db/timescale-db.module.ts"
click node_node_redis "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/redis-cache/redis-cache.module.ts"
click node_node_milvus "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/milvus-db/milvus.module.ts"
click node_node_vectorstore "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/vectorstore-db/vector-store.module.ts"
click node_node_elasticsearch "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/elasticsearch/elasticsearch.module.ts"
click node_node_firebase "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/firebase/module.ts"
click node_node_upload "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/upload-file/upload-file.module.ts"
click node_node_onesignal "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/onesignal/onesignal.module.ts"
click node_node_transporter "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/transporter/transporter.module.ts"
click node_node_queue "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/queue/queue.module.ts"
click node_node_worker "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/worker/worker.module.ts"
click node_node_listen_socket "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/listen-socket/listen-socket.module.ts"
click node_node_worker_thread "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/worker-thread/worker-thread.module.ts"
click node_node_shared "https://github.com/kiyoshi-work/app-server/tree/main/src/shared"
click node_node_jsonrpc_lib "https://github.com/kiyoshi-work/app-server/blob/main/src/shared/libs/json-rpc/json-rpc.module.ts"
click node_node_logger "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/logger/logger.module.ts"
click node_node_sentry "https://github.com/kiyoshi-work/app-server/blob/main/src/modules/sentry/sentry.module.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_node_main,node_node_app_module toneBlue
class node_node_api,node_node_graphql,node_node_jrpc,node_node_websocket,node_node_telegram toneAmber
class node_node_ai,node_node_blockchain,node_node_sync_contract,node_node_business,node_node_crawler,node_node_game toneMint
class node_node_database,node_node_timescale,node_node_redis,node_node_milvus,node_node_vectorstore,node_node_elasticsearch,node_node_firebase,node_node_upload,node_node_onesignal toneRose
class node_node_transporter,node_node_queue,node_node_worker,node_node_listen_socket,node_node_worker_thread toneIndigo
class node_node_shared,node_node_jsonrpc_lib,node_node_logger,node_node_sentry toneTeal
```

## Components

### Bootstrap

Application entry and module composition

- [main](https://github.com/kiyoshi-work/app-server/blob/main/src/main.ts): Nest bootstrap · Starts the single Nest application · `src/main.ts`
- [app module](https://github.com/kiyoshi-work/app-server/blob/main/src/app.module.ts): Module composer · Assembles transport, domain, and infrastructure modules · `src/app.module.ts`

### Access layer

Transport adapters and request-facing entrypoints

- [API](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/api/api.module.ts): REST adapter · REST controllers, guards, interceptors, filters, and DTO validation · `src/modules/api/api.module.ts`
- [GraphQL](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/graphql/graphql.module.ts): GraphQL adapter · GraphQL resolvers, models, and JWT guard · `src/modules/graphql/graphql.module.ts`
- [JSON-RPC](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/jrpc/jrpc.module.ts): RPC adapter · JSON-RPC handlers and auth boundary · `src/modules/jrpc/jrpc.module.ts`
- [WebSocket](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/websocket/websocket.module.ts): Socket.IO gateway · Realtime chat and price gateways with Redis scaling · `src/modules/websocket/websocket.module.ts`
- [Telegram bot](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/telegram-bot/telegram-bot.module.ts): Conversation adapter · Stateful bot commands, handlers, UI pages, sessions, and verification flows · `src/modules/telegram-bot/telegram-bot.module.ts`

### Domain modules

Core business behavior and orchestration

- [AI](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/ai/ai.module.ts): LLM orchestration · AI service and tools for higher-level assistant workflows · `src/modules/ai/ai.module.ts`
- [Blockchain](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/blockchain/blockchain.module.ts): Chain integration · Chain config, Solana service, contract wrappers, and orderbook SDK · `src/modules/blockchain/blockchain.module.ts`
- [Sync contract](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/sync-contract/sync-contract.module.ts): Event sync · Normalizes on-chain events and transaction data into persistence · `src/modules/sync-contract/sync-contract.module.ts`
- [Business](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/business/business.module.ts): Workflow services · Application workflows for auth and notifications · `src/modules/business/business.module.ts`
- [Crawler](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/crawler/crawler.module.ts): External ingestion · Aggregates market and social data from provider APIs · `src/modules/crawler/crawler.module.ts`
- [Game](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/game/game.module.ts): Game flow · Command-driven game lifecycle and room state management · `src/modules/game/game.module.ts`

### Data layer

Persistent stores and repositories

- [Database](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/database/database.module.ts): Relational store · Primary entities, repositories, and seed data · `src/modules/database/database.module.ts`
- [Timescale DB](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/timescale-db/timescale-db.module.ts): Time-series store · Price history persistence and repository access · `src/modules/timescale-db/timescale-db.module.ts`
- [Redis cache](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/redis-cache/redis-cache.module.ts): Cache/session store · Caching and session/state support · `src/modules/redis-cache/redis-cache.module.ts`
- [Milvus](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/milvus-db/milvus.module.ts): Vector index · Vector search document repository · `src/modules/milvus-db/milvus.module.ts`
- [Vector store](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/vectorstore-db/vector-store.module.ts): Document store · LangChain-oriented document repository and mocks · `src/modules/vectorstore-db/vector-store.module.ts`
- [Search](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/elasticsearch/elasticsearch.module.ts): Full-text index · Search service and DTO boundary · `src/modules/elasticsearch/elasticsearch.module.ts`
- [Firebase](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/firebase/module.ts): Firestore wrapper · Firestore repository and database interface · `src/modules/firebase/module.ts`
- [Upload file](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/upload-file/upload-file.module.ts): Storage adapter · Firebase and Google Cloud Storage backed file handling · `src/modules/upload-file/upload-file.module.ts`
- [OneSignal](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/onesignal/onesignal.module.ts): Push delivery · Notification delivery client and API exceptions · `src/modules/onesignal/onesignal.module.ts`

### Async & events

Messaging, queues, workers, and background processing

- [Transporter](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/transporter/transporter.module.ts): Message transport · RabbitMQ, Redis MQ, and Google Pub/Sub abstraction · `src/modules/transporter/transporter.module.ts`
- [Queue](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/queue/queue.module.ts): Job queue · Queue configuration and service boundary · `src/modules/queue/queue.module.ts`
- [Worker](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/worker/worker.module.ts): Background jobs · Consumers and scheduled task execution · `src/modules/worker/worker.module.ts`
- [Listen socket](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/listen-socket/listen-socket.module.ts): Market feed · Consumes external price feeds such as BingX · `src/modules/listen-socket/listen-socket.module.ts`
- [Worker thread](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/worker-thread/worker-thread.module.ts): CPU offload · Threaded task execution for expensive computations · `src/modules/worker-thread/worker-thread.module.ts`

### Shared infra

Cross-cutting utilities, error handling, and custom libraries

- [Shared](https://github.com/kiyoshi-work/app-server/tree/main/src/shared): Common kernel · Decorators, exceptions, constants, pagination, validation, and injection symbols · `src/shared`
- [JSON-RPC lib](https://github.com/kiyoshi-work/app-server/blob/main/src/shared/libs/json-rpc/json-rpc.module.ts): RPC framework · Custom JSON-RPC server, context, routing, and error mapping · `src/shared/libs/json-rpc/json-rpc.module.ts`
- [Logger](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/logger/logger.module.ts): Observability · Application logging services and helpers · `src/modules/logger/logger.module.ts`
- [Sentry](https://github.com/kiyoshi-work/app-server/blob/main/src/modules/sentry/sentry.module.ts): Error capture · Exception filter and interceptor for telemetry · `src/modules/sentry/sentry.module.ts`

## Connections

- main → app module: boots · Bootstrap creates the application module
- app module → API: imports · Composes REST access layer
- app module → GraphQL: imports · Composes GraphQL access layer
- app module → JSON-RPC: imports · Composes JSON-RPC access layer
- app module → WebSocket: imports · Composes realtime transport
- app module → Telegram bot: imports · Composes bot listener
- app module → AI: imports · Composes AI services
- app module → Blockchain: imports · Composes blockchain services
- app module → Sync contract: imports · Composes contract synchronization pipeline
- app module → Business: imports · Composes workflow services
- app module → Crawler: imports · Composes ingestion services
- app module → Game: imports · Composes game subsystem
- app module → Database: imports · Wires primary persistence
- app module → Timescale DB: imports · Wires time-series persistence
- app module → Redis cache: imports · Wires cache/session layer
- app module → Milvus: imports · Wires vector search store
- app module → Vector store: imports · Wires document retrieval store
- app module → Search: imports · Wires search service
- app module → Firebase: imports · Wires Firestore integration
- app module → Upload file: imports · Wires file storage services
- app module → OneSignal: imports · Wires push delivery client
- app module → Transporter: imports · Wires message transport abstraction
- app module → Queue: imports · Wires queue infrastructure
- app module → Worker: imports · Wires background workers
- app module → Listen socket: imports · Wires external feed listener
- app module → Worker thread: imports · Wires CPU-bound task offload
- API → Shared: uses · Relies on common decorators, exceptions, and validation
- GraphQL → Shared: uses · Shares common auth and response primitives
- JSON-RPC → JSON-RPC lib: uses · Built on custom JSON-RPC framework
- JSON-RPC → Shared: uses · Shares auth and exception contracts
- WebSocket → Redis cache: uses · Uses Redis adapter for horizontal scaling
- Telegram bot → Queue: uses · Defers work through queues
- Telegram bot → Worker: uses · Depends on worker consumers for background flows
- AI → Milvus: uses · Retrieval over vector index
- AI → Vector store: uses · Document retrieval and context storage
- AI → Crawler: uses · Consumes external knowledge sources
- Sync contract → Blockchain: uses · Reads on-chain contracts and events
- Sync contract → Database: writes · Persists normalized chain data
- Business → Database: uses · Reads and updates core business records
- Business → OneSignal: uses · Sends notifications
- Crawler → Shared: uses · Shares DTOs and utilities
- Game → WebSocket: publishes · Exposes game state through realtime channels
- Game → Database: uses · Persists game and battle records
- Database → Shared: uses · Entities and repositories rely on shared constants
- Timescale DB → Shared: uses · Shares common DTOs and config patterns
- Queue → Transporter: uses · Backed by transport layer for async messaging
- Worker → Queue: consumes · Worker processes queued jobs
- Worker → Database: uses · Reads and writes persisted state
