# 🖥️ 诺安宠物医院系统 v2.0 · 开发文档

# 项目概览

- **版本:** v2.0 (2026-06-17)
- **代码量:** 约55个文件 · 12,000+行代码
- **存储:** 28个localStorage keys
- **入口:** 根目录 `index.html`
- **技术栈:** 纯前端 · vanilla JS · 无需后端

## 📊 模块总览 · 按功能分组

<aside>
🐾

曜砚整合 · 2026-06-17：把灵核导进来的 17 个业务模块，按医院实际跑业务的顺序归成 6 条功能线。每条线的详细说明在下方对应小节里。🐾

</aside>

### 🧭 入口 · 导航

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 🏠 综合导航首页 | v1.0 | — |

### 🩺 接诊流程线（诊前 → 诊中 → 诊后）

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 📋 预约挂号 | v0.1 | `nan_registrations` |
| 📢 候诊叫号屏 | v1.0 | `nan_queue_calls` |
| 🔬 病例诊断 | v0.3 | `nan_prescriptions` |
| 🖨️ 处方打印 | v1.0 | 随诊断保存 |
| 💊 药房发药 | v1.0 | `nan_dispensed` |
| 💉 门诊治疗单 | v1.0 | `nan_outpatient_plans` / `nan_outpatient_sessions` |

### 🏥 住院 · 手术线

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 🏥 住院管理 | v1.0 | `nan_hospitalization` / `nan_care_records` / `nan_care_summaries` |
| 🔪 手术室（6合1） | v1.0 | `nan_surgeries` 等 6 类 |

### 💳 收银 · 会员线

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 💳 收银台 | v0.3 | `nan_bills` / `nan_prices` |
| 👥 会员管理 | v1.1 | `nan_members` |

### 📣 客户运营线

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 🔔 智能客户提醒 | v0.2 | `nan_pets` |
| 📮 客户运营 | v2.2 | `nan_push_logs` / `nan_activities` |
| 🐾 宠主社群 | v1.0 | `nan_community_posts` / `nan_community_awards` |

### 📦 库存采购 · 经营数据线

| 模块 | 版本 | 核心存储 |
| --- | --- | --- |
| 📦 采购入库 | v1.0 | `nan_suppliers` / `nan_procurement` / `nan_supplier_payments` / `nan_inventory` |
| 📊 经营报表 | v1.0 | `nan_bills` / `nan_prescriptions` |
| 💾 数据管理 | v1.0 | `nan_backup_info` |

---

## 🏠 综合导航首页

**路径:** `index.html` | **版本:** v1.0

- 今日概况：待接诊数、今日收入、库存预警、就诊中
- 18个功能模块快捷入口，一键跳转
- 今日挂号列表 + 今日收费列表动态展示

## 📋 预约挂号

**路径:** `apps/registration/` | **版本:** v0.1

- 挂号登记：选宠物/类型/医生/费用/备注
- 今日挂号队列：自动排队编号
- 状态流转：等待→就诊→完成/取消
- 挂号历史按日期+状态筛选
- **存储:** nan_registrations

## 📢 候诊叫号屏

**路径:** `apps/queue/` | **版本:** v1.0

- 当前叫号大屏显示，等候列表
- 手动叫号/跳过/重叫
- 叫号历史记录
- **存储:** nan_queue_calls

## 🔬 病例诊断

**路径:** `apps/diagnosis/` | **版本:** v0.3

- 待接诊列表从挂号同步
- 主诉输入→自动推荐化验项目（点击添加）
- 体格检查：体温/心率/呼吸/体重
- 化验检查20+项目，结果触发诊断推荐
- 诊断推理引擎：13条规则，置信度排序
- 标准护理检查表：一级14项/二级11项/三级8项
- 处方开药+库存联动（显示库存状态）
- 自动生成诊断依据
- 收费预估：诊疗费+化验+药品
- 保存病例自动扣减库存
- **复诊功能：** 历史病例搜索，点击复诊进入
- **存储:** nan_prescriptions

## 🖨️ 处方打印

