# rusik636/tigro architecture

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

- Interactive diagram: https://gitdiagram.com/rusik636/tigro
- Repository: https://github.com/rusik636/tigro

## Overview

Tigro is a Python microservice framework for Telegram bots. Its principal workflow converts Telegram messages or callbacks into correlated events, routes them to service handlers, collects response commands, and returns responses through RabbitMQ for the gateway to render and send. The graph also includes module composition, handler discovery/decorators, keyboard construction and rendering, and middleware extension points. The README documents service-side event handling, but the sampled sources do not show its broker consumer or complete runtime wiring; those links are documented rather than source-verified.

Main entry points: [`tigro/core.py`](https://github.com/rusik636/tigro/blob/main/tigro/core.py) (Event router), [`tigro/gateway/aiogram_gateway.py`](https://github.com/rusik636/tigro/blob/main/tigro/gateway/aiogram_gateway.py) (Aiogram gateway), [`tigro/gateway/rpc.py`](https://github.com/rusik636/tigro/blob/main/tigro/gateway/rpc.py) (RPC client), [`tigro/transport/rabbit_bus.py`](https://github.com/rusik636/tigro/blob/main/tigro/transport/rabbit_bus.py) (Rabbit publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["Telegram gateway"]
  node_gateway_app["Aiogram gateway<br/>[aiogram_gateway.py]"]
end

subgraph group_messaging["Broker messaging"]
  node_rpc["RPC client<br/>[rpc.py]"]
  node_rabbit["RabbitMQ"]
  node_publisher["Rabbit publisher<br/>[rabbit_bus.py]"]
  node_event_schema["Event and response schemas<br/>[schemas.py]"]
  node_shared_schema["Shared response schema<br/>[schemas.py]"]
end

subgraph group_handlers["Service handlers"]
  node_router["Event router<br/>[core.py]"]
  node_matchers["Event matchers<br/>[matchers.py]"]
  node_decorators["Handler decorators<br/>[decorators.py]"]
  node_discovery["Handler discovery<br/>[discovery.py]"]
  node_modules["Module routers<br/>[modules.py]"]
  node_contracts["Extension contracts<br/>[contracts.py]"]
end

subgraph group_responses["Responses and UI"]
  node_context["Handler context<br/>[core.py]"]
  node_renderer["Aiogram renderer<br/>[__init__.py]"]
  node_keyboard["Keyboard DSL<br/>[keyboard.py]"]
end

node_user(("Telegram user"))
node_telegram{{"Telegram API"}}

node_user -->|"sends update"| node_telegram
node_telegram -->|"delivers update"| node_gateway_app
node_gateway_app -->|"calls RPC"| node_rpc
node_rpc -->|"publishes event"| node_rabbit
node_rpc -->|"subscribes responses"| node_rabbit
node_rabbit -.->|"delivers event"| node_router
node_router -->|"matches routes"| node_matchers
node_decorators -->|"registers matchers"| node_matchers
node_discovery -->|"registers handlers"| node_router
node_modules -->|"combines routes"| node_router
node_router -->|"creates context"| node_context
node_router -->|"dispatches responses"| node_publisher
node_publisher -->|"publishes response"| node_rabbit
node_context -->|"forms responses"| node_event_schema
node_contracts -->|"defines interfaces"| node_router
node_gateway_app -->|"builds events"| node_event_schema
node_gateway_app -->|"renders markup"| node_renderer
node_renderer -->|"builds Telegram markup"| node_telegram
node_keyboard -.->|"provides markup"| node_renderer
node_gateway_app -->|"sends response"| node_telegram
node_shared_schema -->|"types responses"| node_publisher

click node_gateway_app "https://github.com/rusik636/tigro/blob/main/tigro/gateway/aiogram_gateway.py"
click node_rpc "https://github.com/rusik636/tigro/blob/main/tigro/gateway/rpc.py"
click node_publisher "https://github.com/rusik636/tigro/blob/main/tigro/transport/rabbit_bus.py"
click node_event_schema "https://github.com/rusik636/tigro/blob/main/tigro/schemas.py"
click node_router "https://github.com/rusik636/tigro/blob/main/tigro/core.py"
click node_matchers "https://github.com/rusik636/tigro/blob/main/tigro/matchers.py"
click node_decorators "https://github.com/rusik636/tigro/blob/main/tigro/decorators.py"
click node_discovery "https://github.com/rusik636/tigro/blob/main/tigro/discovery.py"
click node_modules "https://github.com/rusik636/tigro/blob/main/tigro/modules.py"
click node_contracts "https://github.com/rusik636/tigro/blob/main/tigro/contracts.py"
click node_context "https://github.com/rusik636/tigro/blob/main/tigro/core.py"
click node_renderer "https://github.com/rusik636/tigro/blob/main/tigro/renderers/__init__.py"
click node_keyboard "https://github.com/rusik636/tigro/blob/main/tigro/keyboard.py"
click node_shared_schema "https://github.com/rusik636/tigro/blob/main/shared/schemas.py"

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_gateway_app,node_user toneBlue
class node_rpc,node_rabbit,node_publisher,node_event_schema,node_shared_schema toneAmber
class node_router,node_matchers,node_decorators,node_discovery,node_modules,node_contracts,node_telegram toneMint
class node_context,node_renderer,node_keyboard toneRose
```

## Components

### Telegram gateway

- [Aiogram gateway](https://github.com/rusik636/tigro/blob/main/tigro/gateway/aiogram_gateway.py): `tigro/gateway/aiogram_gateway.py`

### Broker messaging

- [RPC client](https://github.com/rusik636/tigro/blob/main/tigro/gateway/rpc.py): `tigro/gateway/rpc.py`
- **RabbitMQ**
- [Rabbit publisher](https://github.com/rusik636/tigro/blob/main/tigro/transport/rabbit_bus.py): `tigro/transport/rabbit_bus.py`
- [Event and response schemas](https://github.com/rusik636/tigro/blob/main/tigro/schemas.py): `tigro/schemas.py`
- [Shared response schema](https://github.com/rusik636/tigro/blob/main/shared/schemas.py): `shared/schemas.py`

### Service handlers

- [Event router](https://github.com/rusik636/tigro/blob/main/tigro/core.py): `tigro/core.py`
- [Event matchers](https://github.com/rusik636/tigro/blob/main/tigro/matchers.py): `tigro/matchers.py`
- [Handler decorators](https://github.com/rusik636/tigro/blob/main/tigro/decorators.py): `tigro/decorators.py`
- [Handler discovery](https://github.com/rusik636/tigro/blob/main/tigro/discovery.py): `tigro/discovery.py`
- [Module routers](https://github.com/rusik636/tigro/blob/main/tigro/modules.py): `tigro/modules.py`
- [Extension contracts](https://github.com/rusik636/tigro/blob/main/tigro/contracts.py): `tigro/contracts.py`

### Responses and UI

- [Handler context](https://github.com/rusik636/tigro/blob/main/tigro/core.py): `tigro/core.py`
- [Aiogram renderer](https://github.com/rusik636/tigro/blob/main/tigro/renderers/__init__.py): `tigro/renderers/__init__.py`
- [Keyboard DSL](https://github.com/rusik636/tigro/blob/main/tigro/keyboard.py): `tigro/keyboard.py`

### Other components

- **Telegram user**
- **Telegram API**

## Connections

- Telegram user → Telegram API: sends update (evidence: `README.md`)
- Telegram API → Aiogram gateway: delivers update (evidence: `README.md`)
- Aiogram gateway → RPC client: calls RPC (evidence: `tigro/gateway/aiogram_gateway.py`)
- RPC client → RabbitMQ: publishes event (evidence: `tigro/gateway/rpc.py`)
- RPC client → RabbitMQ: subscribes responses (evidence: `tigro/gateway/rpc.py`)
- RabbitMQ → Event router: delivers event (evidence: `README.md`)
- Event router → Event matchers: matches routes (evidence: `tigro/core.py`)
- Handler decorators → Event matchers: registers matchers (evidence: `tigro/decorators.py`)
- Handler discovery → Event router: registers handlers (evidence: `tigro/discovery.py`)
- Module routers → Event router: combines routes (evidence: `tigro/modules.py`)
- Event router → Handler context: creates context (evidence: `tigro/core.py`)
- Event router → Rabbit publisher: dispatches responses (evidence: `tigro/core.py`)
- Rabbit publisher → RabbitMQ: publishes response (evidence: `tigro/transport/rabbit_bus.py`)
- Handler context → Event and response schemas: forms responses (evidence: `tigro/core.py`)
- Extension contracts → Event router: defines interfaces (evidence: `tigro/core.py`)
- Aiogram gateway → Event and response schemas: builds events (evidence: `tigro/gateway/aiogram_gateway.py`)
- Aiogram gateway → Aiogram renderer: renders markup (evidence: `tigro/gateway/aiogram_gateway.py`)
- Aiogram renderer → Telegram API: builds Telegram markup (evidence: `tigro/renderers/__init__.py`)
- Keyboard DSL → Aiogram renderer: provides markup (evidence: `README.md`)
- Aiogram gateway → Telegram API: sends response (evidence: `tigro/gateway/aiogram_gateway.py`)
- Shared response schema → Rabbit publisher: types responses (evidence: `tigro/transport/rabbit_bus.py`)
