Шхуна не тонет: 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",

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

@@ -6,6 +6,7 @@ from uuid import uuid4
 from app.core.config import settings
 from app.core.datetime_utils import ensure_utc, utc_now
 from app.core.email import send_template_email
+from app.core.jwt_denylist import bump_auth_epoch, revoke_access_token
 from app.core.security import (
     create_access_token,
     generate_opaque_token,
@@ -111,7 +112,7 @@ def resend_verification(email: str) -> None:
 
 def forgot_password(email: str) -> None:
     user = repository.get_user_by_email(email)
-    if not user:
+    if not user or user.status == "blocked":
         return
     token = _issue_password_reset_token(user.id)
     _send_password_reset_email(user, token)
@@ -132,6 +133,7 @@ def reset_password(token: str, new_password: str) -> None:
     user.password_hash = hash_password(new_password)
     repository.update_user(user)
     auth_repository.mark_password_reset_token_used(token_hash)
+    bump_auth_epoch(user.id)
     revoke_user_refresh_family(user.id)
 
 
@@ -199,18 +201,21 @@ def refresh(refresh_token: str) -> tuple[str, str, User]:
     token_row = auth_repository.get_refresh_token(token_hash)
     if not token_row:
         raise PermissionError("INVALID_REFRESH")
+
+    user = repository.get_user_by_id(token_row.user_id)
+    if not user:
+        raise PermissionError("INVALID_REFRESH")
+    if user.status == "pending":
+        raise PermissionError("EMAIL_NOT_VERIFIED")
+    if user.status == "blocked":
+        raise PermissionError("ACCOUNT_BLOCKED")
+
     if token_row.revoked_at is not None:
         auth_repository.revoke_family_tokens(token_row.family_id)
         raise PermissionError("INVALID_REFRESH")
     if ensure_utc(token_row.expires_at) < utc_now():
         raise PermissionError("EXPIRED_REFRESH")
 
-    user = repository.get_user_by_id(token_row.user_id)
-    if not user:
-        raise PermissionError("INVALID_REFRESH")
-    if user.status in {"pending", "blocked"}:
-        raise PermissionError("INVALID_REFRESH")
-
     auth_repository.revoke_refresh_token(token_hash)
     new_refresh = issue_refresh_token(user.id, family_id=token_row.family_id)
     access = create_access_token(user.id, user.role, user.is_superuser)
@@ -224,5 +229,12 @@ def revoke_refresh_token(refresh_token: str) -> None:
         auth_repository.revoke_family_tokens(token_row.family_id)
 
 
+def logout(refresh_token: str | None, access_token: str | None) -> None:
+    if access_token:
+        revoke_access_token(access_token)
+    if refresh_token:
+        revoke_refresh_token(refresh_token)
+
+
 def revoke_user_refresh_family(user_id: str) -> None:
     auth_repository.revoke_user_families(user_id)