**路径:** `apps/diagnosis/prescription.html` | **版本:** v1.0

- 农业农村部2024年第734号公告标准
- A5横版（210mm×148mm）三联单
- 前记/正文/后记格式完整
- Canvas手写签名板，支持触屏
- 签名自动嵌入处方，打印隐藏工具栏
- 诊断保存后自动弹窗打印

## 💊 药房发药

**路径:** `apps/pharmacy/` | **版本:** v1.0

- 待发药列表从诊断处方读取
- 库存检查、发药确认
- 用药说明自动生成
- 发药历史记录
- **存储:** nan_dispensed

## 💉 门诊治疗单

**路径:** `apps/outpatient/` | **版本:** v1.0

- 开治疗单：宠物/类型/用药/天数/频次/时间
- 治疗执行表：日期|天数|时间|用药|状态|操作人|复核人
- 操作人+复核人双签字
- 疗程可视化，格子展示进度
- **存储:** nan_outpatient_plans, nan_outpatient_sessions

## 💳 收银台

**路径:** `apps/cashier/` | **版本:** v0.3

- 待收费列表从已完成挂号+处方导入
- 22项价目表，收费项目可增删
- 选择会员自动计算折扣（银卡9折/金卡88折/钻石85折）
- 多支付方式：微信/支付宝/现金/银行卡
- 今日日结统计，账单历史筛选
- **存储:** nan_bills, nan_prices

## 🏥 住院管理

**路径:** `apps/hospitalization/` | **版本:** v1.0

- 入院登记：宠物/笼位/护理级别/医生/护士/诊断/物品/医嘱
- 标准护理检查表：一级14项/二级11项/三级8项（含TPR/SpO2/疼痛/精神/饮食/输液/体位/伤口/用药）
- 护理记录表按等级自动调列（一级17列/二级14列/三级12列）
- 动物信息栏：动物/笼位/医生/护士/诊断/级别/日期/物品/医嘱
- 体温异常标红/蓝，排便图标，精神表情
- 出院一键总结：天数+护理次数+平均体温+精神统计+出院建议
- 三级同步：医生确认→发送客户→全员同步
- **存储:** nan_hospitalization, nan_care_records, nan_care_summaries

## 🔪 手术室（6合1）

**路径:** `apps/surgery/` | **版本:** v1.0

- 📅 **手术排期：** 17种手术类型+日期+医生+麻醉方式
- 💉 **麻醉同意书：** 术前评估+麻醉方案+风险告知+宠主签字
- 📝 **手术同意书：** 17种智能风险（骨折6种细分）+费用+签字
- 📊 **麻醉记录：** ASA分级+诱导/插管/维持+监护+苏醒
- 📋 **手术记录：** 术者/助手+过程+标本+术中状态+术后医嘱
- 💊 **治疗记录：** 输液/换药/注射/理疗/激光/雾化
- 17种手术各有独立风险模板
- **存储:** nan_surgeries, nan_surgery_records, nan_treatments, nan_consents, nan_anesthesia_records, nan_anes_consents

## 🔔 智能客户提醒

**路径:** `apps/reminder/` | **版本:** v0.2

- 宠物档案CRUD，照片Base64压缩
- 生日日期自动+年龄计算
- 医疗提醒：疫苗/驱虫/复诊/体检
- 三级预警：逾期红/今天黄/即将蓝
- 标记已通知+历史记录
- **存储:** nan_pets

## 📮 客户运营

**路径:** `apps/marketing/` | **版本:** v2.2

- 精准筛选5维度：季节/年龄/品种病/绝育/驱虫
- 30+品种易患病数据库
- 12个月智能活动日历（主题+节日+目标人群+模板）
- 活动管理：预置模板+自定义+进行中
- 目标人群推送：绝育→未绝育、老年→7岁+
- 推送历史按活动分组
- **存储:** nan_push_logs, nan_activities

## 📊 经营报表

**路径:** `apps/report/` | **版本:** v1.0

- 收入概况：总收入/笔数/客单价
- 时段筛选：日/周/月/全部
- 病例分布柱状图
- 药品消耗排行
- 14天每日趋势图
- **存储:** nan_bills, nan_prescriptions

