(refactor) switched comments to right

This commit is contained in:
Rorik Star Platinum 2025-11-05 21:48:35 +03:00
parent 756dd0a7fb
commit da3dfe40b0
4 changed files with 40 additions and 40 deletions

View file

@ -1,21 +1,21 @@
// src/db.rs // src/db.rs
// Почему это здесь? // Почему это здесь?
// - Это всё, связанное с инициализацией и конфигурацией базы данных // - Это всё, связанное с инициализацией и конфигурацией базы данных
// - Здесь создаётся connection pool, который переиспользуется во всём приложении // - Здесь создаётся connection pool, который переиспользуется во всём приложении
use sqlx::postgres::PgPoolOptions; use sqlx::postgres::PgPoolOptions;
use sqlx::PgPool; use sqlx::PgPool;
use std::env; use std::env;
/// Инициализирует PgPool (connection pool для PostgreSQL) /// Инициализирует PgPool (connection pool для PostgreSQL)
/// ///
/// Connection pool — это набор переиспользуемых соединений к БД. /// Connection pool — это набор переиспользуемых соединений к БД.
/// Вместо того, чтобы открывать новое соединение для каждого запроса, /// Вместо того, чтобы открывать новое соединение для каждого запроса,
/// мы берём готовое соединение из пула. /// мы берём готовое соединение из пула.
/// ///
/// Это **критически важно** для производительности: /// Это **критически важно** для производительности:
/// - Открытие соединения — медленная операция /// - Открытие соединения — медленная операция
/// - Connection pool решает эту проблему /// - Connection pool решает эту проблему
pub async fn init_pool() -> PgPool { pub async fn init_pool() -> PgPool {
let database_url = env::var("DATABASE_URL") let database_url = env::var("DATABASE_URL")
.expect("DATABASE_URL must be set"); .expect("DATABASE_URL must be set");

View file

@ -1,16 +1,16 @@
// src/route.rs // src/route.rs
// Почему это здесь? // Почему это здесь?
// - Это центр управления всеми HTTP маршрутами (роутами) // - Это центр управления всеми HTTP маршрутами (роутами)
// - Здесь объявляются все подмодули (handlers, будущие сервисы и т.д.) // - Здесь объявляются все подмодули (handlers, будущие сервисы и т.д.)
// - Здесь собирается финальный Router для Axum // - Здесь собирается финальный Router для Axum
pub mod handlers; // Объявляем подмодуль handlers pub mod handlers; // Объявляем подмодуль handlers
use axum::{routing::get, Router}; use axum::{routing::get, Router};
use crate::state::AppState; use crate::state::AppState;
/// Создаёт и возвращает Router со всеми сконфигурированными роутами /// Создаёт и возвращает Router со всеми сконфигурированными роутами
/// Функция принимает AppState и передаёт его всем handlers'ам /// Функция принимает AppState и передаёт его всем handlers'ам
pub fn router(app_state: AppState) -> Router { pub fn router(app_state: AppState) -> Router {
Router::new() Router::new()
// GET /api/health — health-check эндпоинт // GET /api/health — health-check эндпоинт

View file

@ -1,7 +1,7 @@
// src/route/handlers.rs // src/route/handlers.rs
// Почему это здесь? // Почему это здесь?
// - Это всё, что обрабатывает HTTP запросы // - Это всё, что обрабатывает HTTP запросы
// - Каждый handler'а — это async функция, которая обрабатывает запрос и возвращает ответ // - Каждый handler'а — это async функция, которая обрабатывает запрос и возвращает ответ
use axum::{ use axum::{
extract::State, extract::State,
@ -12,12 +12,12 @@ use axum::{
use serde_json::json; use serde_json::json;
use crate::state::AppState; use crate::state::AppState;
/// Health-check handler /// Health-check handler
/// ///
/// Что он делает: /// Что он делает:
/// 1. Принимает AppState через extract::State (это параметр, который Axum инжектирует) /// 1. Принимает AppState через extract::State (это параметр, который Axum инжектирует)
/// 2. Пытается выполнить простой SELECT 1 в БД (проверка подключения) /// 2. Пытается выполнить простой SELECT 1 в БД (проверка подключения)
/// 3. Возвращает 200 OK если всё хорошо, или 500 если БД недоступна /// 3. Возвращает 200 OK если всё хорошо, или 500 если БД недоступна
pub async fn health_handler( pub async fn health_handler(
State(state): State<AppState>, State(state): State<AppState>,
) -> impl IntoResponse { ) -> impl IntoResponse {