"""Engine и фабрика сессий SQLAlchemy. Живёт рядом с config.py, но отдельно: Settings только описывает параметры, а создание ресурсов (engine, пул) — здесь, чтобы тесты могли подменять Settings. """ import logging from sqlalchemy import Engine, create_engine, text from sqlalchemy.exc import SQLAlchemyError from sqlalchemy.orm import Session, sessionmaker from app.core.config import Settings logger = logging.getLogger(__name__) def create_db_engine(settings: Settings) -> Engine: """Создаёт engine с ограниченным пулом и таймаутами. create_engine ленивый: подключение к БД происходит при первом запросе, поэтому приложение стартует и без доступной БД (ready вернёт 503). """ return create_engine( settings.get_database_url(), pool_size=settings.db_pool_size, max_overflow=settings.db_max_overflow, pool_timeout=settings.db_pool_timeout_seconds, pool_pre_ping=True, connect_args={ "connect_timeout": settings.db_connect_timeout_seconds, "options": f"-c statement_timeout={settings.db_statement_timeout_ms}", }, ) def create_session_factory(engine: Engine) -> sessionmaker[Session]: """Фабрика сессий: одна сессия на HTTP-запрос (см. endpoints/dependencies.py). expire_on_commit=False — после commit объекты остаются читаемыми, и domain может собрать ответ без повторного SELECT. autoflush=False — flush вызываем явно, поведение предсказуемо. """ return sessionmaker(bind=engine, expire_on_commit=False, autoflush=False) def check_database(engine: Engine) -> bool: """True, если БД отвечает на SELECT 1. Используется в /health/ready.""" try: with engine.connect() as connection: connection.execute(text("SELECT 1")) except SQLAlchemyError: logger.warning("database readiness check failed", exc_info=True) return False return True