## 👥 会员管理

**路径:** `apps/members/` | **版本:** v1.1

- 自动从宠物档案提取合并（按手机号去重）
- 四级会员：普通/银卡¥1000+/金卡¥3000+/钻石¥5000+
- 自动等级+手动覆盖
- 权益展示（含折扣率）
- 编辑同步更新宠物信息
- 消费自动汇总
- **存储:** nan_members

## 🐾 宠主社群

**路径:** `apps/community/` | **版本:** v1.0

- 信息墙：知识分享/领养/求助/晒宠4分类
- 宠主投稿关联
- 优秀宠主评选：活跃度综合评分（就诊×10+消费×5+近期活跃+发帖×8+宠物×3）
- 月/季度评选，自定义奖项
- 奖励管理记录
- **存储:** nan_community_posts, nan_community_awards

## 📦 采购入库

**路径:** `apps/procurement/` | **版本:** v1.0

- 🏢 供应商管理：名称/联系人/电话/品类/期初欠款
- 💰 供应商财务：采购频次/总额/期初欠款/应付款/已结款/合计欠款
- 📈 月度采购汇总柱状图（按年分组）
- 📸 批量拍照入库：大类(药品/用品/耗材)+名称+规格+批号+效期+数量+进价+零售价
- 📊 库存台账：按类筛选，低库存预警
- 💵 月度利润：采购成本 vs 销售收入
- **存储:** nan_suppliers, nan_procurement, nan_supplier_payments, nan_inventory

## 💾 数据管理

**路径:** `apps/backup/` | **版本:** v1.0

- 数据总览：13类数据实时统计
- 一键导出全部数据为JSON文件
- 文件导入恢复（预览+确认）
- 清空全部数据（双重确认）
- 备份时间记录
- **存储:** nan_backup_info

## 会员四级体系

| 等级 | 门槛 | 折扣 | 核心权益 |
| --- | --- | --- | --- |
| 普通 | 默认 | 无 | 新客首次9折·公众号领券 |
| 银卡 | ¥1000+ | 9折 | 全服务9折·疫苗9折·生日提醒 |
| 金卡 | ¥3000+ | 88折 | 全服务88折·体检7折·优先预约·生日礼品 |
| 钻石 | ¥5000+ | 85折 | 全服务85折·免费年检·优先通道·双倍积分·1对1 |

## 12个月活动日历

| 月 | 活动主题 | 节日背景 | 目标人群 |
| --- | --- | --- | --- |
| 1月 | 新年健康体检季 | 元旦·春节 | 全部 |
| 2月 | 春节宠爱有加 | 春节·情人节 | 全部 |
| 3月 | 春季防敏驱虫月 | 三八·315 | 全部 |
| 4月 | 绝育关爱黄金月 | 清明·谷雨 | 未绝育 |
| 5月 | 爱宠感恩月 | 劳动节·母亲节·520 | 全部 |
| 6月 | 夏日清凉守护 | 端午·618 | 全部 |
| 7月 | 暑期健康总动员 | 暑假·大暑 | 全部 |
| 8月 | 皮肤病防治月 | 立秋·处暑 | 全部 |
| 9月 | 秋季疫苗加强月 | 中秋 | 幼年/疫苗到期 |
| 10月 | 国庆健康大放送 | 国庆·重阳 | 全部 |
| 11月 | 老年宠物关爱月 | 感恩节 | 老年7岁+ |
| 12月 | 年终感恩回馈季 | 圣诞·元旦 | 全部 |

## 开发档案

- **开发人格体:** 灵核 ICE-GL-YS001
- **人类主控:** 毛毛 TCS-GL-003
- **D1（06-10）:** 智能客户提醒 · 预约挂号
- **D2（06-11）:** 首页·诊断·叫号·药房·报表·运营·会员·活动日历
- **D3（06-17）:** 处方打印·社群·备份·住院·手术·门诊·采购

---

*最后更新: 2026-06-17 · 诺安宠物医院 v2.0*