Worldhub 药店经营管理系统 · 全功能使用说明

版本适用：当前所有模块（销售 / 采购 / 库存 / 会员 / 促销 / 报表 / GSP / 麻精 / 追溯 / 医保 / AI）用途：按“页面 → 输入框 → 按钮 → 作用”逐项说明，供店员、店长、管理员上手使用。

登录与主界面

账号、密码登录。首次登录或历史管理员被重置时，系统会强制提示修改初始密码。
登录失败提示“账号或密码错误”或“账号已锁定”。
默认管理员：admin（初始密码见系统重置说明，登录后请在「系统设置 → 修改当前用户密码」改密）。

主窗口布局

左：侧栏导航（按角色隐藏无权限项）。顶上有「☰」按钮可折叠/展开侧栏。
顶栏：全局搜索框（Ctrl+Q）、时钟。
底部状态栏：当前用户/角色、数据库（已加密）、授权状态、OCR 引擎状态。
帮助菜单（顶栏）：快捷键说明、输入许可号码激活、联系公司。

全局快捷键

按键	功能
`F1`	帮助 / 快捷键说明
`F2`	快速跳转采购入库
`F3`	快速跳转销售 POS
`F4`	进入销售并弹出结算
`F5`	配药助理
`F6`	销售查询/退货
`F7`	会员
`F8`	交班日结
`Ctrl+Q`	全局搜索药品
`Delete`	删除当前收银行

1. 主驾驶舱（dashboard）

今日经营一览，点指标卡可跳转对应页面。

今日营收（跳销售）：当日销售额（已扣退货）。
今日单数（跳销售查询）：当日销售单数。
库存资金占用（跳药品档案）：库存 × 成本。
近效期 30 天（跳库存）：30 天内到期的批次数。
缺货 / 低库存（跳采购）：低于最低库存的品规数。
当前挂单（跳收银）：挂单数量。
需关注品规表：近效期 + 低库存清单（最多 50 条）。
最近销售表：最新销售单号/金额/支付/时间。
底部快捷按钮：扫码入库、快速销售 F3、销售查询 F6、会员 F7、交班 F8、AI 配药（按角色显示）。

2. 配药助理（assistant）

多语言病情描述 → AI 推荐药品，并可将有库存药一键加入收银。

顾客语言下拉：中文 / 维吾尔语 / 藏语 / 蒙古语 / 英语（右侧输入框随之切换文字方向与字体）。
病情描述框：用顾客语言描述症状。
AI 配药按钮：调用当前 AI 后端（DeepSeek 或豆包）按本店库存档案推荐药品。
清空按钮：清空全部输入与结果。
中文理解：AI 对病情的中文摘要。
推荐药品表：中文通用名 · 库存 · 规格 · 用法用量 · 注意事项 · 类型（处方药/OTC）· 来源（本店有货/档案有/中文名推荐）。
有库存加入收银按钮：把本店有货的推荐药一次性加入收银购物车（含处方药提醒）。
给顾客说明（顾客语言）：可改，最终翻译以此为准。
中文意见：要转达顾客的话，可手改。
意见翻译到下拉 + 翻译意见按钮：把中文意见译成所选语言，供柜台口述。
说明：处方药须执业药师审核后售；危急症状会提示立即就医。

配药、翻译均使用「系统设置」中选定的 AI 后端（详见第 20 节）。

3. 药品档案（drugs）

左侧分类树 + 右侧药品列表 + 选中药品的批次/附件/说明详情面板。

顶栏

搜索框：按药品名/商品名/条码/批准文号等搜索。
新增 / 编辑 / 删除：维护药品档案。
导入 / 导出：XLSX/CSV 批量导入；导出 Excel。导入支持“药品说明/使用方式/用法用量/适应症”等列。
变更日志：查看该药历次价格/字段变更留痕（谁、何时、从多少改到多少）。
扫码/别名匹配：新建时录入条码，之后采购/销售可用扫码枪快速匹配。

药品档案表单（新增/编辑弹窗）字段

条码、通用名、商品名、剂型、规格、单位、零售价、会员价、成本价、库存、最低/最高库存、拆零系数/单位、有效期、批号、厂家、批准文号/注册证号、医保编码/类型、储存/储存温度、功能主治/分类、药品分类、类型（OTC/处方药）、管理类别，以及四个文本块：

适应症/能治疗的病情
吃药/使用方式（一次X、一日X次）
用法用量明细与疗程
药品说明（说明书要点）
「AI 补全档案说明」按钮：依通用名/规格/厂家生成上述内容草稿（后台线程），提醒“以实际说明书/执业药师审核为准”。

左侧分类树

右键弹出菜单：新增子分类 / 重命名 / 删除分类。选中分类后列表只显示该分类及其子分类药品。

