cfc/docs/superpowers/specs/2026-07-16-first-login-auto-complete.md

规格文档：小程序首次登录自动跳过身份选择切入信息补充

目标

小程序首次登录时，跳过「选择身份」步骤，直接进入补充身份信息页面（该页需增加地址信息字段），并默认身份为 parent。

背景

• 当前流程：微信授权登录 → 选择身份（parent/child/guide） → 补充信息（姓名/头像/家庭）
• 痛点：用户进入APP额外点选步骤影响留存， info 补全率低于40%
• 统计：90%新用户实际为家长身份需求

设计决策

方案	决策理由
直接跳过选择	默认设 parent，适合家庭搭建逻辑；极少数 child/guide 用户在 profile 可切换
补全页增地址	地址字段作为必填值，基于四级选择器匹配（AddressPicker 组件）
入口逻辑	首次强制弹窗；后续 profile 仍可修正

技术调整

Components:
 - condition: isAuth && !user.address
   modal: profile/edit.vue
   picker: AddressPicker
Endpoints:
 - POST /api/user/update - new field: address, areaCodeList
State:
 - Vuex: user.address (同步)

实施步骤

1. 挖出 index.vue 登录逻辑，移除身份选择跳转
2. 增 /api/user/update address/areaCodeList 字段支持
3. profile/edit.vue 加入 <AddressPicker> 嵌入，强制识别 firstComplete 弹出状态

验收标准

• □ 新用户登录直达 profile/edit，无权限跳异常流
• □ 地址录入四级实时匹配，保存成功同步 Vuex
• □ 旧用户缺 address 依然收到弹窗，首页不阻断

注意

• 地址字段为空时 user.address = null 默认值
• 回溯地址选择时拟定带省市区街道完整编码路径