概关于 GSP 质量管理模块
GSP（药品经营质量管理规范）与 GSME（医疗器械经营质量管理规范）对经营企业提出了批号级库存、有效期管控、质量状态分区、供货/购货单位资质审核等硬性要求。简仓在通用进销存之上，以「可插拔质量能力」的形态叠加这套合规能力：普通经营租户完全无感，医药 / 器械租户开通后即获得整套 GSP 工作台。
两层能力模型
- 能力开关（Feature）：批号效期、质量状态、资质档案、温湿度、验收养护、追溯码等能力各自独立开关，按需启用。
- 行业预设：一个行业 = 一组能力开关的预设值。首期提供 药品 GSP、器械 GSME、通用 三档，能力大量复用，仅追溯码（药品追溯码 / 器械 UDI）与证照字段有差异。
✓
本手册范围。下列 4 个已上线功能可实际操作，本手册逐一讲解：业务目录（概览）、资质档案、批次库存、效期预警。侧边栏「GSP 质量」分组中的其余菜单项为规划中功能，暂不在本手册讲解范围内。
一开通与进入
GSP 质量管理属于可选订阅能力，需由平台运营方为您的租户开通后才会出现。开通后：
- 使用您的账号登录简仓（业务端）。
- 在左侧导航中找到 「质量管理 / GSP」 分组，展开后即可看到 GSP 各功能入口。
- 点击 「业务目录」 进入模块首页（概览与导航中枢），或直接点击 资质档案 / 批次库存 / 效期预警 进入对应功能。
i
若左侧没有「GSP 质量」分组，说明当前租户尚未开通该能力，请联系平台运营方开通。菜单入口右上角标有预设标签（通用 / 药品 / 器械），指示该功能在何种行业预设下可用。
二业务目录（模块概览）
业务目录是 GSP 模块的首页与导航中枢，用一屏展示：当前行业预设、经营质量业务闭环蓝图、关键质量指标概览，以及分区功能卡片（点击卡片即可跳转到对应功能）。
页面构成
- 预设切换（右上角）：在 药品 GSP / 器械 GSME / 通用 之间切换预览。不同预设下，与追溯码、证照相关的项会相应显示或隐藏（例：药品预设下显示药品追溯码，器械 UDI 相关项隐藏）。
- 采购到货质量闭环：以
采购入库 → 收货验收 → 质量判定 → 出库与追溯四步展示经营质量的业务蓝图，帮助理解各功能在整条链路中的位置。 - 质量指标概览：待验批次、近效期批次、不合格隔离、进行中召回、即将到期资质、温湿度超限等关键计数。
- 分区功能卡片：按「准入与资质 / 收发质控 / 库存与效期 / 养护处置 / 追溯召回」分区列出各功能，点击卡片直接进入。
!
关于占位「—」。业务目录顶部的指标卡与部分分区卡片计数会显示占位符「—」，并注明「将在对应子模块上线后接入真实数据」。这是刻意设计——只在功能真正上线后才展示真实数字，不以演示假数充当指标。已上线功能（资质档案 / 批次库存 / 效期预警）的真实指标，请进入各功能页查看。
三资质档案
资质档案集中管理供应商 / 客户的经营资质：营业执照、经营许可证、GSP/GSME 证、授权委托书及其有效期，以及经营范围与首营审核状态。系统会依据证照有效期自动派生资质状态并预警到期。
页面能做什么
- KPI 概览：合作单位总数、即将到期（证照 90 天内到期）、已过期、待首营审核数量，一眼掌握风险面。
- 搜索与筛选：按单位名称 / 统一社会信用代码搜索；按类型（供应商 / 客户）、资质状态（有效 / 即将到期 / 已过期 / 无证照）筛选。
- 资质状态与首营状态以带色标签直观呈现（详见附录速查表）。
新建资质档案
- 在列表右上角点击 「+ 新建资质档案」，右侧滑出录入抽屉。
- 选择 类型（供应商 / 客户），再从 单位 下拉中选择一个已存在的供应商或客户（下拉支持输入关键字过滤）。
- 填写 统一社会信用代码、经营范围（用于后续与拟采购 / 销售品种比对）。
- 设置 首营审核状态：新单位默认 待审，审核通过后改为 已通过，不符合要求则 已驳回。
- 在 证照 区点击 「+ 添加证照」，逐行录入：证照类型（营业执照 / 经营许可证 / GSP·GSME 证 / 授权委托书）、证号、有效期起、有效期止。可添加多张，误加的用行尾「删除」移除。
- 如有需要在 备注 中补充说明，点击底部 「保存」 完成。
✓
有效期止很关键。系统据每张证照的「有效期止」自动计算资质状态与到期预警——务必如实填写，才能在证照临期时收到「即将到期」提醒。
编辑 / 查看 / 删除
- 编辑：在列表行尾点击「编辑」，在抽屉中修改单位信息、增删证照行、调整首营审核状态，点击「保存」生效。这也是推进首营审核（待审 → 已通过 / 已驳回）的入口。
- 删除：行尾「删除」并二次确认。请仅对录错或作废的档案执行删除。
资质状态是如何算出来的
资质状态由该单位最早到期的那张证照的「有效期止」派生（读时计算，不落库、永不过期）：
| 距最近到期 | 资质状态 | 含义 |
|---|---|---|
| 已过期（< 今天） | 已过期 | 有证照已失效，应立即停止合作或补证 |
| 0–90 天内 | 即将到期 | 临期预警，应提前催办换证 |
| > 90 天 | 有效 | 证照均在有效期内 |
| 未录任何证照 | 无证照 | 尚未登记证照，需补录 |
四批次库存
批次库存把库存维度从「商品 × 仓库」扩展为 商品 × 仓库 × 批号 × 效期 × 质量状态，让每一批货的生产日期、有效期与质量状态都清晰可查。这是整个 GSP 效期与质量管控的数据地基。
双视图与筛选
- 按批次 / 按商品切换：左上角切换视图。「按批次」逐批展示每一批的效期与质量；「按商品」把同一商品的多批聚合，展示批次数、合计数量、最近效期与聚合质量状态。
- 搜索：按商品名称 / 编码 / 批号快速定位。
- 按仓库筛选：只看某个仓库的批次库存。
- 按质量状态筛选：只看待验 / 合格 / 不合格等（仅在「按批次」视图可用）。
色标解读
每批同时带 质量状态与效期状态两组色标：
质量状态：待验 合格 不合格 退货 锁定。其中只有「合格」批次可正常销售出库，其余状态在出库时会被系统拦截（质量否决为领域规则，正随出库 FEFO 功能上线）。
效期状态：正常 近效期 已过期，并显示剩余天数（如「149 天」「已过期 21 天」）。近效期阈值默认取商品的「效期预警天数」（缺省 90 天）。
i
未启用批次管理的普通商品，批号显示为默认「—」批、质量状态默认「合格」，行为与普通库存一致——统一表结构、按能力分流，互不干扰。
五效期预警
效期预警把近效期与已过期批次按剩余天数分桶集中呈现，配合「近效期先出（FEFO）」的经营原则，帮助你在货物失效前及时复查、优先出库或处置。
操作方式
- 页面默认展示 「30 天内」 桶。点击顶部任一分桶卡（已过期 / 30 天内 / 90 天内 / 180 天内）即可切换查看该区间的批次。
- 在列表中查看每批的剩余天数（读时派生）、批号、仓库与质量状态。
- 可用搜索框按商品名称 / 编码 / 批号进一步定位。
处置建议（管理动作）
- 近效期：安排养护复查、优先出库或促销消化，避免临期变过期。
- 已过期：应停止销售、隔离并按不合格品流程处置（不合格 / 处置功能规划中，届时可在系统内闭环）。
✓
FEFO 原则。近效期先出（First-Expired-First-Out）是效期管控的核心。效期预警页帮助你识别应优先出库的批次；系统级的出库自动带最近效期合格批，将随出库 FEFO 功能上线。
附状态速查表
库存质量状态
| 状态 | 色标 | 说明 |
|---|---|---|
| 待验 | 待验 | 到货待检，尚不可销售 |
| 合格 | 合格 | 检验合格，可正常出库销售 |
| 不合格 | 不合格 | 检验不合格，禁止销售出库 |
| 退货 | 退货 | 退货区暂存 |
| 锁定 | 锁定 | 因质量事项被锁定，不可动用 |
效期状态
| 状态 | 色标 | 判定 |
|---|---|---|
| 正常 | 正常 | 剩余天数 > 预警天数（默认 90 天） |
| 近效期 | 近效期 | 0 ≤ 剩余天数 ≤ 预警天数 |
| 已过期 | 已过期 | 已超过有效期止 |
资质状态 / 首营状态
| 维度 | 取值 |
|---|---|
| 资质状态 | 有效 即将到期 已过期 无证照 |
| 首营审核状态 | 待审 已通过 已驳回 |
说数据与免责说明
- 本手册截图取自演示环境（平台宿主账号 + 内置演示数据），单位名称、商品、批号、日期等均为示例；实际界面以各租户的真实数据为准。
- 手册仅覆盖已上线并可实际操作的 4 个功能。收货验收、养护、不合格品、召回、温湿度台账、追溯码 / UDI、GSP 报表等为规划中功能，将随版本迭代补充相应操作说明。
- 页面文案、字段与色标以线上系统实际显示为准；如与本手册不一致，请以系统为准并反馈更新。