feat: 首次登录跳过角色选择直接进入信息补充页（默认parent）+ 地址四级选择器

- login.vue: needsRoleSelect → autoParent 传参，跳过角色选择
- user-edit.vue: autoParent 模式下默认 parent，嵌入 AddressPicker 四级地址组件
- UpdateUserDTO + UserController + UserService: 扩展 address 字段支持
- schema.sql: users 表同步 address 列

cfc-backend/src/main/java/com/etotem/cfc/controller/UserController.java

@@ -95,6 +95,7 @@ public class UserController {
         if (params.containsKey("mascot")) dto.setMascot((String) params.get("mascot"));
         if (params.containsKey("hobbies")) dto.setHobbies((String) params.get("hobbies"));
         if (params.containsKey("dietPreferences")) dto.setDietPreferences((String) params.get("dietPreferences"));
+        if (params.containsKey("address")) dto.setAddress((String) params.get("address"));
 
         boolean success = userService.updateUserInfo(userId, dto);
         if (success) {

cfc-backend/src/main/java/com/etotem/cfc/dto/UpdateUserDTO.java

@@ -32,4 +32,7 @@ public class UpdateUserDTO {
 
     // AI助手形象: xibao(浠宝)/fubao(福宝)
     private String mascot;
+
+    // 地址
+    private String address;
 }

cfc-backend/src/main/java/com/etotem/cfc/service/UserService.java

@@ -1038,7 +1038,11 @@ private FamilyInvitationService familyInvitationService;
             user.setDietPreferences(dto.getDietPreferences());
             recordProfileChange(userId, "dietPreferences", oldDiet, dto.getDietPreferences(), "user_edit");
         }
-        user.setUpdatedAt(new Date());
+        // 更新地址
+        if (dto.getAddress() != null) {
+            user.setAddress(dto.getAddress());
+        }
+
         userMapper.updateById(user);
         return true;
     }

cfc-backend/src/main/resources/schema.sql

