Шхуна не тонет: security, infra и доки на русском.

Безопасность довёл до ума — Cursor-генерацию переписал руками.
IDOR закрыл, CSRF задушил, refresh rotation теперь как надо.
HSTS на staging, ENABLE_DOCS=false, install.env recovery протестил.

Backend:
- jwt_denylist + auth_epoch: мгновенный revoke access JWT (logout/block/reset)
- auth/admin/users: bump epoch, logout с Bearer, forgot_password skip для blocked
- install_secrets: путь всегда apps/api/data/secrets/ (bootstrap из корня не ломает Docker)
- seed: SEED_DEMO_USERS=false на prod/staging
- тесты: jwt revoke, integration, coverage gate 90%

Frontend:
- logout шлёт Bearer, обработка TOKEN_REVOKED
- guards TypeScript fix
- E2E: blocked user → 401 сразу после block

Infra:
- staging/prod compose, TLS nginx, deploy-скрипты
- k6 §17.2, backup/health/smoke scripts

Docs:
- docs/ на русском: project, security, deploy, release (старые md слили)
- README короткий + план ТЗ + стандартные логины dev

Код готов к плаванию. Капитан может идти писать фронт.

apps/api/app/modules/auth/router.py

@@ -1,7 +1,8 @@
-from app.core.datetime_utils import ensure_utc, utc_now
-from fastapi import APIRouter, HTTPException, Request, Response, status
+from fastapi import APIRouter, Depends, HTTPException, Request, Response, status
+from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
 
 from app.core.config import settings
+from app.core.datetime_utils import ensure_utc, utc_now
 from app.core.redis import check_rate_limit, client_ip
 from app.modules.auth.schemas import (
     ForgotPasswordIn,
@@ -15,16 +16,17 @@ from app.modules.auth.schemas import (
 from app.modules.auth.service import (
     forgot_password,
     login,
+    logout,
     refresh,
     register,
     resend_verification,
     reset_password,
-    revoke_refresh_token,
     verify_email_token,
 )
 from app.modules.users import repository
 
 router = APIRouter()
+optional_bearer = HTTPBearer(auto_error=False)
 
 
 def _allowed_origins() -> set[str]:
@@ -139,7 +141,12 @@ async def refresh_route(request: Request, response: Response):
     check_rate_limit(f"refresh:{client_ip(request)}", limit=30, window_seconds=60)
     try:
         access_token, new_refresh, user = refresh(refresh_token)
-    except PermissionError:
+    except PermissionError as exc:
+        detail = str(exc)
+        if detail == "EMAIL_NOT_VERIFIED":
+            raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="EMAIL_NOT_VERIFIED")
+        if detail == "ACCOUNT_BLOCKED":
+            raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="ACCOUNT_BLOCKED")
         raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="INVALID_REFRESH")
     _set_refresh_cookie(response, new_refresh)
     return {
@@ -156,11 +163,15 @@ async def refresh_route(request: Request, response: Response):
 
 
 @router.post("/logout")
-async def logout_route(request: Request, response: Response):
+async def logout_route(
+    request: Request,
+    response: Response,
+    credentials: HTTPAuthorizationCredentials | None = Depends(optional_bearer),
+):
     _enforce_origin(request, require_header=True)
     refresh_token = request.cookies.get("refresh_token")
-    if refresh_token:
-        revoke_refresh_token(refresh_token)
+    access_token = credentials.credentials if credentials else None
+    logout(refresh_token, access_token)
     response.delete_cookie(
         "refresh_token",
         path="/api/v1/auth",