# 修改密码功能实现计划

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 为碳信网平台添加普通用户自助修改密码功能（txw-sso后端 + txw-mhzc-web前端）

**Architecture:**
- 后端：SSO服务新增 `POST /sso/auth/changePassword` 接口，用户通过 authenticate 验证旧密码，通过 mhzc-service 的 Feign 接口更新用户密码
- 前端：mhzc-web 新增修改密码页面（账号管理），工作台增加快捷入口，用户中心左侧菜单增加"账号管理"菜单项

**Tech Stack:** Java Spring Boot / Vue 2 / TDesign / Feign

---

## 涉及的变更文件

### 后端（txw-sso）
| 文件 | 改动 |
|------|------|
| `AuthService.java` | 新增 `changePassword` 接口声明 |
| `AuthServiceImpl.java` | 实现 `changePassword` 逻辑 |
| `AuthController.java` | 新增 `/auth/changePassword` 路由 |
| `ChangePasswordReqVO.java` | 新建请求 VO |
| `ChangePasswordRespVO.java` | 新建响应 VO |
| `YhxxApi.java` (txw-sso-api) | 新增 Feign 方法 `updatePassword` |
| `TxwMhzcYhxxbService.java` (txw-mhzc) | 新增 `updatePassword` 方法声明 |
| `TxwMhzcYhxxbServiceImpl.java` (txw-mhzc) | 实现 `updatePassword` |
| `TxwMhzcYhxxbMapper.xml` | 新增 updatePassword SQL |
| `ISsoApi.java` | FeignClient name 常量（需确认mhzc服务名） |

### 前端（txw-mhzc-web）
| 文件 | 改动 |
|------|------|
| `views/gzt/index.vue` | 新增修改密码快捷入口按钮 |
| `views/yhzx/zhanghugl/index.vue` | 新建修改密码页面 |
| `router/routes.js` | 新增 `zhanghugl` 路由 |
| `views/glxtSy/config.js` | 菜单配置新增"账号管理" |
| `api/sso.js` | 新建，封装 changePassword API |

---

## 后端任务拆分

### Task 1: 后端 - 新建 ChangePasswordReqVO

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/pojo/vo/ChangePasswordReqVO.java`

- [ ] **Step 1: 创建文件**

```java
package com.css.txw.sso.pojo.vo;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import javax.validation.constraints.NotBlank;

@Schema(description = "修改密码 Request VO")
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class ChangePasswordReqVO {

    @Schema(description = "旧密码（MD5加密）", requiredMode = Schema.RequiredMode.REQUIRED)
    @NotBlank(message = "旧密码不能为空")
    private String oldPassword;

    @Schema(description = "新密码（MD5加密）", requiredMode = Schema.RequiredMode.REQUIRED)
    @NotBlank(message = "新密码不能为空")
    private String newPassword;

    @Schema(description = "确认密码（MD5加密）", requiredMode = Schema.RequiredMode.REQUIRED)
    @NotBlank(message = "确认密码不能为空")
    private String confirmPassword;
}
```

---

### Task 2: 后端 - AuthService 新增 changePassword 接口声明

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/service/auth/AuthService.java`

在接口末尾添加：
```java
/**
 * 修改密码
 *
 * @param reqVO 修改密码请求
 * @return 成功返回 null
 */
void changePassword(ChangePasswordReqVO reqVO);
```

引入 import：
```java
import com.css.txw.sso.pojo.vo.ChangePasswordReqVO;
```

---

