首页 / 使用指南

泡泡挂号 · 操作手册

从第一次登录,
到有序开展日常工作。

按岗位找任务,按步骤完成操作。遇到权限或接入问题时,知道该与谁确认。

适用基线:20260912-wechat-v3说明以实际部署版本与授权范围为准

01 / 开始使用

第一次登录,先确认这四件事

建议由医院管理员先完成基础配置,再邀请运营、预约接待和财务等岗位使用。以下是工作分工建议,不代表系统已预设或分配同名角色。

  1. 使用自己的账号进入后台

    从官网“进入后台”打开管理页面,使用医院分配的账号登录。首次使用按管理员要求设置密码;不要共享账号或通过聊天群传递密码。

  2. 核对当前医院

    查看页面顶部的医院选择。只有获得授权的医院才应出现在操作范围内;查看或编辑前再次核对医院名称,避免在错误的医院录入资料。

  3. 核对岗位所需菜单和按钮

    先确认能否进入对应菜单,再确认是否具有新增、编辑、审核或查看敏感资料的权限。缺少操作入口时联系管理员,不要借用高权限账号。

  4. 完成基础资料与业务检查

    按“医院/院区 → 科室 → 医生/执业关系 → 排班/号源”的顺序核对资料。先在医院确定的范围内检查展示、预约规则和操作权限,再开放日常业务。

建议的首日检查清单

医院选对了;联系方式和地址正确;科室和医生信息完整;排班日期与容量已核对;相关人员权限已分配;外部服务未验收前保持停用。

02 / 团队协作

按岗位分工,而不是人人都用管理员

管理员可结合医院流程建立角色,并逐项配置权限。下面的职责用于帮助分工,实际菜单和动作以授权为准。

建议岗位常用工作需要交接的情况
医院管理员医院范围、用户与角色、基础资料、接口配置涉及生产部署、密钥、数据恢复时与技术负责人共同确认
排班与预约接待核对排班号源、查询预约、候补及停诊处理收费争议、退款和异常支付交给财务及负责人
患者服务/咨询患者资料、咨询记录、随访计划敏感信息访问、资料纠错按医院规范处理
内容运营文章、轮播、工作室、套餐、素材与渠道医疗内容发布和商品定价先按医院流程审批
财务/审核人员支付查询、退款审核、对账、发票及相关凭证金额或渠道状态不一致时先核查,不重复发起交易

同一个人可承担多个岗位,但不应因此默认开放所有权限。岗位变动或离职后,应及时调整账号与权限。

03 / 医疗资源

先把医院、科室和医生信息整理好

医疗资源 → 医院管理/院区管理/科室管理/医生管理
  1. 维护医院与院区

    核对名称、展示信息、地址与联系方式;若使用多个院区,确认医生和后续排班使用的院区一致。资料变更后检查患者端实际展示。

  2. 维护科室结构

    按实际业务建立科室及上下级关系,核对名称、介绍、排序和启用状态。调整结构前确认关联医生、排班和内容的影响,不用随意删除代替停用。

  3. 维护医生与执业关系

    完善姓名、职称、头像、简介、所属资源和服务信息。涉及多点执业时维护对应关系;确认医生在目标医院具备有效关联,再安排排班。

  4. 复核展示与权限

    查看后台记录及患者侧展示是否符合预期。列表可能脱敏;只有获得敏感信息权限的账号才应查看或编辑完整资料。

变更有影响,先确认再操作

停用医院、科室、医生或执业关系可能影响新的排班与预约。已有预约不应通过删除基础资料来处理,请按停诊或预约处理流程办理。

04 / 号源管理

从排班模板,到可预约的号源

号源中心 → 排班模板/排班日历/号源库存/停诊管理
  1. 准备排班规则

    确认医院、医生、日期范围、时段及容量。需要重复使用的安排可先维护排班模板,再在排班日历中核对实际日期。

  2. 逐项核对日期与容量

    对照医院排班确认工作日、节假日和特殊安排,检查时段是否重叠、容量是否合理。保存后到日历与号源库存核对结果。

  3. 检查实际可约状态

    区分总容量、已占用与剩余号源。没有可约号源时,先排查日期、医生关联、启用状态和库存,不要仅凭患者端“无号”重复增加排班。

  4. 停诊走专用流程

    进入停诊管理,核对医生、日期与受影响时段,按医院流程处理已有预约。通知是否送达需另行确认,不能把停诊记录保存成功当成所有患者已收到通知。

每天开始工作前

