# devgardencc/reg_service__back architecture

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

- Interactive diagram: https://gitdiagram.com/devgardencc/reg_service__back
- Repository: https://github.com/devgardencc/reg_service__back

## Overview

This is a FastAPI registration service. A client submits registration details; the API validates them, writes a timestamped row to Google Sheets, then schedules a Telegram notification rendered from a Jinja template. It also exposes a health check. Configuration supplies the sheet, Telegram and hosting settings. The graph reflects the inspected route and service code; no database beyond Google Sheets or additional workflow stages are evidenced.

Main entry points: [`main.py`](https://github.com/devgardencc/reg_service__back/blob/main/main.py) (FastAPI routes), [`app/service.py`](https://github.com/devgardencc/reg_service__back/blob/main/app/service.py) (Sheets service), [`app/logger.py`](https://github.com/devgardencc/reg_service__back/blob/main/app/logger.py) (Logger), [`app/scheme.py`](https://github.com/devgardencc/reg_service__back/blob/main/app/scheme.py) (Request schemas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_api["FastAPI routes<br/>[main.py]"]
  node_schemas["Request schemas<br/>[scheme.py]"]
  node_template["Telegram template<br/>[telegram_msg.j2]"]
end

subgraph group_integrations["Integrations"]
  node_sheets_service["Sheets service<br/>[service.py]"]
  node_telegram_service["Telegram service<br/>[service.py]"]
end

subgraph group_support["Support"]
  node_settings["Settings<br/>[config.py]"]
  node_logger["Logger<br/>[logger.py]"]
end

node_client(("Registration client"))
node_google_sheets[("Google Sheets")]
node_telegram["Telegram API"]

node_client -->|"submits registration"| node_api
node_client -->|"checks health"| node_api
node_api -->|"validates and responds"| node_schemas
node_api -->|"reads settings"| node_settings
node_api -->|"appends row"| node_sheets_service
node_sheets_service -->|"writes row"| node_google_sheets
node_api -->|"renders message"| node_template
node_api -->|"schedules notification"| node_telegram_service
node_telegram_service -->|"sends message"| node_telegram
node_api -->|"logs events"| node_logger
node_sheets_service -->|"logs errors"| node_logger
node_telegram_service -->|"logs outcomes"| node_logger

click node_api "https://github.com/devgardencc/reg_service__back/blob/main/main.py"
click node_schemas "https://github.com/devgardencc/reg_service__back/blob/main/app/scheme.py"
click node_template "https://github.com/devgardencc/reg_service__back/blob/main/app/templates/telegram_msg.j2"
click node_settings "https://github.com/devgardencc/reg_service__back/blob/main/app/config.py"
click node_logger "https://github.com/devgardencc/reg_service__back/blob/main/app/logger.py"
click node_sheets_service "https://github.com/devgardencc/reg_service__back/blob/main/app/service.py"
click node_telegram_service "https://github.com/devgardencc/reg_service__back/blob/main/app/service.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_api,node_schemas,node_template,node_client toneBlue
class node_sheets_service,node_telegram_service,node_google_sheets toneAmber
class node_settings,node_logger,node_telegram toneMint
```

## Components

### API

- [FastAPI routes](https://github.com/devgardencc/reg_service__back/blob/main/main.py): `main.py`
- [Request schemas](https://github.com/devgardencc/reg_service__back/blob/main/app/scheme.py): `app/scheme.py`
- [Telegram template](https://github.com/devgardencc/reg_service__back/blob/main/app/templates/telegram_msg.j2): `app/templates/telegram_msg.j2`

### Integrations

- [Sheets service](https://github.com/devgardencc/reg_service__back/blob/main/app/service.py): `app/service.py`
- [Telegram service](https://github.com/devgardencc/reg_service__back/blob/main/app/service.py): `app/service.py`

### Support

- [Settings](https://github.com/devgardencc/reg_service__back/blob/main/app/config.py): `app/config.py`
- [Logger](https://github.com/devgardencc/reg_service__back/blob/main/app/logger.py): `app/logger.py`

### Other components

- **Registration client**
- **Google Sheets**
- **Telegram API**

## Connections

- Registration client → FastAPI routes: submits registration (evidence: `main.py`)
- Registration client → FastAPI routes: checks health (evidence: `main.py`)
- FastAPI routes → Request schemas: validates and responds (evidence: `main.py`)
- FastAPI routes → Settings: reads settings (evidence: `main.py`)
- FastAPI routes → Sheets service: appends row (evidence: `main.py`)
- Sheets service → Google Sheets: writes row (evidence: `app/service.py`)
- FastAPI routes → Telegram template: renders message (evidence: `main.py`)
- FastAPI routes → Telegram service: schedules notification (evidence: `main.py`)
- Telegram service → Telegram API: sends message (evidence: `app/service.py`)
- FastAPI routes → Logger: logs events (evidence: `main.py`)
- Sheets service → Logger: logs errors (evidence: `app/service.py`)
- Telegram service → Logger: logs outcomes (evidence: `app/service.py`)
