docs: add requirements checklist v1

This commit is contained in:
2026-01-28 10:24:46 +08:00
parent 36910a6156
commit d59dce511d

178
需求清单.md Normal file
View File

@@ -0,0 +1,178 @@
# 爱维宠物医院管理平台(可落地需求清单 v1
来源:`关鹏飞-开题报告.md`(提炼 + 落地化改写)
## 0. 目标与范围
### 0.1 建设目标
- 提升宠物医院运营效率:流程标准化、无纸化、减少排队与人工重复录入。
- 优化宠物主就诊体验:在线预约、随时查询档案/病历/处方/报告。
- 保障诊疗数据安全:权限控制、审计(可选)、数据备份策略(可选)。
### 0.2 系统用户与角色
- 管理员(后台全局管理)
- 宠物医生(诊疗业务)
- 顾客/宠物主人(前台自助服务)
### 0.3 MVP 建议边界(用于阶段验收)
- 顾客端:注册登录、宠物档案、门诊预约、订单/支付(可先做“线下支付/模拟支付”)、报告/处方查询
- 医生端:门诊接待(接诊/叫号/分诊简化)、病历、处方
- 管理员端:账号管理、公告管理、药品/耗材库存、基础统计
---
## 1. 权限与通用能力RBAC
### 1.1 账号体系
- 支持登录/退出
- 支持注册(顾客)
- 支持重置密码(管理员为员工重置;顾客找回可选)
### 1.2 权限控制
- 管理员:拥有最高权限,可进行门诊/病例/宠物档案等全局增删改查
- 医生:仅能处理授权范围内的诊疗数据(默认本人接诊记录;可扩展到科室/门店)
- 顾客:仅能访问“本人 + 本人宠物”的数据
### 1.3 通用能力(建议)
- 操作审计日志(可选,建议对:删除、作废、退款、库存出入库等关键操作记录)
- 文件上传(报告附件、宠物头像等)
- 数据导出Excel/CSV报表二期可增强
---
## 2. 顾客端(前台)需求
### 2.1 登录/注册
- 顾客注册信息:手机号/邮箱(二选一)+ 密码(验证码可选)
- 登录后进入个人中心
### 2.2 就诊指南(内容展示)
- 展示门诊预约流程、就诊要求、注意事项
- 内容由管理员维护(后台公告/文章形式即可)
### 2.3 系统公告
- 公告列表/详情
- 支持置顶、发布时间、下架
- 场景:医院通知、优惠活动、疫苗/驱虫提醒类公告
### 2.4 留言板/咨询
- 顾客提交:标题、内容、联系方式、提交时间
- 管理员处理:回复内容、处理状态(待处理/已处理)
### 2.5 个人中心
- 个人信息:姓名/昵称、联系方式等
- 查看我的宠物列表
### 2.6 宠物档案(顾客自助)
- 新增/编辑宠物:名称、品种、性别、生日、体重、照片(可选)
- 疫苗/驱虫记录:日期、项目、备注、下次提醒日期
### 2.7 门诊预约
- 预约信息:门店/科室/医生(可选)、日期、时段、就诊宠物、备注
- 预约状态:待确认/已确认/已到诊/已取消/爽约
- 顾客可取消(规则:如就诊前 X 小时内不可取消,规则可选)
### 2.8 我的订单 & 在线支付
- 订单列表/详情
- 订单状态:未支付/已支付/已取消/退款中/已退款
- 支付:
- MVP记录支付方式与支付状态线下/模拟)
- 二期:对接微信/支付宝
### 2.9 报告查询
- 按宠物/时间筛选
- 报告形式:文本摘要 + 附件(图片/PDF
### 2.10 处方查询
- 查看医生开具的电子处方
- 支持下载/打印(可选:导出 PDF
---
## 3. 医生端(后台)需求
### 3.1 个人中心
- 个人资料维护
- 查看历史诊疗记录
### 3.2 门诊接待/门诊管理
- 查看预约列表(按日期、状态筛选)
- 到诊登记/叫号(可简化为状态流转)
- 创建就诊记录Visit并关联顾客、宠物、预约
### 3.3 宠物信息查询
- 查看宠物档案、疫苗/驱虫记录、既往病史
### 3.4 病历管理
- 创建/编辑病历:
- 主诉、现病史、体格检查、检查结果、诊断结论、治疗方案、医嘱
- 病历与就诊记录关联
- 病历状态:草稿/已完成(可选)
### 3.5 处方管理
- 开具处方:药品明细(名称、规格、数量、用法用量、天数)
- 处方状态:草稿/已提交/已发药(可选)/已作废
- 支持打印/导出(可选)
---
## 4. 管理员端(后台)需求
### 4.1 账户管理
- 员工账号管理:新增、禁用、重置密码、分配角色
- 顾客账号:查看/禁用(可选)
### 4.2 公告管理
- 发布、编辑、置顶、下架
### 4.3 药品/耗材管理(库存)
- 药品资料:名称、规格、单位、库存、预警阈值(进价/售价可选)
- 入库:入库数量、入库时间、经办人
- 出库/消耗:消耗数量、消耗时间、关联处方/手工出库MVP 可先手工)
- 预警:库存低于阈值的列表提示
### 4.4 数据管理(全局)
- 门诊管理:全局查询、纠错、删除(建议保留审计)
- 病例管理:全局查询、纠错、删除/作废
- 宠物档案管理:全局查询、纠错
### 4.5 统计报表
- 基础报表:
- 收入统计(按日/周/月)
- 订单数量
- 医生业绩(按医生汇总)
- 导出 Excel建议二期
---
## 5. 数据实体草案(用于 ER 图/数据库设计)
> 该部分用于数据库设计草案,可按项目栈进一步细化字段。
- User用户顾客/员工)
- Role / Permission或简化为 user.role
- Pet宠物
- VaccineRecord疫苗/驱虫记录)
- Appointment预约
- Visit就诊/门诊记录)
- MedicalRecord病历
- Prescription处方
- PrescriptionItem处方明细
- Drug药品
- StockIn入库流水
- StockOut出库/消耗流水)
- Order订单
- Payment / Refund支付/退款,可 MVP 合并到 Order
- Report检查报告文本 + 附件)
- Notice公告
- MessageBoard留言
---
## 6. 关键待确认点(决定后续架构与实现)
1) 前端技术Vue3SPA还是模板渲染如 Thymeleaf
2) 形态:一个 Web 站点多入口,还是顾客端另做 H5/小程序?
3) 支付MVP 仅记录支付状态,还是要真实对接?
4) 多门店/多院区:是否必须?
5) 报告来源:人工上传附件为主,还是要对接设备/第三方?