皮肤医美患者管理系统v1.0.0

一、产品概述

皮肤医美患者管理系统（以下简称"本系统"）是面向医疗美容机构与医院皮肤科门诊的本地化患者管理与临床记录系统，由成都炳兆医疗科技发展有限公司研发（官网：www.bzvmp.com），当前交付版本为 V1.0.0。

本系统以门诊业务全流程留痕为设计主线：从患者建档、就诊登记、治疗记录、影像归档、随访提醒，直至知情同意书签署与统计报表输出，全部收敛在一个桌面客户端内完成。所有业务数据保存在机构自有计算机的本地目录中，不联网、不上传云端。

交付形态为 Windows 安装程序，安装包体积约 14.5 MB，默认安装至 D:\皮肤医美患者管理系统，安装向导中可自行指定其他目录。

一句话定位：为皮肤科与医美门诊提供一套数据不出院、录入口径可统一、操作过程有留痕的患者管理系统。

二、设计原则

本系统在功能取舍上遵循四条原则，后续各章节的功能描述均可回溯到其中某一条。

第一，数据不出院。系统采用单机本地部署，数据库、影像原图、手写签名与导出报表全部存放在本机数据目录内，运行期不产生任何对外网络请求。机构对数据的物理位置有完全掌控权，也无需为云端存储与传输链路额外做合规评估。

第二，一次录入、多方共享。同一份数据只在一个位置录入，其余场景通过读取复用。患者基本信息在档案中维护，就诊与治疗记录引用之；操作医生与接诊医生字段直接读取系统账号表，不另建人员名单；报表与统计从业务表实时汇总，不依赖人工二次填报。

第三，口径先行。需要横向对比的字段（诊断结论、治疗部位、仪器设备、产品品牌等）一律由数据字典驱动，录入时只能从字典中选择，从源头保证同一含义只有一种写法，统计结果才具备可比性。

第四，权责可追溯。系统按岗位划分权限，关键操作（增删改、导出、签署、备份、恢复）均写入操作留痕，记录操作人、时间与对象，可筛选、可导出。

三、核心功能详解

本章按左侧导航的八个业务模块逐一展开，说明每个模块解决什么问题、由哪些字段与能力构成。各模块共用同一套数据底座——患者档案是主数据，治疗与影像挂在就诊之下，随访与同意书再挂到患者与项目之上，因此同一条信息只需录入一次。

（一）工作台

登录后的默认页面，用于回答"今天该做什么"。集中呈现当日待办随访、逾期提醒、近期就诊与治疗概况等入口级信息，点击任一数字可直接跳转至对应模块并带上筛选条件。

（二）患者档案：单页 360° 视图

新建档案支持手动录入与身份证读卡器录入两种方式。录入 18 位身份证号时，系统自动解析性别、出生日期与年龄；身份证号与手机号在保存时自动查重，避免重复建档。档案字段覆盖姓名、性别、年龄、身份证号、手机号、出生日期、籍贯、紧急联系人、既往病史，过敏史可由后台补充。

档案检索提供八项组合条件与关键词模糊匹配，支持按手机号、姓名、档案编号、就诊日期、诊疗项目等维度定位。页面提供"最近就诊"快捷入口，用于一键调取高频患者。

双击任一患者进入档案详情。详情页采用单页纵向布局而非标签页：基本信息、就诊记录、治疗记录、影像资料、随访计划、知情同意书六块内容自上而下排列在同一可滚动页面中，顶部设有固定的快速定位按钮，点击即跳转至对应板块。各板块表格行数随数据量自适应（最多展开 8 行，超出部分在表内滚动），并各自保留新增、编辑、删除等操作按钮。这一设计的目的，是让接诊人员在一屏之内完成对患者既往情况的通读，而不是在标签页之间来回切换。

（三）治疗记录：四区结构化留痕

治疗记录按激光光电、注射填充、操作与院感、评估四个区域组织字段，与门诊实际操作顺序一致：

● 激光光电区：仪器型号、治疗波长、能量参数、治疗部位、治疗时长、术中反应、术后即刻状态、禁忌项；

