297 lines
10 KiB
Markdown
297 lines
10 KiB
Markdown
|
|
# 🖥️ 诺安宠物医院系统 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*
|