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