● 注射填充区：产品品牌、批号、注射剂量、注射部位、操作医生；

● 操作与院感区：操作步骤、消毒方式、敷料处理；

● 评估区：术前术后对比与疗效评价。

上述字段中，诊断结论、治疗部位、注射部位、仪器设备、产品品牌、敷料处理等属于只读下拉，只能从数据字典中选择；治疗波长、能量参数、治疗时长、注射剂量属于带单位的连续参数，采用可编辑下拉——常用值一点即选，特殊值可直接输入。两类控件共用同一份字典，保证了统计口径的稳定性。操作医生与接诊医生字段直接读取系统账号表，账号新增或停用后下拉即时同步。

每条治疗记录可关联术前、术中、术后、复诊四类影像，形成完整的疗效对照链。

（四）影像资料：缩略图墙与分类归档

「影像总览」以缩略图网格呈现全部影像，一屏五列，滚轮翻页。这是刻意的选择：影像资料的辨识依赖画面，文件名与日期只是辅助信息，列表形式会让检索效率大幅下降。

网格上方支持按影像分类、资料类型，以及患者姓名、档案编号、文件名进行筛选。点击任意缩略图打开高清查看器，支持缩放与原图查看。系统支持 JPG、PNG、TIFF、BMP 与 PDF 五类格式，VISIA 等设备导出的检测报告可与照片一并归档。

影像按患者与分类两级目录存放于本地数据目录，缩略图带内存缓存（按文件修改时间自动失效），全量 233 张影像首次渲染约 1.5 秒，二次进入约 0.7 秒。

（五）随访提醒：按紧急度分色

随访计划支持六个标准节点一键勾选生成（1 天、3 天、7 天、1 个月、3 个月等），生成时自动填充对应的健康宣教话术；也可单条新增、标记完成或标记失联。

「随访提醒」页面按紧急度整行着色，一眼可判断处理顺序：

颜色	级别	含义
红	已逾期	计划日期已过仍未闭环，需当天联系
橙	今日到期	今天必须完成
黄	3 日内	可提前安排
斑马纹	待随访	尚在排期
绿	已完成	已随访并留痕
灰	已失联 / 已取消	需重新激活

页面顶部色块兼作图例，点击某一色块即可只查看该类任务。顶部横栏的铃铛角标与左侧导航徽标同步变色——存在逾期任务时为红、仅今日到期时为橙，每 30 秒自动刷新。导出的 Excel 与 PDF 报表中同样附带"紧急度"列，纸质排班与系统排班口径一致。

（六）统计报表：五个维度与临床分析

统计模块包含五个标签页：患者统计、业务统计、临床分析、质量统计、员工统计。周期支持本月、本季、本年与自定义区间，切换即时重算。

其中「临床分析」是本系统区别于通用客户管理软件的模块。由于诊断结论、治疗部位、仪器设备、产品品牌等字段已纳入数据字典驱动录入，该页可直接按当前统计区间输出四张图表——诊断分布 TOP12、治疗部位分布 TOP12、仪器设备使用 TOP12、产品品牌构成，并在下方附一张带占比的明细表。这意味着机构可以回答"本季度哪个诊断的接诊量最大""哪台设备的使用率最高"这类临床运营问题，而不必人工翻查病历。

所有报表支持导出为真实的 .xlsx 工作簿与 .pdf 文档，图表随报表一并导出。

（七）知情同意书：模板可维护 + 手写电子签名

同意书模板可在菜单栏「同意书」中自行维护：新增、改名、修改正文、排序、停用。正文支持九个占位符——{name}、{gender}、{age}、{archive_no}、{phone}、{project}、{date}、{org}、{doctor}，签署时自动替换为患者与项目信息。系统出厂内置三套模板，其余可由机构按项目类型自行扩展。

签署界面提供鼠标手写电子签名（手写板支持，签名图单独留档），签署完成后记录进入同意书台账，可按患者、模板、时间检索与导出 PDF。既有的签署记录不会被模板改动影响：模板改名时，系统会同步更新历史上引用该模板的同意书记录，保证台账与引用计数不失真；已被引用过的模板禁止删除，只允许停用。

