docs

src/error.rs

@@ -1,3 +1,9 @@
+//! Единый тип ошибки приложения. `AppError` реализует `IntoResponse`, поэтому любой
+//! контроллер может просто возвращать `Result<T, AppError>` — маппинг в HTTP-статус,
+//! безопасное для клиента сообщение и структурированный лог/метрику делает `into_response`.
+//! Правило: детали (SQL-ошибки, внутренние сообщения) уходят только в логи, наружу — общие
+//! формулировки, чтобы не раскрывать внутреннее устройство системы атакующему.
+
 use axum::{
     http::StatusCode,
     response::{IntoResponse, Response},