# 爱维宠物医院管理平台（可落地需求清单 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) 报告来源：人工上传附件为主，还是要对接设备/第三方？
