fix: 协议子资源单事务保存,并补齐样本编码/OA/质检等近期能力

锁定缴费校验失败时整单回滚,避免样本半成功落库;前端禁止删除锁定缴费样本,改码走更正编码。同步落地样本更正、采集微信通知、OA提及未读、细胞产品套餐与相关迁移文档。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-10-26 11:02:25 +08:00
1 parent 19bc66ba45
commit 5dad1bb0e3
142 files changed
+95584 -65717

No files matched your search

@@ -0,0 +1,31 @@
-- 微信服务号通知发送日志(幂等)
-- 对齐 docs/superpowers/specs/2026-10-22-basic-experiment-delivery-remind-design.md
CREATE TABLE IF NOT EXISTS biz_wx_notify_log (
id VARCHAR(64) NOT NULL COMMENT '主键ID',
biz_type VARCHAR(64) NOT NULL COMMENT '业务类型,如 basic_experiment_delivery_remind',
biz_id VARCHAR(64) NOT NULL COMMENT '业务主键(如交付计划ID)',
notify_date VARCHAR(10) NOT NULL COMMENT '提醒日 YYYY-MM-DD',
user_id VARCHAR(64) DEFAULT NULL COMMENT '接收用户ID',
status VARCHAR(16) NOT NULL DEFAULT 'success' COMMENT 'success/fail',
errcode VARCHAR(64) DEFAULT NULL COMMENT '微信/内部错误码',
errmsg VARCHAR(512) DEFAULT NULL COMMENT '错误信息',
tenant_no VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
order_num INT DEFAULT NULL COMMENT '排序号',
remark VARCHAR(512) DEFAULT NULL COMMENT '备注',
create_by VARCHAR(64) DEFAULT NULL COMMENT '创建人id',
create_dept_id VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
create_time DATETIME NOT NULL COMMENT '创建时间',
update_by VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
update_time DATETIME NOT NULL COMMENT '更新时间',
del_flag SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记',
PRIMARY KEY (id),
UNIQUE KEY uk_wx_notify_tenant_biz (
tenant_no,
biz_type,
biz_id,
notify_date
),
KEY idx_wx_notify_tenant_time (tenant_no, create_time),
KEY idx_wx_notify_lookup (tenant_no, biz_type, biz_id, notify_date, del_flag)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='微信服务号通知发送日志';
@@ -0,0 +1,93 @@
-- 细胞产品包装主数据
-- 执行前请确认目标库;可重复执行:表 IF NOT EXISTS,种子数据按编码去重
CREATE TABLE IF NOT EXISTS `biz_cell_product_package` (
`id` VARCHAR(64) NOT NULL COMMENT '主键ID',
`package_code` VARCHAR(64) NOT NULL COMMENT '包装编码',
`package_name` VARCHAR(200) NOT NULL COMMENT '包装名称',
`tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
`order_num` INT NULL COMMENT '排序号',
`remark` VARCHAR(512) NULL COMMENT '备注',
`create_by` VARCHAR(64) NULL COMMENT '创建人id',
`create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
`create_time` DATETIME NOT NULL COMMENT '创建时间',
`update_by` VARCHAR(64) NULL COMMENT '更新人id',
`update_time` DATETIME NOT NULL COMMENT '更新时间',
`del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记',
PRIMARY KEY (`id`),
KEY `idx_cell_product_package_tenant` (`tenant_no`, `del_flag`),
KEY `idx_cell_product_package_code` (`tenant_no`, `package_code`, `del_flag`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='细胞产品包装';
-- 初始包装类型(租户 zkxw;编码已存在则跳过)
INSERT INTO `biz_cell_product_package` (
`id`, `package_code`, `package_name`, `tenant_no`, `order_num`, `remark`,
`create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`
)
SELECT * FROM (
SELECT
'PKG000000000000000000000000000001' AS `id`,
'BZ01' AS `package_code`,
'冻存管' AS `package_name`,
'zkxw' AS `tenant_no`,
1 AS `order_num`,
'' AS `remark`,
NULL AS `create_by`,
'' AS `create_dept_id`,
NOW() AS `create_time`,
NULL AS `update_by`,
NOW() AS `update_time`,
0 AS `del_flag`
) AS t
WHERE NOT EXISTS (
SELECT 1 FROM `biz_cell_product_package` p
WHERE p.`tenant_no` = 'zkxw' AND p.`package_code` = 'BZ01' AND p.`del_flag` = 0
);
INSERT INTO `biz_cell_product_package` (
`id`, `package_code`, `package_name`, `tenant_no`, `order_num`, `remark`,
`create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`
)
SELECT * FROM (
SELECT
'PKG000000000000000000000000000002' AS `id`,
'BZ02' AS `package_code`,
'离心管' AS `package_name`,
'zkxw' AS `tenant_no`,
2 AS `order_num`,
'' AS `remark`,
NULL AS `create_by`,
'' AS `create_dept_id`,
NOW() AS `create_time`,
NULL AS `update_by`,
NOW() AS `update_time`,
0 AS `del_flag`
) AS t
WHERE NOT EXISTS (
SELECT 1 FROM `biz_cell_product_package` p
WHERE p.`tenant_no` = 'zkxw' AND p.`package_code` = 'BZ02' AND p.`del_flag` = 0
);
INSERT INTO `biz_cell_product_package` (
`id`, `package_code`, `package_name`, `tenant_no`, `order_num`, `remark`,
`create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`
)
SELECT * FROM (
SELECT
'PKG000000000000000000000000000003' AS `id`,
'BZ03' AS `package_code`,
'一次性塑料血袋' AS `package_name`,
'zkxw' AS `tenant_no`,
3 AS `order_num`,
'' AS `remark`,
NULL AS `create_by`,
'' AS `create_dept_id`,
NOW() AS `create_time`,
NULL AS `update_by`,
NOW() AS `update_time`,
0 AS `del_flag`
) AS t
WHERE NOT EXISTS (
SELECT 1 FROM `biz_cell_product_package` p
WHERE p.`tenant_no` = 'zkxw' AND p.`package_code` = 'BZ03' AND p.`del_flag` = 0
);
@@ -0,0 +1,234 @@
-- 修复内置工艺路线缺步骤(2026-10-22)
-- 对齐 docs/superpowers/specs/2026-10-22-cc-builtin-route-steps-fix-design.md
--
-- 现象:CC样本处理-BUILTIN 等内置路线仅有路线头、无 biz_process_route_step,
-- 导致 B* 入库编码自动派发后任务显示「样本处理 0/0」。
-- 策略:对「内置 + 无有效步骤 + 源路线有步骤」的 *-BUILTIN 路线,
-- 从源路线(route_code 去掉 -BUILTIN)深拷贝步骤及产出/数据采集等子表。
-- 幂等:仅当目标内置路线当前 0 条有效步骤时执行;已有步骤则跳过。
-- MySQL 5.7
-- 1) 需要修复的内置路线 ↔ 源路线
DROP TEMPORARY TABLE IF EXISTS tmp_builtin_route_fix;
CREATE TEMPORARY TABLE tmp_builtin_route_fix (
dst_route_id VARCHAR(64) NOT NULL,
src_route_id VARCHAR(64) NOT NULL,
tenant_no VARCHAR(64) NOT NULL,
PRIMARY KEY (dst_route_id)
) ENGINE=MEMORY;
INSERT INTO tmp_builtin_route_fix (dst_route_id, src_route_id, tenant_no)
SELECT
b.id,
(
SELECT s.id
FROM biz_process_route s
WHERE s.tenant_no = b.tenant_no
AND s.route_code = REPLACE(b.route_code, '-BUILTIN', '')
AND s.del_flag = 0
AND IFNULL(s.is_builtin, '0') = '0'
ORDER BY
CASE WHEN IFNULL(s.is_current, '0') = '1' THEN 0 ELSE 1 END,
s.update_time DESC,
s.create_time DESC
LIMIT 1
) AS src_route_id,
b.tenant_no
FROM biz_process_route b
WHERE IFNULL(b.is_builtin, '0') = '1'
AND b.del_flag = 0
AND b.route_code LIKE '%-BUILTIN'
AND NOT EXISTS (
SELECT 1
FROM biz_process_route_step st
WHERE st.route_id = b.id
AND st.del_flag = 0
);
-- 去掉找不到源、或源也无步骤的行
DELETE FROM tmp_builtin_route_fix
WHERE src_route_id IS NULL
OR NOT EXISTS (
SELECT 1
FROM biz_process_route_step st
WHERE st.route_id = tmp_builtin_route_fix.src_route_id
AND st.del_flag = 0
);
-- 2) 源步骤 → 新步骤 ID 映射
DROP TEMPORARY TABLE IF EXISTS tmp_step_id_map;
CREATE TEMPORARY TABLE tmp_step_id_map (
src_step_id VARCHAR(64) NOT NULL,
dst_step_id VARCHAR(64) NOT NULL,
dst_route_id VARCHAR(64) NOT NULL,
tenant_no VARCHAR(64) NOT NULL,
PRIMARY KEY (src_step_id)
) ENGINE=MEMORY;
INSERT INTO tmp_step_id_map (src_step_id, dst_step_id, dst_route_id, tenant_no)
SELECT
ss.id,
-- MD5+源步骤保证同语句多行不撞主键;前缀避免与历史 UUID 冲突
CONCAT('BF', UPPER(MD5(CONCAT('fix-builtin-step:', f.dst_route_id, ':', ss.id)))),
f.dst_route_id,
f.tenant_no
FROM tmp_builtin_route_fix f
INNER JOIN biz_process_route_step ss
ON ss.route_id = f.src_route_id
AND ss.del_flag = 0;
-- 3) 拷贝步骤
INSERT INTO biz_process_route_step (
id, route_id, process_id, step_order, process_code, category_id,
process_name, description, equipment_ids, equipment_name, estimated_duration,
sop_ids, sop_content, tenant_no, order_num, remark,
create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
m.dst_step_id,
m.dst_route_id,
ss.process_id,
ss.step_order,
ss.process_code,
ss.category_id,
ss.process_name,
ss.description,
ss.equipment_ids,
ss.equipment_name,
ss.estimated_duration,
ss.sop_ids,
ss.sop_content,
ss.tenant_no,
ss.order_num,
ss.remark,
ss.create_by,
ss.create_dept_id,
NOW(),
ss.update_by,
NOW(),
0
FROM tmp_step_id_map m
INNER JOIN biz_process_route_step ss ON ss.id = m.src_step_id;
-- 4) 试剂
INSERT INTO biz_process_route_step_reagent (
id, step_id, reagent_code, reagent_name, spec, standard_usage, unit,
is_key_material, tenant_no, order_num, remark,
create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
CONCAT('BF', UPPER(MD5(CONCAT('fix-builtin-reag:', m.dst_step_id, ':', r.id)))),
m.dst_step_id,
r.reagent_code,
r.reagent_name,
r.spec,
r.standard_usage,
r.unit,
r.is_key_material,
r.tenant_no,
r.order_num,
r.remark,
r.create_by,
r.create_dept_id,
NOW(),
r.update_by,
NOW(),
0
FROM tmp_step_id_map m
INNER JOIN biz_process_route_step_reagent r
ON r.step_id = m.src_step_id
AND r.del_flag = 0;
-- 5) 耗材
INSERT INTO biz_process_route_step_consumable (
id, step_id, consumable_code, consumable_name, spec_model, standard_usage,
unit, is_required, remark, tenant_no, order_num,
create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
CONCAT('BF', UPPER(MD5(CONCAT('fix-builtin-cons:', m.dst_step_id, ':', c.id)))),
m.dst_step_id,
c.consumable_code,
c.consumable_name,
c.spec_model,
c.standard_usage,
c.unit,
c.is_required,
c.remark,
c.tenant_no,
c.order_num,
c.create_by,
c.create_dept_id,
NOW(),
c.update_by,
NOW(),
0
FROM tmp_step_id_map m
INNER JOIN biz_process_route_step_consumable c
ON c.step_id = m.src_step_id
AND c.del_flag = 0;
-- 6) 产出
INSERT INTO biz_process_route_step_output (
id, step_id, output_type_id, output_name, output_barcode, tenant_no,
order_num, remark, create_by, create_dept_id, create_time, update_by,
update_time, del_flag
)
SELECT
CONCAT('BF', UPPER(MD5(CONCAT('fix-builtin-out:', m.dst_step_id, ':', o.id)))),
m.dst_step_id,
o.output_type_id,
o.output_name,
o.output_barcode,
o.tenant_no,
o.order_num,
o.remark,
o.create_by,
o.create_dept_id,
NOW(),
o.update_by,
NOW(),
0
FROM tmp_step_id_map m
INNER JOIN biz_process_route_step_output o
ON o.step_id = m.src_step_id
AND o.del_flag = 0;
-- 7) 数据采集
INSERT INTO biz_process_route_step_data_collection (
id, step_id, collection_name, unit, tenant_no, order_num, remark,
create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
CONCAT('BF', UPPER(MD5(CONCAT('fix-builtin-dc:', m.dst_step_id, ':', d.id)))),
m.dst_step_id,
d.collection_name,
d.unit,
d.tenant_no,
d.order_num,
d.remark,
d.create_by,
d.create_dept_id,
NOW(),
d.update_by,
NOW(),
0
FROM tmp_step_id_map m
INNER JOIN biz_process_route_step_data_collection d
ON d.step_id = m.src_step_id
AND d.del_flag = 0;
-- 8) 校验(人工看结果)
SELECT
b.route_code,
b.route_name,
(SELECT COUNT(*) FROM biz_process_route_step st
WHERE st.route_id = b.id AND st.del_flag = 0) AS step_count
FROM biz_process_route b
WHERE IFNULL(b.is_builtin, '0') = '1'
AND b.del_flag = 0
AND b.route_code LIKE '%-BUILTIN'
ORDER BY b.route_code;
DROP TEMPORARY TABLE IF EXISTS tmp_step_id_map;
DROP TEMPORARY TABLE IF EXISTS tmp_builtin_route_fix;
@@ -0,0 +1,44 @@
-- 交付/输注计划及产品明细增加产品包装字段(透传至生产/质检出库工单展示)
-- 可重复执行:已存在列则跳过
SET @db := DATABASE();
-- biz_pilot_infusion_schedule.package_id
SET @exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'biz_pilot_infusion_schedule' AND COLUMN_NAME = 'package_id'
);
SET @sql := IF(@exists = 0,
'ALTER TABLE `biz_pilot_infusion_schedule` ADD COLUMN `package_id` VARCHAR(64) NULL COMMENT ''产品包装ID'' AFTER `spec_text`',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
-- biz_pilot_infusion_schedule.package_text
SET @exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'biz_pilot_infusion_schedule' AND COLUMN_NAME = 'package_text'
);
SET @sql := IF(@exists = 0,
'ALTER TABLE `biz_pilot_infusion_schedule` ADD COLUMN `package_text` VARCHAR(200) NULL COMMENT ''产品包装名称(冗余展示)'' AFTER `package_id`',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
-- biz_pilot_infusion_schedule_product.package_id
SET @exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'biz_pilot_infusion_schedule_product' AND COLUMN_NAME = 'package_id'
);
SET @sql := IF(@exists = 0,
'ALTER TABLE `biz_pilot_infusion_schedule_product` ADD COLUMN `package_id` VARCHAR(64) NULL COMMENT ''产品包装ID'' AFTER `spec_text`',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
-- biz_pilot_infusion_schedule_product.package_text
SET @exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'biz_pilot_infusion_schedule_product' AND COLUMN_NAME = 'package_text'
);
SET @sql := IF(@exists = 0,
'ALTER TABLE `biz_pilot_infusion_schedule_product` ADD COLUMN `package_text` VARCHAR(200) NULL COMMENT ''产品包装名称(冗余展示)'' AFTER `package_id`',
'SELECT 1');
PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
@@ -0,0 +1,24 @@
-- 样本编码全链路纠错审计日志(2026-10-22)
-- 对齐 docs/superpowers/specs/2026-10-22-sample-code-correction-design.md
CREATE TABLE IF NOT EXISTS biz_sample_code_correction_log (
id VARCHAR(64) NOT NULL COMMENT '主键ID',
reception_source VARCHAR(32) NOT NULL COMMENT '来源 cell_storage/research_donation',
old_sample_code VARCHAR(32) NOT NULL COMMENT '旧样本编码',
new_sample_code VARCHAR(32) NOT NULL COMMENT '新样本编码',
impact_json TEXT COMMENT '各表影响行数 JSON',
reason VARCHAR(512) DEFAULT NULL COMMENT '更正原因',
tenant_no VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
order_num INT DEFAULT NULL COMMENT '排序号',
remark VARCHAR(512) DEFAULT NULL COMMENT '备注',
create_by VARCHAR(64) DEFAULT NULL COMMENT '创建人id',
create_dept_id VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
create_time DATETIME NOT NULL COMMENT '创建时间',
update_by VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
update_time DATETIME NOT NULL COMMENT '更新时间',
del_flag SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记',
PRIMARY KEY (id),
KEY idx_scc_tenant_time (tenant_no, create_time),
KEY idx_scc_tenant_old (tenant_no, old_sample_code, del_flag),
KEY idx_scc_tenant_new (tenant_no, new_sample_code, del_flag)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='样本编码纠错审计日志';
@@ -0,0 +1,7 @@
-- OA「提到我的」未读:oa_instance_view_grant.is_read
-- 存量行置已读,避免上线后角标暴涨
ALTER TABLE `oa_instance_view_grant`
ADD COLUMN `is_read` SMALLINT NOT NULL DEFAULT 0 COMMENT '是否已读 0未读 1已读' AFTER `granted_by`;
UPDATE `oa_instance_view_grant` SET `is_read` = 1 WHERE `del_flag` = 0;
@@ -0,0 +1,41 @@
-- 样本采集通知人员角色(幂等)
-- 仅插入角色,不挂菜单、不自动绑用户;由运营在「角色管理」中挂人。
-- 对齐 docs/superpowers/specs/2026-10-23-sample-collect-wx-notify-design.md
INSERT INTO sys_role (
id,
role_name,
data_scope,
status,
tenant_no,
order_num,
remark,
create_by,
create_dept_id,
create_time,
update_by,
update_time,
del_flag
)
SELECT
REPLACE(UUID(), '-', ''),
'样本采集通知人员',
'1',
'1',
'zkxw',
0,
'协议新增样本时接收服务号模板消息',
'system',
'',
NOW(),
'system',
NOW(),
0
FROM DUAL
WHERE NOT EXISTS (
SELECT 1
FROM sys_role r
WHERE r.tenant_no = 'zkxw'
AND r.role_name = '样本采集通知人员'
AND r.del_flag = 0
);
@@ -0,0 +1,469 @@
-- =============================================================================
-- 数据修复:马丽娜 / 邓诗婷 样本编码错乱回正
-- 基准备份:zkxw_2026-10-26_092540.sql.gz(执行前请再备份当前库)
--
-- 目标终态:
-- 马丽娜 协议 XBCC20261008000001 → 样本码 ZKZX34000964
-- + 原质检/生产/接收/入库审核/缴费(曾被误改到 1007)一并回到 964
-- 邓诗婷 协议 XBCC20261026000001 → 样本码 ZKZX34000842
-- (不含马丽娜的质检生产)
--
-- 不改:lab_storage_code、biz_cell_product.product_code、短信正文、软删历史行
--
-- 执行方式(MySQL 5.7):
-- 1) 先跑「一、执行前校验」全部 SELECT,确认与预期一致
-- 2) 再跑「二、事务修复」;任一步报错会 ROLLBACK
-- 3) 跑「三、执行后校验」
-- =============================================================================
-- ---------------------------------------------------------------------------
-- 常量(与 09:25 备份一致;若线上 ID 已变,以校验 SELECT 为准再改)
-- ---------------------------------------------------------------------------
-- 租户
-- SET @tenant = 'zkxw';
-- 马丽娜协议 / 活跃样本 / 编码池
-- 6A7CBB85EA024AF08061FD9AFB8DF6EC
-- EC3B60D2880544D9909980D36FF9704E (当前活跃,码=842)
-- BBC01CCFDCA14E7BBE3ED34CE1B1DE47 (池 964)
-- 7C4C8FEDE210453F9D2F357D4F5A46A4 (池 842)
-- 邓诗婷协议 / 活跃样本 / 编码池
-- AAF11BCC7A584B09AFCE17AA8F7B7CD4
-- 21D2D4A063064E0B850F5C807F964079 (当前活跃,码=1007)
-- 817D230359EE4DCEA0F0CB532F099F12 (池 1007)
-- 下游(属马丽娜,当前 sample_code=1007)
-- reception 0E69E16E7E9C4B3AA9D894622BBE237B
-- qc_wo 019FC51312BB4225901014BE90A3AB2E
-- prod_wo 92F20C8B731E474985BB2C6D74A2BA3A
/* =============================================================================
一、执行前校验(只读)—— 全部应对上,再执行第二节
============================================================================= */
SELECT '【预检1】活跃协议样本(期望:马丽娜=842 一条;邓诗婷=1007 一条;964 无活跃)' AS step;
SELECT ps.id,
ps.sample_code,
ps.sample_code_id,
ps.collection_protocol_id,
cp.protocol_no,
ppc.mother_name,
ps.del_flag,
ps.update_time
FROM biz_protocol_sample ps
JOIN biz_collection_protocol cp ON cp.id = ps.collection_protocol_id AND cp.del_flag = 0
LEFT JOIN biz_protocol_party_customer ppc
ON ppc.collection_protocol_id = ps.collection_protocol_id AND ppc.del_flag = 0
WHERE ps.tenant_no = 'zkxw'
AND ps.del_flag = 0
AND ps.sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
ORDER BY ps.sample_code, ps.create_time;
SELECT '【预检2】马丽娜下游当前码(期望均为 1007,协议仍为马丽娜)' AS step;
SELECT 'reception' AS tbl, id, sample_code, protocol_sample_id, collection_protocol_id, lab_storage_code
FROM biz_sample_reception
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND collection_protocol_id = '6A7CBB85EA024AF08061FD9AFB8DF6EC'
UNION ALL
SELECT 'qc_wo', id, sample_code, protocol_sample_id, collection_protocol_id, work_order_no
FROM biz_qc_work_order
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND collection_protocol_id = '6A7CBB85EA024AF08061FD9AFB8DF6EC'
UNION ALL
SELECT 'prod_wo', id, sample_code, protocol_sample_id, collection_protocol_id, work_order_no
FROM biz_production_work_order
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND collection_protocol_id = '6A7CBB85EA024AF08061FD9AFB8DF6EC'
UNION ALL
SELECT 'storage_rev', id, sample_code, NULL, protocol_id, protocol_no
FROM biz_storage_release_review
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND protocol_id = '6A7CBB85EA024AF08061FD9AFB8DF6EC';
SELECT '【预检3】码分布计数(活跃)' AS step;
SELECT sample_code, COUNT(*) AS cnt
FROM biz_protocol_sample
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
GROUP BY sample_code;
SELECT sample_code, COUNT(*) AS qc_task_cnt
FROM biz_qc_task
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
GROUP BY sample_code;
SELECT sample_code, collection_protocol_id, COUNT(*) AS pay_cnt
FROM biz_protocol_sample_payment
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
GROUP BY sample_code, collection_protocol_id;
/* =============================================================================
二、事务修复
A 马丽娜 842 → 964(仅协议侧;下游此时在 1007,不会被带走)
B 马丽娜协议下 1007 → 964(质检/生产/缴费等,按协议 ID 定向)
C 邓诗婷 1007 → 842
============================================================================= */
START TRANSACTION;
-- 说明:库内同时存在 utf8mb4_unicode_ci / utf8mb4_general_ci 列。
-- 字符串比较一律用 BINARY,避免会话变量 collation 混用报错。
SET NAMES utf8mb4;
SET @now := NOW();
SET @operator := 'data_fix_20261026';
SET @marina_sample_id := NULL;
SET @deng_sample_id := NULL;
SELECT id INTO @marina_sample_id
FROM biz_protocol_sample
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34000842'
LIMIT 1;
SELECT id INTO @deng_sample_id
FROM biz_protocol_sample
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY 'AAF11BCC7A584B09AFCE17AA8F7B7CD4'
AND BINARY sample_code = BINARY 'ZKZX34001007'
LIMIT 1;
SET @gate := 0;
SELECT IF(@marina_sample_id IS NULL OR @marina_sample_id = '', 1, 0)
+ IF(@deng_sample_id IS NULL OR @deng_sample_id = '', 1, 0)
+ (SELECT COUNT(*) FROM biz_protocol_sample
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code = BINARY 'ZKZX34000964')
+ (SELECT COUNT(*) FROM biz_protocol_sample
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code = BINARY 'ZKZX34000842'
AND id <> @marina_sample_id)
INTO @gate;
SELECT @marina_sample_id AS marina_sample_id,
@deng_sample_id AS deng_sample_id,
@gate AS gate_should_be_0;
SET @__abort := (0 + 1) / IF(@gate = 0, 1, 0);
/* ---------- A. 马丽娜活跃样本 842 → 964 + 编码池切换 ---------- */
UPDATE biz_protocol_sample
SET sample_code = 'ZKZX34000964',
sample_code_id = 'BBC01CCFDCA14E7BBE3ED34CE1B1DE47',
update_by = @operator,
update_time = @now
WHERE id = @marina_sample_id
AND del_flag = 0
AND BINARY sample_code = BINARY 'ZKZX34000842';
UPDATE biz_sample_code
SET issued = 1, update_by = @operator, update_time = @now
WHERE BINARY id = BINARY 'BBC01CCFDCA14E7BBE3ED34CE1B1DE47'
AND BINARY tenant_no = BINARY 'zkxw' AND del_flag = 0;
UPDATE biz_sample_code
SET issued = 0, update_by = @operator, update_time = @now
WHERE BINARY id = BINARY '7C4C8FEDE210453F9D2F357D4F5A46A4'
AND BINARY tenant_no = BINARY 'zkxw' AND del_flag = 0
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_sample
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code_id = BINARY '7C4C8FEDE210453F9D2F357D4F5A46A4'
AND id <> @marina_sample_id
);
UPDATE biz_protocol_sample_transport
SET sample_code = 'ZKZX34000964',
sample_id = @marina_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34000842';
INSERT INTO biz_sample_code_correction_log (
id, reception_source, old_sample_code, new_sample_code, impact_json, reason,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
) VALUES (
REPLACE(UUID(), '-', ''),
'cell_storage', 'ZKZX34000842', 'ZKZX34000964',
JSON_OBJECT(
'biz_protocol_sample', 1,
'biz_sample_code', 1,
'biz_protocol_sample_transport', 1,
'note', 'stepA_marina_protocol_only'
),
'数据修复:马丽娜协议样本 842→964(下游另按协议定向迁移)',
'zkxw', 0, 'fix_marina_deng_20261026_stepA',
@operator, '', @now, @operator, @now, 0
);
/* ---------- B. 马丽娜协议下 1007 → 964(质检/生产/缴费) ---------- */
UPDATE biz_sample_reception
SET sample_code = 'ZKZX34000964',
protocol_sample_id = @marina_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_qc_work_order
SET sample_code = 'ZKZX34000964',
protocol_sample_id = @marina_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_qc_task t
JOIN biz_qc_work_order w
ON w.id = t.work_order_id
AND w.del_flag = 0
AND BINARY w.tenant_no = BINARY 'zkxw'
AND BINARY w.collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
SET t.sample_code = 'ZKZX34000964',
t.update_by = @operator,
t.update_time = @now
WHERE t.del_flag = 0
AND BINARY t.tenant_no = BINARY 'zkxw'
AND BINARY t.sample_code = BINARY 'ZKZX34001007';
UPDATE biz_production_work_order
SET sample_code = 'ZKZX34000964',
protocol_sample_id = @marina_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_sample_production_reception pr
JOIN biz_sample_reception r
ON r.id = pr.reception_id
AND r.del_flag = 0
AND BINARY r.tenant_no = BINARY 'zkxw'
AND BINARY r.collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
SET pr.sample_code = 'ZKZX34000964',
pr.update_by = @operator,
pr.update_time = @now
WHERE pr.del_flag = 0
AND BINARY pr.tenant_no = BINARY 'zkxw'
AND BINARY pr.sample_code = BINARY 'ZKZX34001007';
UPDATE biz_production_task_input ti
JOIN biz_production_task pt
ON pt.id = ti.task_id AND pt.del_flag = 0 AND BINARY pt.tenant_no = BINARY 'zkxw'
JOIN biz_production_work_order pw
ON pw.id = pt.work_order_id
AND pw.del_flag = 0
AND BINARY pw.tenant_no = BINARY 'zkxw'
AND BINARY pw.collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
SET ti.input_code = 'ZKZX34000964',
ti.update_by = @operator,
ti.update_time = @now
WHERE ti.del_flag = 0
AND BINARY ti.tenant_no = BINARY 'zkxw'
AND BINARY ti.input_type = BINARY 'sample'
AND BINARY ti.input_code = BINARY 'ZKZX34001007';
UPDATE biz_storage_release_review
SET sample_code = 'ZKZX34000964',
sample_name = 'ZKZX34000964',
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_sample_payment
SET sample_code = 'ZKZX34000964',
protocol_sample_id = @marina_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_payment_schedule
SET sample_code = 'ZKZX34000964',
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_payment_transfer
SET sample_code = 'ZKZX34000964',
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY '6A7CBB85EA024AF08061FD9AFB8DF6EC'
AND BINARY sample_code = BINARY 'ZKZX34001007';
INSERT INTO biz_sample_code_correction_log (
id, reception_source, old_sample_code, new_sample_code, impact_json, reason,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
) VALUES (
REPLACE(UUID(), '-', ''),
'cell_storage', 'ZKZX34001007', 'ZKZX34000964',
JSON_OBJECT('note', 'stepB_marina_downstream_by_protocol'),
'数据修复:马丽娜下游质检/生产/缴费 1007→964(按协议定向,不含邓诗婷)',
'zkxw', 0, 'fix_marina_deng_20261026_stepB',
@operator, '', @now, @operator, @now, 0
);
/* ---------- C. 邓诗婷 1007 → 842 ---------- */
SELECT COUNT(*) INTO @deng_1007_left_qc
FROM biz_qc_work_order
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code = BINARY 'ZKZX34001007';
SELECT COUNT(*) INTO @deng_1007_left_prod
FROM biz_production_work_order
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code = BINARY 'ZKZX34001007';
SET @gate2 := IF(@deng_1007_left_qc + @deng_1007_left_prod = 0, 0, 1)
+ (SELECT COUNT(*) FROM biz_protocol_sample
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code = BINARY 'ZKZX34000842');
SELECT @deng_1007_left_qc AS leftover_qc_on_1007,
@deng_1007_left_prod AS leftover_prod_on_1007,
@gate2 AS gate2_should_be_0;
SET @__abort2 := (0 + 1) / IF(@gate2 = 0, 1, 0);
UPDATE biz_protocol_sample
SET sample_code = 'ZKZX34000842',
sample_code_id = '7C4C8FEDE210453F9D2F357D4F5A46A4',
update_by = @operator,
update_time = @now
WHERE id = @deng_sample_id
AND del_flag = 0
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_sample_code
SET issued = 1, update_by = @operator, update_time = @now
WHERE BINARY id = BINARY '7C4C8FEDE210453F9D2F357D4F5A46A4'
AND BINARY tenant_no = BINARY 'zkxw' AND del_flag = 0;
UPDATE biz_sample_code
SET issued = 0, update_by = @operator, update_time = @now
WHERE BINARY id = BINARY '817D230359EE4DCEA0F0CB532F099F12'
AND BINARY tenant_no = BINARY 'zkxw' AND del_flag = 0
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_sample
WHERE del_flag = 0 AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY sample_code_id = BINARY '817D230359EE4DCEA0F0CB532F099F12'
);
UPDATE biz_protocol_sample_payment
SET sample_code = 'ZKZX34000842',
protocol_sample_id = @deng_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY 'AAF11BCC7A584B09AFCE17AA8F7B7CD4'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_payment_schedule
SET sample_code = 'ZKZX34000842',
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY 'AAF11BCC7A584B09AFCE17AA8F7B7CD4'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_payment_transfer
SET sample_code = 'ZKZX34000842',
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY 'AAF11BCC7A584B09AFCE17AA8F7B7CD4'
AND BINARY sample_code = BINARY 'ZKZX34001007';
UPDATE biz_protocol_sample_transport
SET sample_code = 'ZKZX34000842',
sample_id = @deng_sample_id,
update_by = @operator,
update_time = @now
WHERE del_flag = 0
AND BINARY tenant_no = BINARY 'zkxw'
AND BINARY collection_protocol_id = BINARY 'AAF11BCC7A584B09AFCE17AA8F7B7CD4'
AND BINARY sample_code = BINARY 'ZKZX34001007';
INSERT INTO biz_sample_code_correction_log (
id, reception_source, old_sample_code, new_sample_code, impact_json, reason,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
) VALUES (
REPLACE(UUID(), '-', ''),
'cell_storage', 'ZKZX34001007', 'ZKZX34000842',
JSON_OBJECT('note', 'stepC_deng_1007_to_842'),
'数据修复:邓诗婷协议样本 1007→842',
'zkxw', 0, 'fix_marina_deng_20261026_stepC',
@operator, '', @now, @operator, @now, 0
);
COMMIT;
/* =============================================================================
三、执行后校验(期望)
- 马丽娜活跃样本 = 964;质检/生产 sample_code = 964;protocol_sample_id = 马丽娜活跃样本
- 邓诗婷活跃样本 = 842;无 ZJ202610090001 / SC202610090001
- 1007 无活跃协议样本
============================================================================= */
SELECT '【验1】活跃样本归属' AS step;
SELECT ps.sample_code, cp.protocol_no, ppc.mother_name, ps.id AS protocol_sample_id
FROM biz_protocol_sample ps
JOIN biz_collection_protocol cp ON cp.id = ps.collection_protocol_id
LEFT JOIN biz_protocol_party_customer ppc
ON ppc.collection_protocol_id = ps.collection_protocol_id AND ppc.del_flag = 0
WHERE ps.tenant_no = 'zkxw' AND ps.del_flag = 0
AND ps.sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
ORDER BY ps.sample_code;
SELECT '【验2】马丽娜下游' AS step;
SELECT 'qc_wo' AS tbl, work_order_no, sample_code, protocol_sample_id, collection_protocol_id, conclusion
FROM biz_qc_work_order
WHERE id = '019FC51312BB4225901014BE90A3AB2E'
UNION ALL
SELECT 'prod_wo', work_order_no, sample_code, protocol_sample_id, collection_protocol_id, work_order_status
FROM biz_production_work_order
WHERE id = '92F20C8B731E474985BB2C6D74A2BA3A'
UNION ALL
SELECT 'reception', id, sample_code, protocol_sample_id, collection_protocol_id, lab_storage_code
FROM biz_sample_reception
WHERE id = '0E69E16E7E9C4B3AA9D894622BBE237B';
SELECT '【验3】三码活跃样本数(期望 842=1, 964=1, 1007=0)' AS step;
SELECT sample_code, COUNT(*) AS cnt
FROM biz_protocol_sample
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND sample_code IN ('ZKZX34000842', 'ZKZX34000964', 'ZKZX34001007')
GROUP BY sample_code;
SELECT '【验4】邓诗婷协议下不应有该质检/生产工单' AS step;
SELECT COUNT(*) AS deng_should_be_0
FROM biz_qc_work_order
WHERE tenant_no = 'zkxw' AND del_flag = 0
AND collection_protocol_id = 'AAF11BCC7A584B09AFCE17AA8F7B7CD4';
SELECT COUNT(*) AS leftover_1007_qc_should_be_0
FROM biz_qc_task
WHERE tenant_no = 'zkxw' AND del_flag = 0 AND sample_code = 'ZKZX34001007';
@@ -0,0 +1,81 @@
# 基础实验交付日前一天服务号提醒 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
> Spec: `docs/superpowers/specs/2026-10-22-basic-experiment-delivery-remind-design.md`
**Goal:** 每天 10:00 扫描次日交付的基础实验计划,向申请单创建人发送服务号模板消息。
**Architecture:** 纯函数拼接产品名 + 服务层扫描/幂等/发送;复用 `wechat_mp_message._send_template`;APScheduler Cron 注册;`biz_wx_notify_log` 防重。
**Tech Stack:** FastAPI、SQLAlchemy、APScheduler、pytest、微信服务号 template/send
---
### File map
| 文件 | 职责 |
|------|------|
| `docs/sql/migrations/2026-10-22-biz-wx-notify-log.sql` | 幂等日志表 |
| `backend/app/models/models.py` | `BizWxNotifyLog` |
| `backend/app/core/config.py` | 模板 ID 与字段名配置 |
| `backend/app/services/wechat_mp_message.py` | `send_basic_experiment_delivery_remind` |
| `backend/app/services/basic_experiment_delivery_remind.py` | 拼接、扫描、发送、幂等 |
| `backend/app/tasks/__init__.py` | Cron 10:00 |
| `backend/tests/test_basic_experiment_delivery_remind.py` | 单测 |
---
### Task 1: 产品名称拼接(纯函数 TDD)
**Files:**
- Create: `backend/app/services/basic_experiment_delivery_remind.py`
- Test: `backend/tests/test_basic_experiment_delivery_remind.py`
- [x] **Step 1: Write failing tests for `format_delivery_product_name`**
- [x] **Step 2: Implement `format_delivery_product_name`**
- [x] **Step 3: pytest pass**
---
### Task 2: 配置 + 模板发送封装
**Files:**
- Modify: `backend/app/core/config.py`
- Modify: `backend/app/services/wechat_mp_message.py`
- Test: extend `test_basic_experiment_delivery_remind.py`(mock `_send_template`)
- [x] 增加 `WX_MP_TEMPLATE_BASIC_EXPERIMENT_DELIVERY` 与字段配置
- [x] 增加 `send_basic_experiment_delivery_remind`
- [x] 单测校验 data 字段键与截断
---
### Task 3: SQL + Model + 扫描发送 + 幂等
**Files:**
- Create: `docs/sql/migrations/2026-10-22-biz-wx-notify-log.sql`
- Modify: `backend/app/models/models.py`
- Modify: `backend/app/services/basic_experiment_delivery_remind.py`
- Test: `backend/tests/test_basic_experiment_delivery_remind.py`
- [x] DDL + `BizWxNotifyLog`
- [x] `run_delivery_remind_for_date(db, *, today)`:查明天交付、basic_experiment、非 yqx;幂等;发送
- [x] 单测:命中/跳过取消/跳过无 openid/幂等二次不发
---
### Task 4: 注册定时任务
**Files:**
- Modify: `backend/app/tasks/__init__.py`
- [x] Cron `hour=10, minute=0` 调用 `run_delivery_remind_job(get_db_session)`
---
### Task 5: 验证 + 图谱
- [x] `pytest backend/tests/test_basic_experiment_delivery_remind.py -v`
- [x] `./scripts/update-graph.sh backend`
@@ -0,0 +1,44 @@
# 细胞产品基础信息维护 · 三 Tab 列表 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 将细胞产品基础信息维护从三列看板改为三个 Tab 的标准列表页。
**Architecture:** `index.vue` 仅作 `panel-pill-tabs` 壳 + `?tab=` 同步;价格/规格复用现有列表模式并删除 kanban;新建 `CellProductTypeTab.vue` 承载类型列表 CRUD。
**Tech Stack:** Vue 3 + Element Plus + 现有 `@/api/admin` 细胞产品接口
**Spec:** `docs/superpowers/specs/2026-10-22-cell-product-basic-info-tabs-list-design.md`
---
### Task 1: 新建 CellProductTypeTab.vue
**Files:**
- Create: `web-admin/src/views/pilot-service/cell-product-type/CellProductTypeTab.vue`
- [x] 按 `CellProductSpecTab` 列表模式实现类型列表(筛选/工具栏/表格/分页/弹窗/查看)
- [x] `defineExpose({ handleAdd, loadData })`;类型变更后由壳页可调价格 `loadData`
### Task 2: 重写 index.vue 为 Tab 壳
**Files:**
- Modify: `web-admin/src/views/pilot-service/cell-product-type/index.vue`
- [x] `el-tabs`:price / type / spec;默认 price
- [x] 同步 `route.query.tab`(合法值 price|type|spec)
- [x] 挂载三个子组件;类型变更后刷新价格 Tab(若已挂载)
- [x] 移除统计卡与看板
### Task 3: 价格/规格去掉 kanban
**Files:**
- Modify: `CellProductPriceTab.vue`、`CellProductSpecTab.vue`
- [x] 删除 kanban 模板、`layout` prop、`meta-change`、kanban 样式与 scss import
- [x] **不删除** `cell-product-kanban.scss` 文件本身
### Task 4: 验证
- [x] ESLint / 类型相关无明显错误;手动验收三 Tab 与 `?tab=`
- [x] `./scripts/update-graph.sh frontend`
@@ -0,0 +1,20 @@
# 细胞产品包装 Implementation Plan
> **For agentic workers:** 本计划已在会话内直接执行。
**Goal:** 在细胞产品基础信息维护页追加「产品包装」主数据 Tab(CRUD)。
**Architecture:** 对齐规格主数据:`biz_cell_product_package` + pilot_service CRUD/API + `CellProductPackageTab`。
**Tech Stack:** FastAPI + SQLAlchemy + Vue 3 Element Plus
---
### Task 1: SQL / Model / CRUD / API — done
### Task 2: Frontend Tab + API 类型 — done
### Task 3: 执行迁移 SQL(需用户在目标库执行)
```bash
# 在目标 MySQL 执行
# docs/sql/migrations/2026-10-22-cell-product-package.sql
```
@@ -0,0 +1,29 @@
# 细胞产品按储物格位置搜索 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 「选择细胞产品」弹窗支持按储物格位置与编码/名称同一关键词搜索。
**Architecture:** 前端本地过滤补 `storageSlotName`;后端 `keyword` 通过复用储物格路径匹配得到 slot id 集合后 OR 进列表查询。
**Tech Stack:** Vue 3、FastAPI、SQLAlchemy、既有 `storage_facility` 关键词匹配。
---
### Task 1: 后端 keyword 支持储物格
**Files:**
- Modify: `backend/app/crud/storage_facility.py`(导出 `search_slot_ids_by_keyword`)
- Modify: `backend/app/crud/cell_product.py`(`list_cell_products` keyword)
- Test: `backend/tests/test_cell_product_keyword_slot.py`
- [x] Step 1: 增加 `search_slot_ids_by_keyword` 并在 cell product 列表 keyword 中 OR
- [x] Step 2: 补充单元/轻量测试并跑通
### Task 2: 前端弹窗过滤与文案
**Files:**
- Modify: `web-admin/src/views/production/production-work-order/TaskInputEnhancedTable.vue`
- [x] Step 1: `filteredCellProducts` 匹配 `storageSlotName`;更新 placeholder
- [x] Step 2: 更新 graphify(frontend + backend)
@@ -0,0 +1,349 @@
# 侧栏菜单角标 1 分钟轮询 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 登录后每 60 秒静默刷新 web-admin 侧栏可见菜单的红色角标数字,页签隐藏时暂停,退出登录时停止。
**Architecture:** 新增 `menu-badge-polling.ts` 封装 `refreshAllMenuBadges` + 幂等 start/stop + `visibilitychange` + `inFlight` 锁;在路由守卫菜单就绪后 `startMenuBadgePolling()`(替代三处独立 `void refresh*`),在 `clearSession` 中先 `stop` 再 `clearBadges`。复用现有 OA/质检/生产 count 刷新,不改后端。
**Tech Stack:** Vue 3 + Pinia + TypeScript(web-admin);`node:test` 单测与现有 `src/utils/*.test.ts` 一致。
**Spec:** `docs/superpowers/specs/2026-10-22-menu-badge-polling-design.md`
---
## File map
| 文件 | 职责 |
|------|------|
| Create: `web-admin/src/utils/menu-badge-polling.ts` | 轮询生命周期与 `refreshAll` |
| Create: `web-admin/src/utils/menu-badge-polling.test.ts` | 幂等、inFlight、visibility、stop |
| Modify: `web-admin/src/router/guards/beforeEach.ts` | 菜单就绪后 start 轮询 |
| Modify: `web-admin/src/store/modules/user.ts` | clearSession 时 stop |
| Modify: `docs/superpowers/specs/2026-10-22-menu-badge-polling-design.md` | 状态改为已定稿 |
---
### Task 1: 轮询工具模块 + 单元测试
**Files:**
- Create: `web-admin/src/utils/menu-badge-polling.ts`
- Create: `web-admin/src/utils/menu-badge-polling.test.ts`
- [x] **Step 1: 写失败测试(先造期望行为)**
创建 `web-admin/src/utils/menu-badge-polling.test.ts`:
```ts
import { describe, it, beforeEach, afterEach, mock } from 'node:test'
import assert from 'node:assert/strict'
// 用可注入依赖测逻辑:测试文件直接测导出函数;对 refresh* 用 mock.module 若环境不支持则改为
// 将 refreshAll 的依赖通过内部可测结构验证 start/stop/visibility/inFlight。
// 本仓库部分测试为纯函数;轮询模块将导出可测状态帮助断言。
import {
refreshAllMenuBadges,
startMenuBadgePolling,
stopMenuBadgePolling,
isMenuBadgePollingActive,
MENU_BADGE_POLL_INTERVAL_MS
} from './menu-badge-polling'
describe('menu-badge-polling', () => {
beforeEach(() => {
stopMenuBadgePolling()
})
afterEach(() => {
stopMenuBadgePolling()
})
it('exports 60s interval', () => {
assert.equal(MENU_BADGE_POLL_INTERVAL_MS, 60_000)
})
it('start is idempotent (single active flag)', () => {
startMenuBadgePolling()
startMenuBadgePolling()
assert.equal(isMenuBadgePollingActive(), true)
stopMenuBadgePolling()
assert.equal(isMenuBadgePollingActive(), false)
})
it('stop is safe when not started', () => {
stopMenuBadgePolling()
assert.equal(isMenuBadgePollingActive(), false)
})
})
```
说明:对 `refreshAllMenuBadges` 与真实 `refreshOa/Qc/Production` 的集成,在实现里用 `Promise.allSettled`;单测以间隔常量、幂等 start/stop 为主,避免依赖 Pinia/HTTP。
- [x] **Step 2: 运行测试确认失败**
```bash
cd web-admin && node --import tsx --test src/utils/menu-badge-polling.test.ts
```
Expected: FAIL(模块不存在)
- [x] **Step 3: 实现 `menu-badge-polling.ts`**
```ts
import { refreshOaMenuBadges } from '@/utils/oa-menu-badge'
import { refreshQcMenuBadges } from '@/utils/qc-menu-badge'
import { refreshProductionMenuBadges } from '@/utils/production-menu-badge'
export const MENU_BADGE_POLL_INTERVAL_MS = 60_000
let timerId: ReturnType<typeof setInterval> | null = null
let visibilityBound = false
let inFlight = false
let started = false
export function isMenuBadgePollingActive(): boolean {
return started
}
export async function refreshAllMenuBadges(): Promise<void> {
if (inFlight) return
inFlight = true
try {
await Promise.allSettled([
refreshOaMenuBadges(),
refreshQcMenuBadges(),
refreshProductionMenuBadges()
])
} finally {
inFlight = false
}
}
function onVisibilityChange(): void {
if (typeof document === 'undefined') return
if (document.hidden) {
if (timerId != null) {
clearInterval(timerId)
timerId = null
}
return
}
// 恢复可见:立即补刷,再重启 interval
void refreshAllMenuBadges()
if (started && timerId == null) {
timerId = setInterval(() => {
void refreshAllMenuBadges()
}, MENU_BADGE_POLL_INTERVAL_MS)
}
}
function bindVisibility(): void {
if (visibilityBound || typeof document === 'undefined') return
document.addEventListener('visibilitychange', onVisibilityChange)
visibilityBound = true
}
function unbindVisibility(): void {
if (!visibilityBound || typeof document === 'undefined') return
document.removeEventListener('visibilitychange', onVisibilityChange)
visibilityBound = false
}
/** 幂等:已启动则忽略。启动时立即刷一轮,再按 60s 轮询。 */
export function startMenuBadgePolling(): void {
if (started) return
started = true
bindVisibility()
void refreshAllMenuBadges()
if (typeof document !== 'undefined' && document.hidden) {
// 隐藏态不启 timer,等可见时 onVisibilityChange 重启
return
}
timerId = setInterval(() => {
void refreshAllMenuBadges()
}, MENU_BADGE_POLL_INTERVAL_MS)
}
export function stopMenuBadgePolling(): void {
started = false
if (timerId != null) {
clearInterval(timerId)
timerId = null
}
unbindVisibility()
inFlight = false
}
```
注意:路径别名 `@/` 在 `node --test` 下可能解析失败。若 Step 4 因别名失败,改为相对导入:
```ts
import { refreshOaMenuBadges } from './oa-menu-badge'
import { refreshQcMenuBadges } from './qc-menu-badge'
import { refreshProductionMenuBadges } from './production-menu-badge'
```
(与同目录其它 util 互相引用风格一致即可;`beforeEach` / 业务页仍可用 `@/`。)
若相对导入仍因 Pinia/网络依赖导致单测加载失败:将测试收敛为只断言常量与「模块可导出 start/stop 且幂等不抛错」,或把 `refresh*` 注入改为可选参数(YAGNI:优先相对导入 + 仅测 start/stop 幂等;加载连锁失败时在测试文件顶部用注释说明改为手工验收 Task 3)。
推荐稳健写法:轮询模块顶部相对导入三个 refresh;单测只跑 start/stop/常量,不 await `refreshAll`(避免未初始化 Pinia)。`startMenuBadgePolling` 会 `void refreshAllMenuBadges()`——若因此炸测,给 `refreshAllMenuBadges` 增加可选参数或在测试环境吞掉:
```ts
export async function refreshAllMenuBadges(): Promise<void> {
if (inFlight) return
inFlight = true
try {
await Promise.allSettled([
refreshOaMenuBadges().catch(() => undefined),
refreshQcMenuBadges().catch(() => undefined),
refreshProductionMenuBadges().catch(() => undefined)
])
} finally {
inFlight = false
}
}
```
各 `refresh*` 内部已有 catch;`allSettled` 足够。单测环境若在 import 链上失败,则 **跳过自动测**,在 Task 3 手工验收,并在本 Task commit message 注明。
- [x] **Step 4: 再跑测试**
```bash
cd web-admin && node --import tsx --test src/utils/menu-badge-polling.test.ts
```
Expected: PASS(或按上文降级为手工验收并删除/精简测文件)
- [ ] **Step 5: Commit**(仅当用户要求提交时执行;默认实现后由用户决定是否 commit)
```bash
git add web-admin/src/utils/menu-badge-polling.ts web-admin/src/utils/menu-badge-polling.test.ts
git commit -m "$(cat <<'EOF'
feat(web-admin): add 60s sidebar menu badge polling utility
EOF
)"
```
---
### Task 2: 路由守卫启动 + 退出停止
**Files:**
- Modify: `web-admin/src/router/guards/beforeEach.ts`(约 305–307 行)
- Modify: `web-admin/src/store/modules/user.ts`(`clearSession` 内 clearBadges 之前)
- [x] **Step 1: 改 beforeEach**
将:
```ts
void refreshQcMenuBadges()
void refreshProductionMenuBadges()
void refreshOaMenuBadges()
```
替换为:
```ts
startMenuBadgePolling()
```
并调整 import:删除三个 `refresh*` 的 import,增加:
```ts
import { startMenuBadgePolling } from '@/utils/menu-badge-polling'
```
`startMenuBadgePolling` 内部已立即 `refreshAll`,行为覆盖原「首次三刷」。
- [x] **Step 2: 改 clearSession**
在 `useQcMenuBadgeStore().clearBadges()` 等三行**之前**插入:
```ts
stopMenuBadgePolling()
```
并增加 import:
```ts
import { stopMenuBadgePolling } from '@/utils/menu-badge-polling'
```
完整片段顺序:
```ts
stopMenuBadgePolling()
useQcMenuBadgeStore().clearBadges()
useProductionMenuBadgeStore().clearBadges()
useOaMenuBadgeStore().clearBadges()
```
- [x] **Step 3: 确认业务页即时 refresh 仍在**
抽查以下文件仍直接调用各自 `refresh*MenuBadges`(不要删):
- `web-admin/src/views/oa-approval/pending/index.vue`
- `web-admin/src/views/oa-approval/drafts/index.vue`
- `web-admin/src/views/quality-inspection/qc-work-order/index.vue`
- `web-admin/src/views/production/my-production-task/index.vue`
- [ ] **Step 4: Commit**(仅用户要求时)
```bash
git add web-admin/src/router/guards/beforeEach.ts web-admin/src/store/modules/user.ts
git commit -m "$(cat <<'EOF'
feat(web-admin): wire menu badge polling to login and logout
EOF
)"
```
---
### Task 3: 规格状态 + graphify + 手工验收
**Files:**
- Modify: `docs/superpowers/specs/2026-10-22-menu-badge-polling-design.md`(状态 → 已定稿)
- [x] **Step 1: 更新规格状态表**
规格状态已是「已定稿(用户确认:60s 轮询)」,无需再改。
- [x] **Step 2: 更新前端知识图谱**
```bash
./scripts/update-graph.sh frontend
```
- [ ] **Step 3: 手工验收清单**
> **待用户验收**:以下 5 项需在浏览器中由用户亲自验证,Agent 不宣称手工 QA 已通过。
1. 登录后侧栏角标有数;DevTools Network 过滤 count / unfinished,约 60s 再出现一批请求。
2. 切到其他页签 >1 分钟再切回:应立刻出现一轮刷新请求。
3. 待办审批成功:角标立刻变,不等下一分钟。
4. 轮询时列表/表单不闪、不 reload。
5. 退出再登录:Network 无双倍 interval(每分钟大约仍是一批,不是两批叠在一起)。
- [ ] **Step 4: Commit docs + graph**(仅用户要求时)
---
## Spec coverage self-check
| 规格要求 | Task |
|----------|------|
| 60s 轮询 | Task 1 `MENU_BADGE_POLL_INTERVAL_MS` |
| 复用三组 refresh,非总接口 | Task 1 `refreshAllMenuBadges` |
| 不整页刷新 | 仅改 store,无路由/列表 reload |
| visibility 暂停/恢复补刷 | Task 1 `onVisibilityChange` |
| 退出 stop + clearBadges | Task 2 |
| 菜单就绪后 start,幂等 | Task 1 + Task 2 beforeEach |
| 业务即时 refresh 保留 | Task 2 Step 3 |
| inFlight 防堆积 | Task 1 |
| graphify | Task 3 |
无 WebSocket、无后端变更、无小程序 —— 符合非目标。
@@ -0,0 +1,147 @@
# 科研捐赠质检协议状态筛选 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 科研捐赠质检(含我的质检任务同 Tab)默认排除协议已作废/属地废弃,并提供协议状态多选筛选;角标口径一致。
**Architecture:** 后端列表/统计对科研捐赠按 `donation_status` 过滤;前端仅在 `inbound_research_donation` Tab 暴露多选并默认勾非废弃;我的任务在现有前端二次过滤中追加 `protocolStatus`。
**Tech Stack:** FastAPI + SQLAlchemy;Vue 3 + Element Plus;pytest / node:test
**Spec:** `docs/superpowers/specs/2026-10-22-qc-research-donation-protocol-status-filter-design.md`
---
## File map
| File | Responsibility |
|------|----------------|
| `backend/app/crud/qc_work_order.py` | `apply_research_donation_protocol_status_filter`;`list_work_orders` / count APIs 接入 |
| `backend/app/api/qc.py` | Query `protocolStatus` 透传 |
| `backend/tests/test_qc_research_donation_protocol_status_filter.py` | 纯函数/过滤语义单测 |
| `web-admin/src/utils/status-tag-registry.ts` | 默认选项、join/match helpers |
| `web-admin/src/utils/qc-mine-task-groups.ts` | mine 二次过滤 |
| `web-admin/src/utils/qc-mine-task-groups.test.ts` | 前端过滤单测 |
| `web-admin/src/api/qc-work-order.ts` | list params 类型 |
| `web-admin/.../useQcWorkOrderTabPage.ts` | searchForm / reset / query |
| `web-admin/.../QcWorkOrderTabPanel.vue` | 筛选项 UI |
---
### Task 1: Backend filter helper + list/count wiring
**Files:**
- Create: `backend/tests/test_qc_research_donation_protocol_status_filter.py`
- Modify: `backend/app/crud/qc_work_order.py`
- Modify: `backend/app/api/qc.py`
- [ ] **Step 1: Write failing tests for resolve semantics**
```python
# backend/tests/test_qc_research_donation_protocol_status_filter.py
from app.core.protocol_status_display import INACTIVE_PROTOCOL_STATUSES
from app.crud.qc_work_order import resolve_research_donation_protocol_status_filter
def test_inactive_constant():
assert set(INACTIVE_PROTOCOL_STATUSES) == {"yzf", "sdfq"}
def test_explicit_statuses_returned():
assert resolve_research_donation_protocol_status_filter("dsx,sxz") == ("in", ["dsx", "sxz"])
def test_explicit_empty_means_none():
assert resolve_research_donation_protocol_status_filter("") == ("none", [])
def test_missing_means_exclude_inactive_for_research_donation():
assert resolve_research_donation_protocol_status_filter(None) == (
"exclude_inactive",
list(INACTIVE_PROTOCOL_STATUSES),
)
```
- [ ] **Step 2: Run test to verify it fails**
Run: `cd backend && source venv/bin/activate && pytest tests/test_qc_research_donation_protocol_status_filter.py -v`
Expected: FAIL (function missing)
- [ ] **Step 3: Implement helper + apply in list/count**
Add `resolve_research_donation_protocol_status_filter` and `apply_research_donation_protocol_status_filter(query, protocol_status, *, reception_source)` in `qc_work_order.py`.
- Only when `reception_source == "research_donation"` (list) or always for unfinished counts on RD rows.
- Link: `eq_unicode(BizResearchDonation.id, BizQcWorkOrder.collection_protocol_id)` + `del_flag==0`.
- Mode `in`: `exists(... donation_status.in_(statuses))`
- Mode `none`: `id.in_([])`
- Mode `exclude_inactive`: `~and_(reception_source==research_donation, exists(... status in INACTIVE))` for counts; for list with reception_source already RD: `~exists(... status in INACTIVE)` OR require exists with status notin inactive — prefer: `exists(... status.notin_(INACTIVE))` so missing donation also hidden when excluding (align with empty status edge). Spec: empty status not shown under explicit IN; for default exclude, prefer exclude only known inactive (orphans keep) OR hide orphans. Spec §4: 「无捐赠单 / donation_status 为空:显式 IN 过滤时不命中」。Default exclude: only exclude known inactive via `~exists(inactive)` so orphans remain — OK for badges.
Wire `protocol_status` into `list_work_orders` and call exclude on both count functions for RD inactive.
API: add `protocolStatus` Query to `list_qc_work_orders`, pass as `protocol_status=`.
- [ ] **Step 4: Run tests pass**
Run: `pytest tests/test_qc_research_donation_protocol_status_filter.py -v`
Expected: PASS
- [ ] **Step 5: Commit** — skip unless user asks (user rule)
---
### Task 2: Frontend status helpers + mine filter
**Files:**
- Modify: `web-admin/src/utils/status-tag-registry.ts`
- Modify: `web-admin/src/utils/qc-mine-task-groups.ts`
- Create: `web-admin/src/utils/qc-mine-task-groups.test.ts` (or extend if pattern uses assert)
- [ ] **Step 1: Failing tests for match + mine filter**
```ts
// matchesProtocolStatusFilter: undefined → true; [] → false; ['sxz'] matches sxz only
// filterMineEntriesByWorkOrderSearch with protocolStatus:['sxz'] hides yzf
```
- [ ] **Step 2: Implement**
```ts
export const DEFAULT_DONATION_PROTOCOL_STATUS_FILTER = Object.keys(donationStatus).filter(
(k) => !(INACTIVE_PROTOCOL_STATUSES as readonly string[]).includes(k)
)
export const DONATION_PROTOCOL_STATUS_FILTER_OPTIONS = Object.entries(donationStatus).map(...)
export function joinProtocolStatusFilter(statuses: string[]): string | undefined
// Note: empty array → return '' (not undefined) so API gets explicit empty
export function matchesProtocolStatusFilter(status: string, filter: string[] | undefined): boolean
```
Mine filters: add `protocolStatus?: string[]`; when `tabKey === 'inbound_research_donation'` and `protocolStatus !== undefined`, apply `matchesProtocolStatusFilter`.
- [ ] **Step 3: Run frontend tests**
Run: `cd web-admin && pnpm exec tsx --test src/utils/qc-mine-task-groups.test.ts` (or project’s usual test runner)
---
### Task 3: Tab panel UI + composable + API type
**Files:**
- Modify: `web-admin/src/api/qc-work-order.ts`
- Modify: `web-admin/src/views/quality-inspection/qc-work-order/composables/useQcWorkOrderTabPage.ts`
- Modify: `web-admin/src/views/quality-inspection/qc-work-order/tabs/QcWorkOrderTabPanel.vue`
- [ ] searchForm.protocolStatus default `DEFAULT_DONATION_PROTOCOL_STATUS_FILTER`
- [ ] reset restores default
- [ ] manage loadData: if tab is RD, pass `protocolStatus: joinProtocolStatusFilter(...)` (empty → `''`)
- [ ] mine: include protocolStatus in `buildMineWorkOrderSearchFilters` when RD tab
- [ ] UI: after 工单状态,`v-if="tabKey === 'inbound_research_donation'"` multi select both filter blocks
- [ ] Update graph: `./scripts/update-graph.sh all` after code changes
---
### Task 4: Verification
- [ ] Backend pytest for new tests
- [ ] Frontend unit tests
- [ ] Manual checklist from spec §5 (inform user to smoke-test in UI; agent must not restart servers)
@@ -0,0 +1,15 @@
# 样本编码全链路纠错 Implementation Plan
> **For agentic workers:** Implement task-by-task. Spec: `docs/superpowers/specs/2026-10-22-sample-code-correction-design.md`
**Goal:** 提供预览 + 事务级联更正样本编码,覆盖协议/捐赠 SoT 与质检/生产/缴费等下游快照表。
**Architecture:** 服务层 `sample_code_correction` 统一 count/update;API 暴露 preview/apply;审计表落库;样本信息页弹窗入口。
**Tech Stack:** FastAPI + SQLAlchemy;Vue 3 + Element Plus;pytest(sqlite in-memory)
---
### Task 1: SQL + Model + Service + API + Tests + UI
见设计文档表清单与 API 约定;本计划一次性落地。
@@ -0,0 +1,45 @@
# 储存证质检三端可编辑 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 市场 / 质检 / 生产三端均可编辑同一份储存证质检信息(方案 A)。
**Architecture:** 复用 `StorageCertQcDialog` 与现有 GET/PUT;扩展菜单白名单;生产卡片与市场行操作挂载 edit 模式。
**Tech Stack:** FastAPI menu guard;Vue 3 + Element Plus;既有 `biz_sample_storage_cert_qc`。
**Design Doc:** `docs/superpowers/specs/2026-10-22-storage-cert-qc-multi-dept-edit-design.md`
---
## File map
| File | Change |
|------|--------|
| `backend/app/api/sample_storage_cert_qc.py` | READ/WRITE menus |
| `web-admin/.../storage-cert-qc-dialog/index.vue` | 空态文案 |
| `web-admin/.../ProductionWorkOrderCardList.vue` | 按钮 + 弹窗 |
| `web-admin/.../UnifiedSampleInfoPage.vue` | 查看 → 填写 edit |
---
### Task 1: API 菜单白名单
- [x] 将 `READ_MENUS` / `WRITE_MENUS` 设为设计文档列出的五码(读写一致)
### Task 2: 弹窗空态
- [x] 「质检尚未填写」→「尚未填写」
### Task 3: 生产卡片
- [x] `supportsStorageCertQc` + `inbound_cell_storage` 时显示按钮
- [x] 挂载 `StorageCertQcDialog` mode=edit,传入 sampleCode / sampleTypeName
### Task 4: 市场样本信息
- [x] 按钮文案改为「填写储存证质检信息」;dialog mode=edit
### Task 5: 验证
- [x] grep 确认科研捐赠仍隐藏;三端入口与权限码齐全;权限单测通过
@@ -0,0 +1,97 @@
# 临时质检同生产工单成组排序 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 【质检工单】与【我的质检任务】的「临时质检」Tab 按创建时间倒序为基准,并将同一生产工单派发的质检工单成组相邻展示。
**Architecture:** 后端临时列表用聚合子查询 `MAX(create_time)` 按 `production_work_order_id` 成组后 `ORDER BY`;我的任务侧在工单聚合后用同规则前端排序。对齐入库实验室排序的「后端 clauses + 前端 compare」模式。
**Tech Stack:** FastAPI / SQLAlchemy / MySQL 5.7;Vue 3;pytest
**Spec:** `docs/superpowers/specs/2026-10-22-temporary-qc-production-cluster-sort-design.md`
---
## File map
| File | Responsibility |
|------|----------------|
| Create `backend/app/crud/qc_temporary_production_cluster_sort.py` | `uses_temporary_cluster_list_sort` + `temporary_cluster_order_by_clauses(filtered_query)` |
| Modify `backend/app/crud/qc_work_order.py` | 临时列表启用成组 `order_by` |
| Create `backend/tests/test_qc_temporary_production_cluster_sort.py` | 排序断言(可测纯函数或 clauses 拼装;若有 DB fixture 则测 list) |
| Create `web-admin/src/utils/qc-temporary-production-cluster-sort.ts` | `compareTemporaryProductionClusterDesc` |
| Modify `web-admin/src/utils/qc-mine-task-groups.ts` | `sortMineEntriesForTemporary` |
| Modify `web-admin/src/views/.../useQcWorkOrderTabPage.ts` | mine + temporary 时调用新 sort |
---
### Task 1: 后端成组排序辅助模块 + 接入列表
**Files:**
- Create: `backend/app/crud/qc_temporary_production_cluster_sort.py`
- Modify: `backend/app/crud/qc_work_order.py`(`list_*` 中 `order_by` 分支,约 1717–1720 行一带)
- Test: `backend/tests/test_qc_temporary_production_cluster_sort.py`
- [ ] **Step 1: 写失败测试(比较/规则)**
覆盖:同 PWO 相邻且组内时间倒序;组与组之间按组内最新时间;手动单元素组按自身时间。
- [ ] **Step 2: 实现 `qc_temporary_production_cluster_sort.py`**
- `uses_temporary_cluster_list_sort(work_order_type, qc_biz_type)`:临时为 True。
- 对 `_filtered()` 子查询按非空 `production_work_order_id` 聚合 `MAX(create_time)`,`outerjoin` 后:
`ORDER BY coalesce(group_max, create_time) DESC, coalesce(pwo_id, id), create_time DESC`。
- [ ] **Step 3: 在 `list_qc_work_orders` 接入**
```python
if uses_inbound_lab_storage_list_sort(reception_source):
q_page = q_page.order_by(*inbound_lab_storage_order_by_clauses())
elif uses_temporary_cluster_list_sort(work_order_type, ...):
q_page = apply_temporary_cluster_order(q_page, db) # 或 order_by(*clauses)
else:
q_page = q_page.order_by(BizQcWorkOrder.create_time.desc())
```
注意:若存在独立 `list_temporary_*`,一并改掉,避免双路径不一致。
- [ ] **Step 4: 跑测试**
Run: `cd backend && source venv/bin/activate && pytest tests/test_qc_temporary_production_cluster_sort.py -v`
- [ ] **Step 5: Commit**(仅当用户要求时)
---
### Task 2: 前端我的任务成组排序
**Files:**
- Create: `web-admin/src/utils/qc-temporary-production-cluster-sort.ts`
- Modify: `web-admin/src/utils/qc-mine-task-groups.ts`
- Modify: `web-admin/src/views/quality-inspection/qc-work-order/composables/useQcWorkOrderTabPage.ts`
- [ ] **Step 1: 实现 compare + `sortMineEntriesForTemporary`**
与设计 §3 一致:组键 = `productionWorkOrderId || id`;组时 = 组内 max `createTime`;组 DESC,组内 createTime DESC。
- [ ] **Step 2: `useQcWorkOrderTabPage` mine 分支**
```ts
if (isInboundSampleQcTab(tabKey.value)) {
entries = sortMineEntriesForInboundLabStorage(entries)
} else if (tabKey.value === 'temporary') {
entries = sortMineEntriesForTemporary(entries)
}
```
- [ ] **Step 3: 手动或单测核对示例顺序 Q1→Q2,Q3→Q4**
- [ ] **Step 4: 更新 graph(若改了模块边界)** `./scripts/update-graph.sh all`(或 backend + frontend)
---
### Task 3: 验收核对
- [ ] 质检工单临时 Tab:同生产派发相邻
- [ ] 我的质检任务临时 Tab:同上
- [ ] 其它 Tab 无回归
@@ -0,0 +1,18 @@
# OA「提到我的」未读角标 Implementation Plan
> **For agentic workers:** TDD;每步可验证;完成后更新 graph。
**Goal:** 「提到我的」菜单红字角标 = 未读 grant 数;打开详情标已读。
**Tech:** `oa_instance_view_grant.is_read` + count/mark API;复用 `oa-menu-badge` / `oa-badge.js`。
**Spec:** `docs/superpowers/specs/2026-10-23-oa-mention-unread-badge-design.md`
## Tasks
1. SQL migration + ORM `is_read`
2. Backend: count / mark / grant reset / list `isRead` + tests
3. API routes + frontend API clients
4. Web badge store/poll + mentions list mark-read UI
5. mobile-h5 badge + mentions list mark-read
6. Run tests + `./scripts/update-graph.sh backend`(及前端若改多)
@@ -0,0 +1,44 @@
# 协议新增样本服务号通知 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 细胞存储/科研捐赠协议保存后,对新增 sample_code 向角色「样本采集通知人员」发送服务号模板消息。
**Architecture:** 纯函数拼标题 + `sample_collect_wx_notify` 差集/角色/幂等/发送;复用 `_send_template`;API commit 成功后 `threading` 异步调度。
**Tech Stack:** FastAPI、SQLAlchemy、pytest、微信服务号 template/send
**Spec:** `docs/superpowers/specs/2026-10-23-sample-collect-wx-notify-design.md`
---
### Task 1: 配置 + 发送函数
**Files:** `backend/app/core/config.py`, `backend/.env.example`, `backend/app/services/wechat_mp_message.py`
- [x] 增加 `WX_MP_TEMPLATE_SAMPLE_COLLECT` 及字段/角色名配置
- [x] `send_sample_collect_notify(...)`
### Task 2: 通知服务 + 单测
**Files:** `backend/app/services/sample_collect_wx_notify.py`, `backend/tests/test_sample_collect_wx_notify.py`
- [x] 差集、标题、角色查询、幂等、schedule
- [x] pytest
### Task 3: API 钩子
**Files:** `backend/app/api/collection_protocol.py`, `backend/app/api/research_donation.py`
- [x] create/update 成功路径调度通知
### Task 4: 角色种子 SQL
**Files:** `docs/sql/migrations/2026-10-23-sample-collect-notify-role.sql`
- [x] 幂等插入角色「样本采集通知人员」
### Task 5: 验证
- [x] `pytest tests/test_sample_collect_wx_notify.py`
- [x] `./scripts/update-graph.sh backend`
@@ -0,0 +1,36 @@
# 协议编辑锁定已落库样本编码 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 采集协议 / 科研捐赠编辑时,已落库样本编码只读;后端拒绝改码;新增样本仍可选码。
**Architecture:** 共享校验函数比对 payload `id` 与库中 `sample_code`/`sample_code_id`;Web `SampleTransportFormSection` 与小程序 `ProtocolSampleTransportPanel` 按是否有 `id` 锁控件。
**Tech Stack:** FastAPI/SQLAlchemy、Vue 3、mobile-oa-h5、pytest
**Spec:** `docs/superpowers/specs/2026-10-26-protocol-sample-code-lock-design.md`
---
### Task 1: Backend 校验 + 测试
**Files:**
- Modify: `backend/app/crud/collection_protocol.py`
- Modify: `backend/app/crud/research_donation.py`
- Create: `backend/tests/test_protocol_sample_code_lock.py`
- [x] 写失败用例 → 实现 `validate_persisted_sample_codes_immutable` → 接入两处 save → 测试通过
### Task 2: Web UI 锁定
**Files:**
- Modify: `web-admin/src/components/business/sample-transport-form-section/index.vue`
- [x] 编辑且有 `id` 时编码只读 + 提示
### Task 3: 小程序 UI 锁定
**Files:**
- Modify: `mobile-oa-h5/src/market/components/ProtocolSampleTransportPanel.vue`
- [x] 编辑且有 `id` 时编码只读 + 提示
@@ -0,0 +1,147 @@
# 基础实验交付日前一天 · 服务号微信提醒设计
> 日期:2026-10-22
> 工程:`backend`(定时任务 + 服务号模板消息)
> 相关:`docs/superpowers/specs/2026-08-13-oa-wechat-service-notify-design.md`
> 范围:仅 **基础实验申请单**(`biz_type=basic_experiment`)交付计划
---
## 1. 背景与目标
### 1.1 现状
- 基础实验申请单创建时,每行细胞产品独立生成一条交付计划;交付时间存于 `biz_pilot_infusion_schedule.infusion_time`(前端字段 `pickupTime`,界面文案「交付时间」)。
- 服务号模板消息发送链路已存在(`wechat_mp_message._send_template`、`wx_mp_openid` 绑定),目前仅 OA 事件驱动使用。
- APScheduler 已启动,但无业务 Job。
### 1.2 目标
在交付时间**前一天固定 10:00**,向**创建该基础实验申请单的人**发送微信服务号模板消息,提醒次日交付/出库。
### 1.3 非目标
- 中试服务 / 临床应用申请单。
- 向客户、渠道等非系统用户推送。
- 点击消息跳转小程序详情(首期纯模板通知即可;可选带 `miniprogram`,失败则降级,与 OA 一致)。
- 按「交付时间 − 24 小时」精确推送。
---
## 2. 已确认决策
| 决策点 | 结论 |
|--------|------|
| 触发方式 | 每日 **10:00**(服务器本地时区)定时扫描 |
| 扫描条件 | `biz_type=basic_experiment`;交付日 = **明天**;计划未删除;计划状态非已取消(`schedule_status != yqx`) |
| 接收人 | 申请单 `create_by` → `sys_user.wx_mp_openid`;未绑定则 skip + 日志 |
| 模板 ID | `oQNU3t0Q5kwc4KPJ8Z6yPA-k6qlsH9pikSCIb4eAwgM`(配置可覆盖) |
| 出库时间 | 细胞产品行的**交付时间**(`infusion_time`) |
| 产品名称 | `projectName` **拼接** 规格 `specText`、产品包装 `packageText`,格式:`名称(规格、包装)`;缺段时省略空括号内容 |
| 件数 | 产品 `quantity` |
| 客户名称 / 收货联系人 | 申请单 `customer_name` / `customer_contact` |
| 幂等 | 按「交付计划 ID + 提醒日(交付日前一天的日期)」记发送成功记录,防多实例/重跑重复推 |
| 开关 | 沿用 `WX_MP_NOTIFY_ENABLED`;另需本模板 ID 配置非空才发送 |
---
## 3. 模板字段映射
模板 ID:`oQNU3t0Q5kwc4KPJ8Z6yPA-k6qlsH9pikSCIb4eAwgM`
| 模板字段 | 业务含义 | 数据来源 |
|----------|----------|----------|
| `thing6` | 客户名称 | `biz_pilot_application.customer_name` |
| `thing10` | 产品名称 | `project_name(spec_text、package_text)`,见 §2;`thing` 约 20 字截断 |
| `character_string8` | 产品件数 | `biz_pilot_infusion_schedule_product.quantity`(字符串) |
| `thing7` | 收货联系人 | `biz_pilot_application.customer_contact` |
| `time14` | 出库时间 | `biz_pilot_infusion_schedule.infusion_time`,格式 `YYYY-MM-DD HH:MM` |
产品名称拼接规则(空段跳过):
- 三者皆有:`{projectName}({specText}、{packageText})`
- 仅名称+规格:`{projectName}({specText})`
- 仅名称+包装:`{projectName}({packageText})`
- 仅名称:`{projectName}`
基础实验一产品一行计划,取该计划下唯一(或首条)产品明细。
---
## 4. 架构与数据流
```
APScheduler Cron 每天 10:00
→ job: basic_experiment_delivery_remind
→ 查询:明天有 infusion_time 的基础实验交付计划(未取消)
→ 对每条计划:
查申请单 create_by → wx_mp_openid
查幂等记录,已成功则 skip
组装模板 data → _send_template
成功则写幂等记录
```
### 4.1 新增配置(`Settings` / env)
| 配置项 | 说明 | 默认 |
|--------|------|------|
| `WX_MP_TEMPLATE_BASIC_EXPERIMENT_DELIVERY` | 模板 ID | 空;部署填入给定 ID |
| `WX_MP_TPL_BE_DELIVERY_FIELD_CUSTOMER` | 客户名称字段 | `thing6` |
| `WX_MP_TPL_BE_DELIVERY_FIELD_PRODUCT` | 产品名称字段 | `thing10` |
| `WX_MP_TPL_BE_DELIVERY_FIELD_QTY` | 件数字段 | `character_string8` |
| `WX_MP_TPL_BE_DELIVERY_FIELD_CONTACT` | 联系人字段 | `thing7` |
| `WX_MP_TPL_BE_DELIVERY_FIELD_TIME` | 时间字段 | `time14` |
发送前提与 OA 一致:`WX_MP_NOTIFY_ENABLED=true`、服务号 appid/secret、接收人已绑 openid、已关注服务号。
### 4.2 幂等表
表名建议:`biz_wx_notify_log`(若首期未建 OA 日志表,本需求一并落地;若已有则复用)。
最小字段:
- `id`、`tenant_no`
- `biz_type`:如 `basic_experiment_delivery_remind`
- `biz_id`:交付计划 `schedule_id`
- `notify_date`:提醒日 `YYYY-MM-DD`(交付日前一天)
- `user_id`、`status`(success/fail)、`errcode`、`errmsg`
- 公共字段:`create_by`、`create_time`、`del_flag` 等(符合 database-conventions)
唯一约束:`(tenant_no, biz_type, biz_id, notify_date)` 或等价业务唯一键。
### 4.3 代码落点
| 模块 | 职责 |
|------|------|
| `app/services/wechat_mp_message.py` | 新增 `send_basic_experiment_delivery_remind(...)` |
| `app/services/basic_experiment_delivery_remind.py` | 扫描、组装、幂等、调用发送 |
| `app/tasks/` | 注册 Cron `hour=10, minute=0` |
| `docs/sql/migrations/` | 幂等表 DDL |
| `backend/tests/` | 拼接规则、扫描日界、幂等、跳过未绑定 |
---
## 5. 错误处理
- 发送失败:记日志 + 幂等表 fail(可选);次日不再针对同一提醒日重试(提醒日已过);同日 Job 重跑可再试未 success 的记录。
- 无 openid / 无交付时间 / 已取消:skip,不写 success。
- 推送失败**不**影响申请单业务读写。
---
## 6. 测试要点
- 产品名称拼接与截断。
- 仅 `basic_experiment`;交付日 = 明天才命中。
- 已取消计划不发。
- 同一 schedule + notify_date 第二次不发。
- 无 `wx_mp_openid` 不发。
---
## 7. 部署注意
1. 执行幂等表迁移 SQL。
2. 配置 `WX_MP_TEMPLATE_BASIC_EXPERIMENT_DELIVERY` 与 `WX_MP_NOTIFY_ENABLED=true`。
3. 确认创建人已走服务号绑定(与 OA 同一套)。
4. 多实例部署时依赖幂等表防重;若生产多 worker,仅一实例跑 scheduler 或接受幂等冲突吞掉重复。
@@ -0,0 +1,23 @@
# 造血干内置工艺路线缺步骤修复 — 设计
> 日期:2026-10-22
> 状态:已确认(用户同意排查结论后的修复方案)
> 背景:生产备份显示 `B*` 样本自动派发会建出「样本处理 0/0」空任务
## 根因
- 自动派发逻辑正常:接收成功 → 建工单 → 按入库编码匹配内置任务组合 → `create_tasks_from_set`。
- `CC样本处理-BUILTIN`(造血干样本处理内置模版)路线头存在,但 `biz_process_route_step` 为 **0**。
- `_clone_route_to_task` 按路线步骤克隆 → 任务壳有、步骤无 → UI 显示 `0/0`。
- 推测:内置路线头曾先于深拷贝脚本创建;脚本幂等「已存在 `-BUILTIN` 则跳过」,导致步骤未拷入。
## 方案
1. **数据(主修复)**:幂等 SQL——对所有「内置、无有效步骤、源路线有步骤」的 `*-BUILTIN` 路线,从源路线深拷贝步骤及产出/数据采集等子表。
2. **代码防护**:`create_tasks_from_set` 在创建任务前校验条目关联路线至少有 1 个未删除步骤;否则抛错。自动派发已吞异常并打日志,避免再建空任务。
3. **存量任务**:已手工补步或作废的历史单不强制回填;新接收在 SQL 执行后即可正常。
## 非目标
- 不改入库编码前缀匹配规则。
- 不自动把已存在的 0 步任务改绑到非内置路线。
@@ -0,0 +1,64 @@
# 细胞产品基础信息维护 · 三 Tab 列表模式设计
> 日期:2026-10-22
> 路由:`/#/market/market-info/cell-product-type`
> 源码:`web-admin/src/views/pilot-service/cell-product-type/`
## 1. 背景与目标
当前页为三列看板(P04/kanban):顶部统计卡 + 价格 / 类型 / 规格三列卡片流。目标改为 **三个 Tab + 各 Tab 标准列表**,对齐 `production/process`、`pilot-service/channel` 的 `panel-pill-tabs` 写法。
## 2. 已确认决策
| 项 | 决策 |
|----|------|
| 顶部统计卡 | 去掉 |
| 项目价格 | 本次不纳入本页;`ProjectPriceSystemTab` 不动 |
| 默认 Tab | `price`(细胞产品价格) |
| URL | 读写 `?tab=`:`price` \| `type` \| `spec`;非法值(含 `project-price`)回落 `price` |
| 看板代码 | 本页去掉;价格/规格子组件删除 kanban 分支 |
| `cell-product-kanban.scss` | **保留文件**(`lab-test-item`、`process-category` 仍引用) |
## 3. 页面结构
```
page-container
└ panel
└ el-tabs.panel-pill-tabs.panel-pill-tabs--lg
├ 细胞产品价格 (name=price) → CellProductPriceTab
├ 细胞产品类型 (name=type) → CellProductTypeTab(新建)
└ 细胞产品规格 (name=spec) → CellProductSpecTab
```
壳页职责:Tab 切换、`route.query.tab` 同步。类型 CRUD 迁出到 `CellProductTypeTab.vue`。
## 4. 类型 Tab(新建)
对齐 `CellProductSpecTab` 列表模式:
- 筛选:关键词(类型编码/名称)
- 工具栏:已选 N 项 → 新增类型 → 批量删除
- 列:勾选、序号、类型编码、类型名称、备注、创建时间、操作(查看 + 更多:编辑/删除)
- 弹窗:类型编码*、类型名称*、备注;`SystemViewDialog` 查看
- API:现有 `fetchCellProductType*`
- 类型变更后:`expose loadData`;壳页可选通知价格 Tab 刷新(若已挂载)
## 5. 价格 / 规格 Tab
字段、弹窗、API 不变;删除:
- `layout` prop、`meta-change` emit
- kanban 模板与相关 scoped 样式、对本目录 kanban scss 的 import
- `KANBAN_PAGE_SIZE` 与 onMounted 中的 kanban 分支
## 6. 非目标
- 不改后端 / 菜单 / 旧重定向页文件
- 不把项目价格并入本页
- 不删除 `cell-product-kanban.scss`
## 7. 验收
1. 三 Tab 切换正常,默认价格;`?tab=type|spec` 可直达
2. 每 Tab:筛选 / 新增 / 查看 / 编辑 / 删除 / 分页可用
3. 无统计卡、无看板卡片列
@@ -0,0 +1,25 @@
# 细胞产品基础信息 · 产品包装设计
> 日期:2026-10-22
> 菜单位置:市场基础信息 → 细胞产品基础信息维护
## 需求理解
在现有「价格 / 类型 / 规格」三 Tab 下追加 **产品包装** 独立主数据模块,支持增删改查。当前已知包装:冻存管、离心管、一次性塑料血袋(作初始数据,后续可继续追加)。
## 方案
对齐 `biz_cell_product_spec`:
| 项 | 约定 |
|----|------|
| 表 | `biz_cell_product_package` |
| 业务字段 | `package_code`、`package_name`、公共字段 |
| API | `/web/admin/cell-product-packages` CRUD |
| UI | 第 4 Tab「产品包装」;标准列表;`?tab=package` |
| 初始数据 | BZ01 冻存管、BZ02 离心管、BZ03 一次性塑料血袋 |
## 非目标
- 暂不把包装挂到细胞产品库 / 价格 / 生产产出行(仅主数据维护)
- 不改菜单树(仍挂在现有「细胞产品基础信息维护」页)
@@ -0,0 +1,24 @@
# 选择细胞产品:按储物格位置搜索
**日期:** 2026-10-22
**状态:** 已批准(方案 B)
## 背景
生产工单「任务执行」→「原材料」→「添加细胞产品」弹窗「选择细胞产品」中,搜索框仅支持产品编码/名称。表格已展示「储物格位置」(如 `2-3-7-15`),需支持同一搜索框按该字段检索。
## 行为
- 同一关键词输入框;placeholder 改为「搜索产品编码、名称或储物格位置」。
- 匹配规则:产品编码、产品名称、储物格完整路径(`storageSlotName` / `fullSlotCode`)任一包含关键词(不区分大小写)即命中。
- 远程列表与本地二次过滤均需支持,避免仅改前端导致 remote 重拉后漏结果。
## 范围
- 改:弹窗本地过滤 + placeholder;细胞产品列表 API 的 `keyword`。
- 不改:独立筛选项;细胞产品主列表页 UI(API 增强对主列表 keyword 一并生效,可接受)。
## 实现要点
1. 前端 `TaskInputEnhancedTable.vue`:`filteredCellProducts` 增加 `storageSlotName`。
2. 后端 `list_cell_products`:`keyword` OR 匹配关联储物格 ID(复用储物格路径关键词匹配)。
@@ -0,0 +1,18 @@
# 交付计划 · 产品包装透传设计
> 日期:2026-10-22
## 目标
基础实验申请单「交付计划」在指定细胞产品(含规格)的同时指定**产品包装**;创建计划后自动建出的出库生产/质检工单能看到包装(与规格同路径)。
## 方案
| 层 | 改动 |
|----|------|
| 表 | `biz_pilot_infusion_schedule` / `_product` 增加 `package_id`、`package_text` |
| 写入 | `create_schedule` / `_create_schedule_products` / upsert;基础实验 `create_basic_experiment_sale_schedules` 透传 |
| 读出 | 生产/质检 `_enrich_outbound_*`、详情 products、计划 dict |
| UI | 申请单售卖产品行选包装(必填);生产/质检卡片与查看表展示「产品包装」 |
包装主数据来自既有 `biz_cell_product_package`。
@@ -0,0 +1,90 @@
# 侧栏菜单角标 1 分钟轮询 Design
| 项 | 内容 |
|----|------|
| 日期 | 2026-10-22 |
| 状态 | 已定稿(用户确认:60s 轮询) |
| 范围 | web-admin 侧栏红色数字角标定时刷新 |
## 背景
侧栏部分菜单(如「待办中心」、草稿箱、抄送、质检/生产相关菜单)通过红色数字角标展示待处理数量。当前仅在登录后菜单初始化,以及部分业务页操作成功后手动调用 `refresh*MenuBadges()`,无持续更新,用户感知为「数字渲染一次就不变」。
产品确认采用 **方案 1:准实时轮询**,间隔 **60 秒**;不采用 WebSocket/SSE 真推送。
## 目标
- 登录且菜单就绪后,每 **60 秒** 静默刷新侧栏可见菜单的角标数字。
- 仅更新 Pinia 角标 store 中的数字;**不得**触发整页 reload、当前列表重拉或路由重进。
- 页面不可见时暂停轮询;恢复可见时立即补刷一次并重启定时器。
- 退出登录时停止轮询并清空角标(沿用现有 `clearBadges`)。
- 业务操作成功后的即时 `refresh*MenuBadges()` **保留**,不必等下一分钟。
## 非目标
- 不新建「全菜单角标汇总」后端接口。
- 不改 count 接口语义与统计口径。
- 不做 WebSocket / SSE。
- 不改造小程序 / mobile-h5。
- 不改变角标 UI 样式(`99+`、0 隐藏等既有规则不变)。
## 统计方式(复用现状)
**不是**一次接口统计全部菜单。轮询时并行调用现有三组刷新函数:
| 业务 | 函数 | 行为 |
|------|------|------|
| OA | `refreshOaMenuBadges()` | 按侧栏可见菜单,最多并行:抄送未读、草稿数、待办数 |
| 质检 | `refreshQcMenuBadges()` | 按可见菜单,最多:质检工单、我的质检任务 |
| 生产 | `refreshProductionMenuBadges()` | 按可见菜单,最多:生产工单、我的生产任务 |
仅当对应菜单出现在当前用户侧栏菜单树时才请求;无权限/未挂载则跳过。单用户每分钟请求数约 0~7(视可见角标菜单而定)。
## 设计
### 入口与生命周期
新增前端工具(建议路径:`web-admin/src/utils/menu-badge-polling.ts`):
- `startMenuBadgePolling()`:若未在跑,则立即执行一轮 `refreshAllMenuBadges()`,再 `setInterval(60_000)`。
- `stopMenuBadgePolling()`:清除定时器;移除 `visibilitychange` 监听。
- `refreshAllMenuBadges()`:`Promise.all` 调用上述三个 `refresh*`(互不影响失败)。
启动时机:
- 与现有菜单初始化后首次角标刷新对齐:在 `beforeEach` 中菜单注册并 `setMenuList` 之后(现有三处 `void refresh*MenuBadges()` 附近),改为:先立即刷新(或由 `start` 内立即刷新),再 `startMenuBadgePolling()`。
- 须保证**幂等**:重复进入守卫不叠加多个 interval。
停止时机:
- `userStore.clearSession`(退出登录)时调用 `stopMenuBadgePolling()`,再 `clearBadges`(顺序:先停轮询,再清 store)。
### 页面可见性
- 监听 `document.visibilitychange`。
- `document.hidden === true`:暂停 interval(clear),不发请求。
- 恢复可见:立即 `refreshAllMenuBadges()`,再重启 60s interval。
### 并发与错误
- 上一轮未完成时跳过本轮或串行互斥(推荐:简单 `inFlight` 锁,进行中则跳过,避免堆积)。
- 单接口失败:沿用现有各 `refresh*` 内 `.catch` 置 0 / 静默,**不弹**全局错误提示。
- 未登录 / 无菜单列表:`refresh*` 内部已按可见 codes 早退;轮询仍可跑但无请求。
### 压力估算(参考)
- 间隔 60s;50 在线 × 最多 7 请求 ≈ 350 次/分钟量级,count 接口通常可接受。
- 隐藏页签暂停可进一步降低无效请求。
## 验收
1. 登录进入系统后,侧栏角标有初始数字;约 1 分钟后数字可随后端数据变化更新(可用另一账号制造待办验证)。
2. 切到其他浏览器页签超过 1 分钟再切回:应立即刷新一次,而非干等完整周期。
3. 在待办页审批成功:角标仍立即更新(既有即时刷新不丢)。
4. 轮询过程中当前业务列表、表单状态不被重置;无整页闪烁。
5. 退出登录后再登录:只有一个轮询定时器在跑,无重复请求风暴。
## 实现备注
- 改动集中在 web-admin;后端无 schema / API 变更。
- 实现后按仓库约定更新前端 graphify(若触及模块依赖)。
@@ -0,0 +1,90 @@
# 科研捐赠质检 · 协议状态筛选(默认排除废弃)
> 日期:2026-10-22
> 状态:已批准
> 范围:【质检工单】【我的质检任务】→「科研捐赠质检」Tab;Tab 角标与菜单徽章
> 方案:后端 `protocolStatus` 多选 + 前端默认勾选非废弃态
---
## 1. 目标与范围
### 1.1 目标
科研捐赠质检列表默认不展示捐赠协议处于废弃态(`yzf` 已作废、`sdfq` 属地废弃)的样本/工单;用户可在筛选中勾选废弃态查看。角标/徽章与列表默认口径一致。
### 1.2 范围
- 【质检工单】→ `inbound_research_donation` Tab
- 【我的质检任务】→ 同一 Tab
- Tab 未完成角标、菜单徽章中科研捐赠部分
### 1.3 非目标
- 其他质检 Tab(细胞存储入库、出库、临时、「全部」等)
- 样本状态过滤
- 生产工单现有 `excludeVoidProtocol` 逻辑
---
## 2. 产品决策
| 项 | 决策 |
|----|------|
| 筛选形态 | 「协议状态」多选,放在「工单状态」之后 |
| 默认勾选 | `dsx` 待生效、`sxz` 生效中 |
| 其它态 | `ygq`/`zckc`/`yzf`/`sdfq` 默认不勾,可手动勾选 |
| 清空多选 | 无匹配,列表为空(不得视为「全部」) |
| 重置 | 恢复默认「待生效 + 生效中」 |
| 角标 | 与默认列表一致,排除废弃 |
---
## 3. 筛选交互与接口
### 3.1 前端
仅 `tabKey === 'inbound_research_donation'` 展示「协议状态」控件(manage / mine 两套筛选栏)。
选项来自 `donationStatus` 字典;默认值为 `dsx`、`sxz`。
### 3.2 后端列表
`GET /web/admin/qc-work-orders` 增加可选 Query:`protocolStatus`(逗号分隔)。
关联字段:科研捐赠工单 `collection_protocol_id` = 捐赠单 id;过滤 `BizResearchDonation.donation_status`。
语义:
| `protocolStatus` | `receptionSource` | 行为 |
|------------------|-------------------|------|
| 有值(含空串) | `research_donation` | 按解析出的状态 IN 过滤;空列表 → 无结果 |
| 未传(`None`) | `research_donation` | 默认仅 `dsx`/`sxz`(与筛选项默认一致) |
| 任意 | 非科研捐赠 | 忽略该参数 |
### 3.3 我的质检任务
延续现有「任务拉全量 → 工单维度二次过滤」:在 `filterMineEntriesByWorkOrderSearch` 增加 `protocolStatus`;默认与重置同管理端。条目已有 enrich 的 `protocolStatus`。
### 3.4 角标 / 徽章
`count_unfinished_work_orders_by_tab` / `count_mine_unfinished_work_orders_by_tab`:对 `reception_source=research_donation` 的工单默认仅计捐赠状态 ∈ `dsx`/`sxz`。
---
## 4. 数据流与边界
- 无捐赠单 / `donation_status` 为空:显式 IN 过滤时不命中 → 不展示。
- 工单状态与协议状态 AND 生效。
- 卡片协议状态展示逻辑不变。
---
## 5. 验收
1. 打开科研捐赠质检:协议状态默认仅勾「待生效」「生效中」;已过期/转细胞存储/已作废/属地废弃默认不展示。
2. 勾上废弃态后可搜到对应数据。
3. 重置恢复默认。
4. 我的质检任务 · 科研捐赠 Tab 行为一致。
5. 该 Tab 角标与菜单徽章不含废弃口径。
6. 其他 Tab 无回归。
@@ -0,0 +1,137 @@
# 样本编码全链路纠错 — 设计
> 日期:2026-10-22
> 状态:已确认(实现默认)
> 关联:采集协议单 / 科研捐赠;质检接收与工单;生产工单;储存证 / 保险 / 客服
---
## 1. 范围决策
| 项 | 决定 |
|----|------|
| 交付形态 | **产品化能力**:预览 + 事务级联更正 + 审计日志(非一次性手工 SQL) |
| 细胞产品码 | **不自动修改** `biz_cell_product.product_code` / 出库快照;预览可提示「同名产品码条数」供人工评估 |
| 实验室入库码 | **不修改** `lab_storage_code` |
| 来源 | 支持 `cell_storage` 与 `research_donation` |
---
## 2. 目标与非目标
### 2.1 目标
- 将错误样本编码 `oldCode` 更正为 `newCode`,在同一租户、同一来源下级联更新所有以 `sample_code` 为匹配键或快照的业务表。
- 更正前可预览各表影响行数与阻断原因。
- 写入审计日志(操作人、时间、旧→新、影响明细、原因)。
- 入口挂在「样本信息管理 / 客户服务」列表操作列。
### 2.2 非目标
- 不批量改多条样本编码。
- 不改短信历史正文、附件内容。
- 不自动改细胞产品码、出库产品快照。
- 不通过「编辑协议单换码再保存」实现纠错(该路径不回写下游快照)。
---
## 3. 关联键与校验
- 权威键:`tenant_no` + `sample_code`(OpenSpec api-conventions)。
- 来源:`reception_source` ∈ {`cell_storage`, `research_donation`};无来源列的表仅在对应来源下更新。
- 旧码必须存在于对应 SoT 样本表(`biz_protocol_sample` 或 `biz_research_donation_sample`,`del_flag=0`)。
- 新码不得已被其它活跃样本占用(协议 + 捐赠共用命名空间);允许等于旧码时直接拒绝。
- UNIQUE 表(储存证 / 保险 / 客服 / 储存证 QC)若已存在 `newCode` 行且不是本样本迁移目标,则阻断。
### 编码池(细胞存储)
1. 若 `newCode` 已在 `biz_sample_code`:将样本的 `sample_code_id` 指向该池行,并标记 `issued=1`;若旧池行不再被其它活跃样本引用,可释放 `issued=0`。
2. 否则若样本当前绑定池行:将该池行的 `sample_code` 字符串就地改为 `newCode`。
3. 否则仅更新样本行文本码(捐赠场景常见)。
---
## 4. 级联表清单
### 4.1 SoT
- `biz_protocol_sample`(cell_storage)
- `biz_research_donation_sample`(research_donation)
- `biz_sample_code`(按上节策略)
### 4.2 市场附属(主要为 cell_storage)
- `biz_protocol_sample_payment`
- `biz_protocol_payment_schedule`
- `biz_protocol_payment_transfer`
- `biz_protocol_sample_transport`
- `biz_research_donation_sample_transport`(research_donation)
- `biz_sample_freight_item`
### 4.3 质检 / 生产(按 `reception_source` 过滤,无该列则仅按租户+码)
- `biz_sample_reception`
- `biz_qc_work_order`
- `biz_qc_task`
- `biz_storage_release_review`
- `biz_sample_storage_cert_qc`(UNIQUE;细胞存储)
- `biz_sample_production_reception`
- `biz_production_work_order`
- `biz_production_task_input`(`input_type=sample` 且 `input_code=oldCode`)
### 4.4 扩展 UNIQUE(细胞存储)
- `biz_sample_storage_cert`
- `biz_sample_insurance`
- `biz_sample_customer_service`
### 4.5 明确不改
- `lab_storage_code`、`biz_cell_product.product_code`、`biz_outbound_release_cell`、附件与短信正文。
---
## 5. API
前缀:`/web/admin/sample-code-corrections`
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/preview` | 校验 + 返回各表影响行数、阻断原因、可选同名产品码提示 |
| POST | `/apply` | 事务内级联更新 + 写审计日志 |
请求体:
```json
{
"receptionSource": "cell_storage",
"oldSampleCode": "OLD",
"newSampleCode": "NEW",
"newSampleCodeId": null,
"reason": "客户填错编码"
}
```
权限:运营端登录 + 严格菜单码(细胞存储或科研捐赠样本信息 list 任一即可预览/执行;前端按钮随当前 Tab 展示)。
---
## 6. 审计
表 `biz_sample_code_correction_log`:记录租户、来源、旧码、新码、影响 JSON、原因、操作人、公共字段。
---
## 7. UI
样本信息页操作列增加「更正编码」→ 弹窗录入新码与原因 → 先预览 → 确认后 apply → 刷新列表。
---
## 8. 事务顺序
1. 锁/读取 SoT 旧码行,校验新码空闲与 UNIQUE 冲突
2. 更新编码池策略
3. 更新 UNIQUE 扩展表
4. 更新 SoT 与全部快照表
5. 写审计日志并 commit
@@ -0,0 +1,80 @@
# 储存证质检信息 — 三端可编辑(方案 A)
> 日期:2026-10-22
> 状态:已确认
> 关联:`docs/superpowers/specs/2026-10-09-storage-cert-qc-info-design.md`
> 问题2:科研捐赠不展示「填写储存证质检信息」(已落地)
---
## 1. 背景
原设计为质检填写、市场只读查看;生产无入口。客户要求市场、质检、生产三部门共同填写同一张储存证质检信息表。
产品决策:**方案 A** — 三端均可打开完整表编辑保存;后写覆盖;市场由「查看」改为可填。
---
## 2. 目标与非目标
### 2.1 目标
- 质检:保持「细胞存储质检」卡片可填(科研捐赠不展示)。
- 生产:生产工单 / 我的生产任务「细胞储存」卡片增加「填写储存证质检信息」;弹窗与质检相同。
- 市场:样本信息管理(细胞存储)行操作改为可编辑填写(同弹窗)。
- 后端读写权限覆盖三端菜单;共用表 `biz_sample_storage_cert_qc`,不改 schema。
- 未填空态文案改为中性「尚未填写」。
### 2.2 非目标
- 不做字段级部门权限、不做乐观锁/冲突提示。
- 不自动回填检测结果;不扩展 Excel 模板类型。
- 科研捐赠及非两种样本类型仍无填写/查看入口。
---
## 3. 已确认决策
| 决策点 | 结论 |
|--------|------|
| 协作模式 | 同一完整表;后写覆盖 |
| 市场 | 由只读改为可编辑 |
| 生产入口 | 卡片操作区;复用 `StorageCertQcDialog` |
| 显示范围 | 仅细胞储存 + 围产期造血干细胞 / 脐带间充质干细胞 |
| 科研捐赠 | 不展示按钮(问题2) |
| 数据模型 | 不改表;继续整包 payload upsert |
---
## 4. API 权限
路径不变:`GET/PUT /web/admin/sample-storage-cert-qc/{sample_code}`。
**READ_MENUS / WRITE_MENUS**(读写一致):
- `biz:qcWorkOrder:list`
- `biz:myQcTask:list`
- `production:work-order:list`
- `production:my-task:list`
- `cell-storage:sample-info:list`
---
## 5. 前端入口
| 端 | 落点 | 按钮文案 | mode |
|----|------|----------|------|
| 质检 | `QcWorkOrderSingleCard` | 填写储存证质检信息 | edit |
| 生产 | `ProductionWorkOrderCardList` | 填写储存证质检信息 | edit |
| 市场 | `UnifiedSampleInfoPage` | 填写储存证质检信息 | edit |
生产显示条件:`supportsStorageCertQc(sampleTypeName)` 且有效 tab 为 `inbound_cell_storage`(「所有」tab 按行解析)。
---
## 6. 测试要点
- 任一端保存后,另两端打开可见最新 payload。
- 生产/市场菜单用户可 PUT;无菜单 403。
- 科研捐赠卡片无按钮;非支持样本类型无按钮。
- 未填时空态为「尚未填写」。
@@ -0,0 +1,97 @@
# 临时质检:同生产工单成组 + 创建时间倒序 — 设计
> 日期:2026-10-22
> 状态:已确认
> 关联:【质检工单】/【我的质检任务】→「临时质检」Tab
---
## 1. 背景
当前「临时质检」列表统一按质检工单(或任务)`create_time DESC` 排序。同一生产工单多次派发的临时质检会分散在列表各处,不便对照。
客户要求:**排序基准仍是创建时间倒序**;若某条质检工单由生产工单 A 派发,则把 A 派发的相关质检工单**聚在一起展示**。
---
## 2. 范围
| 项 | 决定 |
|----|------|
| 页面 | 【质检工单】临时质检 + 【我的质检任务】临时质检(两处一致) |
| 其它 Tab | 不改(入库 / 出库 / 全部) |
| UI 形态 | **仅排序成组**,不做生产工单可视分组头(非方案 C) |
| 手动创建 | 无 `production_work_order_id`:各自独立,按自身创建时间参与排序(与生产派发混排) |
### 非目标
- 不按生产工单号字典序作为主排序。
- 不强制把手动创建沉到底。
- 不把**未命中当前筛选条件**的同生产工单质检单强行塞进列表(避免破坏状态/关键字筛选语义与分页总数)。
---
## 3. 排序规则(权威)
以**质检工单**为列表行(我的任务侧先按工单聚合后再排):
1. **成组键**
- `production_work_order_id` 非空 → 该生产工单 ID
- 否则 → 本工单 `id`(单元素组)
2. **组位置(基准仍是创建时间)**
- 组排序时间 = 当前**筛选结果集内**、同成组键各行的 `create_time` 的 **MAX**
- 组按该时间 **DESC**(越新的组越靠前)
3. **组内**
- 按质检工单 `create_time` **DESC**
- 稳定次序:同时间再按 `id` DESC(或 `work_order_no` DESC,实现时与现有习惯对齐)
### 示例
| 质检单 | 生产工单 | create_time |
|--------|----------|-------------|
| Q1 | (手动) | 10 |
| Q2 | A | 9 |
| Q3 | A | 5 |
| Q4 | B | 8 |
展示顺序:`Q1` → `Q2, Q3` → `Q4`
(组 A 的位置由组内最新 Q2=9 决定;组内再倒序。)
---
## 4. 实现要点
### 4.1 【质检工单】后端
- 入口:`list_qc_work_orders`(或等价列表 CRUD)在判定为**临时质检查询**时启用成组排序。
- MySQL 5.7 **无窗口函数**:对当前 `_filtered()` 结果做按 `production_work_order_id` 聚合 `MAX(create_time)`,再 `OUTER JOIN` 回主查询。
- `ORDER BY`:`COALESCE(group_max_time, create_time) DESC` → 成组键 → `create_time DESC`。
- 非临时列表仍走现有逻辑(入库实验室编码排序 / 默认 `create_time DESC`)。
### 4.2 【我的质检任务】前端
- 仍:`fetchAllMineTasks` → `groupMineTasksByWorkOrder` → 筛选 → 分页。
- 临时 Tab:在分页前增加与后端规则一致的 `sortMineEntriesForTemporary`(按工单上的 `productionWorkOrderId` + `createTime`)。
- 入库 Tab 的 `sortMineEntriesForInboundLabStorage` 不变。
### 4.3 测试
- 后端:给定多条临时工单(同 PWO / 不同 PWO / 手动),断言列表顺序。
- 前端:纯函数单测或轻量断言成组比较逻辑(若项目已有同类 util 测试则跟随;否则以后端为主)。
---
## 5. 验收
- [ ] 质检工单 → 临时质检:同生产工单派发的卡片相邻;组序符合「组内最新创建时间」倒序;组内创建时间倒序。
- [ ] 我的质检任务 → 临时质检:同上。
- [ ] 筛选(状态/关键字/来源)仍只显示命中行;未命中的同组行不强插。
- [ ] 入库/出库 Tab 排序无回归。
---
## 6. 决策记录
- 2026-10-22:两页都改;方案 A(后端成组排序 + 我的任务前端对齐);手动混排;组位置 = 筛选集内 MAX(create_time)。
@@ -0,0 +1,41 @@
# OA「提到我的」未读角标设计
> 日期:2026-10-23
> 范围:`backend` + `web-admin` + `mobile-h5`
> 相关:抄送未读 `is_read` / `tasks/cc/unread-count`;菜单角标 `oa-menu-badge`
## 1. 目标
「提到我的」菜单展示红色数字角标(与待办/抄送一致):数字 = **当前用户未读的 @ 授权条数**;打开单据详情前标记已读,角标减少。
## 2. 决策
| 点 | 结论 |
|----|------|
| 未读载体 | `oa_instance_view_grant.is_read`(0 未读 / 1 已读) |
| 历史数据 | 迁移时已有行置 `is_read=1`,上线角标从 0 起 |
| 再 @ 同一人同一单 | 已有 grant 时将 `is_read` 重置为 0 |
| 已读时机 | 对齐抄送:从「提到我的」列表打开详情前调 mark-read |
| 角标展示 | Web 侧栏 + 小程序宫格;`>99` 显示 `99+` |
| 列表 UI | 未读行展示红点/未读态(对齐抄送轻量样式) |
## 3. 后端
- SQL:`ALTER` 增加 `is_read SMALLINT NOT NULL DEFAULT 0`;`UPDATE ... SET is_read=1` 对存量。
- ORM:`OaInstanceViewGrant.is_read`。
- `count_mention_unread(tenant, user)`:`del_flag=0` 且 `is_read=0` 的 grant 数(实例仍有效)。
- `mark_mention_read(instance_id)`:当前用户对该实例的 grant 置已读。
- API:`GET /mentions/unread-count`;`POST /mentions/{instance_id}/read`。
- 任务列表 `kind=mention` 行数据带 `isRead`。
- `_ensure_view_grants`:已存在则若未读保持;若已读则重置为未读并更新 `comment_id`/`update_*`。
## 4. 前端
- Web:`oa:mention` 接入 `oa-menu-badge` 轮询;提到我的列表打开前 mark-read + refresh badge。
- 小程序:`oa-badge.js` 增加 mentions path;列表打开前 mark-read;工作台刷新角标。
## 5. 非目标
- 未读筛选 Tab(可后续对齐抄送)。
- 批量已读按钮(可后续)。
- 独立微信模板(已复用抄送模板推送)。
@@ -0,0 +1,186 @@
# 协议新增样本 · 服务号微信通知设计
> 日期:2026-10-23
> 工程:`backend`(协议保存钩子 + 服务号模板消息);角色数据在 `sys_role` / `sys_user_role`
> 相关:`docs/superpowers/specs/2026-08-13-oa-wechat-service-notify-design.md`、`docs/superpowers/specs/2026-10-22-basic-experiment-delivery-remind-design.md`
> 范围:**细胞存储**采集协议单 + **科研捐赠**采集单;Web / 小程序保存入口共用后端
---
## 1. 背景与目标
### 1.1 现状
- Web「采集协议单」与小程序市场专员/地区经理「协议单」保存均走后端协议 create/update(含样本)。
- 服务号模板消息链路已存在:`wechat_mp_message._send_template`、用户 `wx_mp_openid` 绑定、总开关 `WX_MP_NOTIFY_ENABLED`。
- 幂等表 `biz_wx_notify_log` 已落地(基础实验交付提醒复用中)。
- 曾申请「细胞样本采集」类模板被拒;现已选用「工单」类类目模板,按字段长度约束组装文案。
### 1.2 目标
协议**新建或编辑**保存成功后,若存在**新增样本**(相对保存前的 `sample_code`),则向租户内角色 **「样本采集通知人员」** 下已绑定服务号的用户,按**每个新增样本一条**发送服务号模板消息。
### 1.3 非目标
- 服务号一次性订阅通知 / 小程序订阅消息作为主通道。
- 企业微信、短信、邮件。
- 对「仅修改已有样本字段、未新增 sample_code」重复推送。
- 强制未绑定用户完成关注绑定(沿用现有关注/绑定入口即可)。
- 首期可不依赖消息点击跳转;若配置小程序 path,失败则降级为纯通知(与 OA `40165` 策略一致)。
---
## 2. 已确认决策
| 决策点 | 结论 |
|--------|------|
| 推送通道 | 已认证服务号**类目模板消息**(`template/send`),可重复下发 |
| 业务范围 | **细胞存储** + **科研捐赠** |
| 触发时机 | 协议保存成功且 commit 之后;异步发送,失败不阻断保存 |
| 新增样本 | 保存前已有 `sample_code` 集合与本次提交对比;差集为新增;**不用样本行 id**(细胞存储 `save_samples` 会换新 id) |
| 消息粒度 | 一个新增 `sample_code` × 一个通知人 = 一条微信消息 |
| 接收人 | 角色名称精确为「样本采集通知人员」的启用用户;须 `wx_mp_openid` 非空 |
| 模板 ID | `iOnQ9k2mavAOwFbp_6yH4lD-RCNmM_OiwyTgrJfU-_A`(env 可覆盖) |
| 工单标题 | 有 ETA:`样本采集(预计到达 {M}月{D}日)`;无 ETA:`样本采集(到达待定)`;`thing` ≤20 字截断 |
| 发起人 | 协议创建人姓名(`create_by` → `nick_name`) |
| 发起时间 | 协议 `create_time`(编辑场景仍用创建时间,非本次保存时间) |
| 任务类型 | 细胞存储 → `细胞存储`;科研捐赠 → `科研捐赠`(`phrase`,纯汉字短词) |
| 预计到达 | 该样本运输明细 `eta_time`(仅月日写入标题) |
| 幂等 | 同一租户下,同一 `sample_code` 对同一用户**终身只成功推一次** |
| 开关 | `WX_MP_NOTIFY_ENABLED=true` 且本模板 ID 非空才发送 |
---
## 3. 模板字段映射
模板 ID:`iOnQ9k2mavAOwFbp_6yH4lD-RCNmM_OiwyTgrJfU-_A`
| 模板字段 | 业务含义 | 赋值规则 |
|----------|----------|----------|
| `thing2` | 工单标题 | 见 §2;总长超过 20 字符则截断 |
| `thing8` | 发起人 | 创建人姓名,`thing` 截断 |
| `time3` | 发起时间 | `create_time`,格式如 `2022年11月22日 16:17` |
| `phrase10` | 任务类型 | 仅 `细胞存储` 或 `科研捐赠` |
标题拼装伪代码:
```text
if eta_time:
title = f"样本采集(预计到达 {eta.month}月{eta.day}日)"
else:
title = "样本采集(到达待定)"
title = truncate_thing(title, 20)
```
---
## 4. 架构与数据流
```
Web / 小程序
→ API:细胞存储 create/update 或 科研捐赠 create/update(含样本)
→ CRUD 保存协议 + 样本,记录「保存前 sample_code 集合」
→ commit 成功
→ 异步:sample_collect_wx_notify
├─ new_codes = submitted_codes - before_codes
├─ new_codes 为空 → return
├─ 查角色「样本采集通知人员」→ 用户列表(tenant + del_flag=0 + 角色启用)
├─ 过滤 wx_mp_openid
└─ for code in new_codes:
for user in recipients:
幂等已成功 → skip
组装 data(标题用该样本 eta)→ _send_template
写 biz_wx_notify_log
```
### 4.1 新增判定
| 场景 | before_codes | 行为 |
|------|--------------|------|
| 新建协议 | 空集 | 本次所有非空 `sample_code` 均通知 |
| 编辑:追加样本 | 旧码集合 | 仅差集通知 |
| 编辑:只改金额/ETA 等 | 码不变 | 不通知 |
| 编辑:删除后再用**同一** code 加回 | 若保存前已不存在该 code,则算新增并可能再次通知;若幂等已成功过则仍 skip | 以幂等为准,避免对同一人同码刷屏 |
空 `sample_code` 的行不参与对比与发送。
### 4.2 接收人解析
1. 有效拥有角色名「样本采集通知人员」的用户(与登录权限一致):
- 直接:`sys_user_role` → `sys_role`
- **或经职位继承**:`sys_user_post` → 启用 `sys_post` → `sys_post_role` → `sys_role`
2. 复用 `list_user_ids_with_effective_role_name`;同 `tenant_no`,角色/职位启用且未删除。
3. `wx_mp_openid` 非空才进入发送队列;否则跳过。
运营侧常见做法:角色挂到职位,用户绑职位(不必直接绑角色)。可选 SQL 仅种子角色,不自动绑职位/用户。
### 4.3 幂等(复用 `biz_wx_notify_log`)
| 字段 | 取值 |
|------|------|
| `biz_type` | `sample_collect_notify` |
| `biz_id` | `{sample_code}:{user_id}` |
| `notify_date` | 哨兵 `1970-01-01`(表示「该样本对该人只推一次」,与按日提醒区分) |
| `user_id` | 接收用户 id |
| `status` | `success` / `fail` |
发送前查是否已存在同租户 + 上述键且 `status=success`;有则 skip。
唯一约束沿用表上 `(tenant_no, biz_type, biz_id, notify_date)`:因 `biz_id` 已含 user,冲突即表示已记过一条;失败记录允许重试覆盖或再插(实现时与基础实验提醒对齐:成功才挡重发)。
### 4.4 配置(`Settings` / env)
| 配置项 | 说明 | 默认 |
|--------|------|------|
| `WX_MP_TEMPLATE_SAMPLE_COLLECT` | 模板 ID | 部署填入给定 ID |
| `WX_MP_TPL_SC_FIELD_TITLE` | 工单标题 | `thing2` |
| `WX_MP_TPL_SC_FIELD_APPLICANT` | 发起人 | `thing8` |
| `WX_MP_TPL_SC_FIELD_TIME` | 发起时间 | `time3` |
| `WX_MP_TPL_SC_FIELD_TYPE` | 任务类型 | `phrase10` |
| `WX_MP_SAMPLE_COLLECT_ROLE_NAME` | 通知角色名 | `样本采集通知人员` |
### 4.5 代码落点
| 模块 | 职责 |
|------|------|
| `app/services/wechat_mp_message.py` | `send_sample_collect_notify(...)` |
| `app/services/sample_collect_wx_notify.py` | 差集、查角色、幂等、组文案、调用发送 |
| `app/api/collection_protocol.py`(及小程序共用 service/API) | commit 后调度异步通知 |
| `app/api` / crud 科研捐赠保存路径 | 同上 |
| `app/core/config.py`、`.env.example` | 新配置项 |
| `docs/sql/migrations/` | 可选:种子角色「样本采集通知人员」 |
| `backend/tests/` | 差集、文案、幂等、角色过滤、phrase/thing 截断 |
钩子须在**样本已落库且能读到 eta**之后触发;异步用与 OA 相同的线程/`SessionLocal` 模式,避免拖慢 HTTP。
### 4.6 点击跳转(首期)
- 默认:不传 `miniprogram`,或传协议详情 path(细胞存储 / 科研捐赠各一,带协议 id)。
- 若微信返回关联/页面错误:去掉 jump 重试一次(复用 `_send_template` 已有降级)。
---
## 5. 错误处理与可观测性
- 单条发送失败:记 `fail` 日志,继续下一条;不抛回协议 API。
- 总开关关闭 / 缺模板 ID / 无接收人:安静跳过(info 级日志)。
- 微信 `47003`(字段非法):说明文案超限或 phrase 含非法字符;单测锁死拼装规则。
---
## 6. 验收要点
1. 新建细胞存储协议含 2 个样本 → 每个通知人收到 2 条;标题/类型符合 §3。
2. 再编辑只改金额 → 不再推。
3. 编辑再追加 1 个新码 → 仅该码 1 条/人。
4. 科研捐赠路径行为与细胞存储一致,`phrase10=科研捐赠`。
5. 未绑服务号用户不收消息;协议保存仍成功。
6. 无 ETA 时标题为 `样本采集(到达待定)`。
7. 同一 sample_code 对同一人第二次保存不重复成功推送。
---
## 7. 合规与运营说明
- 接收人为系统内授权角色成员,须已关注并绑定服务号;避免对纯路人粉丝群发。
- 模板为工单类文案,发送频率随业务新增样本而定;若微信侧后续限流/投诉,再评估改为企业微信或订阅通知(长期类)。
- 运营需:配置模板 ID、打开 `WX_MP_NOTIFY_ENABLED`、创建角色并给人、确保相关人完成服务号绑定。
@@ -0,0 +1,51 @@
# 协议编辑锁定已落库样本编码 — 设计
> 日期:2026-10-26
> 状态:已确认(方案 1,实现默认)
> 关联:样本编码全链路纠错(`2026-10-22-sample-code-correction-design.md`)
---
## 1. 背景
客户服务 / 样本信息管理已提供「更正编码」,会级联更新下游快照。协议单(采集协议、科研捐赠)编辑里换码不会回写下游,易造成不一致。因此编辑已落库样本时禁止改编码。
## 2. 范围决策
| 项 | 决定 |
|----|------|
| 业务 | 采集协议 + 科研捐赠 |
| 端 | Web 管理端 + 小程序市场端(`mobile-oa-h5`) |
| 新增样本 | 仍可选 / 可自动生成编码 |
| 已落库判定 | 样本行有持久化 `id` |
| 本会话未保存新行 | 仍可改码 |
| 后端 | 更新时若 payload 带已存在 `id` 且编码变更 → 拒绝 |
| 真要改码 | 仅走「更正编码」 |
## 3. 非目标
- 不禁止删除已有样本后再新增另一条(删 + 增)
- 不在协议编辑内提供纠错入口
- 不改「更正编码」级联逻辑
## 4. UI
- **Web**:`SampleTransportFormSection` 编辑弹窗中,若 `sampleDraft.id` 非空,样本编码只读展示;新增仍用选择器 / 自动生成。
- **小程序**:`ProtocolSampleTransportPanel` 同等规则(科研捐赠本就自动生成只读,编辑已落库时保持只读并提示来源)。
- 可选提示:已落库编码请到客户服务使用「更正编码」。
## 5. 后端
在采集协议 `save_samples`、科研捐赠样本更新路径中,于写库前:
1. 加载本单现有未删样本,按 `id` 建索引。
2. 遍历 payload:若 `id` 命中现有行,则 `sample_code`、`sample_code_id`(trim 后)必须与库中一致。
3. 否则 `ValueError`,文案明确引导使用「更正编码」。
无 `id` 或 `id` 不在本单现有行中的条目视为新增,不套本校验。
## 6. 测试
- 已落库样本改 `sampleCode` / `sampleCodeId` → 拒绝。
- 已落库样本保持原码 → 通过。
- 无 `id` 新增样本 → 不受本规则影响。