选中药品的详情面板

适应症 / 用法 / 说明摘要。
批次表：该药各批号的批号/有效期/成本/批次库存。
附件表：说明书/图片/检验报告/证件等附件；按钮 上传附件 / 打开附件 / 删除附件。

4. 采购入库（purchase）

智能采购：OCR 识别进货单、粘贴 Excel、AI 编制、扫码枪快速录入、按批号入库。

顶栏按钮

拍照识别 / 选择进货单图片：用 PaddleOCR 本地识别纸质进货单（离线），把药材按行填入明细。
生成入库明细：把 OCR 原始文本按行解析成明细（可手工修正文本后再生成）。
AI 编制入库单：把 OCR 文本交给 AI 整理成结构化明细并给建议（需 AI Key）。
保存草稿：保存当前明细为草稿（不扣库存）。
审核入库：确认入库，按批号分堆入库（同批合并、不同批分堆），扣/加库存与批次。
打印入库单：打印当前单的入库单。
新建单据：清空新建一张空白入库单。
供应商下拉：选择本次供应商。
扫码输入框（USB 扫码枪）：对准药品条码回车，自动从档案匹配并加一行（自动带出规格/成本/批号/有效期）。

明细表

列：品名（下拉自档案，可手输）、规格、数量、单价、批号、有效期。底部 「新增空行」 按钮。

明细表格支持粘贴（Ctrl+V 多行：品名规格数量单价）。
AI 入库备注区：显示 AI 建议，可改。

下方：采购历史单据

日期范围（从/到）、供应商、关键字筛选；查询历史。
打开单据 / 复制再入库 / 采购建议。
采购建议按钮：生成“低于最低库存”的补货清单填入明细（补批号后入库）。
历史表按供应商/日期/药品翻单，双击打开。

5. 销售POS（sales）

收银开单，扫码/拼音/通用名加购，支持会员价、拆零、赠品、满减、积分抵现、赊账。

顶栏

扫码/拼音/通用名回车：加购（输入时实时弹出匹配建议列表，点选加入）。
会员价勾选：启用会员价（指定品种活动价优先自动生效）。
拆零勾选：按档案“一盒几粒/板”以粒/板计（整盒进、按粒卖）。
+1 / -1：当前行数量加减（拆零时按系数步进，超库存会提示）。
本行为赠品：当前行单价改为 0。
删除行 / 清空：删当前行 / 清空购物车。
结算 F4：进入结算弹窗。
挂单 / 取单：把当前购物车暂存为挂单 / 取出挂单继续结算。
打印：重打最近一张销售小票。

会员行

会员输入框：手机号/姓名/卡号回车识别；可 识别 / 新建会员 / 清除，并显示当前会员姓名、积分与欠款。
班次状态：显示当前班次，未开班结算前会提示开班。

购物车表

列：药品、规格、库存、数量、单价、小计；侧栏显示 本单合计、行数和件数。

处方药结算时会弹出处方登记（医师、处方日期、可上传处方笺影像）。

结算弹窗（SettleDialog）

显示毛利/应付、会员信息、加载的活动优惠（满减）。
整单折扣输入。
积分抵现（会员）：输入使用积分，按“几分抵 1 元”抵扣，显示已抵金额。
赠品备注输入。
支付方式：现金 / 微信 / 支付宝 / 银行卡 / 赊账（多选可混合支付）。
- 现金可选填实收现金并显示找零。
- 赊账需先识别会员（熟客先拿药、月底结），计入会员欠款。
确认后：扣减库存/批次、累加会员积分与消费、写销售单、自动打小票（可选）。

6. 会员（members）

会员档案与积分、欠款管理。

搜索框：姓名/手机号/卡号，回车或输入即查。
按钮：查询 / 新增 / 编辑 / 还款 / 欠款查询。
会员表列：姓名、电话、卡号、积分、累计消费、消费次数、欠款、建档时间（双击编辑）。
选中会员显示其消费记录（单号/金额/支付/积分/时间）。
还款弹窗：录入还款金额 + 支付方式 + 备注，冲抵欠款并返还对应积分。
欠款查询弹窗：列出所有有欠款会员及明细（应付/实付/欠款），用于对账。

7. 销售查询 / 退货（sales_query）

查历史单、重打小票、按行或整单退货回库存。

筛选：日期(从/到) + 关键字（单号/药品/会员姓名或手机）；查询按钮。
上表：单号、时间、金额、支付、会员、收银（点选显示明细）。
明细表列：药品、售出、已退、可退、本次退（可改）、单价。
按钮：
- 重打小票：重打当前销售单。
- 退选中行：按“本次退”数量退该行（未填时自动填可退数）。
- 整单退货：可退数量全部退库。
- 退款方式下拉：现金/微信/支付宝/银行卡。
退货需填原因；退货后库存加回、会员积分按比例扣回，并生成退货单号。

