role-admin/docs/C_APP_ADMIN_REQUIREMENTS.md

role-admin C 端正式版管理后台需求文档

1. 后台定位

role-admin 继续作为管理后台，不承载员工日常移动端工作。正式版需要在现有门店、角色、员工、权限策略基础上，增加 C 端运营能力：

• 公告管理。
• 任务管理。
• 排班管理。
• 员工密码重置和凭据审计。

2. 现有能力保留

继续保留当前页面：

• 门店管理。
• 角色管理。
• 员工管理。
• 权限策略。

登录与鉴权仍按现有流程：

1. POST /api/auth/admin/login
2. GET /api/auth/me
3. GET /api/permissions/me

菜单和按钮继续以后端返回的 menus、permissions、actions 为准。

3. 新增菜单

在现有“权限管理”业务组之外，新增“员工工作台运营”业务组。

路由	菜单	权限	说明
/announcements	公告管理	announcement:view	管理 C 端公告
/tasks	任务管理	task:view	管理门店和员工任务
/shifts	排班管理	shift:view	管理员工排班
/credential-audits	凭据审计	credential:audit:view	查看密码重置审计

4. 公告管理

列表：

• 标题、重要级别、目标范围、状态、发布人、发布时间、已读人数。
• 支持状态、重要级别、关键词筛选。

表单：

• 标题、内容、重要级别。
• 目标范围：全部门店、指定门店、指定角色、指定员工。
• 保存草稿、发布、归档。

权限：

• announcement:view: 查看列表和详情。
• announcement:manage: 新建、编辑、发布、归档。

5. 任务管理

列表：

• 标题、目标门店、分配员工、状态、优先级、截止时间、创建人。
• 支持门店、员工、状态、优先级、关键词筛选。

表单：

• 标题、描述、目标门店、分配员工、优先级、截止时间。
• 支持取消未完成任务。

详情：

• 展示任务状态流转记录和员工备注。

权限：

• task:view: 查看任务。
• task:manage: 新建、编辑、取消任务。

6. 排班管理

列表：

• 门店、员工、岗位、开始时间、结束时间、状态。
• 支持门店、员工、日期范围筛选。

表单：

• 选择门店后加载员工。
• 选择员工、岗位、开始时间、结束时间。
• 同一员工同一时间段不能重复排班。

权限：

• shift:view: 查看排班。
• shift:manage: 新增、编辑、取消排班。

7. 密码重置与凭据审计

用户提出“超级管理员与管理员需要支持查看自身和下级用户密码”。后台正式实现为“重置和一次性查看临时密码”，不做明文原密码查看。

7.1 员工管理页改造

在员工列表和员工详情增加：

• “重置密码”按钮：需要 credential:reset。
• 重置确认弹窗：必须填写原因。
• 重置成功弹窗：显示一次性临时密码，并提供复制按钮。
• 弹窗关闭后不再展示该临时密码。

范围规则：

• 超级管理员可重置所有员工。
• 管理员只能重置自己权限范围内的员工。
• 店长如被授予 credential:reset，只能重置本店员工。
• 不支持查看自身当前密码；自身密码走修改密码。

7.2 凭据审计页

展示：

• 操作者。
• 目标员工。
• 动作类型。
• 时间。
• IP。
• User-Agent。
• 原因。

筛选：

• 操作者、目标员工、时间范围、门店。

8. 前端实现要求

• 业务接口继续集中在 src/api/access.ts 或按模块拆分到 src/api/*.ts，页面不直接拼接 URL。
• 路由、菜单和按钮显隐继续基于后端权限。
• 新增页面应复用现有 Element Plus 和 pure-admin 页面风格。
• 列表页都要支持分页、筛选、重置、保存后刷新。
• 重置密码成功弹窗不能把临时密码写入本地存储、日志或 URL。

9. README 同步

新增页面、API 模块、路由模块或关键配置后，必须同步更新 README.md 的：

• 业务模块。
• 后端对接接口。
• 登录与鉴权流程中涉及的新增凭据规则。

10. 验收标准

• 超级管理员可以看到新增菜单。
• 没有权限的用户看不到对应菜单和按钮。
• 员工密码重置只显示一次性临时密码。
• 凭据审计能查到每次重置行为。
• 不存在“查看当前明文密码”的入口。