Задача 037: двухфакторная аутентификация TOTP по выбору пользователя

Пользователь сам включает TOTP (QR, приложение-аутентификатор); 10 одноразовых кодов
восстановления; superadmin сбрасывает 2FA другому пользователю. Вход в два шага:
/auth/login → mfa_token, /auth/login/2fa — под теми же лимитами и advisory-lock, что пароль.
Секрет шифруется Fernet-ключом TOTP_ENC_KEY, защита от повторного использования кода
(totp_last_step), лимиты перебора кода при отключении. Миграция 0015, зависимости pyotp,
segno, cryptography. UI: второй шаг входа, диалоги 2FA в меню логина, бейдж и сброс
в «Пользователях»; submitDialog не закрывает окно, открытое следующим шагом цепочки.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

app/models.py

@@ -151,6 +151,15 @@ class User(Base):
     password_changed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))  # токены с iat раньше — недействительны
     last_login_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))  # изменение 035: время последнего успешного входа
     last_login_ip: Mapped[str | None] = mapped_column(INET)  # изменение 035: IP последнего успешного входа
+    # изменение 037: двухфакторная аутентификация TOTP, по выбору пользователя
+    totp_secret_enc: Mapped[str | None] = mapped_column(Text)  # зашифрованный (Fernet, TOTP_ENC_KEY) подтверждённый секрет
+    totp_pending_enc: Mapped[str | None] = mapped_column(Text)  # секрет на время настройки, до подтверждения кодом
+    totp_enabled_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))  # NULL — 2FA выключена
+    totp_last_step: Mapped[int | None] = mapped_column(BigInteger)  # защита от повторного использования кода: шаг должен строго возрастать
+
+    @property
+    def totp_enabled(self) -> bool:  # изменение 037: вычисляемое поле для UserOut (from_attributes читает его как обычный атрибут)
+        return self.totp_enabled_at is not None
 
 
 Index("uq_users_lower_username", func.lower(User.username), unique=True)  # логин уникален без учёта регистра
@@ -207,3 +216,13 @@ class ClearAttempt(Base):
     id: Mapped[int] = mapped_column(primary_key=True)
     user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="CASCADE"), index=True)
     ts: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+
+
+class RecoveryCode(Base):
+    """Коды восстановления 2FA (изменение 037): выдаются 10 штук при включении, каждый гасится один раз.
+    Хэш — sha256 (не argon2): код высокоэнтропийный (10 символов base32), медленный хэш не нужен."""
+    __tablename__ = "recovery_codes"
+    id: Mapped[int] = mapped_column(primary_key=True)
+    user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="CASCADE"), index=True)
+    code_hash: Mapped[str] = mapped_column(String(64))
+    used_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))