This commit is contained in:
zlwu committed 2026-10-17 11:46:53 +08:00
1 parent 48dcf991dc
commit be2226e4ca
100 files changed
+61340 -40975

No files matched your search

File diff suppressed because it is too large. Load diff
@@ -0,0 +1,484 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>采集协议单 · 状态变更记录展示 Demo</title>
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<style>
:root {
--primary: #10b981;
--primary-dark: #059669;
--primary-bg: #ecfdf5;
--bg-page: #f8fafc;
--panel: #ffffff;
--text: #0f172a;
--text-secondary: #334155;
--text-muted: #64748b;
--border: #e2e8f0;
--radius: 10px;
--radius-sm: 8px;
--warning: #d97706;
--warning-bg: #fffbeb;
--danger: #dc2626;
--danger-bg: #fef2f2;
--info: #64748b;
--info-bg: #f1f5f9;
}
* { box-sizing: border-box; }
body {
margin: 0;
font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
font-size: 14px;
line-height: 1.5;
color: var(--text);
background: var(--bg-page);
}
.page { max-width: 1100px; margin: 0 auto; padding: 24px 20px 80px; }
.hero { margin-bottom: 18px; }
.hero h1 {
margin: 0 0 8px;
font-size: 22px;
font-weight: 700;
letter-spacing: -0.02em;
}
.hero h1::before {
content: "";
display: inline-block;
width: 4px;
height: 1.1em;
margin-right: 10px;
vertical-align: -0.15em;
border-radius: 2px;
background: var(--primary);
}
.hero p { margin: 0 0 8px; color: var(--text-muted); max-width: 920px; }
.context-bar { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
.pill {
display: inline-flex; align-items: center;
padding: 4px 10px; border-radius: 999px; font-size: 12px;
background: var(--primary-bg); color: var(--primary-dark); border: 1px solid #a7f3d0;
}
.pill.muted { background: #f1f5f9; color: var(--text-muted); border-color: var(--border); }
.pill.warn { background: var(--warning-bg); color: var(--warning); border-color: #fcd34d; }
.pill.danger { background: var(--danger-bg); color: var(--danger); border-color: #fecaca; }
.note {
margin: 0 0 20px;
padding: 14px 16px;
background: #fff;
border: 1px solid var(--border);
border-radius: var(--radius);
font-size: 13px;
color: var(--text-secondary);
}
.note strong { color: var(--text); }
.note ul { margin: 8px 0 0; padding-left: 18px; }
.note li { margin: 4px 0; }
.tabs {
display: flex;
gap: 0;
margin-bottom: 0;
border-bottom: 1px solid var(--border);
}
.tab-btn {
appearance: none;
border: none;
background: transparent;
padding: 10px 18px;
font: inherit;
font-weight: 500;
color: var(--text-muted);
cursor: pointer;
border-bottom: 2px solid transparent;
margin-bottom: -1px;
}
.tab-btn:hover { color: var(--primary-dark); }
.tab-btn.active {
color: var(--primary-dark);
border-bottom-color: var(--primary);
font-weight: 600;
}
.panel {
background: var(--panel);
border: 1px solid var(--border);
border-top: none;
border-radius: 0 0 var(--radius) var(--radius);
padding: 20px;
}
.section-title {
margin: 0 0 14px;
padding: 8px 12px;
background: linear-gradient(90deg, var(--primary-bg), transparent);
border-radius: var(--radius-sm);
}
.section-title h3 {
margin: 0;
font-size: 15px;
font-weight: 600;
color: var(--text);
}
/* ---- 现状:四列网格挤在一起 ---- */
.data-grid {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 12px 16px;
}
.data-item {
min-width: 0;
padding: 10px 12px;
background: #f8fafc;
border: 1px solid var(--border);
border-radius: var(--radius-sm);
}
.data-label {
font-size: 12px;
color: var(--text-muted);
margin-bottom: 4px;
}
.data-value {
font-size: 14px;
color: var(--text);
word-break: break-word;
}
.data-value--muted { color: var(--text-secondary); }
.problem-callout {
margin-top: 14px;
padding: 10px 12px;
background: var(--danger-bg);
border: 1px solid #fecaca;
border-radius: var(--radius-sm);
color: #991b1b;
font-size: 13px;
}
/* ---- 方案:表格单行历史 ---- */
.table-wrap {
border: 1px solid var(--border);
border-radius: var(--radius-sm);
overflow: auto;
}
table.list-table {
width: 100%;
border-collapse: collapse;
font-size: 14px;
}
table.list-table thead th {
background: #f8fafc;
color: var(--text-secondary);
font-weight: 600;
font-size: 13px;
padding: 10px 12px;
border-bottom: 1px solid var(--border);
white-space: nowrap;
text-align: center;
}
table.list-table tbody td {
padding: 10px 12px;
border-bottom: 1px solid var(--border);
text-align: center;
vertical-align: middle;
color: var(--text);
}
table.list-table tbody tr:last-child td { border-bottom: none; }
table.list-table tbody tr:nth-child(even) { background: #fafafa; }
table.list-table tbody tr:hover { background: var(--primary-bg); }
table.list-table .col-desc {
text-align: left;
max-width: 280px;
color: var(--text-secondary);
}
.tag {
display: inline-flex;
align-items: center;
padding: 2px 8px;
border-radius: 4px;
font-size: 12px;
font-weight: 500;
line-height: 1.6;
}
.tag.success { background: var(--primary-bg); color: var(--primary-dark); }
.tag.warning { background: var(--warning-bg); color: var(--warning); }
.tag.danger { background: var(--danger-bg); color: var(--danger); }
.tag.info { background: var(--info-bg); color: var(--info); }
.tag.primary { background: #eff6ff; color: #2563eb; }
.highlight-row td { box-shadow: inset 3px 0 0 var(--primary); }
.caption {
margin-top: 12px;
font-size: 12px;
color: var(--text-muted);
}
.caption em {
font-style: normal;
color: var(--primary-dark);
font-weight: 600;
}
.compare {
display: none;
}
.compare.active { display: block; }
/* 方案 B:卡片行(备选) */
.record-list { display: flex; flex-direction: column; gap: 10px; }
.record-row {
display: grid;
grid-template-columns: 88px 1fr 160px 100px;
gap: 12px;
align-items: start;
padding: 12px 14px;
border: 1px solid var(--border);
border-radius: var(--radius-sm);
background: #fff;
}
.record-row:hover { border-color: #a7f3d0; background: var(--primary-bg); }
.record-type { padding-top: 2px; }
.record-main .time {
font-weight: 600;
color: var(--text);
margin-bottom: 2px;
}
.record-main .desc { color: var(--text-secondary); font-size: 13px; }
.record-meta {
font-size: 12px;
color: var(--text-muted);
text-align: right;
line-height: 1.6;
}
.record-meta .from-to { color: var(--text-secondary); }
@media (max-width: 720px) {
.data-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.record-row { grid-template-columns: 1fr; }
.record-meta { text-align: left; }
}
</style>
</head>
<body>
<div class="page">
<header class="hero">
<h1>采集协议单 · 状态变更记录展示 Demo</h1>
<p>
对照用户反馈:① 变更记录有时挤在一行;② 同种类型第二条覆盖第一条。
下方用同一份模拟数据展示「现状」与「建议方案」。
</p>
<div class="context-bar">
<span class="pill">Fresh Mint</span>
<span class="pill muted">对齐审核记录表格风格</span>
<span class="pill warn">问题 1:网格挤行</span>
<span class="pill danger">问题 2:主表字段覆盖写</span>
</div>
</header>
<div class="note">
<strong>模拟场景:</strong>协议经历多次状态流转(含两次「过期」类操作示意)。
<ul>
<li>现状:主表只存各类型最新时间/描述 → 第二次「过期」会盖掉第一次;四列网格把多类字段摊平,视觉上不像「一条记录一行」。</li>
<li>建议:改成与「审核记录」一致的表格流水;每次变更追加一行;同类型可出现多条。</li>
</ul>
</div>
<div class="tabs" role="tablist">
<button type="button" class="tab-btn active" data-tab="current">现状(有问题)</button>
<button type="button" class="tab-btn" data-tab="table">方案 A · 表格流水(推荐)</button>
<button type="button" class="tab-btn" data-tab="card">方案 B · 卡片行</button>
</div>
<!-- 现状 -->
<section class="panel compare active" id="panel-current">
<div class="section-title"><h3>状态变更记录</h3></div>
<div class="data-grid">
<div class="data-item">
<div class="data-label">协议生效时间</div>
<div class="data-value">2026-03-01 10:20:00</div>
</div>
<div class="data-item">
<div class="data-label">协议生效描述</div>
<div class="data-value data-value--muted">审核通过后生效</div>
</div>
<div class="data-item">
<div class="data-label">协议过期时间</div>
<div class="data-value">2026-09-15 18:00:00</div>
</div>
<div class="data-item">
<div class="data-label">协议过期描述</div>
<div class="data-value data-value--muted">第二次标记过期(已覆盖第一次)</div>
</div>
<div class="data-item">
<div class="data-label">作废类型</div>
<div class="data-value">客户主动解约</div>
</div>
<div class="data-item">
<div class="data-label">协议作废时间</div>
<div class="data-value">2026-10-01 09:30:00</div>
</div>
<div class="data-item">
<div class="data-label">协议作废描述</div>
<div class="data-value data-value--muted">客户书面申请作废</div>
</div>
<div class="data-item">
<div class="data-label">协议转科研时间</div>
<div class="data-value">—</div>
</div>
</div>
<div class="problem-callout">
问题示意:① 生效/过期/作废字段混在同一 4 列网格,作废 3 个字段更容易「挤成一行」;
② 第一次过期(假设 2026-06-01「合同到期提醒」)已被第二次过期描述覆盖,界面上看不到历史。
</div>
</section>
<!-- 方案 A:表格 -->
<section class="panel compare" id="panel-table">
<div class="section-title"><h3>状态变更记录</h3></div>
<div class="table-wrap">
<table class="list-table">
<thead>
<tr>
<th style="width:68px">序号</th>
<th style="min-width:110px">变更类型</th>
<th style="min-width:160px">变更时间</th>
<th style="min-width:120px">状态流转</th>
<th style="min-width:200px">变更说明</th>
<th style="min-width:100px">操作人</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td><span class="tag success">生效</span></td>
<td>2026-03-01 10:20:00</td>
<td>待生效 → 生效中</td>
<td class="col-desc">审核通过后生效</td>
<td>张三</td>
</tr>
<tr class="highlight-row">
<td>2</td>
<td><span class="tag warning">过期</span></td>
<td>2026-06-01 12:00:00</td>
<td>生效中 → 已过期</td>
<td class="col-desc">合同到期提醒(第一次,保留)</td>
<td>李四</td>
</tr>
<tr>
<td>3</td>
<td><span class="tag success">生效</span></td>
<td>2026-07-10 09:00:00</td>
<td>已过期 → 生效中</td>
<td class="col-desc">续签后重新生效</td>
<td>张三</td>
</tr>
<tr class="highlight-row">
<td>4</td>
<td><span class="tag warning">过期</span></td>
<td>2026-09-15 18:00:00</td>
<td>生效中 → 已过期</td>
<td class="col-desc">第二次标记过期(不再覆盖第一条)</td>
<td>王五</td>
</tr>
<tr>
<td>5</td>
<td><span class="tag danger">作废</span></td>
<td>2026-10-01 09:30:00</td>
<td>已过期 → 已作废</td>
<td class="col-desc">作废类型:客户主动解约;客户书面申请作废</td>
<td>赵六</td>
</tr>
</tbody>
</table>
</div>
<p class="caption">
高亮行为同类型「过期」的两条记录 —— 演示 <em>追加不覆盖</em>。
列结构对齐详情里「审核记录」:序号 / 类型 Tag / 时间 / 说明 / 操作人。
</p>
</section>
<!-- 方案 B:卡片行 -->
<section class="panel compare" id="panel-card">
<div class="section-title"><h3>状态变更记录</h3></div>
<div class="record-list">
<div class="record-row">
<div class="record-type"><span class="tag success">生效</span></div>
<div class="record-main">
<div class="time">2026-03-01 10:20:00</div>
<div class="desc">审核通过后生效</div>
</div>
<div class="record-meta">
<div class="from-to">待生效 → 生效中</div>
<div>操作人:张三</div>
</div>
</div>
<div class="record-row" style="border-color:#a7f3d0;background:var(--primary-bg)">
<div class="record-type"><span class="tag warning">过期</span></div>
<div class="record-main">
<div class="time">2026-06-01 12:00:00</div>
<div class="desc">合同到期提醒(第一次,保留)</div>
</div>
<div class="record-meta">
<div class="from-to">生效中 → 已过期</div>
<div>操作人:李四</div>
</div>
</div>
<div class="record-row">
<div class="record-type"><span class="tag success">生效</span></div>
<div class="record-main">
<div class="time">2026-07-10 09:00:00</div>
<div class="desc">续签后重新生效</div>
</div>
<div class="record-meta">
<div class="from-to">已过期 → 生效中</div>
<div>操作人:张三</div>
</div>
</div>
<div class="record-row" style="border-color:#a7f3d0;background:var(--primary-bg)">
<div class="record-type"><span class="tag warning">过期</span></div>
<div class="record-main">
<div class="time">2026-09-15 18:00:00</div>
<div class="desc">第二次标记过期(不再覆盖第一条)</div>
</div>
<div class="record-meta">
<div class="from-to">生效中 → 已过期</div>
<div>操作人:王五</div>
</div>
</div>
<div class="record-row">
<div class="record-type"><span class="tag danger">作废</span></div>
<div class="record-main">
<div class="time">2026-10-01 09:30:00</div>
<div class="desc">作废类型:客户主动解约;客户书面申请作废</div>
</div>
<div class="record-meta">
<div class="from-to">已过期 → 已作废</div>
<div>操作人:赵六</div>
</div>
</div>
</div>
<p class="caption">卡片行更偏时间线阅读;若要与审核记录视觉统一,优先方案 A。</p>
</section>
</div>
<script>
const buttons = document.querySelectorAll(".tab-btn");
const panels = {
current: document.getElementById("panel-current"),
table: document.getElementById("panel-table"),
card: document.getElementById("panel-card"),
};
buttons.forEach((btn) => {
btn.addEventListener("click", () => {
buttons.forEach((b) => b.classList.remove("active"));
btn.classList.add("active");
Object.keys(panels).forEach((key) => {
panels[key].classList.toggle("active", key === btn.dataset.tab);
});
});
});
</script>
</body>
</html>
@@ -0,0 +1,46 @@
-- =============================================================================
-- 弱密码刷新说明:111111 → Zkxw@123
-- 日期:2026-10-16
-- =============================================================================
--
-- 重要:sys_user.password 存储 bcrypt 哈希(每次盐随机),
-- 不能用下列语句命中弱密码用户:
-- WHERE password = '111111' -- 无效
-- WHERE password LIKE '%111111%' -- 无效
--
-- 推荐:用 Python 脚本,并通过变量指定目标库(勿依赖本机默认 .env 误连生产)。
--
-- cd backend && source venv/bin/activate
--
-- # 方式 A:完整 URL
-- python scripts/reset_weak_password_111111.py \
-- --database-url 'mysql+pymysql://USER:PASS@HOST:3306/DBNAME' --dry-run
--
-- # 方式 B:分项变量
-- python scripts/reset_weak_password_111111.py \
-- --db-host HOST --db-port 3306 --db-user USER --db-password 'PASS' --db-name DBNAME --dry-run
--
-- # 方式 C:指定环境文件
-- python scripts/reset_weak_password_111111.py --env-file ./.env.test --dry-run
--
-- # 正式写入:去掉 --dry-run
--
-- 脚本行为:校验 del_flag=0 的用户口令是否为明文 111111(含停用账号),
-- 命中则更新为 Zkxw@123 的新 bcrypt 哈希。
--
-- =============================================================================
-- 以下仅为「已知单个用户 id」时的手工 UPDATE 模板。
-- 哈希由本机生成示例(明文 Zkxw@123,bcrypt cost 12),部署前请用 Python 重新生成:
-- python -c "from app.core.security import get_password_hash; print(get_password_hash('Zkxw@123'))"
-- =============================================================================
-- 示例哈希(仅供手工单用户更新参考;批量请用脚本):
-- $2b$12$ULvPCr6g9IUmI8K7nlGU5emk7hupaAz4WgFdEoQBe935Wh1pVYKCK
-- UPDATE sys_user
-- SET password = '$2b$12$ULvPCr6g9IUmI8K7nlGU5emk7hupaAz4WgFdEoQBe935Wh1pVYKCK',
-- update_time = NOW()
-- WHERE id = '<user_id>'
-- AND del_flag = 0;
-- 执行前请备份 sys_user;执行后通知用户使用新密码并建议登录后自行修改。
@@ -0,0 +1,161 @@
-- =============================================================================
-- 打开全部 OA 审批应用的「审批人去重」,并强制重新发布(2026-10-16)
-- MySQL 5.7
--
-- 行为:
-- 1. 每个已有「最新已发布」版本的应用:无论 approverDedup 当前是否已为 true,
-- 一律复制为新的 published 行(表单、流程不变,开关强制 true),
-- 旧的 is_latest_published 改为 0。
-- 已在途实例仍指向旧 version id;新发起走新版本。
-- 2. 全部未删除草稿:就地把 approverDedup 设为 true(不把草稿未完成改动一并发布)。
-- 3. 从未发布过的应用:把版本号最大的那条草稿标为已发布,并打开开关。
--
-- 注意:本脚本会为每个已发布应用再升一版;短时间内重复执行会连续升版。
-- =============================================================================
DROP PROCEDURE IF EXISTS sp_oa_enable_approver_dedup;
DELIMITER $$
CREATE PROCEDURE sp_oa_enable_approver_dedup()
BEGIN
DECLARE v_done INT DEFAULT 0;
DECLARE v_src_id VARCHAR(64);
DECLARE v_app_id VARCHAR(64);
DECLARE v_tenant VARCHAR(64);
DECLARE v_next_no INT;
DECLARE v_new_id VARCHAR(64);
DECLARE v_advanced TEXT;
-- 强制:所有当前最新已发布版本都重新发布一版
DECLARE cur CURSOR FOR
SELECT id, app_id, tenant_no
FROM oa_app_version
WHERE del_flag = 0
AND is_latest_published = '1';
DECLARE CONTINUE HANDLER FOR NOT FOUND SET v_done = 1;
OPEN cur;
read_loop: LOOP
FETCH cur INTO v_src_id, v_app_id, v_tenant;
IF v_done = 1 THEN
LEAVE read_loop;
END IF;
SELECT IFNULL(MAX(version_no), 0) + 1
INTO v_next_no
FROM oa_app_version
WHERE app_id = v_app_id
AND tenant_no = v_tenant;
SET v_new_id = UPPER(REPLACE(UUID(), '-', ''));
SELECT CAST(
JSON_SET(
CASE
WHEN advanced_settings_json IS NULL
OR advanced_settings_json = ''
OR JSON_VALID(advanced_settings_json) = 0
THEN CAST('{}' AS JSON)
ELSE CAST(advanced_settings_json AS JSON)
END,
'$.approverDedup',
CAST('true' AS JSON)
) AS CHAR
)
INTO v_advanced
FROM oa_app_version
WHERE id = v_src_id;
INSERT INTO oa_app_version (
id, app_id, version_no, status, is_latest_published,
form_schema_json, flow_tree_json, advanced_settings_json,
tenant_no, order_num, remark,
create_by, create_dept_id, create_time,
update_by, update_time, del_flag
)
SELECT
v_new_id, app_id, v_next_no, 'published', '1',
form_schema_json, flow_tree_json, v_advanced,
tenant_no, order_num, remark,
create_by, create_dept_id, NOW(),
'sql-approver-dedup', NOW(), 0
FROM oa_app_version
WHERE id = v_src_id;
UPDATE oa_app_version
SET is_latest_published = '0',
update_by = 'sql-approver-dedup',
update_time = NOW()
WHERE id = v_src_id;
END LOOP;
CLOSE cur;
-- 草稿只改开关,避免把未完成的表单/流程改动一起发布
UPDATE oa_app_version
SET advanced_settings_json = CAST(
JSON_SET(
CASE
WHEN advanced_settings_json IS NULL
OR advanced_settings_json = ''
OR JSON_VALID(advanced_settings_json) = 0
THEN CAST('{}' AS JSON)
ELSE CAST(advanced_settings_json AS JSON)
END,
'$.approverDedup',
CAST('true' AS JSON)
) AS CHAR
),
update_by = 'sql-approver-dedup',
update_time = NOW()
WHERE del_flag = 0
AND status = 'draft';
-- 从未发布:提升当前最大版本号草稿
UPDATE oa_app_version d
INNER JOIN (
SELECT app_id, tenant_no, MAX(version_no) AS version_no
FROM oa_app_version
WHERE del_flag = 0
AND status = 'draft'
GROUP BY app_id, tenant_no
) latest_draft
ON latest_draft.app_id = d.app_id
AND latest_draft.tenant_no = d.tenant_no
AND latest_draft.version_no = d.version_no
LEFT JOIN (
SELECT app_id, tenant_no
FROM oa_app_version
WHERE del_flag = 0
AND is_latest_published = '1'
GROUP BY app_id, tenant_no
) published
ON published.app_id = d.app_id
AND published.tenant_no = d.tenant_no
SET d.status = 'published',
d.is_latest_published = '1',
d.update_by = 'sql-approver-dedup',
d.update_time = NOW()
WHERE d.del_flag = 0
AND d.status = 'draft'
AND published.app_id IS NULL;
END$$
DELIMITER ;
CALL sp_oa_enable_approver_dedup();
DROP PROCEDURE IF EXISTS sp_oa_enable_approver_dedup;
-- 核对:最新已发布应由本脚本生成,且开关为 true
SELECT app_id,
tenant_no,
version_no,
status,
is_latest_published,
update_by,
JSON_UNQUOTE(JSON_EXTRACT(advanced_settings_json, '$.approverDedup')) AS approver_dedup
FROM oa_app_version
WHERE del_flag = 0
AND is_latest_published = '1'
ORDER BY tenant_no, app_id;
@@ -0,0 +1,322 @@
-- 采集协议单 / 科研捐赠:状态变更历史表(追加写,同类型不覆盖)
-- 对齐 docs/superpowers/plans/2026-10-17-protocol-status-change-history.md
CREATE TABLE IF NOT EXISTS biz_protocol_status_change (
id VARCHAR(64) NOT NULL COMMENT '主键ID',
collection_protocol_id VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
change_type VARCHAR(32) NOT NULL COMMENT '变更类型 activate/expire/void/to_research',
from_status VARCHAR(16) DEFAULT NULL COMMENT '变更前状态码',
to_status VARCHAR(16) NOT NULL COMMENT '变更后状态码',
change_time DATETIME NOT NULL COMMENT '业务变更时间',
change_desc VARCHAR(512) DEFAULT NULL COMMENT '变更描述',
void_type VARCHAR(32) DEFAULT NULL COMMENT '作废类型(字典 xyzflx)',
operator_user_id VARCHAR(64) DEFAULT NULL COMMENT '操作人用户ID',
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_bpsc_protocol_time (tenant_no, collection_protocol_id, del_flag, change_time)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单状态变更记录';
CREATE TABLE IF NOT EXISTS biz_donation_status_change (
id VARCHAR(64) NOT NULL COMMENT '主键ID',
research_donation_id VARCHAR(64) NOT NULL COMMENT '科研捐赠单ID',
change_type VARCHAR(32) NOT NULL COMMENT '变更类型 activate/expire/void/to_storage',
from_status VARCHAR(16) DEFAULT NULL COMMENT '变更前状态码',
to_status VARCHAR(16) NOT NULL COMMENT '变更后状态码',
change_time DATETIME NOT NULL COMMENT '业务变更时间',
change_desc VARCHAR(512) DEFAULT NULL COMMENT '变更描述',
void_type VARCHAR(32) DEFAULT NULL COMMENT '作废类型(字典 xyzflx)',
operator_user_id VARCHAR(64) DEFAULT NULL COMMENT '操作人用户ID',
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_bdsc_donation_time (tenant_no, research_donation_id, del_flag, change_time)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='科研捐赠状态变更记录';
-- 回填:主表已有快照各插 1 条(幂等:同协议同 change_type 尚无历史时)
INSERT INTO biz_protocol_status_change (
id, collection_protocol_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(p.id, '|activate'))),
p.id,
'activate',
NULL,
'sxz',
p.effective_time,
p.effective_desc,
NULL,
p.update_by,
p.tenant_no,
0,
NULL,
p.update_by,
'',
IFNULL(p.effective_time, NOW()),
p.update_by,
IFNULL(p.effective_time, NOW()),
0
FROM biz_collection_protocol p
WHERE p.del_flag = 0
AND p.effective_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_status_change c
WHERE c.collection_protocol_id = p.id
AND c.change_type = 'activate'
AND c.del_flag = 0
);
INSERT INTO biz_protocol_status_change (
id, collection_protocol_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(p.id, '|expire'))),
p.id,
'expire',
NULL,
'ygq',
p.expire_time,
p.expire_desc,
NULL,
p.update_by,
p.tenant_no,
0,
NULL,
p.update_by,
'',
IFNULL(p.expire_time, NOW()),
p.update_by,
IFNULL(p.expire_time, NOW()),
0
FROM biz_collection_protocol p
WHERE p.del_flag = 0
AND p.expire_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_status_change c
WHERE c.collection_protocol_id = p.id
AND c.change_type = 'expire'
AND c.del_flag = 0
);
INSERT INTO biz_protocol_status_change (
id, collection_protocol_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(p.id, '|void'))),
p.id,
'void',
NULL,
'yzf',
p.void_time,
p.void_desc,
p.void_type,
p.update_by,
p.tenant_no,
0,
NULL,
p.update_by,
'',
IFNULL(p.void_time, NOW()),
p.update_by,
IFNULL(p.void_time, NOW()),
0
FROM biz_collection_protocol p
WHERE p.del_flag = 0
AND p.void_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_status_change c
WHERE c.collection_protocol_id = p.id
AND c.change_type = 'void'
AND c.del_flag = 0
);
INSERT INTO biz_protocol_status_change (
id, collection_protocol_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(p.id, '|to_research'))),
p.id,
'to_research',
NULL,
'zky',
p.to_research_time,
p.to_research_desc,
NULL,
p.update_by,
p.tenant_no,
0,
NULL,
p.update_by,
'',
IFNULL(p.to_research_time, NOW()),
p.update_by,
IFNULL(p.to_research_time, NOW()),
0
FROM biz_collection_protocol p
WHERE p.del_flag = 0
AND p.to_research_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_protocol_status_change c
WHERE c.collection_protocol_id = p.id
AND c.change_type = 'to_research'
AND c.del_flag = 0
);
INSERT INTO biz_donation_status_change (
id, research_donation_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(d.id, '|activate'))),
d.id,
'activate',
NULL,
'sxz',
d.effective_time,
d.effective_desc,
NULL,
d.update_by,
d.tenant_no,
0,
NULL,
d.update_by,
'',
IFNULL(d.effective_time, NOW()),
d.update_by,
IFNULL(d.effective_time, NOW()),
0
FROM biz_research_donation d
WHERE d.del_flag = 0
AND d.effective_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_donation_status_change c
WHERE c.research_donation_id = d.id
AND c.change_type = 'activate'
AND c.del_flag = 0
);
INSERT INTO biz_donation_status_change (
id, research_donation_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(d.id, '|expire'))),
d.id,
'expire',
NULL,
'ygq',
d.expire_time,
d.expire_desc,
NULL,
d.update_by,
d.tenant_no,
0,
NULL,
d.update_by,
'',
IFNULL(d.expire_time, NOW()),
d.update_by,
IFNULL(d.expire_time, NOW()),
0
FROM biz_research_donation d
WHERE d.del_flag = 0
AND d.expire_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_donation_status_change c
WHERE c.research_donation_id = d.id
AND c.change_type = 'expire'
AND c.del_flag = 0
);
INSERT INTO biz_donation_status_change (
id, research_donation_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(d.id, '|void'))),
d.id,
'void',
NULL,
'yzf',
d.void_time,
d.void_desc,
d.void_type,
d.update_by,
d.tenant_no,
0,
NULL,
d.update_by,
'',
IFNULL(d.void_time, NOW()),
d.update_by,
IFNULL(d.void_time, NOW()),
0
FROM biz_research_donation d
WHERE d.del_flag = 0
AND d.void_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_donation_status_change c
WHERE c.research_donation_id = d.id
AND c.change_type = 'void'
AND c.del_flag = 0
);
INSERT INTO biz_donation_status_change (
id, research_donation_id, change_type, from_status, to_status,
change_time, change_desc, void_type, operator_user_id,
tenant_no, order_num, remark, create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
UPPER(MD5(CONCAT(d.id, '|to_storage'))),
d.id,
'to_storage',
NULL,
'zckc',
d.to_storage_time,
d.to_storage_desc,
NULL,
d.update_by,
d.tenant_no,
0,
NULL,
d.update_by,
'',
IFNULL(d.to_storage_time, NOW()),
d.update_by,
IFNULL(d.to_storage_time, NOW()),
0
FROM biz_research_donation d
WHERE d.del_flag = 0
AND d.to_storage_time IS NOT NULL
AND NOT EXISTS (
SELECT 1 FROM biz_donation_status_change c
WHERE c.research_donation_id = d.id
AND c.change_type = 'to_storage'
AND c.del_flag = 0
);
@@ -0,0 +1,36 @@
# 存储服务与市场移动端完整性测试及修复计划
> 执行方式:当前会话按模块并行排查,协调者统一集成与回归;采用 systematic-debugging、test-driven-development、verification-before-completion。
**目标:** 对指定七个 Web 模块与市场专员、地区经理各五个移动模块建立测试证据,修复可复现缺陷并回归。
**架构:** 沿用现有 FastAPI、Vue 管理端、uni-app 壳与市场 H5;仅修改目标模块及其专用测试。普通角色权限在隔离数据库验证,真实环境使用 admin 验证接口和页面。
**范围:** protocol-audit、presign-order、payment-info、payment-chase、sample-info(客户服务)、sample-freight、payment-confirm;mobile-h5 市场入口与 mobile-oa-h5 市场五模块。OA、生产、质检及其他业务不在修改范围。
## 测试步骤
- [x] 确认运行服务、菜单与代码映射,记录初始工作区修改。
- [x] 使用提供的 admin 账号通过 Web 登录。
- [x] 执行后端目标模块基线测试、移动端 307 项基线及 Web 专项检查。
- [x] 验证七个 Web 列表/详情/表单及十个移动入口,记录浏览器和接口错误。
- [x] 用专用 QA 标记数据验证预签约、转账提交/撤回/退回/确认、转正式、协议缴费、催缴、运费和客户服务。
- [x] 对缺陷增加先失败的回归测试,再实施最小修复。
- [x] 重新运行相关自动化、页面与接口检查,更新知识图谱和字段一致性检查。
- [x] 汇总测试报告、缺陷闭环、残余限制与复测方法。
## 第一轮发现与改造方案
### QA-01 Web 运费缺少角色数据权限
发现:`backend/app/api/sample_freight.py` 调用 CRUD 时未传当前用户数据权限;同租户受限用户能访问超出角色范围的运费。
方案:在运费列表、详情、写入以及可选/关联样本检查现有数据权限;保持多角色并集语义,并保留移动端既有市场角色范围。仅修改运费 API/CRUD 与专用测试。
验证:隔离 SQLite 构造本人/他人、部门及多角色范围,证明未授权列表、详情和修改被拒绝;验证管理员与授权路径仍可用。先运行失败测试,再修复并重跑。
后续缺陷及具体修复记录随实测补充到测试报告,避免将静态猜测记为已确认问题。
## 执行结果
已完成报告:`docs/testing/2026-10-15-storage-market-report.md`。新增缺陷及修复方案、回归证据和真实验收限制见报告;财务成功链路以隔离测试覆盖,严格权限规则未修改。
@@ -0,0 +1,31 @@
# OA 已办中心打印按钮 — Implementation Plan
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**Goal:** 为 Web / 小程序【已办中心】补齐打印入口,复用现有 PDF 导出链路。
**Architecture:** 不新增打印引擎;Web 复制 `cc`/`mine` 的 `printRow`;小程序复制 `mine` 的 `onCardLongPress` + `autoPrint`。
**Tech Stack:** Vue 3 + Element Plus(web-admin);uni-app Vue2(mobile-h5)
---
### Task 1: Web 已办中心加打印
**Files:**
- Modify: `web-admin/src/views/oa-approval/done/index.vue`
**Step 1:** 操作列加「打印」按钮与 `printRow`(`instanceId`,`exportOaApprovalPdf`)
**Step 2:** 操作列 `min-width` 调至约 320,避免裁切
---
### Task 2: 小程序已办中心加长按打印
**Files:**
- Modify: `mobile-h5/pages/oa/done/index.vue`
**Step 1:** 卡片 `@longpress="onCardLongPress"`
**Step 2:** `onCardLongPress` + `openView(row, { autoPrint })` 对齐 `mine`
@@ -29,7 +29,7 @@
**Files:**
- Modify: `backend/tests/test_oa_instance_history.py`
- [ ] **Step 1: Extend setUp with SysDept tree and initiator_dept_id on instances**
- [x] **Step 1: Extend setUp with SysDept tree and initiator_dept_id on instances**
Import `SysDept` from `app.models.models`.
@@ -0,0 +1,107 @@
# Security Scan and Weak Password Reset 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:** Deliver a static security scan report (SQLi/XSS etc., no business code fixes) and a script to reset `sys_user` passwords that verify as `111111` to `Zkxw@123`.
**Architecture:** Static grep/read audit of `backend/app` and frontend `src` trees; findings written to Markdown. Weak-password reset uses bcrypt verify in a one-off Python script; SQL file documents why pure SQL cannot match hashes and points to the script.
**Tech Stack:** Python 3.9, bcrypt, SQLAlchemy/pymysql via existing backend settings; Markdown reports under `docs/`.
**Spec:** `docs/superpowers/specs/2026-10-16-security-scan-and-weak-password-design.md`
---
### Task 1: Static security audit and report
**Files:**
- Create: `docs/testing/2026-10-16-security-scan-report.md`
- [x] **Step 1: Search backend for SQL injection patterns**
Run from repo root:
```bash
rg -n "text\(|execute\(|f[\"'].*(SELECT|INSERT|UPDATE|DELETE)|%\s*\(.*SELECT|\.format\(" backend/app --glob '*.py'
rg -n "sql_template|strategy.*sql|_FORBIDDEN_SQL" backend/app --glob '*.py'
```
Read each hit that builds or runs SQL with possible user/config input (especially `workflow_engine.py` SQL approver strategy). Note file:line, risk, suggestion.
- [x] **Step 2: Search frontends for XSS patterns**
```bash
rg -n "v-html|innerHTML|document\.write|eval\(|new Function" web-admin/src mobile-oa-h5/src mobile-h5 miniprogram --glob '*.{vue,js,ts}'
```
For each `v-html`, check whether content passes `sanitizeHtml` / DOMPurify. Exclude vendor noise.
- [x] **Step 3: Spot-check auth / weak-password related info items**
Confirm password hashing (`backend/app/core/security.py`), default `admin`/`111111` docs (`AGENTS.md`, `backend/README.md`). Record as 信息 if relevant.
- [x] **Step 4: Write the report**
Create `docs/testing/2026-10-16-security-scan-report.md` with:
- Summary (counts by severity)
- Findings table/sections: 标题、风险、位置、简述、建议
- Method, scope, limitations
- Explicit “未发现” for categories with clean results after search
Do not modify business application code.
---
### Task 2: Weak-password reset script
**Files:**
- Create: `backend/scripts/reset_weak_password_111111.py`
- Create: `docs/sql/2026-10-16-reset-weak-password-111111.sql`
- [x] **Step 1: Implement Python script**
Create `backend/scripts/reset_weak_password_111111.py` that:
1. Adds repo `backend` to `sys.path` and loads settings like other scripts (reuse `app.core.database` / `app.core.config` / `app.core.security`).
2. Queries `SysUser` where `del_flag == 0`.
3. For each row, `verify_password("111111", password)`; if true and not `--dry-run`, set password via `get_password_hash("Zkxw@123")` and update `update_time` if present.
4. Supports `--dry-run` (list only) and optional `--commit` or default commit with clear print of counts.
5. Prints `user_no`, `id`, `status` for each hit.
Follow patterns in existing `backend/scripts/*.py` for DB session bootstrap.
- [x] **Step 2: Write SQL companion doc**
Create `docs/sql/2026-10-16-reset-weak-password-111111.sql` explaining bcrypt limitation; include example:
```sql
-- 说明:无法用 WHERE password='111111' 命中弱密码。
-- 请使用: python backend/scripts/reset_weak_password_111111.py [--dry-run]
-- 以下仅为「已知单用户」手工更新模板(哈希需现场生成):
-- UPDATE sys_user SET password = '<bcrypt of Zkxw@123>', update_time = NOW()
-- WHERE id = '<user_id>' AND del_flag = 0;
```
Generate one real bcrypt hash of `Zkxw@123` in comments for operators who must UPDATE a known id manually.
- [x] **Step 3: Dry-run verification**
```bash
cd backend && source venv/bin/activate && python scripts/reset_weak_password_111111.py --dry-run
```
Expected: script starts, lists matching users or “0 matches”, does not write. If DB unavailable, document in report/script README comment how to run when DB is up; do not invent failures as bugs.
---
### Task 3: Spec checklist
- [x] **Step 1: Confirm deliverables exist**
- [x] `docs/testing/2026-10-16-security-scan-report.md`
- [x] `backend/scripts/reset_weak_password_111111.py`
- [x] `docs/sql/2026-10-16-reset-weak-password-111111.sql`
- [x] No unrelated business code changes
- [x] **Step 2: Stop for human review** (no auto-commit unless user asks)
@@ -0,0 +1,538 @@
# 移动端缴费信息 · 协议只读 + 缴费明细同屏转账 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.
> **Status:** Tasks 1–6 implemented on `V2.0` (commits `80d238d3`…`d355cd06`). Market suite 323/323 pass. Manual UI checklist still recommended.
**Goal:** 缴费列表「协议单」进入只读协议详情(隐藏编辑/删除);「缴费明细」同屏应缴只读 + 期次转账可写(保存/提交财务/撤回),附件统一 `MarketAttachmentCards`。
**Architecture:** 方案 1——协议复用 `MarketModuleDetail`,用 `query.from=payment` 过滤写动作;缴费详情挂载 `PaymentDetailTransfersPanel`,转账区抽共享 `ScheduleTransferEditor`(从 `ProtocolSamplePaymentPanel` 抽出),API 仍走现有 `/mini/market/{role}/payment-transfers`。
**Tech Stack:** Vue 3 + Vant(`mobile-oa-h5`)、既有 `protocol-sample-transfer.js` 纯函数、`MarketAttachmentCards`、node `--test`
**Spec:** `docs/superpowers/specs/2026-10-17-mobile-payment-detail-parity-design.md`
**Demo:** `docs/demos/2026-10-17-mobile-payment-detail-parity-demo.html`
---
## File map
| 文件 | 职责 |
|------|------|
| Create: `mobile-oa-h5/src/market/payment-entry.js` | `from=payment` 判定与协议动作过滤纯函数 |
| Create: `mobile-oa-h5/src/market/payment-entry.test.js` | 上述纯函数测试 |
| Modify: `mobile-oa-h5/src/views/market/MarketModuleList.vue` | `openProtocol` 附加 `from=payment` |
| Modify: `mobile-oa-h5/src/views/market/MarketModuleDetail.vue` | 协议只读压制;缴费详情挂载转账面板;缴费底栏去掉转账动作 |
| Create: `mobile-oa-h5/src/market/components/ScheduleTransferEditor.vue` | 单期转账卡片 CRUD/提交/撤回/凭证 |
| Create: `mobile-oa-h5/src/market/components/PaymentDetailTransfersPanel.vue` | 缴费详情摘要 + 期次头 + 挂载 Editor |
| Modify: `mobile-oa-h5/src/market/components/ProtocolSamplePaymentPanel.vue` | 转账区改为组合 `ScheduleTransferEditor` |
| Modify: `mobile-oa-h5/src/market/protocol-sample-transfer.js` | `assertCanSaveTransfer` / `canSubmitFinance` 支持 `contextId`(协议或缴费) |
| Modify: `mobile-oa-h5/src/market/mobile-parity-ui.test.js` 等 | 契约断言 |
| Docs only(已存在) | spec + demo,实现中勿改产品决策 |
---
### Task 1: `from=payment` 协议动作过滤(纯函数)
**Files:**
- Create: `mobile-oa-h5/src/market/payment-entry.js`
- Create: `mobile-oa-h5/src/market/payment-entry.test.js`
- [x] **Step 1: 写失败测试**
```js
import test from 'node:test'
import assert from 'node:assert/strict'
import {
isPaymentEntryView,
filterProtocolActionsForPaymentEntry
} from './payment-entry.js'
test('isPaymentEntryView detects from=payment', () => {
assert.equal(isPaymentEntryView({ from: 'payment' }), true)
assert.equal(isPaymentEntryView({ from: 'Payment' }), false)
assert.equal(isPaymentEntryView({}), false)
assert.equal(isPaymentEntryView(null), false)
})
test('filterProtocolActionsForPaymentEntry hides edit and delete', () => {
assert.deepEqual(
filterProtocolActionsForPaymentEntry(['view', 'edit', 'delete', 'create']),
['view']
)
assert.deepEqual(
filterProtocolActionsForPaymentEntry([
{ code: 'edit' },
{ code: 'delete' },
{ code: 'view' }
]),
[{ code: 'view' }]
)
})
```
- [ ] **Step 2: 跑测确认失败**
```bash
cd mobile-oa-h5 && node --test src/market/payment-entry.test.js
```
Expected: FAIL(模块不存在)
- [ ] **Step 3: 最小实现**
```js
/** 缴费信息入口进入协议详情时的只读压制 */
const PROTOCOL_WRITE_CODES = new Set(['edit', 'delete', 'create'])
export function isPaymentEntryView(query) {
return String(query?.from || '') === 'payment'
}
function actionCode(action) {
return typeof action === 'string'
? action
: String(action?.code || action?.action || action?.key || '').trim()
}
export function filterProtocolActionsForPaymentEntry(actions) {
return (Array.isArray(actions) ? actions : []).filter(
(action) => !PROTOCOL_WRITE_CODES.has(actionCode(action))
)
}
```
注:`create` 一般不会出现在详情底栏,一并过滤无害。
- [ ] **Step 4: 跑测通过**
```bash
cd mobile-oa-h5 && node --test src/market/payment-entry.test.js
```
Expected: PASS
- [ ] **Step 5: Commit**
```bash
git add mobile-oa-h5/src/market/payment-entry.js mobile-oa-h5/src/market/payment-entry.test.js
git commit -m "$(cat <<'EOF'
feat(mobile-oa-h5): add payment-entry helpers for readonly protocol view
EOF
)"
```
---
### Task 2: 列表跳转 + 详情只读压制
**Files:**
- Modify: `mobile-oa-h5/src/views/market/MarketModuleList.vue`(`openProtocol`)
- Modify: `mobile-oa-h5/src/views/market/MarketModuleDetail.vue`(`allowedActions`)
- Modify: `mobile-oa-h5/src/market/mobile-parity-ui.test.js`(源码契约)
- [ ] **Step 1: 写失败契约测试**
在 `mobile-parity-ui.test.js` 增加:
```js
test('payment list openProtocol passes from=payment', async () => {
const list = await readFile(new URL('../views/market/MarketModuleList.vue', import.meta.url), 'utf8')
assert.match(list, /from:\s*['"]payment['"]|from:\s*'payment'/)
assert.match(list, /openProtocol/)
})
test('protocol detail filters actions when from=payment', async () => {
const detail = await readFile(new URL('../views/market/MarketModuleDetail.vue', import.meta.url), 'utf8')
assert.match(detail, /isPaymentEntryView|filterProtocolActionsForPaymentEntry/)
})
```
(按文件现有 `readFile` / 断言风格微调。)
- [ ] **Step 2: 跑测确认失败**
```bash
cd mobile-oa-h5 && node --test src/market/mobile-parity-ui.test.js
```
- [ ] **Step 3: 改 `openProtocol`**
在 `MarketModuleList.vue` 的 `openProtocol` query 中增加 `from: 'payment'`(仅当当前模块为 `payment` 或 `payment-chase` 时;**缴费信息列表**与催缴进协议都应用只读——按 spec:缴费入口。催缴若也调 `openProtocol`,同样带 `from=payment` 与产品「只能看」一致;若催缴需编辑,则仅 `context.module === 'payment'` 时附加)。
**本计划明确:** 仅当 `context.value.module === 'payment'` 时附加 `from: 'payment'`。
```js
query: {
...pickMarketNavigationQuery(route.query),
source: item.source || 'cell_storage',
...(context.value.module === 'payment' ? { from: 'payment' } : {})
}
```
- [ ] **Step 4: 改 `MarketModuleDetail` 的 `allowedActions`**
```js
import {
isPaymentEntryView,
filterProtocolActionsForPaymentEntry
} from '../../market/payment-entry.js'
const allowedActions = computed(() => {
const raw = collectAllowedActions(
context.value.module,
context.value.marketRole,
detail.value
)
if (context.value.module === 'protocol' && isPaymentEntryView(route.query)) {
return filterProtocolActionsForPaymentEntry(raw)
}
return raw
})
```
`has-bottom-bar` 已绑定 `allowedActions.length > 0`,过滤后为空则自动无底栏。
- [ ] **Step 5: 跑测通过并 Commit**
```bash
cd mobile-oa-h5 && node --test src/market/payment-entry.test.js src/market/mobile-parity-ui.test.js
git add mobile-oa-h5/src/views/market/MarketModuleList.vue \
mobile-oa-h5/src/views/market/MarketModuleDetail.vue \
mobile-oa-h5/src/market/mobile-parity-ui.test.js
git commit -m "$(cat <<'EOF'
feat(mobile-oa-h5): open protocol from payment as readonly detail
EOF
)"
```
---
### Task 3: 扩展转账纯函数支持缴费 contextId
**Files:**
- Modify: `mobile-oa-h5/src/market/protocol-sample-transfer.js`
- Modify: `mobile-oa-h5/src/market/protocol-sample-transfer.test.js`
- [ ] **Step 1: 写失败测试**
```js
test('assertCanSaveTransfer accepts contextId alias for protocolId', () => {
assert.doesNotThrow(() =>
assertCanSaveTransfer({ contextId: 'pay-1', scheduleId: 's1' })
)
assert.throws(
() => assertCanSaveTransfer({ contextId: '', scheduleId: 's1' }),
/请先保存/
)
})
test('canSubmitFinance accepts contextId', () => {
assert.equal(
canSubmitFinance({ id: 't1', payStatus: 'dfj' }, 'pay-1'),
true
)
})
```
- [ ] **Step 2: 跑测确认失败**
```bash
cd mobile-oa-h5 && node --test src/market/protocol-sample-transfer.test.js
```
- [ ] **Step 3: 实现**
将 `assertCanSaveTransfer` 改为:
```js
export function assertCanSaveTransfer({ protocolId, contextId, scheduleId } = {}) {
const ctx = String(contextId || protocolId || '').trim()
if (!ctx) {
throw new Error('请先保存后再保存转账记录')
}
if (!String(scheduleId || '').trim()) {
throw new Error('缺少应缴批次,无法保存转账记录')
}
}
```
`canSubmitFinance` / `canWithdrawFinance` 第二个参数语义改为「业务上下文 id」(协议 id 或样本缴费 id),保持签名 `(transfer, contextId)`,调用方传 `props.protocolId` 或 `props.samplePaymentId` 即可。错误文案若协议侧测试依赖「请先保存协议…」,则:
```js
if (!ctx) {
throw new Error(
protocolId != null || contextId == null
? '请先保存协议后再保存转账记录'
: '缺少缴费上下文,无法保存转账记录'
)
}
```
更稳妥:保持协议旧文案当仅传 `protocolId`;传 `contextId` 时用中性文案。更新测试断言与之一致。
- [ ] **Step 4: 跑测通过并 Commit**
```bash
cd mobile-oa-h5 && node --test src/market/protocol-sample-transfer.test.js
git add mobile-oa-h5/src/market/protocol-sample-transfer.js \
mobile-oa-h5/src/market/protocol-sample-transfer.test.js
git commit -m "$(cat <<'EOF'
refactor(mobile-oa-h5): allow transfer helpers to use payment contextId
EOF
)"
```
---
### Task 4: 抽出 `ScheduleTransferEditor` 并接到协议面板
**Files:**
- Create: `mobile-oa-h5/src/market/components/ScheduleTransferEditor.vue`
- Modify: `mobile-oa-h5/src/market/components/ProtocolSamplePaymentPanel.vue`
- Modify: `mobile-oa-h5/src/market/mobile-parity-ui.test.js` / `protocol-mobile-parity.test.js`
- [ ] **Step 1: 写失败契约测试**
```js
test('ScheduleTransferEditor exposes save submit withdraw and MarketAttachmentCards', async () => {
const src = await readFile(
new URL('./components/ScheduleTransferEditor.vue', import.meta.url),
'utf8'
)
assert.match(src, /MarketAttachmentCards|PresignAttachmentUploader/)
assert.match(src, /提交财务/)
assert.match(src, /撤回/)
assert.match(src, /添加转账/)
})
```
- [ ] **Step 2: 跑测确认失败**
- [ ] **Step 3: 创建 `ScheduleTransferEditor.vue`**
Props(最小集):
```js
defineProps({
schedule: { type: Object, required: true },
transferTypes: { type: Array, default: () => [] },
marketRole: { type: String, required: true },
contextId: { type: String, required: true }, // protocolId 或 samplePaymentId
disabled: { type: Boolean, default: false }
})
defineEmits(['update:schedule', 'changed'])
```
行为从 `ProtocolSamplePaymentPanel` 迁入(按期次单份):
- `emptyTransferRow` / `validateTransferRow` / `buildTransferSavePayload` / `applySavedTransfer`
- `canAdd` / `canEdit` / `canDelete` / `canSubmit` / `canWithdraw`(用 `canUseProtocolScheduleAction` / `canUseProtocolTransferAction`)
- UI:转账卡片字段 + `PresignAttachmentUploader`(内部即 `MarketAttachmentCards`)
- API:`performMarketAction(context, 'register-transfer'|'edit-transfer'|…)`,`context = { marketRole, module: 'payment' }`(与现面板一致)
- 保存:`data: { scheduleId: schedule.id, ...payload }`;创建用 `register-transfer`,更新用带 id 的 update
从面板剪切转账相关 template/script 时,保持按钮文案与确认框与现网一致。
- [ ] **Step 4: `ProtocolSamplePaymentPanel` 每期改为**
```vue
<ScheduleTransferEditor
:schedule="sch"
:transfer-types="transferTypes"
:market-role="marketRole"
:context-id="protocolId"
:disabled="disabled || !canManageTransfers"
@update:schedule="(next) => replaceSchedule(pIdx, sIdx, next)"
@changed="onTransferChanged"
/>
```
实现 `replaceSchedule`:写回 `modelValue[pIdx].schedules[sIdx]` 并 `emit('update:modelValue')` / dirty 事件。
- [ ] **Step 5: 跑协议相关测通过并 Commit**
```bash
cd mobile-oa-h5 && node --test \
src/market/protocol-sample-transfer.test.js \
src/market/protocol-mobile-parity.test.js \
src/market/mobile-parity-ui.test.js
```
```bash
git add mobile-oa-h5/src/market/components/ScheduleTransferEditor.vue \
mobile-oa-h5/src/market/components/ProtocolSamplePaymentPanel.vue \
mobile-oa-h5/src/market/*.test.js
git commit -m "$(cat <<'EOF'
refactor(mobile-oa-h5): extract ScheduleTransferEditor for shared transfer UI
EOF
)"
```
---
### Task 5: `PaymentDetailTransfersPanel` + 挂到缴费详情
**Files:**
- Create: `mobile-oa-h5/src/market/components/PaymentDetailTransfersPanel.vue`
- Modify: `mobile-oa-h5/src/views/market/MarketModuleDetail.vue`
- Modify: `mobile-oa-h5/src/market/action-policy.js` 或 Detail 内过滤:缴费详情不展示转账底栏动作
- Modify: tests
- [ ] **Step 1: 写失败契约测试**
```js
test('payment detail hosts PaymentDetailTransfersPanel and hides transfer bottom actions', async () => {
const detail = await readFile(new URL('../views/market/MarketModuleDetail.vue', import.meta.url), 'utf8')
assert.match(detail, /PaymentDetailTransfersPanel/)
assert.match(detail, /filterPaymentDetailBottomActions|PAYMENT_TRANSFER_BOTTOM/)
})
```
- [ ] **Step 2: 实现 `PaymentDetailTransfersPanel.vue`**
- Props:`detail`(缴费详情)、`marketRole`、`transferTypes`(可由父组件拉取字典,或面板内 `onMounted` 拉与 Form 相同的转账方式字典——优先父组件传入,与 Form 一致)
- 模板:
1. 摘要区(客户、样本、方式 Tag、合同额、已缴/待缴、进度)——字段取自 `detail` 现有键(对齐 `modules/payment.js` detailSections 摘要)
2. 「应缴批次」标题
3. `v-for="sch in detail.schedules"`:期头只读(第 N 期 · 应缴 · 应缴日 · 已缴 · 欠缴 + 状态 Tag)+ `ScheduleTransferEditor`
- `@changed`:调用父级 `reloadDetail`(emit `refresh`)
样式类名跟现有 `market-detail-*` / Demo 期次卡,勿引入 Web mint 色;用三墙 token。
- [ ] **Step 3: 挂载到 `MarketModuleDetail`**
当 `context.module === 'payment'` 且已加载 `detail`:
```vue
<PaymentDetailTransfersPanel
v-if="context.module === 'payment' && detail"
:detail="detail"
:market-role="context.marketRole"
:transfer-types="paymentTransferTypes"
@refresh="loadDetail"
/>
```
只读 `detailSections` 中「应缴批次 / 转账」重复展示时:对 payment 模块 **跳过** 会重复的 schedule 分区——做法二选一(本计划固定选 A):
- **A(推荐)**:payment 模块详情 **不再渲染** `detailSections` 里的批次转账卡片,仅渲染摘要类 section + `PaymentDetailTransfersPanel`;或 `detailSections` 只返回非 schedule 的概览 section。
- 实现:在 `modules/payment.js` 的 `detailSections` 去掉 schedule 嵌套卡,改为仅概览字段;转账全由 Panel 负责。
- [ ] **Step 4: 隐藏缴费详情底栏转账动作**
在 `payment-entry.js` 增加:
```js
const PAYMENT_TRANSFER_BOTTOM_CODES = new Set([
'register-transfer',
'edit-transfer',
'delete-payment-transfer',
'submit',
'withdraw'
])
export function filterPaymentDetailBottomActions(actions) {
return (Array.isArray(actions) ? actions : []).filter(
(action) => !PAYMENT_TRANSFER_BOTTOM_CODES.has(actionCode(action))
)
}
```
`MarketModuleDetail`:
```js
if (context.value.module === 'payment') {
return filterPaymentDetailBottomActions(raw)
}
```
并为该函数补单测。
转账方式字典:复用 Form 拉取逻辑(查 `MarketModuleForm` 中 transferTypes 来源,抽一小函数或在 Detail `onMounted` 同样请求)。若 Detail 暂无字典 API,可从 `detail` 无关的全局字典接口复制 Form 现有调用。
- [ ] **Step 5: 跑测 + Commit**
```bash
cd mobile-oa-h5 && node --test src/market/payment-entry.test.js \
src/market/protocol-sample-transfer.test.js \
src/market/mobile-parity-ui.test.js \
src/market/module-contracts.test.js \
src/market/module-actions.test.js
```
```bash
git add mobile-oa-h5/src/market/components/PaymentDetailTransfersPanel.vue \
mobile-oa-h5/src/market/modules/payment.js \
mobile-oa-h5/src/market/payment-entry.js \
mobile-oa-h5/src/views/market/MarketModuleDetail.vue \
mobile-oa-h5/src/market/*.test.js
git commit -m "$(cat <<'EOF'
feat(mobile-oa-h5): inline payment detail transfers aligned with web dialog
EOF
)"
```
---
### Task 6: 手工验收清单 + 收尾
- [ ] **Step 1: 本地手工验收(专员或经理账号)**
1. 缴费列表 →「协议单」:分区与协议模块详情一致;底栏无编辑/删除;附件为标准卡片且只读。
2. 从「协议单」模块进同一协议:仍可编辑(无 `from=payment`)。
3. 缴费列表 →「缴费明细」:摘要 + 各期;欠缴期可添加转账;凭证为虚线「添加」卡片。
4. 保存 → 提交财务 → 状态确认中且锁定 → 撤回 → 可再改。
5. 已付款转账无操作按钮。
6. 底栏不再出现「登记转账 / 提交财务确认」等转账入口。
- [ ] **Step 2: 全量相关自动化**
```bash
cd mobile-oa-h5 && node --test src/market/**/*.test.js src/market/presign/**/*.test.js
```
Expected: 全部 PASS(若有与旧「跳转表单」强耦合的断言,按新主路径更新断言,勿保留双路径要求)。
- [ ] **Step 3: Commit 测试/文案修正(若有)**
```bash
git add -u mobile-oa-h5
git commit -m "$(cat <<'EOF'
test(mobile-oa-h5): align payment detail parity contracts with inline transfers
EOF
)"
```
---
## Spec coverage(自检)
| Spec 要求 | Task |
|-----------|------|
| 协议复用详情 + `from=payment` 隐藏编辑/删除 | 1–2 |
| 附件 MarketAttachmentCards | 4–5(Uploader/Cards) |
| 缴费明细同屏应缴只读 + 转账可写 | 4–5 |
| 保存/提交财务/撤回/删除 | 4–5(复用协议面板逻辑) |
| 去掉缴费详情转账底栏主路径 | 5 |
| 不改应缴计划 / 不做移动财务确认 | 非目标,无 Task |
| 复用 payment-transfers API | 4–5 |
| Demo/spec 已存在 | 文档,实现不改决策 |
## Placeholder scan
无 TBD;`transferTypes` 拉取指向 Form 既有实现;`detailSections` 去重选 A 已写死。
## Type / 命名一致性
- Query:`from=payment`
- 共享组件:`ScheduleTransferEditor`
- 缴费面板:`PaymentDetailTransfersPanel`
- 上下文 id:`contextId`(协议 `protocolId` 或缴费 `detail.id` / samplePaymentId)
- 过滤:`filterProtocolActionsForPaymentEntry`、`filterPaymentDetailBottomActions`
@@ -0,0 +1,175 @@
# 采集协议单状态变更记录 · 方案 A 实现计划
> **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:** 新增两张追加写历史表(细胞存储 / 科研捐赠),状态变更写路径在更新主表「最新快照字段」的同时插入历史行;详情与移动端只读改为拉历史列表。主表 `effective_*` / `expire_*` / `void_*` / `to_research_*`(捐赠侧 `to_storage_*`)保留为最新快照,供列表筛选与兼容旧数据。
**Tech Stack:** MySQL 5.7 · FastAPI/SQLAlchemy · Vue 3 web-admin · mobile-oa-h5
**UI 定稿:** [docs/demos/2026-10-17-protocol-status-change-records-demo.html](../../demos/2026-10-17-protocol-status-change-records-demo.html) 方案 A(表格流水)
**范围默认:** 细胞存储采集协议单 + 科研捐赠协议单(统一页两个 Tab);移动端详情只读同步。
---
## 文件与职责
| 路径 | 职责 |
|------|------|
| `docs/sql/migrations/2026-10-17-protocol-status-change-log.sql` | 建表 + 从主表快照回填首条历史 |
| `backend/app/models/models.py`(或 donation 模型文件) | `BizProtocolStatusChange` / `BizDonationStatusChange` |
| `backend/app/crud/collection_protocol.py` | 状态变更时写历史;list 历史 API 支撑 |
| `backend/app/crud/research_donation.py` | `change_status` / `convert_from_storage` 写历史;list 历史 |
| `backend/app/api/collection_protocol.py` | `GET .../status-changes` |
| `backend/app/api/research_donation.py` | `GET .../status-changes` |
| `web-admin/.../ProtocolViewDialog.vue` | 表格替换 `data-grid--4` |
| `web-admin/.../DonationViewDialog.vue` | 同上 |
| `web-admin/src/api/collection-protocol.ts` / `research-donation.ts` | 列表 API |
| `mobile-oa-h5/src/market/modules/protocol.js` | 状态变更区块改为行列表(或表格字段集) |
| `backend/tests/test_protocol_status_change_history.py`(新建) | 追加不覆盖 + 回填语义 |
---
## 数据模型
### `biz_protocol_status_change`(细胞存储)
字段顺序:`id` → 业务字段 → 公共字段(对齐 database-conventions)。
| 字段 | 说明 |
|------|------|
| `id` | VARCHAR(64) UUID |
| `collection_protocol_id` | 协议单 ID |
| `change_type` | `activate` / `expire` / `void` / `to_research` |
| `from_status` | 变更前状态码 |
| `to_status` | 变更后状态码(`sxz`/`ygq`/`yzf`/`zky`) |
| `change_time` | 业务时间(表单选择的时间) |
| `change_desc` | 描述 |
| `void_type` | 作废类型(仅 void,可空) |
| `operator_user_id` | 操作人 |
| `tenant_no` … `del_flag` | 公共字段 |
索引:`(tenant_no, collection_protocol_id, del_flag, change_time)`。
### `biz_donation_status_change`(科研捐赠)
对称设计:`research_donation_id` + `change_type`(`activate`/`expire`/`void`/`to_storage`)。
### 回填规则(一次性 SQL)
对主表已有非空时间字段,各插入 1 条历史(`from_status` 可空或按常识推断;`create_by`/`operator` 用协议 `update_by`):
- `effective_time` → `activate`
- `expire_time` → `expire`
- `void_time` → `void`(带 `void_type`)
- `to_research_time` / `to_storage_time` → 对应类型
回填后主表快照字段**不删不改**。
---
## 写路径(追加不覆盖)
```mermaid
flowchart LR
UI[StatusChangeDialog] --> API[update / status-change / convert]
API --> Snap[更新主表最新快照字段]
API --> Log[INSERT 历史行]
Snap --> DB[(MySQL)]
Log --> DB
Detail[ViewDialog / Mobile] --> ListAPI[GET status-changes]
ListAPI --> DB
```
1. **细胞存储生效/过期/作废**:现有 `fetchUpdateCollectionProtocol` 写 `protocolStatus` + 时间描述。在 `update_collection_protocol` 中,当 `protocol_status` 实际变更且对应时间字段被写入时,插入历史行(记录 `from_status`/`to_status`)。
2. **转科研**:`convert_from_storage` 写 `to_research_*` 时同步插历史。
3. **科研捐赠**:`change_status` 每次成功变更插历史;转细胞存储对称处理。
4. 纯编辑其它字段(附件等)**不**写历史。
列表排序:`change_time ASC, create_time ASC`(与 Demo 时间线一致;若产品要最新在上可改为 DESC,前后端统一)。
---
## 前端展示(方案 A)
列(对齐 Demo / 审核记录):
| 列 | 来源 |
|----|------|
| 序号 | index |
| 变更类型 | Tag:`activate→生效` / `expire→过期` / `void→作废` / `to_research→转科研` / `to_storage→转细胞存储` |
| 变更时间 | `changeTime` |
| 状态流转 | `fromLabel → toLabel`(用现有 `protocolStatusDisplayLabel`) |
| 变更说明 | `changeDesc`;作废时前缀「作废类型:xxx;」 |
| 操作人 | 用户昵称 |
空态:`暂无状态变更记录`(`el-table` empty-text)。
去掉现有 `data-grid data-grid--4` 快照拼盘;`hasAnyStatusChange` 改为 `statusChangeRecords.length > 0`。
---
## 任务清单
### Task 1:建表 SQL + 回填
- [x] 编写 `docs/sql/migrations/2026-10-17-protocol-status-change-log.sql`
- [x] 含两张表 CREATE + 从 `biz_collection_protocol` / `biz_research_donation` 回填 INSERT
- [ ] 本地/测试库执行验证行数合理(需在目标库手工执行 migration)
### Task 2:后端模型 + CRUD 写历史
- [x] 增加 SQLAlchemy 模型
- [x] `update_collection_protocol`:状态相关字段写入时 append log
- [x] `convert_from_storage`:append `to_research`
- [x] `change_status`(捐赠):append log
- [x] 捐赠转存储路径若有对称写字段,一并 append
### Task 3:列表 API
- [x] `GET /web/admin/collection-protocols/{id}/status-changes`
- [x] `GET /web/admin/research-donations/{id}/status-changes`
- [x] 返回字段 camelCase;附带 `operatorUserName`;租户隔离 + 软删过滤
- [x] 注册路由(已有 router 模块内新增,无需改 main)
### Task 4:后端测试
- [x] 同类型连续两次变更 → 历史 2 行,主表快照为第二次
- [x] 详情 list API 返回顺序与条数正确(CRUD list 覆盖)
- [x] `pytest` 相关用例通过
### Task 5:web-admin 详情
- [x] `ProtocolViewDialog`:加载历史 + 方案 A 表格
- [x] `DonationViewDialog`:同上
- [x] API 封装
### Task 6:移动端只读对齐
- [x] `mobile-oa-h5` protocol module `statusChange` 区块改为多行记录(非扁平字段)
- [x] 更新 `protocol-mobile-parity` / `mobile-parity-ui` 相关断言
### Task 7:验证与图谱
- [ ] 手动:审核页两个 Tab 打开详情,做两次过期类变更,确认两条都在(需先执行 SQL)
- [x] `./scripts/update-graph.sh all`
---
## 非目标
- 不改状态机合法流转规则(仍用 `assert_protocol_status_transition`)
- 不删除主表快照列
- 不在本迭代做历史编辑/删除 UI
- 不改审核记录表
---
## 验收标准
1. 详情「状态变更记录」为单行表格,不再出现四列网格挤行。
2. 同类型变更第二次后,历史中仍可见第一次。
3. 细胞存储与科研捐赠行为一致。
4. 旧数据经回填后至少能看到各类「最后一次」快照对应的一条历史。
@@ -0,0 +1,20 @@
# OA 已办中心补齐打印按钮
## Goal
在 Web 管理端与小程序【已办中心】补齐与「我发起的 / 抄送我的 / 提到我的」一致的打印能力。
## Scope
- In: `web-admin` `oa-approval/done` 列表操作列「打印」
- In: `mobile-h5` `pages/oa/done` 长按 ActionSheet「打印」→ `autoPrint=1`
- Out: 详情页改动、PDF 模板改动、其它已具备打印的列表页
## Behavior
- Web:拉 `fetchOaInstanceDetail(instanceId)` → `exportOaApprovalPdf`
- 小程序:对齐 `mine` 长按菜单,仅「打印」一项(已办无「复制并重新发起」)
## ID
已办行主键用 `row.instanceId`(与现有「查看」一致);Web 兼容 `instanceId || id`。
@@ -0,0 +1,110 @@
# 安全扫描与弱密码刷新设计
日期:2026-10-16
状态:待评审
## 背景与目标
业务方要求:
1. 对项目做安全扫描,重点关注 SQL 注入、XSS 等常见 Web 安全问题。
2. 将库中密码明文等价于弱密码 `111111` 的用户,统一改为强密码 `Zkxw@123`。
本次交付:**只出报告、不改业务代码**;弱密码另附可执行刷新脚本/SQL。
## 决策摘要
| 项 | 决策 |
|----|------|
| 扫描方式 | 方案 A:静态代码审计(人工 + 定向检索) |
| 扫描交付 | Markdown 报告:问题清单 + 风险等级 + 文件位置 + 简述与建议 |
| 代码修复 | 本次不做;报告中给出建议,后续另开任务 |
| 弱密码目标 | `111111` → `Zkxw@123` |
| 弱密码识别 | 因 bcrypt 随机盐,须用应用侧 `bcrypt.checkpw` 校验,不能纯 SQL `WHERE password='111111'` |
| 弱密码范围 | `sys_user`,`del_flag = 0`;**含已禁用用户**(`status != '1'` 也刷新,避免复用账号时残留弱口令) |
## 1. 安全扫描
### 1.1 范围
**纳入:**
- `backend/app/`:原始 SQL / `text()`、字符串拼接查询、动态 SQL(含工作流审批人 SQL 策略)、鉴权与敏感接口相关模式
- `web-admin/src/`:`v-html`、未消毒 HTML、`innerHTML` 等 XSS 相关用法
- 业务相关前端(如 `mobile-oa-h5/src/`、`mobile-h5/`、`miniprogram/` 中同类模式,若存在)
**排除:**
- `backend/venv/`、`node_modules/`、第三方静态资源(如 `web-admin/public/tinymce/`)
- 纯 Demo / mockup HTML(`docs/**` 演示页、`mobile-ui/**` 等),除非被生产路径引用
### 1.2 检查类别(至少覆盖)
| 类别 | 关注点 |
|------|--------|
| SQL 注入 | `text()` + 用户可控拼接;`f"...SELECT..."`;`%` / `.format` 拼 SQL;工作流 `strategy=sql` |
| XSS | `v-html` 是否经 `sanitizeHtml`/DOMPurify;未消毒的 `innerHTML` |
| 认证/口令(信息项) | 默认弱口令文档、明文登录开关等(记入报告,不强制本次改代码) |
| 其他高信号 | 硬编码密钥/口令、危险 `eval`/`new Function`(业务代码) |
### 1.3 风险等级
- **高**:可被外部/低权限用户直接利用,导致读改删数据或执行脚本
- **中**:需特定权限/配置或利用链较长,仍有实质影响
- **低**:防御不完善但当前利用面小,或仅内部可控场景
- **信息**:加固建议、文档/默认配置风险,非直接漏洞
### 1.4 报告格式与路径
路径:`docs/testing/2026-10-16-security-scan-report.md`
每条问题包含:
1. 标题
2. 风险等级
3. 文件位置(路径 + 尽量到函数/行号)
4. 问题简述
5. 修复建议(文字,不直接改代码)
报告末尾附:扫描方法说明、覆盖范围、已知局限(静态审计无法替代动态渗透)。
## 2. 弱密码刷新
### 2.1 约束
- `sys_user.password` 存 **bcrypt**(`$2b$...`),每次哈希盐不同。
- 无法用单条 `UPDATE ... WHERE password = '111111'` 命中所有弱密码用户。
- 新密码明文:`Zkxw@123`(写入运维说明;哈希由脚本生成)。
### 2.2 交付物
| 文件 | 作用 |
|------|------|
| `backend/scripts/reset_weak_password_111111.py` | **主路径**:连接当前环境库,逐用户 `verify` 是否为 `111111`,命中则更新为 `Zkxw@123` 的新 bcrypt 哈希;打印命中 `user_no` / 数量;支持 `--dry-run` |
| `docs/sql/2026-10-16-reset-weak-password-111111.sql` | **辅助**:说明为何不能纯 SQL 筛选;给出预生成示例哈希与单条 `UPDATE` 模板;引导使用上述 Python 脚本 |
### 2.3 脚本行为
1. 读取环境 DB 配置(与现有 backend 一致:`.env` / `.env.local` 等)。
2. 查询 `sys_user`:`del_flag = 0`,取出 `id, user_no, password, status`。
3. 对每条用 bcrypt 校验明文 `111111`;命中则 `password = bcrypt(Zkxw@123)`,更新 `update_time`(若列存在)。
4. 默认提交事务;`--dry-run` 只列出将修改的账号。
5. 不修改业务应用代码、不重置非 `111111` 的密码。
### 2.4 运维注意
- 执行前备份 `sys_user` 或整库。
- 执行后通知相关用户使用新密码,并建议首次登录后自行修改。
- 文档中的默认账号说明(如 `admin` / `111111`)后续由文档任务单独更新(本次可不改 AGENTS.md,可在报告「信息」项列出)。
## 3. 非目标
- 不修复报告中的代码漏洞
- 不做完整渗透测试、依赖 CVE 全量扫描、基础设施扫描
- 不批量重置「所有用户」密码,仅命中弱密码 `111111` 的用户
## 4. 验收标准
1. 存在上述安全扫描报告,且至少覆盖 SQL 注入与 XSS 两类检索结论(含「未发现」亦需写明检索范围)。
2. 存在弱密码 Python 脚本与 SQL 说明文件;`--dry-run` 可列出命中用户;正式执行后原 `111111` 用户可用 `Zkxw@123` 登录。
3. 业务源码无功能性改动(仅新增 docs/scripts/sql 交付物)。
@@ -0,0 +1,170 @@
# 移动端缴费信息 · 协议只读 + 缴费明细同屏转账(对齐 Web)
**日期:** 2026-10-17
**状态:** 设计已确认(待实现)
**Demo:** `docs/demos/2026-10-17-mobile-payment-detail-parity-demo.html`
**实现路径:** 方案 1 — 复用现有协议详情路由 + 缴费详情内嵌转账区
**对齐权威:**
- Web:`docs/superpowers/specs/2026-10-10-payment-info-detail-list-mode-design.md`
- 移动转账视觉:`docs/superpowers/specs/2026-10-14-payment-detail-transfer-display-design.md`
- 协议内转账:`ProtocolSamplePaymentPanel.vue`、`MarketAttachmentCards.vue`
## 1. 背景与目标
### 1.1 现状
地区经理 / 市场专员在 `mobile-oa-h5`「缴费信息」列表有两个操作:
| 按钮 | 现状 | 问题 |
|------|------|------|
| 协议单 | 已跳转 `protocol-detail` | 详情底栏仍可能出现编辑等写动作;产品要求从缴费入口只能看 |
| 缴费明细 | 只读分区 + 底栏跳独立表单登记/编辑转账 | 与 Web「缴费明细」弹窗(同屏期次下转账)交互不一致 |
`mobile-h5` 仅为 WebView 壳,无独立业务实现;改动落在 `mobile-oa-h5`。
### 1.2 目标
1. **协议单**:打开与小程序「协议单」模块**同一套详情界面**;从缴费入口进入时**完全隐藏编辑 / 删除**(决策 A)。
2. **缴费明细**:对齐 Web 缴费信息页「缴费明细」弹窗语义——应缴只读;每一期可增加转账记录,支持保存、提交财务审核、撤回、删除草稿。
3. **附件**:协议详情与转账凭证统一使用小程序标准附件卡片(`MarketAttachmentCards`,与协议单新增一致)。
### 1.3 已确认决策
| 项 | 决策 |
|----|------|
| 实现路径 | **方案 1**:复用现有页面/组件,不新建第二套协议详情 |
| 协议入口写动作 | **A**:完全隐藏编辑/删除;改协议去「协议单」模块 |
| 缴费明细 UX | 同屏期次下转账可写(Demo 第 3 Tab);非跳转独立表单为主路径 |
| 附件样式 | `MarketAttachmentCards`(84×84;可写态虚线「添加」+ 删除角标;只读态无添加/删除,保留预览/下载) |
| 专员 vs 经理 | 缴费写能力同权;仅数据范围不同 |
| 后端 | 复用现有 market `payment-transfers` API,不新增资源模型 |
## 2. 信息架构
```
缴费信息列表(specialist | manager)
├─「协议单」
│ → market-{role}-protocol-detail
│ → query 增加来源标记 from=payment
│ → MarketModuleDetail + protocol.detailSections
│ → 过滤 edit / delete;无写动作时可隐藏底栏
│
└─「缴费明细」
→ market-{role}-payment-detail
→ 摘要 + 应缴批次只读
→ 每期内嵌转账卡片(可写)
→ 凭证 = MarketAttachmentCards
```
### 2.1 产品边界(不变)
- 不在缴费菜单修改应缴计划(趸交/分期方案仍在协议单编辑内改)。
- 财务确认 / 拒绝仅 Web「缴费财务确认」。
- 不改 Web 缴费明细弹窗本身。
## 3. 界面与交互
### 3.1 协议单(只读压制)
- 跳转仍复用 `MarketModuleList.openProtocol`,附加 query:`from=payment`(固定键名,不做别名)。
- `MarketModuleDetail`:当 `route.query.from === 'payment'` 时,`allowedActions` 排除 `edit`、`delete` 及任何写协议动作。
- 详情分区、附件与「协议单」模块详情一致(协议信息 / 采集 / 客户 / 样本 / 缴费摘要 / 退费 / 审核 / 附件等)。
- 附件:`MarketAttachmentCards` 且 `editable=false`。
- **不**新建独立协议只读页。
### 3.2 缴费明细(同屏转账)
对齐 Web 样本缴费详情弹窗 + 移动 Demo:
1. **摘要区**:客户、样本编码、缴费方式 Tag、合同额、已缴/待缴、整体进度、缴费进度 Tag。
2. **应缴批次**:按 `scheduleNo` 升序;期头只读(应缴、应缴日、已缴、欠缴、状态 Tag)。
3. **添加转账**:`arrearsAmount > 0` 且业务允许时显示;已缴清期不显示添加。
4. **转账卡片**(列表模式语义,移动为卡片而非表格):
| 字段 | 可编辑条件 |
|------|------------|
| 转账方式 | 非锁定(非 `jfqrz` / `yjf`) |
| 转账金额 | 同上 |
| 转账时间 | 同上 |
| 转账凭证 | 同上;`MarketAttachmentCards` / `PresignAttachmentUploader` |
| 备注 | 同上 |
| 财务备注 | 只读 |
| 状态 | Tag:`dfj` / `jfqrz` / `yjf` |
| 状态 | 操作 |
|------|------|
| `dfj`(含未落库草稿) | 保存;有 id 可提交财务;可删除 |
| `jfqrz` | 仅撤回 |
| `yjf` | 无操作(—) |
校验与文案对齐 `ProtocolSamplePaymentPanel`:
- 转账方式必填;金额 > 0。
- 上传中禁止保存。
- 未保存不可提交 → Toast「请先保存该转账记录后再提交财务确认」。
- 提交 / 撤回 / 删除需二次确认。
### 3.3 与现有底栏动作
同屏可写落地后,缴费详情底栏**不再展示** `register-transfer` / `edit-transfer` / `submit` / `withdraw` / `delete-payment-transfer` 等转账相关动作(避免双路径)。API 仍由同屏面板直接调用。
## 4. 组件与数据流
### 4.1 组件职责
| 单元 | 职责 |
|------|------|
| `MarketModuleList` | 「协议单」跳转带 `from=payment`;「缴费明细」进 payment-detail |
| `MarketModuleDetail` | `from=payment` 时过滤协议写动作 |
| `ScheduleTransferEditor`(新建共享子组件,从 `ProtocolSamplePaymentPanel` 抽出转账区) | 单期/多样本共用:转账卡片 CRUD、提交/撤回、凭证卡片;**不含**改应缴计划 |
| `PaymentDetailTransfersPanel`(新建,挂在缴费详情) | 拉缴费详情数据;渲染摘要 + 期次头(应缴只读)+ 每期挂载 `ScheduleTransferEditor` |
| `ProtocolSamplePaymentPanel` | 保留配方案 UI;转账区改为组合 `ScheduleTransferEditor`,避免双套状态机 |
| `modules/payment.js` | 配合详情挂载可写面板所需数据;弱化「纯只读 section + 跳表单」主路径 |
| `MarketAttachmentCards` | 协议详情只读附件;转账凭证可写/只读 |
### 4.2 数据流
```
打开缴费明细 → GET /mini/market/{role}/payments/{id}
添加/编辑转账(本地)→ 保存:POST 或 PUT .../payment-transfers
提交财务 → POST .../payment-transfers/{id}/submit → jfqrz
撤回 → POST .../withdraw → dfj
删除草稿 → DELETE(未落库仅本地移除)
成功后刷新详情或 patch 本地行
```
凭证上传:复用现有 market 附件上传策略(accept / maxSize 与协议单新增一致)。
### 4.3 错误与并发
- 接口失败:Toast 展示错误,不静默成功。
- 单行 `busyKey` 防重复点击。
- 校验失败不发请求。
## 5. 测试要点
- `from=payment`:协议详情无 edit/delete;无该标记时行为不变。
- 缴费详情:欠缴期可添加;`dfj` 可保存/提交/删;`jfqrz` 仅撤回;`yjf` 锁定。
- 附件:卡片规格与协议新增一致;详情只读无添加/删除。
- 回归:协议编辑内转账链路仍可用。
- 合约/UI 测试:缴费主路径不再依赖跳转独立转账表单。
## 6. 非目标
- 不改 Web 缴费明细弹窗实现。
- 不开放移动端财务确认/拒绝。
- 不在缴费菜单改分期/趸交方案。
- 不新增后端资源模型。
- `mobile-h5` 无独立业务页改动(壳层入口不变即可)。
## 7. 参考路径
| 类型 | 路径 |
|------|------|
| Demo | `docs/demos/2026-10-17-mobile-payment-detail-parity-demo.html` |
| Web 弹窗 | `web-admin/src/components/business/sample-payment-detail-dialog/index.vue` |
| 移动协议详情分区 | `mobile-oa-h5/src/market/modules/protocol.js` → `detailSections` |
| 移动协议内转账 | `mobile-oa-h5/src/market/components/ProtocolSamplePaymentPanel.vue` |
| 附件标准 | `mobile-oa-h5/src/market/components/MarketAttachmentCards.vue` |
| 缴费列表动作 | `mobile-oa-h5/src/market/list-presenter.js`、`MarketModuleList.vue` |
| 后端 | `backend/app/api/market_mobile.py`、`backend/app/services/market_payment.py` |
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,170 @@
# 存储服务与市场移动端完整性测试报告
测试日期:2026-10-15 至 2026-10-16(Asia/Shanghai);测试对象为本地工作区,不代表生产环境已部署。
## 结论
本轮按照“基线测试 → 复现缺陷 → 制定最小修复方案 → 回归 → 交叉审查 → 真实接口/页面复测”执行。下表列出的已确认缺陷已修复。业务修改限定在指定七个 Web 模块、市场移动页面及对应后端;没有修改 OA、生产、质检等其他模块的业务规则,也没有调整全局权限守卫。
财务真实链路已补验:从数据库查得既有会计账号“张敏”,经正常账号密码登录,完成预签约意向金和正式缴费的页面退回、重新提交、确认及重复操作保护。验收仍存在明确边界:微信真机、网络故障下的原生 web-view、实际对象存储下载和高并发压力未做完整验收。不能将本报告解释为这些场景已经通过,或保证系统不存在任何尚未发现的缺陷。
## 范围与环境
| 端 | 范围 | 实际实现/入口 |
|---|---|---|
| Web | 采集协议单 | `/market/cell-storage/protocol-audit`,协议专用表单/详情/运输组件 |
| Web | 预签约订单 | `/market/cell-storage/presign-order` |
| Web | 缴费信息、催缴信息 | `/market/cell-storage/payment-info`、`payment-chase` |
| Web | 客户服务管理 | `/market/cell-storage/sample-info` |
| Web | 运费信息、缴费财务确认 | `/market/cell-storage/sample-freight`、`payment-confirm` |
| 移动 | 市场专员、地区经理各五模块 | `presign`、`protocol`、`payment`、`payment-chase`、`freight` |
Web 当前菜单名称为“市场 → 存储服务”。小程序工程实际为 `mobile-h5`;市场入口通过 web-view 打开 `mobile-oa-h5`。仓库没有名为 `miniprogram` 的目录。
- 后端:本地端口 8000;最终回归前用原启动命令和原环境重启,加载修复。
- Web:端口 3006;市场 H5:端口 5178、base `/oa-h5/`。
- 真实登录:首轮使用 admin;财务补测从数据库按有效角色/职位授权查询,选择会计账号“张敏”,经 Web 账号密码表单正常登录。没有修改账号密码、角色或菜单权限;凭据和 Token 不写入报告或仓库。后续需其他权限账号时优先直接查询数据库中的既有用户。
- 浏览器:Chrome + Playwright;Web 1440×1000,移动 390×844。
- 权限测试:SQLite 隔离用户、角色、自定义范围及多角色并集。财务状态测试调用真实 CRUD。
- 测试数据:专用 `QA_STORAGE_20261015_…` 标记,未修改已有客户/协议/缴费记录。
## 第一轮缺陷、改造方案与复测
| 编号 | 级别 | 复现/影响 | 实施方案 | 回归证据 |
|---|---|---|---|---|
| QA-01 | P1 | 同租户受限用户可越权读取、修改 Web 运费;关联样本可影响无权批次 | 在批次和样本所属协议应用既有角色数据范围;校验旧关联批次;样本快照由服务器派生 | 运费权限、并集、伪造快照及跨批次用例通过 |
| QA-02 | P1 | 预签约列表有范围限制,详情/编辑/转正式/转账等单条入口缺失同等保护 | 十个入口增加对应订单或转账列表模型的数据范围检查 | 本人、无权、多角色并集三组回归通过 |
| QA-03 | P1 | 直接调用协议审核入口可绕过协议数据范围 | 审核前复用协议可访问性校验 | 越权审核拒绝且不调用写服务 |
| QA-04 | P1 | 新建记录创建部门为空,纯部门范围用户可能创建后无法查看 | 运费、协议、预签约及派生操作从数据库当前用户取得创建部门 | 服务器部门参数回归通过;不信任客户端部门 |
| QA-05 | P2 | Web 预签约传 `2026-10-15` 等非法日期进入 CHAR(8),报数据库 503 | Schema 校验 YYYYMMDD 长度与真实日期 | 修复前 10 失败,修复后日期 18 项通过;真实接口返回 422 |
| QA-06 | P2 | 非有限运费 NaN/Infinity 可导致异常或绕过普通金额检查 | Decimal 有限性校验,负数继续拒绝 | 单元及真实接口错误码 400 验证通过 |
| QA-07 | P2 | V2 协议已有样本缴费和首期时间,列表缴费方式仍显示“—” | 仅协议列表开启 V2 模式汇总;支持混合模式、分改趸 | 五项新回归及真实接口“趸交”标签通过 |
| QA-08 | P2 | 预签约/正式协议清空可选字段后恢复原值 | 将清空意图编码为空串/null,避免 JSON 省略 undefined | 行为回归通过;真实预签约备注清空保存后重新读取为空 |
| QA-09 | P2 | 删除全部协议或转账附件后保存,旧附件恢复 | 不再用旧 URL 覆盖空附件列表,明确发送空值 | 正式/预签约转账、主单附件回归通过 |
| QA-10 | P2 | 上传期间删除前面的附件,上传完成或失败时改错数组项 | 四处上传回填按临时 ID 查找,处理已移除项 | 成功与失败竞态回归通过 |
| QA-11 | P2 | 附件上传未结束就保存或提交财务,凭证可能遗漏 | 保存和提交前检查上传状态 | 上传中拒绝提交回归通过 |
| QA-12 | P1 | 编辑详情失败仍可保存空表单;预签约字典/详情加载期间输入可被覆盖 | 初始化全程加载/禁用与就绪校验;失败提示重开,禁止提交 | 协议详情失败、预签约初始化五项新增回归通过 |
| QA-13 | P2 | 协议运输组件读取不存在的 `formData.id`;编辑后新增沿用旧 editingId | 传真实 editingId,新增初始化清空旧上下文 | 运输 ID 与新增隔离行为回归通过 |
| QA-14 | P2 | 移动协议切地区保留旧经理/医院,慢响应覆盖新地区 | 切换时清旧候选、取消旧请求并验证请求身份 | 新行为测试、两角色真实地区切换通过 |
| QA-15 | P2 | 移动预签约清空地区后 loading 卡住,旧响应回填旧选项 | 清空加载状态、取消请求、忽略旧响应 | 新行为测试、两角色真实地区切换通过 |
另外修正实际引用页面的 18 条类型错误,包括无效导入、金额参数类型和自动完成返回值;未修改闲置的开票/退款 Tab 等范围外代码。
V2 模式汇总通过显式开关限定在协议列表,质检、样本接收等调用保持原有默认行为。权限继续采用所有角色的并集;未把财务权限修改为超级管理员自动绕过。
## 自动化结果
| 检查 | 结果 | 说明 |
|---|---:|---|
| 后端主回归 | 679/679 | 39 个去重文件;新增 81 项 |
| 客服补充回归 | 38/38 | 快捷登记、证书/保险样本级关联、质检信息、办理状态 |
| 移动市场 | 312/312 | 原 307 项,加 5 项地区联动/竞态回归 |
| Web 单元/行为 | 85/85 | 原 54 项,加 31 项表单/附件/初始化回归 |
| Web 既有专用脚本 | 2/2 | 缴费预设、缴费详情弹窗布局 |
| 小程序市场入口脚本 | 通过 | 两角色共十入口、web-view URL/返回路径 |
| 独立交叉审查 | 通过 | 后端相关集合另跑 263 项;属于重复验证,不再累计 |
| `git diff --check` | 通过 | 无补丁空白错误 |
| 市场 H5 生产构建 | 通过 | 既有大包提示 |
| Web 生产构建 | 通过 | 默认 2 GB 堆 OOM;提高到 8 GB 后构建成功,存在既有 Sass/大包提示 |
主回归与客服补充合计 717 个后端用例;加移动、Web 合计 **1,114 个用例通过**。独立审查和重复回归不重复累计。
关键回归文件:
- `backend/tests/test_web_freight_permissions.py`
- `backend/tests/test_web_presign_permissions.py`
- `backend/tests/test_presign_order_date_validation.py`
- `backend/tests/test_protocol_v2_payment_mode_summary.py`
- `backend/tests/test_payment_finance_status_regression.py`
- `web-admin/scripts/test-cell-storage-form-regressions.ts`
- `mobile-oa-h5/src/market/protocol-region-cascade.test.js`
- `mobile-oa-h5/src/market/presign/presign-region-cascade.test.js`
新增测试先观察原实现失败再修复。财务四项是补充覆盖,原状态逻辑本身通过:预签约/样本缴费分别验证确认、退回成功,及重复操作不能覆盖状态。权限测试使用真实隔离数据库查询,写服务用 spy 验证越权时未调用;不将其声称为实际 MySQL 完整写链路。
## 真实页面与业务链路
| 检查项 | 结果与边界 |
|---|---|
| 七个 Web 列表 | 均加载成功;检查脚本错误、HTTP 错误和页面整体横向溢出 |
| 七类 Web 弹窗 | 协议新增、预签约新增、缴费明细、催缴关联协议、客服查看、运费编辑、财务确认弹窗均打开 |
| 十个移动入口 | 两角色五模块均可进入;空数据和有数据状态均有覆盖 |
| 移动四个新增表单 | 两角色×协议/预签约;必填校验通过 |
| 地区联动 | 四地区×四表单 16 轮,另 8 轮有经理→无经理;24 轮均符合实际 API |
| 预签约链路 | 新增、编辑、双角色详情、转账提交/撤回/编辑、转正式;重复转正式拒绝 |
| 协议/缴费链路 | 转正式后增加样本及缴费计划;双角色查看/修改转账、提交、撤回;重复提交拒绝 |
| 催缴 | 逾期测试期次出现;查看缴费关联正确 |
| 运费 | 创建、修改、双角色读取;金额边界拒绝 |
| 客服 | 短信、微生物回访、履约登记后重新查询,三组字段均持久化 |
| 表单实际保存 | 浏览器新增预签约,再分别编辑预签约、正式协议清空备注,API 重新读取确认为空;正式协议最后复测无页面/API错误 |
| 最终真实 API 专项 | 24/24 检查通过,包括 V2 标签、日期、金额、状态保护、十入口 |
| 无效请求 | 10/10 拒绝检查:未登录、非法分页、不存在记录;无数据泄露 |
移动地区选择器没有“清空”操作入口;清空地区的竞态仅有行为测试覆盖,没有计为真实点击通过。首轮 admin 被严格财务权限拒绝;补测已用既有会计账号完成真实成功流程,所有财务写操作只针对本轮新建的 QA 记录。
## 财务权限账号补测(2026-10-16)
使用既有“会计”角色用户“张敏”正常登录本地 Web。数据库权限解析覆盖直接角色和职位继承角色;没有变更权限配置。专用数据标记为 `QA_FINANCE_20261016_1792081469569`。
| 验证 | 结果 |
|---|---|
| 意向金实际页面退回、重新提交、确认 | 通过;状态依次为 `jfqrz → dfj → jfqrz → yjf` |
| 正式缴费实际页面退回、重新提交、确认 | 通过;状态同上 |
| 两类转账在退回后再次退回/确认、确认后再次确认/退回 | 8 次非法操作均返回业务码 400;原金额及财务备注未被覆盖 |
| 待确认与已确认列表 | 已确认记录从待确认移除,出现在已确认列表;财务备注正确 |
| 金额与欠款汇总 | 意向金确认 12 元;正式缴费确认 30 元,100 元期次剩余 70 元;重复操作没有重复计款 |
| MySQL 持久化 | 两类转账均为 `yjf`,更新人为所用会计用户,财务备注保存正确 |
| 浏览器错误 | 4 次实际页面财务动作通过,页面脚本错误 0 条 |
本次补测 24 次 API 检查和 4 次页面财务提交全部通过(不并入前文 1,114 个隔离/行为用例计数),未发现需要新增代码修复的问题。9 条本次有效测试行按精确 ID/标记软删除,5 个相关列表回查为 0;测试会话已登出,本机临时凭据已移除。原始验证摘要附在证据 JSON 的 `financeFollowup` 字段。
## 构建、历史问题与验收限制
1. **真实财务权限(已补验)**:admin 的超级管理员标记不能替代严格菜单授权,403 规则保留。已从数据库找到具有显式权限的既有会计账号“张敏”,完成以下真实页面/API/MySQL 验证,此项不再是待验收限制。
2. **Web 全量类型检查**:默认堆内存不足;8 GB 重跑完成,错误由 415 条降至 397 条,已修改文件无错误。剩余来自未修改模块及闲置旧组件,未按“全仓通过”报告。
3. **字段一致性脚本**:执行结果 0 errors、5 warnings,退出码 1。警告来自未修改的 consumable/reagent/material/qc_material/sop_document 的 orderNum 或旧前端路径,未扩大范围修复。
4. **历史部门字段**:未擅自回填已有 `create_dept_id=''` 数据;其在纯部门数据范围下可能不可见。若要修复历史记录,需要基于创建人部门核对后单独制定数据迁移。
5. **知识图谱**:已执行 backend/frontend 更新脚本。后端节点过多,工具跳过 HTML;前端 JSON 节点缩减触发保护,旧 JSON 保留,报告/HTML 已生成。未强制覆盖可能含人工补充的节点。脚本没有 mobile-oa-h5 目标。
6. **环境瞬断**:跨午夜时后端日志记录远程 MySQL 拒绝连接,导致列表刷新一度 503。连接恢复后重测原页面及协议保存通过,未修改网络或数据库配置。
7. **未覆盖的外部环境**:微信真机/正式域名、真实附件上传下载的全面验证、并发压力及生产数据库部署不在本轮已通过清单内。
## 测试数据清理
本次创建的 16 条有效测试行(含自动生成的客户、关联子表与测试运输字典项)已按精确 ID/标记软删除,未物理删除。六个业务列表按测试标记回查均返回 0 条。保留正常审计日志和业务编号流水,不回退序号。财务补测另创建并清理 9 条有效行,见财务补测小节。
## 复测命令
后端主回归(先去重 glob,避免重复计数):
```bash
cd backend
venv/bin/python - <<'PY'
from glob import glob
import subprocess
patterns = [
'tests/test_*protocol*.py', 'tests/test_*payment*.py',
'tests/test_*presign*.py', 'tests/test_*freight*.py',
'tests/test_*customer_service*.py',
'tests/test_market_mobile_permissions.py',
'tests/test_market_field_scope.py',
]
files = sorted({f for p in patterns for f in glob(p)})
raise SystemExit(subprocess.call(['venv/bin/python', '-m', 'pytest', '-q', '--tb=short', *files]))
PY
venv/bin/python -m pytest -q tests/test_sample_info_quick_register.py tests/test_sample_cert_insurance_sample_level.py tests/test_sample_storage_cert_qc.py tests/test_sample_info_handle.py tests/test_sample_info_progress.py
```
```bash
cd web-admin
pnpm exec tsx --test scripts/test-cell-storage-form-regressions.ts
NODE_OPTIONS=--max-old-space-size=8192 pnpm exec vue-tsc --noEmit
cd ../mobile-oa-h5
node --test src/market/*.test.js src/market/presign/*.test.js
pnpm build
cd ..
node mobile-h5/utils/market-h5.test.js
```
修复计划见 `docs/superpowers/plans/2026-10-15-storage-market-completeness.md`。测试证据摘要另存同目录 JSON;原始本机日志及截图在 `/tmp/zkxw-storage-qa/`,含页面业务数据的截图未收入仓库。
@@ -0,0 +1,137 @@
# 安全扫描报告(静态审计)
日期:2026-10-16
方法:方案 A — 静态代码检索 + 关键路径人工研判
范围:`backend/app/`、`web-admin/src/`、`mobile-oa-h5/src/`、`mobile-h5/`、`miniprogram/`(业务源码)
排除:`venv/`、`node_modules/`、`web-admin/public/tinymce/`、纯 Demo HTML
**本次不改业务代码**;下列「建议」供后续专项修复使用。
## 摘要
| 风险 | 数量 |
|------|------|
| 高 | 0 |
| 中 | 2 |
| 低 | 3 |
| 信息 | 4 |
结论概要:
- **未发现**典型的「用户输入直接拼进 SQL 字符串」的经典 SQL 注入(业务 CRUD 大量使用 SQLAlchemy ORM / 绑定参数 `text(...):param`)。
- **存在**工作流「SQL 审批人」动态执行路径:黑名单不完整;前后端字段名不一致(`sqlExpr` vs `sql`)可能使该能力当前未真正生效,但代码路径本身具备风险。
- **XSS**:商品详情查看已走 `sanitizeHtml`;其余 `v-html`/`innerHTML` 多为固定资源或已 `escapeHtml`,风险较低。
- **弱口令**:文档与基线默认 `admin` / `111111`;请用配套脚本将库中明文等价 `111111` 的账号改为 `Zkxw@123`。
---
## 问题清单
### M-01 工作流 SQL 审批人:动态执行 SELECT,黑名单可绕过
- **风险**:中
- **位置**:`backend/app/services/workflow_engine.py`(约 26–28、306–317 行)`_resolve_approvers` / `_FORBIDDEN_SQL_KEYWORDS`
- **简述**:当审批节点 `strategy == "sql"` 时,引擎对流程定义中的 SQL 模板执行 `db.execute(text(sql_template), variables)`。虽要求以 `SELECT` 开头并禁止 `INSERT/UPDATE/DELETE/DROP/ALTER/CREATE/TRUNCATE`,但未限制 `UNION`、多语句、`INTO OUTFILE`、`LOAD_FILE`、耗时函数等;流程变量以绑定参数传入相对安全,**SQL 模板本身**若被有流程设计权限的账号写入恶意语句,可造成越权读库或影响可用性。
- **建议**:仅允许预置白名单查询或受控 DSL;禁止自由 SQL;若必须保留,使用只读库账号 + 强制单语句解析 + 禁止分号/UNION/文件操作关键字;严格限制可编辑流程定义的角色。
### M-02 流程设计器与引擎 SQL 字段名不一致(`sqlExpr` vs `sql`)
- **风险**:中(安全相关功能缺陷;修复不当会放大 M-01)
- **位置**:
- 前端:`web-admin/src/views/system/workflow/designer/FlowDesigner.vue`(约 202–209、889 行)`config.sqlExpr`
- 后端:`backend/app/services/workflow_engine.py`(约 307 行)`config.get("sql", "")`
- **简述**:设计器保存的是 `sqlExpr`,引擎读取的是 `sql`。当前可能导致 SQL 策略实际取不到语句而失败;若后续只改一端对齐字段而**未**加固 M-01,会意外开启动态 SQL 执行面。
- **建议**:统一字段名并做端到端测试;同时落实 M-01 加固后再启用。
### L-01 ThemeSvg:`fetch(src)` 后 `v-html` 渲染 SVG
- **风险**:低
- **位置**:`web-admin/src/components/core/theme/theme-svg/index.vue`(约 5、61–74 行)
- **简述**:将 `src` 拉取的文本直接 `v-html`。当前调用方(如登录页)传入本地/静态 SVG 路径,利用面小;若将来 `src` 可被不可信来源控制,SVG 内嵌脚本可能构成 XSS。
- **建议**:限制 `src` 为同源静态资源白名单;或对 SVG 做消毒后再渲染。
### L-02 ArtTextScroll:`v-html="text"` 未消毒
- **风险**:低
- **位置**:`web-admin/src/components/core/text-effect/art-text-scroll/index.vue`(约 23、29 行)
- **简述**:`text` 属性直接 `v-html`。业务侧若传入用户/运营可编辑的 HTML,存在 XSS;当前主要被节日滚动等内部组件使用。
- **建议**:默认按纯文本渲染,或统一走 `sanitizeHtml`。
### L-03 highlight 指令:依赖调用方提供的 HTML
- **风险**:低
- **位置**:`web-admin/src/directives/business/highlight.ts`(注释示例约 21 行;处理约 56–69、190 行)
- **简述**:假定宿主已用 `v-html` 注入代码内容后再做行号等处理。若业务把不可信内容直接 `v-html` 再挂指令,会有 XSS。
- **建议**:文档标明仅用于可信演示内容;业务展示代码用转义或消毒。
### I-01 默认弱口令文档与基线账号
- **风险**:信息
- **位置**:`AGENTS.md`、`backend/README.md`、`deploy/docker/README.md`(`admin` / `111111`)
- **简述**:默认口令便于本地联调,若生产未轮换则属高危配置问题(由弱密码刷新脚本处理库内口令)。
- **建议**:生产执行 `backend/scripts/reset_weak_password_111111.py`;后续更新文档默认口令说明。
### I-02 登录允许明文开关
- **风险**:信息
- **位置**:`backend/app/core/config.py`(约 169–170 行)`LOGIN_ALLOW_PLAINTEXT_LOGIN`(默认 `False`)
- **简述**:生产若误开,登录凭据可能以明文进入请求体。
- **建议**:生产配置审计确保为 `false`。
### I-03 API 加密 fail-open
- **风险**:信息
- **位置**:`backend/app/core/config.py`(约 183–184 行)`API_ENCRYPT_FAIL_OPEN`(默认 `True`)
- **简述**:加密中间件失败时放行,偏可用性;在加密本应强制的环境可能削弱传输层保护预期。
- **建议**:生产按安全要求评估是否关闭 fail-open。
### I-04 商品详情富文本已消毒(正向记录)
- **风险**:信息(良好实践)
- **位置**:`web-admin/src/components/business/product-view-dialog/index.vue` + `web-admin/src/utils/sanitize-html.ts`
- **简述**:查看弹窗 `v-html` 使用 `DOMPurify`(`sanitizeHtml`),降低存储型 XSS 风险。
- **建议**:其他富文本展示对齐同一工具。
---
## 分类检索结论
### SQL 注入
| 检查项 | 结果 |
|--------|------|
| `f"...SELECT/INSERT..."` / `%` / `.format` 拼 SQL | **未发现**(`backend/app`) |
| `text()` 使用 | `biz_no_generator` / `sample_reception_lab_code` 等为**固定 SQL + 命名绑定参数**,未见用户输入拼进语句 |
| 工作流动态 SQL | **见 M-01 / M-02** |
| ORM `filter` 主路径 | 普遍使用绑定,未见字符串拼 WHERE |
### XSS
| 检查项 | 结果 |
|--------|------|
| `web-admin` `v-html` | 商品详情已消毒;ThemeSvg / ArtTextScroll / highlight 见 L-01~L-03 |
| `mobile-oa-h5` 打印 PDF | `exportOaApprovalPdf.js` 对展示字段使用 `escapeHtml` 后再 `innerHTML`,风险可控 |
| `mobile-h5` `document.write` | 入口加载脚本用,非用户内容注入点 |
| `miniprogram` | **未发现** `v-html` / `innerHTML` / `eval` 业务用法 |
### 其他
| 检查项 | 结果 |
|--------|------|
| 工作流 callback SSRF | `validate_callback_url` 禁止 http(s),仅本地注册路径 — 正向 |
| 密码存储 | bcrypt(`app/core/security.py`)— 正向 |
| 依赖 CVE / 渗透 / 基础设施 | **未做**(超出本次范围) |
---
## 局限
1. 静态审计不能替代动态渗透与鉴权矩阵测试(水平越权、IDOR 等需接口级用例)。
2. 未扫描第三方依赖 CVE、容器/主机配置、MinIO/Redis 网络暴露。
3. Demo / 文档 HTML 中的 `innerHTML` 未计入生产风险。
## 配套交付
- 弱密码刷新脚本:`backend/scripts/reset_weak_password_111111.py`
- SQL 说明:`docs/sql/2026-10-16-reset-weak-password-111111.sql`
- 设计说明:`docs/superpowers/specs/2026-10-16-security-scan-and-weak-password-design.md`