8. 交班日结（shift）

开班记销售、交班对现金、长短款留档。

开班按钮：录入备用金开班（收银前必须开班）。
卡片：本班状态 / 本班净额（销售−退货）/ 应交现金（备用金+现金销售−现金退货）。
实点现金输入 + 自动显示长短款（长款/短款/账实相符） + 备注。
确认交班按钮：交班归档，按支付方式汇总应收，生成长短款记录。可选打印日结。
打印日结按钮：打印本班或所选历史班次日结。
右侧：最近班次表（班次、收银员、开班/交班、净销售、长短款、状态），双击预览该班次收款明细。

9. 库存深度管理（inventory）

近效期/低库存预警、批次分堆、报损、退供、盘点（按批次）、流水追溯。

顶栏按钮：
- 刷新
- 报损：选中预警药品，录入数量与原因，按近效期批次扣减。
- 退货：退供供应商，录数量（按近效期批次扣减）。
- 开始盘点：创建一张盘点单，锁定当前库存快照。
- 录入实盘：对盘点单所选行录入实际数量。
- 确认调整：按盘点差异调整库存/批次。
- 导出近效期：导出 90 天近效期清单（Excel）。
- 打印近效期：打印 90 天近效期清单。
近效期/低库存表（按批次）：药品、批号、批次库存、有效期、剩余天数、账面库存、最低库存、状态（近效期/已过期/低库存）。
所选药品批次表：近效期先出排序的批次与成本。
库存流水表：按日期/关键字（药品/单号/类型）查询入库、销售、报损、盘点等进出记录。
当前盘点单表：药品、批号、有效期、账面、实盘、差异。

10. 供应商（suppliers）

供应商名单 + 交易历史 + 对账单。

按钮：新增 / 编辑 / 对账单 / 刷新。
表格列：名称、电话、最近采购、历史单数、最近进价（双击显示关联入库单）。
下方：关联入库单表。
对账单弹窗：选日期范围（默认近一月）→ 查询。显示本期进货 / 本期退供 / 对账净额，可分是入库单和退供单两张明细表。导出 Excel 生成对账单交给业务员对账。

11. 经营统计（reports）

店长晚班对账用：期间销售 + 多维度拆分 + 畅滞销。

周期下拉：按日 / 按月 / 按年。
统计范围：起止日期。
导出 Excel：把当前周期与范围的全部报表导出。
本期概览卡片：当前周期毛利。
六个标签页：
1. 期间汇总：期间、单数、销售额、客单价。
2. 按收银员：收银员、单数、销售、实收、未收（欠款）。
3. 按支付方式：支付方式、单数、净额(已退)、实收、未收欠款。
4. 毛利品类：品类、销售额、成本、毛利、毛利率。
5. 畅销 Top10：热门药品数量与金额。
6. 滞销 Top20：库存大/临期滞销品，供下架或退货。

12. 促销活动（promo）

满减 + 指定品种活动价。

按钮：新增活动 / 启用·停用 / 删除 / 刷新。
表格：活动、类型、门槛、优惠、指定药品、起/止、状态。
新增/编辑弹窗：
- 活动名称、类型（满减 / 活动价）。
- 满减：门槛金额、减免金额。
- 活动价：指定药品下拉 + 活动价。
- 起止日期、状态（启用/停用）。
说明：选定启用后，POS 结算自动应用“满 X 减 Y”；指定品种在收银时自动优先生效活动价（不高于现价）。

13. 麻精药品专册（narcotic）

麻醉 / 精神药品专用登记台账，双人双锁管理、专册不可删除。

筛选：日期(从/到)、登记类型（购进/销售/盘点/报损等）、关键字（药品/单号/医师/患者）；查询。
按钮：新增手工登记 / 导出 Excel / 打印专册。
登记台账表：时间、类别、药品、规格、单位、类型、方向、数量、结存、单号、医师、患者、操作人。
麻精结存表：药品、规格、类别、账面库存、台账结存、登记笔数。
新增登记弹窗：选药品、登记类型、数量（入/出自动判定）、批号、单号、医师、处方日期、患者。

14. GSP 质量合规台账（gsp）

入库验收 / 首营审批 / 在库养护 / 温湿度，均可导出存档。

入库验收

过滤：关键字（药品/采购单号/批号）、状态（待验收/合格/不合格/拒收）；导出 Excel。
双击验收单 → 验收弹窗：填验收员、质量负责人、结论（合格/不合格/拒收）、备注。

首营审批

过滤：类别（企业/品种）、关键字（名称/证照号）。
按钮：新增首营 / 删除 / 导出 Excel。
新增首营弹窗：类别、名称、证照号/批准文号、有效期、联系人、电话、申请部门。
双击待批准记录 → 审批弹窗：同意/驳回。

