# 上虞利率定价系统操作手册生成实施记录

## 基本信息

- 日期：2026-05-09
- 任务：生成系统操作文档，覆盖主要业务流程、用户管理、部门管理，并在合适位置加入真实页面截图
- 产物：`doc/上虞利率定价系统操作手册-2026-05-09.docx`

## 实施内容

- 梳理前端路由、菜单 SQL、业务流程组件和系统管理页面，确认操作手册覆盖范围。
- 临时启动前端开发服务，复用本机 63310 后端服务，通过真实浏览器获取页面截图。
- 截图覆盖登录页、流程列表、客户类型选择、客户号查询、新增个人定价流程、流程详情、用户管理、部门管理。
- 使用 `python-docx` 生成 Word 操作手册，内容包含：
  - 文档说明与角色范围
  - 登录与页面布局
  - 利率定价主要业务流程
  - 用户管理操作说明
  - 部门管理操作说明
  - 日常使用注意事项

## 验证情况

- 已确认前端服务可访问：`http://localhost:8080`
- 已通过 `/login/test` 获取测试登录令牌并进入真实页面截图。
- 已抽查关键截图显示正常，流程详情截图已改为从列表真实记录进入，避免使用无效流水号。
- 已生成 Word 文件：`doc/上虞利率定价系统操作手册-2026-05-09.docx`
- DOCX 渲染检查尝试使用文档技能提供的 `render_docx.py`，当前机器缺少 `soffice`，无法完成逐页 PNG 渲染；截图已内嵌在 Word 文档中。
- 已使用 macOS Quick Look 生成首屏缩略图进行抽查，封面、标题、表格和首张截图显示正常。

## 临时文件

- 截图目录、生成脚本、Playwright 临时依赖均位于 `output/` 下。
- 本次收尾时已清理 `output/`，避免误提交临时文件。