# 首次登录强制修改密码功能

## 功能说明

当管理员首次登录或需要重置密码时，系统会强制要求修改密码后才能正常使用系统。

## 安装步骤

### 方式一：使用安装脚本（推荐）

#### Windows 系统
```bash
install_first_login_password.bat
```

#### Linux/Mac 系统
```bash
chmod +x install_first_login_password.sh
./install_first_login_password.sh
```

### 方式二：手动执行 SQL

执行 `add_is_paw_field.sql` 文件中的 SQL 语句：

```sql
ALTER TABLE `la_admin` 
ADD COLUMN `is_paw` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否已修改初始密码：0=需要修改，1=正常' AFTER `multipoint_login`;
```

## 使用方法

### 设置管理员需要修改密码

如果需要强制某个管理员在下次登录时修改密码，执行以下 SQL：

```sql
UPDATE la_admin SET is_paw = 0 WHERE id = <管理员ID>;
```

例如，强制 ID 为 1 的管理员修改密码：

```sql
UPDATE la_admin SET is_paw = 0 WHERE id = 1;
```

### 批量设置所有管理员

如果需要强制所有管理员修改密码：

```sql
UPDATE la_admin SET is_paw = 0;
```

## 工作流程

1. 管理员登录系统
2. 系统检查 `is_paw` 字段
   - 如果 `is_paw = 0`：跳转到修改密码页面
   - 如果 `is_paw = 1`：正常进入系统
3. 管理员在修改密码页面输入新密码
4. 密码修改成功后，`is_paw` 自动更新为 1
5. 系统要求重新登录
6. 使用新密码登录后正常使用系统

## 安全机制

系统通过路由守卫确保安全性：

1. **强制跳转**：当 `is_paw = 0` 时，用户访问任何页面都会被强制跳转到修改密码页面
2. **URL 防护**：即使用户直接在浏览器输入其他页面 URL，也会被拦截并跳转到修改密码页面
3. **状态持久化**：`is_paw` 状态存储在 Vuex store 中，页面刷新后仍然有效
4. **防止绕过**：修改密码页面需要登录才能访问，但已修改密码的用户无法再次访问该页面

## 技术实现

### 后端修改

1. **LoginLogic.php** - 登录逻辑返回 `is_paw` 字段
2. **LoginController.php** - 添加 `changeFirstPassword` 接口
3. **数据库** - 添加 `is_paw` 字段

### 前端修改

1. **login.vue** - 登录成功后判断 `is_paw` 字段
2. **change-password.vue** - 新增修改密码页面
3. **routes.ts** - 添加修改密码路由
4. **user.ts** - 添加修改密码 API
5. **user.ts (store)** - 存储 `isPaw` 状态
6. **permission.ts** - 路由守卫，强制需要修改密码的用户只能访问修改密码页面

## 字段说明

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| is_paw | TINYINT(1) | 1 | 0=需要修改密码，1=正常 |

## 注意事项

1. 修改密码后会自动退出登录，需要使用新密码重新登录
2. 密码长度不能少于 6 位
3. 两次输入的密码必须一致
4. 该功能同时支持账号密码登录和企业微信登录

## 测试步骤

### 1. 安装功能

执行安装脚本或手动执行 SQL 添加 `is_paw` 字段。

### 2. 设置测试账号

```sql
-- 设置 ID 为 1 的管理员需要修改密码
UPDATE la_admin SET is_paw = 0 WHERE id = 1;
```

### 3. 测试登录流程

1. 使用该管理员账号登录
2. 登录成功后应自动跳转到修改密码页面
3. 输入新密码（至少 6 位）
4. 确认修改后应提示"密码修改成功，请重新登录"
5. 自动跳转到登录页面
6. 使用新密码登录，应能正常进入系统

### 4. 验证数据库

```sql
-- 查看管理员的 is_paw 状态，应该已更新为 1
SELECT id, account, is_paw FROM la_admin WHERE id = 1;
```

### 5. 使用测试 SQL

可以使用 `test_first_login.sql` 文件中的 SQL 语句进行测试。

## 安全建议

1. 建议为新创建的管理员账号设置 `is_paw = 0`，强制首次登录修改密码
2. 定期要求管理员修改密码，可批量设置 `is_paw = 0`
3. 密码应包含字母、数字和特殊字符，提高安全性