在库养护

过滤：药品/批号/记录号。
按钮：新增养护 / 删除 / 导出 Excel。
养护弹窗：药品、批号、数量、养护方式（外观/包装/效期/抽查）、结论、养护员、备注。

温湿度记录

日期范围筛选；按钮：记录温湿度 / 删除 / 导出 Excel。
记录弹窗：温度℃、湿度%、位置、记录人、备注；自动判断合格/异常。

15. 药品追溯码（trace）

20 位药监追溯码出入库核注/核销与流向查询。

顶栏：追溯码输入框（回车=登记入库）、状态（全部/在库/已出库）、日期(从/到)、查询。
按钮：扫码入库 / 扫码出库 / 流向查询 / 导出 Excel。
全部记录表：追溯码、药品、规格、批号、方向、单号、状态、操作人、时间。
在库追溯码表：当前在库的追溯码。
出入库弹窗：追溯码、方向（入/出）、批号、单号。入库自动按条码/名称匹配药品，出库校验核销。
流向查询弹窗：输入追溯码，展示其分销/入库/出库流向。

16. 医保结算（insurance）

医保卡结算登记：医保支付 / 自付拆分、交易流水与汇总。

筛选：日期(从/到)、关键字（卡号/单号/操作人）；按钮：登记医保结算 / 导出 Excel。
表：结算单号、销售单、医保类型、卡号、总额、医保支付、自付、状态、操作人、时间。
登记弹窗：销售单号、医保卡号、医保类型（医保卡/职工医保/居民医保）、总额、医保支付、单据号。

17. 打印订单设置（print_designer）

销售小票 / 交班页

打印机下拉、热敏纸宽（80/58）、打印份数、小票字号、左右边距。
勾选项：结算成功后自动打印小票；每次打印先弹出系统对话框；小票显示项（收银员、会员姓名/手机、批号、有效期、整单折扣、本单积分、单号二维码）。
店铺地址、页脚寄语（退换货说明）。
按钮：保存打印设置 / 试打示例小票 / 导出预览 PDF。
右侧实时预览示例销售小票，改动即刷新。

入库单模板页

模板列表（★为默认）、模板名、纸张（A4/80mm/58mm）、单据类型。
组件 JSON 编辑区；按钮：添加文本 / 添加表格 / 保存模板 / 另存副本 / 恢复出厂模板。
右侧 A4 入库单实时预览。

18. 处方登记台账（rx）

查询并打开已售处方药的处方笺影像。

筛选：日期(从/到)、关键字（医师/药品/销售单号）；查询；打开处方笺。
表：销售单号、销售时间、药品、数量、医师、处方日期、会员、处方笺（是否有影像）。双击或“打开处方笺”用系统默认程序打开影像。

19. 系统设置（settings）

店与界面

店名、电话、店铺地址；界面风格下拉；界面字号。
保存设置按钮。

AI 后端

AI 后端下拉：DeepSeek / 豆包（火山方舟）。
推理速度下拉：低延迟（最快，推荐配药） / 均衡 / 高思考（最慢）。
DeepSeek Key / API 地址 / 模型 / 代理。
豆包(方舟) API Key / API 地址 / 模型。
提示：AI 配药、译意见、AI 补全档案均使用当前选中的后端。
测试当前 AI 连接按钮：按当前后端实际连通并反馈。
豆包默认低延迟模型，配药更快。

业务参数

默认毛利率%、每消费 1 元积分、积分兑换（几分抵 1 元）、热敏纸宽 mm。

备份

立即备份、备份到文件夹(U盘)、导出经营Excel。
定时提醒备份勾选 + 间隔分钟（到点弹窗提示）。

其它

修改当前用户密码、输入许可号码激活、联系公司。
右侧：员工账号管理（新增账号、角色可见性）、操作日志（留痕）。

20. 角色与权限

管理员 / 店长 / 收银员 / 库管员等角色决定侧栏可访问页面。
历史管理员角色（owner）等同于“管理员”，全功能可见。
「帮助」菜单可输入许可号码激活正式版；盗版/虚拟机/硬件变更会限制登录。

附：常用流程速查

收银：F3 → 扫码加购 → 选会员 → F4 结算 → 支付/赊账/抵现 → 自动打票。
进货：F2 → 选供应商 → 拍照/扫码/AI 生成明细 → 审核入库。
退货：F6 → 查单 → 退选中行或整单退货。
盘点：库存 → 开始盘点 → 录入实盘 → 确认调整。
对账：供应商 → 对账单 → 查询 → 导出 Excel。
晚班：经营统计 → 按收银员/支付/品类对账；交班日结打小票。