From d59dce511d0cc2ba2138808b79041f47fdfd1126 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=80=81=E7=8E=8B?= <1702282943@qq.com>
Date: Wed, 28 Jan 2026 10:24:46 +0800
Subject: [PATCH] docs: add requirements checklist v1

---
 需求清单.md | 178 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 178 insertions(+)
 create mode 100644 需求清单.md

diff --git a/需求清单.md b/需求清单.md
new file mode 100644
index 0000000..d088be3
--- /dev/null
+++ b/需求清单.md
@@ -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) 前端技术：Vue3（SPA）还是模板渲染（如 Thymeleaf）？
+2) 形态：一个 Web 站点多入口，还是顾客端另做 H5/小程序？
+3) 支付：MVP 仅记录支付状态，还是要真实对接？
+4) 多门店/多院区：是否必须？
+5) 报告来源：人工上传附件为主，还是要对接设备/第三方？