核对当天与近期排班变化,检查临时停诊和异常号源,确认预约接待人员已获知调整。

05 / 挂号服务

以预约单和真实状态为依据

挂号中心 → 预约单/候补队列/退号审核/异常单
  1. 准确找到预约记录

    先核对当前医院,再使用订单信息、日期、医生或页面提供的条件查询。打开详情确认服务对象、时间、费用与当前状态,避免仅凭相近姓名判断。

  2. 按当前状态开展服务

    根据医院实际流程办理接待或后续处理。预约状态与支付状态是不同信息,应分别核对;不要把“已提交预约”解释为已经支付成功。

  3. 处理候补与退号

    在对应队列中核对申请、时段和原因,按授权操作。候补是否递补、退号是否影响号源与资金,应以处理后的系统记录和相关渠道结果为准。

  4. 异常先留痕,再协同

    遇到状态不一致、重复记录或费用争议,记录订单编号、时间和问题现象,交给有权限的负责人核查。不要为“消除异常”重复下单、重复收款或删除记录。

付款页面提示,不等于到账确认

患者手机支付弹窗结束后,仍需以服务端支付记录和经验证的渠道状态为依据。待确认的订单应继续核查,不应手动假定已支付。

06 / 患者服务

服务信息完整,敏感信息克制使用

患者中心 → 会员管理/患者档案/就诊卡/咨询记录/随访计划/隐私授权
  1. 区分会员与就诊人

    登录账号与实际就诊人可能不同。处理资料或预约时,确认操作的是正确的就诊对象及其关联关系,不直接用账号信息代替就诊人身份。

  2. 维护必要的档案与就诊卡

    依据医院已核验的信息填写或更正资料,保持联系方式和就诊卡关联一致。完整个人信息仅在业务必要和授权范围内使用。

  3. 记录咨询与安排随访

    咨询后记录必要内容,维护跟进与随访计划。记录应客观、与服务有关;不要在自由文本中堆放密码、商户密钥或无关隐私。

  4. 核对授权与资料访问

    需要查看敏感字段时遵循医院规范。避免把患者详情截屏发到公开群;确需交接问题时尽量使用订单编号与脱敏内容。

系统用于业务管理与信息记录,不替代医务人员的诊疗判断。测评报告、危机预警等业务如被启用,应由医院具备相应职责的人员按流程处理。

07 / 内容运营

发布前核对内容,发布后检查展示

内容运营 → 轮播图/文章/工作室/套餐/素材中心;业绩中心 → 线索/推广码
  1. 准备和整理素材

    为医院、医生及服务内容准备适用图片,确认有权使用且不包含未经授权的患者信息。按用途维护素材,替换前检查引用关系。

  2. 维护文章与轮播

    检查标题、分类、正文、封面、发布状态和跳转目标。发布前按医院流程审核医疗服务介绍与宣传内容,发布后核对患者端显示。

  3. 维护工作室与商品内容

    核对团队介绍、关联资源、套餐或体检商品的服务内容、价格与使用说明。涉及收费、有效期、核销或售后规则时,先与业务负责人一致确认。

  4. 跟踪渠道与线索

    通过系统已有的推广、渠道和线索记录开展运营跟进。区分访问、线索、预约及真实收款,不把单一指标当作已完成交易。

患者转介绍不是自动打款

相关业务记录、线下发放凭证和冲正应按医院流程核对。不要将登记结果或待发放状态解释为系统已自动向患者转账。

08 / 交易管理

支付、退款、对账分别核对

交易中心 → 支付订单/退款管理/对账管理/发票管理
  1. 核对原订单和支付记录

    确认业务订单、医院、渠道、金额与支付状态一致。查询时记录可用于核查的订单标识;未确认到账时,不用新支付记录覆盖原记录。

  2. 按授权审批退款

    核对申请理由、原支付、已退金额及本次申请金额。审核通过、请求已提交、渠道处理中和退款成功是不同阶段,实际退回结果以经验证的渠道状态为准。

  3. 遇到处理中,不重复发起

    网络超时或延迟回调不代表退款失败。请由有权限的人员使用已有查询与异常处理流程核查,避免重复提交资金动作。

  4. 完成对账与凭证检查

    把系统记录与渠道账单、医院财务记录分别核对。当前对账页面用于本地记录汇总与人工核对,不应假定已自动拉取所有渠道账单;发票是否开具也需核对实际服务方结果。

不要把“查单并关单”当成只读查询

