🌊 Волна 17: backend #8 — баги + N+1 (16 багов)

Продуктовые:
- hint_consumed_before_word_check: сначала проверка слов, потом инкремент (hints.py)
- hint_fake_first_cell: 404 вместо [0,0] (hints.py)
- leaderboard_rank_wrong_for_uncached_user: корректный rank (leaderboard.py)
- teacher_ai_explanation_empty_on_failure: fallback-текст (teacher.py)

Данные:
- duplicate_delete_keeps_wrong_row: оставляем лучшую строку (database.py)

Security:
- fastapi_docs_exposed: /docs скрыт в проде (main.py)
- cf_ip_check_per_request: предкомпиляция CF_IPS (main.py)

N+1:
- admin_content_lesson_levels_n_plus_1: 3 GROUP BY (admin_content.py)
- admin_content_lesson_topics_n_plus_1: 2 GROUP BY (admin_content.py)
- admin_content_get_lesson_n_plus_1: ANY + группировка (admin_content.py)
- teacher_progress_n_plus_1: 2 GROUP BY (teacher.py)
- teacher_diagnostic_test_n_plus_1: ANY + группировка (teacher.py)
- orchestrator_n_plus_1_options: ANY + группировка (orchestrator.py)

Качество:
- cleanup_task_leak_on_startup_failure: cleanup после init (main.py)
- unused_first_name: удалена мёртвая переменная (auth.py)

Пропущено осознанно:
- initdata_in_query_param (fallback deleteFeedPost)
- init_db_slow_startup (Alembic, отдельная задача)

Аудит v5: Issue #8, backend 16/17 задач
This commit is contained in:
2026-09-24 17:35:14 +00:00
parent f655a44a84
commit 3d75a00046
8 changed files with 272 additions and 131 deletions
+30 -15
View File
@@ -126,23 +126,25 @@ class RateLimiter:
rate_limiter = RateLimiter()
# 🔧 ФИКС (24.09.2026): cf_connecting_ip_spoof —
# проверяем, что IP клиента входит в список Cloudflare.
# 🔧 ФИКС (25.09.2026): cf_ip_check_per_request —
# компилируем CF_IPS один раз при старте, а не парсим 22 CIDR на каждый запрос.
_CF_NETWORKS = []
for _cidr in CF_IPS:
try:
_CF_NETWORKS.append(ipaddress.ip_network(_cidr, strict=False))
except ValueError:
logger.warning(f"Invalid CF_IPS entry skipped: {_cidr}")
def _is_cloudflare_ip(ip_str: str) -> bool:
"""Проверяет, что IP входит в CF_IPS (Cloudflare)."""
"""Проверяет, что IP входит в предкомпилированные сети Cloudflare."""
if not ip_str:
return False
try:
ip = ipaddress.ip_address(ip_str)
except ValueError:
return False
for cidr in CF_IPS:
try:
if ip in ipaddress.ip_network(cidr, strict=False):
return True
except ValueError:
continue
return False
return any(ip in net for net in _CF_NETWORKS)
# ============ Фоновое обновление кэша рейтинга ============
@@ -171,10 +173,9 @@ async def lifespan(app: FastAPI):
await init_achievements()
await init_learning_data()
# 🔧 ФИКС (24.09.2026): cleanup_task_not_cancelled —
# сохраняем ссылку и отменяем в shutdown.
cleanup_task = asyncio.create_task(rate_limiter.start_cleanup())
# 🔧 ФИКС (25.09.2026): cleanup_task_leak_on_startup_failure —
# создаём cleanup_task ПОСЛЕ успешной инициализации БД и matview.
# Если что-то упадёт до этого — задача не создастся, утечки не будет.
from database import get_pool
pool = await get_pool()
async with pool.acquire() as conn:
@@ -227,6 +228,9 @@ async def lifespan(app: FastAPI):
logger.info("Leaderboard cache created")
refresh_task = asyncio.create_task(refresh_leaderboard_cache_loop())
# 🔧 ФИКС (25.09.2026): cleanup_task_leak_on_startup_failure —
# создаём cleanup_task только после успешной инициализации.
cleanup_task = asyncio.create_task(rate_limiter.start_cleanup())
logger.info(f"Filwords API v{APP_VERSION} started")
@@ -251,7 +255,18 @@ async def lifespan(app: FastAPI):
logger.info(f"Filwords API v{APP_VERSION} stopped")
app = FastAPI(title="Filwords PL API", lifespan=lifespan)
# 🔧 ФИКС (25.09.2026): fastapi_docs_exposed —
# в проде скрываем /docs, /redoc, /openapi.json.
_ENV = os.getenv("ENV", "production")
_is_prod = _ENV == "production"
app = FastAPI(
title="Filwords PL API",
lifespan=lifespan,
docs_url=None if _is_prod else "/docs",
redoc_url=None if _is_prod else "/redoc",
openapi_url=None if _is_prod else "/openapi.json",
)
# ============ Rate Limiting Middleware ============