|
|
@@ -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
|
|
|
+```
|
Sisyphus