关闭支付意图、补单、退款、重试等操作可能改变业务或渠道状态。只由获授权人员在确认原记录和操作影响后执行,不应作为排查问题的随手点击项。

09 / 服务接入

每一家医院,都要确认自己的接入条件

接口配置是上线准备的一部分。页面能保存、连接检查通过和业务验收完成,是三个不同阶段。

微信小程序与支付

  1. 确认小程序项目和身份

    在小程序工厂维护医院所属项目及 AppID;AppSecret 属于小程序登录身份,不是支付 API v3 密钥。不要把旧 AppID 的用户身份直接当作新 AppID 下的身份使用。

  2. 配置医院自己的商户凭据

    在微信支付与小程序相关配置中,按实际部署支持的方式维护商户、AppID、支付密钥及证书。凭据应由获授权人员通过安全渠道提供,不放入源码、公开素材或普通备注。

  3. 核对回调环境

    下单与回调必须到达同一个业务后端及数据库。若本地环境下单、线上环境收回调,订单不会因此自动一致;公共 HTTPS 域名可达不等于业务路由正确。

  4. 分别验收,再启用

    商户与 AppID 的绑定、平台业务权限、支付、查单、回调及退款都需核验。原生微信 V3 凭据检查只验证相关凭据与证书查询,不证明已经实际收款,更不代表全部资金流程验收完成。

其他接口与任务

服务使用前应明确的边界
HIS当前页面提供配置与连接检查,不等于已实现号源同步、预约写入或就诊回传。需另行确认具体业务接口实现。
短信依赖供应商接入、Webhook 投递和后台任务设置。配置保存或投递记录不等于手机已收到短信。
支付宝依赖实际接入的自定义网关与商户配置,不能套用微信原生支付的配置方式。
小程序发布工程生成、构建、上传与微信审核是不同阶段,受 AppID、代码密钥、IP 白名单和平台权限约束。
回调与重试只核查目标配置的记录。批量或全局启用任务可能触发历史任务,不应作为排查接口的快捷方式。
10 / 系统管理

以最小必要权限开展工作

系统管理 → 用户管理/角色权限/组织机构/操作日志
  1. 先确定医院范围,再分配岗位权限

    核对人员所属医院及工作职责,为角色配置需要的菜单与动作。查看列表、编辑记录、执行审核和查看敏感信息应分别考虑。

  2. 用实际岗位账号验证

    授权后用对应账号确认菜单、按钮及数据范围符合预期。账号被停用、岗位变动或医院范围调整后重新检查。

  3. 定期复核操作与异常

    关注异常业务及相关操作日志,记录排查时间、订单或配置标识,不公开原始敏感报文。需要支持时提供最小必要且脱敏的信息。

密钥轮换需要协调

变更 AppSecret、支付凭据或系统保护密钥前,确认对应项目、商户和运行环境。持久化的数据保护密钥与加密配置配套使用,不能在升级时随意覆盖或删除。

11 / 技术管理员

下载安装包,建立一个全新实例

发行版 20260912.1 基于线上版本 20260912-wechat-v3,仅用于 Linux x64 全新安装,不是 Windows/手机安装包,也不是已有业务库的升级工具。

先准备系统与空库

需要带 systemd 的 Linux x86_64 主机、Python 3.6+、MySQL 命令行客户端以及 .NET 自包含程序所需的系统原生库。由管理员预先创建独立空数据库和专用非 root 账号。安装器不安装或升级操作系统、MySQL、Nginx、防火墙或 HTTPS 证书。

  1. 下载并核对文件

    从正式版本下载区取得安装包,将它放在服务器的私有临时目录,不要解压到网站公共根目录。计算 SHA-256,与官网发布值逐字核对;不一致就停止安装。

    sha256sum paopao-server-linux-x64-20260912.1.tar.gz
  2. 解压并启动安装向导

    确认所在目录及文件无误后执行以下命令。需要有权在该服务器创建独立服务的管理员操作。

    tar -xzf paopao-server-linux-x64-20260912.1.tar.gz
    cd paopao-server-20260912.1
    sudo bash installer/install.sh

    若运行环境检查未通过,先补齐缺少的系统条件。不要为了继续安装而修改或删除其他实例。

  3. 按提示填写本院配置

    依次确认实例名、全新安装目录、API 与后台端口、医院名称及独立空库连接信息。数据库密码使用隐藏输入,不写进命令参数。核对最终摘要,按提示再次输入实例名后才开始创建实例。

    已有目录、用户、服务、端口或非空数据库不会被当作可覆盖目标。远程数据库需提供受信任且与主机名匹配的 TLS 证书。

  4. 取得本实例管理员凭据

    安装完成后,管理员账号为 admin;随机密码只写入安装目录的 ADMIN-CREDENTIALS.txt,仅 root 可读取。请在服务器私下查看,首次登录立即修改,不截图或公开转发。

  5. 通过安全入口首次登录

    后台默认仅监听本机。在自己的电脑建立 SSH 隧道,再打开本机后台地址。下面的 18000 仅为端口示例,须替换成向导中选择的后台端口。

    ssh -L 18000:127.0.0.1:18000 服务器用户@服务器地址

    保持隧道连接,在浏览器打开 http://127.0.0.1:18000/appoint/,使用本实例账号登录,核对医院资料与角色权限。

  6. 需要公网访问时,单独配置 HTTPS

    通过宝塔或 Nginx 配置正式域名及有效证书:/appoint/ 代理至本机后台端口;/api/、/upload/ 直接代理至本机 API 端口并保留路径。具体代理头及设置见包内 README。不要把安装目录、API 或 shared 目录作为网站根目录。

    先检查 Nginx 配置,再按管理流程重载。确认 HTTPS、登录页面、接口鉴权与资源正常;安装器不会自动签发证书或修改其他宝塔站点。