### Task 3: 后端 - AuthServiceImpl 实现 changePassword

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/service/auth/impl/AuthServiceImpl.java`

在类末尾添加实现方法：

```java
@Override
public void changePassword(ChangePasswordReqVO reqVO) {
    // 1. 校验新密码与确认密码一致性
    if (!reqVO.getNewPassword().equals(reqVO.getConfirmPassword())) {
        throw exception(AUTH_PASSWORD_CONFIRM_MISMATCH);
    }

    // 2. 密码复杂度校验（6-20位，字母+数字）
    if (!isValidPasswordComplexity(reqVO.getNewPassword())) {
        throw exception(AUTH_PASSWORD_COMPLEXITY_INVALID);
    }

    // 3. 获取当前登录用户
    String userId = SecurityFrameworkUtils.getLoginUserId();
    YhxxbDTO yhxx = yhxxService.getYhxx(userId);

    // 4. 校验新旧密码不能相同
    if (reqVO.getOldPassword().equals(reqVO.getNewPassword())) {
        throw exception(AUTH_PASSWORD_SAME_AS_OLD);
    }

    // 5. 旧密码正确性校验
    authenticate(yhxx.getDlzh(), reqVO.getOldPassword());

    // 6. 更新密码
    yhxxService.updatePassword(userId, reqVO.getNewPassword());
}

private boolean isValidPasswordComplexity(String password) {
    if (password == null || password.length() < 6 || password.length() > 20) {
        return false;
    }
    boolean hasLetter = password.matches(".*[A-Za-z]+.*");
    boolean hasDigit = password.matches(".*[0-9]+.*");
    return hasLetter && hasDigit;
}
```

新增引入：
```java
import com.css.txw.sso.pojo.vo.ChangePasswordReqVO;
import com.css.txw.sso.util.SecurityFrameworkUtils;
import static com.css.txw.sso.constants.ErrorCodeConstants.AUTH_PASSWORD_CONFIRM_MISMATCH;
import static com.css.txw.sso.constants.ErrorCodeConstants.AUTH_PASSWORD_COMPLEXITY_INVALID;
import static com.css.txw.sso.constants.ErrorCodeConstants.AUTH_PASSWORD_SAME_AS_OLD;
```

---

### Task 4: 后端 - ErrorCodeConstants 新增错误码

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/constants/ErrorCodeConstants.java`

新增三个错误码：
```java
AUTH_PASSWORD_CONFIRM_MISMATCH(400, "两次输入的新密码不一致"),
AUTH_PASSWORD_COMPLEXITY_INVALID(400, "密码长度6-20位，需包含字母和数字"),
AUTH_PASSWORD_SAME_AS_OLD(400, "新密码不能与原密码相同"),
```

---

### Task 5: 后端 - AuthController 新增路由

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/controller/auth/AuthController.java`

在类末尾添加：

```java
@PostMapping("/changePassword")
@Operation(summary = "修改密码")
public CommonResult<Void> changePassword(@RequestBody @Valid ChangePasswordReqVO reqVO) {
    authService.changePassword(reqVO);
    return success(null);
}
```

新增引入：
```java
import com.css.txw.sso.pojo.vo.ChangePasswordReqVO;
```

---

### Task 6: 后端 - YhxxService 新增 updatePassword 方法

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/service/yhxx/YhxxService.java`

末尾新增方法声明：
```java
void updatePassword(String yhUuid, String newPassword);
```

---

### Task 7: 后端 - YhxxServiceImpl 实现 updatePassword（Feign调用mhzc）

**文件:** `txw-sso/txw-sso-service-biz/src/main/java/com/css/txw/sso/service/yhxx/impl/YhxxServiceImpl.java`

首先需要确认 mhzc 服务的 Feign 接口存在。如果 YhxxApi 不支持更新密码，则需要在 txw-sso-api 中新增 Feign 方法指向 mhzc 的更新密码接口。

步骤：
1. 在 `txw-sso-api` 的 `YhxxApi.java` 中新增 `updatePassword` Feign 方法
2. 在 `txw-mhzc` 的 `TxwMhzcYhxxbService` 新增 `updatePassword` 方法
3. 在 `TxwMhzcYhxxbServiceImpl` 实现该方法
4. 在 mapper XML 中新增 update SQL
5. 在 `YhxxServiceImpl` 中调用该 Feign 接口

**YhxxApi.java (txw-sso-api) 新增：**
```java
@PostMapping("/mhzc/user/updatePassword")
@Operation(summary = "更新用户密码")
CommonResult<String> updatePassword(@RequestParam("yhUuid") String yhUuid, @RequestParam("dlmm") String dlmm);
```