@@ -28,6 +28,7 @@ CREATE TABLE IF NOT EXISTS users (
     gender ENUM('male','female'),
     birth_hour VARCHAR(10) COMMENT '出生时辰: 子丑寅卯辰巳午未申酉戌亥',
     mascot VARCHAR(20) DEFAULT NULL COMMENT 'AI助手形象: xibao(浠宝)/fubao(福宝)',
+    address VARCHAR(500) COMMENT '地址',
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
     updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
     butler_status VARCHAR(20) COMMENT '管家状态: null/pending/approved/rejected',

cfc-frontend/pages/login/login.vue

@@ -148,8 +148,9 @@ export default {
           uni.showToast({ title: '登录成功', icon: 'success' })
 
           if (res.data.needsRoleSelect) {
+            // 首次登录：跳过角色选择，默认 parent，直接进入信息补充页
             uni.redirectTo({
-              url: '/pages/user-edit/user-edit?token=' + res.data.token + '&userId=' + res.data.userId + '&needsRoleSelect=true'
+              url: '/pages/user-edit/user-edit?token=' + res.data.token + '&userId=' + res.data.userId + '&autoParent=true'
             })
           } else {
             self.handlePostLoginRouting()

cfc-frontend/pages/user-edit/user-edit.vue

@@ -136,6 +136,12 @@
 				</picker>
 			</view>
 
+			<!-- 地址选择 -->
+			<view class="form-item">
+				<text class="label">所在地区 <text class="required" v-if="isNewUserFlow">*</text></text>
+				<AddressPicker ref="addressPicker" />
+			</view>
+
 			<!-- 兴趣爱好 -->
 			<view class="form-item">
 				<text class="label">兴趣爱好</text>
@@ -248,8 +254,12 @@
 
 <script>
 import { updateUserInfo, joinFamily, createFamily, directRegister, getUserInfo } from '../../utils/api.js'
+import AddressPicker from '../../components/address-picker.vue'
 
 export default {
+	components: {
+		AddressPicker
+	},
 	data() {
 		return {
 			isEdit: false,
@@ -275,7 +285,9 @@ export default {
 				highestEducation: '',
 				maritalStatus: '',
 				hobbies: '',
-				dietPreferences: ''
+				dietPreferences: '',
+				address: '',
+				addressId: null
 			},
 			ethnicityOptions: ['汉族','蒙古族','回族','藏族','维吾尔族','苗族','彝族','壮族','布依族','朝鲜族','满族','侗族','瑶族','白族','土家族','哈尼族','哈萨克族','傣族','黎族','其他'],
 			bloodTypeOptions: ['A','B','AB','O','未知'],
@@ -309,16 +321,27 @@ export default {
 		if (options.token && options.userId) {
 			this.token = options.token
 			this.userId = options.userId
-			
-			// 检查是否需要选择角色（新用户）- 只有明确传递 needsRoleSelect=true 才显示选择
+
+			if (options.autoParent === 'true') {
+				// 首次登录：跳过角色选择，默认 parent，直接进入信息补充页
+				this.showRoleSelect = false
+				this.isEdit = true
+				this.isNewUserFlow = true
+				this.form.role = 'parent'
+			} else {
+				// 检查是否需要选择角色（新用户）- 只有明确传递 needsRoleSelect=true 才显示选择
+				this.showRoleSelect = options.needsRoleSelect === 'true'
+				this.isEdit = !this.showRoleSelect
+				this.isNewUserFlow = options.needsRoleSelect === 'true'
+			}
+		} else if (options.phone && (options.autoParent === 'true' || options.needsRoleSelect === 'true')) {
+			// 测试环境：没有token，只有手机号，是新用户注册流程
 			this.showRoleSelect = options.needsRoleSelect === 'true'
 			this.isEdit = !this.showRoleSelect
-			this.isNewUserFlow = options.needsRoleSelect === 'true'
-		} else if (options.phone && options.needsRoleSelect === 'true') {
-			// 测试环境：没有token，只有手机号，是新用户注册流程
-			this.showRoleSelect = true
-			this.isEdit = false
 			this.isNewUserFlow = true
+			if (options.autoParent === 'true') {
+				this.form.role = 'parent'
+			}
 			// 将手机号传递给表单
 			this.form.phone = options.phone
 		} else {
@@ -430,6 +453,7 @@ export default {
 					this.form.hobbies = userData.hobbies || ''
 					this.form.dietPreferences = userData.dietPreferences || ''
 					this.form.mascot = userData.mascot || ''
+				this.form.address = userData.address || ''
 				}
 			} catch (e) {
 				console.error('加载用户信息失败', e)
@@ -442,6 +466,11 @@ export default {
 				return
 			}
 			
+			// 从 AddressPicker 读取地址文本
+			if (this.$refs.addressPicker && this.$refs.addressPicker.fullAddress) {
+				this.form.address = this.$refs.addressPicker.fullAddress
+			}
+
 			this.loading = true
 			try {
 				await updateUserInfo({
@@ -457,7 +486,8 @@ export default {
 					highestEducation: this.form.highestEducation,
 					maritalStatus: this.form.maritalStatus,
 					hobbies: this.form.hobbies,
-					dietPreferences: this.form.dietPreferences
+					dietPreferences: this.form.dietPreferences,
+					address: this.form.address
 				})
 				uni.showToast({ title: '保存成功', icon: 'success' })
 				setTimeout(() => {

docs/superpowers/plans/2026-07-16-first-login-auto-complete-plan.md

@@ -0,0 +1,215 @@
+# 小程序首次登录自动跳过身份选择切入信息补充 — 实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development.
+> Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 新用户微信授权后直跳信息补充页（默认 parent），profile/edit 嵌入四级地址选择器
+
+**Architecture:** 修改 login.vue（传参跳过角色选择）+ user-edit.vue（autoParent 模式 + 嵌入 AddressPicker）+ 后端 DTO/Controller/Service 扩展 address 字段
+
+**Tech Stack:** uni-app Vue 2 + Spring Boot 2.7 + MyBatis-Plus
+
+---
+
+### Task 1: 后端 — UpdateUserDTO + Controller + Service 扩展 address 字段
+
+**Files:**
+- Modify: `cfc-backend/src/main/java/com/etotem/cfc/dto/UpdateUserDTO.java`
+- Modify: `cfc-backend/src/main/java/com/etotem/cfc/controller/UserController.java`
+- Modify: `cfc-backend/src/main/java/com/etotem/cfc/service/UserService.java`
+
+- [ ] **Step 1: 给 UpdateUserDTO 添加 address 字段**
+
+```java
+// 在 UpdateUserDTO.java 末尾添加（在 mascot 字段之后）
+private String address;
+```
+
+- [ ] **Step 2: 给 UserController.updateUser 添加 address 参数解析**
+
+```java
+// 在 UserController.java 的 updateUser 方法中，在 mascot 解析之后、boolean success 之前添加：
+if (params.containsKey("address")) dto.setAddress((String) params.get("address"));
+```
+
+- [ ] **Step 3: 给 UserService.updateUserInfo 添加 address 赋值**
+
+```java
+// 在 UserService.java 的 updateUserInfo 方法中，在 mascot 处理之后、userMapper.updateById 之前添加：
+if (dto.getAddress() != null) {
+    user.setAddress(dto.getAddress());
+}
+```
+
+- [ ] **Step 4: schema.sql 同步 — users 表添加 address 列**
+
+```sql
+-- 在 CREATE TABLE IF NOT EXISTS users 定义中，在 mascot VARCHAR(20) 行之后添加：
+address VARCHAR(500) COMMENT '地址',
+```
+
+- [ ] **Step 5: 验证编译**
+
+```bash
+cd cfc-backend && mvn clean compile -q
+```
+Expected: BUILD SUCCESS
+
+---
+
+### Task 2: 前端 — login.vue 传参 autoParent
+
+**Files:**
+- Modify: `cfc-frontend/pages/login/login.vue`
+
+- [ ] **Step 1: 修改 needsRoleSelect 处理逻辑**
+
+将 login.vue 中 `res.data.needsRoleSelect` 为 true 时的跳转从：
+```javascript
+if (res.data.needsRoleSelect) {
+    uni.redirectTo({
+        url: '/pages/user-edit/user-edit?token=' + res.data.token + '&userId=' + res.data.userId + '&needsRoleSelect=true'
+    })
+}
+```
+改为：
+```javascript
+if (res.data.needsRoleSelect) {
+    // 新用户：跳过角色选择，默认 parent，直接进入信息补充页
+    uni.redirectTo({
+        url: '/pages/user-edit/user-edit?token=' + res.data.token + '&userId=' + res.data.userId + '&autoParent=true'
+    })
+}
+```
+
+---
+
+### Task 3: 前端 — user-edit.vue 自动 parent 模式 + 地址选择器
+
+**Files:**
+- Modify: `cfc-frontend/pages/user-edit/user-edit.vue`
+
+- [ ] **Step 1: 引入 AddressPicker 组件**
+
+在 `<script>` 顶部 import 区域添加：
+```javascript
+import AddressPicker from '../../components/address-picker.vue'
+```
+
+在 `components` 注册中添加：
+```javascript
+components: {
+    AddressPicker
+}
+```
+
+- [ ] **Step 2: 处理 autoParent 参数**
+
+在 `onLoad` 中，第一个 `if (options.token && options.userId)` 分支内，将：
+```javascript
+this.showRoleSelect = options.needsRoleSelect === 'true'
+this.isEdit = !this.showRoleSelect
+this.isNewUserFlow = options.needsRoleSelect === 'true'
+```
+改为：
+```javascript
+// autoParent=true 跳过了角色选择，默认 parent 直接进入信息补充页
+if (options.autoParent === 'true') {
+    this.showRoleSelect = false
+    this.isEdit = true
+    this.isNewUserFlow = true
+    this.form.role = 'parent'
+} else {
+    this.showRoleSelect = options.needsRoleSelect === 'true'
+    this.isEdit = !this.showRoleSelect
+}
+this.isNewUserFlow = options.autoParent === 'true' || options.needsRoleSelect === 'true'
+```
+
+- [ ] **Step 3: form.data 中添加 address 相关字段**
+
+在 `data()` 的 `form` 对象中添加：
+```javascript
+address: '',
+addressId: null
+```
+
+- [ ] **Step 4: 表单模板中嵌入 AddressPicker（放在婚姻状态之后、兴趣爱好之前）**
+
+```html
+<!-- 地址选择（新用户必填） -->
+<view class="form-item">
+    <text class="label">所在地区 <text class="required" v-if="isNewUserFlow">*</text></text>
+    <AddressPicker v-model="form.addressId" @change="onAddressChange" />
+</view>
+```
+
+在 methods 中添加：
+```javascript
+onAddressChange(e) {
+    // AddressPicker 组件通过 v-model 传 addressId，完整地址字符串通过其他事件获取
+    // 实际 address 显示值由 AddressPicker 内部 computed 提供
+}
+```
+
+- [ ] **Step 5: loadUserInfo 中加载地址字段**
+
+在 `loadUserInfo` 方法中，加载已有数据部分添加：
+```javascript
+this.form.address = userData.address || ''
+```
+
+- [ ] **Step 6: saveUserInfo 中提交 address 字段**
+
+在 `saveUserInfo` 方法的 `updateUserInfo({...})` 调用中添加：
+```javascript
+address: this.form.address
+```
+
+- [ ] **Step 7: 新用户注册流程提交时带 address**
+
+在 `submitRegister` 或对应新用户注册的提交方法（搜索 `updateUserInfo` 调用位置），确保 address 也一并提交。检查 `submitTeacherInfo` 是否也需要（如果是家长+teacher场景）。
+
+---
+
+### Task 4: schema.sql 同步 + 验证
+
+**Files:**
+- Modify: `cfc-backend/src/main/resources/schema.sql`
+
+- [ ] **Step 1: 确保 address 列在 CREATE TABLE users 中**
+
+检查 `CREATE TABLE IF NOT EXISTS users` 中确认 address 列已添加（see Task 1 Step 4）。
+
+- [ ] **Step 2: 编译验证**
+
+```bash
+cd cfc-backend && mvn clean compile -q
+```
+Expected: BUILD SUCCESS
+
+- [ ] **Step 3: 前端 LSP 诊断**
+
+```bash
+# 检查 user-edit.vue 和 login.vue 有无语法错误
+```
+Expected: 无报错
+
+---
+
+### Task 5: Git commit & push
+
+- [ ] **Step 1: 检查变更范围**
+
+```bash
+git diff --cached --stat  # 确认仅包含目标文件
+git status
+```
+
+- [ ] **Step 2: 提交**
+
+```bash
+git add -A
+git commit -m "feat: 首次登录跳过角色选择，直接进入信息补充页（预设parent）+ AddressPicker 四级地址"
+git push origin cfclub
+```

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

@@ -0,0 +1,42 @@
+# 规格文档：小程序首次登录自动跳过身份选择切入信息补充
+
+## 目标
+小程序首次登录时，跳过「选择身份」步骤，直接进入**补充身份信息**页面（该页需增加**地址信息**字段），并默认身份为 `parent`。
+
+## 背景
+- 当前流程：微信授权登录 → 选择身份（parent/child/guide） → 补充信息（姓名/头像/家庭）
+- 痛点：用户进入APP额外点选步骤影响留存， info 补全率低于40%
+- 统计：90%新用户实际为家长身份需求
+
+## 设计决策
+| 方案 | 决策理由 |
+|------|----------|
+| **直接跳过选择** | 默认设 parent，适合家庭搭建逻辑；极少数 child/guide 用户在 profile 可切换 |
+| **补全页增地址** | 地址字段作为必填值，基于四级选择器匹配（AddressPicker 组件） |
+| **入口逻辑** | 首次强制弹窗；后续 profile 仍可修正 | 
+
+## 技术调整
+```yaml
+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 默认值
+- 回溯地址选择时拟定带省市区街道完整编码路径