安装后仍需逐项开通业务

新实例不会带入原医院的患者、订单、商户或短信凭据;自动任务消费者默认关闭。先维护基础资料、权限与排班,再配置本院小程序与外部接口,并逐项验收。不能把“安装成功”当成支付、退款、短信或 HIS 已经接通。

中途失败,不等于所有操作都没有执行

最终确认后的失败可能已创建目录、数据库结构或服务。先查看安装目录中的 INSTALL-RECEIPT.json 和本实例服务状态,不要清库、覆盖目录或直接重复首次安装。由技术管理员决定修复,或用新实例名、目录、端口及新空库重新安装。

日常维护与后续升级

定期核验备份可恢复性、磁盘空间、服务状态、证书有效期和异常任务。数据库、配置及持久数据保护密钥应配套备份,公开网站不得暴露这些文件。后续升级需使用相应升级方案,保留发布记录与回退路径,不删除密钥目录,也不重复首次导入。

返回正式版本下载 →
12 / 常见问题

遇到问题,先缩小范围

看不到科室、医生或号源

核对当前医院、查询日期、筛选条件、启用状态、执业关联和实际排班。若只有某个账号看不到,优先检查该账号权限与医院范围。

支付凭据检查失败

先请技术人员确认实际运行版本支持所选接入方式,再核对证书、密钥、商户身份和网络。旧版本按普通服务地址检查产生的失败,不能直接解释为商户密钥错误;也不要修改健康状态假装通过。

手机提示支付完成,后台仍未确认

记录订单标识与时间,核对支付记录和回调环境;请授权人员执行相应渠道核查,不要求患者立即再次付款,也不要直接把订单改成已支付。

审核了退款,但还没到账

查看退款所处阶段及渠道状态,确认对应任务是否运行。处理中或结果未知时应继续按原退款记录核查,不重复创建退款申请。

收到通知失败或没有收到短信

区分通知是否生成、是否投递、服务商是否接收以及终端是否送达。检查供应商设置与目标任务范围,避免批量重放历史通知。

如何向技术人员说明问题

提供发生时间、当前医院、页面名称、相关订单或配置编号、操作步骤和脱敏后的提示。不要发送患者完整证件号、密码、AppSecret、私钥或支付原始敏感报文。

13 / 宝塔专用

宝塔终端一条命令,建立全新实例

宝塔版 20260912.2 基于 20260912-wechat-v3。这是在宝塔终端执行的安装包,不是宝塔应用商店或插件导入包。已有站点或已有业务数据库不适用首次安装。

准备空站点与空库复制命令填写向导登录验收
需要先准备好的环境