模板维护窗口为非模态独立窗口，可与主界面同时操作。这一设计是因为维护模板时常需一边改一边对照主界面上的患者表单与已签同意书清单；同一入口只保留一个窗口，重复点击会聚焦到已打开的窗口，避免两份数据被同时编辑。

（八）活动科普推送

按患者标签圈选目标人群，规划推送内容与推送渠道，记录推送状态流转。该模块用于支撑机构的患教与复购运营，本期实现为本地计划与记录管理，尚未接入微信等外部触达通道（详见第十章）。

四、权限体系与操作留痕

系统采用五角色 × 十八权限点的权限模型，按岗位而非按个人授权。

角色	权限范围概述
系统管理员	全部权限，含用户管理、系统设置、字典维护、数据恢复
医生	建档、编辑档案、治疗记录增改、影像上传与删除、随访管理、统计、同意书与字典维护
护士 / 治疗师	编辑档案、治疗记录增改、影像上传、随访管理、同意书
前台 / 咨询	建档与编辑档案、查看治疗记录、影像上传、查看随访、同意书
只读访客	仅查看患者、治疗、影像、随访与统计

十八个权限点覆盖患者档案的查、增、改、删，治疗记录的查、增、改，影像的查、传、删，随访的查、管，以及统计查看、同意书管理、用户管理、操作留痕查看、系统设置与字典维护。

菜单项与页面入口均按当前账号权限显隐或置灰，未授权的功能不会出现在界面上，而非点击后才报错。删除患者档案仅管理员可操作，且执行前二次确认。

所有关键操作写入操作留痕表，记录操作人、动作、对象与时间，可按账号、姓名、对象、动作、关键词与时间范围组合筛选，并导出为 Excel。

五、部署与交付

运行环境。Windows 7 SP1 及以上 64 位系统。安装程序已将 Python 运行时与全部依赖一并打包，目标机器无需预装 Python 或任何第三方库。

安装。运行安装程序，默认安装目录为 D:\皮肤医美患者管理系统。若该机器不存在 D 盘或 D 盘不可写，安装向导会自动回退至系统程序目录，用户亦可在向导中手动指定任意路径。安装过程需要管理员权限。安装完成后创建开始菜单快捷方式与桌面快捷方式（桌面快捷方式可在向导中取消勾选）。

首次运行。程序首次启动会在安装目录下自动创建数据目录并初始化数据库，生成四个默认账号（系统管理员、医生、护士/治疗师、前台/咨询）、出厂数据字典与三套同意书模板。默认账号的初始密码应在首次登录后通过「系统 → 系统设置 → 用户与权限」立即修改。

日常启动。通过桌面快捷方式或开始菜单启动，无需命令行操作。

升级。运行新版安装程序可直接覆盖安装，安装目录下的数据目录不受影响。

退出与切换账号。这两个动作在界面上是分开的：横栏最右侧的「退出系统」（或菜单「系统 → 退出系统」、窗口关闭按钮）用于关闭整个程序；菜单「系统 → 切换账号」用于更换使用者，返回登录页而程序保持运行。

六、版本说明与后续规划

本期（V1.0.0）已实现：患者档案全流程管理、治疗记录结构化留痕、影像归档与浏览、随访计划与分色提醒、五维统计报表与 Excel/PDF 导出、数据字典治理与一致性检查、知情同意书模板维护与手写电子签名、五角色权限体系与操作留痕、数据库备份与恢复、活动科普推送的本地计划管理。

本期未包含：与 HIS、收费系统、皮肤镜/VISIA 设备的自动化对接；微信小程序等顾客端触点。

数据层面已为顾客端预留患者、治疗、随访等结构，后续接入微信小程序与后端服务后即可启用预约、缴费与顾客自助查询等能力。设备对接与院内系统集成需按机构既有环境单独评估。

多机协同同样不在本期范围内。当前为单机部署模式；如需多台计算机共用数据，可将数据目录置于共享盘，或后续升级为"院内服务器 + 局域网客户端"架构。