7.6 KiB
出库放行审核 · 待审核/已审核 Tab + 就绪过滤 + 作废隐藏
日期:2026-07-29
状态:已实现
模块:中试服务 / 基础实验(及共用同页的临床应用入口)→ 出库放行审核
关联(对齐入库):
docs/superpowers/specs/2026-07-16-storage-release-review-tabs-design.mddocs/superpowers/specs/2026-07-29-storage-release-pending-ready-filter-design.mddocs/superpowers/specs/2026-07-29-storage-release-hide-voided-related-design.md
界面模式:P22(审核列表)+panel-pill-tabs
参考页:web-admin/src/views/quality-inspection/storage-release-review/index.vue
实现页:web-admin/src/views/pilot-service/outbound-release-review/index.vue
后端:backend/app/crud/outbound_release_review.py
1. 背景与目标
现状
「出库放行审核」以输注计划为主表,列表无 Tab;筛选区「审核结论」含无效空值「待审核」。未按质检/生产完成度默认收敛,关联出库工单全部作废后行仍可能出现。
中试服务、基础实验(及临床应用)菜单下的出库放行审核共用同一 Vue 页(bizType 区分),需一并调整。
目标
- 双 Tab:待审核 / 已审核(交互与入库一致)。
- 就绪过滤:待审核默认仅展示出库质检侧与出库生产侧均「已完成」的记录;复选框「展示全部待审核」勾选后展示全部待审。
- 作废隐藏:出库质检或出库生产「有工单且全部
yzf」时,两 Tab 均不展示该行。 - 分页与
total与过滤一致。
范围外
- 不改详情、单条/批量审核、出库物料准备接口(直链仍可打开与操作)
- 不软删输注计划或审核行;不改表结构
- 不做协议(采集/捐赠)无效态过滤(出库场景无此关联)
- 入库/临时工单不参与本规则
- 不强制「未完成禁止审核」(仅列表默认隐藏;勾选后仍可审)
2. 需求确认记录
| 维度 | 决定 |
|---|---|
| 菜单范围 | 中试 + 基础实验(同页组件一并覆盖临床入口) |
| Tab | 待审核 / 已审核;默认待审核 |
| 就绪 UI | 「展示全部待审核」复选框;仅待审核可见;默认不勾选 |
| 就绪语义 | 对齐入库:无未完成状态码 ⇒ 该侧完成(含零工单);yzf 不算未完成 |
| 作废隐藏 | 该侧有出库工单且全部 yzf 才因该侧隐藏 |
| 工单范围 | 质检:qc_biz_type=outbound + trigger_source=schedule;生产:work_order_type=outbound;键:infusion_schedule_id |
| 作废作用 Tab | 两 Tab 常驻 |
| 详情/审核 | 仅列表隐藏,API 不拦 |
| 实现路径 | 后端列表参数 + SQL;前端 Tab + 复选框 |
3. Tab 与筛选
3.1 Tabs
| key | 文案 | 默认 |
|---|---|---|
pending |
待审核 | ✓ |
reviewed |
已审核 |
布局:panel-top → panel-pill-tabs → 筛选 → 工具栏 → 卡片列表 + 分页。
切换 Tab:页码回 1、清空勾选、保留其它筛选;从已审核切回待审核时复选框恢复不勾选。
3.2 审核结论筛选
- 去掉空值「待审核」选项(由 Tab 承担)。
- 保留清空 = 当前 Tab 内全部;选项:通过
tg/ 不通过btg。 - 待审核 Tab 下若再选通过/不通过 → 与阶段叠加,结果为空属预期。
3.3 阶段过滤(后端)
以输注计划为主表;审核结论来自关联 biz_outbound_release_review(del_flag=0)。
reviewPhase |
语义 |
|---|---|
pending |
不存在「有非空 review_conclusion」的审核记录(与现有 review_conclusion=pending 一致) |
reviewed |
存在审核记录且 review_conclusion 非空 |
| 缺省/非法 | 不按阶段过滤(兼容) |
前端:待审核始终传 reviewPhase=pending;已审核传 reviewed。具体结论筛选用现有 reviewConclusion(仅 tg/btg)。
4. 就绪过滤(待审核默认)
4.1 UI
仅待审核显示复选框,主文案:展示全部待审核;副文案对齐入库:默认不勾选仅展示质检与生产工单均为完成的记录;勾选后展示全部。
重置 → 不勾选。
4.2 「侧完成」语义
关联:同租户、del_flag=0、infusion_schedule_id = 当前计划 id。
| 侧 | 工单范围 | 已完成 | 未完成 |
|---|---|---|---|
| 质检 | qc_biz_type=outbound 且 trigger_source=schedule |
无工单;或不存在 work_order_status IN ('dpz','ypz') |
存在至少一条 dpz/ypz |
| 生产 | work_order_type=outbound |
无工单;或不存在 work_order_status IN ('dpz','jxz') |
存在至少一条 dpz/jxz |
说明:仅 ywc/yzf、无未完成码 → 该侧已完成。零工单 → 该侧已完成。
4.3 API
readyForReviewOnly=true 时:质检侧已完成 AND 生产侧已完成(双 NOT EXISTS 未完成工单)。缺省/false → 不按就绪过滤。
仅前端在「待审核且未勾选展示全部」时传 true。
5. 作废隐藏(两 Tab 常驻)
5.1 条件(满足任一则隐藏)
- 出库质检全作废:存在 ≥1 张上述范围质检工单,且不存在状态非
yzf(含NULL视为非作废)的工单。 - 出库生产全作废:存在 ≥1 张上述范围生产工单,且全部为
yzf(NULL非作废)。
列表可见 ⇔ 非(质检全作废 OR 生产全作废)
与 reviewPhase / readyForReviewOnly / 关键词等 AND 叠加。无查询参数开关。
无协议无效过滤。混有非 yzf → 不因该侧隐藏。仅入库/临时工单作废 → 不影响。
5.2 与就绪过滤的关系
就绪过滤将单侧仅 yzf 视为「已完成」;若该侧全部为 yzf,作废隐藏优先,行不可见(含勾选「展示全部待审核」时)。
6. API 与改动面
6.1 列表接口
沿用 GET 出库放行审核列表,增加:
| 参数 | 说明 |
|---|---|
reviewPhase |
pending | reviewed |
readyForReviewOnly |
布尔;true 启用双工单侧完成过滤 |
作废隐藏在 CRUD list_reviews_paginated 内常驻。过滤在 COUNT/分页之前。
详情/审核/物料 API 不变。
6.2 前端
| 文件 | 变更 |
|---|---|
web-admin/src/views/pilot-service/outbound-release-review/index.vue |
Tab、复选框、请求参数、去掉空「待审核」选项 |
web-admin/src/api/outbound-release-review.ts |
params 增加 reviewPhase、readyForReviewOnly |
卡片列表组件可不改结构。
6.3 后端
| 文件 | 变更 |
|---|---|
backend/app/api/outbound_release_review.py |
Query 透传新参数 |
backend/app/crud/outbound_release_review.py |
phase / ready / void EXISTS 过滤 |
backend/tests/test_outbound_release_review_*.py |
normalize 与/或谓词单测(按实现计划) |
7. 测试要点
- 待审核默认:存在出库质检
dpz/ypz或出库生产dpz/jxz→ 不出现;两侧均无未完成(含双无工单)→ 可出现。 - 勾选「展示全部待审核」→ 待审核全集(仍排除全作废)。
- 出库质检全部
yzf或出库生产全部yzf→ 两 Tab 均不出现。 - 混有
ywc+yzf→ 不因该侧作废隐藏。 - 已审核无复选框;作废隐藏仍生效。
- 中试 / 基础实验入口行为一致(同页不同
bizType)。 total与过滤一致;详情直链仍可用。
8. 方案取舍
| 方案 | 结论 |
|---|---|
| 1. 后端参数 + SQL + 前端 Tab/复选框 | 采用 |
| 2. 前端拉全量过滤 | 拒绝 |
| 3. 作废钩子软删 | 拒绝 |