来源:
AGENTS.md(统一认证、公开路径)、API_REFERENCE.md(/api/auth/*、/api/articles/*部分公开、/api/media/upload公开)、黑盒方案 T-01~T-05。 关联用例:test-cases/guest.md(TC-G-01~TC-G-05)。
用户故事:作为还没注册的访客,我想一打开就能看到产品价值并找到登录入口,以便我决定是否注册。
wechat.test-mode 可开。splash / home 引流页。JwtInterceptor 拦截 /api/**(仅 8 个公开路径除外);游客不应看到业务数据。用户故事:作为新用户,我想用微信一键登录免去注册麻烦,以便快速进入家庭管理。
POST /api/auth/wechat-login → 返回 Result 含 token + 用户信息。parent,跳转家长首页。User + family_members(memberType=login)。AuthController /api/auth/* 公开;openid 关联 User,决定 memberType。用户故事:作为不想用微信的用户,我想用手机号登录,以便也能使用全部功能。
13800000001)。POST /api/auth/send-code 获取验证码。POST /api/auth/phone-login。用户故事:作为被家人邀请的用户,我想通过邀请码/二维码直接加入家庭,以便立即成为成员。
POST /api/family/invite/generate 生成邀请码/二维码(含令牌与落地页)。POST /api/auth/register-with-invite(携带邀请令牌)。FamilyInviteController /api/family/invite/*;二维码含令牌+落地页(cfclub 特性)。用户故事:作为游客,我想随便看看商品和内容,但访问我的家庭/任务时必须先登录,以便数据安全。
/pages/family/index、/pages/tasks/index)。Authorization)。JwtInterceptor 返回 401 → 前端跳转登录页;登录后回跳原页。POST /api/product/list、文章列表 POST /api/articles/list → 可见内容(公开路径)。/api/** 一律拦截;登录态过期后接口统一 401。Authorization Header;8 个公开路径白名单。