**TxwMhzcYhxxbService.java 新增：**
```java
String updatePassword(String yhUuid, String dlmm);
```

**TxwMhzcYhxxbServiceImpl.java 新增：**
```java
@Override
public String updatePassword(String yhUuid, String dlmm) {
    TxwMhzcYhxxbDO yhxxbDO = new TxwMhzcYhxxbDO();
    yhxxbDO.setYhUuid(yhUuid);
    yhxxbDO.setDlmm(dlmm);
    this.updateById(yhxxbDO);
    return "success";
}
```

**TxwMhzcYhxxbMapper.xml 新增：**
```xml
<update id="updatePassword">
    UPDATE txw_mhzc_yhxxb SET dlmm = #{dlmm} WHERE yh_uuid = #{yhUuid}
</update>
```

**YhxxServiceImpl.java 实现：**
```java
@Resource
private YhxxApi yhxxApi;

@Override
public void updatePassword(String yhUuid, String newPassword) {
    yhxxApi.updatePassword(yhUuid, newPassword);
}
```

---

## 前端任务拆分（txw-mhzc-web）

### Task 8: 前端 - 新建 api/sso.js

**文件:** `txw-mhzc-web/src/pages/index/api/sso.js`

```js
import { fetchSso } from '@/core/request';

export const changePassword = (params) => {
  return fetchSso({
    url: '/sso/auth/changePassword',
    data: JSON.stringify(params),
    method: 'post',
    loading: true,
  });
};
```

---

### Task 9: 前端 - 新建修改密码页面

**文件:** `txw-mhzc-web/src/pages/index/views/yhzx/zhanghugl/index.vue`

页面元素：
- 三个密码输入框（旧密码、新密码、确认密码）
- 确认按钮
- 密码格式提示文字

校验逻辑：
1. 旧密码、新密码、确认密码不能为空
2. 新密码长度6-20位，需包含字母和数字（提示：密码长度6-20位，需包含字母和数字）
3. 新密码与确认密码一致性（提示：两次输入的新密码不一致）
4. 提交后调用 changePassword API
5. 成功提示"密码修改成功"，可跳转回工作台

样式参考现有的登录页面，使用 TDesign 组件库。

---

### Task 10: 前端 - 路由配置新增 zhanghugl

**文件:** `txw-mhzc-web/src/pages/index/router/routes.js`

在 `yhzx` 的 children 数组中新增：
```js
{ path: 'zhanghugl', component: zhanghugl, name: 'zhanghugl', meta: { title: '账号管理' } }
```

新增 zhanghugl 路由函数：
```js
function zhanghugl() {
  return import('@/pages/index/views/yhzx/zhanghugl/index.vue');
}
```

---

### Task 11: 前端 - 菜单配置新增"账号管理"

**文件:** `txw-mhzc-web/src/pages/index/views/glxtSy/config.js`

在 `menuList` 数组中新增一项：
```js
{
  value: 'zhanghugl',
  title: '账号管理',
  icon: 'password',
}
```

---

### Task 12: 前端 - 工作台新增修改密码快捷入口

**文件:** `txw-mhzc-web/src/pages/index/views/gzt/index.vue`

在快捷操作区域新增按钮：
```html
<t-button theme="primary" variant="outline" @click="$router.push('/yhzx/zhanghugl')">
  修改密码
</t-button>
```

---

## 任务执行顺序

建议按以下顺序执行：

1. Task 1 - 新建 ChangePasswordReqVO
2. Task 4 - 新增错误码
3. Task 6 - YhxxService 新增 updatePassword
4. Task 7 - YhxxServiceImpl + Feign + MHZC 实现
5. Task 2 - AuthService 新增 changePassword
6. Task 3 - AuthServiceImpl 实现
7. Task 5 - AuthController 新增路由
8. Task 8 - 前端 API 新建
9. Task 9 - 前端页面新建
10. Task 10 - 路由配置
11. Task 11 - 菜单配置
12. Task 12 - 工作台入口