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

View file

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

View file

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