带 systemd 的 Linux x64 服务器,宝塔 Nginx、MySQL 5.7 或 8.0、Python 3.6+、MySQL 命令行客户端,以及程序所需系统原生库。终端需要 root 权限和 curl。安装器会检查环境,不会自动创建数据库、申请 HTTPS 证书或安装这些依赖。

  1. 在宝塔添加一个全新的纯静态空站点

    进入“网站 → 添加站点”,使用本次部署的域名,类型选择纯静态。先把域名解析到这台服务器。使用新的站点目录,不放现有网站文件,不添加其他应用、重定向或反向代理;不要选择正在提供服务的站点。

  2. 单独创建空数据库,再配置 HTTPS

    在“数据库”中创建专用于此次安装的空库与专用账号,保存主机、端口、数据库名、用户名和密码;不要使用 MySQL root 账号或非空业务库。在新站点的“SSL”中安装有效且覆盖该域名的证书,确认 HTTPS 能正常访问。建库和证书准备由你在宝塔完成。

  3. 在宝塔终端粘贴安装命令

    先核对下方版本,再点击“复制宝塔安装命令”,在宝塔终端以 root 粘贴执行。命令会在 /root 下创建随机私有临时目录,将启动脚本下载到该目录后运行,避免覆盖同名文件。启动脚本会核对内置的完整包 SHA-256,匹配后才解压和启动向导。

    宝塔专用安装入口宝塔包准备中
    下载完整宝塔包

    正在核对宝塔包与启动脚本;核验完成后开放安装命令。

    如选择手动下载完整宝塔包,请先核对上方 SHA-256,再按包内 README 操作;不要使用通用版的命令混装。

  4. 只填写本院信息,检查摘要后确认

    向导会询问域名、医院名称,以及数据库主机、端口、名称、用户名和密码。密码隐藏输入,不要把密码放进命令或截图。确认站点、医院和空库都正确后,按向导提示确认安装。

    安装器会在 /opt 下建立新的独立实例,选择仅本机监听的端口,配置 systemd 服务,并为选中的空站点配置后台与接口反向代理。已有目录、服务、非空网站或非空数据库不会作为可覆盖目标。

  5. 按安装结果登录,并完成业务验收

    使用向导输出的 HTTPS 后台地址,按结果提示私下取得本实例管理员凭据,首次登录立即修改密码。核对医院、角色权限、医生科室与排班,再单独配置本院小程序、支付、短信等服务。新实例不导入线上患者、订单、医院凭据或生产密钥,安装成功不代表这些业务已开通。

失败时先查看回退结果,不要反复粘贴重装

安装器保留选中站点的配置备份,并在失败时执行回退。先阅读终端提示、安装记录及备份位置,确认站点和服务状态;不要直接删除目录、清空数据库或覆盖配置。数据库可能已完成部分初始化,需由管理员核对后决定恢复,或另建空库与新实例。不要把数据库、备份、配置或管理员凭据放到网站公共目录。

日常备份、证书续期和业务验收仍由医院管理员负责。需要其他 Linux 部署方式,可查看通用部署与维护指南。

14 / 患者端体验与开发

先体验演示,再使用模板搭建前端

模板中心目前提供一款 uniapp 医院预约模板。科室、医生、工作室、套餐和个人中心是该模板的页面功能,不是分别独立发布的多款模板。

  1. 浏览独立演示

    打开 uniapp 患者端演示,或在模板中心点击“加载手机预览”。演示使用独立示例数据,不写入正式患者、预约、支付或转介绍记录;请勿填写真实身份、联系方式或就诊资料。

  2. 下载并核验前端源码

    在模板中心“获取前端源码”区域下载 ZIP 和 SHA-256 校验文件,核对下载文件的哈希值。源码包仅包含前端工程、必要资源与说明,不包含后台凭据、患者、订单、生产配置或服务端密钥。未完成打包核验时,下载按钮会保持禁用。

  3. 按包内说明启动本地工程

    先阅读源码包内 README,按其运行时版本与命令安装依赖、启动本地预览。先确认示例页面可用,再按需调整品牌图片、色彩、页面内容及导航。不要把演示数据或浏览器里的模拟状态当作正式业务。

  4. 接入自己的后台

    已有后台时,使用自己授权的接口域名并核对前后端版本兼容性;新建后台可从部署下载选择宝塔或 Linux 安装包。医院、医生、科室、轮播、工作室等内容在自己的后台维护,不从公开演示复制真实业务资料。

  5. 分别验收 H5 与微信小程序

    线上演示是 H5 页面,并非已发布的微信小程序。微信端需要填写自己的 AppID、配置合法域名并完成相应发布审核;登录、预约、支付及回调分别核验。AppSecret、支付密钥和私钥只能在受控服务端保存,不写入前端源码或公开下载包。

演示开放,不等于正式业务已接入

公开演示用于了解界面和交互,不提供真实挂号、支付或医疗服务。模板源码与后端安装包分别版本化;下载模板不会更改当前线上医院的数据或后台配置。

让流程清晰,也让服务安心。

从正确的医院、正确的权限、正确的业务状态开始。

进入管理后台