feat(auth): 邮箱验证码注册,生产重新有了自助入口
CI / backend (push) Canceled after 0s

短信登录关掉后,生产没有任何注册入口——这一版补上最普通的那条路:
填邮箱、收验证码、设密码,注册完直接进首页。

先发码再注册,不是"注册时顺带发信"

  POST /auth/email/code 只做三件事:查重、限流、发码。
  填完密码才被告知"这个邮箱注册过了"最气人,所以占用(2019)在发码前就回。

邮箱既是账号名也是唯一联系方式,所以必须真验一次码

  验证通过时间落 app_user.email_verified_at,/auth/me 回 email_verified。
  "随手填一个"会让账号变成没人能找回的孤岛。

app_user.phone 改为可空(迁移 0011)

  邮箱注册的账号本来就没有手机号。user.phone 对这类账号回空串,
  成员列表同理,不再伪装成一串星号。

防刷

  同邮箱 60 秒一次(2022)、验证码 10 分钟有效、错 5 次即作废(2021)。
  6 位数可以被刮,不设上限等于把注册口子交给脚本。

本机联调开关 EMAIL_CODE_DEV_ECHO

  为 true 时把码回给调用方且不发真信——否则每跑一次 e2e 就往真实收件箱塞一封。
  生产打开会让 validate_runtime() 拒绝启动。

前端

  新增 /register(邮箱、验证码、密码、确认、昵称;60 秒倒计时;
  服务端关着注册时整页只说"联系管理员开通"),登录页按 /auth/methods
  决定要不要显示「还没有账号?用邮箱注册」。

验证

  pytest 139 passed、ruff check / format 全绿
  tsc --noEmit 0、vite build 通过
  e2e register.mjs 7 项:登录页入口 → 拿码 → 注册落进首页 → 退出用邮箱+密码登回来
    → 同一邮箱再发码回 2019 → 控制台零报错
  e2e login-email-smtp.mjs 15 项回归通过(含真发一封测试信)
  e2e account.mjs 14 项、knowledge.mjs 全绿

顺带修的两处测试

  test_account 的字段白名单补 email_verified(接口确实多了这个字段);
  test_config_prod 用 Settings(_env_file=None, ...) 构造,别被本机 .env 里的
  EMAIL_CODE_DEV_ECHO=true 带偏——那个开关在生产是硬错误,本机却是跑 e2e 必需的。
This commit is contained in:
Steven
2026-11-03 01:04:26 +08:00
parent c0c5230fd1
commit b5170ad1ce
20 changed files with 955 additions and 16 deletions
@@ -0,0 +1,41 @@
"""app_user 支持邮箱注册:放开 phone 非空、记录邮箱已验证时间
手机验证码登录关掉以后,新用户是「邮箱 + 验证码」注册进来的,此时还没有手机号;
`app_user.phone` 原来 NOT NULL,不放开就没法插这类账号。
`email_verified_at` 用来区分"填了个邮箱字符串"和"这个地址确实验证过":
注册流程发码成功后写入;账号页手工绑邮箱时同一套流程。
Revision ID: 0011
Revises: 0010
"""
from __future__ import annotations
from alembic import op
from app.roles import APP_ROLE
revision = "0011"
down_revision = "0010"
branch_labels = None
depends_on = None
def upgrade() -> None:
# 邮箱注册的账号没有手机号:老账号都有值,放开非空不影响它们
op.execute("ALTER TABLE app_user ALTER COLUMN phone DROP NOT NULL")
op.execute("ALTER TABLE app_user ADD COLUMN IF NOT EXISTS email_verified_at TIMESTAMPTZ")
op.execute(
"COMMENT ON COLUMN app_user.email_verified_at IS "
"'邮箱验证通过的时间;为空表示还没验证过这个地址'"
)
# 本表全局(不挂租户),只补列不新增表,权限照旧:应用角色要能读写这些列
op.execute(f"GRANT SELECT, UPDATE ON app_user TO {APP_ROLE}")
def downgrade() -> None:
# 回滚前先把没有手机号的账号补上占位值,否则加回 NOT NULL 会失败
op.execute("UPDATE app_user SET phone = 'redeem-' || replace(id::text, '-', '') WHERE phone IS NULL")
op.execute("ALTER TABLE app_user DROP COLUMN IF EXISTS email_verified_at")
op.execute("ALTER TABLE app_user ALTER COLUMN phone SET NOT NULL")