diff --git a/.playwright-mcp/page-2026-05-16T05-37-34-857Z.yml b/.playwright-mcp/page-2026-05-16T05-37-34-857Z.yml
new file mode 100644
index 00000000..e6aca3cc
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-37-34-857Z.yml
@@ -0,0 +1,5 @@
+- generic [ref=e1]:
+  - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+    - img [ref=e3]
+  - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+    - img [ref=e9]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-37-57-758Z.yml b/.playwright-mcp/page-2026-05-16T05-37-57-758Z.yml
new file mode 100644
index 00000000..146b6085
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-37-57-758Z.yml
@@ -0,0 +1,119 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e64]:
+    - complementary [ref=e65]:
+      - generic [ref=e67]:
+        - generic [ref=e68] [cursor=pointer]:
+          - img "中科兴皖" [ref=e70]
+          - paragraph [ref=e71]: 中科兴皖
+        - menubar [ref=e75]:
+          - menuitem "工作台" [ref=e76] [cursor=pointer]:
+            - generic [ref=e78]: 工作台
+          - menuitem "运营支撑" [expanded] [ref=e79]:
+            - generic [ref=e80] [cursor=pointer]:
+              - img [ref=e83]
+              - generic [ref=e85]: 运营支撑
+              - img [ref=e87]
+            - menu [ref=e89]:
+              - menuitem "洁净室管理" [ref=e90] [cursor=pointer]:
+                - generic [ref=e91]: 洁净室管理
+              - menuitem "库位管理" [ref=e92] [cursor=pointer]:
+                - generic [ref=e93]: 库位管理
+              - menuitem "展馆预约" [ref=e94] [cursor=pointer]:
+                - generic [ref=e95]: 展馆预约
+              - menuitem "demo" [ref=e96] [cursor=pointer]:
+                - generic [ref=e97]: demo
+          - menuitem "基础信息管理" [expanded] [ref=e98]:
+            - generic [ref=e99] [cursor=pointer]:
+              - img [ref=e102]
+              - generic [ref=e104]: 基础信息管理
+              - img [ref=e106]
+            - menu [ref=e108]:
+              - menuitem "客户管理" [ref=e109] [cursor=pointer]:
+                - generic [ref=e110]: 客户管理
+              - menuitem "细胞样本类型管理" [ref=e111] [cursor=pointer]:
+                - generic [ref=e112]: 细胞样本类型管理
+              - menuitem "采集地区及医院管理" [ref=e113] [cursor=pointer]:
+                - generic [ref=e114]: 采集地区及医院管理
+              - menuitem "采集协议号管理" [ref=e115] [cursor=pointer]:
+                - generic [ref=e116]: 采集协议号管理
+              - menuitem "样本编码管理" [ref=e117] [cursor=pointer]:
+                - generic [ref=e118]: 样本编码管理
+          - menuitem "细胞存储管理" [expanded] [ref=e119]:
+            - generic [ref=e120] [cursor=pointer]:
+              - img [ref=e123]
+              - generic [ref=e125]: 细胞存储管理
+              - img [ref=e127]
+            - menu [ref=e129]:
+              - menuitem "采集协议单" [ref=e130] [cursor=pointer]:
+                - generic [ref=e131]: 采集协议单
+              - menuitem "采集协议单审核" [ref=e132] [cursor=pointer]:
+                - generic [ref=e133]: 采集协议单审核
+              - menuitem "收款确认（财务）" [ref=e134] [cursor=pointer]:
+                - generic [ref=e135]: 收款确认（财务）
+              - menuitem "退费确认（财务）" [ref=e136] [cursor=pointer]:
+                - generic [ref=e137]: 退费确认（财务）
+              - menuitem "分期缴费预警" [ref=e138] [cursor=pointer]:
+                - generic [ref=e139]: 分期缴费预警
+          - menuitem "工作流管理" [expanded] [ref=e140]:
+            - generic [ref=e141] [cursor=pointer]:
+              - img [ref=e144]
+              - generic [ref=e147]: 工作流管理
+              - img [ref=e149]
+            - menu [ref=e151]:
+              - menuitem "流程配置" [ref=e152] [cursor=pointer]:
+                - generic [ref=e153]: 流程配置
+              - menuitem "待办中心" [ref=e154] [cursor=pointer]:
+                - generic [ref=e155]: 待办中心
+              - menuitem "已办中心" [ref=e156] [cursor=pointer]:
+                - generic [ref=e157]: 已办中心
+              - menuitem "我的申请" [ref=e158] [cursor=pointer]:
+                - generic [ref=e159]: 我的申请
+              - menuitem "请假申请" [ref=e160] [cursor=pointer]:
+                - generic [ref=e161]: 请假申请
+    - main [ref=e162]:
+      - generic [ref=e164]:
+        - generic [ref=e165]:
+          - generic [ref=e166]:
+            - img [ref=e169] [cursor=pointer]
+            - img [ref=e173] [cursor=pointer]
+            - navigation "breadcrumb" [ref=e175]:
+              - list [ref=e176]:
+                - listitem [ref=e177]:
+                  - generic [ref=e179]: 工作台
+          - generic [ref=e180]:
+            - img [ref=e183] [cursor=pointer]
+            - img [ref=e187] [cursor=pointer]
+        - generic [ref=e188]:
+          - list [ref=e190]:
+            - listitem [ref=e191] [cursor=pointer]: 工作台
+          - img [ref=e195] [cursor=pointer]
+      - generic [ref=e199]:
+        - generic [ref=e200]:
+          - heading "工作台" [level=1] [ref=e201]
+          - paragraph [ref=e202]: 以下为固定参考页，新增管理端界面请对照布局与类名；视觉以文档为准。
+        - generic [ref=e203]:
+          - heading "快速入口" [level=2] [ref=e205]: 快速入口
+          - generic [ref=e207]:
+            - paragraph [ref=e208]: "详见仓库根目录 `.cursorrules` 中「页面级 UI 模板（固定五页）」。"
+            - generic [ref=e209]:
+              - button "商品单位" [ref=e210] [cursor=pointer]:
+                - generic [ref=e211]: 商品单位
+              - button "用户管理" [ref=e212] [cursor=pointer]:
+                - generic [ref=e213]: 用户管理
+              - button "商品分类" [ref=e214] [cursor=pointer]:
+                - generic [ref=e215]: 商品分类
+              - button "租户管理" [ref=e216] [cursor=pointer]:
+                - generic [ref=e217]: 租户管理
+              - button "客户管理" [ref=e218] [cursor=pointer]:
+                - generic [ref=e219]: 客户管理
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
+  - alert [ref=e220]:
+    - img [ref=e222]
+    - generic [ref=e224]:
+      - heading "登录成功" [level=2] [ref=e225]
+      - paragraph [ref=e227]: 欢迎回来，系统管理员！
+      - img [ref=e229] [cursor=pointer]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-40-18-880Z.yml b/.playwright-mcp/page-2026-05-16T05-40-18-880Z.yml
new file mode 100644
index 00000000..1c2a6a10
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-40-18-880Z.yml
@@ -0,0 +1,29 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e231]:
+    - generic [ref=e233]:
+      - img "中科兴皖" [ref=e235]
+      - heading "一体化管理门户" [level=1] [ref=e236]
+      - paragraph [ref=e237]: 安全 · 高效 · 可扩展
+      - generic [ref=e238]:
+        - generic [ref=e240]: 系统管理
+        - generic [ref=e242]: 权限配置
+        - generic [ref=e244]: 数据统计
+    - generic [ref=e246]:
+      - generic [ref=e247]:
+        - heading "欢迎登录" [level=2] [ref=e248]
+        - paragraph [ref=e249]: 请输入您的账号信息
+      - generic [ref=e250]:
+        - generic [ref=e254]:
+          - img [ref=e257]
+          - textbox "请输入用户名" [ref=e259]
+        - generic [ref=e263]:
+          - img [ref=e266]
+          - textbox "请输入密码" [ref=e269]
+        - button "登 录" [ref=e272] [cursor=pointer]:
+          - generic [ref=e273]: 登 录
+      - generic [ref=e274]: 中科兴皖 © 2026
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-40-31-785Z.yml b/.playwright-mcp/page-2026-05-16T05-40-31-785Z.yml
new file mode 100644
index 00000000..1c2a6a10
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-40-31-785Z.yml
@@ -0,0 +1,29 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e231]:
+    - generic [ref=e233]:
+      - img "中科兴皖" [ref=e235]
+      - heading "一体化管理门户" [level=1] [ref=e236]
+      - paragraph [ref=e237]: 安全 · 高效 · 可扩展
+      - generic [ref=e238]:
+        - generic [ref=e240]: 系统管理
+        - generic [ref=e242]: 权限配置
+        - generic [ref=e244]: 数据统计
+    - generic [ref=e246]:
+      - generic [ref=e247]:
+        - heading "欢迎登录" [level=2] [ref=e248]
+        - paragraph [ref=e249]: 请输入您的账号信息
+      - generic [ref=e250]:
+        - generic [ref=e254]:
+          - img [ref=e257]
+          - textbox "请输入用户名" [ref=e259]
+        - generic [ref=e263]:
+          - img [ref=e266]
+          - textbox "请输入密码" [ref=e269]
+        - button "登 录" [ref=e272] [cursor=pointer]:
+          - generic [ref=e273]: 登 录
+      - generic [ref=e274]: 中科兴皖 © 2026
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-41-00-624Z.yml b/.playwright-mcp/page-2026-05-16T05-41-00-624Z.yml
new file mode 100644
index 00000000..3358df39
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-41-00-624Z.yml
@@ -0,0 +1,119 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e280]:
+    - complementary [ref=e281]:
+      - generic [ref=e283]:
+        - generic [ref=e284] [cursor=pointer]:
+          - img "中科兴皖" [ref=e286]
+          - paragraph [ref=e287]: 中科兴皖
+        - menubar [ref=e291]:
+          - menuitem "工作台" [ref=e292] [cursor=pointer]:
+            - generic [ref=e294]: 工作台
+          - menuitem "运营支撑" [expanded] [ref=e295]:
+            - generic [ref=e296] [cursor=pointer]:
+              - img [ref=e299]
+              - generic [ref=e301]: 运营支撑
+              - img [ref=e303]
+            - menu [ref=e305]:
+              - menuitem "洁净室管理" [ref=e306] [cursor=pointer]:
+                - generic [ref=e307]: 洁净室管理
+              - menuitem "库位管理" [ref=e308] [cursor=pointer]:
+                - generic [ref=e309]: 库位管理
+              - menuitem "展馆预约" [ref=e310] [cursor=pointer]:
+                - generic [ref=e311]: 展馆预约
+              - menuitem "demo" [ref=e312] [cursor=pointer]:
+                - generic [ref=e313]: demo
+          - menuitem "基础信息管理" [expanded] [ref=e314]:
+            - generic [ref=e315] [cursor=pointer]:
+              - img [ref=e318]
+              - generic [ref=e320]: 基础信息管理
+              - img [ref=e322]
+            - menu [ref=e324]:
+              - menuitem "客户管理" [ref=e325] [cursor=pointer]:
+                - generic [ref=e326]: 客户管理
+              - menuitem "细胞样本类型管理" [ref=e327] [cursor=pointer]:
+                - generic [ref=e328]: 细胞样本类型管理
+              - menuitem "采集地区及医院管理" [ref=e329] [cursor=pointer]:
+                - generic [ref=e330]: 采集地区及医院管理
+              - menuitem "采集协议号管理" [ref=e331] [cursor=pointer]:
+                - generic [ref=e332]: 采集协议号管理
+              - menuitem "样本编码管理" [ref=e333] [cursor=pointer]:
+                - generic [ref=e334]: 样本编码管理
+          - menuitem "细胞存储管理" [expanded] [ref=e335]:
+            - generic [ref=e336] [cursor=pointer]:
+              - img [ref=e339]
+              - generic [ref=e341]: 细胞存储管理
+              - img [ref=e343]
+            - menu [ref=e345]:
+              - menuitem "采集协议单" [ref=e346] [cursor=pointer]:
+                - generic [ref=e347]: 采集协议单
+              - menuitem "采集协议单审核" [ref=e348] [cursor=pointer]:
+                - generic [ref=e349]: 采集协议单审核
+              - menuitem "收款确认（财务）" [ref=e350] [cursor=pointer]:
+                - generic [ref=e351]: 收款确认（财务）
+              - menuitem "退费确认（财务）" [ref=e352] [cursor=pointer]:
+                - generic [ref=e353]: 退费确认（财务）
+              - menuitem "分期缴费预警" [ref=e354] [cursor=pointer]:
+                - generic [ref=e355]: 分期缴费预警
+          - menuitem "工作流管理" [expanded] [ref=e356]:
+            - generic [ref=e357] [cursor=pointer]:
+              - img [ref=e360]
+              - generic [ref=e363]: 工作流管理
+              - img [ref=e365]
+            - menu [ref=e367]:
+              - menuitem "流程配置" [ref=e368] [cursor=pointer]:
+                - generic [ref=e369]: 流程配置
+              - menuitem "待办中心" [ref=e370] [cursor=pointer]:
+                - generic [ref=e371]: 待办中心
+              - menuitem "已办中心" [ref=e372] [cursor=pointer]:
+                - generic [ref=e373]: 已办中心
+              - menuitem "我的申请" [ref=e374] [cursor=pointer]:
+                - generic [ref=e375]: 我的申请
+              - menuitem "请假申请" [ref=e376] [cursor=pointer]:
+                - generic [ref=e377]: 请假申请
+    - main [ref=e378]:
+      - generic [ref=e380]:
+        - generic [ref=e381]:
+          - generic [ref=e382]:
+            - img [ref=e385] [cursor=pointer]
+            - img [ref=e389] [cursor=pointer]
+            - navigation "breadcrumb" [ref=e391]:
+              - list [ref=e392]:
+                - listitem [ref=e393]:
+                  - generic [ref=e395]: 工作台
+          - generic [ref=e396]:
+            - img [ref=e399] [cursor=pointer]
+            - img [ref=e403] [cursor=pointer]
+        - generic [ref=e404]:
+          - list [ref=e406]:
+            - listitem [ref=e407] [cursor=pointer]: 工作台
+          - img [ref=e411] [cursor=pointer]
+      - generic [ref=e415]:
+        - generic [ref=e416]:
+          - heading "工作台" [level=1] [ref=e417]
+          - paragraph [ref=e418]: 以下为固定参考页，新增管理端界面请对照布局与类名；视觉以文档为准。
+        - generic [ref=e419]:
+          - heading "快速入口" [level=2] [ref=e421]: 快速入口
+          - generic [ref=e423]:
+            - paragraph [ref=e424]: "详见仓库根目录 `.cursorrules` 中「页面级 UI 模板（固定五页）」。"
+            - generic [ref=e425]:
+              - button "商品单位" [ref=e426] [cursor=pointer]:
+                - generic [ref=e427]: 商品单位
+              - button "用户管理" [ref=e428] [cursor=pointer]:
+                - generic [ref=e429]: 用户管理
+              - button "商品分类" [ref=e430] [cursor=pointer]:
+                - generic [ref=e431]: 商品分类
+              - button "租户管理" [ref=e432] [cursor=pointer]:
+                - generic [ref=e433]: 租户管理
+              - button "客户管理" [ref=e434] [cursor=pointer]:
+                - generic [ref=e435]: 客户管理
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
+  - alert [ref=e436]:
+    - img [ref=e438]
+    - generic [ref=e440]:
+      - heading "登录成功" [level=2] [ref=e441]
+      - paragraph [ref=e443]: 欢迎回来，系统管理员！
+      - img [ref=e445] [cursor=pointer]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-41-36-020Z.yml b/.playwright-mcp/page-2026-05-16T05-41-36-020Z.yml
new file mode 100644
index 00000000..2fecfa76
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-41-36-020Z.yml
@@ -0,0 +1,29 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e447]:
+    - generic [ref=e449]:
+      - img "中科兴皖" [ref=e451]
+      - heading "一体化管理门户" [level=1] [ref=e452]
+      - paragraph [ref=e453]: 安全 · 高效 · 可扩展
+      - generic [ref=e454]:
+        - generic [ref=e456]: 系统管理
+        - generic [ref=e458]: 权限配置
+        - generic [ref=e460]: 数据统计
+    - generic [ref=e462]:
+      - generic [ref=e463]:
+        - heading "欢迎登录" [level=2] [ref=e464]
+        - paragraph [ref=e465]: 请输入您的账号信息
+      - generic [ref=e466]:
+        - generic [ref=e470]:
+          - img [ref=e473]
+          - textbox "请输入用户名" [ref=e475]
+        - generic [ref=e479]:
+          - img [ref=e482]
+          - textbox "请输入密码" [ref=e485]
+        - button "登 录" [ref=e488] [cursor=pointer]:
+          - generic [ref=e489]: 登 录
+      - generic [ref=e490]: 中科兴皖 © 2026
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-41-45-619Z.yml b/.playwright-mcp/page-2026-05-16T05-41-45-619Z.yml
new file mode 100644
index 00000000..2fecfa76
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-41-45-619Z.yml
@@ -0,0 +1,29 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e447]:
+    - generic [ref=e449]:
+      - img "中科兴皖" [ref=e451]
+      - heading "一体化管理门户" [level=1] [ref=e452]
+      - paragraph [ref=e453]: 安全 · 高效 · 可扩展
+      - generic [ref=e454]:
+        - generic [ref=e456]: 系统管理
+        - generic [ref=e458]: 权限配置
+        - generic [ref=e460]: 数据统计
+    - generic [ref=e462]:
+      - generic [ref=e463]:
+        - heading "欢迎登录" [level=2] [ref=e464]
+        - paragraph [ref=e465]: 请输入您的账号信息
+      - generic [ref=e466]:
+        - generic [ref=e470]:
+          - img [ref=e473]
+          - textbox "请输入用户名" [ref=e475]
+        - generic [ref=e479]:
+          - img [ref=e482]
+          - textbox "请输入密码" [ref=e485]
+        - button "登 录" [ref=e488] [cursor=pointer]:
+          - generic [ref=e489]: 登 录
+      - generic [ref=e490]: 中科兴皖 © 2026
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
\ No newline at end of file
diff --git a/.playwright-mcp/page-2026-05-16T05-42-20-871Z.yml b/.playwright-mcp/page-2026-05-16T05-42-20-871Z.yml
new file mode 100644
index 00000000..453ee949
--- /dev/null
+++ b/.playwright-mcp/page-2026-05-16T05-42-20-871Z.yml
@@ -0,0 +1,119 @@
+- generic [active] [ref=e13]:
+  - generic [ref=e496]:
+    - complementary [ref=e497]:
+      - generic [ref=e499]:
+        - generic [ref=e500] [cursor=pointer]:
+          - img "中科兴皖" [ref=e502]
+          - paragraph [ref=e503]: 中科兴皖
+        - menubar [ref=e507]:
+          - menuitem "工作台" [ref=e508] [cursor=pointer]:
+            - generic [ref=e510]: 工作台
+          - menuitem "运营支撑" [expanded] [ref=e511]:
+            - generic [ref=e512] [cursor=pointer]:
+              - img [ref=e515]
+              - generic [ref=e517]: 运营支撑
+              - img [ref=e519]
+            - menu [ref=e521]:
+              - menuitem "洁净室管理" [ref=e522] [cursor=pointer]:
+                - generic [ref=e523]: 洁净室管理
+              - menuitem "库位管理" [ref=e524] [cursor=pointer]:
+                - generic [ref=e525]: 库位管理
+              - menuitem "展馆预约" [ref=e526] [cursor=pointer]:
+                - generic [ref=e527]: 展馆预约
+              - menuitem "demo" [ref=e528] [cursor=pointer]:
+                - generic [ref=e529]: demo
+          - menuitem "基础信息管理" [expanded] [ref=e530]:
+            - generic [ref=e531] [cursor=pointer]:
+              - img [ref=e534]
+              - generic [ref=e536]: 基础信息管理
+              - img [ref=e538]
+            - menu [ref=e540]:
+              - menuitem "客户管理" [ref=e541] [cursor=pointer]:
+                - generic [ref=e542]: 客户管理
+              - menuitem "细胞样本类型管理" [ref=e543] [cursor=pointer]:
+                - generic [ref=e544]: 细胞样本类型管理
+              - menuitem "采集地区及医院管理" [ref=e545] [cursor=pointer]:
+                - generic [ref=e546]: 采集地区及医院管理
+              - menuitem "采集协议号管理" [ref=e547] [cursor=pointer]:
+                - generic [ref=e548]: 采集协议号管理
+              - menuitem "样本编码管理" [ref=e549] [cursor=pointer]:
+                - generic [ref=e550]: 样本编码管理
+          - menuitem "细胞存储管理" [expanded] [ref=e551]:
+            - generic [ref=e552] [cursor=pointer]:
+              - img [ref=e555]
+              - generic [ref=e557]: 细胞存储管理
+              - img [ref=e559]
+            - menu [ref=e561]:
+              - menuitem "采集协议单" [ref=e562] [cursor=pointer]:
+                - generic [ref=e563]: 采集协议单
+              - menuitem "采集协议单审核" [ref=e564] [cursor=pointer]:
+                - generic [ref=e565]: 采集协议单审核
+              - menuitem "收款确认（财务）" [ref=e566] [cursor=pointer]:
+                - generic [ref=e567]: 收款确认（财务）
+              - menuitem "退费确认（财务）" [ref=e568] [cursor=pointer]:
+                - generic [ref=e569]: 退费确认（财务）
+              - menuitem "分期缴费预警" [ref=e570] [cursor=pointer]:
+                - generic [ref=e571]: 分期缴费预警
+          - menuitem "工作流管理" [expanded] [ref=e572]:
+            - generic [ref=e573] [cursor=pointer]:
+              - img [ref=e576]
+              - generic [ref=e579]: 工作流管理
+              - img [ref=e581]
+            - menu [ref=e583]:
+              - menuitem "流程配置" [ref=e584] [cursor=pointer]:
+                - generic [ref=e585]: 流程配置
+              - menuitem "待办中心" [ref=e586] [cursor=pointer]:
+                - generic [ref=e587]: 待办中心
+              - menuitem "已办中心" [ref=e588] [cursor=pointer]:
+                - generic [ref=e589]: 已办中心
+              - menuitem "我的申请" [ref=e590] [cursor=pointer]:
+                - generic [ref=e591]: 我的申请
+              - menuitem "请假申请" [ref=e592] [cursor=pointer]:
+                - generic [ref=e593]: 请假申请
+    - main [ref=e594]:
+      - generic [ref=e596]:
+        - generic [ref=e597]:
+          - generic [ref=e598]:
+            - img [ref=e601] [cursor=pointer]
+            - img [ref=e605] [cursor=pointer]
+            - navigation "breadcrumb" [ref=e607]:
+              - list [ref=e608]:
+                - listitem [ref=e609]:
+                  - generic [ref=e611]: 工作台
+          - generic [ref=e612]:
+            - img [ref=e615] [cursor=pointer]
+            - img [ref=e619] [cursor=pointer]
+        - generic [ref=e620]:
+          - list [ref=e622]:
+            - listitem [ref=e623] [cursor=pointer]: 工作台
+          - img [ref=e627] [cursor=pointer]
+      - generic [ref=e631]:
+        - generic [ref=e632]:
+          - heading "工作台" [level=1] [ref=e633]
+          - paragraph [ref=e634]: 以下为固定参考页，新增管理端界面请对照布局与类名；视觉以文档为准。
+        - generic [ref=e635]:
+          - heading "快速入口" [level=2] [ref=e637]: 快速入口
+          - generic [ref=e639]:
+            - paragraph [ref=e640]: "详见仓库根目录 `.cursorrules` 中「页面级 UI 模板（固定五页）」。"
+            - generic [ref=e641]:
+              - button "商品单位" [ref=e642] [cursor=pointer]:
+                - generic [ref=e643]: 商品单位
+              - button "用户管理" [ref=e644] [cursor=pointer]:
+                - generic [ref=e645]: 用户管理
+              - button "商品分类" [ref=e646] [cursor=pointer]:
+                - generic [ref=e647]: 商品分类
+              - button "租户管理" [ref=e648] [cursor=pointer]:
+                - generic [ref=e649]: 租户管理
+              - button "客户管理" [ref=e650] [cursor=pointer]:
+                - generic [ref=e651]: 客户管理
+  - generic [ref=e1]:
+    - generic "Toggle devtools panel" [ref=e2] [cursor=pointer]:
+      - img [ref=e3]
+    - generic "Toggle Component Inspector" [ref=e8] [cursor=pointer]:
+      - img [ref=e9]
+  - alert [ref=e652]:
+    - img [ref=e654]
+    - generic [ref=e656]:
+      - heading "登录成功" [level=2] [ref=e657]
+      - paragraph [ref=e659]: 欢迎回来，系统管理员！
+      - img [ref=e661] [cursor=pointer]
\ No newline at end of file
diff --git a/.superpowers/brainstorm/78964-1778664283/content/zkxw-cell-storage-modules-overview.html b/.superpowers/brainstorm/78964-1778664283/content/zkxw-cell-storage-modules-overview.html
new file mode 100644
index 00000000..081ca34a
--- /dev/null
+++ b/.superpowers/brainstorm/78964-1778664283/content/zkxw-cell-storage-modules-overview.html
@@ -0,0 +1,151 @@
+<h2>细胞存储管理（2.2.6 ~ 2.2.10）模块总览</h2>
+<p class="subtitle">用于对齐：菜单结构、核心数据表、关键状态流转与后续页面原型拆分</p>
+
+<div class="section">
+  <div class="label">菜单（本次范围）</div>
+  <div class="cards">
+    <div class="card">
+      <div class="card-image">
+        <div class="mockup">
+          <div class="mockup-header">2.2.6 采集协议单</div>
+          <div class="mockup-body">
+            <div class="mock-content">
+              <div>列表：协议号 / 状态 / 采集专员 / 登记日期 / 创建时间</div>
+              <div class="placeholder" style="margin-top:10px">详情抽屉/弹窗（基础信息 + 样本 + 缴费 + 附件）</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="card-body">
+        <h3>采集协议单</h3>
+        <p>主表：<code>biz_collection_protocol</code>，关联采集信息/样本/运输/当事人/缴费等子表</p>
+      </div>
+    </div>
+
+    <div class="card">
+      <div class="card-image">
+        <div class="mockup">
+          <div class="mockup-header">2.2.7 采集协议单审核</div>
+          <div class="mockup-body">
+            <div class="mock-content">
+              <div>列表：待审核 / 已审核（通过/退回）</div>
+              <div class="placeholder" style="margin-top:10px">审核弹窗：审核意见 + 操作（通过/退回）</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="card-body">
+        <h3>协议单审核</h3>
+        <p>表：<code>biz_protocol_audit</code>（按协议单维度记录审核结果/备注/审核人）</p>
+      </div>
+    </div>
+
+    <div class="card">
+      <div class="card-image">
+        <div class="mockup">
+          <div class="mockup-header">2.2.8 收款确认（财务）</div>
+          <div class="mockup-body">
+            <div class="mock-content">
+              <div>列表：待确认缴费（按缴费明细）</div>
+              <div class="placeholder" style="margin-top:10px">确认弹窗：确认附件 + 备注</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="card-body">
+        <h3>收款确认</h3>
+        <p>表：<code>biz_protocol_payment_detail</code>（<code>pay_status=dfj/jfqrz/yjf</code> 等）</p>
+      </div>
+    </div>
+
+    <div class="card">
+      <div class="card-image">
+        <div class="mockup">
+          <div class="mockup-header">2.2.9 退费确认（财务）</div>
+          <div class="mockup-body">
+            <div class="mock-content">
+              <div>列表：待确认退费（按缴费明细）</div>
+              <div class="placeholder" style="margin-top:10px">确认弹窗：退费附件 + 备注</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="card-body">
+        <h3>退费确认</h3>
+        <p>表：同上（<code>pay_status=tfqrz/ytf</code>）+ 财务确认附件字段</p>
+      </div>
+    </div>
+
+    <div class="card">
+      <div class="card-image">
+        <div class="mockup">
+          <div class="mockup-header">2.2.10 分期缴费预警</div>
+          <div class="mockup-body">
+            <div class="mock-content">
+              <div>列表：即将到期/已逾期（按分期明细）</div>
+              <div class="placeholder" style="margin-top:10px">快捷操作：提醒/标记处理（可选）</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="card-body">
+        <h3>分期缴费预警</h3>
+        <p>字段：<code>installment_due_date</code>（明细应缴日）+ 状态过滤（未缴费/确认中）</p>
+      </div>
+    </div>
+  </div>
+</div>
+
+<div class="section">
+  <div class="label">关键状态流转（建议先对齐）</div>
+  <div class="split">
+    <div class="mockup">
+      <div class="mockup-header">协议单状态（biz_collection_protocol.protocol_status）</div>
+      <div class="mockup-body">
+        <div class="mock-content">
+          <p><b>dsx</b> 待生效 → <b>sxz</b> 生效中 →（到期）→ <b>ygq</b> 已过期</p>
+          <p>任意阶段可 → <b>yzf</b> 已作废（毁约/异常终止/作废）</p>
+          <p>可选：→ <b>zky</b> 转科研（后续再做，当前仅保留字段/入口）</p>
+        </div>
+      </div>
+    </div>
+
+    <div class="mockup">
+      <div class="mockup-header">缴费明细状态（biz_protocol_payment_detail.pay_status）</div>
+      <div class="mockup-body">
+        <div class="mock-content">
+          <p><b>dfj</b> 待缴费 → <b>jfqrz</b> 缴费确认中 → <b>yjf</b> 已缴费</p>
+          <p><b>tfqrz</b> 退费确认中 → <b>ytf</b> 已退费（通常由业务发起后进入）</p>
+          <p class="subtitle" style="margin-top:10px">收款确认页面主要处理：<b>jfqrz → yjf</b>；退费确认页面主要处理：<b>tfqrz → ytf</b></p>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<div class="section">
+  <div class="label">下一步我需要你确认的 1 个问题</div>
+  <div class="mockup">
+    <div class="mockup-header">审核模块（2.2.7）的定义边界</div>
+    <div class="mockup-body">
+      <div class="options">
+        <div class="option" data-choice="audit-1" onclick="toggleSelect(this)">
+          <div class="letter">A</div>
+          <div class="content">
+            <h3>仅“协议附件/缴费截图”审核</h3>
+            <p>审核通过后仅写 <code>biz_protocol_audit</code> 记录，不改协议单主状态（状态仍由业务流程控制）</p>
+          </div>
+        </div>
+        <div class="option" data-choice="audit-2" onclick="toggleSelect(this)">
+          <div class="letter">B</div>
+          <div class="content">
+            <h3>审核通过会驱动协议单生效</h3>
+            <p>审核通过时同步将 <code>protocol_status</code> 从 <code>dsx</code> 推到 <code>sxz</code>（并记录生效时间/描述）</p>
+          </div>
+        </div>
+      </div>
+      <p class="subtitle" style="margin-top:10px">你在浏览器里点选 A 或 B 即可（也可以回终端用文字说明）。</p>
+    </div>
+  </div>
+</div>
+
diff --git a/.superpowers/brainstorm/78964-1778664283/content/zkxw-installment-warning-rule.html b/.superpowers/brainstorm/78964-1778664283/content/zkxw-installment-warning-rule.html
new file mode 100644
index 00000000..4feaf09e
--- /dev/null
+++ b/.superpowers/brainstorm/78964-1778664283/content/zkxw-installment-warning-rule.html
@@ -0,0 +1,76 @@
+<h2>2.2.10 分期缴费用户预警：规则确认</h2>
+<p class="subtitle">目标：确定“预警/逾期”的判定口径，便于后端列表筛选与前端状态标签统一</p>
+
+<div class="section">
+  <div class="label">数据来源（已确定）</div>
+  <div class="mockup">
+    <div class="mockup-header">biz_protocol_payment_detail</div>
+    <div class="mockup-body">
+      <div class="mock-content">
+        <p>按 <code>installment_due_date</code>（YYYYMMDD）计算；仅展示分期明细（<code>installment_no</code> 不为空）</p>
+        <p>过滤状态：通常只看 <code>dfj</code>（待缴费）与（可选）<code>jfqrz</code>（确认中）</p>
+      </div>
+    </div>
+  </div>
+</div>
+
+<div class="section">
+  <div class="label">请选择预警口径（单选）</div>
+  <div class="options">
+    <div class="option" data-choice="warn-7" onclick="toggleSelect(this)">
+      <div class="letter">A</div>
+      <div class="content">
+        <h3>预警=未来 7 天内到期；逾期=已超过到期日</h3>
+        <p>最常见口径；页面分两块：即将到期(0~7天) / 已逾期(&lt;0天)</p>
+      </div>
+    </div>
+    <div class="option" data-choice="warn-3" onclick="toggleSelect(this)">
+      <div class="letter">B</div>
+      <div class="content">
+        <h3>预警=未来 3 天内到期；逾期=已超过到期日</h3>
+        <p>更紧迫；减少列表噪音</p>
+      </div>
+    </div>
+    <div class="option" data-choice="warn-15" onclick="toggleSelect(this)">
+      <div class="letter">C</div>
+      <div class="content">
+        <h3>预警=未来 15 天内到期；逾期=已超过到期日</h3>
+        <p>更早提醒；适合人工跟进周期长的场景</p>
+      </div>
+    </div>
+    <div class="option" data-choice="warn-custom" onclick="toggleSelect(this)">
+      <div class="letter">D</div>
+      <div class="content">
+        <h3>预警天数可配置（字典/配置表/环境变量）</h3>
+        <p>灵活，但实现与运维成本更高；需要补一处配置入口</p>
+      </div>
+    </div>
+  </div>
+</div>
+
+<div class="section">
+  <div class="label">另外 1 个小点（默认建议）</div>
+  <div class="mockup">
+    <div class="mockup-header">确认：是否把“确认中 jfqrz”也纳入预警列表？</div>
+    <div class="mockup-body">
+      <div class="options">
+        <div class="option" data-choice="include-jfqrz-no" onclick="toggleSelect(this)">
+          <div class="letter">1</div>
+          <div class="content">
+            <h3>不纳入</h3>
+            <p>预警只针对“待缴费 dfj”，避免和财务确认页面重复</p>
+          </div>
+        </div>
+        <div class="option" data-choice="include-jfqrz-yes" onclick="toggleSelect(this)">
+          <div class="letter">2</div>
+          <div class="content">
+            <h3>纳入</h3>
+            <p>把“待缴费 + 确认中”都算未完成付款，有助于跟进</p>
+          </div>
+        </div>
+      </div>
+      <p class="subtitle" style="margin-top:10px">你可以点 A/B/C/D，再点 1 或 2；也可以直接在终端回复（例如：A + 1）。</p>
+    </div>
+  </div>
+</div>
+
diff --git a/.superpowers/brainstorm/78964-1778664283/state/server-stopped b/.superpowers/brainstorm/78964-1778664283/state/server-stopped
new file mode 100644
index 00000000..d3c18b35
--- /dev/null
+++ b/.superpowers/brainstorm/78964-1778664283/state/server-stopped
@@ -0,0 +1 @@
+{"reason":"owner process exited","timestamp":1778664344125}
diff --git a/.superpowers/brainstorm/78964-1778664283/state/server.pid b/.superpowers/brainstorm/78964-1778664283/state/server.pid
new file mode 100644
index 00000000..c91ad7a0
--- /dev/null
+++ b/.superpowers/brainstorm/78964-1778664283/state/server.pid
@@ -0,0 +1 @@
+78976
diff --git a/AGENTS.md b/AGENTS.md
index 54bbe5c0..53c549c8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -25,6 +25,11 @@ Full specs: `openspec/changes/zkxw-engineering-standards/specs/*/spec.md`. Below
 - **Dialog grid**: Default 2-column (`.form-grid-2`). Max 5 columns. Full-width fields use `.form-col-span-2` (`grid-column: 1 / -1`). Narrow viewport SHALL fallback to fewer columns.
 - **List panel heading**: `panel-top` → `h2.title-bar-heading` SHALL show primary-color vertical bar via `::before`. Ambiguous titles (e.g. "租户" containing "户") SHALL be registered in `App.vue` `panelTitleBarTextRules`.
 - **Miniprogram media**: Thumbnails 1:1 `aspectFill`; carousel 4:3 `aspectFill`; detail images `widthFix`. Min tap target 44×44px.
+- **Sidebar menu icons**: First-level menu items SHALL show icons before the name; second-level and deeper items SHALL NOT show icons (text only). Implemented via `level === 0` check in `SidebarSubmenu.vue`.
+- **Tab bar (WorkTab) icons**: Tab bar tabs SHALL NOT show icons — only text titles. `meta.icon` is for sidebar only.
+- **Form field annotations**: Field hints (e.g. "数值越小越靠前") SHALL appear as small text after the label via `<template #label>字段名<span class="form-label-tip">注释</span></template>`, NOT beside the input control. Style class: `.form-label-tip` (12px, `--mint-text-muted`).
+- **Attachment upload card layout**: Upload trigger SHALL be a card (120×96px, dashed border `#a7f3d0`) placed inline as the first item in the same flex row as uploaded attachment cards. Hint text below the row. See `openspec/.../ui-conventions/spec.md` "附件上传卡片化布局" for full spec + CSS reference.
+- **Sort fields (sort_order/orderNum)**: web-admin 列表、新增弹窗、编辑弹窗中默认不展示排序字段。后续根据功能需要自行添加。
 - **Template pages** — new pages SHALL match these exactly:
   - Standard list: `src/views/system/unit/index.vue`
   - Complex list: `src/views/system/order/index.vue`
@@ -36,7 +41,7 @@ Full specs: `openspec/changes/zkxw-engineering-standards/specs/*/spec.md`. Below
 
 - **Tenant isolation**: All business data queries SHALL filter by current user's `tenant_no`. All write/update endpoints SHALL set `tenant_no` to the current user's tenant. MUST NOT trust client-submitted tenant overrides (unless multi-tenant admin API with security review).
 - **Data permission**: All business queries SHALL apply data scope filtering based on the union of all roles assigned to the current user (menu + data permissions both use union semantics).
-- **Default sort**: Lists SHALL sort by `order_num ASC, create_time DESC` when no custom sort is specified.
+- **Default sort**: Lists SHALL sort by `create_time DESC` when no custom sort is specified.
 - **Route registration**: New route modules SHALL be registered in `app/api/__init__.py` AND `app/main.py`. SHALL NOT bypass auth/crypto/audit middleware.
 
 ### Database Conventions
@@ -108,7 +113,7 @@ cp .env.example .env.local   # fill in DB, Redis, MinIO, etc.
 - Auth: JWT + RSA-encrypted login. Login RSA key auto-generated or set via `LOGIN_RSA_PRIVATE_KEY_PEM` env var.
 - API encryption middleware: symmetric crypto layer controlled by `API_ENCRYPT_*` env vars. Excluded paths listed in `API_ENCRYPT_EXCLUDE_PATHS`.
 - Config: pydantic-settings (`app/core/config.py`), reads from `.env` / `.env.local` / `.env.production`.
-- Database init SQL: `docs/sql/zkxw-requirements-v0.3-schema.sql`. Default admin: `admin` / `111111`, role `super_admin`.
+- Database init / schema baseline: `docs/sql/zkxw.sql`（从当前库导出的全量 SQL）。Default admin: `admin` / `111111`, role `super_admin`.
 - Swagger docs at `/docs`, ReDoc at `/redoc`.
 - Tests: minimal, only `tests/test_api_crypto.py`. Run with `pytest`.
 
diff --git a/backend/.env.example b/backend/.env.example
index 6cdcdd18..29b67a3e 100644
--- a/backend/.env.example
+++ b/backend/.env.example
@@ -1,4 +1,4 @@
-# 数据库连接配置示例（V0.3 库名示例见 docs/sql/zkxw-requirements-v0.3-schema.sql）
+# 数据库连接配置示例（库名/表结构以 docs/sql/zkxw.sql 全量导出为准）
 # DATABASE_URL 格式：mysql+pymysql://user:password@host:port/dbname
 DATABASE_URL=mysql+pymysql://root:password@localhost:3306/zkxw
 
@@ -43,6 +43,10 @@ DATABASE_URL=mysql+pymysql://root:password@localhost:3306/zkxw
 # MINIO_SECURE=false
 # MINIO_BASE_URL=https://www.chengyantek.cn/sanqiang
 
+# 全量 API 请求日志（写入 sys_api_request_log；无表时会 warning「api_request_log persist failed」）
+# 解决二选一：① 在库中执行 docs/sql/optional-sys-api-request-log.sql 建表 ② 关闭写入：
+# API_REQUEST_LOG_ENABLED=false
+
 # 微信支付配置示例
 # 小程序支付使用 JSAPI（trade_type=JSAPI）
 # WXPAY_MCHID=1900000109
diff --git a/backend/README.md b/backend/README.md
index d8b35612..b021c416 100644
--- a/backend/README.md
+++ b/backend/README.md
@@ -2,7 +2,7 @@
 
 基于 FastAPI 的精简后端：**Web 鉴权**（登录 RSA、登录、刷新 Token、登出、当前用户、菜单 code）、**静态运营菜单树**、**运营端路由占位**。原叁强鲜配业务 API 已移除，可按模块在 `app/api/admin.py` 等位置扩展。
 
-数据库最小初始化见：`docs/sql/zkxw-backend-skeleton.sql`（默认账号 `admin` / `111111`，角色 `super_admin`）。
+数据库结构与种子数据基线见：`docs/sql/zkxw.sql`（全库导出；默认账号 `admin` / `111111`，角色 `super_admin`）。
 
 ## 技术栈
 
diff --git a/backend/app.pid b/backend/app.pid
index 27a5dbe7..eccd6364 100644
--- a/backend/app.pid
+++ b/backend/app.pid
@@ -1 +1 @@
-9695
+92212
diff --git a/backend/app/api/__init__.py b/backend/app/api/__init__.py
index e5083be4..cca9f093 100644
--- a/backend/app/api/__init__.py
+++ b/backend/app/api/__init__.py
@@ -2,9 +2,21 @@
 from app.api.public import router as public_router
 from app.api.menu import router as menu_router
 from app.api.admin import router as admin_router
+from app.api.workflow import router as workflow_router
+from app.api.basic_info import router as basic_info_router
+from app.api.collection_protocol import router as collection_protocol_router
+from app.api.leave import router as leave_router
+from app.api.operations import router as operations_router
+from app.api.ethnic import router as ethnic_router
 
 __all__ = [
     "public_router",
     "menu_router",
     "admin_router",
+    "workflow_router",
+    "basic_info_router",
+    "collection_protocol_router",
+    "leave_router",
+    "operations_router",
+    "ethnic_router",
 ]
diff --git a/backend/app/api/admin.py b/backend/app/api/admin.py
index a0d15399..eba6709b 100644
--- a/backend/app/api/admin.py
+++ b/backend/app/api/admin.py
@@ -1,13 +1,17 @@
 """运营端管理接口（租户、角色下拉等）"""
+import os
+import uuid
 from typing import Any, List, Optional
 
-from fastapi import APIRouter, Depends, Query
+from fastapi import APIRouter, Depends, Query, UploadFile, File, Form
 from pydantic import BaseModel, ConfigDict, Field
 from sqlalchemy.orm import Session
 
+from app.core.config import settings
 from app.core.database import get_db
 from app.core.menu_guard import require_admin_or_super_admin
 from app.core.response import success_response, error_response
+from app.core.storage import storage
 from app.crud import tenant as tenant_svc
 from app.crud import dict_type as dict_type_svc
 from app.crud import dict_data as dict_data_svc
@@ -19,7 +23,7 @@ from app.crud import express_company as express_company_svc
 from app.crud import menu as menu_svc
 from app.crud import role as role_svc
 from app.crud import user as user_svc
-from app.models.models import SysRole, SysUser
+from app.models.models import BizAttachment, SysRole, SysUser
 from app.services.web_auth_roles import _map_role_name_to_web
 
 router = APIRouter(prefix="/web/admin", tags=["运营端管理"])
@@ -39,7 +43,7 @@ async def list_roles_for_select(
     rows: List[SysRole] = (
         db.query(SysRole)
         .filter(SysRole.del_flag == 0, SysRole.status == "1")
-        .order_by(SysRole.order_num.asc())
+        .order_by(SysRole.create_time.desc())
         .all()
     )
     seen: set[str] = set()
@@ -62,6 +66,37 @@ async def list_roles_for_select(
     return success_response(out)
 
 
+@router.get("/users/options")
+async def list_users_for_select(
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    """返回用户下拉选项（label=昵称，value=用户ID），供流程设计器审批人选择使用。"""
+    tenant_no = _user.get("tenant_no", "")
+    q = db.query(SysUser).filter(SysUser.del_flag == 0, SysUser.status == "1")
+    if tenant_no:
+        q = q.filter(SysUser.tenant_no == tenant_no)
+    rows = q.order_by(SysUser.create_time.desc()).all()
+    out = [{"label": (r.nick_name or r.user_no or ""), "value": r.id} for r in rows]
+    return success_response(out)
+
+
+@router.get("/roles/options")
+async def list_roles_for_designer(
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    """返回角色下拉选项（label=角色名，value=角色ID UUID），供流程设计器审批人选择使用。
+    与 /roles 不同，此端点返回角色 UUID 作为 value（引擎解析审批人需要 UUID）。"""
+    tenant_no = _user.get("tenant_no", "")
+    q = db.query(SysRole).filter(SysRole.del_flag == 0, SysRole.status == "1")
+    if tenant_no:
+        q = q.filter(SysRole.tenant_no == tenant_no)
+    rows = q.order_by(SysRole.create_time.desc()).all()
+    out = [{"label": (r.role_name or "").strip(), "value": r.id} for r in rows if (r.role_name or "").strip()]
+    return success_response(out)
+
+
 # ---------------------------------------------------------------------------
 # 租户管理
 # ---------------------------------------------------------------------------
@@ -239,6 +274,22 @@ async def list_users(
     return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
 
 
+@router.get("/users/{user_id}")
+async def get_user_by_id(
+    user_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    row = user_svc.get_user(db, user_id)
+    if not row:
+        return error_response(404, "用户不存在")
+    if row.tenant_no != tenant_no and user.get("role") != "super_admin":
+        return error_response(403, "无权查看该用户")
+    data = user_svc.get_user_with_relations(db, user_id)
+    return success_response(data)
+
+
 @router.post("/users")
 async def create_user(
     body: UserCreateBody,
@@ -862,6 +913,46 @@ async def delete_post(
         return error_response(400, str(e))
 
 
+class PostUsersUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    user_ids: List[str] = Field(default_factory=list, alias="userIds")
+
+
+@router.get("/posts/{post_id}/users")
+async def list_post_bound_users(
+    post_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    post = post_svc.get_post(db, post_id)
+    if not post or post.tenant_no != tenant_no:
+        return error_response(404, "职位不存在")
+    ids = user_svc.list_user_ids_bound_to_post(db, post_id, tenant_no)
+    return success_response({"userIds": ids})
+
+
+@router.put("/posts/{post_id}/users")
+async def update_post_bound_users(
+    post_id: str,
+    body: PostUsersUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    post = post_svc.get_post(db, post_id)
+    if not post or post.tenant_no != tenant_no:
+        return error_response(404, "职位不存在")
+    try:
+        user_svc.sync_post_user_bindings(
+            db, post_id, tenant_no, body.user_ids, user.get("user_id")
+        )
+        return success_response(None, message="保存成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
 # ---------------------------------------------------------------------------
 # 物品单位管理
 # ---------------------------------------------------------------------------
@@ -1340,3 +1431,64 @@ async def update_role_data_scope(
         return success_response(None, message="更新成功")
     except ValueError as e:
         return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 附件上传
+# ---------------------------------------------------------------------------
+
+
+def _format_file_size(size_bytes: int) -> str:
+    if size_bytes < 1024:
+        return f"{size_bytes} B"
+    elif size_bytes < 1024 * 1024:
+        return f"{size_bytes / 1024:.1f} KB"
+    else:
+        return f"{size_bytes / (1024 * 1024):.1f} MB"
+
+
+@router.post("/attachment/upload")
+async def upload_attachment(
+    file: UploadFile = File(...),
+    folder: Optional[str] = Form(""),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    if not file or not file.filename:
+        return error_response(400, "请选择文件")
+    try:
+        file_content = await file.read()
+        full_url = storage.upload_file(file_content, file.filename, folder or "")
+        base_url = settings.MINIO_BASE_URL.rstrip("/") if settings.MINIO_BASE_URL else ""
+        if base_url and full_url.startswith(base_url + "/"):
+            file_url = full_url[len(base_url) + 1:]
+        else:
+            file_url = full_url
+        file_size = len(file_content)
+        file_ext = os.path.splitext(file.filename)[1].lstrip(".") if file.filename else ""
+        file_type = file.content_type or ""
+        tenant_no = _get_tenant_no(db, user)
+        record = BizAttachment(
+            id=uuid.uuid4().hex,
+            original_name=file.filename,
+            file_ext=file_ext,
+            file_url=file_url,
+            file_size=file_size,
+            file_type=file_type,
+            tenant_no=tenant_no,
+            create_by=user.get("user_id"),
+        )
+        db.add(record)
+        db.commit()
+        db.refresh(record)
+        return success_response({
+            "id": record.id,
+            "fileName": record.original_name,
+            "fileUrl": record.file_url,
+            "fileSize": record.file_size,
+            "fileSizeDisplay": _format_file_size(record.file_size or 0),
+            "fileType": record.file_type,
+        })
+    except Exception as e:
+        db.rollback()
+        return error_response(500, f"上传失败: {str(e)}")
diff --git a/backend/app/api/basic_info.py b/backend/app/api/basic_info.py
new file mode 100644
index 00000000..92241a6a
--- /dev/null
+++ b/backend/app/api/basic_info.py
@@ -0,0 +1,860 @@
+"""基础信息管理 API（客户、样本类型、采集地区/医院、协议号池、样本编码池）"""
+from typing import Any, List, Optional
+
+from fastapi import APIRouter, Depends, Query
+from pydantic import BaseModel, ConfigDict, Field
+from sqlalchemy.orm import Session
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import error_response, success_response
+from app.crud import cell_sample_type as cell_type_svc
+from app.crud import collection_region as region_svc
+from app.crud import collection_protocol_no as protocol_no_svc
+from app.crud import customer as customer_svc
+from app.crud import sample_code as sample_code_svc
+from app.models.models import SysUser
+
+router = APIRouter(prefix="/web/admin", tags=["基础信息管理"])
+
+
+def _get_tenant_no(db: Session, user: dict) -> str:
+    user_id = user.get("user_id")
+    if not user_id:
+        raise PermissionError("用户身份信息缺失，无法确定租户")
+    sys_user = db.query(SysUser).filter(SysUser.id == user_id).first()
+    if not sys_user or not sys_user.tenant_no:
+        raise PermissionError("用户租户信息缺失")
+    return sys_user.tenant_no
+
+
+# ---------------------------------------------------------------------------
+# 客户
+# ---------------------------------------------------------------------------
+
+
+class CustomerCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    customer_name: str = Field(..., alias="customerName")
+    sex: Optional[str] = Field("2", alias="sex")
+    id_card_no: Optional[str] = Field(None, alias="idCardNo")
+    age: Optional[int] = None
+    phone_no: Optional[str] = Field(None, alias="phoneNo")
+    customer_tags: Optional[str] = Field(None, alias="customerTags")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class CustomerUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    customer_name: Optional[str] = Field(None, alias="customerName")
+    sex: Optional[str] = None
+    id_card_no: Optional[str] = Field(None, alias="idCardNo")
+    age: Optional[int] = None
+    phone_no: Optional[str] = Field(None, alias="phoneNo")
+    customer_tags: Optional[str] = Field(None, alias="customerTags")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/customers")
+async def list_customers(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = customer_svc.list_customers(db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no)
+    tp = customer_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/customers")
+async def create_customer(
+    body: CustomerCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = customer_svc.create_customer(
+            db,
+            customer_name=body.customer_name,
+            sex=body.sex or "2",
+            id_card_no=body.id_card_no,
+            age=body.age,
+            phone_no=body.phone_no,
+            customer_tags=body.customer_tags,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(customer_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/customers/{customer_id}")
+async def update_customer(
+    customer_id: str,
+    body: CustomerUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = customer_svc.update_customer(
+            db,
+            customer_id,
+            customer_name=payload.get("customer_name"),
+            sex=payload.get("sex"),
+            id_card_no=payload.get("id_card_no"),
+            age=payload.get("age"),
+            phone_no=payload.get("phone_no"),
+            customer_tags=payload.get("customer_tags"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(customer_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/customers/{customer_id}")
+async def delete_customer(
+    customer_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        customer_svc.soft_delete_customer(db, customer_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 细胞样本类型
+# ---------------------------------------------------------------------------
+
+
+class CellSampleTypeCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    type_code: str = Field(..., alias="typeCode")
+    type_name: str = Field(..., alias="typeName")
+    storage_years: Optional[int] = Field(None, alias="storageYears")
+    storage_price: Optional[float] = Field(None, alias="storagePrice")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class CellSampleTypeUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    type_code: Optional[str] = Field(None, alias="typeCode")
+    type_name: Optional[str] = Field(None, alias="typeName")
+    storage_years: Optional[int] = Field(None, alias="storageYears")
+    storage_price: Optional[float] = Field(None, alias="storagePrice")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/cell-sample-types")
+async def list_cell_sample_types(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = cell_type_svc.list_cell_sample_types(
+        db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    tp = cell_type_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/cell-sample-types")
+async def create_cell_sample_type(
+    body: CellSampleTypeCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = cell_type_svc.create_cell_sample_type(
+            db,
+            type_code=body.type_code,
+            type_name=body.type_name,
+            storage_years=body.storage_years,
+            storage_price=body.storage_price,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(cell_type_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/cell-sample-types/{row_id}")
+async def update_cell_sample_type(
+    row_id: str,
+    body: CellSampleTypeUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = cell_type_svc.update_cell_sample_type(
+            db,
+            row_id,
+            type_code=payload.get("type_code"),
+            type_name=payload.get("type_name"),
+            storage_years=payload.get("storage_years"),
+            storage_price=payload.get("storage_price"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(cell_type_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/cell-sample-types/{row_id}")
+async def delete_cell_sample_type(
+    row_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        cell_type_svc.soft_delete_cell_sample_type(db, row_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 采集地区
+# ---------------------------------------------------------------------------
+
+
+class CollectionRegionCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    region_name: str = Field(..., alias="regionName")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class CollectionRegionUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    region_name: Optional[str] = Field(None, alias="regionName")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/collection-regions")
+async def list_collection_regions(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = region_svc.list_collection_regions(
+        db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    tp = region_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/collection-regions")
+async def create_collection_region(
+    body: CollectionRegionCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = region_svc.create_collection_region(
+            db,
+            region_name=body.region_name,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(region_svc._region_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/collection-regions/{region_id}")
+async def update_collection_region(
+    region_id: str,
+    body: CollectionRegionUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = region_svc.update_collection_region(
+            db,
+            region_id,
+            region_name=payload.get("region_name"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(region_svc._region_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/collection-regions/{region_id}")
+async def delete_collection_region(
+    region_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        region_svc.soft_delete_collection_region(db, region_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 采集地区 — 下属医院
+# ---------------------------------------------------------------------------
+
+
+class HospitalCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    hospital_name: str = Field(..., alias="hospitalName")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class HospitalUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    hospital_name: Optional[str] = Field(None, alias="hospitalName")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/collection-regions/{region_id}/hospitals")
+async def list_hospitals(
+    region_id: str,
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        items, total = region_svc.list_hospitals(
+            db, region_id=region_id, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+        )
+        tp = region_svc.total_pages(total, pageSize)
+        return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/collection-regions/{region_id}/hospitals")
+async def create_hospital(
+    region_id: str,
+    body: HospitalCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = region_svc.create_hospital(
+            db,
+            region_id=region_id,
+            hospital_name=body.hospital_name,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(region_svc._hospital_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/collection-regions/{region_id}/hospitals/{hospital_id}")
+async def update_hospital(
+    region_id: str,
+    hospital_id: str,
+    body: HospitalUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        h = region_svc.get_hospital(db, hospital_id, tenant_no=tenant_no)
+        if not h or h.region_id != region_id:
+            return error_response(400, "医院不存在")
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = region_svc.update_hospital(
+            db,
+            hospital_id,
+            hospital_name=payload.get("hospital_name"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(region_svc._hospital_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/collection-regions/{region_id}/hospitals/{hospital_id}")
+async def delete_hospital(
+    region_id: str,
+    hospital_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        h = region_svc.get_hospital(db, hospital_id, tenant_no=tenant_no)
+        if not h or h.region_id != region_id:
+            return error_response(400, "医院不存在")
+        region_svc.soft_delete_hospital(db, hospital_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 采集协议号池
+# ---------------------------------------------------------------------------
+
+
+class ProtocolNoCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    protocol_no: str = Field(..., alias="protocolNo")
+    issued: int = 0
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class ProtocolNoUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    protocol_no: Optional[str] = Field(None, alias="protocolNo")
+    issued: Optional[int] = None
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+    issued_user_id: Optional[str] = Field(None, alias="issuedUserId")
+    issued_user_name: Optional[str] = Field(None, alias="issuedUserName")
+    issued_time: Optional[str] = Field(None, alias="issuedTime")
+
+
+@router.get("/collection-protocol-nos")
+async def list_protocol_nos(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = protocol_no_svc.list_protocol_nos(
+        db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    tp = protocol_no_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+class ProtocolNoBatchGenerateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    prefix: str = Field("ZKZX", alias="prefix")
+    middle: str = Field("34", alias="middle")
+    seq_start: int = Field(..., alias="seqStart")
+    seq_end: int = Field(..., alias="seqEnd")
+    digit_count: int = Field(6, alias="digitCount")
+
+
+class ProtocolNoBatchIssueBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ids: List[str] = Field(..., alias="ids")
+    issued_user_id: str = Field(..., alias="issuedUserId")
+    issued_user_name: Optional[str] = Field(None, alias="issuedUserName")
+
+
+@router.post("/collection-protocol-nos/batch-generate")
+async def batch_generate_protocol_nos(
+    body: ProtocolNoBatchGenerateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = protocol_no_svc.batch_generate_protocol_nos(
+            db,
+            prefix=body.prefix,
+            middle=body.middle,
+            seq_start=body.seq_start,
+            seq_end=body.seq_end,
+            digit_count=body.digit_count,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功生成 {result['created']} 条"
+        if result['skipped'] > 0:
+            msg += f"，跳过已存在 {result['skipped']} 条"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/collection-protocol-nos/batch-issue")
+async def batch_issue_protocol_nos(
+    body: ProtocolNoBatchIssueBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = protocol_no_svc.batch_issue_protocol_nos(
+            db,
+            ids=body.ids,
+            issued_user_id=body.issued_user_id,
+            issued_user_name=body.issued_user_name,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功下发 {result['issuedCount']} 条"
+        if result['alreadyIssued']:
+            msg += f"，{len(result['alreadyIssued'])} 条已下发被跳过"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+class ProtocolNoBatchRevokeBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ids: List[str] = Field(..., alias="ids")
+
+
+@router.post("/collection-protocol-nos/batch-revoke")
+async def batch_revoke_protocol_nos(
+    body: ProtocolNoBatchRevokeBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = protocol_no_svc.batch_revoke_protocol_nos(
+            db,
+            ids=body.ids,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功收回 {result['revokedCount']} 条"
+        if result["notIssued"]:
+            msg += f"，{len(result['notIssued'])} 条未下发已跳过"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/collection-protocol-nos")
+async def create_protocol_no(
+    body: ProtocolNoCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = protocol_no_svc.create_protocol_no(
+            db,
+            protocol_no=body.protocol_no,
+            issued=body.issued,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(protocol_no_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/collection-protocol-nos/{row_id}")
+async def update_protocol_no(
+    row_id: str,
+    body: ProtocolNoUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = protocol_no_svc.update_protocol_no(
+            db,
+            row_id,
+            protocol_no=payload.get("protocol_no"),
+            issued=payload.get("issued"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+            issued_user_id=payload.get("issued_user_id"),
+            issued_user_name=payload.get("issued_user_name"),
+            issued_time=payload.get("issued_time"),
+        )
+        return success_response(protocol_no_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/collection-protocol-nos/{row_id}")
+async def delete_protocol_no(
+    row_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        protocol_no_svc.soft_delete_protocol_no(db, row_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 样本编码池
+# ---------------------------------------------------------------------------
+
+
+class SampleCodeCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    sample_code: str = Field(..., alias="sampleCode")
+    issued: int = 0
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class SampleCodeUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    sample_code: Optional[str] = Field(None, alias="sampleCode")
+    issued: Optional[int] = None
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+    issued_user_id: Optional[str] = Field(None, alias="issuedUserId")
+    issued_user_name: Optional[str] = Field(None, alias="issuedUserName")
+    issued_time: Optional[str] = Field(None, alias="issuedTime")
+
+
+class SampleCodeBatchGenerateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    sample_code_type: str = Field(..., alias="sampleCodeType")
+    middle: str = Field("34", alias="middle")
+    seq_start: int = Field(..., alias="seqStart")
+    seq_end: int = Field(..., alias="seqEnd")
+    digit_count: int = Field(6, alias="digitCount")
+
+
+class SampleCodeBatchIssueBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ids: List[str] = Field(..., alias="ids")
+    issued_user_id: str = Field(..., alias="issuedUserId")
+    issued_user_name: Optional[str] = Field(None, alias="issuedUserName")
+
+
+@router.post("/sample-codes/batch-generate")
+async def batch_generate_sample_codes(
+    body: SampleCodeBatchGenerateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = sample_code_svc.batch_generate_sample_codes(
+            db,
+            sample_code_type=body.sample_code_type,
+            middle=body.middle,
+            seq_start=body.seq_start,
+            seq_end=body.seq_end,
+            digit_count=body.digit_count,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功生成 {result['created']} 条"
+        if result["skipped"] > 0:
+            msg += f"，跳过已存在 {result['skipped']} 条"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/sample-codes/batch-issue")
+async def batch_issue_sample_codes(
+    body: SampleCodeBatchIssueBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = sample_code_svc.batch_issue_sample_codes(
+            db,
+            ids=body.ids,
+            issued_user_id=body.issued_user_id,
+            issued_user_name=body.issued_user_name,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功下发 {result['issuedCount']} 条"
+        if result["alreadyIssued"]:
+            msg += f"，{len(result['alreadyIssued'])} 条已下发被跳过"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+class SampleCodeBatchRevokeBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ids: List[str] = Field(..., alias="ids")
+
+
+@router.post("/sample-codes/batch-revoke")
+async def batch_revoke_sample_codes(
+    body: SampleCodeBatchRevokeBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        result = sample_code_svc.batch_revoke_sample_codes(
+            db,
+            ids=body.ids,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        msg = f"成功收回 {result['revokedCount']} 条"
+        if result["notIssued"]:
+            msg += f"，{len(result['notIssued'])} 条未下发已跳过"
+        return success_response(result, message=msg)
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.get("/sample-codes")
+async def list_sample_codes(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = sample_code_svc.list_sample_codes(
+        db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    tp = sample_code_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/sample-codes")
+async def create_sample_code(
+    body: SampleCodeCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = sample_code_svc.create_sample_code(
+            db,
+            sample_code=body.sample_code,
+            issued=body.issued,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(sample_code_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/sample-codes/{row_id}")
+async def update_sample_code(
+    row_id: str,
+    body: SampleCodeUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = sample_code_svc.update_sample_code(
+            db,
+            row_id,
+            sample_code=payload.get("sample_code"),
+            issued=payload.get("issued"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+            issued_user_id=payload.get("issued_user_id"),
+            issued_user_name=payload.get("issued_user_name"),
+            issued_time=payload.get("issued_time"),
+        )
+        return success_response(sample_code_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/sample-codes/{row_id}")
+async def delete_sample_code(
+    row_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        sample_code_svc.soft_delete_sample_code(db, row_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
diff --git a/backend/app/api/collection_protocol.py b/backend/app/api/collection_protocol.py
new file mode 100644
index 00000000..e65ff1b3
--- /dev/null
+++ b/backend/app/api/collection_protocol.py
@@ -0,0 +1,513 @@
+"""细胞存储 — 采集协议单 / 审核 / 财务确认 / 分期预警 API"""
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, Depends, Query
+from pydantic import BaseModel, ConfigDict, Field
+from sqlalchemy.orm import Session
+
+from sqlalchemy import and_ as sa_and
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import error_response, success_response
+from app.core.utils import parse_datetime
+from app.crud import collection_protocol as cp_svc
+from app.crud import customer as customer_crud
+from app.models.models import BizCollectionProtocol, BizCustomer, SysUser
+
+router = APIRouter(prefix="/web/admin", tags=["细胞存储"])
+
+
+def _get_tenant_no(db: Session, user: dict) -> str:
+    user_id = user.get("user_id")
+    if not user_id:
+        raise PermissionError("用户身份信息缺失，无法确定租户")
+    sys_user = db.query(SysUser).filter(SysUser.id == user_id).first()
+    if not sys_user or not sys_user.tenant_no:
+        raise PermissionError("用户租户信息缺失")
+    return sys_user.tenant_no
+
+
+def _get_current_user_id(user: dict) -> str:
+    user_id = user.get("user_id")
+    if not user_id:
+        raise PermissionError("用户身份信息缺失")
+    return str(user_id)
+
+
+_CAMEL_TO_SNAKE_DATETIME = {
+    "newbornDeliveryTime": "newborn_delivery_time",
+    "sampleCollectTime": "sample_collect_time",
+    "maternalBloodCollectTime": "maternal_blood_collect_time",
+}
+
+
+def _parse_datetime_fields(d: dict, camel_keys: list) -> None:
+    for camel in camel_keys:
+        val = d.get(camel)
+        if val is not None and isinstance(val, str):
+            snake = _CAMEL_TO_SNAKE_DATETIME.get(camel, camel)
+            parsed = parse_datetime(val)
+            if parsed:
+                d.pop(camel, None)
+                d[snake] = parsed
+            else:
+                d.pop(camel, None)
+                d[snake] = None
+
+
+def _ensure_customer_for_mother(db: Session, party_customer: dict, tenant_no: str, user_id: str) -> dict:
+    """If mother info exists but no customerId, create a customer record and link it."""
+    if not party_customer:
+        return party_customer
+    customer_id = party_customer.get("customer_id") or party_customer.get("customerId")
+    mother_name = (party_customer.get("mother_name") or party_customer.get("motherName") or "").strip()
+    if customer_id or not mother_name:
+        return party_customer
+    # Build customer fields from mother info
+    mother_phone = (party_customer.get("mother_phone") or party_customer.get("motherPhone") or "").strip() or None
+    mother_id_card = (party_customer.get("mother_id_card") or party_customer.get("motherIdCard") or "").strip() or None
+
+    # Check if customer with this id_card already exists
+    if mother_id_card and customer_crud.id_card_taken(db, mother_id_card, tenant_no):
+        existing = db.query(BizCustomer).filter(
+            sa_and(
+                BizCustomer.id_card_no == mother_id_card,
+                BizCustomer.tenant_no == tenant_no,
+                BizCustomer.del_flag == 0,
+            )
+        ).first()
+        if existing:
+            party_customer["customer_id"] = existing.id
+            return party_customer
+
+    # Create new customer
+    try:
+        obj = customer_crud.create_customer(
+            db,
+            customer_name=mother_name,
+            sex="1",  # female (mother)
+            id_card_no=mother_id_card,
+            phone_no=mother_phone,
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        party_customer["customer_id"] = obj.id
+    except ValueError:
+        # If creation fails (e.g. duplicate), try to find existing
+        pass
+    return party_customer
+
+
+# ---------------------------------------------------------------------------
+# 采集协议单
+# ---------------------------------------------------------------------------
+
+
+@router.get("/collection-protocols")
+async def list_collection_protocols(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    protocolStatus: Optional[str] = Query(None, alias="protocolStatus"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    current_user_id = _get_current_user_id(user)
+    items, total = cp_svc.list_collection_protocols(
+        db,
+        page=page,
+        page_size=pageSize,
+        keyword=keyword,
+        protocol_status=protocolStatus,
+        tenant_no=tenant_no,
+        scope_collector_user_id=current_user_id,
+    )
+    tp = cp_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.get("/collection-protocols/{protocol_id}")
+async def get_collection_protocol_detail(
+    protocol_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    current_user_id = _get_current_user_id(user)
+    bundle = cp_svc.get_protocol_detail_bundle(
+        db, protocol_id, tenant_no, scope_collector_user_id=current_user_id
+    )
+    if not bundle:
+        return error_response(404, "协议单不存在或无权查看")
+    return success_response(bundle)
+
+
+class ProtocolCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    protocol_no: str = Field(..., alias="protocolNo")
+    protocol_no_id: Optional[str] = Field(None, alias="protocolNoId")
+    protocol_status: str = Field("dsx", alias="protocolStatus")
+    protocol_attachments: Optional[str] = Field(None, alias="protocolAttachments")
+    register_date: Optional[str] = Field(None, alias="registerDate")
+    collector_user_id: Optional[str] = Field(None, alias="collectorUserId")
+    remark: Optional[str] = None
+    party_customer: Optional[dict] = Field(None, alias="partyCustomer")
+    collection_info: Optional[dict] = Field(None, alias="collectionInfo")
+    samples: Optional[list] = Field(None, alias="samples")
+    payment: Optional[dict] = Field(None, alias="payment")
+    payment_details: Optional[list] = Field(None, alias="paymentDetails")
+    attachments: Optional[list] = Field(None, alias="attachments")
+    storage_cert: Optional[dict] = Field(None, alias="storageCert")
+
+
+class ProtocolUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    protocol_no: Optional[str] = Field(None, alias="protocolNo")
+    protocol_status: Optional[str] = Field(None, alias="protocolStatus")
+    protocol_attachments: Optional[str] = Field(None, alias="protocolAttachments")
+    register_date: Optional[str] = Field(None, alias="registerDate")
+    effective_time: Optional[str] = Field(None, alias="effectiveTime")
+    effective_desc: Optional[str] = Field(None, alias="effectiveDesc")
+    expire_time: Optional[str] = Field(None, alias="expireTime")
+    expire_desc: Optional[str] = Field(None, alias="expireDesc")
+    void_time: Optional[str] = Field(None, alias="voidTime")
+    void_desc: Optional[str] = Field(None, alias="voidDesc")
+    to_research_time: Optional[str] = Field(None, alias="toResearchTime")
+    to_research_desc: Optional[str] = Field(None, alias="toResearchDesc")
+    collector_user_id: Optional[str] = Field(None, alias="collectorUserId")
+    remark: Optional[str] = None
+    party_customer: Optional[dict] = Field(None, alias="partyCustomer")
+    collection_info: Optional[dict] = Field(None, alias="collectionInfo")
+    samples: Optional[list] = Field(None, alias="samples")
+    payment: Optional[dict] = Field(None, alias="payment")
+    payment_details: Optional[list] = Field(None, alias="paymentDetails")
+    attachments: Optional[list] = Field(None, alias="attachments")
+    storage_cert: Optional[dict] = Field(None, alias="storageCert")
+
+
+def _resolve_protocol_attachments(
+    protocol_attachments: Optional[str],
+    attachments: Optional[list],
+) -> Optional[str]:
+    from_urls = cp_svc.attachments_to_urls(attachments)
+    if from_urls:
+        return from_urls
+    return protocol_attachments
+
+
+def _persist_protocol_sub_resources(
+    db: Session,
+    protocol_id: str,
+    tenant_no: str,
+    user_id: str,
+    *,
+    party_customer: Optional[dict],
+    collection_info: Optional[dict],
+    samples: Optional[list],
+    payment: Optional[dict],
+    payment_details: Optional[list],
+    storage_cert: Optional[dict],
+) -> None:
+    if party_customer:
+        _parse_datetime_fields(party_customer, ["newbornDeliveryTime"])
+        party_customer = _ensure_customer_for_mother(db, party_customer, tenant_no, user_id)
+        cp_svc.upsert_party_customer(db, protocol_id, tenant_no, user_id, **party_customer)
+    if collection_info:
+        _parse_datetime_fields(collection_info, ["sampleCollectTime", "maternalBloodCollectTime"])
+        cp_svc.upsert_collection_info(db, protocol_id, tenant_no, user_id, **collection_info)
+    if samples is not None:
+        cp_svc.save_samples(db, protocol_id, tenant_no, user_id, samples)
+    if payment:
+        cp_svc.upsert_payment(db, protocol_id, tenant_no, user_id, **payment)
+    if payment_details is not None:
+        pay = cp_svc.get_payment_by_protocol_id(db, protocol_id, tenant_no)
+        if not pay and payment:
+            pay = cp_svc.upsert_payment(db, protocol_id, tenant_no, user_id, **payment)
+        if pay:
+            cp_svc.save_payment_details(db, pay.id, tenant_no, user_id, payment_details)
+    if storage_cert:
+        cp_svc.upsert_storage_cert(db, protocol_id, tenant_no, user_id, **storage_cert)
+
+
+@router.post("/collection-protocols")
+async def create_collection_protocol(
+    body: ProtocolCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    user_id = _get_current_user_id(user)
+    try:
+        protocol_attachments = _resolve_protocol_attachments(
+            body.protocol_attachments,
+            body.attachments,
+        )
+        obj = cp_svc.create_collection_protocol(
+            db,
+            protocol_no=body.protocol_no,
+            protocol_no_id=body.protocol_no_id,
+            protocol_status=body.protocol_status,
+            protocol_attachments=protocol_attachments,
+            register_date=body.register_date,
+            collector_user_id=user_id,
+            remark=body.remark,
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        protocol_id = obj.id
+        _persist_protocol_sub_resources(
+            db,
+            protocol_id,
+            tenant_no,
+            user_id,
+            party_customer=body.party_customer,
+            collection_info=body.collection_info,
+            samples=body.samples,
+            payment=body.payment,
+            payment_details=body.payment_details,
+            storage_cert=body.storage_cert,
+        )
+        return success_response(cp_svc._protocol_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/collection-protocols/{protocol_id}")
+async def update_collection_protocol(
+    protocol_id: str,
+    body: ProtocolUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    user_id = _get_current_user_id(user)
+    try:
+        payload = body.model_dump(exclude_unset=True, by_alias=False)
+        sub_keys = {
+            "party_customer", "collection_info", "samples",
+            "payment", "payment_details", "attachments", "storage_cert",
+        }
+        main_payload = {k: v for k, v in payload.items() if k not in sub_keys}
+        main_payload.pop("collector_user_id", None)
+        if body.attachments is not None:
+            resolved = _resolve_protocol_attachments(
+                main_payload.get("protocol_attachments"),
+                body.attachments,
+            )
+            if resolved is not None:
+                main_payload["protocol_attachments"] = resolved
+        obj = cp_svc.update_collection_protocol(
+            db,
+            protocol_id,
+            tenant_no=tenant_no,
+            user_id=user_id,
+            scope_collector_user_id=user_id,
+            **{k: v for k, v in main_payload.items() if v is not None},
+        )
+        _persist_protocol_sub_resources(
+            db,
+            protocol_id,
+            tenant_no,
+            user_id,
+            party_customer=body.party_customer,
+            collection_info=body.collection_info,
+            samples=body.samples,
+            payment=body.payment,
+            payment_details=body.payment_details,
+            storage_cert=body.storage_cert,
+        )
+        return success_response(cp_svc._protocol_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/collection-protocols/{protocol_id}")
+async def delete_collection_protocol(
+    protocol_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    user_id = _get_current_user_id(user)
+    try:
+        cp_svc.soft_delete_collection_protocol(
+            db,
+            protocol_id,
+            tenant_no=tenant_no,
+            scope_collector_user_id=user_id,
+            user_id=user_id,
+        )
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 审核
+# ---------------------------------------------------------------------------
+
+
+@router.get("/collection-protocol-audits")
+async def list_collection_protocol_audits(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    auditStatus: Optional[str] = Query(None, alias="auditStatus"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = cp_svc.list_audits(
+        db,
+        page=page,
+        page_size=pageSize,
+        keyword=keyword,
+        audit_status=auditStatus,
+        tenant_no=tenant_no,
+    )
+    tp = cp_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+class AuditCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    audit_status: str = Field(..., alias="auditStatus")
+    audit_remark: Optional[str] = Field(None, alias="auditRemark")
+
+
+@router.post("/collection-protocols/{protocol_id}/audit")
+async def submit_collection_protocol_audit(
+    protocol_id: str,
+    body: AuditCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    try:
+        cp_svc.create_audit(
+            db,
+            collection_protocol_id=protocol_id,
+            audit_status=body.audit_status,
+            audit_remark=body.audit_remark,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        p = db.query(BizCollectionProtocol).filter(BizCollectionProtocol.id == protocol_id).first()
+        pn = (p.protocol_no if p else "") or ""
+        return success_response({"protocolNo": pn}, message="审核已提交")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 收款确认
+# ---------------------------------------------------------------------------
+
+
+@router.get("/protocol-payment-details/receipt-confirm")
+async def list_receipt_confirm(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = cp_svc.list_receipt_confirm_details(db, page=page, page_size=pageSize, tenant_no=tenant_no)
+    tp = cp_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+class FinanceConfirmBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    finance_confirm_attachments: Optional[str] = Field(None, alias="financeConfirmAttachments")
+
+
+@router.post("/protocol-payment-details/{detail_id}/receipt-confirm")
+async def post_receipt_confirm(
+    detail_id: str,
+    body: FinanceConfirmBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    try:
+        cp_svc.confirm_receipt(
+            db,
+            detail_id=detail_id,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+            finance_confirm_attachments=body.finance_confirm_attachments,
+        )
+        return success_response(None, message="确认成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 退费确认
+# ---------------------------------------------------------------------------
+
+
+@router.get("/protocol-payment-details/refund-confirm")
+async def list_refund_confirm(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = cp_svc.list_refund_confirm_details(db, page=page, page_size=pageSize, tenant_no=tenant_no)
+    tp = cp_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/protocol-payment-details/{detail_id}/refund-confirm")
+async def post_refund_confirm(
+    detail_id: str,
+    body: FinanceConfirmBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    try:
+        cp_svc.confirm_refund(
+            db,
+            detail_id=detail_id,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+            finance_confirm_attachments=body.finance_confirm_attachments,
+        )
+        return success_response(None, message="确认成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 分期预警
+# ---------------------------------------------------------------------------
+
+
+@router.get("/protocol-payment-details/installment-warning")
+async def list_installment_warning(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    warningType: str = Query("all", alias="warningType"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = cp_svc.list_installment_warning(
+        db,
+        page=page,
+        page_size=pageSize,
+        warning_type=warningType,
+        tenant_no=tenant_no,
+    )
+    tp = cp_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
diff --git a/backend/app/api/ethnic.py b/backend/app/api/ethnic.py
new file mode 100644
index 00000000..67c25193
--- /dev/null
+++ b/backend/app/api/ethnic.py
@@ -0,0 +1,24 @@
+"""民族码表（下拉检索）"""
+from typing import Optional
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.orm import Session
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import success_response
+from app.crud import ethnic as ethnic_svc
+
+router = APIRouter(prefix="/web/admin", tags=["民族码表"])
+
+
+@router.get("/ethnics")
+async def list_ethnics_for_select(
+    keyword: Optional[str] = Query(None, description="民族名称模糊检索"),
+    limit: int = Query(200, ge=1, le=500),
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    """返回民族码表选项（按排序号升序）。"""
+    rows = ethnic_svc.list_ethnics(db, keyword=keyword, limit=limit)
+    return success_response({"list": rows})
diff --git a/backend/app/api/leave.py b/backend/app/api/leave.py
new file mode 100644
index 00000000..8ddb48eb
--- /dev/null
+++ b/backend/app/api/leave.py
@@ -0,0 +1,205 @@
+"""请假申请 API — 工作流测试"""
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.orm import Session
+
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.database import get_db
+from app.core.response import success_response, error_response
+from app.crud import leave as leave_crud
+from app.crud.leave import total_pages
+from app.schemas.leave import LeaveCreate, LeaveUpdate
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/web/admin/leave", tags=["请假管理"])
+
+_LEAVE_TYPE_MAP = {"personal": "事假", "sick": "病假", "annual": "年假", "other": "其他"}
+
+
+def _leave_local_callback(db: Session, business_id: str, event: str) -> None:
+    if not business_id:
+        return
+    if event == "completed":
+        leave_crud.update_leave_status(db, business_id, "approved")
+    elif event == "rejected":
+        leave_crud.update_leave_status(db, business_id, "rejected")
+    db.commit()
+
+
+from app.services.workflow_callback import register_local_callback
+register_local_callback("/api/admin/leave/callback", _leave_local_callback)
+
+
+@router.get("")
+async def list_leaves(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100),
+    keyword: Optional[str] = Query(None),
+    status: Optional[str] = Query(None),
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "")
+    user_id = _user.get("user_id") or _user.get("id", "")
+    items, total = leave_crud.list_leaves(
+        db, page=page, page_size=pageSize, keyword=keyword, status=status,
+        tenant_no=tenant_no, create_by=user_id,
+    )
+    for item in items:
+        item["leaveTypeLabel"] = _LEAVE_TYPE_MAP.get(item.get("leaveType", ""), item.get("leaveType", ""))
+    return success_response({
+        "list": items, "total": total, "page": page, "pageSize": pageSize,
+        "totalPages": total_pages(total, pageSize),
+    })
+
+
+@router.post("")
+async def create_leave(
+    body: LeaveCreate,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "")
+    user_id = _user.get("user_id") or _user.get("id", "")
+    dept_id = _user.get("deptId", "")
+    row = leave_crud.create_leave(
+        db,
+        leave_type=body.leaveType,
+        start_date=body.startDate,
+        end_date=body.endDate,
+        days=body.days,
+        reason=body.reason or "",
+        tenant_no=tenant_no,
+        user_id=user_id,
+        dept_id=dept_id,
+        remark=body.remark or "",
+    )
+    db.commit()
+    return success_response(leave_crud._row_to_dict(row))
+
+
+@router.post("/{leave_id}/submit")
+async def submit_leave(
+    leave_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    from app.models.models import WfProcessDef
+    from app.services.workflow_engine import WorkflowEngine
+
+    tenant_no = _user.get("tenant_no", "")
+    user_id = _user.get("user_id") or _user.get("id", "")
+
+    leave = leave_crud.get_leave(db, leave_id)
+    if not leave:
+        return error_response(404, "请假记录不存在")
+
+    if leave["status"] not in ("draft", "rejected"):
+        return error_response(400, "只有草稿或已驳回的请假单可以提交")
+
+    defn = db.query(WfProcessDef).filter(
+        WfProcessDef.process_code == "leave_request",
+        WfProcessDef.del_flag == 0,
+        WfProcessDef.status == "1",
+    ).first()
+    if not defn:
+        return error_response(400, "未找到请假审批流程(leave_request)，请先在流程配置中创建并发布")
+
+    variables = {
+        "days": leave["days"],
+        "leave_days": leave["days"],
+        "leaveType": leave["leaveType"],
+        "applicant": user_id,
+    }
+
+    try:
+        engine = WorkflowEngine(db)
+        instance = engine.start_process(
+            process_def_id=defn.id,
+            business_type="leave",
+            business_id=leave_id,
+            starter_user_id=user_id,
+            variables=variables,
+            callback_url="/api/admin/leave/callback",
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        leave_crud.update_leave_status(db, leave_id, "pending", wf_instance_id=instance.id, user_id=user_id)
+        db.commit()
+        return success_response({"instanceId": instance.id, "status": "pending"})
+    except Exception as e:
+        db.rollback()
+        logger.exception("发起请假审批失败: %s", e)
+        return error_response(500, f"发起审批失败: {e}")
+
+
+@router.post("/callback")
+async def leave_workflow_callback(
+    body: dict,
+    db: Session = Depends(get_db),
+):
+    logger.info("请假工作流回调: %s", body)
+    business_id = body.get("businessId", "")
+    event = body.get("event", "")
+    if not business_id:
+        return success_response({"received": True})
+
+    if event == "completed":
+        leave_crud.update_leave_status(db, business_id, "approved")
+    elif event == "rejected":
+        leave_crud.update_leave_status(db, business_id, "rejected")
+    db.commit()
+    return success_response({"received": True})
+
+
+@router.get("/{leave_id}")
+async def get_leave(
+    leave_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    item = leave_crud.get_leave(db, leave_id)
+    if not item:
+        return error_response(404, "请假记录不存在")
+    item["leaveTypeLabel"] = _LEAVE_TYPE_MAP.get(item.get("leaveType", ""), item.get("leaveType", ""))
+    return success_response(item)
+
+
+@router.delete("/{leave_id}")
+async def delete_leave(
+    leave_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = _user.get("user_id") or _user.get("id", "")
+    leave = leave_crud.get_leave(db, leave_id)
+    if not leave:
+        return error_response(404, "请假记录不存在")
+    if leave["status"] == "pending":
+        return error_response(400, "审批中的请假单不能删除")
+    leave_crud.soft_delete_leave(db, leave_id, user_id=user_id)
+    db.commit()
+    return success_response(None)
+
+
+@router.put("/{leave_id}")
+async def update_leave(
+    leave_id: str,
+    body: LeaveUpdate,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = _user.get("user_id") or _user.get("id", "")
+    leave = leave_crud.get_leave(db, leave_id)
+    if not leave:
+        return error_response(404, "请假记录不存在")
+    if leave["status"] not in ("draft", "rejected"):
+        return error_response(400, "只有草稿或已驳回状态可以编辑")
+    leave_crud.update_leave(db, leave_id, user_id=user_id, **body.model_dump(exclude_none=True))
+    db.commit()
+    return success_response(leave_crud.get_leave(db, leave_id))
diff --git a/backend/app/api/menu.py b/backend/app/api/menu.py
index 86bcfced..763ce147 100644
--- a/backend/app/api/menu.py
+++ b/backend/app/api/menu.py
@@ -6,7 +6,7 @@ from app.core.response import success_response
 
 router = APIRouter(prefix="/web/menu", tags=["菜单管理"])
 
-# 与 web-admin/src/router/modules/sqxp.ts 一致：「Demo」参考页 +「系统管理」
+# 与 web-admin/src/router/modules/sqxp.ts 一致：Demo、系统管理、基础信息管理 等
 STATIC_MENU_TREE = [
     {
         "id": "10000000000000000000000000000002",
@@ -98,6 +98,104 @@ STATIC_MENU_TREE = [
             },
         ],
     },
+    {
+        "id": "40000000000000000000000000000001",
+        "name": "BasicInfo",
+        "path": "/basic-info",
+        "component": "/index/index",
+        "meta": {
+            "title": "基础信息管理",
+            "icon": "ri:folder-user-line",
+            "keepAlive": False,
+            "roles": ["admin"],
+        },
+        "children": [
+            {
+                "id": "40000000000000000000000000000002",
+                "name": "BizCustomer",
+                "path": "customer",
+                "component": "/basic-info/customer/index",
+                "meta": {"title": "客户管理", "keepAlive": True},
+            },
+            {
+                "id": "40000000000000000000000000000003",
+                "name": "BizCellSampleType",
+                "path": "cell-sample-type",
+                "component": "/basic-info/cell-sample-type/index",
+                "meta": {"title": "细胞样本类型管理", "keepAlive": True},
+            },
+            {
+                "id": "40000000000000000000000000000004",
+                "name": "BizCollectionRegion",
+                "path": "collection-region",
+                "component": "/basic-info/collection-region/index",
+                "meta": {"title": "采集地区及医院管理", "keepAlive": True},
+            },
+            {
+                "id": "40000000000000000000000000000005",
+                "name": "BizCollectionProtocolNo",
+                "path": "collection-protocol-no",
+                "component": "/basic-info/collection-protocol-no/index",
+                "meta": {"title": "采集协议号管理", "keepAlive": True},
+            },
+            {
+                "id": "40000000000000000000000000000006",
+                "name": "BizSampleCode",
+                "path": "sample-code",
+                "component": "/basic-info/sample-code/index",
+                "meta": {"title": "样本编码管理", "keepAlive": True},
+            },
+        ],
+    },
+    {
+        "id": "50000000000000000000000000000001",
+        "name": "CellStorage",
+        "path": "/cell-storage",
+        "component": "/index/index",
+        "meta": {
+            "title": "细胞存储管理",
+            "icon": "ri:test-tube-line",
+            "keepAlive": False,
+            "roles": ["admin"],
+        },
+        "children": [
+            {
+                "id": "50000000000000000000000000000002",
+                "name": "CellStorageProtocol",
+                "path": "protocol",
+                "component": "/cell-storage/protocol/index",
+                "meta": {"title": "采集协议单", "keepAlive": True},
+            },
+            {
+                "id": "50000000000000000000000000000003",
+                "name": "CellStorageProtocolAudit",
+                "path": "protocol-audit",
+                "component": "/cell-storage/protocol-audit/index",
+                "meta": {"title": "采集协议单审核", "keepAlive": True},
+            },
+            {
+                "id": "50000000000000000000000000000004",
+                "name": "CellStoragePaymentConfirm",
+                "path": "payment-confirm",
+                "component": "/cell-storage/payment-confirm/index",
+                "meta": {"title": "采集协议单收款确认（财务确认）", "keepAlive": True},
+            },
+            {
+                "id": "50000000000000000000000000000005",
+                "name": "CellStorageRefundConfirm",
+                "path": "refund-confirm",
+                "component": "/cell-storage/refund-confirm/index",
+                "meta": {"title": "采集协议单退费确认（财务确认）", "keepAlive": True},
+            },
+            {
+                "id": "50000000000000000000000000000006",
+                "name": "CellStorageInstallmentWarning",
+                "path": "installment-warning",
+                "component": "/cell-storage/installment-warning/index",
+                "meta": {"title": "分期缴费用户预警模块", "keepAlive": True},
+            },
+        ],
+    },
 ]
 
 
diff --git a/backend/app/api/operations.py b/backend/app/api/operations.py
new file mode 100644
index 00000000..5ec2bd0f
--- /dev/null
+++ b/backend/app/api/operations.py
@@ -0,0 +1,598 @@
+"""运营支撑 API（洁净室、进出记录、仓储设施、储位、展厅预约）"""
+from datetime import datetime
+from typing import Any, Optional
+
+from fastapi import APIRouter, Depends, Query
+from pydantic import BaseModel, ConfigDict, Field
+from sqlalchemy.orm import Session
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import error_response, success_response
+from app.crud import clean_room as clean_room_svc
+from app.crud import exhibition_appointment as exhibition_svc
+from app.crud import storage_facility as storage_facility_svc
+from app.models.models import SysUser
+
+router = APIRouter(prefix="/web/admin", tags=["运营支撑"])
+
+
+def _get_tenant_no(db: Session, user: dict) -> str:
+    user_id = user.get("user_id")
+    if not user_id:
+        raise PermissionError("用户身份信息缺失，无法确定租户")
+    sys_user = db.query(SysUser).filter(SysUser.id == user_id).first()
+    if not sys_user or not sys_user.tenant_no:
+        raise PermissionError("用户租户信息缺失")
+    return sys_user.tenant_no
+
+
+# ---------------------------------------------------------------------------
+# 洁净室
+# ---------------------------------------------------------------------------
+
+
+class CleanRoomCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    room_code: str = Field(..., alias="roomCode")
+    room_name: str = Field(..., alias="roomName")
+    room_grade: Optional[str] = Field(None, alias="roomGrade")
+    room_status: Optional[str] = Field("zc", alias="roomStatus")
+    area_sqm: Optional[float] = Field(None, alias="areaSqm")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class CleanRoomUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    room_code: Optional[str] = Field(None, alias="roomCode")
+    room_name: Optional[str] = Field(None, alias="roomName")
+    room_grade: Optional[str] = Field(None, alias="roomGrade")
+    room_status: Optional[str] = Field(None, alias="roomStatus")
+    area_sqm: Optional[float] = Field(None, alias="areaSqm")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/clean-rooms")
+async def list_clean_rooms(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = clean_room_svc.list_clean_rooms(db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no)
+    tp = clean_room_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/clean-rooms")
+async def create_clean_room(
+    body: CleanRoomCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = clean_room_svc.create_clean_room(
+            db,
+            room_code=body.room_code,
+            room_name=body.room_name,
+            room_grade=body.room_grade,
+            room_status=body.room_status or "zc",
+            area_sqm=body.area_sqm,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(clean_room_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/clean-rooms/{room_id}")
+async def update_clean_room(
+    room_id: str,
+    body: CleanRoomUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = clean_room_svc.update_clean_room(
+            db,
+            room_id,
+            room_code=payload.get("room_code"),
+            room_name=payload.get("room_name"),
+            room_grade=payload.get("room_grade"),
+            room_status=payload.get("room_status"),
+            area_sqm=payload.get("area_sqm"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(clean_room_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/clean-rooms/{room_id}")
+async def delete_clean_room(
+    room_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        clean_room_svc.soft_delete_clean_room(db, room_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 进出记录
+# ---------------------------------------------------------------------------
+
+
+class AccessLogCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    clean_room_id: str = Field(..., alias="cleanRoomId")
+    person_name: Optional[str] = Field(None, alias="personName")
+    dept_name: Optional[str] = Field(None, alias="deptName")
+    enter_time: Optional[str] = Field(None, alias="enterTime")
+    purpose: Optional[str] = None
+    leave_time: Optional[str] = Field(None, alias="leaveTime")
+    body_temp: Optional[str] = Field(None, alias="bodyTemp")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class AccessLogUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    person_name: Optional[str] = Field(None, alias="personName")
+    dept_name: Optional[str] = Field(None, alias="deptName")
+    enter_time: Optional[str] = Field(None, alias="enterTime")
+    purpose: Optional[str] = None
+    leave_time: Optional[str] = Field(None, alias="leaveTime")
+    body_temp: Optional[str] = Field(None, alias="bodyTemp")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+def _parse_optional_dt(value: Optional[str]) -> Optional[datetime]:
+    if not value:
+        return None
+    return datetime.fromisoformat(value)
+
+
+@router.get("/clean-room-access-logs")
+async def list_access_logs(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    cleanRoomId: str = Query(..., alias="cleanRoomId"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = clean_room_svc.list_access_logs(db, page=page, page_size=pageSize, clean_room_id=cleanRoomId, keyword=keyword, tenant_no=tenant_no)
+    tp = clean_room_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/clean-room-access-logs")
+async def create_access_log(
+    body: AccessLogCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = clean_room_svc.create_access_log(
+            db,
+            clean_room_id=body.clean_room_id,
+            person_name=body.person_name,
+            dept_name=body.dept_name,
+            enter_time=_parse_optional_dt(body.enter_time),
+            purpose=body.purpose,
+            leave_time=_parse_optional_dt(body.leave_time),
+            body_temp=body.body_temp,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id_param=user.get("user_id"),
+        )
+        return success_response(clean_room_svc._access_log_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/clean-room-access-logs/{log_id}")
+async def update_access_log(
+    log_id: str,
+    body: AccessLogUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = clean_room_svc.update_access_log(
+            db,
+            log_id,
+            person_name=payload.get("person_name"),
+            dept_name=payload.get("dept_name"),
+            enter_time=_parse_optional_dt(payload.get("enter_time")) if "enter_time" in payload else None,
+            purpose=payload.get("purpose"),
+            leave_time=_parse_optional_dt(payload.get("leave_time")) if "leave_time" in payload else None,
+            body_temp=payload.get("body_temp"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id_param=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(clean_room_svc._access_log_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/clean-room-access-logs/{log_id}")
+async def delete_access_log(
+    log_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        clean_room_svc.soft_delete_access_log(db, log_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 仓储设施
+# ---------------------------------------------------------------------------
+
+
+class StorageFacilityCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    parent_id: str = Field("0", alias="parentId")
+    node_name: str = Field(..., alias="nodeName")
+    node_type: Optional[str] = Field(None, alias="nodeType")
+    is_leaf: Optional[int] = Field(0, alias="isLeaf")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class StorageFacilityUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    node_name: Optional[str] = Field(None, alias="nodeName")
+    node_type: Optional[str] = Field(None, alias="nodeType")
+    is_leaf: Optional[int] = Field(None, alias="isLeaf")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/storage-facilities")
+async def list_storage_facilities(
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items = storage_facility_svc.list_all_facilities(db, tenant_no=tenant_no, keyword=keyword)
+    return success_response(items)
+
+
+@router.post("/storage-facilities")
+async def create_storage_facility(
+    body: StorageFacilityCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = storage_facility_svc.create_facility(
+            db,
+            parent_id=body.parent_id,
+            node_name=body.node_name,
+            node_type=body.node_type,
+            is_leaf=body.is_leaf,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(storage_facility_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/storage-facilities/{node_id}")
+async def update_storage_facility(
+    node_id: str,
+    body: StorageFacilityUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = storage_facility_svc.update_facility(
+            db,
+            node_id,
+            node_name=payload.get("node_name"),
+            node_type=payload.get("node_type"),
+            is_leaf=payload.get("is_leaf"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(storage_facility_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/storage-facilities/{node_id}")
+async def delete_storage_facility(
+    node_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        storage_facility_svc.soft_delete_facility(db, node_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 储位
+# ---------------------------------------------------------------------------
+
+
+class StorageSlotCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    facility_node_id: str = Field(..., alias="facilityNodeId")
+    slot_code: Optional[str] = Field(None, alias="slotCode")
+    slot_status: Optional[str] = Field(None, alias="slotStatus")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class StorageSlotBatchCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    facility_node_id: str = Field(..., alias="facilityNodeId")
+    rows: int = Field(..., ge=1, le=50)
+    cols: int = Field(..., ge=1, le=50)
+    code_prefix: Optional[str] = Field("", alias="codePrefix")
+
+
+class StorageSlotUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    slot_code: Optional[str] = Field(None, alias="slotCode")
+    slot_status: Optional[str] = Field(None, alias="slotStatus")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/storage-facility-slots")
+async def list_storage_slots(
+    facilityNodeId: str = Query(..., alias="facilityNodeId"),
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items = storage_facility_svc.list_slots(db, facility_node_id=facilityNodeId, tenant_no=tenant_no)
+    return success_response(items)
+
+
+@router.post("/storage-facility-slots/batch")
+async def batch_create_storage_slots(
+    body: StorageSlotBatchCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        items = storage_facility_svc.batch_create_slots(
+            db,
+            facility_node_id=body.facility_node_id,
+            rows=body.rows,
+            cols=body.cols,
+            code_prefix=body.code_prefix,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        return success_response(items, message=f"批量创建 {len(items)} 个格子成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/storage-facility-slots")
+async def create_storage_slot(
+    body: StorageSlotCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = storage_facility_svc.create_slot(
+            db,
+            facility_node_id=body.facility_node_id,
+            slot_code=body.slot_code,
+            slot_status=body.slot_status,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(storage_facility_svc._slot_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/storage-facility-slots/{slot_id}")
+async def update_storage_slot(
+    slot_id: str,
+    body: StorageSlotUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = storage_facility_svc.update_slot(
+            db,
+            slot_id,
+            slot_code=payload.get("slot_code"),
+            slot_status=payload.get("slot_status"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=tenant_no,
+        )
+        return success_response(storage_facility_svc._slot_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/storage-facility-slots/{slot_id}")
+async def delete_storage_slot(
+    slot_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        storage_facility_svc.soft_delete_slot(db, slot_id, tenant_no=tenant_no)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 展厅预约
+# ---------------------------------------------------------------------------
+
+
+class ExhibitionAppointmentCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    appointment_no: Optional[str] = Field(None, alias="appointmentNo")
+    visit_org: Optional[str] = Field(None, alias="visitOrg")
+    contact_name: Optional[str] = Field(None, alias="contactName")
+    visit_date: Optional[str] = Field(None, alias="visitDate")
+    visitor_count: Optional[int] = Field(None, alias="visitorCount")
+    reception_user_id: Optional[str] = Field(None, alias="receptionUserId")
+    order_num: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class ExhibitionAppointmentUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    visit_org: Optional[str] = Field(None, alias="visitOrg")
+    contact_name: Optional[str] = Field(None, alias="contactName")
+    visit_date: Optional[str] = Field(None, alias="visitDate")
+    visitor_count: Optional[int] = Field(None, alias="visitorCount")
+    reception_user_id: Optional[str] = Field(None, alias="receptionUserId")
+    order_num: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+@router.get("/exhibition-appointments")
+async def list_exhibition_appointments(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _get_tenant_no(db, user)
+    items, total = exhibition_svc.list_exhibition_appointments(db, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no)
+    tp = exhibition_svc.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/exhibition-appointments")
+async def create_exhibition_appointment(
+    body: ExhibitionAppointmentCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        obj = exhibition_svc.create_exhibition_appointment(
+            db,
+            appointment_no=body.appointment_no,
+            visit_org=body.visit_org,
+            contact_name=body.contact_name,
+            visit_date=body.visit_date,
+            visitor_count=body.visitor_count,
+            reception_user_id=body.reception_user_id,
+            tenant_no=tenant_no,
+            order_num=body.order_num,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(exhibition_svc._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/exhibition-appointments/{appointment_id}")
+async def update_exhibition_appointment(
+    appointment_id: str,
+    body: ExhibitionAppointmentUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        payload: dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=False)
+        obj = exhibition_svc.update_exhibition_appointment(
+            db,
+            appointment_id,
+            visit_org=payload.get("visit_org"),
+            contact_name=payload.get("contact_name"),
+            visit_date=payload.get("visit_date"),
+            visitor_count=payload.get("visitor_count"),
+            reception_user_id=payload.get("reception_user_id"),
+            order_num=payload.get("order_num"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+        )
+        return success_response(exhibition_svc._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/exhibition-appointments/{appointment_id}")
+async def delete_exhibition_appointment(
+    appointment_id: str,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        exhibition_svc.soft_delete_exhibition_appointment(db, appointment_id)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
diff --git a/backend/app/api/public.py b/backend/app/api/public.py
index bb66764d..8ac08f3a 100644
--- a/backend/app/api/public.py
+++ b/backend/app/api/public.py
@@ -1,4 +1,4 @@
-"""公共接口（Web 登录、刷新 Token、登出；用户模型对齐 zkxw-requirements-v0.3-schema.sql）"""
+"""公共接口（Web 登录、刷新 Token、登出；用户模型对齐 docs/sql/zkxw.sql 基线）"""
 from typing import Optional
 
 from fastapi import APIRouter, Depends, HTTPException, Request
diff --git a/backend/app/api/workflow.py b/backend/app/api/workflow.py
new file mode 100644
index 00000000..7b29dc68
--- /dev/null
+++ b/backend/app/api/workflow.py
@@ -0,0 +1,514 @@
+"""工作流管理接口"""
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, Depends, Query
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field
+from sqlalchemy.orm import Session
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import success_response, error_response
+from app.crud import workflow as wf_crud
+from app.models.models import SysUser, WfNode, WfProcessDef, WfProcessVersion, WfTask
+from app.services.workflow_engine import WorkflowEngine
+
+router = APIRouter(prefix="/web/admin/workflow", tags=["工作流管理"])
+
+# ---------------------------------------------------------------------------
+# 业务类型 → 中文名称映射
+# ---------------------------------------------------------------------------
+
+_BUSINESS_TYPE_LABELS: Dict[str, str] = {
+    "leave": "请假申请",
+}
+
+
+def _business_type_label(code: Optional[str]) -> str:
+    if not code:
+        return ""
+    return _BUSINESS_TYPE_LABELS.get(code, code)
+
+
+# ---------------------------------------------------------------------------
+# 业务表单字段提供者注册表
+# 新增业务类型时，只需添加一个 provider 函数并注册即可，前端无需改动
+# ---------------------------------------------------------------------------
+
+import logging
+_form_field_logger = logging.getLogger("workflow.form_fields")
+
+
+def _leave_form_fields(db: Session, business_id: str) -> List[Dict[str, str]]:
+    from app.crud import leave as leave_crud
+    item = leave_crud.get_leave(db, business_id)
+    if not item:
+        return []
+    leave_type_map = {"personal": "事假", "sick": "病假", "annual": "年假", "other": "其他"}
+    fields = [
+        {"label": "请假类型", "value": leave_type_map.get(item.get("leaveType", ""), item.get("leaveType", ""))},
+        {"label": "请假天数", "value": f"{item.get('days', 0)} 天" if item.get("days") else "--"},
+        {"label": "开始日期", "value": item.get("startDate", "") or "--"},
+        {"label": "结束日期", "value": item.get("endDate", "") or "--"},
+    ]
+    if item.get("reason"):
+        fields.append({"label": "请假原因", "value": item["reason"]})
+    if item.get("remark"):
+        fields.append({"label": "备注", "value": item["remark"]})
+    return fields
+
+
+_BUSINESS_FORM_FIELD_PROVIDERS: Dict[str, Any] = {
+    "leave": _leave_form_fields,
+}
+
+
+def _get_business_form_fields(db: Session, business_type: Optional[str], business_id: Optional[str]) -> List[Dict[str, str]]:
+    if not business_type or not business_id:
+        return []
+    provider = _BUSINESS_FORM_FIELD_PROVIDERS.get(business_type)
+    if not provider:
+        return []
+    try:
+        return provider(db, business_id)
+    except Exception as e:
+        _form_field_logger.warning("加载业务表单字段失败: type=%s id=%s err=%s", business_type, business_id, e)
+        return []
+
+
+def _enrich_task_list(db: Session, items: List[Dict[str, Any]]) -> None:
+    starter_ids = {it.get("starterUserId") for it in items if it.get("starterUserId")}
+    user_name_map: Dict[str, str] = {}
+    if starter_ids:
+        rows = db.query(SysUser.id, SysUser.nick_name).filter(SysUser.id.in_(starter_ids)).all()
+        user_name_map = {r.id: r.nick_name for r in rows}
+    for it in items:
+        sid = it.get("starterUserId")
+        it["starterUserName"] = user_name_map.get(sid, sid or "")
+        it["businessTypeLabel"] = _business_type_label(it.get("businessType"))
+
+
+# ---------------------------------------------------------------------------
+# Pydantic request bodies
+# ---------------------------------------------------------------------------
+
+
+class ProcessDefCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    processCode: str = Field(..., alias="processCode")
+    processName: str = Field(..., alias="processName")
+    status: Optional[str] = Field("1", alias="status")
+    orderNum: Optional[int] = Field(0, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class ProcessDefUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    processCode: Optional[str] = Field(None, alias="processCode")
+    processName: Optional[str] = Field(None, alias="processName")
+    status: Optional[str] = Field(None, alias="status")
+    orderNum: Optional[int] = Field(None, alias="orderNum")
+    remark: Optional[str] = None
+
+
+class PublishVersionBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    graphJson: Optional[str] = Field(None, alias="graphJson")
+    nodes: List[Dict[str, Any]] = Field(default_factory=list, alias="nodes")
+    transitions: List[Dict[str, Any]] = Field(default_factory=list, alias="transitions")
+    remark: Optional[str] = None
+
+
+class StartInstanceBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    processCode: str = Field(..., alias="processCode")
+    businessType: Optional[str] = Field(None, alias="businessType")
+    businessId: Optional[str] = Field(None, alias="businessId")
+    variables: Optional[Dict[str, Any]] = None
+    callbackUrl: Optional[str] = Field(None, alias="callbackUrl")
+
+
+class TaskActionBody(BaseModel):
+    """审批意见：前端传 commentText，兼容 comment。"""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    comment: Optional[str] = Field(
+        default=None,
+        validation_alias=AliasChoices("comment", "commentText"),
+    )
+
+
+# ---------------------------------------------------------------------------
+# 流程定义 CRUD
+# ---------------------------------------------------------------------------
+
+
+@router.get("/defs")
+async def list_process_defs(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    items, total = wf_crud.list_process_defs(
+        db, page=page, page_size=pageSize, keyword=keyword, status=status, tenant_no=tenant_no
+    )
+    tp = wf_crud.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.post("/defs")
+async def create_process_def(
+    body: ProcessDefCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = user.get("tenant_no", "zkxw")
+        obj = wf_crud.create_process_def(
+            db,
+            process_code=body.processCode,
+            process_name=body.processName,
+            tenant_no=tenant_no,
+            status=body.status,
+            order_num=body.orderNum,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response(wf_crud._row_to_dict(obj), message="创建成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.put("/defs/{def_id}")
+async def update_process_def(
+    def_id: str,
+    body: ProcessDefUpdateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        payload: Dict[str, Any] = body.model_dump(exclude_unset=True, by_alias=True)
+        obj = wf_crud.update_process_def(
+            db,
+            def_id,
+            process_code=payload.get("processCode"),
+            process_name=payload.get("processName"),
+            status=payload.get("status"),
+            order_num=payload.get("orderNum"),
+            remark=payload.get("remark"),
+            user_id=user.get("user_id"),
+            tenant_no=user.get("tenant_no", "zkxw"),
+        )
+        return success_response(wf_crud._row_to_dict(obj), message="更新成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.delete("/defs/{def_id}")
+async def delete_process_def(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        wf_crud.soft_delete_process_def(db, def_id)
+        return success_response(None, message="删除成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 版本发布 / 查看
+# ---------------------------------------------------------------------------
+
+
+@router.post("/defs/{def_id}/publish")
+async def publish_version(
+    def_id: str,
+    body: PublishVersionBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = user.get("tenant_no", "zkxw")
+        ver = wf_crud.publish_version(
+            db,
+            process_def_id=def_id,
+            graph_json=body.graphJson or "",
+            nodes=body.nodes,
+            transitions=body.transitions,
+            tenant_no=tenant_no,
+            remark=body.remark,
+            user_id=user.get("user_id"),
+        )
+        return success_response({"versionId": ver.id, "versionNo": ver.version_no}, message="发布成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.get("/defs/{def_id}/versions")
+async def list_versions(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    items = wf_crud.list_versions(db, def_id, tenant_no=tenant_no)
+    return success_response(items)
+
+
+@router.get("/defs/{def_id}/designer")
+async def get_designer_data(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    ver = wf_crud.get_latest_version(db, def_id)
+    if not ver:
+        return success_response({"graphJson": None, "nodes": [], "transitions": []})
+    nodes = wf_crud.get_nodes_by_version(db, ver.id)
+    transitions = wf_crud.get_transitions_by_version(db, ver.id)
+    return success_response({
+        "graphJson": ver.graph_json,
+        "versionId": ver.id,
+        "versionNo": ver.version_no,
+        "nodes": [
+            {"nodeKey": n.node_key, "nodeType": n.node_type, "nodeName": n.node_name, "configJson": n.config_json}
+            for n in nodes
+        ],
+        "transitions": [
+            {"fromNodeKey": t.from_node_key, "toNodeKey": t.to_node_key, "conditionExpr": t.condition_expr}
+            for t in transitions
+        ],
+    })
+
+
+# ---------------------------------------------------------------------------
+# 流程实例
+# ---------------------------------------------------------------------------
+
+
+@router.post("/instances")
+async def start_instance(
+    body: StartInstanceBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = user.get("tenant_no", "zkxw")
+        user_id = user.get("user_id") or user.get("id")
+        defn = (
+            db.query(WfProcessDef)
+            .filter(
+                WfProcessDef.process_code == body.processCode,
+                WfProcessDef.del_flag == 0,
+            )
+            .first()
+        )
+        if not defn:
+            return error_response(404, "流程定义不存在")
+        engine = WorkflowEngine(db)
+        instance = engine.start_process(
+            process_def_id=defn.id,
+            business_type=body.businessType,
+            business_id=body.businessId,
+            starter_user_id=user_id,
+            variables=body.variables,
+            callback_url=body.callbackUrl,
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        return success_response({
+            "instanceId": instance.id,
+            "status": instance.status,
+        }, message="发起成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.get("/instances/my")
+async def list_my_instances(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = user.get("user_id") or user.get("id")
+    tenant_no = user.get("tenant_no", "zkxw")
+    items, total = wf_crud.list_my_instances(
+        db, user_id, page=page, page_size=pageSize,
+        keyword=keyword, status=status, tenant_no=tenant_no,
+    )
+    _enrich_task_list(db, items)
+    tp = wf_crud.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.get("/instances/{instance_id}")
+async def get_instance_detail(
+    instance_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    instance = wf_crud.get_instance(db, instance_id)
+    if not instance:
+        return error_response(404, "流程实例不存在")
+    tasks = db.query(WfTask).filter(
+        WfTask.instance_id == instance_id,
+        WfTask.del_flag == 0,
+    ).order_by(WfTask.create_time.asc()).all()
+
+    # 查询节点名称映射 node_key → node_name
+    node_name_map: Dict[str, str] = {}
+    if instance.process_version_id:
+        for n in wf_crud.get_nodes_by_version(db, instance.process_version_id):
+            node_name_map[n.node_key] = n.node_name or n.node_key
+
+    # 批量查询用户名
+    user_ids = {t.assignee_user_id for t in tasks if t.assignee_user_id}
+    if instance.starter_user_id:
+        user_ids.add(instance.starter_user_id)
+    user_name_map: Dict[str, str] = {}
+    if user_ids:
+        rows = db.query(SysUser.id, SysUser.nick_name).filter(SysUser.id.in_(user_ids)).all()
+        user_name_map = {r.id: r.nick_name for r in rows}
+
+    return success_response({
+        "id": instance.id,
+        "businessType": instance.business_type,
+        "businessTypeLabel": _business_type_label(instance.business_type),
+        "businessId": instance.business_id,
+        "businessFormFields": _get_business_form_fields(db, instance.business_type, instance.business_id),
+        "starterUserId": instance.starter_user_id,
+        "starterUserName": user_name_map.get(instance.starter_user_id, instance.starter_user_id or ""),
+        "status": instance.status,
+        "variablesJson": instance.variables_json,
+        "callbackUrl": instance.callback_url,
+        "createTime": instance.create_time.strftime("%Y-%m-%d %H:%M:%S") if instance.create_time else "",
+        "tasks": [
+            {
+                "id": t.id,
+                "nodeKey": t.node_key,
+                "nodeName": node_name_map.get(t.node_key, t.node_key or ""),
+                "assigneeUserId": t.assignee_user_id,
+                "assigneeUserName": user_name_map.get(t.assignee_user_id, t.assignee_user_id or ""),
+                "status": t.status,
+                "commentText": t.comment_text,
+                "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+                "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+            }
+            for t in tasks
+        ],
+    })
+
+
+# ---------------------------------------------------------------------------
+# 待办 / 已办
+# ---------------------------------------------------------------------------
+
+
+@router.get("/tasks/pending")
+async def list_pending_tasks(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = user.get("user_id") or user.get("id")
+    tenant_no = user.get("tenant_no", "zkxw")
+    items, total = wf_crud.list_pending_tasks(
+        db, user_id, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    _enrich_task_list(db, items)
+    tp = wf_crud.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+@router.get("/tasks/completed")
+async def list_completed_tasks(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100, alias="pageSize"),
+    keyword: Optional[str] = None,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = user.get("user_id") or user.get("id")
+    tenant_no = user.get("tenant_no", "zkxw")
+    items, total = wf_crud.list_completed_tasks(
+        db, user_id, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    _enrich_task_list(db, items)
+    tp = wf_crud.total_pages(total, pageSize)
+    return success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})
+
+
+# ---------------------------------------------------------------------------
+# 审批 / 驳回
+# ---------------------------------------------------------------------------
+
+
+@router.post("/tasks/{task_id}/approve")
+async def approve_task(
+    task_id: str,
+    body: TaskActionBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = user.get("tenant_no", "zkxw")
+        engine = WorkflowEngine(db)
+        instance = engine.approve_task(task_id, body.comment or "", tenant_no)
+        return success_response({"instanceId": instance.id, "status": instance.status}, message="审批成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+@router.post("/tasks/{task_id}/reject")
+async def reject_task(
+    task_id: str,
+    body: TaskActionBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = user.get("tenant_no", "zkxw")
+        engine = WorkflowEngine(db)
+        instance = engine.reject_task(task_id, body.comment or "", tenant_no)
+        return success_response({"instanceId": instance.id, "status": instance.status}, message="已驳回")
+    except ValueError as e:
+        return error_response(400, str(e))
+
+
+# ---------------------------------------------------------------------------
+# 按业务查询所有审批历史（跨实例）
+# ---------------------------------------------------------------------------
+
+
+@router.get("/instances/by-business/{business_type}/{business_id}")
+async def get_business_all_tasks(
+    business_type: str,
+    business_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tasks = wf_crud.get_all_tasks_for_business(db, business_type, business_id)
+
+    business_form_fields = _get_business_form_fields(db, business_type, business_id)
+
+    return success_response({
+        "businessType": business_type,
+        "businessId": business_id,
+        "businessFormFields": business_form_fields,
+        "tasks": tasks,
+    })
diff --git a/backend/app/core/config.py b/backend/app/core/config.py
index d92c06d4..2485f95f 100644
--- a/backend/app/core/config.py
+++ b/backend/app/core/config.py
@@ -100,7 +100,7 @@ class Settings(BaseSettings):
     WX_TEMPLATE_REFUND_RESULT: str = ""  # 退款结果通知模板ID
     WX_TEMPLATE_DELIVERY_WARNING: str = ""  # 配送时效预警模板ID
 
-    # 与 docs/sql/zkxw-requirements-v0.3-schema.sql 一致：登录按租户 + sys_user.user_no
+    # 与 docs/sql/zkxw.sql 基线一致：登录按租户 + sys_user.user_no
     DEFAULT_TENANT_NO: str = "zkxw"
     # 用户未绑定 sys_user_role 时，Web 管理端默认角色（建议 super_admin 便于开发全菜单）
     WEB_AUTH_DEFAULT_ROLE: str = "super_admin"
diff --git a/backend/app/crud/cell_sample_type.py b/backend/app/crud/cell_sample_type.py
new file mode 100644
index 00000000..b2a26e8c
--- /dev/null
+++ b/backend/app/crud/cell_sample_type.py
@@ -0,0 +1,174 @@
+"""细胞样本类型 CRUD（biz_cell_sample_type）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizCellSampleType
+
+
+def _row_to_dict(r: BizCellSampleType) -> Dict[str, Any]:
+    sp = r.storage_price
+    return {
+        "id": r.id,
+        "typeCode": r.type_code,
+        "typeName": r.type_name,
+        "storageYears": r.storage_years,
+        "storagePrice": float(sp) if sp is not None else None,
+        "tenantNo": r.tenant_no,
+        "orderNum": r.order_num if r.order_num is not None else 0,
+        "remark": r.remark or "",
+        "createTime": r.create_time.strftime("%Y-%m-%d %H:%M:%S") if r.create_time else "",
+        "updateTime": r.update_time.strftime("%Y-%m-%d %H:%M:%S") if r.update_time else "",
+    }
+
+
+def type_code_exists(db: Session, code: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    c = (code or "").strip()
+    if not c:
+        return False
+    q = db.query(BizCellSampleType).filter(
+        and_(BizCellSampleType.type_code == c, BizCellSampleType.tenant_no == tenant_no, BizCellSampleType.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(BizCellSampleType.id != exclude_id)
+    return q.first() is not None
+
+
+def list_cell_sample_types(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCellSampleType).filter(BizCellSampleType.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCellSampleType.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(BizCellSampleType.type_code.like(like), BizCellSampleType.type_name.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCellSampleType.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCellSampleType.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_cell_sample_type(db: Session, row_id: str, tenant_no: Optional[str] = None) -> Optional[BizCellSampleType]:
+    q = db.query(BizCellSampleType).filter(and_(BizCellSampleType.id == row_id, BizCellSampleType.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCellSampleType.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_cell_sample_type(
+    db: Session,
+    *,
+    type_code: str,
+    type_name: str,
+    storage_years: Optional[int] = None,
+    storage_price: Optional[float] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCellSampleType:
+    tc = (type_code or "").strip()
+    if not tc:
+        raise ValueError("样本类型编码不能为空")
+    if type_code_exists(db, tc, tenant_no):
+        raise ValueError("样本类型编码已存在")
+    obj = BizCellSampleType(
+        id=generate_uuid(),
+        type_code=tc,
+        type_name=(type_name or "").strip() or tc,
+        storage_years=storage_years,
+        storage_price=storage_price,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_cell_sample_type(
+    db: Session,
+    row_id: str,
+    *,
+    type_code: Optional[str] = None,
+    type_name: Optional[str] = None,
+    storage_years: Optional[int] = None,
+    storage_price: Optional[float] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCellSampleType:
+    obj = get_cell_sample_type(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("样本类型不存在")
+    if type_code is not None:
+        tc = type_code.strip()
+        if not tc:
+            raise ValueError("样本类型编码不能为空")
+        if tc != obj.type_code and type_code_exists(db, tc, obj.tenant_no, exclude_id=row_id):
+            raise ValueError("样本类型编码已存在")
+        obj.type_code = tc
+    if type_name is not None:
+        obj.type_name = (type_name or "").strip() or obj.type_name
+    if storage_years is not None:
+        obj.storage_years = storage_years
+    if storage_price is not None:
+        obj.storage_price = storage_price
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_cell_sample_type(db: Session, row_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_cell_sample_type(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("样本类型不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/clean_room.py b/backend/app/crud/clean_room.py
new file mode 100644
index 00000000..aee83df9
--- /dev/null
+++ b/backend/app/crud/clean_room.py
@@ -0,0 +1,344 @@
+"""洁净室及进出记录 CRUD（biz_clean_room + biz_clean_room_access_log）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizCleanRoom, BizCleanRoomAccessLog
+
+
+# ---------------------------------------------------------------------------
+# 洁净室
+# ---------------------------------------------------------------------------
+
+def _row_to_dict(c: BizCleanRoom) -> Dict[str, Any]:
+    return {
+        "id": c.id,
+        "roomCode": c.room_code,
+        "roomName": c.room_name,
+        "roomGrade": c.room_grade,
+        "roomStatus": c.room_status,
+        "areaSqm": float(c.area_sqm) if c.area_sqm is not None else 0.0,
+        "tenantNo": c.tenant_no,
+        "orderNum": c.order_num if c.order_num is not None else 0,
+        "remark": c.remark or "",
+        "createTime": c.create_time.strftime("%Y-%m-%d %H:%M:%S") if c.create_time else "",
+        "updateTime": c.update_time.strftime("%Y-%m-%d %H:%M:%S") if c.update_time else "",
+    }
+
+
+def list_clean_rooms(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCleanRoom).filter(BizCleanRoom.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCleanRoom.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(BizCleanRoom.room_code.like(like), BizCleanRoom.room_name.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCleanRoom.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCleanRoom.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_clean_room(db: Session, room_id: str, tenant_no: Optional[str] = None) -> Optional[BizCleanRoom]:
+    q = db.query(BizCleanRoom).filter(and_(BizCleanRoom.id == room_id, BizCleanRoom.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCleanRoom.tenant_no == tenant_no)
+    return q.first()
+
+
+def room_code_exists(db: Session, code: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    q = db.query(BizCleanRoom).filter(
+        and_(BizCleanRoom.room_code == code.strip(), BizCleanRoom.tenant_no == tenant_no, BizCleanRoom.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(BizCleanRoom.id != exclude_id)
+    return q.first() is not None
+
+
+def create_clean_room(
+    db: Session,
+    *,
+    room_code: str,
+    room_name: str,
+    room_grade: Optional[str] = None,
+    room_status: Optional[str] = None,
+    area_sqm: Optional[Any] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCleanRoom:
+    rc = (room_code or "").strip()
+    if not rc:
+        raise ValueError("洁净室编码不能为空")
+    if room_code_exists(db, rc, tenant_no):
+        raise ValueError("洁净室编码已存在")
+    obj = BizCleanRoom(
+        id=generate_uuid(),
+        room_code=rc,
+        room_name=(room_name or "").strip() or rc,
+        room_grade=(room_grade or "").strip() or None,
+        room_status=(room_status or "").strip() or None,
+        area_sqm=area_sqm if area_sqm is not None else 0,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_clean_room(
+    db: Session,
+    room_id: str,
+    *,
+    room_code: Optional[str] = None,
+    room_name: Optional[str] = None,
+    room_grade: Optional[str] = None,
+    room_status: Optional[str] = None,
+    area_sqm: Optional[Any] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCleanRoom:
+    obj = get_clean_room(db, room_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("洁净室不存在")
+    if room_code is not None:
+        new_code = room_code.strip()
+        if not new_code:
+            raise ValueError("洁净室编码不能为空")
+        if new_code != obj.room_code and room_code_exists(db, new_code, obj.tenant_no, exclude_id=room_id):
+            raise ValueError("洁净室编码已存在")
+        obj.room_code = new_code
+    if room_name is not None:
+        obj.room_name = (room_name or "").strip() or obj.room_name
+    if room_grade is not None:
+        obj.room_grade = (room_grade or "").strip() or None
+    if room_status is not None:
+        obj.room_status = (room_status or "").strip() or None
+    if area_sqm is not None:
+        obj.area_sqm = area_sqm
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_clean_room(db: Session, room_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_clean_room(db, room_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("洁净室不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# 进出记录
+# ---------------------------------------------------------------------------
+
+def _access_log_to_dict(log: BizCleanRoomAccessLog) -> Dict[str, Any]:
+    return {
+        "id": log.id,
+        "cleanRoomId": log.clean_room_id,
+        "userId": log.user_id,
+        "personName": log.person_name,
+        "deptName": log.dept_name,
+        "enterTime": log.enter_time.strftime("%Y-%m-%d %H:%M:%S") if log.enter_time else "",
+        "purpose": log.purpose or "",
+        "leaveTime": log.leave_time.strftime("%Y-%m-%d %H:%M:%S") if log.leave_time else "",
+        "bodyTemp": log.body_temp or "",
+        "tenantNo": log.tenant_no,
+        "orderNum": log.order_num if log.order_num is not None else 0,
+        "remark": log.remark or "",
+        "createTime": log.create_time.strftime("%Y-%m-%d %H:%M:%S") if log.create_time else "",
+        "updateTime": log.update_time.strftime("%Y-%m-%d %H:%M:%S") if log.update_time else "",
+    }
+
+
+def list_access_logs(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    clean_room_id: Optional[str] = None,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCleanRoomAccessLog).filter(BizCleanRoomAccessLog.del_flag == 0)
+        if clean_room_id:
+            q0 = q0.filter(BizCleanRoomAccessLog.clean_room_id == clean_room_id)
+        if tenant_no:
+            q0 = q0.filter(BizCleanRoomAccessLog.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(
+                BizCleanRoomAccessLog.person_name.like(like),
+                BizCleanRoomAccessLog.dept_name.like(like),
+            ))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCleanRoomAccessLog.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCleanRoomAccessLog.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_access_log_to_dict(x) for x in rows], int(total)
+
+
+def get_access_log(db: Session, log_id: str, tenant_no: Optional[str] = None) -> Optional[BizCleanRoomAccessLog]:
+    q = db.query(BizCleanRoomAccessLog).filter(and_(BizCleanRoomAccessLog.id == log_id, BizCleanRoomAccessLog.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCleanRoomAccessLog.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_access_log(
+    db: Session,
+    *,
+    clean_room_id: str,
+    user_id: Optional[str] = None,
+    person_name: Optional[str] = None,
+    dept_name: Optional[str] = None,
+    enter_time: Optional[datetime] = None,
+    purpose: Optional[str] = None,
+    leave_time: Optional[datetime] = None,
+    body_temp: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id_param: Optional[str] = None,
+) -> BizCleanRoomAccessLog:
+    cr_id = (clean_room_id or "").strip()
+    if not cr_id:
+        raise ValueError("洁净室ID不能为空")
+    obj = BizCleanRoomAccessLog(
+        id=generate_uuid(),
+        clean_room_id=cr_id,
+        user_id=(user_id or "").strip() or None,
+        person_name=(person_name or "").strip() or None,
+        dept_name=(dept_name or "").strip() or None,
+        enter_time=enter_time or datetime.now(),
+        purpose=(purpose or "").strip() or None,
+        leave_time=leave_time,
+        body_temp=(body_temp or "").strip() or None,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id_param,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id_param,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_access_log(
+    db: Session,
+    log_id: str,
+    *,
+    person_name: Optional[str] = None,
+    dept_name: Optional[str] = None,
+    enter_time: Optional[datetime] = None,
+    purpose: Optional[str] = None,
+    leave_time: Optional[datetime] = None,
+    body_temp: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id_param: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCleanRoomAccessLog:
+    obj = get_access_log(db, log_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("进出记录不存在")
+    if person_name is not None:
+        obj.person_name = (person_name or "").strip() or None
+    if dept_name is not None:
+        obj.dept_name = (dept_name or "").strip() or None
+    if enter_time is not None:
+        obj.enter_time = enter_time
+    if purpose is not None:
+        obj.purpose = (purpose or "").strip() or None
+    if leave_time is not None:
+        obj.leave_time = leave_time
+    if body_temp is not None:
+        obj.body_temp = (body_temp or "").strip() or None
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id_param
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_access_log(db: Session, log_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_access_log(db, log_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("进出记录不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/collection_protocol.py b/backend/app/crud/collection_protocol.py
new file mode 100644
index 00000000..aa5e7a4c
--- /dev/null
+++ b/backend/app/crud/collection_protocol.py
@@ -0,0 +1,1580 @@
+"""采集协议单 / 审核 / 缴费明细 CRUD（细胞存储 2.2.6～2.2.10）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime, timedelta
+from decimal import Decimal
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid, parse_datetime
+from app.crud.base import camel_to_snake
+from app.models.models import (
+    BizAttachment,
+    BizCollectionProtocol,
+    BizProtocolAudit,
+    BizProtocolCollectionInfo,
+    BizProtocolPartyCustomer,
+    BizProtocolPayment,
+    BizProtocolPaymentDetail,
+    BizProtocolSample,
+    BizProtocolSampleTransport,
+    BizProtocolStorageCert,
+    BizCollectionRegion,
+    BizCollectionHospital,
+    SysUser,
+)
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
+
+
+def _fmt_dt(t: Optional[datetime]) -> str:
+    return t.strftime("%Y-%m-%d %H:%M:%S") if t else ""
+
+
+def _dec(v: Any) -> Optional[float]:
+    if v is None:
+        return None
+    if isinstance(v, Decimal):
+        return float(v)
+    return float(v)
+
+
+def _optional_decimal(v: Any) -> Optional[Decimal]:
+    if v is None or v == "":
+        return None
+    return Decimal(str(v))
+
+
+def _today_yyyymmdd() -> str:
+    return datetime.now().strftime("%Y%m%d")
+
+
+def _normalize_yyyymmdd_date(val: Any) -> Optional[str]:
+    """将 YYYYMMDD / YYYY-MM-DD 等格式规范为 8 位日期字符串。"""
+    if val is None:
+        return None
+    s = str(val).strip()
+    if not s:
+        return None
+    compact = s.replace("-", "").replace("/", "")[:8]
+    if len(compact) == 8 and compact.isdigit():
+        return compact
+    return None
+
+
+_SNAKE_ALIASES = {
+    "apgar1min": "apgar_1min",
+    "apgar5min": "apgar_5min",
+}
+
+
+def _normalize_fields(fields: Optional[dict]) -> dict:
+    """将前端 camelCase 字段名转为数据库 snake_case。"""
+    if not fields:
+        return {}
+    out: Dict[str, Any] = {}
+    for k, v in fields.items():
+        sk = _SNAKE_ALIASES.get(k) or camel_to_snake(k)
+        out[sk] = v
+    return out
+
+
+def attachments_to_urls(attachments: Any) -> Optional[str]:
+    """附件列表或字符串 → 逗号分隔 URL（MinIO）。"""
+    if attachments is None:
+        return None
+    if isinstance(attachments, str):
+        return attachments.strip() or None
+    if isinstance(attachments, list):
+        urls: List[str] = []
+        for item in attachments:
+            if isinstance(item, dict):
+                u = (item.get("fileUrl") or item.get("file_url") or "").strip()
+                if u:
+                    urls.append(u)
+            elif isinstance(item, str) and item.strip():
+                urls.append(item.strip())
+        return ",".join(urls) if urls else None
+    return None
+
+
+def _normalize_attachment_url_key(url: str) -> str:
+    u = (url or "").strip()
+    if not u:
+        return ""
+    if "?" in u:
+        u = u.split("?", 1)[0]
+    return u.lstrip("/")
+
+
+def _format_attachment_file_size(size_bytes: int) -> str:
+    if size_bytes < 1024:
+        return f"{size_bytes} B"
+    if size_bytes < 1024 * 1024:
+        return f"{size_bytes / 1024:.1f} KB"
+    return f"{size_bytes / (1024 * 1024):.1f} MB"
+
+
+def _lookup_attachment_by_url(
+    db: Session,
+    url: str,
+    tenant_no: Optional[str],
+) -> Optional[BizAttachment]:
+    key = _normalize_attachment_url_key(url)
+    if not key:
+        return None
+    q = db.query(BizAttachment).filter(BizAttachment.del_flag == 0)
+    if tenant_no:
+        q = q.filter(BizAttachment.tenant_no == tenant_no)
+    row = q.filter(BizAttachment.file_url == key).first()
+    if row:
+        return row
+    tail = key.rsplit("/", 1)[-1]
+    if tail:
+        row = (
+            q.filter(BizAttachment.file_url.like(f"%/{tail}"))
+            .order_by(BizAttachment.create_time.desc())
+            .first()
+        )
+    return row
+
+
+def urls_to_attachment_list(
+    urls_str: Optional[str],
+    db: Optional[Session] = None,
+    tenant_no: Optional[str] = None,
+) -> List[Dict[str, Any]]:
+    """逗号分隔 URL → 前端附件卡片结构；有 db 时从 biz_attachment 取原始文件名。"""
+    if not urls_str:
+        return []
+    result: List[Dict[str, Any]] = []
+    for url in urls_str.split(","):
+        u = url.strip()
+        if not u:
+            continue
+        att = _lookup_attachment_by_url(db, u, tenant_no) if db else None
+        if att:
+            size = att.file_size or 0
+            result.append(
+                {
+                    "id": att.id,
+                    "fileUrl": u,
+                    "fileName": att.original_name or u.rsplit("/", 1)[-1],
+                    "fileSize": size,
+                    "fileSizeDisplay": _format_attachment_file_size(size),
+                    "fileType": att.file_type or "",
+                }
+            )
+        else:
+            name = u.rsplit("/", 1)[-1] if "/" in u else u
+            result.append({"fileUrl": u, "fileName": name, "fileSize": 0})
+    return result
+
+
+def _protocol_to_dict(p: BizCollectionProtocol) -> Dict[str, Any]:
+    return {
+        "id": p.id,
+        "protocolNoId": p.protocol_no_id or "",
+        "protocolNo": p.protocol_no or "",
+        "protocolStatus": p.protocol_status or "",
+        "protocolAttachments": p.protocol_attachments or "",
+        "registerDate": (p.register_date or "").strip() if p.register_date else "",
+        "effectiveTime": _fmt_dt(p.effective_time),
+        "effectiveDesc": p.effective_desc or "",
+        "expireTime": _fmt_dt(p.expire_time),
+        "expireDesc": p.expire_desc or "",
+        "voidTime": _fmt_dt(p.void_time),
+        "voidDesc": p.void_desc or "",
+        "toResearchTime": _fmt_dt(p.to_research_time),
+        "toResearchDesc": p.to_research_desc or "",
+        "collectorUserId": p.collector_user_id or "",
+        "tenantNo": p.tenant_no,
+        "orderNum": p.order_num if p.order_num is not None else 0,
+        "remark": p.remark or "",
+        "createTime": _fmt_dt(p.create_time),
+        "updateTime": _fmt_dt(p.update_time),
+    }
+
+
+def _payment_to_dict(p: BizProtocolPayment) -> Dict[str, Any]:
+    return {
+        "id": p.id,
+        "collectionProtocolId": p.collection_protocol_id,
+        "payMode": p.pay_mode or "",
+        "contractAmount": _dec(p.contract_amount),
+        "installmentCount": p.installment_count,
+        "installmentIntervalMonths": p.installment_interval_months,
+        "lumpSumDeadline": (p.lump_sum_deadline or "").strip() if p.lump_sum_deadline else "",
+        "installmentStartDate": (p.installment_start_date or "").strip() if p.installment_start_date else "",
+        "tenantNo": p.tenant_no,
+        "orderNum": p.order_num if p.order_num is not None else 0,
+        "remark": p.remark or "",
+        "createTime": _fmt_dt(p.create_time),
+        "updateTime": _fmt_dt(p.update_time),
+    }
+
+
+def _detail_to_dict(
+    d: BizProtocolPaymentDetail,
+    *,
+    protocol_no: str = "",
+    collection_protocol_id: str = "",
+) -> Dict[str, Any]:
+    return {
+        "id": d.id,
+        "paymentId": d.payment_id,
+        "collectionProtocolId": collection_protocol_id,
+        "protocolNo": protocol_no,
+        "transferType": d.transfer_type or "",
+        "dueAmount": _dec(d.due_amount),
+        "transferAmount": _dec(d.transfer_amount),
+        "transferTime": _fmt_dt(d.transfer_time),
+        "transferAttachments": d.transfer_attachments or "",
+        "financeConfirmAttachments": d.finance_confirm_attachments or "",
+        "payStatus": d.pay_status or "",
+        "installmentNo": d.installment_no,
+        "installmentDueDate": (d.installment_due_date or "").strip() if d.installment_due_date else "",
+        "tenantNo": d.tenant_no,
+        "orderNum": d.order_num if d.order_num is not None else 0,
+        "remark": d.remark or "",
+        "createTime": _fmt_dt(d.create_time),
+        "updateTime": _fmt_dt(d.update_time),
+    }
+
+
+def _audit_to_dict(
+    a: BizProtocolAudit,
+    *,
+    protocol_no: str = "",
+) -> Dict[str, Any]:
+    return {
+        "id": a.id,
+        "collectionProtocolId": a.collection_protocol_id,
+        "protocolNo": protocol_no,
+        "auditorUserId": a.auditor_user_id or "",
+        "auditRemark": a.audit_remark or "",
+        "auditStatus": a.audit_status or "",
+        "tenantNo": a.tenant_no,
+        "orderNum": a.order_num if a.order_num is not None else 0,
+        "remark": a.remark or "",
+        "createTime": _fmt_dt(a.create_time),
+        "updateTime": _fmt_dt(a.update_time),
+    }
+
+
+def _party_customer_to_dict(p: BizProtocolPartyCustomer) -> Dict[str, Any]:
+    return {
+        "id": p.id,
+        "collectionProtocolId": p.collection_protocol_id,
+        "customerId": p.customer_id or "",
+        "motherName": p.mother_name or "",
+        "motherPhone": p.mother_phone or "",
+        "motherIdCard": p.mother_id_card or "",
+        "motherBirthYm": (p.mother_birth_ym or "").strip() if p.mother_birth_ym else "",
+        "motherEthnic": p.mother_ethnic or "",
+        "motherAddress": p.mother_address or "",
+        "fatherName": p.father_name or "",
+        "fatherPhone": p.father_phone or "",
+        "fatherIdCard": p.father_id_card or "",
+        "newbornName": p.newborn_name or "",
+        "newbornIdCard": p.newborn_id_card or "",
+        "newbornDeliveryTime": _fmt_dt(p.newborn_delivery_time),
+        "newbornSex": p.newborn_sex or "",
+        "deliveryMode": p.delivery_mode or "",
+        "birthOrder": p.birth_order,
+        "newbornWeightGram": p.newborn_weight_gram,
+        "apgar1min": _dec(p.apgar_1min),
+        "apgar5min": _dec(p.apgar_5min),
+        "collectorUserId": p.collector_user_id or "",
+        "tenantNo": p.tenant_no,
+        "orderNum": p.order_num if p.order_num is not None else 0,
+        "remark": p.remark or "",
+        "createTime": _fmt_dt(p.create_time),
+        "updateTime": _fmt_dt(p.update_time),
+    }
+
+
+def _collection_info_to_dict(c: BizProtocolCollectionInfo) -> Dict[str, Any]:
+    return {
+        "id": c.id,
+        "collectionProtocolId": c.collection_protocol_id,
+        "regionId": c.region_id or "",
+        "hospitalId": c.hospital_id or "",
+        "medicalStaff": c.medical_staff or "",
+        "salesUserId": c.sales_user_id or "",
+        "sampleCollectTime": _fmt_dt(c.sample_collect_time),
+        "maternalBloodCollectTime": _fmt_dt(c.maternal_blood_collect_time),
+        "tenantNo": c.tenant_no,
+        "orderNum": c.order_num if c.order_num is not None else 0,
+        "remark": c.remark or "",
+        "createTime": _fmt_dt(c.create_time),
+        "updateTime": _fmt_dt(c.update_time),
+    }
+
+
+def _sample_to_dict(s: BizProtocolSample) -> Dict[str, Any]:
+    return {
+        "id": s.id,
+        "collectionProtocolId": s.collection_protocol_id,
+        "sampleTypeId": s.sample_type_id or "",
+        "sampleCodeId": s.sample_code_id or "",
+        "sampleCode": s.sample_code or "",
+        "collectAmount": _dec(s.collect_amount),
+        "unitId": s.unit_id or "",
+        "price": _dec(s.price),
+        "storageYears": s.storage_years,
+        "sampleStatus": (s.sample_status or "").strip() if (s.sample_status or "").strip() else "",
+        "storageInDate": (s.storage_in_date or "").strip() if s.storage_in_date else "",
+        "detectStartDate": (s.detect_start_date or "").strip() if s.detect_start_date else "",
+        "voidDate": (s.void_date or "").strip() if s.void_date else "",
+        "storageExpireDate": (s.storage_expire_date or "").strip() if s.storage_expire_date else "",
+        "tenantNo": s.tenant_no,
+        "orderNum": s.order_num if s.order_num is not None else 0,
+        "remark": s.remark or "",
+        "createTime": _fmt_dt(s.create_time),
+        "updateTime": _fmt_dt(s.update_time),
+    }
+
+
+def _transport_to_dict(t: BizProtocolSampleTransport) -> Dict[str, Any]:
+    return {
+        "id": t.id,
+        "collectionProtocolId": t.collection_protocol_id,
+        "sampleId": t.sample_id,
+        "transportType": t.transport_type or "",
+        "expressCompanyId": t.express_company_id or "",
+        "waybillNo": t.waybill_no or "",
+        "destSiteId": t.dest_site_id or "",
+        "expressFee": _dec(t.express_fee),
+        "etaTime": _fmt_dt(t.eta_time),
+        "carrierName": t.carrier_name or "",
+        "carrierPhone": t.carrier_phone or "",
+        "remark": t.remark or "",
+        "orderNum": t.order_num if t.order_num is not None else 0,
+        "createTime": _fmt_dt(t.create_time),
+        "updateTime": _fmt_dt(t.update_time),
+    }
+
+
+def _storage_cert_to_dict(s: BizProtocolStorageCert) -> Dict[str, Any]:
+    return {
+        "id": s.id,
+        "collectionProtocolId": s.collection_protocol_id,
+        "makeStatus": s.make_status or "0",
+        "certImageUrls": s.cert_image_urls or "",
+        "makeDate": (s.make_date or "").strip() if s.make_date else "",
+        "tenantNo": s.tenant_no,
+        "orderNum": s.order_num if s.order_num is not None else 0,
+        "remark": s.remark or "",
+        "createTime": _fmt_dt(s.create_time),
+        "updateTime": _fmt_dt(s.update_time),
+    }
+
+
+def list_collection_protocols(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    protocol_status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    scope_collector_user_id: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCollectionProtocol).filter(BizCollectionProtocol.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCollectionProtocol.tenant_no == tenant_no)
+        if scope_collector_user_id:
+            q0 = q0.filter(
+                BizCollectionProtocol.collector_user_id == scope_collector_user_id
+            )
+        if protocol_status:
+            q0 = q0.filter(BizCollectionProtocol.protocol_status == protocol_status.strip())
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(
+                or_(
+                    BizCollectionProtocol.protocol_no.like(like),
+                    BizCollectionProtocol.remark.like(like),
+                )
+            )
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCollectionProtocol.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCollectionProtocol.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+
+    # 批量加载子表数据，避免 N+1 查询
+    protocol_ids = [r.id for r in rows]
+    pc_map: Dict[str, Dict[str, Any]] = {}
+    ci_map: Dict[str, Dict[str, Any]] = {}
+    if protocol_ids:
+        pc_rows = (
+            db.query(BizProtocolPartyCustomer)
+            .filter(
+                BizProtocolPartyCustomer.collection_protocol_id.in_(protocol_ids),
+                BizProtocolPartyCustomer.del_flag == 0,
+            )
+            .all()
+        )
+        for pc in pc_rows:
+            pc_map[pc.collection_protocol_id] = _party_customer_to_dict(pc)
+
+        ci_rows = (
+            db.query(BizProtocolCollectionInfo)
+            .filter(
+                BizProtocolCollectionInfo.collection_protocol_id.in_(protocol_ids),
+                BizProtocolCollectionInfo.del_flag == 0,
+            )
+            .all()
+        )
+        for ci in ci_rows:
+            ci_map[ci.collection_protocol_id] = _collection_info_to_dict(ci)
+
+    # 批量解析地区/医院名称
+    region_ids = list({ci_map.get(pid, {}).get("regionId", "") for pid in protocol_ids} - {""})
+    hospital_ids = list({ci_map.get(pid, {}).get("hospitalId", "") for pid in protocol_ids} - {""})
+    region_name_map: Dict[str, str] = {}
+    hospital_name_map: Dict[str, str] = {}
+    if region_ids:
+        for r in db.query(BizCollectionRegion.id, BizCollectionRegion.region_name).filter(BizCollectionRegion.id.in_(region_ids)).all():
+            region_name_map[r.id] = r.region_name or ""
+    if hospital_ids:
+        for h in db.query(BizCollectionHospital.id, BizCollectionHospital.hospital_name).filter(BizCollectionHospital.id.in_(hospital_ids)).all():
+            hospital_name_map[h.id] = h.hospital_name or ""
+
+    # 批量解析销售人员名称
+    sales_user_ids = list({ci_map.get(pid, {}).get("salesUserId", "") for pid in protocol_ids} - {""})
+    collector_user_ids = list({_protocol_to_dict(r).get("collectorUserId", "") for r in rows} - {""})
+    all_user_ids = list(set(sales_user_ids + collector_user_ids))
+    user_name_map: Dict[str, str] = {}
+    if all_user_ids:
+        for u in db.query(SysUser.id, SysUser.nick_name).filter(SysUser.id.in_(all_user_ids)).all():
+            user_name_map[u.id] = u.nick_name or ""
+
+    # 合并主表 + 子表数据
+    result = []
+    for r in rows:
+        d = _protocol_to_dict(r)
+        pc = pc_map.get(r.id)
+        ci = ci_map.get(r.id)
+        d["collectorUserName"] = user_name_map.get(d.get("collectorUserId", ""), "")
+        if pc:
+            d["motherName"] = pc.get("motherName", "")
+            d["motherPhone"] = pc.get("motherPhone", "")
+            d["motherIdCard"] = pc.get("motherIdCard", "")
+            d["motherBirthYm"] = pc.get("motherBirthYm", "")
+            d["motherEthnic"] = pc.get("motherEthnic", "")
+            d["fatherName"] = pc.get("fatherName", "")
+            d["fatherPhone"] = pc.get("fatherPhone", "")
+            d["newbornDeliveryTime"] = pc.get("newbornDeliveryTime", "")
+            d["newbornSex"] = pc.get("newbornSex", "")
+            d["deliveryMode"] = pc.get("deliveryMode", "")
+            d["birthOrder"] = pc.get("birthOrder")
+            d["newbornWeightGram"] = pc.get("newbornWeightGram")
+        else:
+            d["motherName"] = ""
+            d["motherPhone"] = ""
+            d["motherIdCard"] = ""
+            d["motherBirthYm"] = ""
+            d["motherEthnic"] = ""
+            d["fatherName"] = ""
+            d["fatherPhone"] = ""
+            d["newbornDeliveryTime"] = ""
+            d["newbornSex"] = ""
+            d["deliveryMode"] = ""
+            d["birthOrder"] = None
+            d["newbornWeightGram"] = None
+        if ci:
+            d["regionName"] = region_name_map.get(ci.get("regionId", ""), "")
+            d["hospitalName"] = hospital_name_map.get(ci.get("hospitalId", ""), "")
+            d["salesUserName"] = user_name_map.get(ci.get("salesUserId", ""), "")
+            d["sampleCollectTime"] = ci.get("sampleCollectTime", "")
+        else:
+            d["regionName"] = ""
+            d["hospitalName"] = ""
+            d["salesUserName"] = ""
+            d["sampleCollectTime"] = ""
+        result.append(d)
+    return result, int(total)
+
+
+def get_collection_protocol(
+    db: Session,
+    protocol_id: str,
+    tenant_no: str,
+    *,
+    scope_collector_user_id: Optional[str] = None,
+) -> Optional[BizCollectionProtocol]:
+    filters = [
+        BizCollectionProtocol.id == protocol_id,
+        BizCollectionProtocol.del_flag == 0,
+        BizCollectionProtocol.tenant_no == tenant_no,
+    ]
+    if scope_collector_user_id:
+        filters.append(
+            BizCollectionProtocol.collector_user_id == scope_collector_user_id
+        )
+    return db.query(BizCollectionProtocol).filter(and_(*filters)).first()
+
+
+def get_payment_by_protocol_id(db: Session, collection_protocol_id: str, tenant_no: str) -> Optional[BizProtocolPayment]:
+    return (
+        db.query(BizProtocolPayment)
+        .filter(
+            and_(
+                BizProtocolPayment.collection_protocol_id == collection_protocol_id,
+                BizProtocolPayment.tenant_no == tenant_no,
+                BizProtocolPayment.del_flag == 0,
+            )
+        )
+        .first()
+    )
+
+
+def get_protocol_detail_bundle(
+    db: Session,
+    protocol_id: str,
+    tenant_no: str,
+    *,
+    scope_collector_user_id: Optional[str] = None,
+) -> Optional[Dict[str, Any]]:
+    p = get_collection_protocol(
+        db, protocol_id, tenant_no, scope_collector_user_id=scope_collector_user_id
+    )
+    if not p:
+        return None
+    pay = get_payment_by_protocol_id(db, protocol_id, tenant_no)
+    pc = get_party_customer(db, protocol_id, tenant_no)
+    ci = get_collection_info(db, protocol_id, tenant_no)
+    s_rows = list_samples(db, protocol_id, tenant_no)
+    sc = get_storage_cert(db, protocol_id, tenant_no)
+    out: Dict[str, Any] = {"protocol": _protocol_to_dict(p)}
+    out["payment"] = _payment_to_dict(pay) if pay else None
+    out["partyCustomer"] = _party_customer_to_dict(pc) if pc else None
+    out["collectionInfo"] = _collection_info_to_dict(ci) if ci else None
+    transport_rows = list_sample_transports(db, protocol_id, tenant_no)
+    transport_by_sample = {t.sample_id: _transport_to_dict(t) for t in transport_rows}
+    samples_out: List[Dict[str, Any]] = []
+    for s in s_rows:
+        item = _sample_to_dict(s)
+        item["transport"] = transport_by_sample.get(s.id)
+        samples_out.append(item)
+    out["samples"] = samples_out
+    out["storageCert"] = _storage_cert_to_dict(sc) if sc else None
+    out["attachments"] = urls_to_attachment_list(p.protocol_attachments, db, tenant_no)
+    if pay:
+        detail_rows = list_payment_details(db, pay.id, tenant_no)
+        details_out: List[Dict[str, Any]] = []
+        for d in detail_rows:
+            item = _detail_to_dict(
+                d,
+                protocol_no=p.protocol_no or "",
+                collection_protocol_id=protocol_id,
+            )
+            item["attachments"] = urls_to_attachment_list(d.transfer_attachments, db, tenant_no)
+            details_out.append(item)
+        out["paymentDetails"] = details_out
+    else:
+        out["paymentDetails"] = []
+    return out
+
+
+def list_audits(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    audit_status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    q_base = (
+        db.query(BizProtocolAudit, BizCollectionProtocol.protocol_no)
+        .join(
+            BizCollectionProtocol,
+            and_(
+                BizProtocolAudit.collection_protocol_id == BizCollectionProtocol.id,
+                BizCollectionProtocol.del_flag == 0,
+            ),
+        )
+        .filter(BizProtocolAudit.del_flag == 0)
+    )
+    if tenant_no:
+        q_base = q_base.filter(BizProtocolAudit.tenant_no == tenant_no)
+    if audit_status:
+        q_base = q_base.filter(BizProtocolAudit.audit_status == audit_status.strip())
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q_base = q_base.filter(
+            or_(BizCollectionProtocol.protocol_no.like(like), BizProtocolAudit.audit_remark.like(like))
+        )
+
+    total = q_base.order_by(None).with_entities(func.count(BizProtocolAudit.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q_base.order_by(BizProtocolAudit.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    out = [_audit_to_dict(a, protocol_no=pn or "") for a, pn in rows]
+    return out, int(total)
+
+
+def create_audit(
+    db: Session,
+    *,
+    collection_protocol_id: str,
+    audit_status: str,
+    audit_remark: Optional[str],
+    tenant_no: str,
+    user_id: Optional[str],
+) -> BizProtocolAudit:
+    p = get_collection_protocol(db, collection_protocol_id, tenant_no)
+    if not p:
+        raise ValueError("协议单不存在")
+    st = (audit_status or "").strip()
+    if st not in ("shtg", "shth"):
+        raise ValueError("审核状态无效")
+    obj = BizProtocolAudit(
+        id=generate_uuid(),
+        collection_protocol_id=collection_protocol_id,
+        auditor_user_id=user_id,
+        audit_remark=(audit_remark or "").strip() or None,
+        audit_status=st,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def _detail_query_with_protocol(
+    db: Session,
+    tenant_no: str,
+    pay_status_filter: str,
+):
+    return (
+        db.query(BizProtocolPaymentDetail, BizProtocolPayment, BizCollectionProtocol.protocol_no)
+        .join(BizProtocolPayment, BizProtocolPaymentDetail.payment_id == BizProtocolPayment.id)
+        .join(BizCollectionProtocol, BizProtocolPayment.collection_protocol_id == BizCollectionProtocol.id)
+        .filter(
+            BizProtocolPaymentDetail.del_flag == 0,
+            BizProtocolPayment.del_flag == 0,
+            BizCollectionProtocol.del_flag == 0,
+            BizProtocolPaymentDetail.tenant_no == tenant_no,
+            BizProtocolPaymentDetail.pay_status == pay_status_filter,
+        )
+    )
+
+
+def list_receipt_confirm_details(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    if not tenant_no:
+        return [], 0
+    q_base = _detail_query_with_protocol(db, tenant_no, "jfqrz")
+    total = q_base.order_by(None).with_entities(func.count(BizProtocolPaymentDetail.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q_base.order_by(BizProtocolPaymentDetail.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    out = [
+        _detail_to_dict(
+            d,
+            protocol_no=pn or "",
+            collection_protocol_id=pay.collection_protocol_id if pay else "",
+        )
+        for d, pay, pn in rows
+    ]
+    return out, int(total)
+
+
+def confirm_receipt(
+    db: Session,
+    *,
+    detail_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    finance_confirm_attachments: Optional[str] = None,
+) -> BizProtocolPaymentDetail:
+    d = (
+        db.query(BizProtocolPaymentDetail)
+        .filter(
+            and_(
+                BizProtocolPaymentDetail.id == detail_id,
+                BizProtocolPaymentDetail.tenant_no == tenant_no,
+                BizProtocolPaymentDetail.del_flag == 0,
+            )
+        )
+        .first()
+    )
+    if not d:
+        raise ValueError("缴费明细不存在")
+    if d.pay_status != "jfqrz":
+        if d.pay_status == "yjf":
+            raise ValueError("该明细已确认收款")
+        raise ValueError("当前状态不可确认收款")
+    d.pay_status = "yjf"
+    if finance_confirm_attachments is not None:
+        d.finance_confirm_attachments = finance_confirm_attachments.strip() or None
+    d.update_by = user_id
+    d.update_time = datetime.now()
+    db.add(d)
+    db.commit()
+    db.refresh(d)
+    return d
+
+
+def list_refund_confirm_details(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    if not tenant_no:
+        return [], 0
+    q_base = _detail_query_with_protocol(db, tenant_no, "tfqrz")
+    total = q_base.order_by(None).with_entities(func.count(BizProtocolPaymentDetail.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q_base.order_by(BizProtocolPaymentDetail.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    out = [
+        _detail_to_dict(
+            d,
+            protocol_no=pn or "",
+            collection_protocol_id=pay.collection_protocol_id if pay else "",
+        )
+        for d, pay, pn in rows
+    ]
+    return out, int(total)
+
+
+def confirm_refund(
+    db: Session,
+    *,
+    detail_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    finance_confirm_attachments: Optional[str] = None,
+) -> BizProtocolPaymentDetail:
+    d = (
+        db.query(BizProtocolPaymentDetail)
+        .filter(
+            and_(
+                BizProtocolPaymentDetail.id == detail_id,
+                BizProtocolPaymentDetail.tenant_no == tenant_no,
+                BizProtocolPaymentDetail.del_flag == 0,
+            )
+        )
+        .first()
+    )
+    if not d:
+        raise ValueError("缴费明细不存在")
+    if d.pay_status != "tfqrz":
+        if d.pay_status == "ytf":
+            raise ValueError("该明细已确认退费")
+        raise ValueError("当前状态不可确认退费")
+    d.pay_status = "ytf"
+    if finance_confirm_attachments is not None:
+        d.finance_confirm_attachments = finance_confirm_attachments.strip() or None
+    d.update_by = user_id
+    d.update_time = datetime.now()
+    db.add(d)
+    db.commit()
+    db.refresh(d)
+    return d
+
+
+def _classify_installment_warning(due: str, today: str) -> str:
+    """overdue | warn | upcoming — due 为 YYYYMMDD"""
+    if not due or len(due) != 8 or not due.isdigit():
+        return "unknown"
+    if due < today:
+        return "overdue"
+    last_warn = (datetime.strptime(today, "%Y%m%d") + timedelta(days=15)).strftime("%Y%m%d")
+    if today <= due <= last_warn:
+        return "warn"
+    return "upcoming"
+
+
+def list_installment_warning(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    warning_type: str = "all",
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    if not tenant_no:
+        return [], 0
+    today = _today_yyyymmdd()
+    q0 = _detail_query_with_protocol(db, tenant_no, "dfj").filter(
+        BizProtocolPaymentDetail.installment_no.isnot(None),
+    )
+
+    # 拉取当前租户下候选（分期号非空）；日期过滤在内存中完成以保证与 classify 一致
+    rows_all = q0.order_by(BizProtocolPaymentDetail.installment_due_date.asc()).all()
+    flattened: List[Dict[str, Any]] = []
+    for d, pay, pn in rows_all:
+        due_raw = (d.installment_due_date or "").strip() if d.installment_due_date else ""
+        wt = _classify_installment_warning(due_raw, today)
+        item = _detail_to_dict(
+            d,
+            protocol_no=pn or "",
+            collection_protocol_id=pay.collection_protocol_id if pay else "",
+        )
+        item["warningType"] = wt
+        wt_filter = (warning_type or "all").strip().lower()
+        if wt_filter == "overdue" and wt != "overdue":
+            continue
+        if wt_filter == "warn" and wt != "warn":
+            continue
+        if wt_filter == "all":
+            pass
+        elif wt_filter not in ("all", "warn", "overdue"):
+            pass
+        flattened.append(item)
+
+    total = len(flattened)
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    start = (page - 1) * page_size
+    page_rows = flattened[start : start + page_size]
+    return page_rows, total
+
+
+def create_collection_protocol(
+    db: Session,
+    *,
+    protocol_no_id: Optional[str] = None,
+    protocol_no: str = "",
+    protocol_status: str = "dsx",
+    protocol_attachments: Optional[str] = None,
+    register_date: Optional[str] = None,
+    collector_user_id: Optional[str] = None,
+    remark: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> BizCollectionProtocol:
+    pn = (protocol_no or "").strip()
+    if not pn:
+        raise ValueError("协议编号不能为空")
+    dup = (
+        db.query(BizCollectionProtocol)
+        .filter(
+            and_(
+                BizCollectionProtocol.protocol_no == pn,
+                BizCollectionProtocol.tenant_no == tenant_no,
+                BizCollectionProtocol.del_flag == 0,
+            )
+        )
+        .first()
+    )
+    if dup:
+        raise ValueError("协议编号已存在")
+    obj = BizCollectionProtocol(
+        id=generate_uuid(),
+        protocol_no_id=(protocol_no_id or "").strip() or None,
+        protocol_no=pn,
+        protocol_status=protocol_status.strip() or "dsx",
+        protocol_attachments=(protocol_attachments or "").strip() or None,
+        register_date=(register_date or "").strip() or None,
+        collector_user_id=(collector_user_id or "").strip() or None,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_collection_protocol(
+    db: Session,
+    protocol_id: str,
+    *,
+    tenant_no: str,
+    user_id: Optional[str] = None,
+    scope_collector_user_id: Optional[str] = None,
+    protocol_no: Optional[str] = None,
+    protocol_status: Optional[str] = None,
+    protocol_attachments: Optional[str] = None,
+    register_date: Optional[str] = None,
+    effective_time: Optional[datetime] = None,
+    effective_desc: Optional[str] = None,
+    expire_time: Optional[datetime] = None,
+    expire_desc: Optional[str] = None,
+    void_time: Optional[datetime] = None,
+    void_desc: Optional[str] = None,
+    to_research_time: Optional[datetime] = None,
+    to_research_desc: Optional[str] = None,
+    collector_user_id: Optional[str] = None,
+    remark: Optional[str] = None,
+) -> BizCollectionProtocol:
+    obj = get_collection_protocol(
+        db, protocol_id, tenant_no, scope_collector_user_id=scope_collector_user_id
+    )
+    if not obj:
+        raise ValueError("协议单不存在或无权操作")
+    if protocol_no is not None:
+        pn = protocol_no.strip()
+        if not pn:
+            raise ValueError("协议编号不能为空")
+        if pn != obj.protocol_no:
+            dup = (
+                db.query(BizCollectionProtocol)
+                .filter(
+                    and_(
+                        BizCollectionProtocol.protocol_no == pn,
+                        BizCollectionProtocol.tenant_no == tenant_no,
+                        BizCollectionProtocol.del_flag == 0,
+                        BizCollectionProtocol.id != protocol_id,
+                    )
+                )
+                .first()
+            )
+            if dup:
+                raise ValueError("协议编号已存在")
+            obj.protocol_no = pn
+    if protocol_status is not None:
+        obj.protocol_status = protocol_status.strip()
+    if protocol_attachments is not None:
+        obj.protocol_attachments = protocol_attachments.strip() or None
+    if register_date is not None:
+        obj.register_date = register_date.strip() or None
+    if effective_time is not None:
+        obj.effective_time = effective_time
+    if effective_desc is not None:
+        obj.effective_desc = effective_desc.strip() or None
+    if expire_time is not None:
+        obj.expire_time = expire_time
+    if expire_desc is not None:
+        obj.expire_desc = expire_desc.strip() or None
+    if void_time is not None:
+        obj.void_time = void_time
+    if void_desc is not None:
+        obj.void_desc = void_desc.strip() or None
+    if to_research_time is not None:
+        obj.to_research_time = to_research_time
+    if to_research_desc is not None:
+        obj.to_research_desc = to_research_desc.strip() or None
+    if collector_user_id is not None:
+        obj.collector_user_id = collector_user_id.strip() or None
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_collection_protocol(
+    db: Session,
+    protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str] = None,
+    scope_collector_user_id: Optional[str] = None,
+) -> None:
+    obj = get_collection_protocol(
+        db, protocol_id, tenant_no, scope_collector_user_id=scope_collector_user_id
+    )
+    if not obj:
+        raise ValueError("协议单不存在或无权操作")
+    obj.del_flag = 1
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# 子表：当事人客户 / 采集信息 / 样本 / 储存证书
+# ---------------------------------------------------------------------------
+
+
+def get_party_customer(db: Session, collection_protocol_id: str, tenant_no: str) -> Optional[BizProtocolPartyCustomer]:
+    return (
+        db.query(BizProtocolPartyCustomer)
+        .filter(
+            and_(
+                BizProtocolPartyCustomer.collection_protocol_id == collection_protocol_id,
+                BizProtocolPartyCustomer.tenant_no == tenant_no,
+                BizProtocolPartyCustomer.del_flag == 0,
+            )
+        )
+        .first()
+    )
+
+
+def upsert_party_customer(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    **fields,
+) -> BizProtocolPartyCustomer:
+    fields = _normalize_fields(fields)
+    obj = get_party_customer(db, collection_protocol_id, tenant_no)
+    _STR_FIELDS = [
+        "customer_id", "mother_name", "mother_phone", "mother_id_card",
+        "mother_birth_ym", "mother_ethnic", "mother_address",
+        "father_name", "father_phone", "father_id_card",
+        "newborn_name", "newborn_id_card",
+        "newborn_sex", "delivery_mode", "collector_user_id",
+    ]
+    _INT_FIELDS = ["birth_order", "newborn_weight_gram"]
+    _DEC_FIELDS = ["apgar_1min", "apgar_5min"]
+    _DT_FIELDS = ["newborn_delivery_time"]
+    if obj:
+        for k in _STR_FIELDS:
+            if k in fields:
+                setattr(obj, k, (fields[k] or "").strip() or None)
+        for k in _INT_FIELDS:
+            if k in fields:
+                setattr(obj, k, fields[k])
+        for k in _DEC_FIELDS:
+            if k in fields:
+                setattr(obj, k, _optional_decimal(fields[k]))
+        for k in _DT_FIELDS:
+            if k in fields:
+                setattr(obj, k, fields[k])
+        if "remark" in fields:
+            obj.remark = (fields["remark"] or "").strip() or None
+        obj.update_by = user_id
+        obj.update_time = datetime.now()
+        db.add(obj)
+        db.commit()
+        db.refresh(obj)
+        return obj
+    obj = BizProtocolPartyCustomer(
+        id=generate_uuid(),
+        collection_protocol_id=collection_protocol_id,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(fields.get("remark") or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    for k in _STR_FIELDS:
+        if k in fields:
+            setattr(obj, k, (fields[k] or "").strip() or None)
+    for k in _INT_FIELDS:
+        if k in fields:
+            setattr(obj, k, fields[k])
+    for k in _DEC_FIELDS:
+        if k in fields:
+            setattr(obj, k, _optional_decimal(fields[k]))
+    for k in _DT_FIELDS:
+        if k in fields:
+            setattr(obj, k, fields[k])
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def get_collection_info(db: Session, collection_protocol_id: str, tenant_no: str) -> Optional[BizProtocolCollectionInfo]:
+    return (
+        db.query(BizProtocolCollectionInfo)
+        .filter(
+            and_(
+                BizProtocolCollectionInfo.collection_protocol_id == collection_protocol_id,
+                BizProtocolCollectionInfo.tenant_no == tenant_no,
+                BizProtocolCollectionInfo.del_flag == 0,
+            )
+        )
+        .first()
+    )
+
+
+def upsert_collection_info(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    **fields,
+) -> BizProtocolCollectionInfo:
+    fields = _normalize_fields(fields)
+    obj = get_collection_info(db, collection_protocol_id, tenant_no)
+    _STR_FIELDS = ["region_id", "hospital_id", "medical_staff", "sales_user_id"]
+    _DT_FIELDS = ["sample_collect_time", "maternal_blood_collect_time"]
+    if obj:
+        for k in _STR_FIELDS:
+            if k in fields:
+                setattr(obj, k, (fields[k] or "").strip() or None)
+        for k in _DT_FIELDS:
+            if k in fields:
+                setattr(obj, k, fields[k])
+        if "remark" in fields:
+            obj.remark = (fields["remark"] or "").strip() or None
+        obj.update_by = user_id
+        obj.update_time = datetime.now()
+        db.add(obj)
+        db.commit()
+        db.refresh(obj)
+        return obj
+    obj = BizProtocolCollectionInfo(
+        id=generate_uuid(),
+        collection_protocol_id=collection_protocol_id,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(fields.get("remark") or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    for k in _STR_FIELDS:
+        if k in fields:
+            setattr(obj, k, (fields[k] or "").strip() or None)
+    for k in _DT_FIELDS:
+        if k in fields:
+            setattr(obj, k, fields[k])
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def list_samples(db: Session, collection_protocol_id: str, tenant_no: str) -> List[BizProtocolSample]:
+    return (
+        db.query(BizProtocolSample)
+        .filter(
+            and_(
+                BizProtocolSample.collection_protocol_id == collection_protocol_id,
+                BizProtocolSample.tenant_no == tenant_no,
+                BizProtocolSample.del_flag == 0,
+            )
+        )
+        .order_by(BizProtocolSample.create_time.asc())
+        .all()
+    )
+
+
+def save_samples(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    samples: list,
+) -> List[BizProtocolSample]:
+    existing = list_samples(db, collection_protocol_id, tenant_no)
+    for s in existing:
+        s.del_flag = 1
+        s.update_by = user_id
+        s.update_time = datetime.now()
+        db.add(s)
+    if existing:
+        db.flush()
+    _STR_FIELDS = [
+        "sample_type_id", "sample_code_id", "sample_code", "unit_id",
+        "sample_status", "storage_in_date", "detect_start_date",
+        "void_date", "storage_expire_date",
+    ]
+    _DEC_FIELDS = ["collect_amount", "price"]
+    _INT_FIELDS = ["storage_years"]
+    result = []
+    for idx, raw in enumerate(samples):
+        raw = _normalize_fields(raw)
+        obj = BizProtocolSample(
+            id=generate_uuid(),
+            collection_protocol_id=collection_protocol_id,
+            tenant_no=tenant_no,
+            order_num=idx,
+            remark=(raw.get("remark") or "").strip() or None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        for k in _STR_FIELDS:
+            if k == "sample_status":
+                continue
+            if k in raw:
+                setattr(obj, k, (raw[k] or "").strip() or None)
+        # 样本状态：显式支持 null/空字符串，避免 ORM/库默认值 ycj 回填
+        if "sample_status" in raw:
+            status_val = raw.get("sample_status")
+            obj.sample_status = (
+                str(status_val).strip() if status_val is not None and str(status_val).strip() else None
+            )
+        for k in _DEC_FIELDS:
+            if k in raw and raw[k] is not None:
+                setattr(obj, k, Decimal(str(raw[k])))
+        for k in _INT_FIELDS:
+            if k in raw:
+                setattr(obj, k, raw[k])
+        db.add(obj)
+        result.append(obj)
+    db.commit()
+    for o in result:
+        db.refresh(o)
+    save_sample_transports(db, collection_protocol_id, tenant_no, user_id, result, samples)
+    return result
+
+
+def list_sample_transports(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+) -> List[BizProtocolSampleTransport]:
+    return (
+        db.query(BizProtocolSampleTransport)
+        .filter(
+            and_(
+                BizProtocolSampleTransport.collection_protocol_id == collection_protocol_id,
+                BizProtocolSampleTransport.tenant_no == tenant_no,
+                BizProtocolSampleTransport.del_flag == 0,
+            )
+        )
+        .order_by(BizProtocolSampleTransport.order_num.asc(), BizProtocolSampleTransport.create_time.asc())
+        .all()
+    )
+
+
+def _soft_delete_transports_for_protocol(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+) -> None:
+    rows = list_sample_transports(db, collection_protocol_id, tenant_no)
+    for r in rows:
+        r.del_flag = 1
+        r.update_by = user_id
+        r.update_time = datetime.now()
+        db.add(r)
+    if rows:
+        db.flush()
+
+
+def save_sample_transports(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    saved_samples: List[BizProtocolSample],
+    input_samples: list,
+) -> None:
+    _soft_delete_transports_for_protocol(db, collection_protocol_id, tenant_no, user_id)
+    for idx, sample_obj in enumerate(saved_samples):
+        if idx >= len(input_samples):
+            break
+        raw = _normalize_fields(input_samples[idx] if isinstance(input_samples[idx], dict) else {})
+        transport_raw = raw.get("transport")
+        if not isinstance(transport_raw, dict):
+            continue
+        tnorm = _normalize_fields(transport_raw)
+        transport_type = (tnorm.get("transport_type") or "").strip()
+        if not transport_type:
+            continue
+
+        eta_time = tnorm.get("eta_time")
+        if isinstance(eta_time, str):
+            eta_time = parse_datetime(eta_time)
+
+        express_fee = tnorm.get("express_fee")
+        if express_fee is not None and express_fee != "":
+            express_fee = Decimal(str(express_fee))
+        else:
+            express_fee = None
+
+        obj = BizProtocolSampleTransport(
+            id=generate_uuid(),
+            collection_protocol_id=collection_protocol_id,
+            sample_id=sample_obj.id,
+            transport_type=transport_type,
+            express_company_id=(tnorm.get("express_company_id") or "").strip() or None,
+            waybill_no=(tnorm.get("waybill_no") or "").strip() or None,
+            dest_site_id=(tnorm.get("dest_site_id") or "").strip() or None,
+            express_fee=express_fee,
+            eta_time=eta_time,
+            carrier_name=(tnorm.get("carrier_name") or "").strip() or None,
+            carrier_phone=(tnorm.get("carrier_phone") or "").strip() or None,
+            tenant_no=tenant_no,
+            order_num=idx,
+            remark=(tnorm.get("remark") or "").strip() or None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        db.add(obj)
+    db.commit()
+
+
+def get_storage_cert(db: Session, collection_protocol_id: str, tenant_no: str) -> Optional[BizProtocolStorageCert]:
+    return (
+        db.query(BizProtocolStorageCert)
+        .filter(
+            and_(
+                BizProtocolStorageCert.collection_protocol_id == collection_protocol_id,
+                BizProtocolStorageCert.tenant_no == tenant_no,
+                BizProtocolStorageCert.del_flag == 0,
+            )
+        )
+        .first()
+    )
+
+
+def list_payment_details(
+    db: Session,
+    payment_id: str,
+    tenant_no: str,
+) -> List[BizProtocolPaymentDetail]:
+    return (
+        db.query(BizProtocolPaymentDetail)
+        .filter(
+            and_(
+                BizProtocolPaymentDetail.payment_id == payment_id,
+                BizProtocolPaymentDetail.tenant_no == tenant_no,
+                BizProtocolPaymentDetail.del_flag == 0,
+            )
+        )
+        .order_by(
+            BizProtocolPaymentDetail.order_num.asc(),
+            BizProtocolPaymentDetail.create_time.asc(),
+        )
+        .all()
+    )
+
+
+def upsert_payment(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    **fields,
+) -> BizProtocolPayment:
+    fields = _normalize_fields(fields)
+    obj = get_payment_by_protocol_id(db, collection_protocol_id, tenant_no)
+    _STR_FIELDS = ["pay_mode"]
+    _STR_DATE_FIELDS = ["lump_sum_deadline", "installment_start_date"]
+    _DEC_FIELDS = ["contract_amount"]
+    _INT_FIELDS = ["installment_count", "installment_interval_months"]
+
+    def _apply(target: BizProtocolPayment) -> None:
+        for k in _STR_FIELDS:
+            if k in fields:
+                setattr(target, k, (fields[k] or "").strip() or None)
+        for k in _STR_DATE_FIELDS:
+            if k in fields:
+                setattr(target, k, _normalize_yyyymmdd_date(fields[k]))
+        for k in _DEC_FIELDS:
+            if k in fields and fields[k] is not None:
+                setattr(target, k, Decimal(str(fields[k])))
+        for k in _INT_FIELDS:
+            if k in fields:
+                setattr(target, k, fields[k])
+        if "remark" in fields:
+            target.remark = (fields["remark"] or "").strip() or None
+
+    if obj:
+        _apply(obj)
+        obj.update_by = user_id
+        obj.update_time = datetime.now()
+        db.add(obj)
+        db.commit()
+        db.refresh(obj)
+        return obj
+
+    pay_mode = (fields.get("pay_mode") or "").strip() or "dj"
+    obj = BizProtocolPayment(
+        id=generate_uuid(),
+        collection_protocol_id=collection_protocol_id,
+        pay_mode=pay_mode,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(fields.get("remark") or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    _apply(obj)
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def save_payment_details(
+    db: Session,
+    payment_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    details: list,
+) -> List[BizProtocolPaymentDetail]:
+    existing = list_payment_details(db, payment_id, tenant_no)
+    for d in existing:
+        d.del_flag = 1
+        d.update_by = user_id
+        d.update_time = datetime.now()
+        db.add(d)
+    if existing:
+        db.flush()
+
+    _STR_FIELDS = ["transfer_type", "pay_status"]
+    _STR_DATE_FIELDS = ["installment_due_date"]
+    _DEC_FIELDS = ["due_amount", "transfer_amount"]
+    _INT_FIELDS = ["installment_no"]
+    result: List[BizProtocolPaymentDetail] = []
+    for idx, raw in enumerate(details or []):
+        raw = _normalize_fields(raw)
+        att_src = raw.pop("attachments", None)
+        if att_src is None:
+            att_src = raw.get("transfer_attachments")
+        transfer_att = attachments_to_urls(att_src)
+
+        transfer_time = raw.get("transfer_time")
+        if isinstance(transfer_time, str):
+            transfer_time = parse_datetime(transfer_time)
+
+        installment_no = raw.get("installment_no")
+        if installment_no is None and raw.get("installment_due_date"):
+            installment_no = idx + 1
+
+        obj = BizProtocolPaymentDetail(
+            id=generate_uuid(),
+            payment_id=payment_id,
+            tenant_no=tenant_no,
+            order_num=idx,
+            remark=(raw.get("remark") or "").strip() or None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+            transfer_attachments=transfer_att,
+            transfer_time=transfer_time,
+            installment_no=installment_no,
+        )
+        for k in _STR_FIELDS:
+            if k in raw:
+                setattr(obj, k, (raw[k] or "").strip() or None)
+        for k in _STR_DATE_FIELDS:
+            if k in raw:
+                setattr(obj, k, _normalize_yyyymmdd_date(raw[k]))
+        for k in _DEC_FIELDS:
+            if k in raw and raw[k] is not None:
+                setattr(obj, k, Decimal(str(raw[k])))
+        for k in _INT_FIELDS:
+            if k in raw and raw[k] is not None:
+                setattr(obj, k, raw[k])
+        if "pay_status" not in raw or not (raw.get("pay_status") or "").strip():
+            obj.pay_status = "dfj"
+        db.add(obj)
+        result.append(obj)
+    db.commit()
+    for o in result:
+        db.refresh(o)
+    return result
+
+
+def upsert_storage_cert(
+    db: Session,
+    collection_protocol_id: str,
+    tenant_no: str,
+    user_id: Optional[str],
+    **fields,
+) -> BizProtocolStorageCert:
+    fields = _normalize_fields(fields)
+    obj = get_storage_cert(db, collection_protocol_id, tenant_no)
+    _STR_FIELDS = ["make_status", "cert_image_urls", "make_date"]
+    if obj:
+        for k in _STR_FIELDS:
+            if k in fields:
+                setattr(obj, k, (fields[k] or "").strip() or None)
+        if "remark" in fields:
+            obj.remark = (fields["remark"] or "").strip() or None
+        obj.update_by = user_id
+        obj.update_time = datetime.now()
+        db.add(obj)
+        db.commit()
+        db.refresh(obj)
+        return obj
+    obj = BizProtocolStorageCert(
+        id=generate_uuid(),
+        collection_protocol_id=collection_protocol_id,
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(fields.get("remark") or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    for k in _STR_FIELDS:
+        if k in fields:
+            setattr(obj, k, (fields[k] or "").strip() or None)
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
diff --git a/backend/app/crud/collection_protocol_no.py b/backend/app/crud/collection_protocol_no.py
new file mode 100644
index 00000000..24f33cb9
--- /dev/null
+++ b/backend/app/crud/collection_protocol_no.py
@@ -0,0 +1,339 @@
+"""采集协议号池 CRUD（biz_collection_protocol_no）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizCollectionProtocolNo
+
+
+def _row_to_dict(r: BizCollectionProtocolNo) -> Dict[str, Any]:
+    return {
+        "id": r.id,
+        "protocolNo": r.protocol_no,
+        "issued": int(r.issued or 0),
+        "issuedUserId": r.issued_user_id or "",
+        "issuedUserName": r.issued_user_name or "",
+        "issuedTime": r.issued_time.strftime("%Y-%m-%d %H:%M:%S") if r.issued_time else "",
+        "tenantNo": r.tenant_no,
+        "orderNum": r.order_num if r.order_num is not None else 0,
+        "remark": r.remark or "",
+        "createTime": r.create_time.strftime("%Y-%m-%d %H:%M:%S") if r.create_time else "",
+        "updateTime": r.update_time.strftime("%Y-%m-%d %H:%M:%S") if r.update_time else "",
+    }
+
+
+def protocol_no_exists(db: Session, no: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    v = (no or "").strip()
+    if not v:
+        return False
+    q = db.query(BizCollectionProtocolNo).filter(
+        and_(
+            BizCollectionProtocolNo.protocol_no == v,
+            BizCollectionProtocolNo.tenant_no == tenant_no,
+            BizCollectionProtocolNo.del_flag == 0,
+        )
+    )
+    if exclude_id:
+        q = q.filter(BizCollectionProtocolNo.id != exclude_id)
+    return q.first() is not None
+
+
+def list_protocol_nos(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCollectionProtocolNo).filter(BizCollectionProtocolNo.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCollectionProtocolNo.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(BizCollectionProtocolNo.protocol_no.like(like), BizCollectionProtocolNo.remark.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCollectionProtocolNo.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCollectionProtocolNo.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_protocol_no(db: Session, row_id: str, tenant_no: Optional[str] = None) -> Optional[BizCollectionProtocolNo]:
+    q = db.query(BizCollectionProtocolNo).filter(and_(BizCollectionProtocolNo.id == row_id, BizCollectionProtocolNo.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCollectionProtocolNo.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_protocol_no(
+    db: Session,
+    *,
+    protocol_no: str,
+    issued: int = 0,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCollectionProtocolNo:
+    pn = (protocol_no or "").strip()
+    if not pn:
+        raise ValueError("采集协议号不能为空")
+    if protocol_no_exists(db, pn, tenant_no):
+        raise ValueError("采集协议号已存在")
+    obj = BizCollectionProtocolNo(
+        id=generate_uuid(),
+        protocol_no=pn,
+        issued=1 if issued else 0,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_protocol_no(
+    db: Session,
+    row_id: str,
+    *,
+    protocol_no: Optional[str] = None,
+    issued: Optional[int] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    issued_user_id: Optional[str] = None,
+    issued_user_name: Optional[str] = None,
+    issued_time: Optional[str] = None,
+) -> BizCollectionProtocolNo:
+    obj = get_protocol_no(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("记录不存在")
+    if protocol_no is not None:
+        pn = protocol_no.strip()
+        if not pn:
+            raise ValueError("采集协议号不能为空")
+        if pn != obj.protocol_no and protocol_no_exists(db, pn, obj.tenant_no, exclude_id=row_id):
+            raise ValueError("采集协议号已存在")
+        obj.protocol_no = pn
+    if issued is not None:
+        obj.issued = 1 if issued else 0
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    if issued_user_id is not None:
+        obj.issued_user_id = issued_user_id or None
+    if issued_user_name is not None:
+        obj.issued_user_name = issued_user_name or None
+    if issued_time is not None:
+        obj.issued_time = issued_time or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_protocol_no(db: Session, row_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_protocol_no(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("记录不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def batch_generate_protocol_nos(
+    db: Session,
+    *,
+    prefix: str,
+    middle: str,
+    seq_start: int,
+    seq_end: int,
+    digit_count: int = 6,
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    """批量生成协议号: 前缀 + 中间段 + 补零序号"""
+    p = (prefix or "").strip()
+    m = (middle or "").strip()
+    if not p:
+        raise ValueError("固定前缀不能为空")
+    if seq_start < 0 or seq_end < 0:
+        raise ValueError("序号不能为负数")
+    if seq_start > seq_end:
+        raise ValueError("开始序号不能大于结束序号")
+    if digit_count < 1:
+        raise ValueError("序号位数不能小于1")
+    count = seq_end - seq_start + 1
+    if count > 10000:
+        raise ValueError("单次批量生成不能超过10000条")
+
+    generated_nos = []
+    for i in range(seq_start, seq_end + 1):
+        seq_str = str(i).zfill(digit_count)
+        full_no = f"{p}{m}{seq_str}"
+        generated_nos.append(full_no)
+
+    # Batch check existing
+    existing = set(
+        row.protocol_no
+        for row in db.query(BizCollectionProtocolNo.protocol_no)
+        .filter(
+            BizCollectionProtocolNo.tenant_no == tenant_no,
+            BizCollectionProtocolNo.del_flag == 0,
+            BizCollectionProtocolNo.protocol_no.in_(generated_nos),
+        )
+        .all()
+    )
+
+    now = datetime.now()
+    created = []
+    skipped = []
+    for no in generated_nos:
+        if no in existing:
+            skipped.append(no)
+            continue
+        obj = BizCollectionProtocolNo(
+            id=generate_uuid(),
+            protocol_no=no,
+            issued=0,
+            tenant_no=tenant_no,
+            order_num=0,
+            remark=None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=now,
+            update_by=user_id,
+            update_time=now,
+            del_flag=0,
+        )
+        created.append(obj)
+
+    if created:
+        db.bulk_save_objects(created)
+        db.commit()
+
+    return {
+        "created": len(created),
+        "skipped": len(skipped),
+        "skippedNos": skipped,
+    }
+
+
+def batch_issue_protocol_nos(
+    db: Session,
+    *,
+    ids: List[str],
+    issued_user_id: str,
+    issued_user_name: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    """批量下发协议号"""
+    if not ids:
+        raise ValueError("请选择要下发的协议号")
+    uid = (issued_user_id or "").strip()
+    if not uid:
+        raise ValueError("请选择下发用户")
+
+    now = datetime.now()
+    issued_count = 0
+    already_issued = []
+
+    for row_id in ids:
+        obj = get_protocol_no(db, row_id, tenant_no=tenant_no)
+        if not obj:
+            continue
+        if obj.issued == 1:
+            already_issued.append(obj.protocol_no)
+            continue
+        obj.issued = 1
+        obj.issued_user_id = uid
+        obj.issued_user_name = (issued_user_name or "").strip() or None
+        obj.issued_time = now
+        obj.update_by = user_id
+        obj.update_time = now
+        db.add(obj)
+        issued_count += 1
+
+    if issued_count > 0:
+        db.commit()
+
+    return {
+        "issuedCount": issued_count,
+        "alreadyIssued": already_issued,
+    }
+
+
+def batch_revoke_protocol_nos(
+    db: Session,
+    *,
+    ids: List[str],
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    if not ids:
+        raise ValueError("请选择要收回的协议号")
+
+    now = datetime.now()
+    revoked_count = 0
+    not_issued = []
+
+    for row_id in ids:
+        obj = get_protocol_no(db, row_id, tenant_no=tenant_no)
+        if not obj:
+            continue
+        if obj.issued != 1:
+            not_issued.append(obj.protocol_no)
+            continue
+        obj.issued = 0
+        obj.issued_user_id = None
+        obj.issued_user_name = None
+        obj.issued_time = None
+        obj.update_by = user_id
+        obj.update_time = now
+        db.add(obj)
+        revoked_count += 1
+
+    if revoked_count > 0:
+        db.commit()
+
+    return {
+        "revokedCount": revoked_count,
+        "notIssued": not_issued,
+    }
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/collection_region.py b/backend/app/crud/collection_region.py
new file mode 100644
index 00000000..94d1971c
--- /dev/null
+++ b/backend/app/crud/collection_region.py
@@ -0,0 +1,308 @@
+"""采集地区及下属医院 CRUD"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizCollectionHospital, BizCollectionRegion
+
+
+def _region_to_dict(r: BizCollectionRegion, hospital_names: Optional[List[str]] = None) -> Dict[str, Any]:
+    return {
+        "id": r.id,
+        "regionName": r.region_name,
+        "hospitalNames": hospital_names or [],
+        "tenantNo": r.tenant_no,
+        "orderNum": r.order_num if r.order_num is not None else 0,
+        "remark": r.remark or "",
+        "createTime": r.create_time.strftime("%Y-%m-%d %H:%M:%S") if r.create_time else "",
+        "updateTime": r.update_time.strftime("%Y-%m-%d %H:%M:%S") if r.update_time else "",
+    }
+
+
+def _hospital_to_dict(h: BizCollectionHospital) -> Dict[str, Any]:
+    return {
+        "id": h.id,
+        "regionId": h.region_id,
+        "hospitalName": h.hospital_name,
+        "tenantNo": h.tenant_no,
+        "orderNum": h.order_num if h.order_num is not None else 0,
+        "remark": h.remark or "",
+        "createTime": h.create_time.strftime("%Y-%m-%d %H:%M:%S") if h.create_time else "",
+        "updateTime": h.update_time.strftime("%Y-%m-%d %H:%M:%S") if h.update_time else "",
+    }
+
+
+def list_collection_regions(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCollectionRegion).filter(BizCollectionRegion.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCollectionRegion.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(BizCollectionRegion.region_name.like(like), BizCollectionRegion.remark.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCollectionRegion.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCollectionRegion.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+
+    # 批量查询所有 region 的医院名称，避免 N+1
+    region_ids = [r.id for r in rows]
+    hospital_map: Dict[str, List[str]] = {}
+    if region_ids:
+        hosp_rows = (
+            db.query(BizCollectionHospital.region_id, BizCollectionHospital.hospital_name)
+            .filter(
+                and_(
+                    BizCollectionHospital.region_id.in_(region_ids),
+                    BizCollectionHospital.del_flag == 0,
+                )
+            )
+            .order_by(BizCollectionHospital.order_num.asc(), BizCollectionHospital.create_time.desc())
+            .all()
+        )
+        for h in hosp_rows:
+            hospital_map.setdefault(h.region_id, []).append(h.hospital_name)
+
+    return [_region_to_dict(x, hospital_names=hospital_map.get(x.id, [])) for x in rows], int(total)
+
+
+def get_collection_region(db: Session, region_id: str, tenant_no: Optional[str] = None) -> Optional[BizCollectionRegion]:
+    q = db.query(BizCollectionRegion).filter(and_(BizCollectionRegion.id == region_id, BizCollectionRegion.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCollectionRegion.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_collection_region(
+    db: Session,
+    *,
+    region_name: str,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCollectionRegion:
+    name = (region_name or "").strip()
+    if not name:
+        raise ValueError("地区名称不能为空")
+    obj = BizCollectionRegion(
+        id=generate_uuid(),
+        region_name=name,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_collection_region(
+    db: Session,
+    region_id: str,
+    *,
+    region_name: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCollectionRegion:
+    obj = get_collection_region(db, region_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("采集地区不存在")
+    if region_name is not None:
+        n = region_name.strip()
+        if not n:
+            raise ValueError("地区名称不能为空")
+        obj.region_name = n
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_collection_region(db: Session, region_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_collection_region(db, region_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("采集地区不存在")
+    now = datetime.now()
+    obj.del_flag = 1
+    obj.update_time = now
+    db.add(obj)
+    subs = (
+        db.query(BizCollectionHospital)
+        .filter(
+            and_(
+                BizCollectionHospital.region_id == region_id,
+                BizCollectionHospital.del_flag == 0,
+            )
+        )
+        .all()
+    )
+    for h in subs:
+        h.del_flag = 1
+        h.update_time = now
+        db.add(h)
+    db.commit()
+
+
+def list_hospitals(
+    db: Session,
+    *,
+    region_id: str,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    region = get_collection_region(db, region_id, tenant_no=tenant_no)
+    if not region:
+        raise ValueError("采集地区不存在")
+
+    def _filtered():
+        q0 = db.query(BizCollectionHospital).filter(
+            and_(BizCollectionHospital.region_id == region_id, BizCollectionHospital.del_flag == 0)
+        )
+        if tenant_no:
+            q0 = q0.filter(BizCollectionHospital.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(BizCollectionHospital.hospital_name.like(like))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCollectionHospital.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCollectionHospital.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_hospital_to_dict(x) for x in rows], int(total)
+
+
+def get_hospital(db: Session, hospital_id: str, tenant_no: Optional[str] = None) -> Optional[BizCollectionHospital]:
+    q = db.query(BizCollectionHospital).filter(and_(BizCollectionHospital.id == hospital_id, BizCollectionHospital.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCollectionHospital.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_hospital(
+    db: Session,
+    *,
+    region_id: str,
+    hospital_name: str,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCollectionHospital:
+    region = get_collection_region(db, region_id, tenant_no=tenant_no)
+    if not region:
+        raise ValueError("采集地区不存在")
+    hn = (hospital_name or "").strip()
+    if not hn:
+        raise ValueError("医院名称不能为空")
+    obj = BizCollectionHospital(
+        id=generate_uuid(),
+        region_id=region_id,
+        hospital_name=hn,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_hospital(
+    db: Session,
+    hospital_id: str,
+    *,
+    hospital_name: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCollectionHospital:
+    obj = get_hospital(db, hospital_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("医院不存在")
+    if hospital_name is not None:
+        hn = hospital_name.strip()
+        if not hn:
+            raise ValueError("医院名称不能为空")
+        obj.hospital_name = hn
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_hospital(db: Session, hospital_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_hospital(db, hospital_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("医院不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/customer.py b/backend/app/crud/customer.py
new file mode 100644
index 00000000..bd9e5205
--- /dev/null
+++ b/backend/app/crud/customer.py
@@ -0,0 +1,194 @@
+"""客户 CRUD（biz_customer）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizCustomer
+
+
+def _row_to_dict(c: BizCustomer) -> Dict[str, Any]:
+    return {
+        "id": c.id,
+        "customerName": c.customer_name,
+        "sex": (c.sex or "2").strip() if c.sex else "2",
+        "idCardNo": c.id_card_no or "",
+        "age": c.age,
+        "phoneNo": c.phone_no or "",
+        "customerTags": c.customer_tags or "",
+        "tenantNo": c.tenant_no,
+        "orderNum": c.order_num if c.order_num is not None else 0,
+        "remark": c.remark or "",
+        "createTime": c.create_time.strftime("%Y-%m-%d %H:%M:%S") if c.create_time else "",
+        "updateTime": c.update_time.strftime("%Y-%m-%d %H:%M:%S") if c.update_time else "",
+    }
+
+
+def id_card_taken(db: Session, id_card: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    ic = (id_card or "").strip()
+    if not ic:
+        return False
+    q = db.query(BizCustomer).filter(
+        and_(BizCustomer.id_card_no == ic, BizCustomer.tenant_no == tenant_no, BizCustomer.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(BizCustomer.id != exclude_id)
+    return q.first() is not None
+
+
+def list_customers(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizCustomer).filter(BizCustomer.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizCustomer.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(
+                or_(
+                    BizCustomer.customer_name.like(like),
+                    BizCustomer.phone_no.like(like),
+                    BizCustomer.id_card_no.like(like),
+                    BizCustomer.customer_tags.like(like),
+                )
+            )
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizCustomer.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizCustomer.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_customer(db: Session, customer_id: str, tenant_no: Optional[str] = None) -> Optional[BizCustomer]:
+    q = db.query(BizCustomer).filter(and_(BizCustomer.id == customer_id, BizCustomer.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizCustomer.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_customer(
+    db: Session,
+    *,
+    customer_name: str,
+    sex: str = "2",
+    id_card_no: Optional[str] = None,
+    age: Optional[int] = None,
+    phone_no: Optional[str] = None,
+    customer_tags: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizCustomer:
+    name = (customer_name or "").strip()
+    if not name:
+        raise ValueError("客户姓名不能为空")
+    ic = (id_card_no or "").strip() or None
+    if ic and id_card_taken(db, ic, tenant_no):
+        raise ValueError("该身份证号已存在客户，请勿重复创建")
+    obj = BizCustomer(
+        id=generate_uuid(),
+        customer_name=name,
+        sex=(sex or "2")[:1] if sex else "2",
+        id_card_no=ic,
+        age=age,
+        phone_no=(phone_no or "").strip() or None,
+        customer_tags=(customer_tags or "").strip() or None,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_customer(
+    db: Session,
+    customer_id: str,
+    *,
+    customer_name: Optional[str] = None,
+    sex: Optional[str] = None,
+    id_card_no: Optional[str] = None,
+    age: Optional[int] = None,
+    phone_no: Optional[str] = None,
+    customer_tags: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizCustomer:
+    obj = get_customer(db, customer_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("客户不存在")
+    if customer_name is not None:
+        n = customer_name.strip()
+        if not n:
+            raise ValueError("客户姓名不能为空")
+        obj.customer_name = n
+    if sex is not None:
+        obj.sex = (sex or "2")[:1]
+    if id_card_no is not None:
+        ic = id_card_no.strip() or None
+        if ic and id_card_taken(db, ic, obj.tenant_no, exclude_id=customer_id):
+            raise ValueError("该身份证号已被其他客户使用")
+        obj.id_card_no = ic
+    if age is not None:
+        obj.age = age
+    if phone_no is not None:
+        obj.phone_no = phone_no.strip() or None
+    if customer_tags is not None:
+        obj.customer_tags = customer_tags.strip() or None
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_customer(db: Session, customer_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_customer(db, customer_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("客户不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/dept.py b/backend/app/crud/dept.py
index 826e8cac..1482212e 100644
--- a/backend/app/crud/dept.py
+++ b/backend/app/crud/dept.py
@@ -48,7 +48,7 @@ def list_depts(
     if kw:
         like = f"%{kw}%"
         q = q.filter(SysDept.dept_name.like(like))
-    rows = q.order_by(SysDept.order_num.asc(), SysDept.create_time.desc()).all()
+    rows = q.order_by(SysDept.create_time.desc()).all()
     return [_row_to_dict(x) for x in rows]
 
 
diff --git a/backend/app/crud/dict_data.py b/backend/app/crud/dict_data.py
index 85865a9d..036439a4 100644
--- a/backend/app/crud/dict_data.py
+++ b/backend/app/crud/dict_data.py
@@ -52,7 +52,7 @@ def list_dict_data(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysDictData.order_num.asc(), SysDictData.create_time.desc())
+.order_by(SysDictData.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
@@ -147,7 +147,7 @@ def list_dict_data_options(
     )
     if tenant_no:
         q = q.filter(SysDictData.tenant_no == tenant_no)
-    rows = q.order_by(SysDictData.order_num.asc(), SysDictData.create_time.desc()).all()
+    rows = q.order_by(SysDictData.create_time.desc()).all()
     return [{"label": r.dict_label, "value": r.dict_value} for r in rows]
 
 
diff --git a/backend/app/crud/dict_type.py b/backend/app/crud/dict_type.py
index 8b28ea68..953b983e 100644
--- a/backend/app/crud/dict_type.py
+++ b/backend/app/crud/dict_type.py
@@ -48,7 +48,7 @@ def list_dict_types(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysDictType.order_num.asc(), SysDictType.create_time.desc())
+        .order_by(SysDictType.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/ethnic.py b/backend/app/crud/ethnic.py
new file mode 100644
index 00000000..0614ea87
--- /dev/null
+++ b/backend/app/crud/ethnic.py
@@ -0,0 +1,30 @@
+"""民族码表 CRUD（全局 sys_ethnic）"""
+from typing import Any, Dict, List, Optional
+
+from sqlalchemy.orm import Session
+
+from app.models.models import SysEthnic
+
+
+def _row_to_dict(row: SysEthnic) -> Dict[str, Any]:
+    return {
+        "id": row.id,
+        "ethnicName": row.ethnic_name or "",
+        "ethnicCode": row.ethnic_code or "",
+        "orderNum": row.order_num,
+    }
+
+
+def list_ethnics(
+    db: Session,
+    *,
+    keyword: Optional[str] = None,
+    limit: int = 200,
+) -> List[Dict[str, Any]]:
+    q = db.query(SysEthnic).filter(SysEthnic.del_flag == 0)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q = q.filter(SysEthnic.ethnic_name.like(like))
+    rows = q.order_by(SysEthnic.order_num.asc(), SysEthnic.ethnic_code.asc()).limit(max(1, min(limit, 500))).all()
+    return [_row_to_dict(x) for x in rows]
diff --git a/backend/app/crud/exhibition_appointment.py b/backend/app/crud/exhibition_appointment.py
new file mode 100644
index 00000000..9bad235a
--- /dev/null
+++ b/backend/app/crud/exhibition_appointment.py
@@ -0,0 +1,238 @@
+"""展览预约 CRUD（biz_exhibition_appointment）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizExhibitionAppointment
+
+
+def _format_visit_date(val: Any) -> str:
+    """格式化 visit_date 为 YYYY-MM-DD HH:mm:ss 字符串"""
+    if val is None:
+        return ""
+    if isinstance(val, datetime):
+        return val.strftime("%Y-%m-%d %H:%M:%S")
+    return str(val)
+
+
+def _row_to_dict(u: BizExhibitionAppointment) -> Dict[str, Any]:
+    return {
+        "id": u.id,
+        "appointmentNo": u.appointment_no,
+        "visitOrg": u.visit_org,
+        "contactName": u.contact_name,
+        "visitDate": _format_visit_date(u.visit_date),
+        "visitorCount": u.visitor_count,
+        "receptionUserId": u.reception_user_id,
+        "tenantNo": u.tenant_no,
+        "orderNum": u.order_num if u.order_num is not None else 0,
+        "remark": u.remark or "",
+        "createTime": u.create_time.strftime("%Y-%m-%d %H:%M:%S") if u.create_time else "",
+        "updateTime": u.update_time.strftime("%Y-%m-%d %H:%M:%S") if u.update_time else "",
+    }
+
+
+def list_exhibition_appointments(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizExhibitionAppointment).filter(BizExhibitionAppointment.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizExhibitionAppointment.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(
+                or_(
+                    BizExhibitionAppointment.appointment_no.like(like),
+                    BizExhibitionAppointment.visit_org.like(like),
+                    BizExhibitionAppointment.contact_name.like(like),
+                )
+            )
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizExhibitionAppointment.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizExhibitionAppointment.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_exhibition_appointment(db: Session, appointment_id: str) -> Optional[BizExhibitionAppointment]:
+    return (
+        db.query(BizExhibitionAppointment)
+        .filter(and_(BizExhibitionAppointment.id == appointment_id, BizExhibitionAppointment.del_flag == 0))
+        .first()
+    )
+
+
+def appointment_no_exists(db: Session, appointment_no: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    q = db.query(BizExhibitionAppointment).filter(
+        and_(
+            BizExhibitionAppointment.appointment_no == appointment_no.strip(),
+            BizExhibitionAppointment.tenant_no == tenant_no,
+            BizExhibitionAppointment.del_flag == 0,
+        )
+    )
+    if exclude_id:
+        q = q.filter(BizExhibitionAppointment.id != exclude_id)
+    return q.first() is not None
+
+
+def _generate_appointment_no(db: Session, tenant_no: str) -> str:
+    """生成预约编号：YYYYMMDD + 6位序号（如 20260515000001）"""
+    today_str = datetime.now().strftime("%Y%m%d")
+    prefix = today_str
+    last_row = (
+        db.query(BizExhibitionAppointment.appointment_no)
+        .filter(
+            BizExhibitionAppointment.tenant_no == tenant_no,
+            BizExhibitionAppointment.appointment_no.like(f"{prefix}%"),
+            BizExhibitionAppointment.del_flag == 0,
+        )
+        .order_by(BizExhibitionAppointment.appointment_no.desc())
+        .first()
+    )
+    if last_row and last_row[0]:
+        try:
+            seq = int(last_row[0][len(prefix):]) + 1
+        except (ValueError, IndexError):
+            seq = 1
+    else:
+        seq = 1
+    return f"{prefix}{seq:06d}"
+
+
+def create_exhibition_appointment(
+    db: Session,
+    *,
+    appointment_no: Optional[str] = None,
+    visit_org: str,
+    contact_name: str,
+    visit_date: Optional[str] = None,
+    visitor_count: int,
+    reception_user_id: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizExhibitionAppointment:
+    no = (appointment_no or "").strip()
+    if not no:
+        no = _generate_appointment_no(db, tenant_no)
+    else:
+        if appointment_no_exists(db, no, tenant_no):
+            raise ValueError("预约编号已存在")
+    visit_date_val: Optional[datetime] = None
+    if visit_date:
+        try:
+            visit_date_val = datetime.fromisoformat(visit_date)
+        except (ValueError, TypeError):
+            visit_date_val = None
+    obj = BizExhibitionAppointment(
+        id=generate_uuid(),
+        appointment_no=no,
+        visit_org=(visit_org or "").strip(),
+        contact_name=(contact_name or "").strip(),
+        visit_date=visit_date_val,
+        visitor_count=visitor_count if visitor_count is not None else 0,
+        reception_user_id=reception_user_id or "",
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_exhibition_appointment(
+    db: Session,
+    appointment_id: str,
+    *,
+    appointment_no: Optional[str] = None,
+    visit_org: Optional[str] = None,
+    contact_name: Optional[str] = None,
+    visit_date: Optional[str] = None,
+    visitor_count: Optional[int] = None,
+    reception_user_id: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizExhibitionAppointment:
+    obj = get_exhibition_appointment(db, appointment_id)
+    if not obj:
+        raise ValueError("展览预约不存在")
+    if appointment_no is not None:
+        new_no = appointment_no.strip()
+        if not new_no:
+            raise ValueError("预约编号不能为空")
+        if new_no != obj.appointment_no and appointment_no_exists(db, new_no, obj.tenant_no, exclude_id=appointment_id):
+            raise ValueError("预约编号已存在")
+        obj.appointment_no = new_no
+    if visit_org is not None:
+        obj.visit_org = (visit_org or "").strip()
+    if contact_name is not None:
+        obj.contact_name = (contact_name or "").strip()
+    if visit_date is not None:
+        if visit_date:
+            try:
+                obj.visit_date = datetime.fromisoformat(visit_date)
+            except (ValueError, TypeError):
+                obj.visit_date = None
+        else:
+            obj.visit_date = None
+    if visitor_count is not None:
+        obj.visitor_count = visitor_count
+    if reception_user_id is not None:
+        obj.reception_user_id = reception_user_id or ""
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_exhibition_appointment(db: Session, appointment_id: str) -> None:
+    obj = get_exhibition_appointment(db, appointment_id)
+    if not obj:
+        raise ValueError("展览预约不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/express_company.py b/backend/app/crud/express_company.py
index 09fe5318..12967bda 100644
--- a/backend/app/crud/express_company.py
+++ b/backend/app/crud/express_company.py
@@ -48,7 +48,7 @@ def list_express_companies(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(BizExpressCompany.order_num.asc(), BizExpressCompany.create_time.desc())
+        .order_by(BizExpressCompany.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/item_unit.py b/backend/app/crud/item_unit.py
index db3f9006..d4e3c517 100644
--- a/backend/app/crud/item_unit.py
+++ b/backend/app/crud/item_unit.py
@@ -48,7 +48,7 @@ def list_item_units(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(BizItemUnit.order_num.asc(), BizItemUnit.create_time.desc())
+        .order_by(BizItemUnit.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/leave.py b/backend/app/crud/leave.py
new file mode 100644
index 00000000..6643a21f
--- /dev/null
+++ b/backend/app/crud/leave.py
@@ -0,0 +1,144 @@
+"""请假申请 CRUD"""
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizLeaveRequest
+
+
+def total_pages(total: int, page_size: int) -> int:
+    return (total + page_size - 1) // page_size if page_size else 0
+
+
+def _row_to_dict(row: BizLeaveRequest) -> Dict[str, Any]:
+    return {
+        "id": row.id,
+        "leaveType": row.leave_type,
+        "startDate": row.start_date,
+        "endDate": row.end_date,
+        "days": row.days,
+        "reason": row.reason or "",
+        "wfInstanceId": row.wf_instance_id or "",
+        "status": row.status,
+        "tenantNo": row.tenant_no,
+        "orderNum": row.order_num if row.order_num is not None else 0,
+        "remark": row.remark or "",
+        "createBy": row.create_by or "",
+        "createTime": row.create_time.strftime("%Y-%m-%d %H:%M:%S") if row.create_time else "",
+        "updateBy": row.update_by or "",
+        "updateTime": row.update_time.strftime("%Y-%m-%d %H:%M:%S") if row.update_time else "",
+    }
+
+
+def list_leaves(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    create_by: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    q = db.query(BizLeaveRequest).filter(BizLeaveRequest.del_flag == 0)
+    if tenant_no:
+        q = q.filter(BizLeaveRequest.tenant_no == tenant_no)
+    if status:
+        q = q.filter(BizLeaveRequest.status == status)
+    if create_by:
+        q = q.filter(BizLeaveRequest.create_by == create_by)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q = q.filter(or_(BizLeaveRequest.reason.like(like), BizLeaveRequest.leave_type.like(like)))
+    total = q.count()
+    rows = (
+        q.order_by(BizLeaveRequest.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(r) for r in rows], total
+
+
+def get_leave(db: Session, leave_id: str) -> Optional[Dict[str, Any]]:
+    row = db.query(BizLeaveRequest).filter(BizLeaveRequest.id == leave_id, BizLeaveRequest.del_flag == 0).first()
+    return _row_to_dict(row) if row else None
+
+
+def create_leave(
+    db: Session,
+    *,
+    leave_type: str,
+    start_date: str,
+    end_date: str,
+    days: int,
+    reason: str = "",
+    tenant_no: str = "zkxw",
+    user_id: str = "",
+    dept_id: str = "",
+    remark: str = "",
+) -> BizLeaveRequest:
+    row = BizLeaveRequest(
+        id=generate_uuid(),
+        leave_type=leave_type,
+        start_date=start_date,
+        end_date=end_date,
+        days=days,
+        reason=reason,
+        status="draft",
+        tenant_no=tenant_no,
+        create_by=user_id,
+        create_dept_id=dept_id,
+        remark=remark,
+    )
+    db.add(row)
+    db.flush()
+    return row
+
+
+def update_leave(db: Session, leave_id: str, *, user_id: str = "", **fields) -> None:
+    row = db.query(BizLeaveRequest).filter(BizLeaveRequest.id == leave_id, BizLeaveRequest.del_flag == 0).first()
+    if not row:
+        return
+    mapping = {
+        "leaveType": "leave_type",
+        "startDate": "start_date",
+        "endDate": "end_date",
+        "days": "days",
+        "reason": "reason",
+        "remark": "remark",
+    }
+    for camel, snake in mapping.items():
+        if camel in fields and fields[camel] is not None:
+            setattr(row, snake, fields[camel])
+    row.update_by = user_id
+    row.update_time = datetime.now()
+    db.flush()
+
+
+def update_leave_status(db: Session, leave_id: str, status: str, wf_instance_id: str = "", user_id: str = "") -> None:
+    row = db.query(BizLeaveRequest).filter(BizLeaveRequest.id == leave_id, BizLeaveRequest.del_flag == 0).first()
+    if not row:
+        return
+    row.status = status
+    if wf_instance_id:
+        row.wf_instance_id = wf_instance_id
+    row.update_by = user_id
+    row.update_time = datetime.now()
+    db.flush()
+
+
+def soft_delete_leave(db: Session, leave_id: str, user_id: str = "") -> None:
+    row = db.query(BizLeaveRequest).filter(BizLeaveRequest.id == leave_id, BizLeaveRequest.del_flag == 0).first()
+    if not row:
+        return
+    row.del_flag = 1
+    row.update_by = user_id
+    row.update_time = datetime.now()
+    db.flush()
diff --git a/backend/app/crud/menu.py b/backend/app/crud/menu.py
index ae252d25..137aaf7c 100644
--- a/backend/app/crud/menu.py
+++ b/backend/app/crud/menu.py
@@ -51,7 +51,7 @@ def list_menus(
     if kw:
         like = f"%{kw}%"
         q = q.filter(SysMenu.menu_name.like(like))
-    rows = q.order_by(SysMenu.order_num.asc(), SysMenu.create_time.desc()).all()
+    rows = q.order_by(SysMenu.create_time.desc()).all()
     return [_row_to_dict(x) for x in rows]
 
 
diff --git a/backend/app/crud/post.py b/backend/app/crud/post.py
index d9c05b15..6916a660 100644
--- a/backend/app/crud/post.py
+++ b/backend/app/crud/post.py
@@ -49,7 +49,7 @@ def list_posts(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysPost.order_num.asc(), SysPost.create_time.desc())
+        .order_by(SysPost.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/role.py b/backend/app/crud/role.py
index 37ef6b4f..4ab4e6f1 100644
--- a/backend/app/crud/role.py
+++ b/backend/app/crud/role.py
@@ -65,7 +65,7 @@ def list_roles(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysRole.order_num.asc(), SysRole.create_time.desc())
+        .order_by(SysRole.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
@@ -207,13 +207,12 @@ def update_role_menus(
     tenant_no: str,
     user_id: Optional[str] = None,
 ) -> None:
-    # soft-delete old
-    db.query(SysRoleMenu).filter(
-        and_(SysRoleMenu.role_id == role_id, SysRoleMenu.del_flag == 0)
-    ).update({"del_flag": 1, "update_time": datetime.now()})
-    # insert new
+    # uk_role_menu 为 (role_id, menu_id, del_flag)：先全量软删再插入会在再次保存时
+    # 出现两条 (role_id, menu_id, del_flag=1)，触发 1062。关联表采用整角色物理清理后重建。
+    unique_ids = list(dict.fromkeys(menu_ids or []))
+    db.query(SysRoleMenu).filter(SysRoleMenu.role_id == role_id).delete(synchronize_session=False)
     now = datetime.now()
-    for mid in menu_ids:
+    for mid in unique_ids:
         obj = SysRoleMenu(
             id=generate_uuid(),
             role_id=role_id,
diff --git a/backend/app/crud/sample_code.py b/backend/app/crud/sample_code.py
new file mode 100644
index 00000000..c4923626
--- /dev/null
+++ b/backend/app/crud/sample_code.py
@@ -0,0 +1,341 @@
+"""样本编码池 CRUD（biz_sample_code）"""
+from __future__ import annotations
+
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizSampleCode
+
+
+def _row_to_dict(r: BizSampleCode) -> Dict[str, Any]:
+    return {
+        "id": r.id,
+        "sampleCode": r.sample_code,
+        "sampleCodeType": r.sample_code_type or "",
+        "issued": int(r.issued or 0),
+        "issuedUserId": r.issued_user_id or "",
+        "issuedUserName": r.issued_user_name or "",
+        "issuedTime": r.issued_time.strftime("%Y-%m-%d %H:%M:%S") if r.issued_time else "",
+        "tenantNo": r.tenant_no,
+        "orderNum": r.order_num if r.order_num is not None else 0,
+        "remark": r.remark or "",
+        "createTime": r.create_time.strftime("%Y-%m-%d %H:%M:%S") if r.create_time else "",
+        "updateTime": r.update_time.strftime("%Y-%m-%d %H:%M:%S") if r.update_time else "",
+    }
+
+
+def sample_code_exists(db: Session, code: str, tenant_no: str, exclude_id: Optional[str] = None) -> bool:
+    v = (code or "").strip()
+    if not v:
+        return False
+    q = db.query(BizSampleCode).filter(
+        and_(BizSampleCode.sample_code == v, BizSampleCode.tenant_no == tenant_no, BizSampleCode.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(BizSampleCode.id != exclude_id)
+    return q.first() is not None
+
+
+def list_sample_codes(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(BizSampleCode).filter(BizSampleCode.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(BizSampleCode.tenant_no == tenant_no)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(BizSampleCode.sample_code.like(like), BizSampleCode.remark.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(BizSampleCode.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(BizSampleCode.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    return [_row_to_dict(x) for x in rows], int(total)
+
+
+def get_sample_code(db: Session, row_id: str, tenant_no: Optional[str] = None) -> Optional[BizSampleCode]:
+    q = db.query(BizSampleCode).filter(and_(BizSampleCode.id == row_id, BizSampleCode.del_flag == 0))
+    if tenant_no:
+        q = q.filter(BizSampleCode.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_sample_code(
+    db: Session,
+    *,
+    sample_code: str,
+    issued: int = 0,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizSampleCode:
+    sc = (sample_code or "").strip()
+    if not sc:
+        raise ValueError("样本编码不能为空")
+    if sample_code_exists(db, sc, tenant_no):
+        raise ValueError("样本编码已存在")
+    obj = BizSampleCode(
+        id=generate_uuid(),
+        sample_code=sc,
+        issued=1 if issued else 0,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_sample_code(
+    db: Session,
+    row_id: str,
+    *,
+    sample_code: Optional[str] = None,
+    issued: Optional[int] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    issued_user_id: Optional[str] = None,
+    issued_user_name: Optional[str] = None,
+    issued_time: Optional[str] = None,
+) -> BizSampleCode:
+    obj = get_sample_code(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("记录不存在")
+    if sample_code is not None:
+        sc = sample_code.strip()
+        if not sc:
+            raise ValueError("样本编码不能为空")
+        if sc != obj.sample_code and sample_code_exists(db, sc, obj.tenant_no, exclude_id=row_id):
+            raise ValueError("样本编码已存在")
+        obj.sample_code = sc
+    if issued is not None:
+        obj.issued = 1 if issued else 0
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = remark.strip() or None
+    if issued_user_id is not None:
+        obj.issued_user_id = issued_user_id or None
+    if issued_user_name is not None:
+        obj.issued_user_name = issued_user_name or None
+    if issued_time is not None:
+        obj.issued_time = issued_time or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_sample_code(db: Session, row_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_sample_code(db, row_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("记录不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def batch_generate_sample_codes(
+    db: Session,
+    *,
+    sample_code_type: str,
+    middle: str,
+    seq_start: int,
+    seq_end: int,
+    digit_count: int = 6,
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    """批量生成样本编码: 类型前缀 + 中间段 + 补零序号"""
+    t = (sample_code_type or "").strip()
+    if t not in ("zxbm", "qdbm"):
+        raise ValueError("样本编码类型无效，仅支持 zxbm/qdbm")
+    m = (middle or "").strip()
+    if not m:
+        raise ValueError("中间段不能为空")
+    if seq_start < 0 or seq_end < 0:
+        raise ValueError("序号不能为负数")
+    if seq_start > seq_end:
+        raise ValueError("开始序号不能大于结束序号")
+    if digit_count < 1:
+        raise ValueError("序号位数不能小于1")
+    count = seq_end - seq_start + 1
+    if count > 10000:
+        raise ValueError("单次批量生成不能超过10000条")
+
+    prefix_map = {"zxbm": "ZKZX", "qdbm": "ZKQD"}
+    prefix = prefix_map[t]
+
+    generated_codes = []
+    for i in range(seq_start, seq_end + 1):
+        seq_str = str(i).zfill(digit_count)
+        full_code = f"{prefix}{m}{seq_str}"
+        generated_codes.append(full_code)
+
+    existing = set(
+        row.sample_code
+        for row in db.query(BizSampleCode.sample_code)
+        .filter(
+            BizSampleCode.tenant_no == tenant_no,
+            BizSampleCode.del_flag == 0,
+            BizSampleCode.sample_code.in_(generated_codes),
+        )
+        .all()
+    )
+
+    now = datetime.now()
+    created = []
+    skipped = []
+    for code in generated_codes:
+        if code in existing:
+            skipped.append(code)
+            continue
+        obj = BizSampleCode(
+            id=generate_uuid(),
+            sample_code=code,
+            sample_code_type=t,
+            issued=0,
+            tenant_no=tenant_no,
+            order_num=0,
+            remark=None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=now,
+            update_by=user_id,
+            update_time=now,
+            del_flag=0,
+        )
+        created.append(obj)
+
+    if created:
+        db.bulk_save_objects(created)
+        db.commit()
+
+    return {
+        "created": len(created),
+        "skipped": len(skipped),
+        "skippedCodes": skipped,
+    }
+
+
+def batch_issue_sample_codes(
+    db: Session,
+    *,
+    ids: List[str],
+    issued_user_id: str,
+    issued_user_name: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    """批量下发样本编码"""
+    if not ids:
+        raise ValueError("请选择要下发的样本编码")
+    uid = (issued_user_id or "").strip()
+    if not uid:
+        raise ValueError("请选择下发用户")
+
+    now = datetime.now()
+    issued_count = 0
+    already_issued = []
+
+    for row_id in ids:
+        obj = get_sample_code(db, row_id, tenant_no=tenant_no)
+        if not obj:
+            continue
+        if obj.issued == 1:
+            already_issued.append(obj.sample_code)
+            continue
+        obj.issued = 1
+        obj.issued_user_id = uid
+        obj.issued_user_name = (issued_user_name or "").strip() or None
+        obj.issued_time = now
+        obj.update_by = user_id
+        obj.update_time = now
+        db.add(obj)
+        issued_count += 1
+
+    if issued_count > 0:
+        db.commit()
+
+    return {
+        "issuedCount": issued_count,
+        "alreadyIssued": already_issued,
+    }
+
+
+def batch_revoke_sample_codes(
+    db: Session,
+    *,
+    ids: List[str],
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    if not ids:
+        raise ValueError("请选择要收回的样本编码")
+
+    now = datetime.now()
+    revoked_count = 0
+    not_issued = []
+
+    for row_id in ids:
+        obj = get_sample_code(db, row_id, tenant_no=tenant_no)
+        if not obj:
+            continue
+        if obj.issued != 1:
+            not_issued.append(obj.sample_code)
+            continue
+        obj.issued = 0
+        obj.issued_user_id = None
+        obj.issued_user_name = None
+        obj.issued_time = None
+        obj.update_by = user_id
+        obj.update_time = now
+        db.add(obj)
+        revoked_count += 1
+
+    if revoked_count > 0:
+        db.commit()
+
+    return {
+        "revokedCount": revoked_count,
+        "notIssued": not_issued,
+    }
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/crud/site.py b/backend/app/crud/site.py
index 4b38d98f..37f7a182 100644
--- a/backend/app/crud/site.py
+++ b/backend/app/crud/site.py
@@ -54,7 +54,7 @@ def list_sites(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysSite.order_num.asc(), SysSite.create_time.desc())
+        .order_by(SysSite.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/storage_facility.py b/backend/app/crud/storage_facility.py
new file mode 100644
index 00000000..085fe25e
--- /dev/null
+++ b/backend/app/crud/storage_facility.py
@@ -0,0 +1,356 @@
+"""存储设施（树结构）+ 小格 CRUD（biz_storage_facility / biz_storage_facility_slot）"""
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from sqlalchemy import and_, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import BizStorageFacility, BizStorageFacilitySlot
+
+
+# ---------------------------------------------------------------------------
+# Facility node helpers
+# ---------------------------------------------------------------------------
+
+
+def _row_to_dict(f: BizStorageFacility) -> Dict[str, Any]:
+    return {
+        "id": f.id,
+        "parentId": f.parent_id,
+        "nodeName": f.node_name,
+        "nodeType": f.node_type or "",
+        "isLeaf": 1 if f.is_leaf else 0,
+        "tenantNo": f.tenant_no,
+        "orderNum": f.order_num if f.order_num is not None else 0,
+        "remark": f.remark or "",
+        "createTime": f.create_time.strftime("%Y-%m-%d %H:%M:%S") if f.create_time else "",
+        "updateTime": f.update_time.strftime("%Y-%m-%d %H:%M:%S") if f.update_time else "",
+    }
+
+
+def list_all_facilities(
+    db: Session,
+    *,
+    tenant_no: str,
+    keyword: Optional[str] = None,
+) -> List[Dict[str, Any]]:
+    """Return FLAT list of all non-deleted facility nodes (no pagination, no tree building)."""
+    q = db.query(BizStorageFacility).filter(BizStorageFacility.del_flag == 0)
+    if tenant_no:
+        q = q.filter(BizStorageFacility.tenant_no == tenant_no)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q = q.filter(BizStorageFacility.node_name.like(like))
+    rows = q.order_by(BizStorageFacility.order_num.asc(), BizStorageFacility.create_time.asc()).all()
+    return [_row_to_dict(x) for x in rows]
+
+
+def get_facility(db: Session, node_id: str, tenant_no: Optional[str] = None) -> Optional[BizStorageFacility]:
+    q = db.query(BizStorageFacility).filter(
+        and_(BizStorageFacility.id == node_id, BizStorageFacility.del_flag == 0)
+    )
+    if tenant_no:
+        q = q.filter(BizStorageFacility.tenant_no == tenant_no)
+    return q.first()
+
+
+def get_children(db: Session, parent_id: str, tenant_no: str) -> List[BizStorageFacility]:
+    """Direct children of a node."""
+    return (
+        db.query(BizStorageFacility)
+        .filter(
+            and_(
+                BizStorageFacility.parent_id == parent_id,
+                BizStorageFacility.del_flag == 0,
+                BizStorageFacility.tenant_no == tenant_no,
+            )
+        )
+        .order_by(BizStorageFacility.order_num.asc(), BizStorageFacility.create_time.asc())
+        .all()
+    )
+
+
+def collect_descendant_ids(db: Session, node_id: str, tenant_no: str) -> List[str]:
+    """Iteratively collect ALL descendant node IDs (stack-based, no recursion)."""
+    ids: List[str] = []
+    stack: List[str] = [node_id]
+    while stack:
+        current = stack.pop()
+        children = get_children(db, current, tenant_no)
+        for child in children:
+            ids.append(child.id)
+            stack.append(child.id)
+    return ids
+
+
+def create_facility(
+    db: Session,
+    *,
+    parent_id: str = "0",
+    node_name: str,
+    node_type: Optional[str] = None,
+    is_leaf: int = 0,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizStorageFacility:
+    name = (node_name or "").strip()
+    if not name:
+        raise ValueError("节点名称不能为空")
+    obj = BizStorageFacility(
+        id=generate_uuid(),
+        parent_id=parent_id or "0",
+        node_name=name,
+        node_type=(node_type or "").strip() or None,
+        is_leaf=is_leaf,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_facility(
+    db: Session,
+    node_id: str,
+    *,
+    node_name: Optional[str] = None,
+    node_type: Optional[str] = None,
+    is_leaf: Optional[int] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizStorageFacility:
+    obj = get_facility(db, node_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("存储设施节点不存在")
+    if node_name is not None:
+        name = (node_name or "").strip()
+        if not name:
+            raise ValueError("节点名称不能为空")
+        obj.node_name = name
+    if node_type is not None:
+        obj.node_type = (node_type or "").strip() or None
+    if is_leaf is not None:
+        obj.is_leaf = is_leaf
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_facility(db: Session, node_id: str, tenant_no: Optional[str] = None) -> None:
+    """Cascade soft-delete: node + all descendants + their slots."""
+    node = get_facility(db, node_id, tenant_no=tenant_no)
+    if not node:
+        raise ValueError("存储设施节点不存在")
+    # Collect all descendant IDs
+    all_ids = [node_id] + collect_descendant_ids(db, node_id, node.tenant_no)
+    now = datetime.now()
+    # Soft-delete all slots belonging to these nodes
+    db.query(BizStorageFacilitySlot).filter(
+        BizStorageFacilitySlot.facility_node_id.in_(all_ids),
+        BizStorageFacilitySlot.del_flag == 0,
+    ).update({"del_flag": 1, "update_time": now}, synchronize_session=False)
+    # Soft-delete all facility nodes
+    db.query(BizStorageFacility).filter(
+        BizStorageFacility.id.in_(all_ids),
+        BizStorageFacility.del_flag == 0,
+    ).update({"del_flag": 1, "update_time": now}, synchronize_session=False)
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# Slot helpers
+# ---------------------------------------------------------------------------
+
+
+def _slot_to_dict(s: BizStorageFacilitySlot) -> Dict[str, Any]:
+    return {
+        "id": s.id,
+        "facilityNodeId": s.facility_node_id,
+        "slotCode": s.slot_code or "",
+        "slotStatus": s.slot_status or "",
+        "tenantNo": s.tenant_no,
+        "orderNum": s.order_num if s.order_num is not None else 0,
+        "remark": s.remark or "",
+        "createTime": s.create_time.strftime("%Y-%m-%d %H:%M:%S") if s.create_time else "",
+        "updateTime": s.update_time.strftime("%Y-%m-%d %H:%M:%S") if s.update_time else "",
+    }
+
+
+def list_slots(
+    db: Session,
+    *,
+    facility_node_id: str,
+    tenant_no: Optional[str] = None,
+) -> List[Dict[str, Any]]:
+    q = db.query(BizStorageFacilitySlot).filter(
+        and_(
+            BizStorageFacilitySlot.facility_node_id == facility_node_id,
+            BizStorageFacilitySlot.del_flag == 0,
+        )
+    )
+    if tenant_no:
+        q = q.filter(BizStorageFacilitySlot.tenant_no == tenant_no)
+    rows = q.order_by(BizStorageFacilitySlot.order_num.asc(), BizStorageFacilitySlot.create_time.asc()).all()
+    return [_slot_to_dict(x) for x in rows]
+
+
+def get_slot(db: Session, slot_id: str, tenant_no: Optional[str] = None) -> Optional[BizStorageFacilitySlot]:
+    q = db.query(BizStorageFacilitySlot).filter(
+        and_(BizStorageFacilitySlot.id == slot_id, BizStorageFacilitySlot.del_flag == 0)
+    )
+    if tenant_no:
+        q = q.filter(BizStorageFacilitySlot.tenant_no == tenant_no)
+    return q.first()
+
+
+def create_slot(
+    db: Session,
+    *,
+    facility_node_id: str,
+    slot_code: Optional[str] = None,
+    slot_status: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> BizStorageFacilitySlot:
+    fid = (facility_node_id or "").strip()
+    if not fid:
+        raise ValueError("所属设施节点不能为空")
+    obj = BizStorageFacilitySlot(
+        id=generate_uuid(),
+        facility_node_id=fid,
+        slot_code=(slot_code or "").strip() or None,
+        slot_status=(slot_status or "").strip() or None,
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_slot(
+    db: Session,
+    slot_id: str,
+    *,
+    slot_code: Optional[str] = None,
+    slot_status: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> BizStorageFacilitySlot:
+    obj = get_slot(db, slot_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("存储设施小格不存在")
+    if slot_code is not None:
+        obj.slot_code = (slot_code or "").strip() or None
+    if slot_status is not None:
+        obj.slot_status = (slot_status or "").strip() or None
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_slot(db: Session, slot_id: str, tenant_no: Optional[str] = None) -> None:
+    obj = get_slot(db, slot_id, tenant_no=tenant_no)
+    if not obj:
+        raise ValueError("存储设施小格不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def batch_create_slots(
+    db: Session,
+    *,
+    facility_node_id: str,
+    rows: int,
+    cols: int,
+    code_prefix: str = "",
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> List[Dict[str, Any]]:
+    fid = (facility_node_id or "").strip()
+    if not fid:
+        raise ValueError("所属设施节点不能为空")
+    if rows < 1 or cols < 1:
+        raise ValueError("行数和列数必须大于 0")
+    if rows > 50 or cols > 50:
+        raise ValueError("单次最多生成 50×50 = 2500 个格子")
+    node = db.query(BizStorageFacility).filter(
+        and_(BizStorageFacility.id == fid, BizStorageFacility.del_flag == 0)
+    ).first()
+    if not node:
+        raise ValueError("所属设施节点不存在")
+    if not node.is_leaf:
+        raise ValueError("只能为叶子节点创建格子")
+    prefix = (code_prefix or "").strip()
+    now = datetime.now()
+    slots: List[BizStorageFacilitySlot] = []
+    for r in range(1, rows + 1):
+        for c in range(1, cols + 1):
+            code = f"{prefix}{r}-{c}" if prefix else f"{r}-{c}"
+            order = (r - 1) * cols + c
+            obj = BizStorageFacilitySlot(
+                id=generate_uuid(),
+                facility_node_id=fid,
+                slot_code=code,
+                slot_status="空",
+                tenant_no=tenant_no,
+                order_num=order,
+                remark=None,
+                create_by=user_id,
+                create_dept_id="",
+                create_time=now,
+                update_by=user_id,
+                update_time=now,
+                del_flag=0,
+            )
+            db.add(obj)
+            slots.append(obj)
+    db.commit()
+    for s in slots:
+        db.refresh(s)
+    return [_slot_to_dict(s) for s in slots]
diff --git a/backend/app/crud/tenant.py b/backend/app/crud/tenant.py
index a4004790..8b24a0ed 100644
--- a/backend/app/crud/tenant.py
+++ b/backend/app/crud/tenant.py
@@ -47,7 +47,7 @@ def list_tenants(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysTenant.order_num.asc(), SysTenant.create_time.desc())
+        .order_by(SysTenant.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
diff --git a/backend/app/crud/user.py b/backend/app/crud/user.py
index 9f65a9db..5df57a35 100644
--- a/backend/app/crud/user.py
+++ b/backend/app/crud/user.py
@@ -90,7 +90,7 @@ def list_users(
     page_size = min(max(1, page_size), 100)
     rows = (
         _filtered()
-        .order_by(SysUser.order_num.asc(), SysUser.create_time.desc())
+        .order_by(SysUser.create_time.desc())
         .offset((page - 1) * page_size)
         .limit(page_size)
         .all()
@@ -114,6 +114,91 @@ def get_user(db: Session, user_id: str) -> Optional[SysUser]:
     )
 
 
+def list_post_ids_for_user(db: Session, user_id: str) -> List[str]:
+    """用户当前有效职位 ID 列表。"""
+    return [
+        r.post_id
+        for r in db.query(SysUserPost)
+        .filter(and_(SysUserPost.user_id == user_id, SysUserPost.del_flag == 0))
+        .all()
+    ]
+
+
+def set_user_post_ids_only(
+    db: Session,
+    user_id: str,
+    tenant_no: str,
+    post_ids: List[str],
+    updater_id: Optional[str],
+) -> None:
+    """仅替换 sys_user_post，不影响 sys_user_role。"""
+    now = datetime.now()
+    uniq = [p for p in dict.fromkeys(post_ids or []) if p]
+    db.query(SysUserPost).filter(
+        and_(SysUserPost.user_id == user_id, SysUserPost.del_flag == 0)
+    ).update({"del_flag": 1, "update_time": now}, synchronize_session=False)
+    for pid in uniq:
+        db.add(
+            SysUserPost(
+                id=generate_uuid(),
+                user_id=user_id,
+                post_id=pid,
+                tenant_no=tenant_no,
+                order_num=0,
+                remark=None,
+                create_by=updater_id,
+                create_dept_id="",
+                create_time=now,
+                update_by=updater_id,
+                update_time=now,
+                del_flag=0,
+            )
+        )
+
+
+def list_user_ids_bound_to_post(db: Session, post_id: str, tenant_no: str) -> List[str]:
+    rows = (
+        db.query(SysUserPost.user_id)
+        .filter(
+            and_(
+                SysUserPost.post_id == post_id,
+                SysUserPost.tenant_no == tenant_no,
+                SysUserPost.del_flag == 0,
+            )
+        )
+        .all()
+    )
+    return [r[0] for r in rows]
+
+
+def sync_post_user_bindings(
+    db: Session,
+    post_id: str,
+    tenant_no: str,
+    user_ids: List[str],
+    updater_id: Optional[str],
+) -> None:
+    """将本职位绑定的用户集合设为 user_ids（只增删本职位，保留用户其它职位与角色）。"""
+    ordered = list(dict.fromkeys([uid for uid in (user_ids or []) if uid]))
+    for uid in ordered:
+        u = get_user(db, uid)
+        if not u or u.tenant_no != tenant_no:
+            raise ValueError("存在无效用户或用户不属于当前租户")
+
+    current = set(list_user_ids_bound_to_post(db, post_id, tenant_no))
+    target = set(ordered)
+    affected = current | target
+    for uid in affected:
+        u = get_user(db, uid)
+        if not u or u.tenant_no != tenant_no:
+            continue
+        existing = list_post_ids_for_user(db, uid)
+        without = [p for p in existing if p != post_id]
+        new_posts = without + [post_id] if uid in target else without
+        set_user_post_ids_only(db, uid, tenant_no, new_posts, updater_id)
+    db.commit()
+
+
 def get_user_with_relations(db: Session, user_id: str) -> Optional[Dict[str, Any]]:
     u = get_user(db, user_id)
     if not u:
@@ -133,12 +218,7 @@ def get_user_with_relations(db: Session, user_id: str) -> Optional[Dict[str, Any
         .filter(and_(SysUserRole.user_id == user_id, SysUserRole.del_flag == 0))
         .all()
     ]
-    post_ids = [
-        p.post_id
-        for p in db.query(SysUserPost)
-        .filter(and_(SysUserPost.user_id == user_id, SysUserPost.del_flag == 0))
-        .all()
-    ]
+    post_ids = list_post_ids_for_user(db, user_id)
     d["roleIds"] = role_ids
     d["postIds"] = post_ids
     return d
diff --git a/backend/app/crud/workflow.py b/backend/app/crud/workflow.py
new file mode 100644
index 00000000..9fc3ffdf
--- /dev/null
+++ b/backend/app/crud/workflow.py
@@ -0,0 +1,760 @@
+"""工作流 CRUD（wf_process_def / wf_process_version / wf_node / wf_transition / wf_process_instance / wf_task）"""
+from __future__ import annotations
+
+import json
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import (
+    SysUser,
+    WfNode,
+    WfProcessDef,
+    WfProcessInstance,
+    WfProcessVersion,
+    WfTask,
+    WfTransition,
+)
+
+
+# ---------------------------------------------------------------------------
+# 流程定义 wf_process_def
+# ---------------------------------------------------------------------------
+
+
+def _row_to_dict(t: WfProcessDef) -> Dict[str, Any]:
+    return {
+        "id": t.id,
+        "processCode": t.process_code,
+        "processName": t.process_name,
+        "status": t.status,
+        "tenantNo": t.tenant_no,
+        "orderNum": t.order_num if t.order_num is not None else 0,
+        "remark": t.remark or "",
+        "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+        "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+    }
+
+
+def list_process_defs(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(WfProcessDef).filter(WfProcessDef.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(WfProcessDef.tenant_no == tenant_no)
+        if status is not None:
+            q0 = q0.filter(WfProcessDef.status == status)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(or_(WfProcessDef.process_name.like(like), WfProcessDef.process_code.like(like)))
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(WfProcessDef.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(WfProcessDef.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+
+    result = []
+    for r in rows:
+        d = _row_to_dict(r)
+        ver = (
+            db.query(WfProcessVersion)
+            .filter(
+                and_(
+                    WfProcessVersion.process_def_id == r.id,
+                    WfProcessVersion.is_latest == "1",
+                    WfProcessVersion.del_flag == 0,
+                )
+            )
+            .order_by(WfProcessVersion.version_no.desc())
+            .first()
+        )
+        d["latestVersion"] = ver.version_no if ver else None
+        result.append(d)
+    return result, int(total)
+
+
+def get_process_def(db: Session, def_id: str) -> Optional[WfProcessDef]:
+    return (
+        db.query(WfProcessDef)
+        .filter(and_(WfProcessDef.id == def_id, WfProcessDef.del_flag == 0))
+        .first()
+    )
+
+
+def process_code_exists(
+    db: Session, code: str, tenant_no: str, exclude_id: Optional[str] = None
+) -> bool:
+    q = db.query(WfProcessDef).filter(
+        and_(WfProcessDef.process_code == code.strip(), WfProcessDef.tenant_no == tenant_no, WfProcessDef.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(WfProcessDef.id != exclude_id)
+    return q.first() is not None
+
+
+def create_process_def(
+    db: Session,
+    *,
+    process_code: str,
+    process_name: str,
+    tenant_no: str,
+    status: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfProcessDef:
+    code = (process_code or "").strip()
+    if not code:
+        raise ValueError("流程编码不能为空")
+    if process_code_exists(db, code, tenant_no):
+        raise ValueError("流程编码已存在")
+    obj = WfProcessDef(
+        id=generate_uuid(),
+        process_code=code,
+        process_name=(process_name or "").strip(),
+        status=status or "1",
+        tenant_no=tenant_no,
+        order_num=order_num if order_num is not None else 0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_process_def(
+    db: Session,
+    def_id: str,
+    *,
+    process_code: Optional[str] = None,
+    process_name: Optional[str] = None,
+    status: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> WfProcessDef:
+    obj = get_process_def(db, def_id)
+    if not obj:
+        raise ValueError("流程定义不存在")
+    if process_code is not None:
+        new_code = process_code.strip()
+        if not new_code:
+            raise ValueError("流程编码不能为空")
+        tn = tenant_no or obj.tenant_no
+        if new_code != obj.process_code and process_code_exists(db, new_code, tn, exclude_id=def_id):
+            raise ValueError("流程编码已存在")
+        obj.process_code = new_code
+    if process_name is not None:
+        obj.process_name = (process_name or "").strip()
+    if status is not None:
+        obj.status = status
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_process_def(db: Session, def_id: str) -> None:
+    obj = get_process_def(db, def_id)
+    if not obj:
+        raise ValueError("流程定义不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# 流程版本 wf_process_version
+# ---------------------------------------------------------------------------
+
+
+def publish_version(
+    db: Session,
+    process_def_id: str,
+    graph_json: str,
+    nodes: List[Dict[str, Any]],
+    transitions: List[Dict[str, Any]],
+    tenant_no: str,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfProcessVersion:
+    defn = get_process_def(db, process_def_id)
+    if not defn:
+        raise ValueError("流程定义不存在")
+
+    db.query(WfProcessVersion).filter(
+        and_(
+            WfProcessVersion.process_def_id == process_def_id,
+            WfProcessVersion.is_latest == "1",
+            WfProcessVersion.del_flag == 0,
+        )
+    ).update({"is_latest": "0", "update_time": datetime.now()}, synchronize_session=False)
+
+    max_ver = (
+        db.query(func.max(WfProcessVersion.version_no))
+        .filter(and_(WfProcessVersion.process_def_id == process_def_id, WfProcessVersion.del_flag == 0))
+        .scalar()
+    ) or 0
+    new_ver_no = max_ver + 1
+
+    ver = WfProcessVersion(
+        id=generate_uuid(),
+        process_def_id=process_def_id,
+        version_no=new_ver_no,
+        graph_json=graph_json,
+        is_latest="1",
+        tenant_no=tenant_no,
+        order_num=0,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(ver)
+    db.flush()
+
+    for idx, n in enumerate(nodes):
+        node = WfNode(
+            id=generate_uuid(),
+            process_version_id=ver.id,
+            node_key=n.get("nodeKey", ""),
+            node_type=n.get("nodeType", ""),
+            node_name=n.get("nodeName"),
+            config_json=n.get("configJson"),
+            tenant_no=tenant_no,
+            order_num=idx,
+            remark=None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        db.add(node)
+
+    for idx, t in enumerate(transitions):
+        trans = WfTransition(
+            id=generate_uuid(),
+            process_version_id=ver.id,
+            from_node_key=t.get("fromNodeKey", ""),
+            to_node_key=t.get("toNodeKey", ""),
+            condition_expr=t.get("conditionExpr"),
+            tenant_no=tenant_no,
+            order_num=idx,
+            remark=None,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        db.add(trans)
+
+    db.commit()
+    db.refresh(ver)
+    return ver
+
+
+def get_latest_version(db: Session, process_def_id: str) -> Optional[WfProcessVersion]:
+    return (
+        db.query(WfProcessVersion)
+        .filter(
+            and_(
+                WfProcessVersion.process_def_id == process_def_id,
+                WfProcessVersion.is_latest == "1",
+                WfProcessVersion.del_flag == 0,
+            )
+        )
+        .first()
+    )
+
+
+def _version_to_dict(v: WfProcessVersion) -> Dict[str, Any]:
+    return {
+        "id": v.id,
+        "versionNo": v.version_no,
+        "isLatest": v.is_latest,
+        "remark": v.remark or "",
+        "createTime": v.create_time.strftime("%Y-%m-%d %H:%M:%S") if v.create_time else "",
+        "updateTime": v.update_time.strftime("%Y-%m-%d %H:%M:%S") if v.update_time else "",
+    }
+
+
+def list_versions(
+    db: Session, process_def_id: str, tenant_no: Optional[str] = None
+) -> List[Dict[str, Any]]:
+    q = db.query(WfProcessVersion).filter(
+        and_(WfProcessVersion.process_def_id == process_def_id, WfProcessVersion.del_flag == 0)
+    )
+    if tenant_no:
+        q = q.filter(WfProcessVersion.tenant_no == tenant_no)
+    rows = q.order_by(WfProcessVersion.version_no.desc()).all()
+    return [_version_to_dict(v) for v in rows]
+
+
+def get_nodes_by_version(db: Session, version_id: str) -> List[WfNode]:
+    return (
+        db.query(WfNode)
+        .filter(and_(WfNode.process_version_id == version_id, WfNode.del_flag == 0))
+        .order_by(WfNode.order_num.asc())
+        .all()
+    )
+
+
+def get_transitions_by_version(db: Session, version_id: str) -> List[WfTransition]:
+    return (
+        db.query(WfTransition)
+        .filter(and_(WfTransition.process_version_id == version_id, WfTransition.del_flag == 0))
+        .order_by(WfTransition.order_num.asc())
+        .all()
+    )
+
+
+# ---------------------------------------------------------------------------
+# 流程实例 wf_process_instance
+# ---------------------------------------------------------------------------
+
+
+def create_instance(
+    db: Session,
+    *,
+    process_version_id: str,
+    business_type: Optional[str] = None,
+    business_id: Optional[str] = None,
+    starter_user_id: Optional[str] = None,
+    variables: Optional[Dict[str, Any]] = None,
+    status: Optional[str] = None,
+    callback_url: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfProcessInstance:
+    obj = WfProcessInstance(
+        id=generate_uuid(),
+        process_version_id=process_version_id,
+        business_type=business_type,
+        business_id=business_id,
+        starter_user_id=starter_user_id,
+        variables_json=json.dumps(variables, ensure_ascii=False) if variables else None,
+        status=status or "running",
+        callback_url=callback_url,
+        tenant_no=tenant_no or "zkxw",
+        order_num=0,
+        remark=None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def get_instance(db: Session, instance_id: str) -> Optional[WfProcessInstance]:
+    return (
+        db.query(WfProcessInstance)
+        .filter(and_(WfProcessInstance.id == instance_id, WfProcessInstance.del_flag == 0))
+        .first()
+    )
+
+
+def update_instance_status(db: Session, instance_id: str, status: str) -> None:
+    obj = get_instance(db, instance_id)
+    if not obj:
+        raise ValueError("流程实例不存在")
+    obj.status = status
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+def list_my_instances(
+    db: Session,
+    user_id: str,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    from sqlalchemy import func as sa_func
+
+    latest_per_biz = (
+        db.query(
+            WfProcessInstance.business_id,
+            sa_func.max(WfProcessInstance.create_time).label("max_ct"),
+        )
+        .filter(
+            and_(
+                WfProcessInstance.starter_user_id == user_id,
+                WfProcessInstance.del_flag == 0,
+                WfProcessInstance.business_id != None,
+                WfProcessInstance.business_id != "",
+            )
+        )
+        .group_by(WfProcessInstance.business_id)
+        .subquery()
+    )
+
+    q0 = (
+        db.query(WfProcessInstance, WfProcessVersion, WfProcessDef)
+        .join(WfProcessVersion, WfProcessInstance.process_version_id == WfProcessVersion.id)
+        .join(WfProcessDef, WfProcessVersion.process_def_id == WfProcessDef.id)
+        .join(
+            latest_per_biz,
+            and_(
+                WfProcessInstance.business_id == latest_per_biz.c.business_id,
+                WfProcessInstance.create_time == latest_per_biz.c.max_ct,
+            ),
+        )
+        .filter(
+            and_(
+                WfProcessInstance.starter_user_id == user_id,
+                WfProcessInstance.del_flag == 0,
+                WfProcessVersion.del_flag == 0,
+                WfProcessDef.del_flag == 0,
+            )
+        )
+    )
+    if tenant_no:
+        q0 = q0.filter(WfProcessInstance.tenant_no == tenant_no)
+    if status:
+        q0 = q0.filter(WfProcessInstance.status == status)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q0 = q0.filter(
+            or_(WfProcessDef.process_name.like(like), WfProcessInstance.business_id.like(like))
+        )
+
+    total = q0.order_by(None).with_entities(func.count(WfProcessInstance.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q0.order_by(WfProcessInstance.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for inst, ver, defn in rows:
+        result.append({
+            "id": inst.id,
+            "processName": defn.process_name,
+            "businessType": inst.business_type,
+            "businessId": inst.business_id,
+            "starterUserId": inst.starter_user_id,
+            "status": inst.status,
+            "createTime": inst.create_time.strftime("%Y-%m-%d %H:%M:%S") if inst.create_time else "",
+            "updateTime": inst.update_time.strftime("%Y-%m-%d %H:%M:%S") if inst.update_time else "",
+        })
+    return result, int(total)
+
+
+def get_all_tasks_for_business(
+    db: Session,
+    business_type: str,
+    business_id: str,
+) -> List[Dict[str, Any]]:
+    instances = (
+        db.query(WfProcessInstance)
+        .filter(
+            and_(
+                WfProcessInstance.business_type == business_type,
+                WfProcessInstance.business_id == business_id,
+                WfProcessInstance.del_flag == 0,
+            )
+        )
+        .order_by(WfProcessInstance.create_time.asc())
+        .all()
+    )
+
+    all_tasks: List[Dict[str, Any]] = []
+    for inst in instances:
+        node_name_map: Dict[str, str] = {}
+        if inst.process_version_id:
+            for n in get_nodes_by_version(db, inst.process_version_id):
+                node_name_map[n.node_key] = n.node_name or n.node_key
+
+        tasks = (
+            db.query(WfTask)
+            .filter(and_(WfTask.instance_id == inst.id, WfTask.del_flag == 0))
+            .order_by(WfTask.create_time.asc())
+            .all()
+        )
+
+        user_ids = {t.assignee_user_id for t in tasks if t.assignee_user_id}
+        user_name_map: Dict[str, str] = {}
+        if user_ids:
+            rows = db.query(SysUser.id, SysUser.nick_name).filter(SysUser.id.in_(user_ids)).all()
+            user_name_map = {r.id: r.nick_name for r in rows}
+
+        for t in tasks:
+            all_tasks.append({
+                "id": t.id,
+                "instanceId": inst.id,
+                "instanceStatus": inst.status,
+                "nodeKey": t.node_key,
+                "nodeName": node_name_map.get(t.node_key, t.node_key or ""),
+                "assigneeUserId": t.assignee_user_id,
+                "assigneeUserName": user_name_map.get(t.assignee_user_id, t.assignee_user_id or ""),
+                "status": t.status,
+                "commentText": t.comment_text,
+                "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+                "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+            })
+
+    return all_tasks
+
+
+# ---------------------------------------------------------------------------
+# 流程任务 wf_task
+# ---------------------------------------------------------------------------
+
+
+def create_task(
+    db: Session,
+    *,
+    instance_id: str,
+    node_key: Optional[str] = None,
+    assignee_user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfTask:
+    obj = WfTask(
+        id=generate_uuid(),
+        instance_id=instance_id,
+        node_key=node_key,
+        assignee_user_id=assignee_user_id,
+        status="pending",
+        tenant_no=tenant_no or "zkxw",
+        order_num=0,
+        remark=None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def get_task(db: Session, task_id: str) -> Optional[WfTask]:
+    return (
+        db.query(WfTask)
+        .filter(and_(WfTask.id == task_id, WfTask.del_flag == 0))
+        .first()
+    )
+
+
+def get_pending_tasks_by_node(db: Session, instance_id: str, node_key: str) -> List[WfTask]:
+    return (
+        db.query(WfTask)
+        .filter(
+            and_(
+                WfTask.instance_id == instance_id,
+                WfTask.node_key == node_key,
+                WfTask.status == "pending",
+                WfTask.del_flag == 0,
+            )
+        )
+        .all()
+    )
+
+
+def _task_row_to_dict(
+    t: WfTask,
+    process_name: Optional[str] = None,
+    business_type: Optional[str] = None,
+    business_id: Optional[str] = None,
+    starter_user_id: Optional[str] = None,
+    instance_status: Optional[str] = None,
+    instance_create_time: Optional[str] = None,
+) -> Dict[str, Any]:
+    return {
+        "id": t.id,
+        "instanceId": t.instance_id,
+        "nodeKey": t.node_key,
+        "assigneeUserId": t.assignee_user_id,
+        "status": t.status,
+        "commentText": t.comment_text,
+        "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+        "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+        "processName": process_name,
+        "businessType": business_type,
+        "businessId": business_id,
+        "starterUserId": starter_user_id,
+        "instanceStatus": instance_status,
+        "instanceCreateTime": instance_create_time,
+    }
+
+
+def list_pending_tasks(
+    db: Session,
+    user_id: str,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    q0 = (
+        db.query(WfTask, WfProcessInstance, WfProcessVersion, WfProcessDef)
+        .join(WfProcessInstance, WfTask.instance_id == WfProcessInstance.id)
+        .join(WfProcessVersion, WfProcessInstance.process_version_id == WfProcessVersion.id)
+        .join(WfProcessDef, WfProcessVersion.process_def_id == WfProcessDef.id)
+        .filter(
+            and_(
+                WfTask.assignee_user_id == user_id,
+                WfTask.status == "pending",
+                WfTask.del_flag == 0,
+                WfProcessInstance.del_flag == 0,
+                WfProcessVersion.del_flag == 0,
+                WfProcessDef.del_flag == 0,
+            )
+        )
+    )
+    if tenant_no:
+        q0 = q0.filter(WfTask.tenant_no == tenant_no)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q0 = q0.filter(
+            or_(WfProcessDef.process_name.like(like), WfProcessDef.process_code.like(like))
+        )
+
+    total = q0.order_by(None).with_entities(func.count(WfTask.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q0.order_by(WfTask.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for task, inst, ver, defn in rows:
+        result.append(
+            _task_row_to_dict(
+                task,
+                process_name=defn.process_name,
+                business_type=inst.business_type,
+                business_id=inst.business_id,
+                starter_user_id=inst.starter_user_id,
+                instance_status=inst.status,
+                instance_create_time=inst.create_time.strftime("%Y-%m-%d %H:%M:%S") if inst.create_time else "",
+            )
+        )
+    return result, int(total)
+
+
+def list_completed_tasks(
+    db: Session,
+    user_id: str,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    q0 = (
+        db.query(WfTask, WfProcessInstance, WfProcessVersion, WfProcessDef)
+        .join(WfProcessInstance, WfTask.instance_id == WfProcessInstance.id)
+        .join(WfProcessVersion, WfProcessInstance.process_version_id == WfProcessVersion.id)
+        .join(WfProcessDef, WfProcessVersion.process_def_id == WfProcessDef.id)
+        .filter(
+            and_(
+                WfTask.assignee_user_id == user_id,
+                WfTask.status.in_(["approved", "rejected"]),
+                WfTask.del_flag == 0,
+                WfProcessInstance.del_flag == 0,
+                WfProcessVersion.del_flag == 0,
+                WfProcessDef.del_flag == 0,
+            )
+        )
+    )
+    if tenant_no:
+        q0 = q0.filter(WfTask.tenant_no == tenant_no)
+    kw = (keyword or "").strip()
+    if kw:
+        like = f"%{kw}%"
+        q0 = q0.filter(
+            or_(WfProcessDef.process_name.like(like), WfProcessDef.process_code.like(like))
+        )
+
+    total = q0.order_by(None).with_entities(func.count(WfTask.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q0.order_by(WfTask.update_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for task, inst, ver, defn in rows:
+        result.append(
+            _task_row_to_dict(
+                task,
+                process_name=defn.process_name,
+                business_type=inst.business_type,
+                business_id=inst.business_id,
+                starter_user_id=inst.starter_user_id,
+                instance_status=inst.status,
+                instance_create_time=inst.create_time.strftime("%Y-%m-%d %H:%M:%S") if inst.create_time else "",
+            )
+        )
+    return result, int(total)
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
diff --git a/backend/app/main.py b/backend/app/main.py
index cec49f25..895c43ce 100644
--- a/backend/app/main.py
+++ b/backend/app/main.py
@@ -10,7 +10,7 @@ from app.core.database import SessionLocal
 from app.core.api_request_log_middleware import ApiRequestLogMiddleware
 from app.core.api_crypto_middleware import ApiCryptoMiddleware
 from app.models import models  # noqa: F401
-from app.api import public_router, menu_router, admin_router
+from app.api import public_router, menu_router, admin_router, workflow_router, basic_info_router, collection_protocol_router, leave_router, operations_router, ethnic_router
 
 
 @asynccontextmanager
@@ -61,6 +61,12 @@ app.add_middleware(ApiCryptoMiddleware)
 app.include_router(public_router, prefix=settings.API_V1_PREFIX)
 app.include_router(menu_router, prefix=settings.API_V1_PREFIX)
 app.include_router(admin_router, prefix=settings.API_V1_PREFIX)
+app.include_router(workflow_router, prefix=settings.API_V1_PREFIX)
+app.include_router(basic_info_router, prefix=settings.API_V1_PREFIX)
+app.include_router(collection_protocol_router, prefix=settings.API_V1_PREFIX)
+app.include_router(leave_router, prefix=settings.API_V1_PREFIX)
+app.include_router(operations_router, prefix=settings.API_V1_PREFIX)
+app.include_router(ethnic_router, prefix=settings.API_V1_PREFIX)
 
 logger = logging.getLogger("sqxp")
 
diff --git a/backend/app/models/models.py b/backend/app/models/models.py
index 79e974dc..a1cc113d 100644
--- a/backend/app/models/models.py
+++ b/backend/app/models/models.py
@@ -1,8 +1,8 @@
-"""数据模型（与 docs/sql/zkxw-requirements-v0.3-schema.sql 对齐的核心系统表）"""
+"""数据模型（与 docs/sql/zkxw.sql 全库导出基线对齐的核心系统表）"""
 from datetime import datetime
 import enum
 
-from sqlalchemy import Column, String, DateTime, Integer, Text, CHAR, SmallInteger
+from sqlalchemy import Column, String, DateTime, Integer, Text, CHAR, SmallInteger, Numeric
 
 from app.core.database import Base
 
@@ -294,6 +294,132 @@ class BizExpressCompany(Base):
     del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
 
 
+class BizCustomer(Base):
+    """客户 biz_customer"""
+
+    __tablename__ = "biz_customer"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    customer_name = Column(String(100), nullable=False, comment="客户姓名")
+    sex = Column(CHAR(1), nullable=True, default="2", comment="性别（0男1女2未知）")
+    id_card_no = Column(String(32), nullable=True, comment="身份证号")
+    age = Column(Integer, nullable=True, comment="年龄")
+    phone_no = Column(String(32), nullable=True, comment="联系电话")
+    customer_tags = Column(String(512), nullable=True, comment="客户标签，逗号分隔")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCellSampleType(Base):
+    """细胞样本类型 biz_cell_sample_type"""
+
+    __tablename__ = "biz_cell_sample_type"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    type_code = Column(String(64), nullable=False, comment="样本类型编码")
+    type_name = Column(String(200), nullable=False, comment="样本类型名称")
+    storage_years = Column(Integer, nullable=True, comment="样本存储年份")
+    storage_price = Column(Numeric(18, 2), nullable=True, comment="样本存储价格（元）")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCollectionRegion(Base):
+    """采集地区 biz_collection_region"""
+
+    __tablename__ = "biz_collection_region"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    region_name = Column(String(200), nullable=False, comment="地区名称")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCollectionHospital(Base):
+    """采集地区下属医院 biz_collection_hospital"""
+
+    __tablename__ = "biz_collection_hospital"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    region_id = Column(String(64), nullable=False, comment="采集地区ID")
+    hospital_name = Column(String(200), nullable=False, comment="医院名称")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCollectionProtocolNo(Base):
+    """采集协议号池 biz_collection_protocol_no"""
+
+    __tablename__ = "biz_collection_protocol_no"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    protocol_no = Column(String(32), nullable=False, comment="采集协议号")
+    issued = Column(SmallInteger, nullable=False, default=0, comment="是否下发（1是0否）")
+    issued_user_id = Column(String(64), nullable=True, comment="下发用户ID")
+    issued_user_name = Column(String(100), nullable=True, comment="下发用户姓名（冗余）")
+    issued_time = Column(DateTime, nullable=True, comment="下发时间")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizSampleCode(Base):
+    """样本编码池 biz_sample_code"""
+
+    __tablename__ = "biz_sample_code"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    sample_code = Column(String(32), nullable=False, comment="样本编码")
+    sample_code_type = Column(String(16), nullable=True, comment="样本编码类型 zxbm造血编码 qdbm脐带编码")
+    issued = Column(SmallInteger, nullable=False, default=0, comment="是否下发（1是0否）")
+    issued_user_id = Column(String(64), nullable=True, comment="下发用户ID")
+    issued_user_name = Column(String(100), nullable=True, comment="下发用户姓名（冗余）")
+    issued_time = Column(DateTime, nullable=True, comment="下发时间")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
 # =============================================================================
 # 字典管理（sys_dict_type / sys_dict_data）
 # =============================================================================
@@ -318,6 +444,25 @@ class SysDictType(Base):
     del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
 
 
+class SysEthnic(Base):
+    """民族码表 sys_ethnic（国标 GB/T 3304，全局）"""
+
+    __tablename__ = "sys_ethnic"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    ethnic_name = Column(String(64), nullable=False, default="", comment="民族名称")
+    ethnic_code = Column(String(16), nullable=False, default="", comment="民族编码")
+    tenant_no = Column(String(64), nullable=False, default="", comment="租户编号（空=全局）")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
 class SysDictData(Base):
     """字典数据 sys_dict_data"""
 
@@ -393,3 +538,555 @@ class SysApiRequestLogHis(Base):
     update_at = Column(DateTime, nullable=True, comment="修改时间")
     update_by = Column(String(32), nullable=True, comment="修改人ID")
     his_create_at = Column(DateTime, default=datetime.now, comment="历史记录创建时间")
+
+
+# =============================================================================
+# 业务表（biz_leave_request）
+# =============================================================================
+
+
+class BizLeaveRequest(Base):
+    """请假申请 biz_leave_request"""
+
+    __tablename__ = "biz_leave_request"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    leave_type = Column(String(32), nullable=False, default="personal", comment="请假类型: personal/sick/annual/other")
+    start_date = Column(String(20), nullable=False, comment="开始日期")
+    end_date = Column(String(20), nullable=False, comment="结束日期")
+    days = Column(Integer, nullable=False, default=1, comment="请假天数")
+    reason = Column(String(500), nullable=True, comment="请假原因")
+    wf_instance_id = Column(String(64), nullable=True, comment="流程实例ID")
+    status = Column(String(32), nullable=False, default="draft", comment="状态: draft/pending/approved/rejected/cancelled")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+# =============================================================================
+# 工作流（wf_process_def / wf_process_version / wf_node / wf_transition / wf_process_instance / wf_task）
+# =============================================================================
+
+
+class WfProcessDef(Base):
+    """流程定义 wf_process_def"""
+
+    __tablename__ = "wf_process_def"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_code = Column(String(64), nullable=False, comment="流程编码")
+    process_name = Column(String(200), nullable=False, comment="流程名称")
+    status = Column(CHAR(1), nullable=False, default="1", comment="1启用 0停用")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+class WfProcessVersion(Base):
+    """流程定义版本 wf_process_version"""
+
+    __tablename__ = "wf_process_version"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_def_id = Column(String(64), nullable=False, comment="流程定义ID")
+    version_no = Column(Integer, nullable=False, comment="版本号，递增")
+    graph_json = Column(Text, nullable=True, comment="节点与连线等配置（JSON 字符串）")
+    is_latest = Column(CHAR(1), nullable=True, default="0", comment="是否最新版本（1是 0否）")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+class WfNode(Base):
+    """流程节点 wf_node"""
+
+    __tablename__ = "wf_node"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="流程版本ID")
+    node_key = Column(String(64), nullable=False, comment="节点唯一键（画布内）")
+    node_type = Column(String(32), nullable=False, comment="start/end/approval/condition 等")
+    node_name = Column(String(200), nullable=True, comment="节点名称")
+    config_json = Column(Text, nullable=True, comment="审批人/SQL/会签策略等配置")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+class WfTransition(Base):
+    """流程连线/转移 wf_transition"""
+
+    __tablename__ = "wf_transition"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="流程版本ID")
+    from_node_key = Column(String(64), nullable=False, comment="起始节点key")
+    to_node_key = Column(String(64), nullable=False, comment="目标节点key")
+    condition_expr = Column(String(512), nullable=True, comment="条件表达式或分支说明")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+class WfProcessInstance(Base):
+    """流程实例 wf_process_instance"""
+
+    __tablename__ = "wf_process_instance"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="发起时锁定的流程版本ID")
+    business_type = Column(String(64), nullable=True, comment="业务类型")
+    business_id = Column(String(64), nullable=True, comment="业务主键")
+    starter_user_id = Column(String(64), nullable=True, comment="发起人")
+    variables_json = Column(Text, nullable=True, comment="流程变量 JSON")
+    status = Column(String(32), nullable=True, comment="running/completed/rejected 等")
+    callback_url = Column(String(512), nullable=True, comment="业务回调地址")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+class WfTask(Base):
+    """流程任务/待办 wf_task"""
+
+    __tablename__ = "wf_task"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    instance_id = Column(String(64), nullable=False, comment="流程实例ID")
+    node_key = Column(String(64), nullable=True, comment="当前节点key")
+    assignee_user_id = Column(String(64), nullable=True, comment="待办人")
+    status = Column(String(32), nullable=True, comment="pending/approved/rejected 等")
+    comment_text = Column(String(512), nullable=True, comment="审批意见")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记：0-正常 1-已删除")
+
+
+# =============================================================================
+# 细胞存储 — 采集协议单（biz_collection_protocol / audit / payment）
+# =============================================================================
+
+
+class BizCollectionProtocol(Base):
+    """采集协议单 biz_collection_protocol"""
+
+    __tablename__ = "biz_collection_protocol"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    protocol_no_id = Column(String(64), nullable=True, comment="采集协议号表ID")
+    protocol_no = Column(String(32), nullable=False, comment="采集协议号展示")
+    protocol_status = Column(String(16), nullable=False, default="dsx", comment="协议状态")
+    protocol_attachments = Column(String(4000), nullable=True, comment="协议附件")
+    register_date = Column(CHAR(8), nullable=True, comment="登记日期YYYYMMDD")
+    effective_time = Column(DateTime, nullable=True, comment="协议生效时间")
+    effective_desc = Column(String(512), nullable=True, comment="协议生效描述")
+    expire_time = Column(DateTime, nullable=True, comment="协议过期时间")
+    expire_desc = Column(String(512), nullable=True, comment="协议过期描述")
+    void_time = Column(DateTime, nullable=True, comment="协议作废时间")
+    void_desc = Column(String(512), nullable=True, comment="协议作废描述")
+    to_research_time = Column(DateTime, nullable=True, comment="协议转科研时间")
+    to_research_desc = Column(String(512), nullable=True, comment="协议转科研描述")
+    collector_user_id = Column(String(64), nullable=True, comment="采集专员用户ID")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注信息")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolAudit(Base):
+    """采集协议单-审核记录 biz_protocol_audit"""
+
+    __tablename__ = "biz_protocol_audit"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    auditor_user_id = Column(String(64), nullable=True, comment="审核人")
+    audit_remark = Column(String(1000), nullable=True, comment="审核备注")
+    audit_status = Column(String(16), nullable=False, comment="审核状态 shtg/shth")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolPayment(Base):
+    """采集协议单-缴费主表 biz_protocol_payment"""
+
+    __tablename__ = "biz_protocol_payment"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    pay_mode = Column(String(8), nullable=False, comment="dj趸交 fq分期")
+    contract_amount = Column(Numeric(18, 2), nullable=True, comment="合同金额")
+    installment_count = Column(Integer, nullable=True, comment="分期期数")
+    installment_interval_months = Column(Integer, nullable=True, comment="每期间隔（月）")
+    lump_sum_deadline = Column(CHAR(8), nullable=True, comment="趸交截止时间YYYYMMDD")
+    installment_start_date = Column(CHAR(8), nullable=True, comment="分期开始YYYYMMDD")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolPaymentDetail(Base):
+    """采集协议单-缴费明细 biz_protocol_payment_detail"""
+
+    __tablename__ = "biz_protocol_payment_detail"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    payment_id = Column(String(64), nullable=False, comment="缴费主表ID")
+    transfer_type = Column(String(16), nullable=True, comment="转账方式")
+    due_amount = Column(Numeric(18, 2), nullable=True, comment="应缴费金额")
+    transfer_amount = Column(Numeric(18, 2), nullable=True, comment="转账金额")
+    transfer_time = Column(DateTime, nullable=True, comment="转账时间")
+    transfer_attachments = Column(String(4000), nullable=True, comment="转账附件")
+    finance_confirm_attachments = Column(String(4000), nullable=True, comment="财务确认附件")
+    pay_status = Column(String(32), nullable=False, default="dfj", comment="缴费状态")
+    installment_no = Column(Integer, nullable=True, comment="分期期序号")
+    installment_due_date = Column(CHAR(8), nullable=True, comment="分期应缴日期YYYYMMDD")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolPartyCustomer(Base):
+    """采集协议单-当事人客户信息 biz_protocol_party_customer"""
+
+    __tablename__ = "biz_protocol_party_customer"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    customer_id = Column(String(64), nullable=True, comment="客户ID")
+    mother_name = Column(String(100), nullable=True, comment="母亲姓名")
+    mother_phone = Column(String(32), nullable=True, comment="母亲电话")
+    mother_id_card = Column(String(32), nullable=True, comment="母亲身份证号")
+    mother_birth_ym = Column(CHAR(6), nullable=True, comment="母亲出生年月YYYYMM")
+    mother_ethnic = Column(String(32), nullable=True, comment="母亲民族")
+    mother_address = Column(String(512), nullable=True, comment="母亲地址")
+    father_name = Column(String(100), nullable=True, comment="父亲姓名")
+    father_phone = Column(String(32), nullable=True, comment="父亲电话")
+    father_id_card = Column(String(32), nullable=True, comment="父亲身份证号")
+    newborn_name = Column(String(100), nullable=True, comment="新生儿姓名")
+    newborn_id_card = Column(String(32), nullable=True, comment="新生儿身份证号")
+    newborn_delivery_time = Column(DateTime, nullable=True, comment="新生儿分娩时间")
+    newborn_sex = Column(CHAR(1), nullable=True, comment="新生儿性别")
+    delivery_mode = Column(String(16), nullable=True, comment="分娩方式")
+    birth_order = Column(Integer, nullable=True, comment="出生顺序")
+    newborn_weight_gram = Column(Integer, nullable=True, comment="新生儿体重(克)")
+    apgar_1min = Column(Numeric(4, 1), nullable=True, comment="Apgar 1分钟评分")
+    apgar_5min = Column(Numeric(4, 1), nullable=True, comment="Apgar 5分钟评分")
+    collector_user_id = Column(String(64), nullable=True, comment="采集专员用户ID")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolCollectionInfo(Base):
+    """采集协议单-采集信息 biz_protocol_collection_info"""
+
+    __tablename__ = "biz_protocol_collection_info"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    region_id = Column(String(64), nullable=True, comment="区域ID")
+    hospital_id = Column(String(64), nullable=True, comment="医院ID")
+    medical_staff = Column(String(200), nullable=True, comment="医护人员")
+    sales_user_id = Column(String(64), nullable=True, comment="销售人员用户ID")
+    sample_collect_time = Column(DateTime, nullable=True, comment="样本采集时间")
+    maternal_blood_collect_time = Column(DateTime, nullable=True, comment="母血采集时间")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolSample(Base):
+    """采集协议单-样本信息 biz_protocol_sample"""
+
+    __tablename__ = "biz_protocol_sample"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    sample_type_id = Column(String(64), nullable=True, comment="样本类型ID")
+    sample_code_id = Column(String(64), nullable=True, comment="样本编码ID")
+    sample_code = Column(String(32), nullable=True, comment="样本编码")
+    collect_amount = Column(Numeric(18, 4), nullable=True, comment="采集量")
+    unit_id = Column(String(64), nullable=True, comment="单位ID")
+    price = Column(Numeric(18, 2), nullable=True, comment="价格")
+    storage_years = Column(Integer, nullable=True, comment="存储年限")
+    sample_status = Column(String(16), nullable=True, comment="样本状态")
+    storage_in_date = Column(CHAR(8), nullable=True, comment="入库日期YYYYMMDD")
+    detect_start_date = Column(CHAR(8), nullable=True, comment="检测开始日期YYYYMMDD")
+    void_date = Column(CHAR(8), nullable=True, comment="作废日期YYYYMMDD")
+    storage_expire_date = Column(CHAR(8), nullable=True, comment="存储到期日期YYYYMMDD")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolSampleTransport(Base):
+    """采集协议单-样本运输 biz_protocol_sample_transport"""
+
+    __tablename__ = "biz_protocol_sample_transport"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    sample_id = Column(String(64), nullable=False, comment="样本ID")
+    transport_type = Column(String(16), nullable=False, comment="kdys快递运输 ryxd人员携带")
+    express_company_id = Column(String(64), nullable=True, comment="快递公司ID")
+    waybill_no = Column(String(128), nullable=True, comment="快递单号")
+    dest_site_id = Column(String(64), nullable=True, comment="目的站点ID")
+    express_fee = Column(Numeric(18, 2), nullable=True, comment="快递费用（元）")
+    eta_time = Column(DateTime, nullable=True, comment="预计到达时间")
+    carrier_name = Column(String(100), nullable=True, comment="携带人员姓名")
+    carrier_phone = Column(String(32), nullable=True, comment="携带人员联系电话")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizAttachment(Base):
+    """业务附件 biz_attachment"""
+
+    __tablename__ = "biz_attachment"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    business_type = Column(String(50), nullable=True, comment="业务类型")
+    business_id = Column(String(64), nullable=True, comment="业务主键ID")
+    original_name = Column(String(200), nullable=False, comment="原始文件名")
+    file_ext = Column(String(20), nullable=True, comment="文件后缀名")
+    file_url = Column(String(500), nullable=False, comment="MinIO路径后缀")
+    file_size = Column(Integer, nullable=True, comment="文件大小（字节）")
+    file_type = Column(String(50), nullable=True, comment="MIME类型")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizProtocolStorageCert(Base):
+    """采集协议单-储存证书 biz_protocol_storage_cert"""
+
+    __tablename__ = "biz_protocol_storage_cert"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    collection_protocol_id = Column(String(64), nullable=False, comment="采集协议单ID")
+    make_status = Column(CHAR(1), nullable=True, default="0", comment="制作状态 0-未制作 1-已制作")
+    cert_image_urls = Column(String(4000), nullable=True, comment="证书图片URLs")
+    make_date = Column(CHAR(8), nullable=True, comment="制作日期YYYYMMDD")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+# =============================================================================
+# V0.4 运营支撑（2.4 洁净室管理 / 库位管理 / 展馆预约）
+# =============================================================================
+
+
+class BizCleanRoom(Base):
+    """洁净室 biz_clean_room"""
+
+    __tablename__ = "biz_clean_room"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    room_code = Column(String(64), nullable=False, comment="编号")
+    room_name = Column(String(200), nullable=False, comment="名称")
+    room_grade = Column(String(8), nullable=True, comment="等级 A/B/C/D")
+    room_status = Column(String(16), nullable=False, default="zc", comment="zc正常 yc异常")
+    area_sqm = Column(Numeric(12, 2), nullable=True, comment="面积m²")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCleanRoomAccessLog(Base):
+    """洁净室出入记录 biz_clean_room_access_log"""
+
+    __tablename__ = "biz_clean_room_access_log"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    clean_room_id = Column(String(64), nullable=False, comment="洁净室ID")
+    user_id = Column(String(64), nullable=True, comment="人员用户ID")
+    person_name = Column(String(100), nullable=True, comment="人员姓名（冗余）")
+    dept_name = Column(String(200), nullable=True, comment="部门")
+    enter_time = Column(DateTime, nullable=False, comment="进入时间")
+    purpose = Column(String(512), nullable=True, comment="目的")
+    leave_time = Column(DateTime, nullable=True, comment="离开时间")
+    body_temp = Column(String(32), nullable=True, comment="体温")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizStorageFacility(Base):
+    """存储设施树 biz_storage_facility"""
+
+    __tablename__ = "biz_storage_facility"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    parent_id = Column(String(64), nullable=False, default="0", comment="父节点ID，0根")
+    node_name = Column(String(200), nullable=False, comment="节点名称（罐/层/盒等）")
+    node_type = Column(String(32), nullable=True, comment="facility/layer/box 等扩展")
+    is_leaf = Column(SmallInteger, nullable=False, default=0, comment="是否叶子存储位 1是")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizStorageFacilitySlot(Base):
+    """存储设施小格 biz_storage_facility_slot"""
+
+    __tablename__ = "biz_storage_facility_slot"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    facility_node_id = Column(String(64), nullable=False, comment="设施树叶子节点ID")
+    slot_code = Column(String(64), nullable=True, comment="小格编码/坐标")
+    slot_status = Column(String(16), nullable=True, comment="占用状态等扩展")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizExhibitionAppointment(Base):
+    """展馆预约 biz_exhibition_appointment"""
+
+    __tablename__ = "biz_exhibition_appointment"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    appointment_no = Column(String(64), nullable=False, comment="预约编号")
+    visit_org = Column(String(200), nullable=True, comment="来访单位")
+    contact_name = Column(String(100), nullable=True, comment="联系人")
+    visit_date = Column(DateTime, nullable=True, comment="到访日期")
+    visitor_count = Column(Integer, nullable=True, comment="人数")
+    reception_user_id = Column(String(64), nullable=True, comment="接待人员用户ID")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
diff --git a/backend/app/schemas/attachment.py b/backend/app/schemas/attachment.py
new file mode 100644
index 00000000..86ae7c38
--- /dev/null
+++ b/backend/app/schemas/attachment.py
@@ -0,0 +1,13 @@
+from pydantic import BaseModel, ConfigDict
+from typing import Optional
+
+
+class AttachmentUploadResponse(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: str
+    fileName: str
+    fileUrl: str
+    fileSize: Optional[int] = None
+    fileSizeDisplay: Optional[str] = None
+    fileType: Optional[str] = None
diff --git a/backend/app/schemas/leave.py b/backend/app/schemas/leave.py
new file mode 100644
index 00000000..9243366b
--- /dev/null
+++ b/backend/app/schemas/leave.py
@@ -0,0 +1,40 @@
+"""Pydantic schemas - 请假申请"""
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class LeaveCreate(BaseModel):
+    leaveType: str = Field(..., description="请假类型: personal/sick/annual/other")
+    startDate: str = Field(..., description="开始日期")
+    endDate: str = Field(..., description="结束日期")
+    days: int = Field(..., description="请假天数")
+    reason: Optional[str] = Field(None, description="请假原因")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class LeaveUpdate(BaseModel):
+    leaveType: Optional[str] = Field(None, description="请假类型")
+    startDate: Optional[str] = Field(None, description="开始日期")
+    endDate: Optional[str] = Field(None, description="结束日期")
+    days: Optional[int] = Field(None, description="请假天数")
+    reason: Optional[str] = Field(None, description="请假原因")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class LeaveResponse(BaseModel):
+    id: str
+    leaveType: Optional[str] = None
+    startDate: Optional[str] = None
+    endDate: Optional[str] = None
+    days: Optional[int] = None
+    reason: Optional[str] = None
+    wfInstanceId: Optional[str] = None
+    status: Optional[str] = None
+    createBy: Optional[str] = None
+    createTime: Optional[str] = None
+    updateBy: Optional[str] = None
+    updateTime: Optional[str] = None
+
+    class Config:
+        from_attributes = True
diff --git a/backend/app/schemas/workflow.py b/backend/app/schemas/workflow.py
new file mode 100644
index 00000000..f41a7f6c
--- /dev/null
+++ b/backend/app/schemas/workflow.py
@@ -0,0 +1,115 @@
+"""Pydantic schemas - 工作流"""
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class ProcessDefCreate(BaseModel):
+    processCode: str = Field(..., description="流程编码")
+    processName: str = Field(..., description="流程名称")
+    status: Optional[str] = Field("1", description="1启用 0停用")
+    orderNum: Optional[int] = Field(None, description="排序号")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class ProcessDefUpdate(BaseModel):
+    processCode: Optional[str] = Field(None, description="流程编码")
+    processName: Optional[str] = Field(None, description="流程名称")
+    status: Optional[str] = Field(None, description="1启用 0停用")
+    orderNum: Optional[int] = Field(None, description="排序号")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class ProcessDefResponse(BaseModel):
+    id: str
+    processCode: str
+    processName: str
+    status: str
+    latestVersion: Optional[int] = None
+    tenantNo: Optional[str] = None
+    orderNum: Optional[int] = None
+    remark: Optional[str] = None
+    createTime: Optional[str] = None
+    updateTime: Optional[str] = None
+
+    class Config:
+        from_attributes = True
+
+
+class NodeData(BaseModel):
+    nodeKey: str = Field(..., description="节点唯一键")
+    nodeType: str = Field(..., description="start/end/approval/condition 等")
+    nodeName: Optional[str] = Field(None, description="节点名称")
+    configJson: Optional[str] = Field(None, description="审批人/SQL/会签策略等配置")
+
+
+class TransitionData(BaseModel):
+    fromNodeKey: str = Field(..., description="起始节点key")
+    toNodeKey: str = Field(..., description="目标节点key")
+    conditionExpr: Optional[str] = Field(None, description="条件表达式或分支说明")
+
+
+class PublishVersionRequest(BaseModel):
+    graphJson: str = Field(..., description="节点与连线等配置JSON")
+    nodes: List[NodeData] = Field(..., description="节点列表")
+    transitions: List[TransitionData] = Field(default_factory=list, description="连线列表")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class VersionResponse(BaseModel):
+    id: str
+    versionNo: int
+    isLatest: Optional[str] = None
+    remark: Optional[str] = None
+    createTime: Optional[str] = None
+    updateTime: Optional[str] = None
+
+    class Config:
+        from_attributes = True
+
+
+class StartInstanceRequest(BaseModel):
+    processCode: str = Field(..., description="流程编码")
+    businessType: Optional[str] = Field(None, description="业务类型")
+    businessId: Optional[str] = Field(None, description="业务主键")
+    variables: Optional[Dict[str, Any]] = Field(default_factory=dict, description="流程变量")
+    callbackUrl: Optional[str] = Field(None, description="业务回调地址")
+
+
+class ApproveRequest(BaseModel):
+    commentText: Optional[str] = Field(None, description="审批意见")
+
+
+class TaskResponse(BaseModel):
+    id: str
+    instanceId: str
+    nodeKey: Optional[str] = None
+    assigneeUserId: Optional[str] = None
+    status: Optional[str] = None
+    commentText: Optional[str] = None
+    createTime: Optional[str] = None
+    updateTime: Optional[str] = None
+    processName: Optional[str] = None
+    businessType: Optional[str] = None
+    businessId: Optional[str] = None
+    starterUserId: Optional[str] = None
+    instanceStatus: Optional[str] = None
+    instanceCreateTime: Optional[str] = None
+
+    class Config:
+        from_attributes = True
+
+
+class InstanceResponse(BaseModel):
+    id: str
+    processVersionId: str
+    businessType: Optional[str] = None
+    businessId: Optional[str] = None
+    starterUserId: Optional[str] = None
+    status: Optional[str] = None
+    createTime: Optional[str] = None
+    updateTime: Optional[str] = None
+    tasks: List[Dict[str, Any]] = Field(default_factory=list)
+
+    class Config:
+        from_attributes = True
diff --git a/backend/app/services/web_auth_roles.py b/backend/app/services/web_auth_roles.py
index 71225f84..d358c511 100644
--- a/backend/app/services/web_auth_roles.py
+++ b/backend/app/services/web_auth_roles.py
@@ -38,7 +38,7 @@ def resolve_web_role_for_user(db: Session, user_id: str) -> str:
             SysRole.status == "1",
             SysRole.tenant_no == tenant,
         )
-        .order_by(SysRole.order_num.asc())
+        .order_by(SysRole.create_time.desc())
         .all()
     )
     names = [str(r[0]).strip() for r in rows if r and r[0]]
diff --git a/backend/app/services/workflow_callback.py b/backend/app/services/workflow_callback.py
new file mode 100644
index 00000000..31ba8906
--- /dev/null
+++ b/backend/app/services/workflow_callback.py
@@ -0,0 +1,106 @@
+"""工作流回调服务 —— 流程状态变更时通知业务系统"""
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Callable, Dict, Optional
+
+import requests
+
+if TYPE_CHECKING:
+    from app.models.models import WfProcessInstance
+
+logger = logging.getLogger("sqxp.workflow_callback")
+
+# ---------------------------------------------------------------------------
+# 本地回调注册表：内部路径（以 / 开头）直接在进程内调用，不走 HTTP
+# ---------------------------------------------------------------------------
+
+_LocalCallbackFn = Callable[[Any, str, str], None]  # (db, business_id, event) -> None
+
+_LOCAL_CALLBACKS: Dict[str, _LocalCallbackFn] = {}
+
+
+def register_local_callback(path: str, fn: _LocalCallbackFn) -> None:
+    """注册本地回调函数。当 callback_url 以 path 开头时直接调用 fn。"""
+    _LOCAL_CALLBACKS[path] = fn
+
+
+def _dispatch_local(db: Any, instance: WfProcessInstance, event: str) -> bool:
+    """尝试本地直调。返回 True 表示已处理，False 表示无匹配的本地回调。"""
+    url = instance.callback_url or ""
+    if not url.startswith("/"):
+        return False
+    for prefix, fn in _LOCAL_CALLBACKS.items():
+        if url.startswith(prefix):
+            try:
+                fn(db, instance.business_id or "", event)
+                logger.info(
+                    "工作流本地回调成功: event=%s instance=%s path=%s",
+                    event,
+                    instance.id,
+                    url,
+                )
+                return True
+            except Exception:
+                logger.exception(
+                    "工作流本地回调失败: event=%s instance=%s path=%s",
+                    event,
+                    instance.id,
+                    url,
+                )
+                return True  # 已匹配但执行失败，不再走 HTTP
+    return False
+
+
+# ---------------------------------------------------------------------------
+# trigger_callback（对外入口）
+# ---------------------------------------------------------------------------
+
+
+def trigger_callback(db: Any, instance: WfProcessInstance, event: str) -> None:
+    """流程实例状态变更后，向业务系统发送回调通知。
+
+    优先级：
+    1. 如果 callback_url 是内部路径（以 / 开头），优先尝试本地直调
+    2. 本地无匹配时，回退到 HTTP 回调（需完整 URL）
+
+    Args:
+        db: 数据库会话。
+        instance: 流程实例 ORM 对象。
+        event: 事件类型，如 approved / rejected / completed。
+    """
+    if not instance.callback_url:
+        return
+
+    # 尝试本地直调
+    if _dispatch_local(db, instance, event):
+        return
+
+    # 回退到 HTTP 回调
+    payload: Dict[str, Any] = {
+        "event": event,
+        "instanceId": instance.id,
+        "businessType": instance.business_type,
+        "businessId": instance.business_id,
+        "status": instance.status,
+    }
+    try:
+        resp = requests.post(
+            instance.callback_url,
+            json=payload,
+            timeout=10,
+            headers={"Content-Type": "application/json"},
+        )
+        logger.info(
+            "工作流HTTP回调成功: event=%s instance=%s status=%d",
+            event,
+            instance.id,
+            resp.status_code,
+        )
+    except Exception:
+        logger.exception(
+            "工作流HTTP回调失败: event=%s instance=%s url=%s",
+            event,
+            instance.id,
+            instance.callback_url,
+        )
diff --git a/backend/app/services/workflow_engine.py b/backend/app/services/workflow_engine.py
new file mode 100644
index 00000000..589a2b4c
--- /dev/null
+++ b/backend/app/services/workflow_engine.py
@@ -0,0 +1,389 @@
+"""工作流引擎 —— 读取节点与连线执行审批流转"""
+from __future__ import annotations
+
+import json
+import logging
+import re
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from sqlalchemy import text
+from sqlalchemy.orm import Session
+
+from app.crud import workflow as wf_crud
+from app.models.models import (
+    SysUser,
+    SysUserRole,
+    WfNode,
+    WfProcessInstance,
+    WfTask,
+    WfTransition,
+)
+from app.services.workflow_callback import trigger_callback
+
+logger = logging.getLogger("sqxp.workflow_engine")
+
+_FORBIDDEN_SQL_KEYWORDS = re.compile(
+    r"\b(INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE)\b", re.IGNORECASE
+)
+
+
+class WorkflowEngine:
+    def __init__(self, db: Session):
+        self.db = db
+
+    # ------------------------------------------------------------------
+    # start_process
+    # ------------------------------------------------------------------
+
+    def start_process(
+        self,
+        *,
+        process_def_id: str,
+        business_type: Optional[str] = None,
+        business_id: Optional[str] = None,
+        starter_user_id: Optional[str] = None,
+        variables: Optional[Dict[str, Any]] = None,
+        callback_url: Optional[str] = None,
+        tenant_no: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ) -> WfProcessInstance:
+        version = wf_crud.get_latest_version(self.db, process_def_id)
+        if not version:
+            raise ValueError("流程定义没有可用版本，请先发布")
+        instance = wf_crud.create_instance(
+            self.db,
+            process_version_id=version.id,
+            business_type=business_type,
+            business_id=business_id,
+            starter_user_id=starter_user_id,
+            variables=variables,
+            callback_url=callback_url,
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        nodes = wf_crud.get_nodes_by_version(self.db, version.id)
+        start_node = next((n for n in nodes if n.node_type == "start"), None)
+        if not start_node:
+            raise ValueError("流程缺少开始节点")
+        self._advance(instance.id, start_node.node_key, tenant_no or "zkxw")
+        self.db.refresh(instance)
+        return instance
+
+    # ------------------------------------------------------------------
+    # approve_task
+    # ------------------------------------------------------------------
+
+    def approve_task(self, task_id: str, comment: str, tenant_no: str) -> WfProcessInstance:
+        task = wf_crud.get_task(self.db, task_id)
+        if not task:
+            raise ValueError("任务不存在")
+        if task.status != "pending":
+            raise ValueError(f"任务状态为 {task.status}，无法审批")
+
+        task.status = "approved"
+        task.comment_text = comment
+        task.update_time = datetime.now()
+        self.db.add(task)
+        self.db.commit()
+
+        instance = wf_crud.get_instance(self.db, task.instance_id)
+        if not instance:
+            raise ValueError("流程实例不存在")
+
+        version_id = instance.process_version_id
+        nodes = wf_crud.get_nodes_by_version(self.db, version_id)
+        current_node = next(
+            (n for n in nodes if n.node_key == task.node_key), None
+        )
+        config = self._parse_node_config(current_node)
+        pass_type = config.get("passType", "any")
+
+        if pass_type == "any":
+            others = wf_crud.get_pending_tasks_by_node(
+                self.db, task.instance_id, task.node_key
+            )
+            for t in others:
+                t.status = "withdrawn"
+                t.update_time = datetime.now()
+                self.db.add(t)
+            self.db.commit()
+            self._advance(instance.id, task.node_key, tenant_no)
+        else:
+            remaining = wf_crud.get_pending_tasks_by_node(
+                self.db, task.instance_id, task.node_key
+            )
+            if not remaining:
+                self._advance(instance.id, task.node_key, tenant_no)
+
+        self.db.refresh(instance)
+        return instance
+
+    # ------------------------------------------------------------------
+    # reject_task
+    # ------------------------------------------------------------------
+
+    def reject_task(self, task_id: str, comment: str, tenant_no: str) -> WfProcessInstance:
+        task = wf_crud.get_task(self.db, task_id)
+        if not task:
+            raise ValueError("任务不存在")
+        if task.status != "pending":
+            raise ValueError(f"任务状态为 {task.status}，无法驳回")
+
+        task.status = "rejected"
+        task.comment_text = comment
+        task.update_time = datetime.now()
+        self.db.add(task)
+        self.db.commit()
+
+        others = wf_crud.get_pending_tasks_by_node(
+            self.db, task.instance_id, task.node_key
+        )
+        for t in others:
+            t.status = "withdrawn"
+            t.update_time = datetime.now()
+            self.db.add(t)
+        self.db.commit()
+
+        instance = wf_crud.get_instance(self.db, task.instance_id)
+        if instance:
+            wf_crud.update_instance_status(self.db, instance.id, "rejected")
+            self.db.refresh(instance)
+            trigger_callback(self.db, instance, "rejected")
+
+        return instance
+
+    # ------------------------------------------------------------------
+    # _advance (internal)
+    # ------------------------------------------------------------------
+
+    def _advance(
+        self, instance_id: str, from_node_key: str, tenant_no: str
+    ) -> None:
+        instance = wf_crud.get_instance(self.db, instance_id)
+        if not instance:
+            return
+        if instance.status != "running":
+            return
+
+        version_id = instance.process_version_id
+        nodes = wf_crud.get_nodes_by_version(self.db, version_id)
+        transitions = wf_crud.get_transitions_by_version(self.db, version_id)
+        variables = self._parse_variables(instance)
+
+        current_node = next(
+            (n for n in nodes if n.node_key == from_node_key), None
+        )
+        if not current_node:
+            return
+
+        out_edges = [
+            t for t in transitions if t.from_node_key == from_node_key
+        ]
+        if not out_edges:
+            return
+
+        if current_node.node_type in ("start", "approval"):
+            target_key = out_edges[0].to_node_key
+        elif current_node.node_type == "condition":
+            target_key = self._evaluate_condition(out_edges, variables)
+        else:
+            target_key = out_edges[0].to_node_key
+
+        next_node = next((n for n in nodes if n.node_key == target_key), None)
+        if next_node:
+            self._execute_node(instance_id, next_node, variables, tenant_no)
+
+    # ------------------------------------------------------------------
+    # _execute_node
+    # ------------------------------------------------------------------
+
+    def _execute_node(
+        self,
+        instance_id: str,
+        node: WfNode,
+        variables: Dict[str, Any],
+        tenant_no: str,
+    ) -> None:
+        if node.node_type == "end":
+            wf_crud.update_instance_status(self.db, instance_id, "completed")
+            instance = wf_crud.get_instance(self.db, instance_id)
+            if instance:
+                trigger_callback(self.db, instance, "completed")
+            return
+
+        if node.node_type == "approval":
+            config = self._parse_node_config(node)
+            user_ids = self._resolve_approvers(config, variables, tenant_no)
+            for uid in user_ids:
+                wf_crud.create_task(
+                    self.db,
+                    instance_id=instance_id,
+                    node_key=node.node_key,
+                    assignee_user_id=uid,
+                    tenant_no=tenant_no,
+                )
+            return
+
+        if node.node_type == "condition":
+            self._advance(instance_id, node.node_key, tenant_no)
+            return
+
+        self._advance(instance_id, node.node_key, tenant_no)
+
+    # ------------------------------------------------------------------
+    # _resolve_approvers
+    # ------------------------------------------------------------------
+
+    def _resolve_approvers(
+        self,
+        config: Dict[str, Any],
+        variables: Dict[str, Any],
+        tenant_no: str,
+    ) -> List[str]:
+        strategy = config.get("strategy", "users")
+
+        if strategy == "users":
+            return config.get("userIds", [])
+
+        if strategy == "roles":
+            role_ids = config.get("roleIds", [])
+            if not role_ids:
+                return []
+            rows = (
+                self.db.query(SysUser.id)
+                .join(SysUserRole, SysUserRole.user_id == SysUser.id)
+                .filter(
+                    SysUserRole.role_id.in_(role_ids),
+                    SysUser.del_flag == 0,
+                    SysUser.status == "1",
+                )
+                .all()
+            )
+            return [r.id for r in rows]
+
+        if strategy == "sql":
+            sql_template = config.get("sql", "")
+            if not sql_template or not sql_template.strip().upper().startswith("SELECT"):
+                raise ValueError("SQL 审批人策略必须以 SELECT 开头")
+            if _FORBIDDEN_SQL_KEYWORDS.search(sql_template):
+                raise ValueError("SQL 审批人策略包含禁止的关键字")
+            try:
+                result = self.db.execute(text(sql_template), variables or {})
+                return [str(row[0]) for row in result.fetchall()]
+            except Exception as exc:
+                logger.exception("SQL 审批人解析失败: %s", exc)
+                raise ValueError(f"SQL 审批人解析失败: {exc}") from exc
+
+        return []
+
+    # ------------------------------------------------------------------
+    # _evaluate_condition
+    # ------------------------------------------------------------------
+
+    def _evaluate_condition(
+        self, out_edges: List[WfTransition], variables: Dict[str, Any]
+    ) -> str:
+        unconditional_fallback = out_edges[-1].to_node_key if out_edges else ""
+
+        for edge in out_edges:
+            cond_str = edge.condition_expr
+            if not cond_str:
+                continue
+            try:
+                rules = json.loads(cond_str)
+            except (json.JSONDecodeError, TypeError):
+                continue
+            if self._check_rules(rules, variables):
+                return edge.to_node_key
+
+        return unconditional_fallback
+
+    # ------------------------------------------------------------------
+    # _check_rules (recursive)
+    # ------------------------------------------------------------------
+
+    def _check_rules(self, rules: Any, variables: Dict[str, Any]) -> bool:
+        if isinstance(rules, list):
+            return any(self._check_rules(r, variables) for r in rules)
+
+        if isinstance(rules, dict):
+            if "and" in rules:
+                return all(self._check_rules(r, variables) for r in rules["and"])
+            if "or" in rules:
+                return any(self._check_rules(r, variables) for r in rules["or"])
+            if "rules" in rules:
+                return self._check_rules(rules["rules"], variables)
+            if "field" in rules:
+                actual = self._get_variable(rules["field"], variables)
+                op = rules.get("op", "==")
+                expected = rules.get("value")
+                return self._compare(actual, op, expected)
+
+        return False
+
+    # ------------------------------------------------------------------
+    # _compare
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _compare(actual: Any, op: str, expected: Any) -> bool:
+        try:
+            if op == "==":
+                return str(actual) == str(expected)
+            if op == "!=":
+                return str(actual) != str(expected)
+            if op == ">":
+                return float(actual) > float(expected)
+            if op == "<":
+                return float(actual) < float(expected)
+            if op == ">=":
+                return float(actual) >= float(expected)
+            if op == "<=":
+                return float(actual) <= float(expected)
+            if op == "in":
+                return str(actual) in ([str(e) for e in expected] if isinstance(expected, list) else str(expected))
+            if op == "not_in":
+                return str(actual) not in ([str(e) for e in expected] if isinstance(expected, list) else str(expected))
+            if op == "contains":
+                return str(expected) in str(actual)
+        except (ValueError, TypeError):
+            return False
+        return False
+
+    # ------------------------------------------------------------------
+    # _get_variable (dot-notation)
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _get_variable(field: str, variables: Dict[str, Any]) -> Any:
+        parts = field.split(".")
+        current: Any = variables
+        for part in parts:
+            if isinstance(current, dict):
+                current = current.get(part)
+            else:
+                return None
+        return current
+
+    # ------------------------------------------------------------------
+    # helpers
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _parse_node_config(node: Optional[WfNode]) -> Dict[str, Any]:
+        if not node or not node.config_json:
+            return {}
+        try:
+            return json.loads(node.config_json)
+        except (json.JSONDecodeError, TypeError):
+            return {}
+
+    @staticmethod
+    def _parse_variables(instance: WfProcessInstance) -> Dict[str, Any]:
+        if not instance.variables_json:
+            return {}
+        try:
+            return json.loads(instance.variables_json)
+        except (json.JSONDecodeError, TypeError):
+            return {}
diff --git a/backend/requirements.txt b/backend/requirements.txt
index e4054aa6..678308b8 100644
--- a/backend/requirements.txt
+++ b/backend/requirements.txt
@@ -15,3 +15,4 @@ python-dotenv==1.0.0
 apscheduler==3.10.4
 minio==7.2.20
 Pillow>=10.0.0
+requests>=2.31.0
diff --git a/backend/tests/test_basic_info_tenant_ownership.py b/backend/tests/test_basic_info_tenant_ownership.py
new file mode 100644
index 00000000..c3ed3340
--- /dev/null
+++ b/backend/tests/test_basic_info_tenant_ownership.py
@@ -0,0 +1,254 @@
+"""
+Tests for tenant ownership validation in basic-info CRUD operations.
+
+Per AGENTS.md: "All business queries SHALL filter by current user's tenant_no."
+Per audit: customer, cell_sample_type, collection_protocol_no, sample_code
+CRUD get_*() functions do NOT filter by tenant_no, allowing cross-tenant
+update/delete if the record ID is known.
+
+These tests verify that:
+1. get_*() functions accept and filter by tenant_no
+2. update_*() functions reject cross-tenant modifications
+3. soft_delete_*() functions reject cross-tenant deletions
+
+The collection_region module already correctly implements tenant_no filtering
+and serves as the reference pattern.
+"""
+
+import unittest
+from unittest.mock import MagicMock, patch
+
+# We test the CRUD function signatures and behavior without a real database
+# by patching the SQLAlchemy session and model queries.
+
+
+class TestCustomerTenantOwnership(unittest.TestCase):
+    """Customer CRUD should enforce tenant_no on update/delete."""
+
+    def test_get_customer_signature_accepts_tenant_no(self):
+        """get_customer() should accept an optional tenant_no parameter."""
+        from app.crud.customer import get_customer
+
+        import inspect
+        sig = inspect.signature(get_customer)
+        params = list(sig.parameters.keys())
+        # Currently: ['db', 'customer_id'] — should add 'tenant_no'
+        self.assertIn("tenant_no", params, "get_customer() must accept tenant_no parameter")
+
+    def test_get_customer_filters_by_tenant_no(self):
+        """get_customer() should filter query by tenant_no when provided."""
+        from app.crud.customer import get_customer
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        # Should not raise, and should add tenant_no filter
+        result = get_customer(mock_db, "some-id", tenant_no="tenant-A")
+        mock_db.query.assert_called_once()
+        # filter() should be called at least twice (del_flag + tenant_no)
+        self.assertGreaterEqual(mock_query.filter.call_count, 2)
+
+    def test_update_customer_rejects_cross_tenant(self):
+        """update_customer() should raise when record belongs to different tenant."""
+        from app.crud.customer import update_customer
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None  # tenant_no filter blocks access
+
+        with self.assertRaises(ValueError) as ctx:
+            update_customer(
+                mock_db,
+                "cross-tenant-id",
+                customer_name="Hacked",
+                user_id="user-A",
+                tenant_no="tenant-A",  # record belongs to tenant-B
+            )
+        self.assertIn("不存在", str(ctx.exception))
+
+    def test_soft_delete_customer_rejects_cross_tenant(self):
+        """soft_delete_customer() should raise when record belongs to different tenant."""
+        from app.crud.customer import soft_delete_customer
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None  # tenant_no filter blocks access
+
+        with self.assertRaises(ValueError):
+            soft_delete_customer(mock_db, "cross-tenant-id", tenant_no="tenant-A")
+
+
+class TestCellSampleTypeTenantOwnership(unittest.TestCase):
+    """CellSampleType CRUD should enforce tenant_no on update/delete."""
+
+    def test_get_cell_sample_type_signature_accepts_tenant_no(self):
+        """get_cell_sample_type() should accept an optional tenant_no parameter."""
+        from app.crud.cell_sample_type import get_cell_sample_type
+
+        import inspect
+        sig = inspect.signature(get_cell_sample_type)
+        params = list(sig.parameters.keys())
+        self.assertIn("tenant_no", params, "get_cell_sample_type() must accept tenant_no parameter")
+
+    def test_update_cell_sample_type_rejects_cross_tenant(self):
+        """update_cell_sample_type() should raise when record belongs to different tenant."""
+        from app.crud.cell_sample_type import update_cell_sample_type
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError) as ctx:
+            update_cell_sample_type(
+                mock_db,
+                "cross-tenant-id",
+                type_name="Hacked",
+                user_id="user-A",
+                tenant_no="tenant-A",
+            )
+        self.assertIn("不存在", str(ctx.exception))
+
+    def test_soft_delete_cell_sample_type_rejects_cross_tenant(self):
+        """soft_delete_cell_sample_type() should raise when record belongs to different tenant."""
+        from app.crud.cell_sample_type import soft_delete_cell_sample_type
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError):
+            soft_delete_cell_sample_type(mock_db, "cross-tenant-id", tenant_no="tenant-A")
+
+
+class TestProtocolNoTenantOwnership(unittest.TestCase):
+    """CollectionProtocolNo CRUD should enforce tenant_no on update/delete."""
+
+    def test_get_protocol_no_signature_accepts_tenant_no(self):
+        """get_protocol_no() should accept an optional tenant_no parameter."""
+        from app.crud.collection_protocol_no import get_protocol_no
+
+        import inspect
+        sig = inspect.signature(get_protocol_no)
+        params = list(sig.parameters.keys())
+        self.assertIn("tenant_no", params, "get_protocol_no() must accept tenant_no parameter")
+
+    def test_update_protocol_no_rejects_cross_tenant(self):
+        """update_protocol_no() should raise when record belongs to different tenant."""
+        from app.crud.collection_protocol_no import update_protocol_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError) as ctx:
+            update_protocol_no(
+                mock_db,
+                "cross-tenant-id",
+                remark="Hacked",
+                user_id="user-A",
+                tenant_no="tenant-A",
+            )
+        self.assertIn("不存在", str(ctx.exception))
+
+    def test_soft_delete_protocol_no_rejects_cross_tenant(self):
+        """soft_delete_protocol_no() should raise when record belongs to different tenant."""
+        from app.crud.collection_protocol_no import soft_delete_protocol_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError):
+            soft_delete_protocol_no(mock_db, "cross-tenant-id", tenant_no="tenant-A")
+
+
+class TestSampleCodeTenantOwnership(unittest.TestCase):
+    """SampleCode CRUD should enforce tenant_no on update/delete."""
+
+    def test_get_sample_code_signature_accepts_tenant_no(self):
+        """get_sample_code() should accept an optional tenant_no parameter."""
+        from app.crud.sample_code import get_sample_code
+
+        import inspect
+        sig = inspect.signature(get_sample_code)
+        params = list(sig.parameters.keys())
+        self.assertIn("tenant_no", params, "get_sample_code() must accept tenant_no parameter")
+
+    def test_update_sample_code_rejects_cross_tenant(self):
+        """update_sample_code() should raise when record belongs to different tenant."""
+        from app.crud.sample_code import update_sample_code
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError) as ctx:
+            update_sample_code(
+                mock_db,
+                "cross-tenant-id",
+                remark="Hacked",
+                user_id="user-A",
+                tenant_no="tenant-A",
+            )
+        self.assertIn("不存在", str(ctx.exception))
+
+    def test_soft_delete_sample_code_rejects_cross_tenant(self):
+        """soft_delete_sample_code() should raise when record belongs to different tenant."""
+        from app.crud.sample_code import soft_delete_sample_code
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        with self.assertRaises(ValueError):
+            soft_delete_sample_code(mock_db, "cross-tenant-id", tenant_no="tenant-A")
+
+
+class TestGetTenantNoFallback(unittest.TestCase):
+    """_get_tenant_no() should not silently fall back to hardcoded value."""
+
+    def test_get_tenant_no_raises_on_missing_user(self):
+        """When user_id is missing from token, should raise rather than default."""
+        from app.api.basic_info import _get_tenant_no
+
+        mock_db = MagicMock()
+        user = {}  # no user_id
+        with self.assertRaises((ValueError, PermissionError)):
+            _get_tenant_no(mock_db, user)
+
+    def test_get_tenant_no_raises_on_missing_sys_user(self):
+        """When SysUser record not found in DB, should raise rather than default."""
+        from app.api.basic_info import _get_tenant_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None  # SysUser not found
+
+        user = {"user_id": "some-id"}
+        with self.assertRaises((ValueError, PermissionError)):
+            _get_tenant_no(mock_db, user)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/backend/tests/test_collection_protocol_conventions.py b/backend/tests/test_collection_protocol_conventions.py
new file mode 100644
index 00000000..95efb078
--- /dev/null
+++ b/backend/tests/test_collection_protocol_conventions.py
@@ -0,0 +1,249 @@
+"""
+Tests for collection_protocol API/CRUD convention compliance.
+
+Per AGENTS.md engineering standards:
+1. _get_tenant_no() MUST NOT silently fall back to hardcoded "zkxw"
+   — must raise PermissionError when user_id missing or SysUser not found.
+2. All list queries SHALL sort by order_num ASC, create_time DESC
+   (unless a business-specific sort is justified in the design doc).
+3. list_audits, list_receipt_confirm_details, list_refund_confirm_details
+   currently only sort by create_time DESC — missing order_num ASC prefix.
+"""
+
+import unittest
+from unittest.mock import MagicMock, patch, call
+
+
+# ---------------------------------------------------------------------------
+# H1: _get_tenant_no must raise PermissionError (not fall back to "zkxw")
+# ---------------------------------------------------------------------------
+
+
+class TestCollectionProtocolGetTenantNo(unittest.TestCase):
+    """collection_protocol._get_tenant_no should match basic_info pattern."""
+
+    def test_raises_on_missing_user_id(self):
+        """When user dict has no user_id, must raise PermissionError."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        user = {}  # no user_id key
+        with self.assertRaises(PermissionError):
+            _get_tenant_no(mock_db, user)
+
+    def test_raises_on_none_user_id(self):
+        """When user_id is None, must raise PermissionError."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        user = {"user_id": None}
+        with self.assertRaises(PermissionError):
+            _get_tenant_no(mock_db, user)
+
+    def test_raises_on_empty_user_id(self):
+        """When user_id is empty string, must raise PermissionError."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        user = {"user_id": ""}
+        with self.assertRaises(PermissionError):
+            _get_tenant_no(mock_db, user)
+
+    def test_raises_on_missing_sys_user(self):
+        """When SysUser record not found in DB, must raise PermissionError."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None  # SysUser not found
+
+        user = {"user_id": "some-id"}
+        with self.assertRaises(PermissionError):
+            _get_tenant_no(mock_db, user)
+
+    def test_raises_on_sys_user_no_tenant(self):
+        """When SysUser exists but tenant_no is None, must raise PermissionError."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_user = MagicMock()
+        mock_user.tenant_no = None
+        mock_query.first.return_value = mock_user
+
+        user = {"user_id": "some-id"}
+        with self.assertRaises(PermissionError):
+            _get_tenant_no(mock_db, user)
+
+    def test_returns_tenant_no_on_valid_user(self):
+        """When SysUser has valid tenant_no, should return it."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_user = MagicMock()
+        mock_user.tenant_no = "tenant-ABC"
+        mock_query.first.return_value = mock_user
+
+        result = _get_tenant_no(mock_db, {"user_id": "user-1"})
+        self.assertEqual(result, "tenant-ABC")
+
+    def test_does_not_return_hardcoded_zkxw(self):
+        """Must never return the hardcoded fallback 'zkxw'."""
+        from app.api.collection_protocol import _get_tenant_no
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_db.query.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.first.return_value = None
+
+        user = {"user_id": "missing-user"}
+        with self.assertRaises(PermissionError) as ctx:
+            _get_tenant_no(mock_db, user)
+        # Ensure it raised, not returned "zkxw"
+        self.assertNotIsInstance(ctx.exception, type(None))
+
+
+# ---------------------------------------------------------------------------
+# M1: Sort order — list_audits should include order_num ASC
+# ---------------------------------------------------------------------------
+
+
+class TestListAuditsSortOrder(unittest.TestCase):
+    """list_audits should sort by order_num ASC, create_time DESC."""
+
+    @patch("app.crud.collection_protocol.BizProtocolAudit")
+    @patch("app.crud.collection_protocol.BizCollectionProtocol")
+    def test_list_audits_includes_order_num_in_sort(self, MockProtocol, MockAudit):
+        """order_by should include order_num ASC before create_time DESC."""
+        from app.crud.collection_protocol import list_audits
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_query.join.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.order_by.return_value = mock_query
+        mock_query.with_entities.return_value = mock_query
+        mock_query.scalar.return_value = 0
+        mock_query.offset.return_value = mock_query
+        mock_query.limit.return_value = mock_query
+        mock_query.all.return_value = []
+        mock_db.query.return_value = mock_query
+
+        list_audits(mock_db, tenant_no="t1")
+
+        # Check that order_by was called at least once for the data query
+        # The sort call should include order_num ASC
+        order_by_calls = mock_query.order_by.call_args_list
+        self.assertGreaterEqual(len(order_by_calls), 1, "order_by should be called for data query")
+
+        # The data query's order_by should contain order_num.asc()
+        # We check the last order_by call (the data query, not the count query)
+        last_sort_call = order_by_calls[-1]
+        sort_args = last_sort_call[0]  # positional args
+        # Should have at least 2 args: order_num ASC, create_time DESC
+        self.assertGreaterEqual(
+            len(sort_args), 2,
+            f"order_by should have at least 2 args (order_num ASC, create_time DESC), got: {sort_args}"
+        )
+
+
+# ---------------------------------------------------------------------------
+# M1: Sort order — list_receipt_confirm_details should include order_num ASC
+# ---------------------------------------------------------------------------
+
+
+class TestListReceiptConfirmSortOrder(unittest.TestCase):
+    """list_receipt_confirm_details should sort by order_num ASC, create_time DESC."""
+
+    @patch("app.crud.collection_protocol.BizProtocolPaymentDetail")
+    @patch("app.crud.collection_protocol.BizProtocolPayment")
+    @patch("app.crud.collection_protocol.BizCollectionProtocol")
+    def test_receipt_confirm_includes_order_num_in_sort(self, MockProtocol, MockPayment, MockDetail):
+        """order_by should include order_num ASC before create_time DESC."""
+        from app.crud.collection_protocol import list_receipt_confirm_details
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_query.join.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.order_by.return_value = mock_query
+        mock_query.with_entities.return_value = mock_query
+        mock_query.scalar.return_value = 0
+        mock_query.offset.return_value = mock_query
+        mock_query.limit.return_value = mock_query
+        mock_query.all.return_value = []
+        mock_db.query.return_value = mock_query
+
+        list_receipt_confirm_details(mock_db, tenant_no="t1")
+
+        order_by_calls = mock_query.order_by.call_args_list
+        self.assertGreaterEqual(len(order_by_calls), 1)
+
+        last_sort_call = order_by_calls[-1]
+        sort_args = last_sort_call[0]
+        self.assertGreaterEqual(
+            len(sort_args), 2,
+            f"order_by should have at least 2 args, got: {sort_args}"
+        )
+
+
+# ---------------------------------------------------------------------------
+# M1: Sort order — list_refund_confirm_details should include order_num ASC
+# ---------------------------------------------------------------------------
+
+
+class TestListRefundConfirmSortOrder(unittest.TestCase):
+    """list_refund_confirm_details should sort by order_num ASC, create_time DESC."""
+
+    @patch("app.crud.collection_protocol.BizProtocolPaymentDetail")
+    @patch("app.crud.collection_protocol.BizProtocolPayment")
+    @patch("app.crud.collection_protocol.BizCollectionProtocol")
+    def test_refund_confirm_includes_order_num_in_sort(self, MockProtocol, MockPayment, MockDetail):
+        """order_by should include order_num ASC before create_time DESC."""
+        from app.crud.collection_protocol import list_refund_confirm_details
+
+        mock_db = MagicMock()
+        mock_query = MagicMock()
+        mock_query.join.return_value = mock_query
+        mock_query.filter.return_value = mock_query
+        mock_query.order_by.return_value = mock_query
+        mock_query.with_entities.return_value = mock_query
+        mock_query.scalar.return_value = 0
+        mock_query.offset.return_value = mock_query
+        mock_query.limit.return_value = mock_query
+        mock_query.all.return_value = []
+        mock_db.query.return_value = mock_query
+
+        list_refund_confirm_details(mock_db, tenant_no="t1")
+
+        order_by_calls = mock_query.order_by.call_args_list
+        self.assertGreaterEqual(len(order_by_calls), 1)
+
+        last_sort_call = order_by_calls[-1]
+        sort_args = last_sort_call[0]
+        self.assertGreaterEqual(
+            len(sort_args), 2,
+            f"order_by should have at least 2 args, got: {sort_args}"
+        )
+
+
+class TestNormalizeYyyymmddDate(unittest.TestCase):
+    def test_compact_and_dashed(self):
+        from app.crud.collection_protocol import _normalize_yyyymmdd_date
+
+        self.assertEqual(_normalize_yyyymmdd_date("20260506"), "20260506")
+        self.assertEqual(_normalize_yyyymmdd_date("2026-05-06"), "20260506")
+        self.assertIsNone(_normalize_yyyymmdd_date(""))
+        self.assertIsNone(_normalize_yyyymmdd_date(None))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/backend/tests/test_collection_protocol_save_bundle.py b/backend/tests/test_collection_protocol_save_bundle.py
new file mode 100644
index 00000000..848e3126
--- /dev/null
+++ b/backend/tests/test_collection_protocol_save_bundle.py
@@ -0,0 +1,83 @@
+"""采集协议单创建/更新子表持久化与字段名规范化测试。"""
+
+import unittest
+from unittest.mock import MagicMock, patch
+
+from app.crud.collection_protocol import (
+    _normalize_fields,
+    attachments_to_urls,
+    urls_to_attachment_list,
+    upsert_party_customer,
+)
+
+
+class TestNormalizeFields(unittest.TestCase):
+    def test_camel_case_to_snake(self):
+        raw = {
+            "customerId": "c1",
+            "motherName": "张三",
+            "motherBirthYm": "199001",
+            "apgar1min": 9.5,
+            "apgar5min": 10,
+        }
+        out = _normalize_fields(raw)
+        self.assertEqual(out["customer_id"], "c1")
+        self.assertEqual(out["mother_name"], "张三")
+        self.assertEqual(out["mother_birth_ym"], "199001")
+        self.assertEqual(out["apgar_1min"], 9.5)
+        self.assertEqual(out["apgar_5min"], 10)
+
+
+class TestAttachmentsHelpers(unittest.TestCase):
+    def test_attachments_to_urls(self):
+        urls = attachments_to_urls(
+            [{"fileUrl": "http://a/1.jpg"}, {"fileUrl": "http://a/2.jpg"}]
+        )
+        self.assertEqual(urls, "http://a/1.jpg,http://a/2.jpg")
+
+    def test_urls_to_attachment_list(self):
+        items = urls_to_attachment_list("http://x/a.pdf,http://x/b.png")
+        self.assertEqual(len(items), 2)
+        self.assertEqual(items[0]["fileUrl"], "http://x/a.pdf")
+
+    def test_urls_to_attachment_list_uses_original_name_from_db(self):
+        db = MagicMock()
+        att = MagicMock()
+        att.id = "att-1"
+        att.original_name = "合同扫描件.pdf"
+        att.file_url = "protocol/2025/05/16/abc.pdf"
+        att.file_size = 2048
+        att.file_type = "application/pdf"
+        q = MagicMock()
+        db.query.return_value = q
+        q.filter.return_value = q
+        q.first.return_value = att
+        items = urls_to_attachment_list("protocol/2025/05/16/abc.pdf", db, "t1")
+        self.assertEqual(len(items), 1)
+        self.assertEqual(items[0]["fileName"], "合同扫描件.pdf")
+        self.assertEqual(items[0]["id"], "att-1")
+
+
+class TestUpsertPartyCustomer(unittest.TestCase):
+    @patch("app.crud.collection_protocol.get_party_customer")
+    def test_upsert_applies_camel_case_fields(self, mock_get):
+        mock_get.return_value = None
+        db = MagicMock()
+        fields = {
+            "motherName": "李四",
+            "motherPhone": "13800000000",
+            "motherIdCard": "110101199001011234",
+            "motherBirthYm": "199001",
+            "fatherName": "王五",
+        }
+        upsert_party_customer(db, "proto-1", "t1", "u1", **fields)
+        added = db.add.call_args[0][0]
+        self.assertEqual(added.mother_name, "李四")
+        self.assertEqual(added.mother_phone, "13800000000")
+        self.assertEqual(added.mother_id_card, "110101199001011234")
+        self.assertEqual(added.mother_birth_ym, "199001")
+        self.assertEqual(added.father_name, "王五")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/backend/tests/test_ethnic.py b/backend/tests/test_ethnic.py
new file mode 100644
index 00000000..dadf47af
--- /dev/null
+++ b/backend/tests/test_ethnic.py
@@ -0,0 +1,17 @@
+"""民族码表 CRUD 冒烟测试"""
+from app.core.database import SessionLocal
+from app.crud.ethnic import list_ethnics
+
+
+def test_list_ethnics_has_han():
+    db = SessionLocal()
+    try:
+        rows = list_ethnics(db)
+        assert len(rows) >= 56
+        han = next((r for r in rows if r["ethnicName"] == "汉族"), None)
+        assert han is not None
+        assert han["ethnicCode"] == "01"
+        filtered = list_ethnics(db, keyword="蒙古")
+        assert any(r["ethnicName"] == "蒙古族" for r in filtered)
+    finally:
+        db.close()
diff --git a/docs/sql/alter-biz-protocol-party-customer-apgar-decimal.sql b/docs/sql/alter-biz-protocol-party-customer-apgar-decimal.sql
new file mode 100644
index 00000000..030d4fb2
--- /dev/null
+++ b/docs/sql/alter-biz-protocol-party-customer-apgar-decimal.sql
@@ -0,0 +1,4 @@
+-- 采集协议单当事人：新生儿 Apgar 评分支持一位小数
+ALTER TABLE `biz_protocol_party_customer`
+  MODIFY COLUMN `apgar_1min` decimal(4,1) DEFAULT NULL COMMENT '新生儿评分1分钟',
+  MODIFY COLUMN `apgar_5min` decimal(4,1) DEFAULT NULL COMMENT '新生儿评分5分钟';
diff --git a/docs/sql/alter-biz-protocol-sample-status-nullable.sql b/docs/sql/alter-biz-protocol-sample-status-nullable.sql
new file mode 100644
index 00000000..bacaea3f
--- /dev/null
+++ b/docs/sql/alter-biz-protocol-sample-status-nullable.sql
@@ -0,0 +1,3 @@
+-- 样本状态允许为空，移除默认「已采集」，与前端清空行为一致
+ALTER TABLE `biz_protocol_sample`
+  MODIFY COLUMN `sample_status` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'ycj已采集 jcz检测中 yrk已入库 yzf已作废';
diff --git a/docs/sql/sys-ethnic.sql b/docs/sql/sys-ethnic.sql
new file mode 100644
index 00000000..65777cb5
--- /dev/null
+++ b/docs/sql/sys-ethnic.sql
@@ -0,0 +1,83 @@
+-- 民族码表（国标 GB/T 3304，仅数字编码条目，不含字母编码重复项）
+-- 执行前请确认库中无同名表；与 docs/sql/zkxw.sql 全量基线可并存，亦可合并进全量导出
+
+DROP TABLE IF EXISTS `sys_ethnic`;
+CREATE TABLE `sys_ethnic` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `ethnic_name` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '民族名称',
+  `ethnic_code` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '民族编码',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '租户编号（空=全局码表）',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_sys_ethnic_code` (`ethnic_code`,`del_flag`),
+  KEY `idx_sys_ethnic_name` (`ethnic_name`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='民族码表';
+
+BEGIN;
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-01', '汉族', '01', '', 1, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-02', '蒙古族', '02', '', 2, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-03', '回族', '03', '', 3, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-04', '藏族', '04', '', 4, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-05', '维吾尔族', '05', '', 5, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-06', '苗族', '06', '', 6, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-07', '彝族', '07', '', 7, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-08', '壮族', '08', '', 8, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-09', '布依族', '09', '', 9, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-10', '朝鲜族', '10', '', 10, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-11', '满族', '11', '', 11, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-12', '侗族', '12', '', 12, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-13', '瑶族', '13', '', 13, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-14', '白族', '14', '', 14, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-15', '土家族', '15', '', 15, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-16', '哈尼族', '16', '', 16, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-17', '哈萨克族', '17', '', 17, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-18', '傣族', '18', '', 18, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-19', '黎族', '19', '', 19, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-20', '傈僳族', '20', '', 20, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-21', '佤族', '21', '', 21, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-22', '畲族', '22', '', 22, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-23', '高山族', '23', '', 23, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-24', '拉祜族', '24', '', 24, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-25', '水族', '25', '', 25, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-26', '东乡族', '26', '', 26, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-27', '纳西族', '27', '', 27, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-28', '景颇族', '28', '', 28, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-29', '柯尔克孜族', '29', '', 29, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-30', '土族', '30', '', 30, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-31', '达斡尔族', '31', '', 31, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-32', '仫佬族', '32', '', 32, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-33', '羌族', '33', '', 33, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-34', '布朗族', '34', '', 34, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-35', '撒拉族', '35', '', 35, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-36', '毛难族', '36', '', 36, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-37', '仡佬族', '37', '', 37, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-38', '锡伯族', '38', '', 38, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-39', '阿昌族', '39', '', 39, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-40', '普米族', '40', '', 40, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-41', '塔吉克族', '41', '', 41, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-42', '怒族', '42', '', 42, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-43', '乌孜别克族', '43', '', 43, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-44', '俄罗斯族', '44', '', 44, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-45', '鄂温克族', '45', '', 45, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-46', '德昂族', '46', '', 46, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-47', '保安族', '47', '', 47, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-48', '裕固族', '48', '', 48, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-49', '京族', '49', '', 49, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-50', '塔塔尔族', '50', '', 50, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-51', '独龙族', '51', '', 51, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-52', '鄂伦春族', '52', '', 52, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-53', '赫哲族', '53', '', 53, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-54', '门巴族', '54', '', 54, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-55', '珞巴族', '55', '', 55, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-56', '基诺族', '56', '', 56, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-81', '穿青人族', '81', '', 57, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-97', '其他', '97', '', 58, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-98', '外国血统中国籍人士', '98', '', 59, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+COMMIT;
diff --git a/docs/sql/zkxw-init-dept-data.sql b/docs/sql/zkxw-init-dept-data.sql
deleted file mode 100644
index 4328679b..00000000
--- a/docs/sql/zkxw-init-dept-data.sql
+++ /dev/null
@@ -1,20 +0,0 @@
--- 组织管理初始化数据（需求 2.1.3）
--- 市场营销部门下设：采集部、临床部、中试服务部、支持中心、客服部
-
-SET @marketing_id = UUID();
-
-INSERT INTO sys_dept (id, parent_id, dept_name, dept_category_code, status, leader, leader_phone, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '0', '中科兴皖', 'gs', '1', NULL, NULL, 'zkxw', 0, '', 0),
-(@marketing_id, '0', '市场营销部门', 'bm', '1', NULL, NULL, 'zkxw', 1, '', 0),
-(UUID(), '0', '技术研发部', 'bm', '1', NULL, NULL, 'zkxw', 2, '', 0),
-(UUID(), '0', '生产部', 'bm', '1', NULL, NULL, 'zkxw', 3, '', 0),
-(UUID(), '0', '质量安全部', 'bm', '1', NULL, NULL, 'zkxw', 4, '', 0),
-(UUID(), '0', '财务部', 'bm', '1', NULL, NULL, 'zkxw', 5, '', 0),
-(UUID(), '0', '综合部', 'bm', '1', NULL, NULL, 'zkxw', 6, '', 0);
-
-INSERT INTO sys_dept (id, parent_id, dept_name, dept_category_code, status, leader, leader_phone, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), @marketing_id, '采集部', 'bm', '1', NULL, NULL, 'zkxw', 1, '', 0),
-(UUID(), @marketing_id, '临床部', 'bm', '1', NULL, NULL, 'zkxw', 2, '', 0),
-(UUID(), @marketing_id, '中试服务部', 'bm', '1', NULL, NULL, 'zkxw', 3, '', 0),
-(UUID(), @marketing_id, '支持中心', 'bm', '1', NULL, NULL, 'zkxw', 4, '', 0),
-(UUID(), @marketing_id, '客服部', 'bm', '1', NULL, NULL, 'zkxw', 5, '', 0);
diff --git a/docs/sql/zkxw-init-dict-data.sql b/docs/sql/zkxw-init-dict-data.sql
deleted file mode 100644
index 29bbcde8..00000000
--- a/docs/sql/zkxw-init-dict-data.sql
+++ /dev/null
@@ -1,24 +0,0 @@
--- ============================================================
--- 字典管理初始数据（sys_dict_type / sys_dict_data）
--- 执行前提：zkxw-requirements-v0.3-schema.sql 已建表
--- ============================================================
-
--- 字典类型
-INSERT INTO sys_dict_type (id, dict_name, dict_type, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '组织类别编码', 'zzlbbm', 'zkxw', 1, '', 0),
-(UUID(), '站点类型', 'zdlx', 'zkxw', 2, '', 0),
-(UUID(), '站点业务范围', 'zdywfw', 'zkxw', 3, '', 0),
-(UUID(), '部门状态', 'bmzt', 'zkxw', 4, '', 0);
-
--- 字典数据
-INSERT INTO sys_dict_data (id, dict_label, dict_value, dict_type, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '公司', 'gs', 'zzlbbm', 'zkxw', 1, '', 0),
-(UUID(), '分公司', 'fgs', 'zzlbbm', 'zkxw', 2, '', 0),
-(UUID(), '部门', 'bm', 'zzlbbm', 'zkxw', 3, '', 0),
-(UUID(), '中心基地', 'zxjd', 'zdlx', 'zkxw', 1, '', 0),
-(UUID(), '样本采集', 'ybcj', 'zdywfw', 'zkxw', 1, '', 0),
-(UUID(), '样本制备', 'ybzb', 'zdywfw', 'zkxw', 2, '', 0),
-(UUID(), '质量检测', 'zljc', 'zdywfw', 'zkxw', 3, '', 0),
-(UUID(), '细胞存储', 'xbcc', 'zdywfw', 'zkxw', 4, '', 0),
-(UUID(), '停用', '0', 'bmzt', 'zkxw', 1, '', 0),
-(UUID(), '正常', '1', 'bmzt', 'zkxw', 2, '', 0);
diff --git a/docs/sql/zkxw-init-menu-data.sql b/docs/sql/zkxw-init-menu-data.sql
deleted file mode 100644
index 1ddd36d9..00000000
--- a/docs/sql/zkxw-init-menu-data.sql
+++ /dev/null
@@ -1,24 +0,0 @@
--- 2.1.6 菜单管理初始化数据
--- Web端根节点与移动端根节点，parent_id = 0
-
--- 根节点：Web端菜单、移动端菜单
-INSERT INTO sys_menu (id, menu_name, parent_id, menu_type, path, component, visible, status, tenant_no, order_num, create_dept_id, del_flag) VALUES
-('1', 'Web端菜单', '0', 'M', '/system', NULL, '1', '1', 'zkxw', 1, '', 0),
-('2', '移动端菜单', '0', 'M', '/mini', NULL, '1', '1', 'zkxw', 2, '', 0);
-
--- Web端菜单 - 系统管理目录
-INSERT INTO sys_menu (id, menu_name, parent_id, menu_type, path, component, perms, visible, status, tenant_no, order_num, create_dept_id, del_flag) VALUES
-('100', '系统管理', '1', 'M', '/system', '/index/index', NULL, '1', '1', 'zkxw', 1, '', 0);
-
--- 系统管理子菜单
-INSERT INTO sys_menu (id, menu_name, parent_id, menu_type, path, component, perms, visible, status, tenant_no, order_num, create_dept_id, del_flag) VALUES
-('101', '租户管理', '100', 'C', 'tenant', '/system/tenant/index', 'system:tenant:list', '1', '1', 'zkxw', 1, '', 0),
-('102', '字典管理', '100', 'C', 'dict', '/system/dict/index', 'system:dict:list', '1', '1', 'zkxw', 2, '', 0),
-('103', '组织管理', '100', 'C', 'dept', '/system/dept/index', 'system:dept:list', '1', '1', 'zkxw', 3, '', 0),
-('104', '用户管理', '100', 'C', 'user', '/system/user/index', 'system:user:list', '1', '1', 'zkxw', 4, '', 0),
-('105', '角色管理', '100', 'C', 'role', '/system/role/index', 'system:role:list', '1', '1', 'zkxw', 5, '', 0),
-('106', '菜单管理', '100', 'C', 'menu', '/system/menu/index', 'system:menu:list', '1', '1', 'zkxw', 6, '', 0),
-('107', '站点管理', '100', 'C', 'site', '/system/site/index', 'system:site:list', '1', '1', 'zkxw', 7, '', 0),
-('108', '职位管理', '100', 'C', 'post', '/system/post/index', 'system:post:list', '1', '1', 'zkxw', 8, '', 0),
-('109', '物品单位', '100', 'C', 'unit', '/system/unit/index', 'system:unit:list', '1', '1', 'zkxw', 9, '', 0),
-('110', '快递公司', '100', 'C', 'express', '/system/express/index', 'system:express:list', '1', '1', 'zkxw', 10, '', 0);
diff --git a/docs/sql/zkxw-init-role-data.sql b/docs/sql/zkxw-init-role-data.sql
deleted file mode 100644
index 210a8af1..00000000
--- a/docs/sql/zkxw-init-role-data.sql
+++ /dev/null
@@ -1,28 +0,0 @@
--- V0.3 角色初始数据
--- sys_role_data_scope_detail 建表语句
-CREATE TABLE IF NOT EXISTS `sys_role_data_scope_detail` (
-  `id` varchar(64) NOT NULL COMMENT '主键ID',
-  `role_id` varchar(64) NOT NULL COMMENT '角色ID',
-  `scope_type` varchar(20) NOT NULL COMMENT '范围类型：dept/user',
-  `scope_value` varchar(100) NOT NULL COMMENT '范围值：部门ID/用户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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` varchar(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` smallint NOT NULL DEFAULT '0' COMMENT '删除标记',
-  PRIMARY KEY (`id`),
-  KEY `idx_role_id` (`role_id`),
-  KEY `idx_tenant_no` (`tenant_no`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='角色自定义数据权限明细';
-
--- 角色初始数据
-INSERT INTO sys_role (id, role_name, data_scope, status, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '超级管理员', '1', '1', 'zkxw', 1, '', 0),
-(UUID(), '运营管理员', '1', '1', 'zkxw', 2, '', 0),
-(UUID(), '采集专员', '2', '1', 'zkxw', 3, '', 0),
-(UUID(), '市场支持专员', '2', '1', 'zkxw', 4, '', 0),
-(UUID(), '质检专员', '2', '1', 'zkxw', 5, '', 0);
diff --git a/docs/sql/zkxw-init-site-post-unit-express.sql b/docs/sql/zkxw-init-site-post-unit-express.sql
deleted file mode 100644
index 3cac3946..00000000
--- a/docs/sql/zkxw-init-site-post-unit-express.sql
+++ /dev/null
@@ -1,26 +0,0 @@
--- 站点、职位、物品单位、快递公司 初始化数据
--- 对应模型：SysSite, SysPost, BizItemUnit, BizExpressCompany
-
--- 站点
-INSERT INTO sys_site (id, site_name, site_code, site_type, status, address, contact_name, contact_phone, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '中科兴皖中心基地', 'zkxw-zxjd', 'zxjd', '1', '', NULL, NULL, 'zkxw', 1, '', 0);
-
--- 职位
-INSERT INTO sys_post (id, post_name, post_code, status, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), '采集专员', 'cjzy', '1', 'zkxw', 1, '', 0),
-(UUID(), '市场支持专员', 'sczczy', '1', 'zkxw', 2, '', 0),
-(UUID(), '质检专员', 'zjzy', '1', 'zkxw', 3, '', 0);
-
--- 物品单位
-INSERT INTO biz_item_unit (id, unit_code, unit_name, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), 'g', '克', 'zkxw', 1, '', 0),
-(UUID(), 'ml', '毫升', 'zkxw', 2, '', 0),
-(UUID(), 'ge', '个', 'zkxw', 3, '', 0),
-(UUID(), 'fen', '份', 'zkxw', 4, '', 0);
-
--- 快递公司
-INSERT INTO biz_express_company (id, express_code, express_name, tenant_no, order_num, create_dept_id, del_flag) VALUES
-(UUID(), 'sf', '顺丰速运', 'zkxw', 1, '', 0),
-(UUID(), 'jd', '京东快递', 'zkxw', 2, '', 0),
-(UUID(), 'zt', '中通快递', 'zkxw', 3, '', 0),
-(UUID(), 'yt', '圆通速递', 'zkxw', 4, '', 0);
diff --git a/docs/sql/zkxw-init-user-data.sql b/docs/sql/zkxw-init-user-data.sql
deleted file mode 100644
index 3ed4dbc6..00000000
--- a/docs/sql/zkxw-init-user-data.sql
+++ /dev/null
@@ -1,24 +0,0 @@
--- zkxw-init-user-data.sql
--- V0.3 用户管理初始化数据（测试用户）
--- 默认 admin 用户已在骨架 SQL 中创建，此处补充测试账号
--- 注意：密码需通过后端 API 创建以获得正确的 bcrypt hash
-
-INSERT INTO sys_user (
-  id, dept_id, user_no, nick_name, email, phone_no, sex,
-  password, status, tenant_no, order_num,
-  create_dept_id, create_by, create_time, update_by, update_time, del_flag
-) VALUES
-(
-  REPLACE(UUID(),'-',''), 
-  (SELECT id FROM sys_dept WHERE dept_name='市场营销部' AND del_flag=0 LIMIT 1),
-  'zhangsan', '张三', 'zhangsan@zkxw.com', '13800000001', '0',
-  '$2b$12$placeholder_hash_use_api_to_set', '1', 'zkxw', 2,
-  '', NULL, NOW(), NULL, NOW(), 0
-),
-(
-  REPLACE(UUID(),'-',''),
-  (SELECT id FROM sys_dept WHERE dept_name='市场营销部' AND del_flag=0 LIMIT 1),
-  'lisi', '李四', 'lisi@zkxw.com', '13800000002', '1',
-  '$2b$12$placeholder_hash_use_api_to_set', '1', 'zkxw', 3,
-  '', NULL, NOW(), NULL, NOW(), 0
-);
diff --git a/docs/sql/zkxw-requirements-v0.3-schema.sql b/docs/sql/zkxw-requirements-v0.3-schema.sql
deleted file mode 100644
index c9df5f6e..00000000
--- a/docs/sql/zkxw-requirements-v0.3-schema.sql
+++ /dev/null
@@ -1,1638 +0,0 @@
--- =============================================================================
--- 中科兴皖需求 V0.3 表模型 DDL（MySQL 5.7）
--- 依据：docs/中科兴皖需求V0.3.md 第 2、3 节
--- 说明：
---   1) id 为 VARCHAR(64)，由应用生成 UUID；未启用外键约束，便于分步执行与迁移。
---   2) 公共字段顺序：业务字段 → tenant_no → order_num → remark → create_* → update_* → del_flag
---   3) 文档标注「暂不开发」的模块（科研捐赠、临床应用、物料、财务、生产、质检）未建表。
--- =============================================================================
-
-SET NAMES utf8mb4;
-SET FOREIGN_KEY_CHECKS = 0;
-
--- -----------------------------------------------------------------------------
--- 公共列片段（复制到各表；此处仅作文档说明，实际已展开写入各 CREATE TABLE）
--- tenant_no, order_num, remark, create_by, create_dept_id, create_time,
--- update_by, update_time, del_flag
--- -----------------------------------------------------------------------------
-
--- ========== 2.1.1 租户管理 ==========
-DROP TABLE IF EXISTS `sys_tenant`;
-CREATE TABLE `sys_tenant` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `tenant_no` VARCHAR(64) NOT NULL COMMENT '租户编号（业务编码，如 zkxw）',
-  `tenant_name` VARCHAR(200) NOT NULL COMMENT '租户名称',
-  `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人姓名',
-  `contact_phone` VARCHAR(32) DEFAULT NULL 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_sys_tenant_no` (`tenant_no`, `del_flag`),
-  KEY `idx_sys_tenant_del` (`del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='租户信息';
-
--- ========== 2.1.2 字典管理 ==========
-DROP TABLE IF EXISTS `sys_dict_type`;
-CREATE TABLE `sys_dict_type` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `dict_name` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '字典名称',
-  `dict_type` VARCHAR(100) NOT NULL DEFAULT '' 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_dict_type` (`tenant_no`, `dict_type`, `del_flag`),
-  KEY `idx_dict_type_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='字典类型';
-
-DROP TABLE IF EXISTS `sys_dict_data`;
-CREATE TABLE `sys_dict_data` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `dict_label` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '字典标签',
-  `dict_value` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '字典键值',
-  `dict_type` VARCHAR(100) NOT NULL DEFAULT '' 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_dict_data_type` (`tenant_no`, `dict_type`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='字典数据';
-
--- ========== 2.1.3 组织管理 ==========
-DROP TABLE IF EXISTS `sys_dept`;
-CREATE TABLE `sys_dept` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `parent_id` VARCHAR(64) NOT NULL DEFAULT '0' COMMENT '父组织id，0为根',
-  `dept_name` VARCHAR(200) NOT NULL COMMENT '组织名称',
-  `dept_category_code` VARCHAR(64) DEFAULT NULL COMMENT '组织类别编码（字典 zzlbbm）',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '部门状态（字典 bmzt：0停用 1正常）',
-  `leader` VARCHAR(100) DEFAULT NULL COMMENT '部门负责人',
-  `leader_phone` VARCHAR(32) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_dept_parent` (`parent_id`, `del_flag`),
-  KEY `idx_dept_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='组织/部门';
-
--- ========== 2.1.4 用户管理 ==========
-DROP TABLE IF EXISTS `sys_user`;
-CREATE TABLE `sys_user` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `dept_id` VARCHAR(64) DEFAULT NULL COMMENT '部门ID',
-  `user_no` VARCHAR(30) NOT NULL COMMENT '用户账号',
-  `nick_name` VARCHAR(30) NOT NULL COMMENT '用户名',
-  `email` VARCHAR(50) DEFAULT '' COMMENT '用户邮箱',
-  `phone_no` VARCHAR(11) DEFAULT '' COMMENT '手机号码',
-  `sex` CHAR(1) DEFAULT '0' COMMENT '用户性别（0男 1女 2未知）',
-  `avatar` VARCHAR(512) DEFAULT NULL COMMENT '头像（minio完整地址）',
-  `password` VARCHAR(100) DEFAULT '' COMMENT '密码',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '帐号状态（1正常 0停用）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_no` (`tenant_no`, `user_no`, `del_flag`),
-  KEY `idx_user_dept` (`dept_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户';
-
--- ========== 2.1.5 角色管理 ==========
-DROP TABLE IF EXISTS `sys_role`;
-CREATE TABLE `sys_role` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `role_name` VARCHAR(30) NOT NULL COMMENT '角色名称',
-  `data_scope` CHAR(1) DEFAULT '1' COMMENT '数据权限（1全部 2本部门 3本部门及以下 4仅本人 5自定义）',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '角色状态（1正常 0停用）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_role_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色';
-
-DROP TABLE IF EXISTS `sys_user_role`;
-CREATE TABLE `sys_user_role` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `user_id` VARCHAR(64) NOT NULL COMMENT '用户ID',
-  `role_id` VARCHAR(64) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_role` (`user_id`, `role_id`, `del_flag`),
-  KEY `idx_user_role_role` (`role_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户-角色关联';
-
-DROP TABLE IF EXISTS `sys_role_menu`;
-CREATE TABLE `sys_role_menu` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `role_id` VARCHAR(64) NOT NULL COMMENT '角色ID',
-  `menu_id` VARCHAR(64) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_role_menu` (`role_id`, `menu_id`, `del_flag`),
-  KEY `idx_role_menu_menu` (`menu_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色-菜单关联';
-
-DROP TABLE IF EXISTS `sys_role_data_scope_detail`;
-CREATE TABLE `sys_role_data_scope_detail` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `role_id` VARCHAR(64) NOT NULL COMMENT '角色ID',
-  `scope_type` VARCHAR(20) NOT NULL COMMENT '范围类型：dept部门 user用户',
-  `scope_value` VARCHAR(100) NOT NULL COMMENT '范围值：部门ID/用户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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_role_scope_role` (`role_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色自定义数据权限明细';
-
--- ========== 2.1.6 菜单管理 ==========
-DROP TABLE IF EXISTS `sys_menu`;
-CREATE TABLE `sys_menu` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `menu_name` VARCHAR(50) NOT NULL COMMENT '菜单名称',
-  `parent_id` VARCHAR(64) NOT NULL DEFAULT '0' COMMENT '父菜单ID，0为根',
-  `menu_type` CHAR(1) DEFAULT 'M' COMMENT '类型 M目录 C菜单 F按钮（扩展）',
-  `path` VARCHAR(200) DEFAULT '' COMMENT '路由路径（扩展）',
-  `component` VARCHAR(255) DEFAULT NULL COMMENT '组件路径（扩展）',
-  `perms` VARCHAR(100) DEFAULT NULL COMMENT '权限标识（扩展）',
-  `is_frame` INT(1) DEFAULT 1 COMMENT '是否外链（1是 0否）',
-  `visible` CHAR(1) DEFAULT '1' COMMENT '显示状态（1显示 0隐藏）',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '菜单状态（1正常 0停用）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_menu_parent` (`parent_id`, `del_flag`),
-  KEY `idx_menu_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='菜单';
-
--- ========== 2.1.7 站点管理 ==========
-DROP TABLE IF EXISTS `sys_site`;
-CREATE TABLE `sys_site` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `site_name` VARCHAR(200) NOT NULL COMMENT '站点名称',
-  `site_code` VARCHAR(64) NOT NULL COMMENT '站点编码',
-  `site_type` VARCHAR(64) DEFAULT NULL COMMENT '站点类型（字典 zdlx）',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '状态（1正常 0停用）',
-  `address` VARCHAR(512) DEFAULT NULL COMMENT '详细地址',
-  `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人',
-  `contact_phone` VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
-  `business_scope` VARCHAR(256) DEFAULT NULL COMMENT '业务范围（字典 zdywfw，多值可逗号分隔）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_site_code` (`tenant_no`, `site_code`, `del_flag`),
-  KEY `idx_site_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='站点';
-
--- ========== 2.1.8 职位管理 ==========
-DROP TABLE IF EXISTS `sys_post`;
-CREATE TABLE `sys_post` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `post_name` VARCHAR(100) NOT NULL COMMENT '职位名称',
-  `post_code` VARCHAR(64) NOT NULL COMMENT '职位编码',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '状态（1正常 0停用）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_post_code` (`tenant_no`, `post_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='职位';
-
-DROP TABLE IF EXISTS `sys_user_post`;
-CREATE TABLE `sys_user_post` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `user_id` VARCHAR(64) NOT NULL COMMENT '用户ID',
-  `post_id` VARCHAR(64) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_post` (`user_id`, `post_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户-职位关联';
-
--- ========== 2.1.9 物品单位 ==========
-DROP TABLE IF EXISTS `biz_item_unit`;
-CREATE TABLE `biz_item_unit` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `unit_code` VARCHAR(64) NOT NULL COMMENT '单位编码',
-  `unit_name` VARCHAR(100) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_item_unit` (`tenant_no`, `unit_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='物品单位';
-
--- ========== 2.1.10 快递公司 ==========
-DROP TABLE IF EXISTS `biz_express_company`;
-CREATE TABLE `biz_express_company` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `express_code` VARCHAR(64) NOT NULL COMMENT '快递公司编码',
-  `express_name` VARCHAR(200) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_express` (`tenant_no`, `express_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递公司';
-
--- ========== 2.1.11 工作流（概要模型，可随实现扩展） ==========
-DROP TABLE IF EXISTS `wf_process_def`;
-CREATE TABLE `wf_process_def` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `process_code` VARCHAR(64) NOT NULL COMMENT '流程编码',
-  `process_name` VARCHAR(200) NOT NULL COMMENT '流程名称',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '1启用 0停用',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_wf_def` (`tenant_no`, `process_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程定义';
-
-DROP TABLE IF EXISTS `wf_process_version`;
-CREATE TABLE `wf_process_version` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `process_def_id` VARCHAR(64) NOT NULL COMMENT '流程定义ID',
-  `version_no` INT NOT NULL COMMENT '版本号，递增',
-  `graph_json` MEDIUMTEXT COMMENT '节点与连线等配置（JSON 字符串）',
-  `is_latest` CHAR(1) DEFAULT '0' COMMENT '是否最新版本（1是 0否）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_wf_ver_def` (`process_def_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程定义版本';
-
-DROP TABLE IF EXISTS `wf_node`;
-CREATE TABLE `wf_node` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `process_version_id` VARCHAR(64) NOT NULL COMMENT '流程版本ID',
-  `node_key` VARCHAR(64) NOT NULL COMMENT '节点唯一键（画布内）',
-  `node_type` VARCHAR(32) NOT NULL COMMENT 'start/end/approval/condition 等',
-  `node_name` VARCHAR(200) DEFAULT NULL COMMENT '节点名称',
-  `config_json` MEDIUMTEXT COMMENT '审批人/SQL/会签策略等配置',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_wf_node_ver` (`process_version_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程节点';
-
-DROP TABLE IF EXISTS `wf_transition`;
-CREATE TABLE `wf_transition` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `process_version_id` VARCHAR(64) NOT NULL COMMENT '流程版本ID',
-  `from_node_key` VARCHAR(64) NOT NULL COMMENT '起始节点key',
-  `to_node_key` VARCHAR(64) NOT NULL COMMENT '目标节点key',
-  `condition_expr` 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_wf_trans_ver` (`process_version_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程连线/转移';
-
-DROP TABLE IF EXISTS `wf_process_instance`;
-CREATE TABLE `wf_process_instance` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `process_version_id` VARCHAR(64) NOT NULL COMMENT '发起时锁定的流程版本ID',
-  `business_type` VARCHAR(64) DEFAULT NULL COMMENT '业务类型',
-  `business_id` VARCHAR(64) DEFAULT NULL COMMENT '业务主键',
-  `starter_user_id` VARCHAR(64) DEFAULT NULL COMMENT '发起人',
-  `variables_json` MEDIUMTEXT COMMENT '流程变量 JSON',
-  `status` VARCHAR(32) DEFAULT NULL COMMENT 'running/completed/rejected 等',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_wf_inst_biz` (`business_type`, `business_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程实例';
-
-DROP TABLE IF EXISTS `wf_task`;
-CREATE TABLE `wf_task` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `instance_id` VARCHAR(64) NOT NULL COMMENT '流程实例ID',
-  `node_key` VARCHAR(64) DEFAULT NULL COMMENT '当前节点key',
-  `assignee_user_id` VARCHAR(64) DEFAULT NULL COMMENT '待办人',
-  `status` VARCHAR(32) DEFAULT NULL COMMENT 'pending/approved/rejected 等',
-  `comment_text` 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_wf_task_inst` (`instance_id`, `del_flag`),
-  KEY `idx_wf_task_user` (`assignee_user_id`, `status`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程任务/待办';
-
--- ========== 2.2.1 客户管理 customer ==========
-DROP TABLE IF EXISTS `biz_customer`;
-CREATE TABLE `biz_customer` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `customer_name` VARCHAR(100) NOT NULL COMMENT '客户姓名',
-  `sex` CHAR(1) DEFAULT '2' COMMENT '性别（0男 1女 2未知）',
-  `id_card_no` VARCHAR(32) DEFAULT NULL COMMENT '身份证号',
-  `age` INT DEFAULT NULL COMMENT '年龄',
-  `phone_no` VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
-  `customer_tags` 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_customer_idcard` (`tenant_no`, `id_card_no`, `del_flag`),
-  KEY `idx_customer_name` (`tenant_no`, `customer_name`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='客户信息';
-
-DROP TABLE IF EXISTS `biz_customer_follow`;
-CREATE TABLE `biz_customer_follow` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID',
-  `follow_time` DATETIME NOT NULL COMMENT '随访时间',
-  `follow_desc` VARCHAR(2000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_follow_customer` (`customer_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='客户随访';
-
--- ========== 2.2.2 细胞样本类型 ==========
-DROP TABLE IF EXISTS `biz_cell_sample_type`;
-CREATE TABLE `biz_cell_sample_type` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `type_code` VARCHAR(64) NOT NULL COMMENT '样本类型编码',
-  `type_name` VARCHAR(200) NOT NULL COMMENT '样本类型名称',
-  `storage_years` INT DEFAULT NULL COMMENT '样本存储年份',
-  `storage_price` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_sample_type` (`tenant_no`, `type_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞样本类型';
-
--- ========== 2.2.3 采集地区及医院（1 地区 : N 医院） ==========
-DROP TABLE IF EXISTS `biz_collection_hospital`;
-DROP TABLE IF EXISTS `biz_collection_region`;
-CREATE TABLE `biz_collection_region` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `region_name` VARCHAR(200) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_region_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集地区';
-
-CREATE TABLE `biz_collection_hospital` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `region_id` VARCHAR(64) NOT NULL COMMENT '采集地区ID',
-  `hospital_name` VARCHAR(200) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_hospital_region` (`region_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集地区下属医院';
-
--- ========== 2.2.4 采集协议号 ==========
-DROP TABLE IF EXISTS `biz_collection_protocol_no`;
-CREATE TABLE `biz_collection_protocol_no` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `protocol_no` VARCHAR(32) NOT NULL COMMENT '采集协议号',
-  `issued` TINYINT NOT NULL DEFAULT 0 COMMENT '是否下发（1是 0否）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_protocol_no` (`tenant_no`, `protocol_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议号池';
-
--- ========== 2.2.5 样本编码 ==========
-DROP TABLE IF EXISTS `biz_sample_code`;
-CREATE TABLE `biz_sample_code` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `sample_code` VARCHAR(32) NOT NULL COMMENT '样本编码',
-  `issued` TINYINT NOT NULL DEFAULT 0 COMMENT '是否下发（1是 0否）',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_sample_code` (`tenant_no`, `sample_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='样本编码池';
-
--- ========== 2.2.6 采集协议单及子表 ==========
-DROP TABLE IF EXISTS `biz_protocol_operation_log`;
-DROP TABLE IF EXISTS `biz_protocol_storage_cert`;
-DROP TABLE IF EXISTS `biz_protocol_fullmoon_todo`;
-DROP TABLE IF EXISTS `biz_protocol_audit`;
-DROP TABLE IF EXISTS `biz_protocol_party_customer`;
-DROP TABLE IF EXISTS `biz_protocol_payment_detail`;
-DROP TABLE IF EXISTS `biz_protocol_payment`;
-DROP TABLE IF EXISTS `biz_protocol_sample_transport`;
-DROP TABLE IF EXISTS `biz_protocol_sample`;
-DROP TABLE IF EXISTS `biz_protocol_collection_info`;
-DROP TABLE IF EXISTS `biz_collection_protocol`;
-
-CREATE TABLE `biz_collection_protocol` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `protocol_no_id` VARCHAR(64) DEFAULT NULL COMMENT '采集协议号表ID（选用号段）',
-  `protocol_no` VARCHAR(32) NOT NULL COMMENT '采集协议号展示',
-  `protocol_status` VARCHAR(16) NOT NULL DEFAULT 'dsx' COMMENT 'dsx待生效 sxz生效中 ygq已过期 yzf已作废 zky转科研',
-  `protocol_attachments` VARCHAR(4000) DEFAULT NULL COMMENT '协议附件 minio 地址逗号分隔',
-  `register_date` CHAR(8) DEFAULT NULL COMMENT '登记日期YYYYMMDD',
-  `effective_time` DATETIME DEFAULT NULL COMMENT '协议生效时间',
-  `effective_desc` VARCHAR(512) DEFAULT NULL COMMENT '协议生效描述',
-  `expire_time` DATETIME DEFAULT NULL COMMENT '协议过期时间',
-  `expire_desc` VARCHAR(512) DEFAULT NULL COMMENT '协议过期描述',
-  `void_time` DATETIME DEFAULT NULL COMMENT '协议作废时间',
-  `void_desc` VARCHAR(512) DEFAULT NULL COMMENT '协议作废描述',
-  `to_research_time` DATETIME DEFAULT NULL COMMENT '协议转科研时间',
-  `to_research_desc` VARCHAR(512) DEFAULT NULL COMMENT '协议转科研描述',
-  `collector_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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_cp_status` (`tenant_no`, `protocol_status`, `del_flag`),
-  KEY `idx_cp_no` (`tenant_no`, `protocol_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单';
-
-CREATE TABLE `biz_protocol_collection_info` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `region_id` VARCHAR(64) DEFAULT NULL COMMENT '采集地区ID',
-  `hospital_id` VARCHAR(64) DEFAULT NULL COMMENT '采集医院ID',
-  `medical_staff` VARCHAR(200) DEFAULT NULL COMMENT '采集医护',
-  `sales_user_id` VARCHAR(64) DEFAULT NULL COMMENT '销售人员用户ID',
-  `sample_collect_time` DATETIME DEFAULT NULL COMMENT '样本采集时间',
-  `maternal_blood_collect_time` DATETIME 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_coll_one` (`collection_protocol_id`, `del_flag`),
-  KEY `idx_coll_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-采集信息';
-
-CREATE TABLE `biz_protocol_sample` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `sample_type_id` VARCHAR(64) DEFAULT NULL COMMENT '样本类型ID',
-  `sample_code_id` VARCHAR(64) DEFAULT NULL COMMENT '样本编码表ID',
-  `sample_code` VARCHAR(32) DEFAULT NULL COMMENT '样本编码展示',
-  `collect_amount` DECIMAL(18,4) DEFAULT NULL COMMENT '采集量',
-  `unit_id` VARCHAR(64) DEFAULT NULL COMMENT '物品单位ID',
-  `price` DECIMAL(18,2) DEFAULT NULL COMMENT '价格',
-  `storage_years` INT DEFAULT NULL COMMENT '存储年限（年）',
-  `sample_status` VARCHAR(16) NOT NULL DEFAULT 'ycj' COMMENT 'ycj已采集 jcz检测中 yrk已入库 yzf已作废',
-  `storage_in_date` CHAR(8) DEFAULT NULL COMMENT '入库日期YYYYMMDD',
-  `detect_start_date` CHAR(8) DEFAULT NULL COMMENT '检测开始日期',
-  `void_date` CHAR(8) DEFAULT NULL COMMENT '作废日期',
-  `storage_expire_date` CHAR(8) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_sample_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-样本信息';
-
-CREATE TABLE `biz_protocol_sample_transport` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `sample_id` VARCHAR(64) NOT NULL COMMENT '样本ID',
-  `transport_type` VARCHAR(16) NOT NULL COMMENT 'kdys快递运输 ryxd人员携带',
-  `express_company_id` VARCHAR(64) DEFAULT NULL COMMENT '快递公司ID',
-  `waybill_no` VARCHAR(128) DEFAULT NULL COMMENT '快递单号',
-  `dest_site_id` VARCHAR(64) DEFAULT NULL COMMENT '目的站点ID',
-  `express_fee` DECIMAL(18,2) DEFAULT NULL COMMENT '快递费用（元）',
-  `eta_time` DATETIME DEFAULT NULL COMMENT '预计到达时间',
-  `carrier_name` VARCHAR(100) DEFAULT NULL COMMENT '携带人员姓名',
-  `carrier_phone` VARCHAR(32) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_transport_sample` (`sample_id`, `del_flag`),
-  KEY `idx_transport_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-样本运输';
-
-CREATE TABLE `biz_protocol_payment` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `pay_mode` VARCHAR(8) NOT NULL COMMENT 'dj趸交 fq分期',
-  `contract_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '合同金额',
-  `installment_count` INT DEFAULT NULL COMMENT '分期期数',
-  `installment_interval_months` INT DEFAULT NULL COMMENT '每期间隔（月）',
-  `lump_sum_deadline` CHAR(8) DEFAULT NULL COMMENT '趸交截止时间YYYYMMDD',
-  `installment_start_date` CHAR(8) DEFAULT NULL COMMENT '分期开始时间YYYYMMDD',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_payment_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-缴费主表';
-
-CREATE TABLE `biz_protocol_payment_detail` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `payment_id` VARCHAR(64) NOT NULL COMMENT '缴费主表ID',
-  `transfer_type` VARCHAR(16) DEFAULT NULL COMMENT 'wxzz微信 zzbzz支付宝 yhkzz银行卡 xj现金',
-  `transfer_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '转账金额',
-  `transfer_time` DATETIME DEFAULT NULL COMMENT '转账时间',
-  `transfer_attachments` VARCHAR(4000) DEFAULT NULL COMMENT '转账附件逗号分隔',
-  `finance_confirm_attachments` VARCHAR(4000) DEFAULT NULL COMMENT '财务确认附件逗号分隔',
-  `pay_status` VARCHAR(32) NOT NULL DEFAULT 'dfj' COMMENT 'dfj待缴费 jfqrz缴费确认中 yjf已缴费 tfqrz退费确认中 ytf已退费',
-  `installment_no` INT DEFAULT NULL COMMENT '分期期序号，趸交为空',
-  `installment_due_date` CHAR(8) DEFAULT NULL COMMENT '分期应缴费时间YYYYMMDD',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_payd_pay` (`payment_id`, `del_flag`),
-  KEY `idx_payd_status` (`tenant_no`, `pay_status`, `del_flag`),
-  KEY `idx_payd_due` (`installment_due_date`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-缴费明细';
-
-CREATE TABLE `biz_protocol_party_customer` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `customer_id` VARCHAR(64) DEFAULT NULL COMMENT '关联客户表 customer',
-  `mother_name` VARCHAR(100) DEFAULT NULL COMMENT '母亲姓名',
-  `mother_phone` VARCHAR(32) DEFAULT NULL COMMENT '母亲联系电话',
-  `mother_id_card` VARCHAR(32) DEFAULT NULL COMMENT '母亲身份证号',
-  `mother_birth_ym` CHAR(6) DEFAULT NULL COMMENT '母亲出生年月YYYYMM',
-  `mother_ethnic` VARCHAR(32) DEFAULT NULL COMMENT '母亲民族',
-  `mother_address` VARCHAR(512) DEFAULT NULL COMMENT '母亲家庭住址',
-  `father_name` VARCHAR(100) DEFAULT NULL COMMENT '父亲姓名',
-  `father_phone` VARCHAR(32) DEFAULT NULL COMMENT '父亲电话',
-  `father_id_card` VARCHAR(32) DEFAULT NULL COMMENT '父亲身份证号',
-  `newborn_delivery_time` DATETIME DEFAULT NULL COMMENT '新生儿分娩时间',
-  `newborn_sex` CHAR(1) DEFAULT NULL COMMENT '1男 0女',
-  `delivery_mode` VARCHAR(16) DEFAULT NULL COMMENT 'sc顺产 pgc剖宫产',
-  `birth_order` INT DEFAULT NULL COMMENT '胎次',
-  `newborn_weight_gram` INT DEFAULT NULL COMMENT '新生儿体重（克）',
-  `apgar_1min` INT DEFAULT NULL COMMENT '新生儿评分1分钟',
-  `apgar_5min` INT DEFAULT NULL COMMENT '新生儿评分5分钟',
-  `collector_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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_party_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-当事人/产妇新生儿信息';
-
-CREATE TABLE `biz_protocol_audit` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `auditor_user_id` VARCHAR(64) DEFAULT NULL COMMENT '审核人',
-  `audit_remark` VARCHAR(1000) DEFAULT NULL COMMENT '审核备注',
-  `audit_status` VARCHAR(16) NOT NULL COMMENT 'shtg审核通过 shth审核退回',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_audit_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-审核记录';
-
-CREATE TABLE `biz_protocol_fullmoon_todo` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `todo_status` CHAR(1) NOT NULL DEFAULT '0' COMMENT '1已办报销 0未办保险',
-  `handle_date` CHAR(8) DEFAULT NULL COMMENT '办理日期',
-  `handle_remark` VARCHAR(512) DEFAULT NULL COMMENT '办理备注',
-  `insurance_attachments` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_fullmoon_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='新生儿满月待办';
-
-CREATE TABLE `biz_protocol_storage_cert` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `make_status` CHAR(1) NOT NULL DEFAULT '0' COMMENT '1已制作 0未制作',
-  `cert_image_urls` VARCHAR(4000) DEFAULT NULL COMMENT '储存证图片逗号分隔',
-  `make_date` CHAR(8) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_cert_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='储存证';
-
-CREATE TABLE `biz_protocol_operation_log` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `collection_protocol_id` VARCHAR(64) NOT NULL COMMENT '采集协议单ID',
-  `operation_code` VARCHAR(64) NOT NULL COMMENT '操作编码',
-  `operation_name` VARCHAR(200) NOT NULL COMMENT '操作名称',
-  `operation_detail` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_oplog_cp` (`collection_protocol_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单操作日志';
-
--- ========== 2.3 中试服务：细胞产品与价格体系 ==========
-DROP TABLE IF EXISTS `biz_cell_product_project_system_item`;
-DROP TABLE IF EXISTS `biz_cell_product_project_system`;
-DROP TABLE IF EXISTS `biz_cell_product_price`;
-DROP TABLE IF EXISTS `biz_cell_product_spec`;
-DROP TABLE IF EXISTS `biz_cell_product_type`;
-
-CREATE TABLE `biz_cell_product_type` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `product_type_code` VARCHAR(64) NOT NULL COMMENT '细胞产品类型编码',
-  `product_type_name` VARCHAR(200) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_cpt` (`tenant_no`, `product_type_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品类型';
-
-CREATE TABLE `biz_cell_product_spec` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `spec_code` VARCHAR(64) NOT NULL COMMENT '规格编码',
-  `spec_name` VARCHAR(200) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_cps` (`tenant_no`, `spec_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品规格';
-
-CREATE TABLE `biz_cell_product_price` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `project_name` VARCHAR(200) NOT NULL COMMENT '项目名称',
-  `project_code` VARCHAR(64) NOT NULL COMMENT '项目编码',
-  `cell_type_code` VARCHAR(64) DEFAULT NULL COMMENT '细胞类型编码',
-  `cell_type_name` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型名称',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格（展示或关联规格编码）',
-  `spec_id` VARCHAR(64) DEFAULT NULL COMMENT '规格ID',
-  `cell_product_type_id` VARCHAR(64) DEFAULT NULL COMMENT '细胞产品类型ID',
-  `unit_price` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_cpp_tenant` (`tenant_no`, `del_flag`),
-  KEY `idx_cpp_code` (`tenant_no`, `project_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品价格体系';
-
-CREATE TABLE `biz_cell_product_project_system` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `system_name` VARCHAR(200) NOT NULL COMMENT '体系名称',
-  `system_code` VARCHAR(64) NOT NULL COMMENT '体系编码',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '1正常 0停用',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_cpps` (`tenant_no`, `system_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品项目价格体系';
-
-CREATE TABLE `biz_cell_product_project_system_item` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `project_system_id` VARCHAR(64) NOT NULL COMMENT '项目价格体系ID',
-  `source_price_id` VARCHAR(64) DEFAULT NULL COMMENT '来源细胞产品价格体系行ID',
-  `project_name` VARCHAR(200) DEFAULT NULL COMMENT '项目名称',
-  `project_code` VARCHAR(64) DEFAULT NULL COMMENT '项目编码',
-  `cell_type_code` VARCHAR(64) DEFAULT NULL COMMENT '细胞类型编码',
-  `cell_type_name` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型名称',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格',
-  `spec_id` VARCHAR(64) DEFAULT NULL COMMENT '规格ID',
-  `cell_product_type_id` VARCHAR(64) DEFAULT NULL COMMENT '细胞产品类型ID',
-  `unit_price` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_cppsi_sys` (`project_system_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目价格体系-细胞价格明细';
-
--- ========== 2.3.5 渠道及子表 ==========
-DROP TABLE IF EXISTS `biz_channel_agreement_product_price`;
-DROP TABLE IF EXISTS `biz_channel_agreement`;
-DROP TABLE IF EXISTS `biz_channel_mail_address`;
-DROP TABLE IF EXISTS `biz_channel_invoice`;
-DROP TABLE IF EXISTS `biz_channel`;
-
-CREATE TABLE `biz_channel` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_name` VARCHAR(200) NOT NULL COMMENT '渠道名称',
-  `credit_code` VARCHAR(64) DEFAULT NULL COMMENT '统一社会信用代码',
-  `channel_type` VARCHAR(16) DEFAULT NULL COMMENT 'yy医院 hzjg合作机构 zs诊所 zfjg政府机构 qt其他',
-  `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人姓名',
-  `contact_phone` VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
-  `contact_email` VARCHAR(128) DEFAULT NULL COMMENT '联系邮箱',
-  `protocol_attachments` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_channel_tenant` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道信息';
-
-CREATE TABLE `biz_channel_invoice` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_id` VARCHAR(64) NOT NULL COMMENT '渠道ID',
-  `company_name` VARCHAR(200) NOT NULL COMMENT '单位名称',
-  `tax_no` VARCHAR(64) DEFAULT NULL COMMENT '税号',
-  `company_address` VARCHAR(512) DEFAULT NULL COMMENT '单位地址',
-  `company_phone` VARCHAR(64) DEFAULT NULL COMMENT '电话',
-  `bank_name` VARCHAR(200) DEFAULT NULL COMMENT '开户银行',
-  `bank_account` VARCHAR(64) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ch_inv_channel` (`channel_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道开票信息';
-
-CREATE TABLE `biz_channel_mail_address` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_id` VARCHAR(64) NOT NULL COMMENT '渠道ID',
-  `mail_address` VARCHAR(512) NOT NULL COMMENT '邮寄地址',
-  `mail_contact` VARCHAR(100) DEFAULT NULL COMMENT '邮寄联系人',
-  `mail_phone` VARCHAR(32) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ch_mail_channel` (`channel_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道邮寄地址';
-
-CREATE TABLE `biz_channel_agreement` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_id` VARCHAR(64) NOT NULL COMMENT '渠道ID',
-  `agreement_type` VARCHAR(16) NOT NULL COMMENT 'kyxy科研 zsxy中试 lcxy临床',
-  `business_type` VARCHAR(32) DEFAULT NULL COMMENT 'kyyy科研应用/中试应用/临床应用（随协议类型）',
-  `settle_mode` VARCHAR(16) DEFAULT NULL COMMENT 'yj月结 jj季结 nj年结 dcjs单次结算',
-  `credit_limit_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '授信额度（元）',
-  `effective_date` CHAR(8) DEFAULT NULL COMMENT '生效日期YYYYMMDD',
-  `expire_date` CHAR(8) DEFAULT NULL COMMENT '到期日期YYYYMMDD',
-  `agreement_status` VARCHAR(16) NOT NULL DEFAULT 'sxz' COMMENT 'sxz生效中 yzf已作废',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ch_agr_channel` (`channel_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道协议';
-
-CREATE TABLE `biz_channel_agreement_product_price` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_agreement_id` VARCHAR(64) NOT NULL COMMENT '渠道协议ID',
-  `project_name` VARCHAR(200) DEFAULT NULL COMMENT '项目名称',
-  `project_code` VARCHAR(64) DEFAULT NULL COMMENT '项目编码',
-  `cell_type_code` VARCHAR(64) DEFAULT NULL COMMENT '细胞类型编码',
-  `cell_type_name` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型名称',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格',
-  `original_price` DECIMAL(18,2) DEFAULT NULL COMMENT '原价（元）',
-  `agreement_price` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_cap_agr` (`channel_agreement_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道协议-细胞产品价格';
-
--- ========== 2.3.6 体检机构 ==========
-DROP TABLE IF EXISTS `biz_checkup_institution_project`;
-DROP TABLE IF EXISTS `biz_checkup_institution_invoice`;
-DROP TABLE IF EXISTS `biz_checkup_institution`;
-
-CREATE TABLE `biz_checkup_institution` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `institution_name` VARCHAR(200) NOT NULL COMMENT '体检机构名称',
-  `institution_address` VARCHAR(512) DEFAULT NULL COMMENT '体检机构地址',
-  `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人',
-  `contact_phone` VARCHAR(32) DEFAULT NULL COMMENT '联系人电话',
-  `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '1正常 0停用',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ck_inst` (`tenant_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构';
-
-CREATE TABLE `biz_checkup_institution_invoice` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `checkup_institution_id` VARCHAR(64) NOT NULL COMMENT '体检机构ID',
-  `company_name` VARCHAR(200) NOT NULL COMMENT '单位名称',
-  `tax_no` VARCHAR(64) DEFAULT NULL COMMENT '税号',
-  `company_address` VARCHAR(512) DEFAULT NULL COMMENT '单位地址',
-  `company_phone` VARCHAR(64) DEFAULT NULL COMMENT '电话',
-  `bank_name` VARCHAR(200) DEFAULT NULL COMMENT '开户银行',
-  `bank_account` VARCHAR(64) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ck_inv` (`checkup_institution_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构开票信息';
-
-CREATE TABLE `biz_checkup_institution_project` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `checkup_institution_id` VARCHAR(64) NOT NULL COMMENT '体检机构ID',
-  `project_name` VARCHAR(200) NOT NULL COMMENT '项目名称',
-  `project_fee` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_ck_proj` (`checkup_institution_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构项目及价格';
-
--- ========== 2.3.7 / 2.3.8 渠道服务购买订单及财务确认 ==========
-DROP TABLE IF EXISTS `biz_channel_service_order_finance_confirm`;
-DROP TABLE IF EXISTS `biz_channel_service_order_product`;
-DROP TABLE IF EXISTS `biz_channel_service_order`;
-
-CREATE TABLE `biz_channel_service_order` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_id` VARCHAR(64) NOT NULL COMMENT '渠道ID',
-  `channel_name` VARCHAR(200) DEFAULT NULL COMMENT '渠道名称冗余',
-  `dept_name` VARCHAR(200) DEFAULT NULL COMMENT '科室/部门',
-  `order_type` VARCHAR(16) NOT NULL COMMENT 'yfk预付款 gmcp购买产品',
-  `prepay_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '预付金额（订单类型yfk）',
-  `purchase_total_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '购买总金额（订单类型gmcp）',
-  `order_status` VARCHAR(16) NOT NULL DEFAULT 'sxz' COMMENT 'sxz生效中 yzf已作废',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_cso_channel` (`channel_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单';
-
-CREATE TABLE `biz_channel_service_order_product` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `service_order_id` VARCHAR(64) NOT NULL COMMENT '渠道服务购买订单ID',
-  `project_code` VARCHAR(64) DEFAULT NULL COMMENT '项目编码',
-  `project_name` VARCHAR(200) DEFAULT NULL COMMENT '项目名称',
-  `cell_type` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格',
-  `agreement_unit_price` DECIMAL(18,2) DEFAULT NULL COMMENT '协议单价',
-  `buy_qty` DECIMAL(18,4) DEFAULT NULL COMMENT '购买数量',
-  `buy_amount` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_csop_order` (`service_order_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单-产品明细';
-
-CREATE TABLE `biz_channel_service_order_finance_confirm` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `service_order_id` VARCHAR(64) NOT NULL COMMENT '渠道服务购买订单ID',
-  `confirm_time` DATETIME DEFAULT NULL COMMENT '确认时间',
-  `confirm_desc` VARCHAR(2000) DEFAULT NULL COMMENT '确认描述',
-  `confirm_attachments` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_csofc_order` (`service_order_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单-财务确认';
-
--- ========== 2.3.9 中试申请单及嵌套子表 ==========
-DROP TABLE IF EXISTS `biz_pilot_checkup_actual_item`;
-DROP TABLE IF EXISTS `biz_pilot_checkup_reserve_item`;
-DROP TABLE IF EXISTS `biz_pilot_checkup`;
-DROP TABLE IF EXISTS `biz_pilot_delivery_method`;
-DROP TABLE IF EXISTS `biz_pilot_delivery_material`;
-DROP TABLE IF EXISTS `biz_pilot_delivery`;
-DROP TABLE IF EXISTS `biz_pilot_infusion_confirm`;
-DROP TABLE IF EXISTS `biz_pilot_infusion_schedule`;
-DROP TABLE IF EXISTS `biz_pilot_infusion_plan`;
-DROP TABLE IF EXISTS `biz_pilot_patient`;
-DROP TABLE IF EXISTS `biz_pilot_application`;
-
-CREATE TABLE `biz_pilot_application` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `channel_service_order_id` VARCHAR(64) NOT 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pilot_app_order` (`channel_service_order_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道中试服务申请单';
-
-CREATE TABLE `biz_pilot_patient` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `pilot_application_id` VARCHAR(64) NOT NULL COMMENT '中试申请单ID',
-  `customer_id` VARCHAR(64) DEFAULT NULL COMMENT '关联客户ID',
-  `patient_name` VARCHAR(100) DEFAULT NULL COMMENT '姓名',
-  `sex` CHAR(1) DEFAULT NULL COMMENT '性别',
-  `age` INT DEFAULT NULL COMMENT '年龄',
-  `id_card_no` VARCHAR(32) DEFAULT NULL COMMENT '身份证号',
-  `phone_no` VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
-  `emergency_contact` VARCHAR(100) DEFAULT NULL COMMENT '紧急联系人',
-  `emergency_phone` VARCHAR(32) DEFAULT NULL COMMENT '紧急联系人电话',
-  `clinical_diagnosis` VARCHAR(2000) DEFAULT NULL COMMENT '临床诊断',
-  `diagnosis_attachments` VARCHAR(4000) DEFAULT NULL COMMENT '诊断附件逗号分隔',
-  `need_checkup` TINYINT NOT NULL DEFAULT 1 COMMENT '是否需要体检 1需要 0不需要',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_pilot_patient_app` (`pilot_application_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-患者信息';
-
-CREATE TABLE `biz_pilot_infusion_plan` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `pilot_application_id` VARCHAR(64) NOT NULL COMMENT '中试申请单ID',
-  `cell_type` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格',
-  `total_course_count` INT DEFAULT NULL COMMENT '总疗程数',
-  `course_interval` VARCHAR(200) DEFAULT NULL COMMENT '疗程间隔描述',
-  `infusion_route` VARCHAR(200) DEFAULT NULL COMMENT '输注途径',
-  `infusion_start_date` CHAR(8) DEFAULT NULL COMMENT '输注开始日期YYYYMMDD',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pip_app` (`pilot_application_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-输注方案';
-
-CREATE TABLE `biz_pilot_infusion_schedule` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `infusion_plan_id` VARCHAR(64) NOT NULL COMMENT '输注方案ID',
-  `cell_type` VARCHAR(200) DEFAULT NULL COMMENT '细胞类型',
-  `spec_text` VARCHAR(200) DEFAULT NULL COMMENT '规格',
-  `infusion_time` DATETIME DEFAULT NULL COMMENT '输注时间',
-  `schedule_status` VARCHAR(16) NOT NULL DEFAULT 'dsc' COMMENT 'dsc待生产 ysc已生产 yjf已交付 yqx已取消',
-  `attachments` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pis_plan` (`infusion_plan_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-输注计划';
-
-CREATE TABLE `biz_pilot_infusion_confirm` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `infusion_schedule_id` VARCHAR(64) NOT NULL COMMENT '输注计划ID',
-  `confirm_user_id` VARCHAR(64) DEFAULT NULL COMMENT '确认人',
-  `confirm_time` DATETIME DEFAULT NULL COMMENT '确认时间',
-  `confirm_desc` VARCHAR(2000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_pic_sched` (`infusion_schedule_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='输注计划-应用确认';
-
-CREATE TABLE `biz_pilot_delivery` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `infusion_schedule_id` VARCHAR(64) NOT NULL COMMENT '输注计划ID',
-  `delivery_no` VARCHAR(64) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_pdel_sched` (`infusion_schedule_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='输注计划-交付信息';
-
-CREATE TABLE `biz_pilot_delivery_material` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `delivery_id` VARCHAR(64) NOT NULL COMMENT '交付信息ID',
-  `material_name` VARCHAR(200) NOT NULL COMMENT '物料名称',
-  `qty` DECIMAL(18,4) DEFAULT NULL COMMENT '数量',
-  `unit_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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pdm_del` (`delivery_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='交付信息-物料清单';
-
-CREATE TABLE `biz_pilot_delivery_method` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `delivery_id` VARCHAR(64) NOT NULL COMMENT '交付信息ID',
-  `delivery_mode` VARCHAR(16) NOT NULL COMMENT 'qdzt渠道自提 kdfh快递发货',
-  `delivery_attachments` VARCHAR(4000) DEFAULT NULL COMMENT '交付附件',
-  `ship_time` DATETIME DEFAULT NULL COMMENT '发运时间',
-  `handover_temp` VARCHAR(64) DEFAULT NULL COMMENT '交接温度',
-  `pickup_person` VARCHAR(100) DEFAULT NULL COMMENT '自提人员',
-  `pickup_phone` VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
-  `sender_name` VARCHAR(100) DEFAULT NULL COMMENT '发货人',
-  `express_company_id` VARCHAR(64) DEFAULT NULL COMMENT '快递公司ID',
-  `waybill_no` VARCHAR(128) DEFAULT NULL COMMENT '快递单号',
-  `express_fee` DECIMAL(18,2) DEFAULT NULL COMMENT '快递费用',
-  `eta_time` DATETIME 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_pdmeth_del` (`delivery_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='交付信息-交付方式';
-
-CREATE TABLE `biz_pilot_checkup` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `pilot_application_id` VARCHAR(64) NOT NULL COMMENT '中试申请单ID',
-  `checkup_institution_id` VARCHAR(64) DEFAULT NULL COMMENT '体检机构ID',
-  `reserve_time` DATETIME DEFAULT NULL COMMENT '预约时间',
-  `reserve_fee` DECIMAL(18,2) DEFAULT NULL COMMENT '预约费用',
-  `actual_checkup_time` DATETIME DEFAULT NULL COMMENT '实际体检时间',
-  `actual_checkup_fee` DECIMAL(18,2) DEFAULT NULL COMMENT '实际体检费用',
-  `fee_settled` TINYINT DEFAULT 0 COMMENT '费用是否结算 1是 0否',
-  `checkup_status` VARCHAR(16) DEFAULT 'dtj' COMMENT 'dtj待体检 ytj已体检',
-  `fee_status` VARCHAR(16) DEFAULT 'wjs' COMMENT 'wjs未结算 yjs已结算',
-  `checkup_remark` VARCHAR(2000) DEFAULT NULL COMMENT '体检备注',
-  `report_attachments` VARCHAR(4000) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pchk_app` (`pilot_application_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-体检信息';
-
-CREATE TABLE `biz_pilot_checkup_reserve_item` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `pilot_checkup_id` VARCHAR(64) NOT NULL COMMENT '中试申请单体检信息ID',
-  `project_name` VARCHAR(200) DEFAULT NULL COMMENT '项目名称',
-  `project_fee` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pcri_chk` (`pilot_checkup_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检预约项目明细';
-
-CREATE TABLE `biz_pilot_checkup_actual_item` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `pilot_checkup_id` VARCHAR(64) NOT NULL COMMENT '中试申请单体检信息ID',
-  `project_name` VARCHAR(200) DEFAULT NULL COMMENT '项目名称',
-  `project_fee` DECIMAL(18,2) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_pcai_chk` (`pilot_checkup_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检实际项目明细';
-
--- ========== 2.4 运营支撑 ==========
-DROP TABLE IF EXISTS `biz_clean_room_access_log`;
-DROP TABLE IF EXISTS `biz_clean_room`;
-CREATE TABLE `biz_clean_room` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `room_code` VARCHAR(64) NOT NULL COMMENT '编号',
-  `room_name` VARCHAR(200) NOT NULL COMMENT '名称',
-  `room_grade` VARCHAR(8) DEFAULT NULL COMMENT '等级 A/B/C/D',
-  `room_status` VARCHAR(16) NOT NULL DEFAULT 'zc' COMMENT 'zc正常 yc异常',
-  `area_sqm` DECIMAL(12,2) DEFAULT NULL COMMENT '面积m²',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_clean_code` (`tenant_no`, `room_code`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='洁净室信息';
-
-CREATE TABLE `biz_clean_room_access_log` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `clean_room_id` VARCHAR(64) NOT NULL COMMENT '洁净室ID',
-  `user_id` VARCHAR(64) DEFAULT NULL COMMENT '人员用户ID',
-  `person_name` VARCHAR(100) DEFAULT NULL COMMENT '人员姓名（冗余）',
-  `dept_name` VARCHAR(200) DEFAULT NULL COMMENT '部门',
-  `enter_time` DATETIME NOT NULL COMMENT '进入时间',
-  `purpose` VARCHAR(512) DEFAULT NULL COMMENT '目的',
-  `leave_time` DATETIME DEFAULT NULL COMMENT '离开时间',
-  `body_temp` VARCHAR(32) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_crlog_room` (`clean_room_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='洁净室人员进出';
-
-DROP TABLE IF EXISTS `biz_storage_facility_slot`;
-DROP TABLE IF EXISTS `biz_storage_facility`;
-CREATE TABLE `biz_storage_facility` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `parent_id` VARCHAR(64) NOT NULL DEFAULT '0' COMMENT '父节点ID，0根',
-  `node_name` VARCHAR(200) NOT NULL COMMENT '节点名称（罐/层/盒等）',
-  `node_type` VARCHAR(32) DEFAULT NULL COMMENT 'facility/layer/box 等扩展',
-  `is_leaf` TINYINT NOT NULL DEFAULT 0 COMMENT '是否叶子存储位 1是',
-  `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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_sf_parent` (`parent_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞存储设施树节点';
-
-CREATE TABLE `biz_storage_facility_slot` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `facility_node_id` VARCHAR(64) NOT NULL COMMENT '设施树叶子节点ID',
-  `slot_code` VARCHAR(64) DEFAULT NULL COMMENT '小格编码/坐标',
-  `slot_status` VARCHAR(16) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  KEY `idx_sfs_node` (`facility_node_id`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞存储设施储存位置（格子）';
-
-DROP TABLE IF EXISTS `biz_exhibition_appointment`;
-CREATE TABLE `biz_exhibition_appointment` (
-  `id` VARCHAR(64) NOT NULL COMMENT '主键ID',
-  `appointment_no` VARCHAR(64) NOT NULL COMMENT '预约编号',
-  `visit_org` VARCHAR(200) DEFAULT NULL COMMENT '来访单位',
-  `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人',
-  `visit_date` CHAR(8) DEFAULT NULL COMMENT '到访日期YYYYMMDD',
-  `visitor_count` INT DEFAULT NULL COMMENT '人数',
-  `reception_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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id',
-  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-  `del_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0-正常 1-已删除',
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_exh_no` (`tenant_no`, `appointment_no`, `del_flag`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='展馆预约';
-
-SET FOREIGN_KEY_CHECKS = 1;
-
--- -----------------------------------------------------------------------------
--- 可选：租户与字典种子（可重复执行：不存在才插入）
--- -----------------------------------------------------------------------------
-INSERT INTO `sys_tenant` (`id`, `tenant_no`, `tenant_name`, `contact_name`, `contact_phone`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), 'zkxw', '中科兴皖', NULL, NULL, '', 0
-FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_tenant` `t` WHERE `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-
-INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '组织类别', 'zzlbbm', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_type` `t` WHERE `t`.`dict_type` = 'zzlbbm' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '站点类型', 'zdlx', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_type` `t` WHERE `t`.`dict_type` = 'zdlx' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '站点业务范围', 'zdywfw', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_type` `t` WHERE `t`.`dict_type` = 'zdywfw' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '部门状态', 'bmzt', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_type` `t` WHERE `t`.`dict_type` = 'bmzt' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '公司', 'gs', 'zzlbbm', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zzlbbm' AND `t`.`dict_value` = 'gs' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '分公司', 'fgs', 'zzlbbm', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zzlbbm' AND `t`.`dict_value` = 'fgs' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '部门', 'bm', 'zzlbbm', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zzlbbm' AND `t`.`dict_value` = 'bm' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '中心基地', 'zxjd', 'zdlx', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zdlx' AND `t`.`dict_value` = 'zxjd' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '样本采集', 'ybcj', 'zdywfw', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zdywfw' AND `t`.`dict_value` = 'ybcj' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '样本制备', 'ybzb', 'zdywfw', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zdywfw' AND `t`.`dict_value` = 'ybzb' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '质量检测', 'zljc', 'zdywfw', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zdywfw' AND `t`.`dict_value` = 'zljc' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '细胞存储', 'xbcc', 'zdywfw', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'zdywfw' AND `t`.`dict_value` = 'xbcc' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '停用', '0', 'bmzt', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'bmzt' AND `t`.`dict_value` = '0' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
-INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `create_dept_id`, `del_flag`)
-SELECT REPLACE(UUID(), '-', ''), '正常', '1', 'bmzt', 'zkxw', '', 0 FROM (SELECT 1 AS `x`) `d`
-WHERE NOT EXISTS (SELECT 1 FROM `sys_dict_data` `t` WHERE `t`.`dict_type` = 'bmzt' AND `t`.`dict_value` = '1' AND `t`.`tenant_no` = 'zkxw' AND `t`.`del_flag` = 0 LIMIT 1);
diff --git a/docs/sql/zkxw.sql b/docs/sql/zkxw.sql
new file mode 100644
index 00000000..fe805ed3
--- /dev/null
+++ b/docs/sql/zkxw.sql
@@ -0,0 +1,2550 @@
+/*
+ Navicat Premium Dump SQL
+
+ Source Server         : 47.99.164.66  hn02le.34lkdLKD
+ Source Server Type    : MySQL
+ Source Server Version : 50736 (5.7.36)
+ Source Host           : 47.99.164.66:3306
+ Source Schema         : zkxw
+
+ Target Server Type    : MySQL
+ Target Server Version : 50736 (5.7.36)
+ File Encoding         : 65001
+
+ Date: 14/05/2026 10:09:33
+*/
+
+SET NAMES utf8mb4;
+SET FOREIGN_KEY_CHECKS = 0;
+
+-- ----------------------------
+-- Table structure for biz_cell_product_price
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_product_price`;
+CREATE TABLE `biz_cell_product_price` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '项目名称',
+  `project_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '项目编码',
+  `cell_type_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型编码',
+  `cell_type_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型名称',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格（展示或关联规格编码）',
+  `spec_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格ID',
+  `cell_product_type_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞产品类型ID',
+  `unit_price` decimal(18,2) DEFAULT NULL COMMENT '单价（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_cpp_tenant` (`tenant_no`,`del_flag`),
+  KEY `idx_cpp_code` (`tenant_no`,`project_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品价格体系';
+
+-- ----------------------------
+-- Records of biz_cell_product_price
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_cell_product_project_system
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_product_project_system`;
+CREATE TABLE `biz_cell_product_project_system` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `system_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '体系名称',
+  `system_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '体系编码',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '1正常 0停用',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_cpps` (`tenant_no`,`system_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品项目价格体系';
+
+-- ----------------------------
+-- Records of biz_cell_product_project_system
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_cell_product_project_system_item
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_product_project_system_item`;
+CREATE TABLE `biz_cell_product_project_system_item` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `project_system_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '项目价格体系ID',
+  `source_price_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '来源细胞产品价格体系行ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
+  `project_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目编码',
+  `cell_type_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型编码',
+  `cell_type_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型名称',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格',
+  `spec_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格ID',
+  `cell_product_type_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞产品类型ID',
+  `unit_price` decimal(18,2) DEFAULT NULL COMMENT '单价（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_cppsi_sys` (`project_system_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目价格体系-细胞价格明细';
+
+-- ----------------------------
+-- Records of biz_cell_product_project_system_item
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_cell_product_spec
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_product_spec`;
+CREATE TABLE `biz_cell_product_spec` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `spec_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '规格编码',
+  `spec_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '规格名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_cps` (`tenant_no`,`spec_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品规格';
+
+-- ----------------------------
+-- Records of biz_cell_product_spec
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_cell_product_type
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_product_type`;
+CREATE TABLE `biz_cell_product_type` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `product_type_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '细胞产品类型编码',
+  `product_type_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '细胞产品类型名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_cpt` (`tenant_no`,`product_type_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞产品类型';
+
+-- ----------------------------
+-- Records of biz_cell_product_type
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_cell_sample_type
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_cell_sample_type`;
+CREATE TABLE `biz_cell_sample_type` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `type_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '样本类型编码',
+  `type_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '样本类型名称',
+  `storage_years` int(11) DEFAULT NULL COMMENT '样本存储年份',
+  `storage_price` decimal(18,2) DEFAULT NULL COMMENT '样本存储价格（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_sample_type` (`tenant_no`,`type_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞样本类型';
+
+-- ----------------------------
+-- Records of biz_cell_sample_type
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_cell_sample_type` (`id`, `type_code`, `type_name`, `storage_years`, `storage_price`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b3000000000000000000000000000001', 'PBSC', '外周血造血干细胞', 20, 19800.00, 'zkxw', 1, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `biz_cell_sample_type` (`id`, `type_code`, `type_name`, `storage_years`, `storage_price`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b3000000000000000000000000000002', 'UCB', '脐带血', 18, 16800.00, 'zkxw', 2, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `biz_cell_sample_type` (`id`, `type_code`, `type_name`, `storage_years`, `storage_price`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b3000000000000000000000000000003', 'ADSC', '脂肪间充质干细胞', 10, 12800.00, 'zkxw', 3, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel`;
+CREATE TABLE `biz_channel` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道名称',
+  `credit_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '统一社会信用代码',
+  `channel_type` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'yy医院 hzjg合作机构 zs诊所 zfjg政府机构 qt其他',
+  `contact_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人姓名',
+  `contact_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `contact_email` varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系邮箱',
+  `protocol_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '渠道协议附件逗号分隔',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_channel_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道信息';
+
+-- ----------------------------
+-- Records of biz_channel
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_agreement
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_agreement`;
+CREATE TABLE `biz_channel_agreement` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道ID',
+  `agreement_type` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'kyxy科研 zsxy中试 lcxy临床',
+  `business_type` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'kyyy科研应用/中试应用/临床应用（随协议类型）',
+  `settle_mode` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'yj月结 jj季结 nj年结 dcjs单次结算',
+  `credit_limit_amount` decimal(18,2) DEFAULT NULL COMMENT '授信额度（元）',
+  `effective_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '生效日期YYYYMMDD',
+  `expire_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '到期日期YYYYMMDD',
+  `agreement_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'sxz' COMMENT 'sxz生效中 yzf已作废',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ch_agr_channel` (`channel_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道协议';
+
+-- ----------------------------
+-- Records of biz_channel_agreement
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_agreement_product_price
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_agreement_product_price`;
+CREATE TABLE `biz_channel_agreement_product_price` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_agreement_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道协议ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
+  `project_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目编码',
+  `cell_type_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型编码',
+  `cell_type_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型名称',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格',
+  `original_price` decimal(18,2) DEFAULT NULL COMMENT '原价（元）',
+  `agreement_price` decimal(18,2) DEFAULT NULL COMMENT '协议价（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_cap_agr` (`channel_agreement_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道协议-细胞产品价格';
+
+-- ----------------------------
+-- Records of biz_channel_agreement_product_price
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_invoice
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_invoice`;
+CREATE TABLE `biz_channel_invoice` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道ID',
+  `company_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '单位名称',
+  `tax_no` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '税号',
+  `company_address` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '单位地址',
+  `company_phone` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '电话',
+  `bank_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户银行',
+  `bank_account` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '银行账号',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ch_inv_channel` (`channel_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道开票信息';
+
+-- ----------------------------
+-- Records of biz_channel_invoice
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_mail_address
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_mail_address`;
+CREATE TABLE `biz_channel_mail_address` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道ID',
+  `mail_address` varchar(512) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '邮寄地址',
+  `mail_contact` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '邮寄联系人',
+  `mail_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '邮寄联系电话',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ch_mail_channel` (`channel_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道邮寄地址';
+
+-- ----------------------------
+-- Records of biz_channel_mail_address
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_service_order
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_service_order`;
+CREATE TABLE `biz_channel_service_order` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道ID',
+  `channel_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '渠道名称冗余',
+  `dept_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '科室/部门',
+  `order_type` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'yfk预付款 gmcp购买产品',
+  `prepay_amount` decimal(18,2) DEFAULT NULL COMMENT '预付金额（订单类型yfk）',
+  `purchase_total_amount` decimal(18,2) DEFAULT NULL COMMENT '购买总金额（订单类型gmcp）',
+  `order_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'sxz' COMMENT 'sxz生效中 yzf已作废',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注信息',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_cso_channel` (`channel_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单';
+
+-- ----------------------------
+-- Records of biz_channel_service_order
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_service_order_finance_confirm
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_service_order_finance_confirm`;
+CREATE TABLE `biz_channel_service_order_finance_confirm` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `service_order_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道服务购买订单ID',
+  `confirm_time` datetime DEFAULT NULL COMMENT '确认时间',
+  `confirm_desc` varchar(2000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '确认描述',
+  `confirm_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '确认附件逗号分隔',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_csofc_order` (`service_order_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单-财务确认';
+
+-- ----------------------------
+-- Records of biz_channel_service_order_finance_confirm
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_channel_service_order_product
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_channel_service_order_product`;
+CREATE TABLE `biz_channel_service_order_product` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `service_order_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道服务购买订单ID',
+  `project_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目编码',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
+  `cell_type` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格',
+  `agreement_unit_price` decimal(18,2) DEFAULT NULL COMMENT '协议单价',
+  `buy_qty` decimal(18,4) DEFAULT NULL COMMENT '购买数量',
+  `buy_amount` decimal(18,2) DEFAULT NULL COMMENT '购买金额',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_csop_order` (`service_order_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道服务购买订单-产品明细';
+
+-- ----------------------------
+-- Records of biz_channel_service_order_product
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_checkup_institution
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_checkup_institution`;
+CREATE TABLE `biz_checkup_institution` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `institution_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '体检机构名称',
+  `institution_address` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '体检机构地址',
+  `contact_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人',
+  `contact_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人电话',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '1正常 0停用',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ck_inst` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构';
+
+-- ----------------------------
+-- Records of biz_checkup_institution
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_checkup_institution_invoice
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_checkup_institution_invoice`;
+CREATE TABLE `biz_checkup_institution_invoice` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `checkup_institution_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '体检机构ID',
+  `company_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '单位名称',
+  `tax_no` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '税号',
+  `company_address` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '单位地址',
+  `company_phone` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '电话',
+  `bank_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户银行',
+  `bank_account` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '银行账号',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ck_inv` (`checkup_institution_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构开票信息';
+
+-- ----------------------------
+-- Records of biz_checkup_institution_invoice
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_checkup_institution_project
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_checkup_institution_project`;
+CREATE TABLE `biz_checkup_institution_project` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `checkup_institution_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '体检机构ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '项目名称',
+  `project_fee` decimal(18,2) DEFAULT NULL COMMENT '项目费用（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_ck_proj` (`checkup_institution_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检机构项目及价格';
+
+-- ----------------------------
+-- Records of biz_checkup_institution_project
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_clean_room
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_clean_room`;
+CREATE TABLE `biz_clean_room` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `room_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '编号',
+  `room_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '名称',
+  `room_grade` varchar(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '等级 A/B/C/D',
+  `room_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zc' COMMENT 'zc正常 yc异常',
+  `area_sqm` decimal(12,2) DEFAULT NULL COMMENT '面积m²',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_clean_code` (`tenant_no`,`room_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='洁净室信息';
+
+-- ----------------------------
+-- Records of biz_clean_room
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_clean_room_access_log
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_clean_room_access_log`;
+CREATE TABLE `biz_clean_room_access_log` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `clean_room_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '洁净室ID',
+  `user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '人员用户ID',
+  `person_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '人员姓名（冗余）',
+  `dept_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '部门',
+  `enter_time` datetime NOT NULL COMMENT '进入时间',
+  `purpose` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '目的',
+  `leave_time` datetime DEFAULT NULL COMMENT '离开时间',
+  `body_temp` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '体温',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_crlog_room` (`clean_room_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='洁净室人员进出';
+
+-- ----------------------------
+-- Records of biz_clean_room_access_log
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_collection_hospital
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_collection_hospital`;
+CREATE TABLE `biz_collection_hospital` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `region_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集地区ID',
+  `hospital_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '医院名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_hospital_region` (`region_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集地区下属医院';
+
+-- ----------------------------
+-- Records of biz_collection_hospital
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_collection_hospital` (`id`, `region_id`, `hospital_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('B8C83A5EB28D4B738DAE386FFACEC261', 'e1000000000000000000000000000001', '安医大3', 'zkxw', 3, '333', 'd3000000000000000000000000000001', '', '2026-05-14 09:32:25', 'd3000000000000000000000000000001', '2026-05-14 09:32:34', 1);
+INSERT INTO `biz_collection_hospital` (`id`, `region_id`, `hospital_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('e1000000000000000000000000000002', 'e1000000000000000000000000000001', '示例三甲医院（高新区）', 'zkxw', 1, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-14 09:32:38', 1);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_collection_protocol
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_collection_protocol`;
+CREATE TABLE `biz_collection_protocol` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `protocol_no_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集协议号表ID（选用号段）',
+  `protocol_no` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议号展示',
+  `protocol_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'dsx' COMMENT 'dsx待生效 sxz生效中 ygq已过期 yzf已作废 zky转科研',
+  `protocol_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '协议附件 minio 地址逗号分隔',
+  `register_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '登记日期YYYYMMDD',
+  `effective_time` datetime DEFAULT NULL COMMENT '协议生效时间',
+  `effective_desc` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '协议生效描述',
+  `expire_time` datetime DEFAULT NULL COMMENT '协议过期时间',
+  `expire_desc` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '协议过期描述',
+  `void_time` datetime DEFAULT NULL COMMENT '协议作废时间',
+  `void_desc` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '协议作废描述',
+  `to_research_time` datetime DEFAULT NULL COMMENT '协议转科研时间',
+  `to_research_desc` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '协议转科研描述',
+  `collector_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集专员用户ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注信息',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_cp_status` (`tenant_no`,`protocol_status`,`del_flag`),
+  KEY `idx_cp_no` (`tenant_no`,`protocol_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单';
+
+-- ----------------------------
+-- Records of biz_collection_protocol
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_collection_protocol_no
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_collection_protocol_no`;
+CREATE TABLE `biz_collection_protocol_no` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `protocol_no` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议号',
+  `issued` tinyint(4) NOT NULL DEFAULT '0' COMMENT '是否下发（1是 0否）',
+  `issued_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '下发用户ID',
+  `issued_user_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '下发用户姓名（冗余）',
+  `issued_time` datetime DEFAULT NULL COMMENT '下发时间',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_protocol_no` (`tenant_no`,`protocol_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议号池';
+
+-- ----------------------------
+-- Records of biz_collection_protocol_no
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_collection_region
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_collection_region`;
+CREATE TABLE `biz_collection_region` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `region_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '地区名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_region_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集地区';
+
+-- ----------------------------
+-- Records of biz_collection_region
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_collection_region` (`id`, `region_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('e1000000000000000000000000000001', '安徽省', 'zkxw', 1, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_customer
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_customer`;
+CREATE TABLE `biz_customer` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `customer_name` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '客户姓名',
+  `sex` char(1) COLLATE utf8mb4_unicode_ci DEFAULT '2' COMMENT '性别（0男 1女 2未知）',
+  `id_card_no` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '身份证号',
+  `age` int(11) DEFAULT NULL COMMENT '年龄',
+  `phone_no` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `customer_tags` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '客户标签，逗号分隔',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_customer_idcard` (`tenant_no`,`id_card_no`,`del_flag`),
+  KEY `idx_customer_name` (`tenant_no`,`customer_name`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='客户信息';
+
+-- ----------------------------
+-- Records of biz_customer
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_customer` (`id`, `customer_name`, `sex`, `id_card_no`, `age`, `phone_no`, `customer_tags`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('CCC406C12B2746C492C424D0381B9203', '123', '2', '123', 123, '123', '123', 'zkxw', 0, '123123', 'd3000000000000000000000000000001', '', '2026-05-13 12:07:29', 'd3000000000000000000000000000001', '2026-05-13 12:07:29', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_customer_follow
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_customer_follow`;
+CREATE TABLE `biz_customer_follow` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `customer_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '客户ID',
+  `follow_time` datetime NOT NULL COMMENT '随访时间',
+  `follow_desc` varchar(2000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '随访描述',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_follow_customer` (`customer_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='客户随访';
+
+-- ----------------------------
+-- Records of biz_customer_follow
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_exhibition_appointment
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_exhibition_appointment`;
+CREATE TABLE `biz_exhibition_appointment` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `appointment_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '预约编号',
+  `visit_org` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '来访单位',
+  `contact_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人',
+  `visit_date` datetime DEFAULT NULL COMMENT '到访日期',
+  `visitor_count` int(11) DEFAULT NULL COMMENT '人数',
+  `reception_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '接待人员用户ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_exh_no` (`tenant_no`,`appointment_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='展馆预约';
+
+-- ----------------------------
+-- Records of biz_exhibition_appointment
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_express_company
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_express_company`;
+CREATE TABLE `biz_express_company` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `express_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司编码',
+  `express_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_express` (`tenant_no`,`express_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递公司';
+
+-- ----------------------------
+-- Records of biz_express_company
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_express_company` (`id`, `express_code`, `express_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('22655c5a-4e72-11f1-9f47-00163e3bdd96', 'sf', '顺丰速运', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-14 10:00:39', 1);
+INSERT INTO `biz_express_company` (`id`, `express_code`, `express_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('22655ee3-4e72-11f1-9f47-00163e3bdd96', 'jd', '京东快递', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-14 10:03:15', 1);
+INSERT INTO `biz_express_company` (`id`, `express_code`, `express_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('22655f5a-4e72-11f1-9f47-00163e3bdd96', 'zt', '中通快递', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `biz_express_company` (`id`, `express_code`, `express_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('22655fa7-4e72-11f1-9f47-00163e3bdd96', 'yt', '圆通速递', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_item_unit
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_item_unit`;
+CREATE TABLE `biz_item_unit` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `unit_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '单位编码',
+  `unit_name` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '单位名称',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_item_unit` (`tenant_no`,`unit_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='物品单位';
+
+-- ----------------------------
+-- Records of biz_item_unit
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_item_unit` (`id`, `unit_code`, `unit_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('225da6c3-4e72-11f1-9f47-00163e3bdd96', 'g', '克', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `biz_item_unit` (`id`, `unit_code`, `unit_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('225da95c-4e72-11f1-9f47-00163e3bdd96', 'ml', '毫升', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `biz_item_unit` (`id`, `unit_code`, `unit_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('225dab01-4e72-11f1-9f47-00163e3bdd96', 'ge', '个', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `biz_item_unit` (`id`, `unit_code`, `unit_name`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('225dab5c-4e72-11f1-9f47-00163e3bdd96', 'fen', '份', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_leave_request
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_leave_request`;
+CREATE TABLE `biz_leave_request` (
+  `id` varchar(64) NOT NULL COMMENT '主键ID',
+  `leave_type` varchar(32) NOT NULL DEFAULT 'personal' COMMENT '请假类型: personal/sick/annual/other',
+  `start_date` varchar(20) NOT NULL COMMENT '开始日期',
+  `end_date` varchar(20) NOT NULL COMMENT '结束日期',
+  `days` int(11) NOT NULL DEFAULT '1' COMMENT '请假天数',
+  `reason` varchar(500) DEFAULT NULL COMMENT '请假原因',
+  `wf_instance_id` varchar(64) DEFAULT NULL COMMENT '流程实例ID',
+  `status` varchar(32) NOT NULL DEFAULT 'draft' COMMENT '状态: draft/pending/approved/rejected/cancelled',
+  `tenant_no` varchar(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) 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 DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` smallint(6) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_tenant` (`tenant_no`),
+  KEY `idx_status` (`status`),
+  KEY `idx_create_by` (`create_by`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='请假申请';
+
+-- ----------------------------
+-- Records of biz_leave_request
+-- ----------------------------
+BEGIN;
+INSERT INTO `biz_leave_request` (`id`, `leave_type`, `start_date`, `end_date`, `days`, `reason`, `wf_instance_id`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('1750B47E85F647B7BA25D8BD0FAF122A', 'personal', '2026-05-05', '2026-05-27', 1, '123123', '9CC8E0387F61441F992DAB624F6B3306', 'pending', '', NULL, '123123', '', '', '2026-05-13 21:24:44', '', '2026-05-13 21:24:48', 0);
+INSERT INTO `biz_leave_request` (`id`, `leave_type`, `start_date`, `end_date`, `days`, `reason`, `wf_instance_id`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('3A7A24D0459746C4A2A5728BB374FCE7', 'personal', '2026-05-06', '2026-05-28', 1, '123', '7E522AEC4B3D46329EC3CEBD53F222DD', 'pending', '', NULL, '', '', '', '2026-05-13 20:40:08', '', '2026-05-13 21:05:51', 0);
+INSERT INTO `biz_leave_request` (`id`, `leave_type`, `start_date`, `end_date`, `days`, `reason`, `wf_instance_id`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('6C20F75EFAA34530AFEC1751F7833FE2', 'personal', '2026-05-12', '2026-05-29', 1, '123', '8AEC71596A074C7281F913B8000720DF', 'pending', '', NULL, '', 'd3000000000000000000000000000001', '', '2026-05-13 21:25:41', 'd3000000000000000000000000000001', '2026-05-13 21:25:45', 0);
+INSERT INTO `biz_leave_request` (`id`, `leave_type`, `start_date`, `end_date`, `days`, `reason`, `wf_instance_id`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E82F7ED8D4E146A69E8BE132698CCDBF', 'personal', '2026-05-01', '2026-05-26', 1, '123213123', 'E7A16AA9F37A47F29D3BEC93221EFDF4', 'pending', '', NULL, '123123', 'd3000000000000000000000000000001', '', '2026-05-13 22:24:48', 'd3000000000000000000000000000001', '2026-05-13 22:24:52', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_application
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_application`;
+CREATE TABLE `biz_pilot_application` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `channel_service_order_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '渠道服务购买订单ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pilot_app_order` (`channel_service_order_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='渠道中试服务申请单';
+
+-- ----------------------------
+-- Records of biz_pilot_application
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_checkup
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_checkup`;
+CREATE TABLE `biz_pilot_checkup` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `pilot_application_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '中试申请单ID',
+  `checkup_institution_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '体检机构ID',
+  `reserve_time` datetime DEFAULT NULL COMMENT '预约时间',
+  `reserve_fee` decimal(18,2) DEFAULT NULL COMMENT '预约费用',
+  `actual_checkup_time` datetime DEFAULT NULL COMMENT '实际体检时间',
+  `actual_checkup_fee` decimal(18,2) DEFAULT NULL COMMENT '实际体检费用',
+  `fee_settled` tinyint(4) DEFAULT '0' COMMENT '费用是否结算 1是 0否',
+  `checkup_status` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT 'dtj' COMMENT 'dtj待体检 ytj已体检',
+  `fee_status` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT 'wjs' COMMENT 'wjs未结算 yjs已结算',
+  `checkup_remark` varchar(2000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '体检备注',
+  `report_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '体检报告附件',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pchk_app` (`pilot_application_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-体检信息';
+
+-- ----------------------------
+-- Records of biz_pilot_checkup
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_checkup_actual_item
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_checkup_actual_item`;
+CREATE TABLE `biz_pilot_checkup_actual_item` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `pilot_checkup_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '中试申请单体检信息ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
+  `project_fee` decimal(18,2) DEFAULT NULL COMMENT '项目费用（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pcai_chk` (`pilot_checkup_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检实际项目明细';
+
+-- ----------------------------
+-- Records of biz_pilot_checkup_actual_item
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_checkup_reserve_item
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_checkup_reserve_item`;
+CREATE TABLE `biz_pilot_checkup_reserve_item` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `pilot_checkup_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '中试申请单体检信息ID',
+  `project_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
+  `project_fee` decimal(18,2) DEFAULT NULL COMMENT '项目费用（元）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pcri_chk` (`pilot_checkup_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='体检预约项目明细';
+
+-- ----------------------------
+-- Records of biz_pilot_checkup_reserve_item
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_delivery
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_delivery`;
+CREATE TABLE `biz_pilot_delivery` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `infusion_schedule_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '输注计划ID',
+  `delivery_no` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '交付编号（可程序生成）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_pdel_sched` (`infusion_schedule_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='输注计划-交付信息';
+
+-- ----------------------------
+-- Records of biz_pilot_delivery
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_delivery_material
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_delivery_material`;
+CREATE TABLE `biz_pilot_delivery_material` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `delivery_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '交付信息ID',
+  `material_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '物料名称',
+  `qty` decimal(18,4) DEFAULT NULL COMMENT '数量',
+  `unit_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '单位ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pdm_del` (`delivery_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='交付信息-物料清单';
+
+-- ----------------------------
+-- Records of biz_pilot_delivery_material
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_delivery_method
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_delivery_method`;
+CREATE TABLE `biz_pilot_delivery_method` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `delivery_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '交付信息ID',
+  `delivery_mode` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'qdzt渠道自提 kdfh快递发货',
+  `delivery_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '交付附件',
+  `ship_time` datetime DEFAULT NULL COMMENT '发运时间',
+  `handover_temp` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '交接温度',
+  `pickup_person` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '自提人员',
+  `pickup_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `sender_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '发货人',
+  `express_company_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递公司ID',
+  `waybill_no` varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递单号',
+  `express_fee` decimal(18,2) DEFAULT NULL COMMENT '快递费用',
+  `eta_time` datetime DEFAULT NULL COMMENT '预计到达时间',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_pdmeth_del` (`delivery_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='交付信息-交付方式';
+
+-- ----------------------------
+-- Records of biz_pilot_delivery_method
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_infusion_confirm
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_infusion_confirm`;
+CREATE TABLE `biz_pilot_infusion_confirm` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `infusion_schedule_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '输注计划ID',
+  `confirm_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '确认人',
+  `confirm_time` datetime DEFAULT NULL COMMENT '确认时间',
+  `confirm_desc` varchar(2000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '确认描述',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_pic_sched` (`infusion_schedule_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='输注计划-应用确认';
+
+-- ----------------------------
+-- Records of biz_pilot_infusion_confirm
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_infusion_plan
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_infusion_plan`;
+CREATE TABLE `biz_pilot_infusion_plan` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `pilot_application_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '中试申请单ID',
+  `cell_type` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格',
+  `total_course_count` int(11) DEFAULT NULL COMMENT '总疗程数',
+  `course_interval` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '疗程间隔描述',
+  `infusion_route` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '输注途径',
+  `infusion_start_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '输注开始日期YYYYMMDD',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pip_app` (`pilot_application_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-输注方案';
+
+-- ----------------------------
+-- Records of biz_pilot_infusion_plan
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_infusion_schedule
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_infusion_schedule`;
+CREATE TABLE `biz_pilot_infusion_schedule` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `infusion_plan_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '输注方案ID',
+  `cell_type` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '细胞类型',
+  `spec_text` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '规格',
+  `infusion_time` datetime DEFAULT NULL COMMENT '输注时间',
+  `schedule_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'dsc' COMMENT 'dsc待生产 ysc已生产 yjf已交付 yqx已取消',
+  `attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件逗号分隔',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_pis_plan` (`infusion_plan_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-输注计划';
+
+-- ----------------------------
+-- Records of biz_pilot_infusion_schedule
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_pilot_patient
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_pilot_patient`;
+CREATE TABLE `biz_pilot_patient` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `pilot_application_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '中试申请单ID',
+  `customer_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '关联客户ID',
+  `patient_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '姓名',
+  `sex` char(1) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '性别',
+  `age` int(11) DEFAULT NULL COMMENT '年龄',
+  `id_card_no` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '身份证号',
+  `phone_no` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `emergency_contact` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '紧急联系人',
+  `emergency_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '紧急联系人电话',
+  `clinical_diagnosis` varchar(2000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '临床诊断',
+  `diagnosis_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '诊断附件逗号分隔',
+  `need_checkup` tinyint(4) NOT NULL DEFAULT '1' COMMENT '是否需要体检 1需要 0不需要',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_pilot_patient_app` (`pilot_application_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='中试申请单-患者信息';
+
+-- ----------------------------
+-- Records of biz_pilot_patient
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_audit
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_audit`;
+CREATE TABLE `biz_protocol_audit` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `auditor_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '审核人',
+  `audit_remark` varchar(1000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '审核备注',
+  `audit_status` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'shtg审核通过 shth审核退回',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_audit_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-审核记录';
+
+-- ----------------------------
+-- Records of biz_protocol_audit
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_collection_info
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_collection_info`;
+CREATE TABLE `biz_protocol_collection_info` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `region_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集地区ID',
+  `hospital_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集医院ID',
+  `medical_staff` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集医护',
+  `sales_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '销售人员用户ID',
+  `sample_collect_time` datetime DEFAULT NULL COMMENT '样本采集时间',
+  `maternal_blood_collect_time` datetime DEFAULT NULL COMMENT '母血采集时间',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_coll_one` (`collection_protocol_id`,`del_flag`),
+  KEY `idx_coll_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-采集信息';
+
+-- ----------------------------
+-- Records of biz_protocol_collection_info
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_fullmoon_todo
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_fullmoon_todo`;
+CREATE TABLE `biz_protocol_fullmoon_todo` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `todo_status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '1已办报销 0未办保险',
+  `handle_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '办理日期',
+  `handle_remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '办理备注',
+  `insurance_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '保险附件逗号分隔',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_fullmoon_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='新生儿满月待办';
+
+-- ----------------------------
+-- Records of biz_protocol_fullmoon_todo
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_operation_log
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_operation_log`;
+CREATE TABLE `biz_protocol_operation_log` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `operation_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '操作编码',
+  `operation_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '操作名称',
+  `operation_detail` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '操作详情/变更摘要',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_oplog_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单操作日志';
+
+-- ----------------------------
+-- Records of biz_protocol_operation_log
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_party_customer
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_party_customer`;
+CREATE TABLE `biz_protocol_party_customer` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `customer_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '关联客户表 customer',
+  `mother_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲姓名',
+  `mother_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲联系电话',
+  `mother_id_card` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲身份证号',
+  `mother_birth_ym` char(6) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲出生年月YYYYMM',
+  `mother_ethnic` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲民族',
+  `mother_address` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '母亲家庭住址',
+  `father_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '父亲姓名',
+  `father_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '父亲电话',
+  `father_id_card` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '父亲身份证号',
+  `newborn_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '新生儿姓名',
+  `newborn_id_card` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '新生儿身份证号',
+  `newborn_delivery_time` datetime DEFAULT NULL COMMENT '新生儿分娩时间',
+  `newborn_sex` char(1) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '1男 0女',
+  `delivery_mode` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'sc顺产 pgc剖宫产',
+  `birth_order` int(11) DEFAULT NULL COMMENT '胎次',
+  `newborn_weight_gram` int(11) DEFAULT NULL COMMENT '新生儿体重（克）',
+  `apgar_1min` decimal(4,1) DEFAULT NULL COMMENT '新生儿评分1分钟',
+  `apgar_5min` decimal(4,1) DEFAULT NULL COMMENT '新生儿评分5分钟',
+  `collector_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '采集专员用户ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_party_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-当事人/产妇新生儿信息';
+
+-- ----------------------------
+-- Records of biz_protocol_party_customer
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_payment
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_payment`;
+CREATE TABLE `biz_protocol_payment` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `pay_mode` varchar(8) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'dj趸交 fq分期',
+  `contract_amount` decimal(18,2) DEFAULT NULL COMMENT '合同金额',
+  `installment_count` int(11) DEFAULT NULL COMMENT '分期期数',
+  `installment_interval_months` int(11) DEFAULT NULL COMMENT '每期间隔（月）',
+  `lump_sum_deadline` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '趸交截止时间YYYYMMDD',
+  `installment_start_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '分期开始时间YYYYMMDD',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_payment_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-缴费主表';
+
+-- ----------------------------
+-- Records of biz_protocol_payment
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_payment_detail
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_payment_detail`;
+CREATE TABLE `biz_protocol_payment_detail` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `payment_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '缴费主表ID',
+  `transfer_type` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'wxzz微信 zzbzz支付宝 yhkzz银行卡 xj现金',
+  `due_amount` decimal(18,2) DEFAULT NULL COMMENT '应缴费金额',
+  `transfer_amount` decimal(18,2) DEFAULT NULL COMMENT '转账金额',
+  `transfer_time` datetime DEFAULT NULL COMMENT '转账时间',
+  `transfer_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '转账附件逗号分隔',
+  `finance_confirm_attachments` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '财务确认附件逗号分隔',
+  `pay_status` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'dfj' COMMENT 'dfj待缴费 jfqrz缴费确认中 yjf已缴费 tfqrz退费确认中 ytf已退费',
+  `installment_no` int(11) DEFAULT NULL COMMENT '分期期序号，趸交为空',
+  `installment_due_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '分期应缴费时间YYYYMMDD',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_payd_pay` (`payment_id`,`del_flag`),
+  KEY `idx_payd_status` (`tenant_no`,`pay_status`,`del_flag`),
+  KEY `idx_payd_due` (`installment_due_date`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-缴费明细';
+
+-- ----------------------------
+-- Records of biz_protocol_payment_detail
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_sample
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_sample`;
+CREATE TABLE `biz_protocol_sample` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `sample_type_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '样本类型ID',
+  `sample_code_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '样本编码表ID',
+  `sample_code` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '样本编码展示',
+  `collect_amount` decimal(18,4) DEFAULT NULL COMMENT '采集量',
+  `unit_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '物品单位ID',
+  `price` decimal(18,2) DEFAULT NULL COMMENT '价格',
+  `storage_years` int(11) DEFAULT NULL COMMENT '存储年限（年）',
+  `sample_status` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'ycj已采集 jcz检测中 yrk已入库 yzf已作废',
+  `storage_in_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '入库日期YYYYMMDD',
+  `detect_start_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '检测开始日期',
+  `void_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '作废日期',
+  `storage_expire_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '存储到期日期=入库+年限',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_sample_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-样本信息';
+
+-- ----------------------------
+-- Records of biz_protocol_sample
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_sample_transport
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_sample_transport`;
+CREATE TABLE `biz_protocol_sample_transport` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `sample_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '样本ID',
+  `transport_type` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'kdys快递运输 ryxd人员携带',
+  `express_company_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递公司ID',
+  `waybill_no` varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递单号',
+  `dest_site_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '目的站点ID',
+  `express_fee` decimal(18,2) DEFAULT NULL COMMENT '快递费用（元）',
+  `eta_time` datetime DEFAULT NULL COMMENT '预计到达时间',
+  `carrier_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '携带人员姓名',
+  `carrier_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '携带人员联系电话',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_transport_sample` (`sample_id`,`del_flag`),
+  KEY `idx_transport_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集协议单-样本运输';
+
+-- ----------------------------
+-- Records of biz_protocol_sample_transport
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_protocol_storage_cert
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_protocol_storage_cert`;
+CREATE TABLE `biz_protocol_storage_cert` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `collection_protocol_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集协议单ID',
+  `make_status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '1已制作 0未制作',
+  `cert_image_urls` varchar(4000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '储存证图片逗号分隔',
+  `make_date` char(8) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '制作日期',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_cert_cp` (`collection_protocol_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='储存证';
+
+-- ----------------------------
+-- Records of biz_protocol_storage_cert
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_sample_code
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_sample_code`;
+CREATE TABLE `biz_sample_code` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `sample_code` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '样本编码',
+  `sample_code_type` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '样本编码类型 zxbm造血编码 qdbm脐带编码',
+  `issued` tinyint(4) NOT NULL DEFAULT '0' COMMENT '是否下发（1是 0否）',
+  `issued_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '下发用户ID',
+  `issued_user_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '下发用户姓名（冗余）',
+  `issued_time` datetime DEFAULT NULL COMMENT '下发时间',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_sample_code` (`tenant_no`,`sample_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='样本编码池';
+
+-- ----------------------------
+-- Records of biz_sample_code
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_storage_facility
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_storage_facility`;
+CREATE TABLE `biz_storage_facility` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `parent_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '父节点ID，0根',
+  `node_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '节点名称（罐/层/盒等）',
+  `node_type` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'facility/layer/box 等扩展',
+  `is_leaf` tinyint(4) NOT NULL DEFAULT '0' COMMENT '是否叶子存储位 1是',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_sf_parent` (`parent_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞存储设施树节点';
+
+-- ----------------------------
+-- Records of biz_storage_facility
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_storage_facility_slot
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_storage_facility_slot`;
+CREATE TABLE `biz_storage_facility_slot` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `facility_node_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '设施树叶子节点ID',
+  `slot_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '小格编码/坐标',
+  `slot_status` varchar(16) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '占用状态等扩展',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_sfs_node` (`facility_node_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='细胞存储设施储存位置（格子）';
+
+-- ----------------------------
+-- Records of biz_storage_facility_slot
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_dept
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_dept`;
+CREATE TABLE `sys_dept` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `parent_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '父组织id，0为根',
+  `dept_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '组织名称',
+  `dept_category_code` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '组织类别编码（字典 zzlbbm）',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '部门状态（字典 bmzt：0停用 1正常）',
+  `leader` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '部门负责人',
+  `leader_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '部门负责人联系电话',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_dept_parent` (`parent_id`,`del_flag`),
+  KEY `idx_dept_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='组织/部门';
+
+-- ----------------------------
+-- Records of sys_dept
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b13c2be2-4e71-11f1-9f47-00163e3bdd96', '0', '中科兴皖', 'gs', '1', NULL, NULL, 'zkxw', 0, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b13f9389-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '市场营销部门', 'bm', '1', NULL, NULL, 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b1430a9f-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '技术研发部', 'bm', '1', NULL, NULL, 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b1430b15-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '生产部', 'bm', '1', NULL, NULL, 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b1430b82-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '质量安全部', 'bm', '1', NULL, NULL, 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b1430c01-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '财务部', 'bm', '1', NULL, NULL, 'zkxw', 5, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b1430f37-4e71-11f1-9f47-00163e3bdd96', 'b13c2be2-4e71-11f1-9f47-00163e3bdd96', '综合部', 'bm', '1', NULL, NULL, 'zkxw', 6, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b146d77f-4e71-11f1-9f47-00163e3bdd96', 'b13f9389-4e71-11f1-9f47-00163e3bdd96', '采集部', 'bm', '1', NULL, NULL, 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b146da5a-4e71-11f1-9f47-00163e3bdd96', 'b13f9389-4e71-11f1-9f47-00163e3bdd96', '临床部', 'bm', '1', NULL, NULL, 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b146dad8-4e71-11f1-9f47-00163e3bdd96', 'b13f9389-4e71-11f1-9f47-00163e3bdd96', '中试服务部', 'bm', '1', NULL, NULL, 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b146db40-4e71-11f1-9f47-00163e3bdd96', 'b13f9389-4e71-11f1-9f47-00163e3bdd96', '支持中心', 'bm', '1', NULL, NULL, 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+INSERT INTO `sys_dept` (`id`, `parent_id`, `dept_name`, `dept_category_code`, `status`, `leader`, `leader_phone`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('b146dba1-4e71-11f1-9f47-00163e3bdd96', 'b13f9389-4e71-11f1-9f47-00163e3bdd96', '客服部', 'bm', '1', NULL, NULL, 'zkxw', 5, NULL, NULL, '', '2026-05-13 10:16:03', NULL, '2026-05-13 10:16:03', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_dict_data
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_dict_data`;
+CREATE TABLE `sys_dict_data` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `dict_label` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '字典标签',
+  `dict_value` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '字典键值',
+  `dict_type` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '字典类型',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_dict_data_type` (`tenant_no`,`dict_type`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='字典数据';
+
+-- ----------------------------
+-- Records of sys_dict_data
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a583e-4e71-11f1-9f47-00163e3bdd96', '公司', 'gs', 'zzlbbm', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5bcc-4e71-11f1-9f47-00163e3bdd96', '分公司', 'fgs', 'zzlbbm', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5c61-4e71-11f1-9f47-00163e3bdd96', '部门', 'bm', 'zzlbbm', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5cb2-4e71-11f1-9f47-00163e3bdd96', '中心基地', 'zxjd', 'zdlx', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5cfb-4e71-11f1-9f47-00163e3bdd96', '样本采集', 'ybcj', 'zdywfw', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5d46-4e71-11f1-9f47-00163e3bdd96', '样本制备', 'ybzb', 'zdywfw', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5d91-4e71-11f1-9f47-00163e3bdd96', '质量检测', 'zljc', 'zdywfw', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5dde-4e71-11f1-9f47-00163e3bdd96', '细胞存储', 'xbcc', 'zdywfw', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5e36-4e71-11f1-9f47-00163e3bdd96', '停用', '0', 'bmzt', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_data` (`id`, `dict_label`, `dict_value`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25a5e7c-4e71-11f1-9f47-00163e3bdd96', '正常', '1', 'bmzt', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_dict_type
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_dict_type`;
+CREATE TABLE `sys_dict_type` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `dict_name` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '字典名称',
+  `dict_type` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '字典类型编码',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_dict_type` (`tenant_no`,`dict_type`,`del_flag`),
+  KEY `idx_dict_type_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='字典类型';
+
+-- ----------------------------
+-- Records of sys_dict_type
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25639d6-4e71-11f1-9f47-00163e3bdd96', '组织类别编码', 'zzlbbm', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d2565c69-4e71-11f1-9f47-00163e3bdd96', '站点类型', 'zdlx', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d2565ff8-4e71-11f1-9f47-00163e3bdd96', '站点业务范围', 'zdywfw', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+INSERT INTO `sys_dict_type` (`id`, `dict_name`, `dict_type`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d25660b0-4e71-11f1-9f47-00163e3bdd96', '部门状态', 'bmzt', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:16:59', NULL, '2026-05-13 10:16:59', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_menu
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_menu`;
+CREATE TABLE `sys_menu` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `menu_name` varchar(50) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '菜单名称',
+  `parent_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '父菜单ID，0为根',
+  `menu_type` char(1) COLLATE utf8mb4_unicode_ci DEFAULT 'M' COMMENT '类型 M目录 C菜单 F按钮（扩展）',
+  `path` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '路由路径（扩展）',
+  `component` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '组件路径（扩展）',
+  `perms` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '权限标识（扩展）',
+  `is_frame` int(1) DEFAULT '1' COMMENT '是否外链（1是 0否）',
+  `visible` char(1) COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '显示状态（1显示 0隐藏）',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '菜单状态（1正常 0停用）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_menu_parent` (`parent_id`,`del_flag`),
+  KEY `idx_menu_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='菜单';
+
+-- ----------------------------
+-- Records of sys_menu
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('1', 'Web端菜单', '0', 'M', '/system', NULL, NULL, 1, '1', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('100', '系统管理', '1', 'M', '/system', '/index/index', NULL, 1, '1', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('10000000000000000000000000000wf01', '流程配置', '0', 'C', 'workflow/process', '/system/workflow/process/index', 'workflow:process', 1, '1', '1', 'zkxw', 15, NULL, NULL, '', '2026-05-13 10:23:04', NULL, '2026-05-13 10:23:04', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('10000000000000000000000000000wf02', '待办中心', '0', 'C', 'workflow/pending', '/system/workflow/task-pending/index', 'workflow:pending', 1, '1', '1', 'zkxw', 16, NULL, NULL, '', '2026-05-13 10:23:04', NULL, '2026-05-13 10:23:04', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('10000000000000000000000000000wf03', '已办中心', '0', 'C', 'workflow/completed', '/system/workflow/task-completed/index', 'workflow:completed', 1, '1', '1', 'zkxw', 17, NULL, NULL, '', '2026-05-13 10:23:04', NULL, '2026-05-13 10:23:04', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('101', '租户管理', '100', 'C', 'tenant', '/system/tenant/index', 'system:tenant:list', 1, '1', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('102', '字典管理', '100', 'C', 'dict', '/system/dict/index', 'system:dict:list', 1, '1', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('103', '组织管理', '100', 'C', 'dept', '/system/dept/index', 'system:dept:list', 1, '1', '1', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('104', '用户管理', '100', 'C', 'user', '/system/user/index', 'system:user:list', 1, '1', '1', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('105', '角色管理', '100', 'C', 'role', '/system/role/index', 'system:role:list', 1, '1', '1', 'zkxw', 5, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('106', '菜单管理', '100', 'C', 'menu', '/system/menu/index', 'system:menu:list', 1, '1', '1', 'zkxw', 6, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('107', '站点管理', '100', 'C', 'site', '/system/site/index', 'system:site:list', 1, '1', '1', 'zkxw', 7, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('108', '职位管理', '100', 'C', 'post', '/system/post/index', 'system:post:list', 1, '1', '1', 'zkxw', 8, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('109', '物品单位', '100', 'C', 'unit', '/system/unit/index', 'system:unit:list', 1, '1', '1', 'zkxw', 9, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('110', '快递公司', '100', 'C', 'express', '/system/express/index', 'system:express:list', 1, '1', '1', 'zkxw', 10, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('120', '基础信息管理', '1', 'M', '/basic-info', '/index/index', NULL, 1, '1', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('121', '客户管理', '120', 'C', 'customer', '/basic-info/customer/index', 'biz:customer:list', 1, '1', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('122', '细胞样本类型管理', '120', 'C', 'cell-sample-type', '/basic-info/cell-sample-type/index', 'biz:cellSampleType:list', 1, '1', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('123', '采集地区及医院管理', '120', 'C', 'collection-region', '/basic-info/collection-region/index', 'biz:collectionRegion:list', 1, '1', '1', 'zkxw', 3, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('124', '采集协议号管理', '120', 'C', 'collection-protocol-no', '/basic-info/collection-protocol-no/index', 'biz:collectionProtocolNo:list', 1, '1', '1', 'zkxw', 4, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('125', '样本编码管理', '120', 'C', 'sample-code', '/basic-info/sample-code/index', 'biz:sampleCode:list', 1, '1', '1', 'zkxw', 5, NULL, NULL, '', '2026-05-13 12:05:42', NULL, '2026-05-13 12:05:42', 0);
+INSERT INTO `sys_menu` (`id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`, `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2', '移动端菜单', '0', 'M', '/mini', NULL, NULL, 1, '1', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:17:45', NULL, '2026-05-13 10:17:45', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_post
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_post`;
+CREATE TABLE `sys_post` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `post_name` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '职位名称',
+  `post_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '职位编码',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '状态（1正常 0停用）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_post_code` (`tenant_no`,`post_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='职位';
+
+-- ----------------------------
+-- Records of sys_post
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_post` (`id`, `post_name`, `post_code`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('225605c5-4e72-11f1-9f47-00163e3bdd96', '采集专员', 'cjzy', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `sys_post` (`id`, `post_name`, `post_code`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2256083d-4e72-11f1-9f47-00163e3bdd96', '市场支持专员', 'sczczy', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+INSERT INTO `sys_post` (`id`, `post_name`, `post_code`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('22560959-4e72-11f1-9f47-00163e3bdd96', '质检专员', 'zjzy', '1', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_role
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_role`;
+CREATE TABLE `sys_role` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `role_name` varchar(30) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '角色名称',
+  `data_scope` char(1) COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '数据权限（1全部 2本部门 3本部门及以下 4仅本人 5自定义）',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '角色状态（1正常 0停用）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_role_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色';
+
+-- ----------------------------
+-- Records of sys_role
+-- ----------------------------
+BEGIN;
+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`) VALUES ('097bd2c6-4e72-11f1-9f47-00163e3bdd96', '超级管理员', '1', '1', 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:18:31', NULL, '2026-05-13 10:18:31', 0);
+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`) VALUES ('097bd62b-4e72-11f1-9f47-00163e3bdd96', '运营管理员', '1', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:18:31', NULL, '2026-05-13 10:18:31', 0);
+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`) VALUES ('097bd80c-4e72-11f1-9f47-00163e3bdd96', '采集专员', '2', '1', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:18:31', NULL, '2026-05-13 10:18:31', 0);
+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`) VALUES ('097bd88f-4e72-11f1-9f47-00163e3bdd96', '市场支持专员', '2', '1', 'zkxw', 4, NULL, NULL, '', '2026-05-13 10:18:31', NULL, '2026-05-13 10:18:31', 0);
+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`) VALUES ('097bd909-4e72-11f1-9f47-00163e3bdd96', '质检专员', '2', '1', 'zkxw', 5, NULL, NULL, '', '2026-05-13 10:18:31', NULL, '2026-05-13 10:18:31', 0);
+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`) VALUES ('d2000000000000000000000000000001', '超级管理员', '1', '1', 'zkxw', 1, '全部数据权限', NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+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`) VALUES ('d2000000000000000000000000000002', '运营管理员', '2', '1', 'zkxw', 2, '本部门数据', NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_role_data_scope_detail
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_role_data_scope_detail`;
+CREATE TABLE `sys_role_data_scope_detail` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `role_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '角色ID',
+  `scope_type` varchar(20) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '范围类型：dept部门 user用户',
+  `scope_value` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '范围值：部门ID/用户ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_role_scope_role` (`role_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色自定义数据权限明细';
+
+-- ----------------------------
+-- Records of sys_role_data_scope_detail
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_role_menu
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_role_menu`;
+CREATE TABLE `sys_role_menu` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `role_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '角色ID',
+  `menu_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '菜单ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_role_menu` (`role_id`,`menu_id`,`del_flag`),
+  KEY `idx_role_menu_menu` (`menu_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='角色-菜单关联';
+
+-- ----------------------------
+-- Records of sys_role_menu
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000001', 'd2000000000000000000000000000001', 'd4000000000000000000000000000001', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000002', 'd2000000000000000000000000000001', 'd4000000000000000000000000000002', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000003', 'd2000000000000000000000000000001', 'd4000000000000000000000000000003', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000004', 'd2000000000000000000000000000001', 'd4000000000000000000000000000004', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000005', 'd2000000000000000000000000000001', 'd4000000000000000000000000000005', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000011', 'd2000000000000000000000000000002', 'd4000000000000000000000000000001', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000012', 'd2000000000000000000000000000002', 'd4000000000000000000000000000002', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000013', 'd2000000000000000000000000000002', 'd4000000000000000000000000000003', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_role_menu` (`id`, `role_id`, `menu_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d5000000000000000000000000000014', 'd2000000000000000000000000000002', 'd4000000000000000000000000000004', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_site
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_site`;
+CREATE TABLE `sys_site` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `site_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '站点名称',
+  `site_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '站点编码',
+  `site_type` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '站点类型（字典 zdlx）',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '状态（1正常 0停用）',
+  `address` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '详细地址',
+  `contact_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人',
+  `contact_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `business_scope` varchar(256) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务范围（字典 zdywfw，多值可逗号分隔）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_site_code` (`tenant_no`,`site_code`,`del_flag`),
+  KEY `idx_site_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='站点';
+
+-- ----------------------------
+-- Records of sys_site
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_site` (`id`, `site_name`, `site_code`, `site_type`, `status`, `address`, `contact_name`, `contact_phone`, `business_scope`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2237b211-4e72-11f1-9f47-00163e3bdd96', '中科兴皖中心基地', 'zkxw-zxjd', 'zxjd', '1', '', NULL, NULL, NULL, 'zkxw', 1, NULL, NULL, '', '2026-05-13 10:19:13', NULL, '2026-05-13 10:19:13', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_tenant
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_tenant`;
+CREATE TABLE `sys_tenant` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '租户编号（业务编码，如 zkxw）',
+  `tenant_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '租户名称',
+  `contact_name` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人姓名',
+  `contact_phone` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_sys_tenant_no` (`tenant_no`,`del_flag`),
+  KEY `idx_sys_tenant_del` (`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='租户信息';
+
+-- ----------------------------
+-- Records of sys_tenant
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_tenant` (`id`, `tenant_no`, `tenant_name`, `contact_name`, `contact_phone`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('00D57235D5C8497A8C02D54E0FD3CDCF', '123', '123', '123', '123', 1, '123123', 'd3000000000000000000000000000001', '', '2026-05-12 19:06:42', 'd3000000000000000000000000000001', '2026-05-12 19:06:46', 1);
+INSERT INTO `sys_tenant` (`id`, `tenant_no`, `tenant_name`, `contact_name`, `contact_phone`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('034a9f604de111f1938000163e3bdd96', 'zkxw', '中科兴皖', NULL, NULL, NULL, NULL, NULL, '', '2026-05-12 17:00:24', NULL, '2026-05-12 17:00:24', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_user
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_user`;
+CREATE TABLE `sys_user` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `dept_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '部门ID',
+  `user_no` varchar(30) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '用户账号',
+  `nick_name` varchar(30) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '用户名',
+  `email` varchar(50) COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '用户邮箱',
+  `phone_no` varchar(11) COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '手机号码',
+  `sex` char(1) COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '用户性别（0男 1女 2未知）',
+  `avatar` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '头像（minio完整地址）',
+  `password` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '密码',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '帐号状态（1正常 0停用）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_user_no` (`tenant_no`,`user_no`,`del_flag`),
+  KEY `idx_user_dept` (`dept_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户';
+
+-- ----------------------------
+-- Records of sys_user
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_user` (`id`, `dept_id`, `user_no`, `nick_name`, `email`, `phone_no`, `sex`, `avatar`, `password`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2ac3e6204e7211f19f4700163e3bdd96', NULL, 'zhangsan', '张三', 'zhangsan@zkxw.com', '13800000001', '0', NULL, '$2b$12$P.bS1iKm8zS4YEGUpDSi9uswGT/GiZgfJdnqigyQKflsmP2OAn5ai', '1', 'zkxw', 2, NULL, NULL, '', '2026-05-13 10:19:27', NULL, '2026-05-13 22:27:06', 0);
+INSERT INTO `sys_user` (`id`, `dept_id`, `user_no`, `nick_name`, `email`, `phone_no`, `sex`, `avatar`, `password`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2ac489c64e7211f19f4700163e3bdd96', NULL, 'lisi', '李四', 'lisi@zkxw.com', '13800000002', '1', NULL, '$2b$12$P.bS1iKm8zS4YEGUpDSi9uswGT/GiZgfJdnqigyQKflsmP2OAn5ai', '1', 'zkxw', 3, NULL, NULL, '', '2026-05-13 10:19:27', NULL, '2026-05-13 22:27:05', 0);
+INSERT INTO `sys_user` (`id`, `dept_id`, `user_no`, `nick_name`, `email`, `phone_no`, `sex`, `avatar`, `password`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d3000000000000000000000000000001', 'd1000000000000000000000000000002', 'admin', '系统管理员', 'admin@zkxw.local', '13800000000', '0', NULL, '$2b$12$P.bS1iKm8zS4YEGUpDSi9uswGT/GiZgfJdnqigyQKflsmP2OAn5ai', '1', 'zkxw', 1, '初始超级管理员', NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_user` (`id`, `dept_id`, `user_no`, `nick_name`, `email`, `phone_no`, `sex`, `avatar`, `password`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d3000000000000000000000000000002', 'd1000000000000000000000000000002', 'demo', '演示运营', 'demo@zkxw.local', '13900000000', '0', NULL, '$2b$12$w0mJ2.WU5yOCM/oHed0Hhu3fjThWEXN4TxXOWrfKX5naOGMObHYNa', '1', 'zkxw', 2, '初始运营账号', NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_user_post
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_user_post`;
+CREATE TABLE `sys_user_post` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `user_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '用户ID',
+  `post_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '职位ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_user_post` (`user_id`,`post_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户-职位关联';
+
+-- ----------------------------
+-- Records of sys_user_post
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_user_post` (`id`, `user_id`, `post_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d8000000000000000000000000000001', 'd3000000000000000000000000000001', 'd7000000000000000000000000000002', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for sys_user_role
+-- ----------------------------
+DROP TABLE IF EXISTS `sys_user_role`;
+CREATE TABLE `sys_user_role` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `user_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '用户ID',
+  `role_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '角色ID',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_user_role` (`user_id`,`role_id`,`del_flag`),
+  KEY `idx_user_role_role` (`role_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户-角色关联';
+
+-- ----------------------------
+-- Records of sys_user_role
+-- ----------------------------
+BEGIN;
+INSERT INTO `sys_user_role` (`id`, `user_id`, `role_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d6000000000000000000000000000001', 'd3000000000000000000000000000001', 'd2000000000000000000000000000001', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+INSERT INTO `sys_user_role` (`id`, `user_id`, `role_id`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('d6000000000000000000000000000002', 'd3000000000000000000000000000002', 'd2000000000000000000000000000002', 'zkxw', NULL, NULL, NULL, '', '2026-05-12 17:28:38', NULL, '2026-05-12 17:28:38', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_node
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_node`;
+CREATE TABLE `wf_node` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `process_version_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程版本ID',
+  `node_key` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '节点唯一键（画布内）',
+  `node_type` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'start/end/approval/condition 等',
+  `node_name` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '节点名称',
+  `config_json` mediumtext COLLATE utf8mb4_unicode_ci COMMENT '审批人/SQL/会签策略等配置',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_wf_node_ver` (`process_version_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程节点';
+
+-- ----------------------------
+-- Records of wf_node
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('013DF290E0CA48FFA6C1F986CCC75E4E', '1BFEF3BC45FB4B85979203252573251F', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2A06EA4B65F04C54ADB7FCB3CC83EAF3', '65E51B403AEF4F458E162797470E83AA', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('2BD96A3B1B46407FA220A0106D17A99A', 'E694F38CAC504B51AAF64F102DB88380', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('3EBE44E9A0674140A4014A7AFF29B0B5', 'D31763EFEA9B4082B6104576FDB12718', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:02', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('40EC0D320A994063B6CFB02D52717589', 'E694F38CAC504B51AAF64F102DB88380', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('45B29C0FDDEE4BDA9E2A72CAC073E8D7', '1BFEF3BC45FB4B85979203252573251F', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('54C1AA20BA5547B0BBF69206A549CE00', '3DDD7210942F40CB8D117BCC43144B21', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('5B8E273F9066428180CDBA3CAEC9296D', 'A0094B798812442AA8E76C13A0E22460', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('627296C1FC424DD58BD282B4039C2F44', 'D31763EFEA9B4082B6104576FDB12718', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:02', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('62B7E5476E914DD9B1CE48FCCDD46CE7', 'D31763EFEA9B4082B6104576FDB12718', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:02', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('65FA3C08AF6E4988A6BCD0A635419C57', '3DDD7210942F40CB8D117BCC43144B21', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('6F42034687AD4881A541D3B920BC857D', 'A8762F2E338B406AAF1C7A3A5F25F414', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7782AA67567F47E3BA8D58426FDCB1B1', '1BFEF3BC45FB4B85979203252573251F', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7A89CCE6E04C4A1085A1A9FFFAC6AD06', 'E02466CE3C6B4E65A7A0B34C021BE27A', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:00:29', 'd3000000000000000000000000000001', '2026-05-13 21:00:29', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7B8CC10BFFFD40BB86328DF405735C63', 'D676C619406645849BDBA4CD0DB2D999', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:03:12', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7C062A2A90ED4E0D96570EA614FB37FC', '65E51B403AEF4F458E162797470E83AA', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('8B0DB5951990413CAE1D76B269826D7E', '8644BC4075D843B29FFB703B8F488E0A', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:04', 'd3000000000000000000000000000001', '2026-05-13 21:03:04', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('99F41F97C9C04A229168DE64A0CB5C11', '3DDD7210942F40CB8D117BCC43144B21', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('9D890BBBAF0B42E2A2DD0F492F97C546', 'A8762F2E338B406AAF1C7A3A5F25F414', 'a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a', 'approval', '张三审批', '{\"strategy\":\"users\",\"userIds\":[\"2ac3e6204e7211f19f4700163e3bdd96\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 3, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('A2378E111B394806ABF0200BE9B60AA2', 'A0094B798812442AA8E76C13A0E22460', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('A577AD86AFD54F5580991DEDCF412F26', 'E02466CE3C6B4E65A7A0B34C021BE27A', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:00:29', 'd3000000000000000000000000000001', '2026-05-13 21:00:29', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('A5864DF129D04033BB8B11B72399E2C3', '51806057C1D243429BE1316A5945D2F2', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('BA731666B37F4FF982A09F5BF43010D1', '51806057C1D243429BE1316A5945D2F2', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('C5D5ABECB5584C92AA860637F1C89DEE', 'D676C619406645849BDBA4CD0DB2D999', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:03:12', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('CB55117070184292AA173FCE222A1E3F', 'A8762F2E338B406AAF1C7A3A5F25F414', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D47501A16C95463AB4798D7392D70A97', 'E694F38CAC504B51AAF64F102DB88380', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('DB23CEEB4E1240D880270F4071AF881C', '3DDAC80316AC4DCCA972060531F92723', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('DBB50E44330D4C8E85CC4393D796A0C6', '8644BC4075D843B29FFB703B8F488E0A', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:04', 'd3000000000000000000000000000001', '2026-05-13 21:03:04', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('DC3895005A1B47988DB4A13FD2553D4E', 'D676C619406645849BDBA4CD0DB2D999', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:03:12', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('DD96A286684C495CA4A9A3BD3329A88C', 'A0094B798812442AA8E76C13A0E22460', 'start', 'start', '开始', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('DF5DF29FB5B1480FBE12A5FE3595F331', '51806057C1D243429BE1316A5945D2F2', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('EDF0EBDB8D79464A80D76AAB927FEA6A', '3DDAC80316AC4DCCA972060531F92723', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('EE7B35D2FD89458F90A884E3CDCCED53', '8644BC4075D843B29FFB703B8F488E0A', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:04', 'd3000000000000000000000000000001', '2026-05-13 21:03:04', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('EF08625814CF4EEDAA85FEC0B575F3A6', '3DDAC80316AC4DCCA972060531F92723', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('F19D557A100549B18469A75B7F5FE885', '65E51B403AEF4F458E162797470E83AA', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('F68E523F6D504E019D4704761AAAA05D', 'E02466CE3C6B4E65A7A0B34C021BE27A', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:00:29', 'd3000000000000000000000000000001', '2026-05-13 21:00:29', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('F94D43C6230849FD9AE6D942EAC67F17', 'A8762F2E338B406AAF1C7A3A5F25F414', 'end', 'end', '结束', '{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}', 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000010', 'WF000000000000000000000000000002', 'start', 'start', '开始', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:56:11', 'd3000000000000000000000000000001', '2026-05-13 20:56:11', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000011', 'WF000000000000000000000000000002', 'approve1', 'approval', '主管审批', '{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"passType\":\"any\"}', 'zkxw', 2, '指定admin用户审批，任意一人通过即可', 'd3000000000000000000000000000001', '', '2026-05-13 20:56:11', 'd3000000000000000000000000000001', '2026-05-13 20:56:11', 0);
+INSERT INTO `wf_node` (`id`, `process_version_id`, `node_key`, `node_type`, `node_name`, `config_json`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000012', 'WF000000000000000000000000000002', 'end', 'end', '结束', NULL, 'zkxw', 3, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:56:11', 'd3000000000000000000000000000001', '2026-05-13 20:56:11', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_process_def
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_process_def`;
+CREATE TABLE `wf_process_def` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `process_code` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程编码',
+  `process_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程名称',
+  `status` char(1) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '1启用 0停用',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_wf_def` (`tenant_no`,`process_code`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程定义';
+
+-- ----------------------------
+-- Records of wf_process_def
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_process_def` (`id`, `process_code`, `process_name`, `status`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000001', 'leave_request', '请假审批', '1', 'zkxw', 1, '请假审批流程种子数据', 'd3000000000000000000000000000001', '', '2026-05-13 20:56:11', 'd3000000000000000000000000000001', '2026-05-13 20:56:11', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_process_instance
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_process_instance`;
+CREATE TABLE `wf_process_instance` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `process_version_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '发起时锁定的流程版本ID',
+  `business_type` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务类型',
+  `business_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务主键',
+  `starter_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '发起人',
+  `variables_json` mediumtext COLLATE utf8mb4_unicode_ci COMMENT '流程变量 JSON',
+  `status` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'running/completed/rejected 等',
+  `callback_url` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务回调地址',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_wf_inst_biz` (`business_type`,`business_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程实例';
+
+-- ----------------------------
+-- Records of wf_process_instance
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_process_instance` (`id`, `process_version_id`, `business_type`, `business_id`, `starter_user_id`, `variables_json`, `status`, `callback_url`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7E522AEC4B3D46329EC3CEBD53F222DD', 'A0094B798812442AA8E76C13A0E22460', 'leave', '3A7A24D0459746C4A2A5728BB374FCE7', '', '{\"days\": 1, \"leaveType\": \"personal\", \"applicant\": \"\"}', 'running', '/api/admin/leave/callback', 'zkxw', 0, NULL, '', '', '2026-05-13 21:05:50', '', '2026-05-13 21:05:50', 0);
+INSERT INTO `wf_process_instance` (`id`, `process_version_id`, `business_type`, `business_id`, `starter_user_id`, `variables_json`, `status`, `callback_url`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('8AEC71596A074C7281F913B8000720DF', 'A0094B798812442AA8E76C13A0E22460', 'leave', '6C20F75EFAA34530AFEC1751F7833FE2', 'd3000000000000000000000000000001', '{\"days\": 1, \"leaveType\": \"personal\", \"applicant\": \"d3000000000000000000000000000001\"}', 'completed', '/api/admin/leave/callback', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:25:45', 'd3000000000000000000000000000001', '2026-05-13 22:25:17', 0);
+INSERT INTO `wf_process_instance` (`id`, `process_version_id`, `business_type`, `business_id`, `starter_user_id`, `variables_json`, `status`, `callback_url`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('9CC8E0387F61441F992DAB624F6B3306', 'A0094B798812442AA8E76C13A0E22460', 'leave', '1750B47E85F647B7BA25D8BD0FAF122A', '', '{\"days\": 1, \"leaveType\": \"personal\", \"applicant\": \"\"}', 'running', '/api/admin/leave/callback', 'zkxw', 0, NULL, '', '', '2026-05-13 21:24:47', '', '2026-05-13 21:24:47', 0);
+INSERT INTO `wf_process_instance` (`id`, `process_version_id`, `business_type`, `business_id`, `starter_user_id`, `variables_json`, `status`, `callback_url`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E7A16AA9F37A47F29D3BEC93221EFDF4', 'A8762F2E338B406AAF1C7A3A5F25F414', 'leave', 'E82F7ED8D4E146A69E8BE132698CCDBF', 'd3000000000000000000000000000001', '{\"days\": 1, \"leaveType\": \"personal\", \"applicant\": \"d3000000000000000000000000000001\"}', 'completed', '/api/admin/leave/callback', 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:52', 'd3000000000000000000000000000001', '2026-05-13 22:27:51', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_process_version
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_process_version`;
+CREATE TABLE `wf_process_version` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `process_def_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程定义ID',
+  `version_no` int(11) NOT NULL COMMENT '版本号，递增',
+  `graph_json` mediumtext COLLATE utf8mb4_unicode_ci COMMENT '节点与连线等配置（JSON 字符串）',
+  `is_latest` char(1) COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否最新版本（1是 0否）',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_wf_ver_def` (`process_def_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程定义版本';
+
+-- ----------------------------
+-- Records of wf_process_version
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('1BFEF3BC45FB4B85979203252573251F', 'WF000000000000000000000000000001', 9, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '草稿', 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('3DDAC80316AC4DCCA972060531F92723', 'WF000000000000000000000000000001', 2, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"},\"zIndex\":1}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 20:59:21', 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('3DDD7210942F40CB8D117BCC43144B21', 'WF000000000000000000000000000001', 4, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 20:59:38', 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 21:00:28', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('51806057C1D243429BE1316A5945D2F2', 'WF000000000000000000000000000001', 10, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '草稿', 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('65E51B403AEF4F458E162797470E83AA', 'WF000000000000000000000000000001', 3, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 20:59:32', 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('8644BC4075D843B29FFB703B8F488E0A', 'WF000000000000000000000000000001', 7, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '草稿', 'd3000000000000000000000000000001', '', '2026-05-13 21:03:03', 'd3000000000000000000000000000001', '2026-05-13 21:03:11', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('A0094B798812442AA8E76C13A0E22460', 'WF000000000000000000000000000001', 12, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 21:05:33', 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('A8762F2E338B406AAF1C7A3A5F25F414', 'WF000000000000000000000000000001', 13, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"position\":{\"x\":288,\"y\":94},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"审批节点\"},\"label\":{\"text\":\"张三审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"张三审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"2ac3e6204e7211f19f4700163e3bdd96\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":2},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"3f64b22f-c8ff-4983-9c53-bd7fbc7410c9\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a\",\"port\":\"port-in\"},\"zIndex\":3},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"38be86a5-627f-4bd0-b7c1-80f05d526eec\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"source\":{\"cell\":\"a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"},\"zIndex\":4,\"labels\":[{\"attrs\":{\"label\":{\"text\":\"其他情况\",\"fill\":\"#9ca3af\",\"fontSize\":11,\"textAnchor\":\"middle\",\"textVerticalAnchor\":\"bottom\",\"fontStyle\":\"italic\"},\"rect\":{\"fill\":\"#f9fafb\",\"stroke\":\"#d1d5db\",\"strokeWidth\":1,\"rx\":4,\"ry\":4,\"strokeDasharray\":\"3,3\"}},\"position\":{\"distance\":0.5}}]}]}', '1', 'zkxw', 0, '版本发布 - 2026/5/13 22:24:31', 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D31763EFEA9B4082B6104576FDB12718', 'WF000000000000000000000000000001', 6, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 21:03:01', 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:03', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D676C619406645849BDBA4CD0DB2D999', 'WF000000000000000000000000000001', 8, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '草稿', 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E02466CE3C6B4E65A7A0B34C021BE27A', 'WF000000000000000000000000000001', 5, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '版本发布 - 2026/5/13 21:00:27', 'd3000000000000000000000000000001', '', '2026-05-13 21:00:28', 'd3000000000000000000000000000001', '2026-05-13 21:03:01', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E694F38CAC504B51AAF64F102DB88380', 'WF000000000000000000000000000001', 11, '{\"cells\":[{\"position\":{\"x\":180,\"y\":-210},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"开始\"}},\"visible\":true,\"shape\":\"flow-start\",\"ports\":{\"groups\":{\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#10b981\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"start\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":-20},\"size\":{\"width\":180,\"height\":40},\"attrs\":{\"text\":{\"text\":\"主管审批\"},\"label\":{\"text\":\"主管审批\"}},\"visible\":true,\"shape\":\"flow-approval\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"bottom\":{\"position\":\"bottom\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"left\":{\"position\":\"left\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}},\"right\":{\"position\":\"right\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#3b82f6\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"id\":\"approve1\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"position\":{\"x\":200,\"y\":310},\"size\":{\"width\":50,\"height\":50},\"attrs\":{\"text\":{\"text\":\"结束\"}},\"visible\":true,\"shape\":\"flow-end\",\"ports\":{\"groups\":{\"top\":{\"position\":\"top\",\"attrs\":{\"circle\":{\"r\":5,\"magnet\":true,\"stroke\":\"#ef4444\",\"fill\":\"#fff\",\"strokeWidth\":1.5}}}},\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"id\":\"end\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"zIndex\":1},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-start-approve1\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"}},{\"shape\":\"edge\",\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"id\":\"edge-approve1-end\",\"data\":{\"conditionExpr\":\"\"},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}},\"zIndex\":1,\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"}}]}', '0', 'zkxw', 0, '草稿', 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_process_version` (`id`, `process_def_id`, `version_no`, `graph_json`, `is_latest`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000002', 'WF000000000000000000000000000001', 1, '{\"cells\":[{\"shape\":\"flow-start\",\"id\":\"start\",\"x\":200,\"y\":50,\"width\":50,\"height\":50,\"label\":\"开始\",\"data\":{\"nodeType\":\"start\",\"nodeName\":\"开始\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"ports\":{\"items\":[{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"attrs\":{\"body\":{\"fill\":\"#10b981\",\"stroke\":\"#059669\",\"strokeWidth\":2},\"label\":{\"fill\":\"#ffffff\",\"fontSize\":13,\"fontWeight\":600}}},{\"shape\":\"flow-approval\",\"id\":\"approve1\",\"x\":140,\"y\":180,\"width\":180,\"height\":40,\"label\":\"主管审批\",\"data\":{\"nodeType\":\"approval\",\"nodeName\":\"主管审批\",\"config\":{\"strategy\":\"users\",\"userIds\":[\"d3000000000000000000000000000001\"],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"ports\":{\"items\":[{\"group\":\"top\",\"id\":\"port-in\"},{\"group\":\"bottom\",\"id\":\"port-out\"}]},\"attrs\":{\"body\":{\"fill\":\"#3b82f6\",\"stroke\":\"#2563eb\",\"strokeWidth\":2,\"rx\":8,\"ry\":8},\"label\":{\"fill\":\"#ffffff\",\"fontSize\":13,\"fontWeight\":500}}},{\"shape\":\"flow-end\",\"id\":\"end\",\"x\":200,\"y\":310,\"width\":50,\"height\":50,\"label\":\"结束\",\"data\":{\"nodeType\":\"end\",\"nodeName\":\"结束\",\"config\":{\"strategy\":\"users\",\"userIds\":[],\"roleIds\":[],\"sqlExpr\":\"\",\"passType\":\"any\"}},\"ports\":{\"items\":[{\"group\":\"top\",\"id\":\"port-in\"}]},\"attrs\":{\"body\":{\"fill\":\"#ef4444\",\"stroke\":\"#dc2626\",\"strokeWidth\":2},\"label\":{\"fill\":\"#ffffff\",\"fontSize\":13,\"fontWeight\":600}}},{\"shape\":\"edge\",\"id\":\"edge-start-approve1\",\"source\":{\"cell\":\"start\",\"port\":\"port-out\"},\"target\":{\"cell\":\"approve1\",\"port\":\"port-in\"},\"data\":{\"conditionExpr\":\"\"},\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}}},{\"shape\":\"edge\",\"id\":\"edge-approve1-end\",\"source\":{\"cell\":\"approve1\",\"port\":\"port-out\"},\"target\":{\"cell\":\"end\",\"port\":\"port-in\"},\"data\":{\"conditionExpr\":\"\"},\"attrs\":{\"line\":{\"stroke\":\"#6b7280\",\"strokeWidth\":1.5,\"targetMarker\":{\"name\":\"block\",\"width\":10,\"height\":6}}},\"router\":{\"name\":\"manhattan\"},\"connector\":{\"name\":\"rounded\",\"args\":{\"radius\":8}}}]}', '0', 'zkxw', 1, '请假审批流程 v1', 'd3000000000000000000000000000001', '', '2026-05-13 20:56:11', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_task
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_task`;
+CREATE TABLE `wf_task` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `instance_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程实例ID',
+  `node_key` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '当前节点key',
+  `assignee_user_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '待办人',
+  `status` varchar(32) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'pending/approved/rejected 等',
+  `comment_text` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '审批意见',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_wf_task_inst` (`instance_id`,`del_flag`),
+  KEY `idx_wf_task_user` (`assignee_user_id`,`status`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程任务/待办';
+
+-- ----------------------------
+-- Records of wf_task
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_task` (`id`, `instance_id`, `node_key`, `assignee_user_id`, `status`, `comment_text`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('4524DB624F574BEEAA26323D9303B07D', '7E522AEC4B3D46329EC3CEBD53F222DD', 'approve1', 'd3000000000000000000000000000001', 'pending', NULL, 'zkxw', 0, NULL, NULL, '', '2026-05-13 21:05:50', NULL, '2026-05-13 21:05:50', 0);
+INSERT INTO `wf_task` (`id`, `instance_id`, `node_key`, `assignee_user_id`, `status`, `comment_text`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('B188D2AC0527499987E8FEB9C2E6F804', '8AEC71596A074C7281F913B8000720DF', 'approve1', 'd3000000000000000000000000000001', 'approved', '', 'zkxw', 0, NULL, NULL, '', '2026-05-13 21:25:45', NULL, '2026-05-13 22:25:16', 0);
+INSERT INTO `wf_task` (`id`, `instance_id`, `node_key`, `assignee_user_id`, `status`, `comment_text`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D5F711EF896A4056BCFF49EBEE9815A0', 'E7A16AA9F37A47F29D3BEC93221EFDF4', 'approve1', 'd3000000000000000000000000000001', 'approved', '', 'zkxw', 0, NULL, NULL, '', '2026-05-13 22:24:52', NULL, '2026-05-13 22:25:37', 0);
+INSERT INTO `wf_task` (`id`, `instance_id`, `node_key`, `assignee_user_id`, `status`, `comment_text`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D6B3E052BAED4E5E80FBA930CC974A9F', '9CC8E0387F61441F992DAB624F6B3306', 'approve1', 'd3000000000000000000000000000001', 'pending', NULL, 'zkxw', 0, NULL, NULL, '', '2026-05-13 21:24:48', NULL, '2026-05-13 21:24:48', 0);
+INSERT INTO `wf_task` (`id`, `instance_id`, `node_key`, `assignee_user_id`, `status`, `comment_text`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E725C70E1BBE48C98C5CB95F90CB807C', 'E7A16AA9F37A47F29D3BEC93221EFDF4', 'a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a', '2ac3e6204e7211f19f4700163e3bdd96', 'approved', '', 'zkxw', 0, NULL, NULL, '', '2026-05-13 22:25:38', NULL, '2026-05-13 22:27:50', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for wf_transition
+-- ----------------------------
+DROP TABLE IF EXISTS `wf_transition`;
+CREATE TABLE `wf_transition` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `process_version_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '流程版本ID',
+  `from_node_key` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '起始节点key',
+  `to_node_key` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '目标节点key',
+  `condition_expr` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '条件表达式或分支说明',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_wf_trans_ver` (`process_version_id`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流程连线/转移';
+
+-- ----------------------------
+-- Records of wf_transition
+-- ----------------------------
+BEGIN;
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('04AD539470D54AB5A4FC28E057B2B680', '3DDAC80316AC4DCCA972060531F92723', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('10399C04A55B4DA38ACE3FEA019FD946', '3DDAC80316AC4DCCA972060531F92723', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:21', 'd3000000000000000000000000000001', '2026-05-13 20:59:21', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('339DF4F6AAE547FDA657CF29C2450459', 'E02466CE3C6B4E65A7A0B34C021BE27A', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:00:29', 'd3000000000000000000000000000001', '2026-05-13 21:00:29', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('3B4EF674E6FE43C89F0FA63F42C6B6CD', 'D31763EFEA9B4082B6104576FDB12718', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:02', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('45DA444CB3B24F7187B89DC5891F24FF', 'D676C619406645849BDBA4CD0DB2D999', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:03:12', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('498C033E3BBE42E990E9C885DEA20644', '65E51B403AEF4F458E162797470E83AA', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('503CDA7592004396931DC2AEE9105A46', '1BFEF3BC45FB4B85979203252573251F', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('5C8424B13698421DA74304BDD17891B1', 'E694F38CAC504B51AAF64F102DB88380', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('5CF30C767ADD4EE5BED0DE3086BA09FA', 'E694F38CAC504B51AAF64F102DB88380', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:25', 'd3000000000000000000000000000001', '2026-05-13 21:05:25', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('61D6A14E082444D6BDD21B55F612BE38', 'A0094B798812442AA8E76C13A0E22460', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('6D1874C7C4774B37837075D9C54E7D5C', 'A8762F2E338B406AAF1C7A3A5F25F414', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('751031F1DBE44EADABD976144F4C99C4', 'D31763EFEA9B4082B6104576FDB12718', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:02', 'd3000000000000000000000000000001', '2026-05-13 21:03:02', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7694FDED26CC44CCB8B56575A75BC743', 'A8762F2E338B406AAF1C7A3A5F25F414', 'a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a', 'end', NULL, 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('7DD6218A60114A83A290ABA6859E575E', '3DDD7210942F40CB8D117BCC43144B21', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('87084B1BCE194175924FA8518E2ECB80', '51806057C1D243429BE1316A5945D2F2', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('99CAADD1B54346AAB8F481A14C734FAE', '8644BC4075D843B29FFB703B8F488E0A', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:04', 'd3000000000000000000000000000001', '2026-05-13 21:03:04', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ABE78DF01CA4402688B7BD1BCEAF4436', '51806057C1D243429BE1316A5945D2F2', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:19', 'd3000000000000000000000000000001', '2026-05-13 21:05:19', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('AF7E94DF904B4D70B05A7BDC90E778BA', 'D676C619406645849BDBA4CD0DB2D999', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:12', 'd3000000000000000000000000000001', '2026-05-13 21:03:12', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D32A87BEA9A74126A4D3402D472F3C2B', 'E02466CE3C6B4E65A7A0B34C021BE27A', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:00:29', 'd3000000000000000000000000000001', '2026-05-13 21:00:29', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D573BEF4FC874EA89206FBE834986DD5', 'A0094B798812442AA8E76C13A0E22460', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:34', 'd3000000000000000000000000000001', '2026-05-13 21:05:34', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('D7D0D2361F1C47CBA37292245EC3B501', '3DDD7210942F40CB8D117BCC43144B21', 'approve1', 'end', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:39', 'd3000000000000000000000000000001', '2026-05-13 20:59:39', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('E3B8350921B84FB0A0E5B658A8D1C726', 'A8762F2E338B406AAF1C7A3A5F25F414', 'approve1', 'a66a0f0b-030c-4fcc-970b-eb2a9f33cf9a', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 22:24:32', 'd3000000000000000000000000000001', '2026-05-13 22:24:32', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('F4F6D978432E410CAEA4483087F6EFE2', '1BFEF3BC45FB4B85979203252573251F', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:05:10', 'd3000000000000000000000000000001', '2026-05-13 21:05:10', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('F84D9088BFFC414481841DE340F3BA32', '65E51B403AEF4F458E162797470E83AA', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:59:33', 'd3000000000000000000000000000001', '2026-05-13 20:59:33', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('FBD25BC7D11D4751B6EAAC45A7CC2E9D', '8644BC4075D843B29FFB703B8F488E0A', 'start', 'approve1', NULL, 'zkxw', 0, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 21:03:04', 'd3000000000000000000000000000001', '2026-05-13 21:03:04', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000020', 'WF000000000000000000000000000002', 'start', 'approve1', NULL, 'zkxw', 1, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:56:12', 'd3000000000000000000000000000001', '2026-05-13 20:56:12', 0);
+INSERT INTO `wf_transition` (`id`, `process_version_id`, `from_node_key`, `to_node_key`, `condition_expr`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('WF000000000000000000000000000021', 'WF000000000000000000000000000002', 'approve1', 'end', NULL, 'zkxw', 2, NULL, 'd3000000000000000000000000000001', '', '2026-05-13 20:56:12', 'd3000000000000000000000000000001', '2026-05-13 20:56:12', 0);
+COMMIT;
+
+-- ----------------------------
+-- Table structure for biz_attachment
+-- ----------------------------
+DROP TABLE IF EXISTS `biz_attachment`;
+CREATE TABLE `biz_attachment` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `business_type` varchar(50) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务类型（如 collection_protocol）',
+  `business_id` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '业务主键ID',
+  `original_name` varchar(200) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '原始文件名',
+  `file_ext` varchar(20) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '文件后缀名（如 .pdf .jpg）',
+  `file_url` varchar(500) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'MinIO路径后缀（不含前缀）',
+  `file_size` bigint(20) DEFAULT NULL COMMENT '文件大小（字节）',
+  `file_type` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'MIME类型',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  KEY `idx_att_biz` (`business_type`,`business_id`,`del_flag`),
+  KEY `idx_att_tenant` (`tenant_no`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='业务附件';
+
+-- ----------------------------
+-- Records of biz_attachment
+-- ----------------------------
+BEGIN;
+COMMIT;
+
+
+
+-- ----------------------------
+-- Table structure for sys_ethnic (民族码表)
+-- ----------------------------
+-- 民族码表（国标 GB/T 3304，仅数字编码条目，不含字母编码重复项）
+-- 执行前请确认库中无同名表；与 docs/sql/zkxw.sql 全量基线可并存，亦可合并进全量导出
+
+DROP TABLE IF EXISTS `sys_ethnic`;
+CREATE TABLE `sys_ethnic` (
+  `id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '主键ID',
+  `ethnic_name` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '民族名称',
+  `ethnic_code` varchar(16) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '民族编码',
+  `tenant_no` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '租户编号（空=全局码表）',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '创建人id',
+  `create_dept_id` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '创建人部门ID',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '更新人id',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记：0-正常 1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_sys_ethnic_code` (`ethnic_code`,`del_flag`),
+  KEY `idx_sys_ethnic_name` (`ethnic_name`,`del_flag`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='民族码表';
+
+BEGIN;
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-01', '汉族', '01', '', 1, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-02', '蒙古族', '02', '', 2, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-03', '回族', '03', '', 3, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-04', '藏族', '04', '', 4, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-05', '维吾尔族', '05', '', 5, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-06', '苗族', '06', '', 6, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-07', '彝族', '07', '', 7, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-08', '壮族', '08', '', 8, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-09', '布依族', '09', '', 9, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-10', '朝鲜族', '10', '', 10, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-11', '满族', '11', '', 11, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-12', '侗族', '12', '', 12, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-13', '瑶族', '13', '', 13, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-14', '白族', '14', '', 14, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-15', '土家族', '15', '', 15, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-16', '哈尼族', '16', '', 16, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-17', '哈萨克族', '17', '', 17, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-18', '傣族', '18', '', 18, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-19', '黎族', '19', '', 19, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-20', '傈僳族', '20', '', 20, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-21', '佤族', '21', '', 21, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-22', '畲族', '22', '', 22, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-23', '高山族', '23', '', 23, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-24', '拉祜族', '24', '', 24, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-25', '水族', '25', '', 25, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-26', '东乡族', '26', '', 26, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-27', '纳西族', '27', '', 27, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-28', '景颇族', '28', '', 28, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-29', '柯尔克孜族', '29', '', 29, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-30', '土族', '30', '', 30, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-31', '达斡尔族', '31', '', 31, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-32', '仫佬族', '32', '', 32, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-33', '羌族', '33', '', 33, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-34', '布朗族', '34', '', 34, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-35', '撒拉族', '35', '', 35, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-36', '毛难族', '36', '', 36, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-37', '仡佬族', '37', '', 37, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-38', '锡伯族', '38', '', 38, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-39', '阿昌族', '39', '', 39, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-40', '普米族', '40', '', 40, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-41', '塔吉克族', '41', '', 41, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-42', '怒族', '42', '', 42, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-43', '乌孜别克族', '43', '', 43, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-44', '俄罗斯族', '44', '', 44, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-45', '鄂温克族', '45', '', 45, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-46', '德昂族', '46', '', 46, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-47', '保安族', '47', '', 47, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-48', '裕固族', '48', '', 48, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-49', '京族', '49', '', 49, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-50', '塔塔尔族', '50', '', 50, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-51', '独龙族', '51', '', 51, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-52', '鄂伦春族', '52', '', 52, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-53', '赫哲族', '53', '', 53, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-54', '门巴族', '54', '', 54, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-55', '珞巴族', '55', '', 55, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-56', '基诺族', '56', '', 56, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-81', '穿青人族', '81', '', 57, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-97', '其他', '97', '', 58, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+INSERT INTO `sys_ethnic` (`id`, `ethnic_name`, `ethnic_code`, `tenant_no`, `order_num`, `remark`, `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`) VALUES ('ethnic-98', '外国血统中国籍人士', '98', '', 59, NULL, NULL, '', '2026-05-16 00:00:00', NULL, '2026-05-16 00:00:00', 0);
+COMMIT;
+
+SET FOREIGN_KEY_CHECKS = 1;
diff --git a/docs/superpowers/plans/2026-05-13-cell-storage-protocol-modules.md b/docs/superpowers/plans/2026-05-13-cell-storage-protocol-modules.md
new file mode 100644
index 00000000..b9a257d6
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-13-cell-storage-protocol-modules.md
@@ -0,0 +1,59 @@
+# 细胞存储管理（2.2.6～2.2.10）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:** 交付细胞存储管理一级菜单下 5 个页面及对应后端 API（方案 C），满足已定稿设计：`docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md` 与 OpenSpec 变更 `openspec/changes/cell-storage-protocol-modules/`。
+
+**Architecture:** FastAPI 路由挂在 `/web/admin` 旁路扩展；SQLAlchemy Model 覆盖四张业务表；CRUD 层封装租户过滤与 camelCase 列表 DTO；Vue 页面复制 `system/unit` 列表骨架并按模块替换列与弹窗。
+
+**Tech Stack:** Python 3.9、FastAPI、SQLAlchemy、Pydantic v2；Vue 3、Element Plus、pnpm、TypeScript。
+
+---
+
+## 文件映射（落地前对齐）
+
+| 区域 | 路径 |
+|------|------|
+| 设计/契约 | `docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md`，`openspec/changes/cell-storage-protocol-modules/` |
+| Model | `backend/app/models/models.py` |
+| CRUD | `backend/app/crud/collection_protocol.py`（或按职责拆分文件） |
+| API | `backend/app/api/collection_protocol.py`，注册 `app/api/__init__.py`、`main.py` |
+| 菜单 | `backend/app/api/menu.py` |
+| 前端路由 | `web-admin/src/router/modules/sqxp.ts` |
+| 前端 API | `web-admin/src/api/collection-protocol.ts`（命名以仓库惯例为准） |
+| 页面 | `web-admin/src/views/cell-storage/{protocol,protocol-audit,payment-confirm,refund-confirm,installment-warning}/index.vue` |
+
+---
+
+## 执行清单（与 OpenSpec tasks.md 同步）
+
+按顺序执行 `openspec/changes/cell-storage-protocol-modules/tasks.md` 中章节 **1 → 7**。每完成一节，将对应 `- [ ]` 改为 `- [x]`。
+
+---
+
+## Self-review（对照 spec）
+
+| Spec capability | tasks.md 覆盖 |
+|-----------------|---------------|
+| cell-storage-collection-protocol | 1.x、2.x、5.1、3.x |
+| cell-storage-protocol-audit | 1.x、2.x、5.2 |
+| cell-storage-receipt-confirm | 1.x、2.x、5.3 |
+| cell-storage-refund-confirm | 1.x、2.x、5.4 |
+| cell-storage-installment-warning | 1.x、2.x、5.5 |
+
+无占位：具体接口路径与状态码以实现对照 design.md 为准。
+
+---
+
+## Execution Handoff
+
+Plan complete and saved to `docs/superpowers/plans/2026-05-13-cell-storage-protocol-modules.md`.
+
+**Two execution options:**
+
+1. **Subagent-Driven（推荐）** — 每个 task 派生子代理并在任务间复核  
+2. **Inline Execution** — 本会话按 `openspec apply` 逐项实现（使用 executing-plans）
+
+**Which approach?** 若未指定，默认本会话按 OpenSpec `tasks.md` 顺序实现。
+
+下一步命令：`openspec instructions apply --change cell-storage-protocol-modules --json` 读取上下文文件后开始改代码。
diff --git a/docs/superpowers/plans/2026-05-13-flow-designer-enhancements.md b/docs/superpowers/plans/2026-05-13-flow-designer-enhancements.md
new file mode 100644
index 00000000..cbfbf07f
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-13-flow-designer-enhancements.md
@@ -0,0 +1,535 @@
+# FlowDesigner 功能补全实施计划
+
+> **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:** 补全流程设计器三个核心功能缺口：审批人选择（用户/角色下拉数据加载）、连线条件分支配置（点击连线编辑条件表达式）、SQL查询帮助提示。
+
+**Architecture:** 后端新增2个轻量options端点；前端FlowDesigner.vue增加edge:click事件处理、selectedEdge状态、条件表达式编辑面板、以及handleOpen时加载用户/角色数据。
+
+**Tech Stack:** Python FastAPI, Vue 3 + Element Plus, AntV X6
+
+---
+
+## File Structure
+
+| 文件 | 操作 | 职责 |
+|------|------|------|
+| `backend/app/api/admin.py` | 修改 | 新增 `GET /web/admin/users/options` 和 `GET /web/admin/roles/options` |
+| `web-admin/src/api/admin.ts` | 修改 | 新增 `fetchUserOptions()` 和 `fetchRoleOptions()` |
+| `web-admin/src/views/system/workflow/designer/FlowDesigner.vue` | 修改 | 核心改动：edge事件、selectedEdge、条件编辑面板、数据加载 |
+
+---
+
+### Task 1: 后端新增 users/options 和 roles/options 端点
+
+**Files:**
+- Modify: `backend/app/api/admin.py` — 在 `list_roles_for_select`（line 33）后面新增两个端点
+
+- [ ] **Step 1: 新增 `GET /web/admin/users/options` 端点**
+
+在 `admin.py` 的 `list_roles_for_select` 函数后面（约 line 63 之后），添加：
+
+```python
+@router.get("/users/options")
+async def list_users_for_select(
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    """返回用户下拉选项（label=昵称，value=用户ID），供流程设计器审批人选择使用。"""
+    tenant_no = _user.get("tenant_no", "")
+    q = db.query(SysUser).filter(SysUser.del_flag == 0, SysUser.status == "1")
+    if tenant_no:
+        q = q.filter(SysUser.tenant_no == tenant_no)
+    rows = q.order_by(SysUser.order_num.asc(), SysUser.create_time.desc()).all()
+    out = [{"label": (r.nick_name or r.user_no or ""), "value": r.id} for r in rows]
+    return success_response(out)
+```
+
+注意：顶部已有 `from app.models.models import SysUser, SysRole, ...` 等导入，无需新增。
+
+- [ ] **Step 2: 新增 `GET /web/admin/roles/options` 端点**
+
+紧接上面的函数后面添加：
+
+```python
+@router.get("/roles/options")
+async def list_roles_for_designer(
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    """返回角色下拉选项（label=角色名，value=角色ID UUID），供流程设计器审批人选择使用。
+    与 /roles 不同，此端点返回角色 UUID 作为 value（引擎解析审批人需要 UUID）。"""
+    tenant_no = _user.get("tenant_no", "")
+    q = db.query(SysRole).filter(SysRole.del_flag == 0, SysRole.status == "1")
+    if tenant_no:
+        q = q.filter(SysRole.tenant_no == tenant_no)
+    rows = q.order_by(SysRole.order_num.asc()).all()
+    out = [{"label": (r.role_name or "").strip(), "value": r.id} for r in rows if (r.role_name or "").strip()]
+    return success_response(out)
+```
+
+- [ ] **Step 3: 验证后端启动**
+
+```bash
+cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.api.admin import router; print('OK')"
+```
+
+Expected: `OK`
+
+---
+
+### Task 2: 前端 API 函数 + 设计器加载用户/角色数据
+
+**Files:**
+- Modify: `web-admin/src/api/admin.ts` — 新增两个 API 函数
+- Modify: `web-admin/src/views/system/workflow/designer/FlowDesigner.vue` — 导入 API、handleOpen 加载数据
+
+- [ ] **Step 1: 在 `admin.ts` 新增两个 API 函数**
+
+在 `fetchGetRoleList()`（line 18-22）后面添加：
+
+```typescript
+/** 流程设计器：用户下拉选项（label=昵称，value=用户ID） */
+export function fetchUserOptions() {
+  return request.get<Array<{ label: string; value: string }>>({
+    url: '/web/admin/users/options'
+  })
+}
+
+/** 流程设计器：角色下拉选项（label=角色名，value=角色ID UUID） */
+export function fetchRoleOptions() {
+  return request.get<Array<{ label: string; value: string }>>({
+    url: '/web/admin/roles/options'
+  })
+}
+```
+
+- [ ] **Step 2: 在 FlowDesigner.vue 导入新 API 并加载选项数据**
+
+修改 line 146 的 import 语句：
+
+```typescript
+import { fetchDesignerData, fetchPublishVersion } from '@/api/workflow'
+```
+
+改为：
+
+```typescript
+import { fetchDesignerData, fetchPublishVersion } from '@/api/workflow'
+import { fetchUserOptions, fetchRoleOptions } from '@/api/admin'
+```
+
+然后在 `handleOpen()` 函数（line 742-748）中添加数据加载：
+
+```typescript
+function handleOpen() {
+  selectedNode.value = null
+  selectedEdge.value = null
+  registerShapes()
+  nextTick(() => {
+    initGraph()
+    loadDesignerData()
+    loadOptions()
+  })
+}
+
+async function loadOptions() {
+  try {
+    const [users, roles] = await Promise.all([fetchUserOptions(), fetchRoleOptions()])
+    userOptions.value = users || []
+    roleOptions.value = roles || []
+  } catch {
+    // 加载失败则保持空选项，不影响设计器其他功能
+  }
+}
+```
+
+注意：`selectedEdge` 在 Task 3 中定义。
+
+---
+
+### Task 3: 连线点击 + 条件表达式编辑器 + 连线标签
+
+**Files:**
+- Modify: `web-admin/src/views/system/workflow/designer/FlowDesigner.vue`
+
+这是最核心的改动。需要在 FlowDesigner.vue 中完成以下修改：
+
+- [ ] **Step 1: 新增 `selectedEdge` 响应式状态和接口定义**
+
+在 `selectedNode` 定义（line 201）后面添加：
+
+```typescript
+interface ConditionRule {
+  field: string
+  op: string
+  value: string
+}
+
+interface SelectedEdgeData {
+  id: string
+  fromNodeName: string
+  toNodeName: string
+  rules: ConditionRule[]
+  isDefault: boolean
+}
+
+const selectedEdge = ref<SelectedEdgeData | null>(null)
+```
+
+- [ ] **Step 2: 注册 edge:click 事件 + 修改 blank:click 和 node:click 清除 selectedEdge**
+
+在 `initGraph()` 函数中，`graph.on('blank:click', ...)` （line 560-563）后面添加 edge 事件：
+
+```typescript
+// 连线点击 → 选中（仅条件节点的出线可编辑条件）
+graph.on('edge:click', ({ edge }) => {
+  const sourceId = edge.getSourceCellId() || ''
+  const sourceNode = graph!.getCellById(sourceId)
+  const sourceData = sourceNode?.getData() || {}
+  const targetId = edge.getTargetCellId() || ''
+  const targetNode = graph!.getCellById(targetId)
+  const targetData = targetNode?.getData() || {}
+
+  const edgeData = edge.getData() || {}
+  const rawRules = edgeData.conditionExpr ? (JSON.parse(edgeData.conditionExpr) || {}) : {}
+  const rules: ConditionRule[] = rawRules.rules || rawRules || []
+  // 确保至少有一条规则
+  if (!Array.isArray(rules) || rules.length === 0) {
+    rules.push({ field: '', op: '==', value: '' })
+  }
+  // 规范化为 ConditionRule[]（只保留简单的 field/op/value 三元组）
+  const normalizedRules: ConditionRule[] = rules.map((r: any) => ({
+    field: r.field || '',
+    op: r.op || '==',
+    value: String(r.value ?? ''),
+  }))
+
+  selectedEdge.value = {
+    id: edge.id,
+    fromNodeName: sourceData.nodeName || sourceId,
+    toNodeName: targetData.nodeName || targetId,
+    rules: normalizedRules,
+    isDefault: !edgeData.conditionExpr,
+  }
+  selectedNode.value = null
+})
+```
+
+同时修改 `blank:click` 和 `node:click` 事件处理，在清除/设置 `selectedNode` 时也清除 `selectedEdge`：
+
+```typescript
+// node:click 处理中添加：
+selectedEdge.value = null
+
+// blank:click 处理中改为：
+graph.on('blank:click', () => {
+  selectedNode.value = null
+  selectedEdge.value = null
+})
+```
+
+- [ ] **Step 3: 连线创建时初始化 data**
+
+在 `createEdge()` 函数（约 line 522-539）中，给新创建的 edge 加上 data 初始化：
+
+在 `graph!.createEdge({...})` 调用中添加 `data: { conditionExpr: '' }` 属性：
+
+```typescript
+createEdge() {
+  return graph!.createEdge({
+    shape: 'edge',
+    data: { conditionExpr: '' },
+    attrs: {
+      // ... 保持原有 attrs 不变
+    },
+    router: { name: 'manhattan' },
+    connector: { name: 'rounded', args: { radius: 8 } },
+  })
+}
+```
+
+- [ ] **Step 4: 添加同步连线条件数据到 graph edge 的函数**
+
+在 `syncNodeLabel` 函数后面添加：
+
+```typescript
+// 同步条件表达式到 edge 并更新标签
+function syncEdgeCondition() {
+  if (!selectedEdge.value || !graph) return
+  const edge = graph.getCellById(selectedEdge.value.id)
+  if (!edge || !edge.isEdge()) return
+
+  if (selectedEdge.value.isDefault) {
+    edge.setData({ ...edge.getData(), conditionExpr: '' })
+    edge.setLabels([])
+  } else {
+    const rules = selectedEdge.value.rules
+      .filter((r) => r.field.trim())
+      .map((r) => ({ field: r.field, op: r.op, value: r.value }))
+    const expr = JSON.stringify({ rules })
+    edge.setData({ ...edge.getData(), conditionExpr: expr })
+    // 设置标签显示条件摘要
+    const summary = rules.map((r) => `${r.field} ${r.op} ${r.value}`).join(' & ')
+    edge.setLabels([
+      {
+        attrs: {
+          label: {
+            text: summary || '条件',
+            fill: '#374151',
+            fontSize: 11,
+            textAnchor: 'middle',
+            textVerticalAnchor: 'bottom',
+          },
+          rect: {
+            fill: '#fff',
+            stroke: '#d1d5db',
+            strokeWidth: 1,
+            rx: 4,
+            ry: 4,
+          },
+        },
+        position: {
+          distance: 0.5,
+        },
+      },
+    ])
+  }
+}
+```
+
+- [ ] **Step 5: 修改序列化函数，从 edge data 读取 conditionExpr**
+
+当前 `serializeGraph()` 已经正确读取 `e.getData()?.conditionExpr`（line 670），无需修改。确认即可。
+
+- [ ] **Step 6: 修改模板 — 右侧属性面板增加连线编辑状态**
+
+在模板的 `<aside class="props-panel">` 中（line 60-138），修改三态逻辑：
+
+将原来的 `<template v-if="selectedNode">` ... `<template v-else>` 结构改为三态：
+
+```html
+<!-- 右侧属性面板 -->
+<aside class="props-panel">
+  <!-- 节点选中状态 -->
+  <template v-if="selectedNode">
+    <div class="panel-section-title">节点属性</div>
+    <el-form label-position="top" class="props-form">
+      <!-- ... 保持原有节点属性表单不变 (lines 64-132) ... -->
+    </el-form>
+  </template>
+
+  <!-- 连线选中状态（条件编辑） -->
+  <template v-else-if="selectedEdge">
+    <div class="panel-section-title">连线条件</div>
+    <div class="edge-info">
+      <span class="edge-from">{{ selectedEdge.fromNodeName }}</span>
+      <span class="edge-arrow">→</span>
+      <span class="edge-to">{{ selectedEdge.toNodeName }}</span>
+    </div>
+
+    <el-form label-position="top" class="props-form" style="margin-top: 12px">
+      <el-form-item>
+        <el-checkbox v-model="selectedEdge.isDefault" @change="syncEdgeCondition">
+          默认分支（无条件，其他分支都不满足时走此路径）
+        </el-checkbox>
+      </el-form-item>
+
+      <template v-if="!selectedEdge.isDefault">
+        <div v-for="(rule, idx) in selectedEdge.rules" :key="idx" class="condition-rule-row">
+          <el-input v-model="rule.field" placeholder="字段名" style="width: 30%" @input="syncEdgeCondition" />
+          <el-select v-model="rule.op" style="width: 22%" @change="syncEdgeCondition">
+            <el-option label="==" value="==" />
+            <el-option label="!=" value="!=" />
+            <el-option label=">" value=">" />
+            <el-option label="<" value="<" />
+            <el-option label=">=" value=">=" />
+            <el-option label="<=" value="<=" />
+            <el-option label="in" value="in" />
+            <el-option label="not_in" value="not_in" />
+            <el-option label="contains" value="contains" />
+          </el-select>
+          <el-input v-model="rule.value" placeholder="值" style="width: 30%" @input="syncEdgeCondition" />
+          <el-button
+            :icon="selectedEdge.rules.length > 1 ? 'Delete' : undefined"
+            text
+            type="danger"
+            @click="removeConditionRule(idx)"
+          />
+        </div>
+        <el-button type="primary" link @click="addConditionRule">+ 添加条件</el-button>
+      </template>
+    </el-form>
+  </template>
+
+  <!-- 空状态 -->
+  <template v-else>
+    <div class="panel-section-title">属性</div>
+    <div class="empty-hint">点击画布中的节点或连线查看属性</div>
+  </template>
+</aside>
+```
+
+- [ ] **Step 7: 添加条件规则操作函数**
+
+在 `syncEdgeCondition` 函数后面添加：
+
+```typescript
+function addConditionRule() {
+  if (selectedEdge.value) {
+    selectedEdge.value.rules.push({ field: '', op: '==', value: '' })
+  }
+}
+
+function removeConditionRule(idx: number) {
+  if (selectedEdge.value && selectedEdge.value.rules.length > 1) {
+    selectedEdge.value.rules.splice(idx, 1)
+    syncEdgeCondition()
+  }
+}
+```
+
+- [ ] **Step 8: 添加条件编辑面板的 CSS**
+
+在 `<style scoped lang="scss">` 块中添加：
+
+```scss
+.edge-info {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 12px;
+  background: #f9fafb;
+  border-radius: 6px;
+  font-size: 13px;
+  color: #374151;
+}
+
+.edge-from {
+  font-weight: 500;
+}
+
+.edge-arrow {
+  color: #9ca3af;
+}
+
+.edge-to {
+  font-weight: 500;
+}
+
+.condition-rule-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+```
+
+- [ ] **Step 9: 更新操作提示列表**
+
+在左侧面板的操作提示（line 46-51）中，添加连线相关的提示：
+
+```html
+<li>点击连线编辑条件规则</li>
+```
+
+添加在 "从节点连接点拖出连线" 后面。
+
+---
+
+### Task 4: SQL 模式帮助提示
+
+**Files:**
+- Modify: `web-admin/src/views/system/workflow/designer/FlowDesigner.vue`
+
+- [ ] **Step 1: 在 SQL textarea 下方添加帮助提示**
+
+将原有的 SQL textarea（约 line 111-118）修改为：
+
+```html
+<el-form-item v-if="selectedNode.config.strategy === 'sql'" label="SQL查询语句">
+  <el-input
+    v-model="selectedNode.config.sqlExpr"
+    type="textarea"
+    :rows="4"
+    placeholder="SELECT user_id FROM sys_user WHERE ..."
+  />
+  <div class="sql-help">
+    <p><strong>SQL审批人策略说明：</strong></p>
+    <ul>
+      <li>必须以 <code>SELECT</code> 开头，只允许只读查询</li>
+      <li>查询结果第一列将作为审批人 user_id</li>
+      <li>可使用流程变量作为参数：<code>:var_name</code> 占位符</li>
+      <li>禁止 INSERT / UPDATE / DELETE / DROP 等写操作</li>
+    </ul>
+    <p class="sql-example">示例：<code>SELECT id FROM sys_user WHERE dept_id = :dept_id AND del_flag = 0</code></p>
+  </div>
+</el-form-item>
+```
+
+- [ ] **Step 2: 添加 SQL 帮助样式**
+
+在 scoped style 中添加：
+
+```scss
+.sql-help {
+  margin-top: 8px;
+  padding: 10px 12px;
+  background: #f0fdf4;
+  border: 1px solid #bbf7d0;
+  border-radius: 6px;
+  font-size: 12px;
+  color: #374151;
+  line-height: 1.6;
+
+  p {
+    margin: 0 0 4px;
+  }
+
+  ul {
+    margin: 4px 0;
+    padding-left: 18px;
+  }
+
+  li {
+    margin-bottom: 2px;
+  }
+
+  code {
+    background: #e0f2fe;
+    padding: 1px 4px;
+    border-radius: 3px;
+    font-size: 11px;
+    color: #0369a1;
+  }
+}
+
+.sql-example {
+  margin-top: 6px !important;
+  color: #059669;
+}
+```
+
+---
+
+### Task 5: 验证
+
+- [ ] **Step 1: 后端验证**
+
+```bash
+cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.api.admin import router; print('OK')"
+```
+
+Expected: `OK`
+
+- [ ] **Step 2: 前端 build 验证**
+
+```bash
+cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm build
+```
+
+Expected: Build 成功，无新增错误
+
+- [ ] **Step 3: LSP 诊断**
+
+对 `FlowDesigner.vue` 运行 `lsp_diagnostics`，确认无类型错误。
diff --git a/docs/superpowers/plans/2026-05-13-flow-designer-enterprise-enhancements.md b/docs/superpowers/plans/2026-05-13-flow-designer-enterprise-enhancements.md
new file mode 100644
index 00000000..08b382ff
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-13-flow-designer-enterprise-enhancements.md
@@ -0,0 +1,612 @@
+# FlowDesigner 企业级增强实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans.
+
+**Goal:** 将流程设计器从基础原型提升到企业可用级别：节点删除、撤销重做、键盘快捷键、AND/OR条件组、发布前验证、缩放工具栏。
+
+**Architecture:** 安装 AntV X6 插件（Selection/Keyboard/History/Snapline/Clipboard），增强 FlowDesigner.vue 的交互能力和条件编辑器，新增验证逻辑。
+
+**Tech Stack:** AntV X6 v3 + X6 插件, Vue 3 + Element Plus
+
+---
+
+## 前置：安装 X6 插件
+
+```bash
+cd web-admin && pnpm add @antv/x6-plugin-selection @antv/x6-plugin-keyboard @antv/x6-plugin-history @antv/x6-plugin-snapline @antv/x6-plugin-clipboard
+```
+
+---
+
+## Phase 1: 交互增强 — 删除 + 撤销重做 + 快捷键
+
+**Files:** `web-admin/src/views/system/workflow/designer/FlowDesigner.vue`
+
+### 1.1 新增插件导入
+```typescript
+import { Selection } from '@antv/x6-plugin-selection'
+import { Keyboard } from '@antv/x6-plugin-keyboard'
+import { History } from '@antv/x6-plugin-history'
+import { Snapline } from '@antv/x6-plugin-snapline'
+import { Clipboard } from '@antv/x6-plugin-clipboard'
+```
+
+### 1.2 Graph 构造函数启用 history
+```typescript
+history: { enabled: true },
+```
+
+### 1.3 initGraph 中注册插件（在 graph 创建后、事件绑定前）
+```typescript
+graph.use(new Selection({ enabled: true, multiple: true, rubberband: true, movable: true, showNodeSelectionBox: true }))
+graph.use(new Keyboard({ enabled: true }))
+graph.use(new Snapline({ enabled: true }))
+graph.use(new Clipboard({ enabled: true }))
+```
+
+### 1.4 键盘快捷键绑定
+```typescript
+// Delete/Backspace 删除选中
+graph.bindKey(['delete', 'backspace'], () => {
+  const cells = graph.getSelectedCells()
+  if (cells.length) {
+    // 保护：不允许删除 start 和 end 节点以外的连线
+    const toRemove = cells.filter((c) => {
+      if (c.isNode()) {
+        const data = c.getData() || {}
+        return data.nodeType !== 'start' && data.nodeType !== 'end'
+      }
+      return true // 边都可以删除
+    })
+    if (toRemove.length) graph.removeCells(toRemove)
+  }
+  selectedNode.value = null
+  selectedEdge.value = null
+  return false
+})
+
+// Undo Ctrl+Z
+graph.bindKey(['ctrl+z', 'meta+z'], () => {
+  if (graph.canUndo()) graph.undo()
+  return false
+})
+
+// Redo Ctrl+Y
+graph.bindKey(['ctrl+y', 'meta+shift+z'], () => {
+  if (graph.canRedo()) graph.redo()
+  return false
+})
+
+// Copy Ctrl+C
+graph.bindKey(['ctrl+c', 'meta+c'], () => {
+  const cells = graph.getSelectedCells().filter((c) => c.isNode())
+  if (cells.length) graph.copy(cells)
+  return false
+})
+
+// Paste Ctrl+V
+graph.bindKey(['ctrl+v', 'meta+v'], () => {
+  if (!graph.isClipboardEmpty()) {
+    const cells = graph.paste({ offset: 32 })
+    graph.cleanSelection()
+    graph.select(cells)
+  }
+  return false
+})
+```
+
+### 1.5 节点/边删除后清除选中状态
+```typescript
+graph.on('cell:removed', () => {
+  selectedNode.value = null
+  selectedEdge.value = null
+})
+```
+
+### 1.6 属性面板增加删除按钮
+在节点属性面板的顶部，节点名称旁边增加删除按钮：
+```html
+<div style="display: flex; align-items: center; justify-content: space-between">
+  <span style="font-weight: 500">节点属性</span>
+  <el-button
+    v-if="selectedNode.nodeType !== 'start' && selectedNode.nodeType !== 'end'"
+    type="danger"
+    text
+    size="small"
+    @click="deleteSelectedNode"
+  >
+    删除节点
+  </el-button>
+</div>
+```
+
+在连线条件面板顶部也增加删除按钮：
+```html
+<div style="display: flex; align-items: center; justify-content: space-between">
+  <span class="panel-section-title" style="margin: 0">连线条件</span>
+  <el-button type="danger" text size="small" @click="deleteSelectedEdge">删除连线</el-button>
+</div>
+```
+
+### 1.7 删除函数
+```typescript
+function deleteSelectedNode() {
+  if (!selectedNode.value || !graph) return
+  const cell = graph.getCellById(selectedNode.value.id)
+  if (cell) graph.removeCell(cell)
+  selectedNode.value = null
+}
+
+function deleteSelectedEdge() {
+  if (!selectedEdge.value || !graph) return
+  const cell = graph.getCellById(selectedEdge.value.id)
+  if (cell) graph.removeCell(cell)
+  selectedEdge.value = null
+}
+```
+
+### 1.8 工具栏增加撤销/重做按钮
+在 header 的按钮区域增加撤销/重做：
+```html
+<el-button class="btn-ghost" :disabled="!canUndo" @click="handleUndo">撤销</el-button>
+<el-button class="btn-ghost" :disabled="!canRedo" @click="handleRedo">重做</el-button>
+```
+
+新增响应式状态和函数：
+```typescript
+const canUndo = ref(false)
+const canRedo = ref(false)
+
+// 在 initGraph 中，history 插件注册后：
+graph.on('history:change', () => {
+  canUndo.value = graph?.canUndo() ?? false
+  canRedo.value = graph?.canRedo() ?? false
+})
+
+function handleUndo() {
+  if (graph?.canUndo()) graph.undo()
+}
+
+function handleRedo() {
+  if (graph?.canRedo()) graph.redo()
+}
+```
+
+---
+
+## Phase 2: 条件表达式增强 — AND/OR 分组 + 流程变量提示
+
+### 2.1 数据模型改为分组结构
+
+替换 `ConditionRule` 接口为分组结构：
+```typescript
+interface ConditionRule {
+  field: string
+  op: string
+  value: string
+}
+
+interface ConditionGroup {
+  logic: 'and' | 'or'  // 组内规则之间的逻辑
+  rules: ConditionRule[]
+}
+```
+
+替换 `SelectedEdgeData` 的 `rules` 为 `groups`：
+```typescript
+interface SelectedEdgeData {
+  id: string
+  fromNodeName: string
+  toNodeName: string
+  groups: ConditionGroup[]  // 组之间是 OR 关系
+  groupLogic: 'or'          // 组间逻辑（固定为 OR）
+  isDefault: boolean
+}
+```
+
+条件语义：组内 AND，组间 OR。即 `(rule1 AND rule2) OR (rule3 AND rule4)`
+
+### 2.2 条件编辑器 UI 改为分组模式
+
+```html
+<template v-if="!selectedEdge.isDefault">
+  <div v-for="(group, gIdx) in selectedEdge.groups" :key="gIdx" class="condition-group">
+    <div class="group-header">
+      <span class="group-label">条件组 {{ gIdx + 1 }}</span>
+      <span class="group-logic-badge">组内条件全部满足 (AND)</span>
+      <el-button
+        v-if="selectedEdge.groups.length > 1"
+        type="danger"
+        text
+        size="small"
+        @click="removeConditionGroup(gIdx)"
+      >
+        删除组
+      </el-button>
+    </div>
+    <div v-for="(rule, rIdx) in group.rules" :key="rIdx" class="condition-rule-row">
+      <el-input v-model="rule.field" placeholder="字段名(流程变量)" style="width: 28%" @input="syncEdgeCondition" />
+      <el-select v-model="rule.op" style="width: 20%" @change="syncEdgeCondition">
+        <el-option label="==" value="==" />
+        <el-option label="!=" value="!=" />
+        <el-option label=">" value=">" />
+        <el-option label="<" value="<" />
+        <el-option label=">=" value=">=" />
+        <el-option label="<=" value="<=" />
+        <el-option label="包含" value="contains" />
+        <el-option label="不包含" value="not_in" />
+      </el-select>
+      <el-input v-model="rule.value" placeholder="值" style="width: 28%" @input="syncEdgeCondition" />
+      <el-button
+        v-if="group.rules.length > 1"
+        text
+        type="danger"
+        size="small"
+        @click="removeConditionRule(gIdx, rIdx)"
+      >
+        ×
+      </el-button>
+    </div>
+    <el-button type="primary" link size="small" @click="addConditionRule(gIdx)">
+      + 添加条件
+    </el-button>
+  </div>
+  <div class="group-logic-hint">组间关系：任一条件组满足即可 (OR)</div>
+  <el-button type="primary" link @click="addConditionGroup">+ 添加条件组 (OR)</el-button>
+</template>
+```
+
+### 2.3 操作函数更新
+
+```typescript
+function addConditionGroup() {
+  if (selectedEdge.value) {
+    selectedEdge.value.groups.push({ logic: 'and', rules: [{ field: '', op: '==', value: '' }] })
+  }
+}
+
+function removeConditionGroup(gIdx: number) {
+  if (selectedEdge.value && selectedEdge.value.groups.length > 1) {
+    selectedEdge.value.groups.splice(gIdx, 1)
+    syncEdgeCondition()
+  }
+}
+
+function addConditionRule(gIdx: number) {
+  if (selectedEdge.value) {
+    selectedEdge.value.groups[gIdx].rules.push({ field: '', op: '==', value: '' })
+  }
+}
+
+function removeConditionRule(gIdx: number, rIdx: number) {
+  if (selectedEdge.value && selectedEdge.value.groups[gIdx].rules.length > 1) {
+    selectedEdge.value.groups[gIdx].rules.splice(rIdx, 1)
+    syncEdgeCondition()
+  }
+}
+```
+
+### 2.4 syncEdgeCondition 序列化更新
+
+生成与后端引擎兼容的 JSON：
+```typescript
+function syncEdgeCondition() {
+  if (!selectedEdge.value || !graph) return
+  const edge = graph.getCellById(selectedEdge.value.id)
+  if (!edge || !edge.isEdge()) return
+
+  if (selectedEdge.value.isDefault) {
+    edge.setData({ ...edge.getData(), conditionExpr: '' })
+    edge.setLabels([])
+  } else {
+    // 序列化为引擎兼容格式：[{and: [{field,op,value},...]}, {and: [...]}]
+    // 顶层 array = OR 语义（引擎 _check_rules 对 list 做 any()）
+    const groups = selectedEdge.value.groups
+      .filter((g) => g.rules.some((r) => r.field.trim()))
+      .map((g) => ({
+        and: g.rules
+          .filter((r) => r.field.trim())
+          .map((r) => ({ field: r.field, op: r.op, value: r.value })),
+      }))
+    const expr = JSON.stringify(groups)
+    edge.setData({ ...edge.getData(), conditionExpr: expr })
+
+    // 生成可读标签
+    const parts = groups.map((g) =>
+      g.and.map((r) => `${r.field} ${r.op} ${r.value}`).join(' & '),
+    )
+    const summary = parts.join(' | ')
+    edge.setLabels([
+      {
+        attrs: {
+          label: { text: summary || '条件', fill: '#374151', fontSize: 11, textAnchor: 'middle', textVerticalAnchor: 'bottom' },
+          rect: { fill: '#fff', stroke: '#d1d5db', strokeWidth: 1, rx: 4, ry: 4 },
+        },
+        position: { distance: 0.5 },
+      },
+    ])
+  }
+}
+```
+
+### 2.5 edge:click 解析更新
+
+解析引擎格式到分组 UI：
+```typescript
+// 在 edge:click handler 中：
+let normalizedGroups: ConditionGroup[] = []
+if (edgeData.conditionExpr) {
+  try {
+    const parsed = JSON.parse(edgeData.conditionExpr)
+    if (Array.isArray(parsed)) {
+      // 引擎格式: [{and: [{field,op,value},...]}, ...]
+      normalizedGroups = parsed.map((item: any) => {
+        if (item.and) {
+          return { logic: 'and' as const, rules: item.and.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+        }
+        if (item.or) {
+          return { logic: 'or' as const, rules: item.or.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+        }
+        // 兼容旧格式: [{rules: [...]}]
+        const rawRules = item.rules || [item]
+        return { logic: 'and' as const, rules: rawRules.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+      })
+    } else if (parsed.rules) {
+      // 旧格式: {rules: [{field,op,value},...]}
+      normalizedGroups = [{ logic: 'and', rules: parsed.rules.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }]
+    }
+  } catch {
+    // ignore
+  }
+}
+if (normalizedGroups.length === 0) {
+  normalizedGroups = [{ logic: 'and', rules: [{ field: '', op: '==', value: '' }] }]
+}
+```
+
+### 2.6 流程变量提示
+
+在条件字段输入下方添加提示：
+```html
+<div class="field-hint">
+  <p>字段名为流程发起时传入的变量名，支持点号嵌套路径（如 <code>order.amount</code>）</p>
+  <p>常见变量：<code>amount</code>(金额) <code>department</code>(部门) <code>applicant.dept_id</code>(发起人部门)</p>
+</div>
+```
+
+### 2.7 CSS 新增
+```scss
+.condition-group {
+  background: #f9fafb;
+  border: 1px solid #e5e7eb;
+  border-radius: 6px;
+  padding: 10px;
+  margin-bottom: 10px;
+}
+
+.group-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+
+.group-label {
+  font-size: 13px;
+  font-weight: 500;
+  color: #374151;
+}
+
+.group-logic-badge {
+  font-size: 11px;
+  color: #6b7280;
+  background: #e5e7eb;
+  padding: 2px 6px;
+  border-radius: 3px;
+}
+
+.group-logic-hint {
+  font-size: 12px;
+  color: #6b7280;
+  margin: 8px 0;
+  padding: 4px 8px;
+  background: #fef3c7;
+  border-radius: 4px;
+}
+
+.field-hint {
+  margin-top: 8px;
+  padding: 8px 10px;
+  background: #eff6ff;
+  border: 1px solid #bfdbfe;
+  border-radius: 6px;
+  font-size: 12px;
+  color: #1e40af;
+  line-height: 1.6;
+
+  p { margin: 0 0 2px; }
+  code { background: #dbeafe; padding: 1px 4px; border-radius: 3px; font-size: 11px; }
+}
+```
+
+---
+
+## Phase 3: 保存/发布前验证
+
+### 3.1 验证函数
+```typescript
+interface ValidationError {
+  type: 'error' | 'warning'
+  message: string
+  nodeId?: string
+}
+
+function validateGraph(): ValidationError[] {
+  const errors: ValidationError[] = []
+  if (!graph) return errors
+
+  const cells = graph.getCells()
+  const nodes = cells.filter((c) => c.isNode())
+  const edges = cells.filter((c) => c.isEdge())
+
+  // 1. 必须有且仅有一个开始节点
+  const startNodes = nodes.filter((n) => (n.getData() || {}).nodeType === 'start')
+  if (startNodes.length === 0) {
+    errors.push({ type: 'error', message: '必须有一个开始节点' })
+  } else if (startNodes.length > 1) {
+    errors.push({ type: 'error', message: '只能有一个开始节点', nodeId: startNodes[1].id })
+  }
+
+  // 2. 必须有至少一个结束节点
+  const endNodes = nodes.filter((n) => (n.getData() || {}).nodeType === 'end')
+  if (endNodes.length === 0) {
+    errors.push({ type: 'error', message: '必须至少有一个结束节点' })
+  }
+
+  // 3. 开始节点必须有出边
+  if (startNodes.length === 1) {
+    const hasOutEdge = edges.some((e) => e.getSourceCellId() === startNodes[0].id)
+    if (!hasOutEdge) {
+      errors.push({ type: 'error', message: '开始节点必须连接到下游节点', nodeId: startNodes[0].id })
+    }
+  }
+
+  // 4. 结束节点必须有入边
+  endNodes.forEach((en) => {
+    const hasInEdge = edges.some((e) => e.getTargetCellId() === en.id)
+    if (!hasInEdge) {
+      errors.push({ type: 'error', message: '结束节点必须有入边连接', nodeId: en.id })
+    }
+  })
+
+  // 5. 审批节点必须配置审批人
+  nodes.filter((n) => (n.getData() || {}).nodeType === 'approval').forEach((n) => {
+    const config = (n.getData() || {}).config || {}
+    const strategy = config.strategy || 'users'
+    if (strategy === 'users' && (!config.userIds || config.userIds.length === 0)) {
+      errors.push({ type: 'error', message: `审批节点"${(n.getData() || {}).nodeName || n.id}"未选择审批用户`, nodeId: n.id })
+    }
+    if (strategy === 'roles' && (!config.roleIds || config.roleIds.length === 0)) {
+      errors.push({ type: 'error', message: `审批节点"${(n.getData() || {}).nodeName || n.id}"未选择审批角色`, nodeId: n.id })
+    }
+    if (strategy === 'sql' && (!config.sqlExpr || !config.sqlExpr.trim())) {
+      errors.push({ type: 'error', message: `审批节点"${(n.getData() || {}).nodeName || n.id}"未填写SQL查询`, nodeId: n.id })
+    }
+  })
+
+  // 6. 条件节点必须有至少2条出边
+  nodes.filter((n) => (n.getData() || {}).nodeType === 'condition').forEach((n) => {
+    const outEdges = edges.filter((e) => e.getSourceCellId() === n.id)
+    if (outEdges.length < 2) {
+      errors.push({ type: 'error', message: `条件节点"${(n.getData() || {}).nodeName || n.id}"至少需要2条出边`, nodeId: n.id })
+    }
+  })
+
+  // 7. 孤立节点检查（非开始/结束节点必须有入边和出边）
+  nodes.forEach((n) => {
+    const nodeType = (n.getData() || {}).nodeType
+    if (nodeType === 'start' || nodeType === 'end') return
+    const hasIn = edges.some((e) => e.getTargetCellId() === n.id)
+    const hasOut = edges.some((e) => e.getSourceCellId() === n.id)
+    if (!hasIn || !hasOut) {
+      errors.push({ type: 'warning', message: `节点"${(n.getData() || {}).nodeName || n.id}"未完全连接`, nodeId: n.id })
+    }
+  })
+
+  return errors
+}
+```
+
+### 3.2 在 handlePublish 中调用验证
+```typescript
+async function handlePublish() {
+  const errors = validateGraph()
+  const blockers = errors.filter((e) => e.type === 'error')
+  if (blockers.length > 0) {
+    ElMessage.error(blockers[0].message)
+    // 高亮错误节点
+    if (blockers[0].nodeId && graph) {
+      const cell = graph.getCellById(blockers[0].nodeId)
+      if (cell && cell.isNode()) {
+        graph.resetSelection(cell)
+      }
+    }
+    return
+  }
+  // ... 原有发布逻辑
+}
+```
+
+---
+
+## Phase 4: 缩放工具栏 + 默认分支标记
+
+### 4.1 缩放工具栏
+在 header 按钮区域添加缩放控制：
+```html
+<div class="zoom-controls">
+  <el-button text size="small" @click="handleZoomOut" title="缩小">−</el-button>
+  <span class="zoom-level">{{ zoomLevel }}%</span>
+  <el-button text size="small" @click="handleZoomIn" title="放大">+</el-button>
+  <el-button text size="small" @click="handleZoomReset" title="适应画布">⊞</el-button>
+</div>
+```
+
+```typescript
+const zoomLevel = ref(100)
+
+function handleZoomIn() {
+  if (!graph) return
+  const cur = graph.zoom()
+  graph.zoom(0.1)
+  zoomLevel.value = Math.round((cur + 0.1) * 100)
+}
+
+function handleZoomOut() {
+  if (!graph) return
+  const cur = graph.zoom()
+  graph.zoom(-0.1)
+  zoomLevel.value = Math.round((cur - 0.1) * 100)
+}
+
+function handleZoomReset() {
+  if (!graph) return
+  graph.zoomToFit({ padding: 40, maxScale: 1 })
+  zoomLevel.value = Math.round(graph.zoom() * 100)
+}
+```
+
+### 4.2 默认分支连线标记
+默认分支的连线标签显示"其他情况"：
+```typescript
+// syncEdgeCondition 中，默认分支：
+if (selectedEdge.value.isDefault) {
+  edge.setData({ ...edge.getData(), conditionExpr: '' })
+  edge.setLabels([{
+    attrs: {
+      label: { text: '其他情况', fill: '#9ca3af', fontSize: 11, textAnchor: 'middle', textVerticalAnchor: 'bottom', fontStyle: 'italic' },
+      rect: { fill: '#f9fafb', stroke: '#d1d5db', strokeWidth: 1, rx: 4, ry: 4, strokeDasharray: '3,3' },
+    },
+    position: { distance: 0.5 },
+  }])
+}
+```
+
+### 4.3 CSS
+```scss
+.zoom-controls {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin-right: 12px;
+  padding-right: 12px;
+  border-right: 1px solid #e5e7eb;
+}
+
+.zoom-level {
+  font-size: 12px;
+  color: #6b7280;
+  min-width: 36px;
+  text-align: center;
+}
+```
diff --git a/docs/superpowers/plans/2026-05-13-workflow-module.md b/docs/superpowers/plans/2026-05-13-workflow-module.md
new file mode 100644
index 00000000..e956d5f6
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-13-workflow-module.md
@@ -0,0 +1,2502 @@
+# 工作流模块（2.1.11 流程管理）实施计划
+
+> **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:** 实现完整的自研工作流系统——包含流程配置管理、AntV X6图形化设计器、待办中心、已办中心、后端图遍历引擎。
+
+**Architecture:** 后端图遍历引擎读取 wf_node + wf_transition 关系表执行节点分发。前端 AntV X6 设计器保存 graph_json（设计器快照）+ 同步写入 wf_node/wf_transition（运行时数据）。业务模块通过 API 调用发起流程，引擎通过回调通知业务状态变更。
+
+**Tech Stack:** FastAPI, SQLAlchemy, Pydantic v2, Vue 3, Element Plus, AntV X6, TypeScript
+
+**Design Spec:** `docs/superpowers/specs/2026-05-13-workflow-module-design.md`
+
+---
+
+## File Structure
+
+### Backend（新建文件）
+- `backend/app/models/models.py` — 新增6个wf_*模型（追加到现有文件）
+- `backend/app/schemas/workflow.py` — Pydantic请求/响应schemas
+- `backend/app/crud/workflow.py` — CRUD操作
+- `backend/app/services/workflow_engine.py` — 核心引擎（节点分发、条件评估、审批人解析）
+- `backend/app/services/workflow_callback.py` — 回调服务
+- `backend/app/api/workflow.py` — API路由
+- `backend/app/api/__init__.py` — 注册workflow路由（修改）
+- `backend/app/main.py` — 注册workflow路由（修改）
+- `docs/sql/zkxw.sql` — 数据库全量导出基线；增量 schema 可先落库再重导或另附 `docs/sql/` 补丁（如 `callback_url` 字段）
+
+### Frontend（新建文件）
+- `web-admin/src/api/workflow.ts` — API调用
+- `web-admin/src/types/api.d.ts` — 新增Workflow命名空间（追加）
+- `web-admin/src/views/system/workflow/process/index.vue` — 流程配置管理
+- `web-admin/src/views/system/workflow/designer/FlowDesigner.vue` — AntV X6设计器
+- `web-admin/src/views/system/workflow/task-pending/index.vue` — 待办中心
+- `web-admin/src/views/system/workflow/task-completed/index.vue` — 已办中心
+- `web-admin/src/views/system/workflow/components/ApprovalDialog.vue` — 审批弹窗
+- `web-admin/src/views/system/workflow/components/ProcessStatusTag.vue` — 状态标签
+- `web-admin/src/router/modules/sqxp.ts` — 新增3个路由（修改）
+- `web-admin/src/App.vue` — 标题白名单（修改）
+
+### SQL数据
+- `docs/sql/zkxw.sql` — 全库导出（含 `sys_menu` 等）；若仅需菜单补丁可在 `docs/sql/` 另增增量脚本
+
+---
+
+## Phase 1: Backend Foundation
+
+### Task 1: SQLAlchemy Models（6个wf_*模型）
+
+**Files:**
+- Modify: `backend/app/models/models.py`（追加到文件末尾）
+
+- [ ] **Step 1: 在 models.py 末尾追加6个wf_*模型**
+
+在文件末尾追加以下代码。字段顺序遵循规范：id → 业务字段 → tenant_no → order_num → remark → create_by → create_dept_id → create_time → update_by → update_time → del_flag。
+
+```python
+# =============================================================================
+# 工作流（2.1.11 流程管理）
+# =============================================================================
+
+
+class WfProcessDef(Base):
+    """流程定义 wf_process_def"""
+
+    __tablename__ = "wf_process_def"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_code = Column(String(64), nullable=False, comment="流程编码")
+    process_name = Column(String(200), nullable=False, comment="流程名称")
+    status = Column(CHAR(1), nullable=False, default="1", comment="1启用 0停用")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+
+
+class WfProcessVersion(Base):
+    """流程定义版本 wf_process_version"""
+
+    __tablename__ = "wf_process_version"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_def_id = Column(String(64), nullable=False, comment="流程定义ID")
+    version_no = Column(Integer, nullable=False, comment="版本号，递增")
+    graph_json = Column(Text, nullable=True, comment="节点与连线等配置（JSON字符串）")
+    is_latest = Column(CHAR(1), default="0", comment="是否最新版本 1是 0否")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+
+
+class WfNode(Base):
+    """流程节点 wf_node"""
+
+    __tablename__ = "wf_node"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="流程版本ID")
+    node_key = Column(String(64), nullable=False, comment="节点唯一键（画布内）")
+    node_type = Column(String(32), nullable=False, comment="start/end/approval/condition等")
+    node_name = Column(String(200), nullable=True, comment="节点名称")
+    config_json = Column(Text, nullable=True, comment="审批人/SQL/会签策略等配置")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+
+
+class WfTransition(Base):
+    """流程连线/转移 wf_transition"""
+
+    __tablename__ = "wf_transition"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="流程版本ID")
+    from_node_key = Column(String(64), nullable=False, comment="起始节点key")
+    to_node_key = Column(String(64), nullable=False, comment="目标节点key")
+    condition_expr = Column(String(512), nullable=True, comment="条件表达式JSON")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+
+
+class WfProcessInstance(Base):
+    """流程实例 wf_process_instance"""
+
+    __tablename__ = "wf_process_instance"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    process_version_id = Column(String(64), nullable=False, comment="发起时锁定的流程版本ID")
+    business_type = Column(String(64), nullable=True, comment="业务类型")
+    business_id = Column(String(64), nullable=True, comment="业务主键")
+    starter_user_id = Column(String(64), nullable=True, comment="发起人")
+    variables_json = Column(Text, nullable=True, comment="流程变量JSON")
+    status = Column(String(32), nullable=True, comment="running/completed/rejected/cancelled")
+    callback_url = Column(String(512), nullable=True, comment="业务回调地址")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+
+
+class WfTask(Base):
+    """流程任务/待办 wf_task"""
+
+    __tablename__ = "wf_task"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    instance_id = Column(String(64), nullable=False, comment="流程实例ID")
+    node_key = Column(String(64), nullable=True, comment="当前节点key")
+    assignee_user_id = Column(String(64), nullable=True, comment="待办人")
+    status = Column(String(32), nullable=True, comment="pending/approved/rejected/withdrawn")
+    comment_text = Column(String(512), nullable=True, comment="审批意见")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记 0正常 1已删除")
+```
+
+- [ ] **Step 2: 创建Schema变更SQL**
+
+在目标库执行下列 `ALTER TABLE` 后，将变更纳入 `docs/sql/zkxw.sql`（重导）或 `docs/sql/` 下增量补丁：
+
+```sql
+-- 为 wf_process_instance 新增 callback_url 字段
+ALTER TABLE `wf_process_instance`
+  ADD COLUMN `callback_url` VARCHAR(512) DEFAULT NULL COMMENT '业务回调地址' AFTER `status`;
+```
+
+- [ ] **Step 3: 验证模型可导入**
+
+Run: `cd backend && python -c "from app.models.models import WfProcessDef, WfProcessVersion, WfNode, WfTransition, WfProcessInstance, WfTask; print('OK')"`
+Expected: OK
+
+---
+
+### Task 2: Pydantic Schemas
+
+**Files:**
+- Create: `backend/app/schemas/workflow.py`
+
+- [ ] **Step 1: 创建workflow schemas文件**
+
+```python
+"""Pydantic schemas - 工作流管理"""
+from pydantic import BaseModel, Field
+from typing import Optional, List, Any
+
+
+# ---------------------------------------------------------------------------
+# 流程定义
+# ---------------------------------------------------------------------------
+
+
+class ProcessDefCreate(BaseModel):
+    processCode: str = Field(..., min_length=1, max_length=64, description="流程编码")
+    processName: str = Field(..., min_length=1, max_length=200, description="流程名称")
+    status: Optional[str] = Field("1", description="1启用 0停用")
+    orderNum: Optional[int] = Field(0, description="排序号")
+    remark: Optional[str] = Field(None, description="备注")
+
+
+class ProcessDefUpdate(BaseModel):
+    processCode: Optional[str] = Field(None, min_length=1, max_length=64)
+    processName: Optional[str] = Field(None, min_length=1, max_length=200)
+    status: Optional[str] = None
+    orderNum: Optional[int] = None
+    remark: Optional[str] = None
+
+
+class ProcessDefResponse(BaseModel):
+    id: str
+    processCode: str
+    processName: str
+    status: str
+    latestVersion: Optional[int] = None
+    tenantNo: str
+    orderNum: int
+    remark: Optional[str] = None
+    createTime: str
+    updateTime: str
+
+
+# ---------------------------------------------------------------------------
+# 发布版本
+# ---------------------------------------------------------------------------
+
+
+class NodeData(BaseModel):
+    nodeKey: str = Field(..., description="节点唯一键")
+    nodeType: str = Field(..., description="start/end/approval/condition")
+    nodeName: Optional[str] = None
+    configJson: Optional[str] = None
+
+
+class TransitionData(BaseModel):
+    fromNodeKey: str
+    toNodeKey: str
+    conditionExpr: Optional[str] = None
+
+
+class PublishVersionRequest(BaseModel):
+    graphJson: str = Field(..., description="AntV X6画布JSON快照")
+    nodes: List[NodeData] = Field(default_factory=list)
+    transitions: List[TransitionData] = Field(default_factory=list)
+    remark: Optional[str] = None
+
+
+class VersionResponse(BaseModel):
+    id: str
+    versionNo: int
+    isLatest: str
+    remark: Optional[str] = None
+    createTime: str
+    updateTime: str
+
+
+# ---------------------------------------------------------------------------
+# 发起流程
+# ---------------------------------------------------------------------------
+
+
+class StartInstanceRequest(BaseModel):
+    processCode: str = Field(..., description="流程编码")
+    businessType: Optional[str] = Field(None, description="业务类型")
+    businessId: Optional[str] = Field(None, description="业务主键")
+    variables: Optional[dict] = Field(default_factory=dict, description="流程变量")
+    callbackUrl: Optional[str] = Field(None, description="业务回调地址")
+
+
+class InstanceResponse(BaseModel):
+    id: str
+    processVersionId: str
+    businessType: Optional[str] = None
+    businessId: Optional[str] = None
+    starterUserId: Optional[str] = None
+    status: Optional[str] = None
+    createTime: str
+    updateTime: str
+    tasks: Optional[List[dict]] = None
+
+
+# ---------------------------------------------------------------------------
+# 任务
+# ---------------------------------------------------------------------------
+
+
+class ApproveRequest(BaseModel):
+    commentText: Optional[str] = Field(None, description="审批意见")
+
+
+class TaskResponse(BaseModel):
+    id: str
+    instanceId: str
+    nodeKey: Optional[str] = None
+    assigneeUserId: Optional[str] = None
+    status: Optional[str] = None
+    commentText: Optional[str] = None
+    createTime: str
+    updateTime: str
+    # 关联信息（列表页用）
+    processName: Optional[str] = None
+    businessType: Optional[str] = None
+    businessId: Optional[str] = None
+    starterUserId: Optional[str] = None
+    instanceStatus: Optional[str] = None
+    instanceCreateTime: Optional[str] = None
+```
+
+- [ ] **Step 2: 验证schemas可导入**
+
+Run: `cd backend && python -c "from app.schemas.workflow import ProcessDefCreate, StartInstanceRequest; print('OK')"`
+Expected: OK
+
+---
+
+### Task 3: CRUD Operations
+
+**Files:**
+- Create: `backend/app/crud/workflow.py`
+
+- [ ] **Step 1: 创建workflow CRUD文件**
+
+遵循项目现有CRUD模式（独立函数、`_row_to_dict`、`generate_uuid()`、手动字段映射）。
+
+```python
+"""工作流 CRUD 操作"""
+from __future__ import annotations
+
+import json
+import math
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import and_, func, or_
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.models import (
+    WfProcessDef,
+    WfProcessVersion,
+    WfNode,
+    WfTransition,
+    WfProcessInstance,
+    WfTask,
+    SysUser,
+)
+
+
+# ---------------------------------------------------------------------------
+# 流程定义
+# ---------------------------------------------------------------------------
+
+
+def _def_to_dict(t: WfProcessDef, latest_version: Optional[int] = None) -> Dict[str, Any]:
+    return {
+        "id": t.id,
+        "processCode": t.process_code,
+        "processName": t.process_name,
+        "status": t.status,
+        "latestVersion": latest_version,
+        "tenantNo": t.tenant_no,
+        "orderNum": t.order_num if t.order_num is not None else 0,
+        "remark": t.remark or "",
+        "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+        "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+    }
+
+
+def list_process_defs(
+    db: Session,
+    *,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    def _filtered():
+        q0 = db.query(WfProcessDef).filter(WfProcessDef.del_flag == 0)
+        if tenant_no:
+            q0 = q0.filter(WfProcessDef.tenant_no == tenant_no)
+        if status:
+            q0 = q0.filter(WfProcessDef.status == status)
+        kw = (keyword or "").strip()
+        if kw:
+            like = f"%{kw}%"
+            q0 = q0.filter(
+                or_(WfProcessDef.process_name.like(like), WfProcessDef.process_code.like(like))
+            )
+        return q0
+
+    total = _filtered().order_by(None).with_entities(func.count(WfProcessDef.id)).scalar() or 0
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        _filtered()
+        .order_by(WfProcessDef.order_num.asc(), WfProcessDef.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for r in rows:
+        latest = (
+            db.query(func.max(WfProcessVersion.version_no))
+            .filter(
+                WfProcessVersion.process_def_id == r.id,
+                WfProcessVersion.del_flag == 0,
+            )
+            .scalar()
+        )
+        result.append(_def_to_dict(r, latest_version=latest))
+    return result, int(total)
+
+
+def get_process_def(db: Session, def_id: str) -> Optional[WfProcessDef]:
+    return (
+        db.query(WfProcessDef)
+        .filter(and_(WfProcessDef.id == def_id, WfProcessDef.del_flag == 0))
+        .first()
+    )
+
+
+def process_code_exists(
+    db: Session, code: str, tenant_no: str, exclude_id: Optional[str] = None
+) -> bool:
+    q = db.query(WfProcessDef).filter(
+        and_(WfProcessDef.process_code == code.strip(), WfProcessDef.tenant_no == tenant_no, WfProcessDef.del_flag == 0)
+    )
+    if exclude_id:
+        q = q.filter(WfProcessDef.id != exclude_id)
+    return q.first() is not None
+
+
+def create_process_def(
+    db: Session,
+    *,
+    process_code: str,
+    process_name: str,
+    tenant_no: str,
+    status: str = "1",
+    order_num: int = 0,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfProcessDef:
+    code = (process_code or "").strip()
+    if not code:
+        raise ValueError("流程编码不能为空")
+    if process_code_exists(db, code, tenant_no):
+        raise ValueError("流程编码已存在")
+    obj = WfProcessDef(
+        id=generate_uuid(),
+        process_code=code,
+        process_name=(process_name or "").strip(),
+        status=status,
+        tenant_no=tenant_no,
+        order_num=order_num,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def update_process_def(
+    db: Session,
+    def_id: str,
+    *,
+    process_code: Optional[str] = None,
+    process_name: Optional[str] = None,
+    status: Optional[str] = None,
+    order_num: Optional[int] = None,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> WfProcessDef:
+    obj = get_process_def(db, def_id)
+    if not obj:
+        raise ValueError("流程定义不存在")
+    if process_code is not None:
+        new_code = process_code.strip()
+        if not new_code:
+            raise ValueError("流程编码不能为空")
+        tn = tenant_no or obj.tenant_no
+        if new_code != obj.process_code and process_code_exists(db, new_code, tn, exclude_id=def_id):
+            raise ValueError("流程编码已存在")
+        obj.process_code = new_code
+    if process_name is not None:
+        obj.process_name = (process_name or "").strip()
+    if status is not None:
+        obj.status = status
+    if order_num is not None:
+        obj.order_num = order_num
+    if remark is not None:
+        obj.remark = (remark or "").strip() or None
+    obj.update_by = user_id
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def soft_delete_process_def(db: Session, def_id: str) -> None:
+    obj = get_process_def(db, def_id)
+    if not obj:
+        raise ValueError("流程定义不存在")
+    obj.del_flag = 1
+    obj.update_time = datetime.now()
+    db.add(obj)
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# 发布版本
+# ---------------------------------------------------------------------------
+
+
+def publish_version(
+    db: Session,
+    *,
+    process_def_id: str,
+    graph_json: str,
+    nodes: List[Dict[str, Any]],
+    transitions: List[Dict[str, Any]],
+    tenant_no: str,
+    remark: Optional[str] = None,
+    user_id: Optional[str] = None,
+) -> WfProcessVersion:
+    # 将旧版本 is_latest 置 0
+    db.query(WfProcessVersion).filter(
+        WfProcessVersion.process_def_id == process_def_id,
+        WfProcessVersion.is_latest == "1",
+        WfProcessVersion.del_flag == 0,
+    ).update({"is_latest": "0"}, synchronize_session=False)
+
+    # 计算新版本号
+    max_ver = (
+        db.query(func.max(WfProcessVersion.version_no))
+        .filter(WfProcessVersion.process_def_id == process_def_id, WfProcessVersion.del_flag == 0)
+        .scalar()
+    ) or 0
+    new_ver = max_ver + 1
+
+    # 创建新版本
+    version_id = generate_uuid()
+    version = WfProcessVersion(
+        id=version_id,
+        process_def_id=process_def_id,
+        version_no=new_ver,
+        graph_json=graph_json,
+        is_latest="1",
+        tenant_no=tenant_no,
+        remark=(remark or "").strip() or None,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(version)
+
+    # 写入节点
+    for n in nodes:
+        node = WfNode(
+            id=generate_uuid(),
+            process_version_id=version_id,
+            node_key=n.get("nodeKey", ""),
+            node_type=n.get("nodeType", ""),
+            node_name=n.get("nodeName"),
+            config_json=n.get("configJson"),
+            tenant_no=tenant_no,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        db.add(node)
+
+    # 写入连线
+    for t in transitions:
+        trans = WfTransition(
+            id=generate_uuid(),
+            process_version_id=version_id,
+            from_node_key=t.get("fromNodeKey", ""),
+            to_node_key=t.get("toNodeKey", ""),
+            condition_expr=t.get("conditionExpr"),
+            tenant_no=tenant_no,
+            create_by=user_id,
+            create_dept_id="",
+            create_time=datetime.now(),
+            update_by=user_id,
+            update_time=datetime.now(),
+            del_flag=0,
+        )
+        db.add(trans)
+
+    db.commit()
+    db.refresh(version)
+    return version
+
+
+def get_latest_version(db: Session, process_def_id: str) -> Optional[WfProcessVersion]:
+    return (
+        db.query(WfProcessVersion)
+        .filter(
+            WfProcessVersion.process_def_id == process_def_id,
+            WfProcessVersion.is_latest == "1",
+            WfProcessVersion.del_flag == 0,
+        )
+        .first()
+    )
+
+
+def list_versions(
+    db: Session, process_def_id: str, tenant_no: Optional[str] = None
+) -> List[Dict[str, Any]]:
+    q = db.query(WfProcessVersion).filter(
+        WfProcessVersion.process_def_id == process_def_id,
+        WfProcessVersion.del_flag == 0,
+    )
+    if tenant_no:
+        q = q.filter(WfProcessVersion.tenant_no == tenant_no)
+    rows = q.order_by(WfProcessVersion.version_no.desc()).all()
+    return [
+        {
+            "id": v.id,
+            "versionNo": v.version_no,
+            "isLatest": v.is_latest,
+            "remark": v.remark or "",
+            "createTime": v.create_time.strftime("%Y-%m-%d %H:%M:%S") if v.create_time else "",
+            "updateTime": v.update_time.strftime("%Y-%m-%d %H:%M:%S") if v.update_time else "",
+        }
+        for v in rows
+    ]
+
+
+# ---------------------------------------------------------------------------
+# 流程实例
+# ---------------------------------------------------------------------------
+
+
+def create_instance(
+    db: Session,
+    *,
+    process_version_id: str,
+    business_type: Optional[str] = None,
+    business_id: Optional[str] = None,
+    starter_user_id: Optional[str] = None,
+    variables: Optional[dict] = None,
+    callback_url: Optional[str] = None,
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> WfProcessInstance:
+    obj = WfProcessInstance(
+        id=generate_uuid(),
+        process_version_id=process_version_id,
+        business_type=business_type,
+        business_id=business_id,
+        starter_user_id=starter_user_id,
+        variables_json=json.dumps(variables or {}, ensure_ascii=False),
+        status="running",
+        callback_url=callback_url,
+        tenant_no=tenant_no,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def get_instance(db: Session, instance_id: str) -> Optional[WfProcessInstance]:
+    return (
+        db.query(WfProcessInstance)
+        .filter(and_(WfProcessInstance.id == instance_id, WfProcessInstance.del_flag == 0))
+        .first()
+    )
+
+
+def update_instance_status(db: Session, instance_id: str, status: str) -> None:
+    db.query(WfProcessInstance).filter(WfProcessInstance.id == instance_id).update(
+        {"status": status, "update_time": datetime.now()}, synchronize_session=False
+    )
+    db.commit()
+
+
+# ---------------------------------------------------------------------------
+# 任务
+# ---------------------------------------------------------------------------
+
+
+def create_task(
+    db: Session,
+    *,
+    instance_id: str,
+    node_key: str,
+    assignee_user_id: str,
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> WfTask:
+    obj = WfTask(
+        id=generate_uuid(),
+        instance_id=instance_id,
+        node_key=node_key,
+        assignee_user_id=assignee_user_id,
+        status="pending",
+        tenant_no=tenant_no,
+        create_by=user_id,
+        create_dept_id="",
+        create_time=datetime.now(),
+        update_by=user_id,
+        update_time=datetime.now(),
+        del_flag=0,
+    )
+    db.add(obj)
+    db.commit()
+    db.refresh(obj)
+    return obj
+
+
+def get_task(db: Session, task_id: str) -> Optional[WfTask]:
+    return (
+        db.query(WfTask)
+        .filter(and_(WfTask.id == task_id, WfTask.del_flag == 0))
+        .first()
+    )
+
+
+def get_pending_tasks_by_node(
+    db: Session, instance_id: str, node_key: str
+) -> List[WfTask]:
+    return (
+        db.query(WfTask)
+        .filter(
+            WfTask.instance_id == instance_id,
+            WfTask.node_key == node_key,
+            WfTask.status == "pending",
+            WfTask.del_flag == 0,
+        )
+        .all()
+    )
+
+
+def list_pending_tasks(
+    db: Session,
+    *,
+    user_id: str,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    """我的待办列表"""
+    q = (
+        db.query(WfTask, WfProcessInstance, WfProcessVersion, WfProcessDef)
+        .join(WfProcessInstance, WfTask.instance_id == WfProcessInstance.id)
+        .join(WfProcessVersion, WfProcessInstance.process_version_id == WfProcessVersion.id)
+        .join(WfProcessDef, WfProcessVersion.process_def_id == WfProcessDef.id)
+        .filter(
+            WfTask.assignee_user_id == user_id,
+            WfTask.status == "pending",
+            WfTask.del_flag == 0,
+            WfProcessInstance.del_flag == 0,
+        )
+    )
+    if tenant_no:
+        q = q.filter(WfTask.tenant_no == tenant_no)
+    if keyword and keyword.strip():
+        like = f"%{keyword.strip()}%"
+        q = q.filter(WfProcessDef.process_name.like(like))
+
+    total = q.count()
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q.order_by(WfTask.create_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for task, inst, ver, pdef in rows:
+        result.append({
+            "id": task.id,
+            "instanceId": task.instance_id,
+            "nodeKey": task.node_key,
+            "assigneeUserId": task.assignee_user_id,
+            "status": task.status,
+            "createTime": task.create_time.strftime("%Y-%m-%d %H:%M:%S") if task.create_time else "",
+            "updateTime": task.update_time.strftime("%Y-%m-%d %H:%M:%S") if task.update_time else "",
+            "processName": pdef.process_name,
+            "businessType": inst.business_type,
+            "businessId": inst.business_id,
+            "starterUserId": inst.starter_user_id,
+            "instanceStatus": inst.status,
+            "instanceCreateTime": inst.create_time.strftime("%Y-%m-%d %H:%M:%S") if inst.create_time else "",
+        })
+    return result, int(total)
+
+
+def list_completed_tasks(
+    db: Session,
+    *,
+    user_id: str,
+    page: int = 1,
+    page_size: int = 10,
+    keyword: Optional[str] = None,
+    tenant_no: Optional[str] = None,
+) -> Tuple[List[Dict[str, Any]], int]:
+    """我的已办列表"""
+    q = (
+        db.query(WfTask, WfProcessInstance, WfProcessVersion, WfProcessDef)
+        .join(WfProcessInstance, WfTask.instance_id == WfProcessInstance.id)
+        .join(WfProcessVersion, WfProcessInstance.process_version_id == WfProcessVersion.id)
+        .join(WfProcessDef, WfProcessVersion.process_def_id == WfProcessDef.id)
+        .filter(
+            WfTask.assignee_user_id == user_id,
+            WfTask.status.in_(["approved", "rejected"]),
+            WfTask.del_flag == 0,
+            WfProcessInstance.del_flag == 0,
+        )
+    )
+    if tenant_no:
+        q = q.filter(WfTask.tenant_no == tenant_no)
+    if keyword and keyword.strip():
+        like = f"%{keyword.strip()}%"
+        q = q.filter(WfProcessDef.process_name.like(like))
+
+    total = q.count()
+    page = max(1, page)
+    page_size = min(max(1, page_size), 100)
+    rows = (
+        q.order_by(WfTask.update_time.desc())
+        .offset((page - 1) * page_size)
+        .limit(page_size)
+        .all()
+    )
+    result = []
+    for task, inst, ver, pdef in rows:
+        result.append({
+            "id": task.id,
+            "instanceId": task.instance_id,
+            "nodeKey": task.node_key,
+            "assigneeUserId": task.assignee_user_id,
+            "status": task.status,
+            "commentText": task.comment_text,
+            "createTime": task.create_time.strftime("%Y-%m-%d %H:%M:%S") if task.create_time else "",
+            "updateTime": task.update_time.strftime("%Y-%m-%d %H:%M:%S") if task.update_time else "",
+            "processName": pdef.process_name,
+            "businessType": inst.business_type,
+            "businessId": inst.business_id,
+            "starterUserId": inst.starter_user_id,
+            "instanceStatus": inst.status,
+            "instanceCreateTime": inst.create_time.strftime("%Y-%m-%d %H:%M:%S") if inst.create_time else "",
+        })
+    return result, int(total)
+
+
+# ---------------------------------------------------------------------------
+# 节点/连线查询
+# ---------------------------------------------------------------------------
+
+
+def get_nodes_by_version(db: Session, version_id: str) -> List[WfNode]:
+    return (
+        db.query(WfNode)
+        .filter(WfNode.process_version_id == version_id, WfNode.del_flag == 0)
+        .all()
+    )
+
+
+def get_transitions_by_version(db: Session, version_id: str) -> List[WfTransition]:
+    return (
+        db.query(WfTransition)
+        .filter(WfTransition.process_version_id == version_id, WfTransition.del_flag == 0)
+        .all()
+    )
+
+
+def total_pages(total: int, page_size: int) -> int:
+    if total <= 0:
+        return 0
+    return int(math.ceil(total / float(page_size)))
+```
+
+- [ ] **Step 2: 验证CRUD可导入**
+
+Run: `cd backend && python -c "from app.crud.workflow import list_process_defs, publish_version; print('OK')"`
+Expected: OK
+
+---
+
+## Phase 2: Workflow Engine
+
+### Task 4: Core Engine（节点分发 + Start/End Handler）
+
+**Files:**
+- Create: `backend/app/services/workflow_engine.py`
+
+- [ ] **Step 1: 创建工作流引擎**
+
+```python
+"""工作流引擎 - 图遍历模式"""
+from __future__ import annotations
+
+import json
+import logging
+import re
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from sqlalchemy.orm import Session
+
+from app.crud import workflow as wf_crud
+from app.models.models import WfNode, WfTransition, WfTask
+
+logger = logging.getLogger(__name__)
+
+
+class WorkflowEngine:
+    """图遍历工作流引擎"""
+
+    def __init__(self, db: Session):
+        self.db = db
+
+    # ------------------------------------------------------------------
+    # 公共入口
+    # ------------------------------------------------------------------
+
+    def start_process(
+        self,
+        *,
+        process_version_id: str,
+        business_type: Optional[str] = None,
+        business_id: Optional[str] = None,
+        starter_user_id: Optional[str] = None,
+        variables: Optional[dict] = None,
+        callback_url: Optional[str] = None,
+        tenant_no: str = "zkxw",
+        user_id: Optional[str] = None,
+    ) -> str:
+        """发起流程，返回实例ID"""
+        instance = wf_crud.create_instance(
+            self.db,
+            process_version_id=process_version_id,
+            business_type=business_type,
+            business_id=business_id,
+            starter_user_id=starter_user_id,
+            variables=variables,
+            callback_url=callback_url,
+            tenant_no=tenant_no,
+            user_id=user_id,
+        )
+        # 找到 start 节点并推进
+        nodes = wf_crud.get_nodes_by_version(self.db, process_version_id)
+        start_node = next((n for n in nodes if n.node_type == "start"), None)
+        if start_node:
+            self._advance(instance.id, start_node.node_key, tenant_no)
+        return instance.id
+
+    def approve_task(self, task_id: str, comment: Optional[str] = None, tenant_no: str = "zkxw") -> None:
+        """审批通过任务"""
+        task = wf_crud.get_task(self.db, task_id)
+        if not task or task.status != "pending":
+            raise ValueError("任务不存在或已处理")
+        task.status = "approved"
+        task.comment_text = comment
+        task.update_time = datetime.now()
+        self.db.add(task)
+        self.db.commit()
+
+        # 检查同节点是否全部通过
+        instance = wf_crud.get_instance(self.db, task.instance_id)
+        if not instance:
+            return
+        nodes = wf_crud.get_nodes_by_version(self.db, instance.process_version_id)
+        current_node = next((n for n in nodes if n.node_key == task.node_key), None)
+        if not current_node:
+            return
+
+        config = json.loads(current_node.config_json or "{}")
+        pass_type = config.get("pass_type", "any")
+
+        pending_tasks = wf_crud.get_pending_tasks_by_node(self.db, task.instance_id, task.node_key)
+
+        should_advance = False
+        if pass_type == "any":
+            # 任一通过即可推进，取消其余待办
+            should_advance = True
+            for pt in pending_tasks:
+                pt.status = "withdrawn"
+                pt.update_time = datetime.now()
+                self.db.add(pt)
+            self.db.commit()
+        else:
+            # all: 全部通过才推进
+            if not pending_tasks:
+                should_advance = True
+
+        if should_advance:
+            self._advance(task.instance_id, task.node_key, tenant_no)
+
+    def reject_task(self, task_id: str, comment: Optional[str] = None, tenant_no: str = "zkxw") -> None:
+        """审批驳回任务"""
+        task = wf_crud.get_task(self.db, task_id)
+        if not task or task.status != "pending":
+            raise ValueError("任务不存在或已处理")
+        task.status = "rejected"
+        task.comment_text = comment
+        task.update_time = datetime.now()
+        self.db.add(task)
+        self.db.commit()
+
+        # 驳回 → 取消同节点其他待办 → 实例标记 rejected
+        pending_tasks = wf_crud.get_pending_tasks_by_node(self.db, task.instance_id, task.node_key)
+        for pt in pending_tasks:
+            pt.status = "withdrawn"
+            pt.update_time = datetime.now()
+            self.db.add(pt)
+        self.db.commit()
+
+        wf_crud.update_instance_status(self.db, task.instance_id, "rejected")
+        # 触发回调
+        instance = wf_crud.get_instance(self.db, task.instance_id)
+        if instance:
+            from app.services.workflow_callback import trigger_callback
+            trigger_callback(self.db, instance, event="rejected")
+
+    # ------------------------------------------------------------------
+    # 内部推进
+    # ------------------------------------------------------------------
+
+    def _advance(self, instance_id: str, from_node_key: str, tenant_no: str) -> None:
+        """从指定节点推进到下一个节点"""
+        instance = wf_crud.get_instance(self.db, instance_id)
+        if not instance or instance.status != "running":
+            return
+
+        nodes = wf_crud.get_nodes_by_version(self.db, instance.process_version_id)
+        transitions = wf_crud.get_transitions_by_version(self.db, instance.process_version_id)
+        variables = json.loads(instance.variables_json or "{}")
+
+        current_node = next((n for n in nodes if n.node_key == from_node_key), None)
+        if not current_node:
+            return
+
+        # 找到出边
+        out_edges = [t for t in transitions if t.from_node_key == from_node_key]
+        if not out_edges:
+            return
+
+        # 根据节点类型决定下一条边
+        next_node_key = None
+        if current_node.node_type == "start":
+            next_node_key = out_edges[0].to_node_key
+        elif current_node.node_type == "approval":
+            next_node_key = out_edges[0].to_node_key if out_edges else None
+        elif current_node.node_type == "condition":
+            next_node_key = self._evaluate_condition(out_edges, variables)
+        else:
+            return
+
+        if not next_node_key:
+            return
+
+        # 执行目标节点
+        next_node = next((n for n in nodes if n.node_key == next_node_key), None)
+        if not next_node:
+            return
+
+        self._execute_node(instance_id, next_node, variables, tenant_no)
+
+    def _execute_node(self, instance_id: str, node: WfNode, variables: dict, tenant_no: str) -> None:
+        """执行节点逻辑"""
+        if node.node_type == "end":
+            wf_crud.update_instance_status(self.db, instance_id, "completed")
+            instance = wf_crud.get_instance(self.db, instance_id)
+            if instance:
+                from app.services.workflow_callback import trigger_callback
+                trigger_callback(self.db, instance, event="completed")
+        elif node.node_type == "approval":
+            self._create_approval_tasks(instance_id, node, variables, tenant_no)
+        elif node.node_type == "condition":
+            self._advance(instance_id, node.node_key, tenant_no)
+        else:
+            # start 等其他类型直接推进
+            self._advance(instance_id, node.node_key, tenant_no)
+
+    def _create_approval_tasks(
+        self, instance_id: str, node: WfNode, variables: dict, tenant_no: str
+    ) -> None:
+        """审批节点：解析审批人并创建任务"""
+        config = json.loads(node.config_json or "{}")
+        user_ids = self._resolve_approvers(config, variables, tenant_no)
+        for uid in user_ids:
+            wf_crud.create_task(
+                self.db,
+                instance_id=instance_id,
+                node_key=node.node_key,
+                assignee_user_id=uid,
+                tenant_no=tenant_no,
+            )
+
+    def _resolve_approvers(self, config: dict, variables: dict, tenant_no: str) -> List[str]:
+        """解析审批人列表"""
+        strategy = config.get("strategy", "users")
+
+        if strategy == "users":
+            return config.get("user_ids", [])
+
+        elif strategy == "roles":
+            role_ids = config.get("role_ids", [])
+            if not role_ids:
+                return []
+            from app.models.models import SysUserRole, SysUser
+            rows = (
+                self.db.query(SysUser.id)
+                .join(SysUserRole, SysUser.id == SysUserRole.user_id)
+                .filter(
+                    SysUserRole.role_id.in_(role_ids),
+                    SysUser.del_flag == 0,
+                    SysUser.status == "1",
+                )
+                .distinct()
+                .all()
+            )
+            return [r[0] for r in rows]
+
+        elif strategy == "sql":
+            sql_template = config.get("sql", "")
+            if not sql_template:
+                return []
+            return self._execute_sql_approvers(sql_template, variables, tenant_no)
+
+        return []
+
+    def _execute_sql_approvers(self, sql_template: str, variables: dict, tenant_no: str) -> List[str]:
+        """执行SQL解析审批人（仅允许SELECT，参数化查询）"""
+        # 安全检查：只允许 SELECT
+        normalized = sql_template.strip().upper()
+        for forbidden in ["INSERT", "UPDATE", "DELETE", "DROP", "ALTER", "CREATE", "TRUNCATE"]:
+            if forbidden in normalized:
+                logger.warning(f"SQL approver resolution blocked: forbidden keyword '{forbidden}'")
+                return []
+        if not normalized.startswith("SELECT"):
+            return []
+
+        # 参数替换
+        params = dict(variables)
+        params["tenant_no"] = tenant_no
+
+        try:
+            result = self.db.execute(sql_template, params)
+            rows = result.fetchall()
+            return [str(r[0]) for r in rows]
+        except Exception as e:
+            logger.error(f"SQL approver resolution failed: {e}")
+            return []
+
+    def _evaluate_condition(self, out_edges: List[WfTransition], variables: dict) -> Optional[str]:
+        """评估条件分支，返回目标节点key"""
+        for edge in out_edges:
+            if not edge.condition_expr:
+                # 无条件 = 默认分支（最后一条）
+                continue
+            try:
+                rules = json.loads(edge.condition_expr)
+                if self._check_rules(rules, variables):
+                    return edge.to_node_key
+            except (json.JSONDecodeError, KeyError):
+                continue
+
+        # 兜底：最后一条无条件边
+        for edge in reversed(out_edges):
+            if not edge.condition_expr:
+                return edge.to_node_key
+
+        return out_edges[-1].to_node_key if out_edges else None
+
+    def _check_rules(self, rules: Any, variables: dict) -> bool:
+        """检查条件规则"""
+        if isinstance(rules, dict):
+            if "rules" in rules:
+                # 顶层 rules 数组
+                return self._check_rules(rules["rules"], variables)
+            if "and" in rules:
+                return all(self._check_rules(r, variables) for r in rules["and"])
+            if "or" in rules:
+                return any(self._check_rules(r, variables) for r in rules["or"])
+            # 单条规则
+            field = rules.get("field", "")
+            op = rules.get("op", "==")
+            value = rules.get("value")
+            actual = self._get_variable(field, variables)
+            return self._compare(actual, op, value)
+        elif isinstance(rules, list):
+            # 如果是数组，第一条匹配即返回（按顺序评估）
+            for rule in rules:
+                if self._check_rules(rule, variables):
+                    return True
+            return False
+        return False
+
+    def _get_variable(self, field: str, variables: dict) -> Any:
+        """从变量字典取值，支持点号路径"""
+        parts = field.split(".")
+        val = variables
+        for p in parts:
+            if isinstance(val, dict):
+                val = val.get(p)
+            else:
+                return None
+        return val
+
+    def _compare(self, actual: Any, op: str, expected: Any) -> bool:
+        """比较操作"""
+        try:
+            if op == "==":
+                return actual == expected
+            elif op == "!=":
+                return actual != expected
+            elif op == ">":
+                return float(actual) > float(expected)
+            elif op == "<":
+                return float(actual) < float(expected)
+            elif op == ">=":
+                return float(actual) >= float(expected)
+            elif op == "<=":
+                return float(actual) <= float(expected)
+            elif op == "in":
+                return actual in expected if isinstance(expected, list) else False
+            elif op == "not_in":
+                return actual not in expected if isinstance(expected, list) else True
+            elif op == "contains":
+                return str(expected) in str(actual) if actual else False
+        except (TypeError, ValueError):
+            return False
+        return False
+```
+
+- [ ] **Step 2: 验证引擎可导入**
+
+Run: `cd backend && python -c "from app.services.workflow_engine import WorkflowEngine; print('OK')"`
+Expected: OK
+
+---
+
+### Task 5: Callback Service
+
+**Files:**
+- Create: `backend/app/services/workflow_callback.py`
+
+- [ ] **Step 1: 创建回调服务**
+
+```python
+"""工作流回调服务"""
+from __future__ import annotations
+
+import json
+import logging
+from typing import Optional
+
+import requests
+from sqlalchemy.orm import Session
+
+from app.models.models import WfProcessInstance
+
+logger = logging.getLogger(__name__)
+
+CALLBACK_TIMEOUT_SECONDS = 10
+
+
+def trigger_callback(db: Session, instance: WfProcessInstance, event: str) -> None:
+    """触发业务回调"""
+    if not instance.callback_url:
+        return
+
+    payload = {
+        "event": event,
+        "instanceId": instance.id,
+        "businessType": instance.business_type,
+        "businessId": instance.business_id,
+        "status": instance.status,
+    }
+
+    try:
+        resp = requests.post(
+            instance.callback_url,
+            json=payload,
+            timeout=CALLBACK_TIMEOUT_SECONDS,
+            headers={"Content-Type": "application/json"},
+        )
+        logger.info(
+            f"Workflow callback triggered: {instance.callback_url} event={event} status={resp.status_code}"
+        )
+    except Exception as e:
+        logger.error(f"Workflow callback failed: {instance.callback_url} error={e}")
+```
+
+- [ ] **Step 2: 添加 requests 到 requirements.txt（如果缺失）**
+
+Run: `cd backend && grep -q "requests" requirements.txt && echo "EXISTS" || echo "requests" >> requirements.txt`
+
+---
+
+## Phase 3: API Routes
+
+### Task 6: Workflow API Routes + Router Registration
+
+**Files:**
+- Create: `backend/app/api/workflow.py`
+- Modify: `backend/app/api/__init__.py`
+- Modify: `backend/app/main.py`
+
+- [ ] **Step 1: 创建workflow API路由文件**
+
+```python
+"""工作流管理 API 路由"""
+from typing import Optional
+
+from fastapi import APIRouter, Depends, Query
+from pydantic import BaseModel, ConfigDict, Field
+from sqlalchemy.orm import Session
+
+from app.core.database import get_db
+from app.core.menu_guard import require_admin_or_super_admin
+from app.core.response import success_response, error_response
+from app.crud import workflow as wf_crud
+from app.schemas.workflow import (
+    ProcessDefCreate,
+    ProcessDefUpdate,
+    PublishVersionRequest,
+    StartInstanceRequest,
+    ApproveRequest,
+)
+from app.services.workflow_engine import WorkflowEngine
+
+router = APIRouter(prefix="/web/admin/workflow", tags=["工作流管理"])
+
+
+# ---------------------------------------------------------------------------
+# 流程定义
+# ---------------------------------------------------------------------------
+
+
+@router.get("/defs")
+async def list_defs(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100),
+    keyword: Optional[str] = None,
+    status: Optional[str] = None,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    rows, total = wf_crud.list_process_defs(
+        db, page=page, page_size=pageSize, keyword=keyword, status=status, tenant_no=tenant_no
+    )
+    return success_response({
+        "list": rows,
+        "total": total,
+        "page": page,
+        "pageSize": pageSize,
+        "totalPages": wf_crud.total_pages(total, pageSize),
+    })
+
+
+class _DefBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    processCode: str = Field(..., alias="processCode")
+    processName: str = Field(..., alias="processName")
+    status: Optional[str] = Field("1")
+    orderNum: Optional[int] = Field(0)
+    remark: Optional[str] = None
+
+
+@router.post("/defs")
+async def create_def(
+    body: _DefBody,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    user_id = _user.get("user_id") or _user.get("id")
+    try:
+        obj = wf_crud.create_process_def(
+            db,
+            process_code=body.processCode,
+            process_name=body.processName,
+            tenant_no=tenant_no,
+            status=body.status or "1",
+            order_num=body.orderNum or 0,
+            remark=body.remark,
+            user_id=user_id,
+        )
+        return success_response(wf_crud._def_to_dict(obj))
+    except ValueError as e:
+        return error_response(str(e))
+
+
+class _DefUpdateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    processCode: Optional[str] = None
+    processName: Optional[str] = None
+    status: Optional[str] = None
+    orderNum: Optional[int] = None
+    remark: Optional[str] = None
+
+
+@router.put("/defs/{def_id}")
+async def update_def(
+    def_id: str,
+    body: _DefUpdateBody,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    user_id = _user.get("user_id") or _user.get("id")
+    try:
+        obj = wf_crud.update_process_def(
+            db,
+            def_id,
+            process_code=body.processCode,
+            process_name=body.processName,
+            status=body.status,
+            order_num=body.orderNum,
+            remark=body.remark,
+            user_id=user_id,
+            tenant_no=tenant_no,
+        )
+        return success_response(wf_crud._def_to_dict(obj))
+    except ValueError as e:
+        return error_response(str(e))
+
+
+@router.delete("/defs/{def_id}")
+async def delete_def(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        wf_crud.soft_delete_process_def(db, def_id)
+        return success_response(None, msg="删除成功")
+    except ValueError as e:
+        return error_response(str(e))
+
+
+# ---------------------------------------------------------------------------
+# 发布版本
+# ---------------------------------------------------------------------------
+
+
+@router.post("/defs/{def_id}/publish")
+async def publish_version(
+    def_id: str,
+    body: PublishVersionRequest,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    user_id = _user.get("user_id") or _user.get("id")
+    def_obj = wf_crud.get_process_def(db, def_id)
+    if not def_obj:
+        return error_response("流程定义不存在")
+    nodes = [n.model_dump() for n in body.nodes]
+    transitions = [t.model_dump() for t in body.transitions]
+    version = wf_crud.publish_version(
+        db,
+        process_def_id=def_id,
+        graph_json=body.graphJson,
+        nodes=nodes,
+        transitions=transitions,
+        tenant_no=tenant_no,
+        remark=body.remark,
+        user_id=user_id,
+    )
+    return success_response({
+        "id": version.id,
+        "versionNo": version.version_no,
+        "isLatest": version.is_latest,
+    })
+
+
+@router.get("/defs/{def_id}/versions")
+async def list_versions(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    rows = wf_crud.list_versions(db, def_id, tenant_no=tenant_no)
+    return success_response(rows)
+
+
+# ---------------------------------------------------------------------------
+# 获取设计器数据（最新版本的 graph_json + nodes + transitions）
+# ---------------------------------------------------------------------------
+
+
+@router.get("/defs/{def_id}/designer")
+async def get_designer_data(
+    def_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    version = wf_crud.get_latest_version(db, def_id)
+    if not version:
+        return success_response({"graphJson": None, "nodes": [], "transitions": []})
+    nodes = wf_crud.get_nodes_by_version(db, version.id)
+    transitions = wf_crud.get_transitions_by_version(db, version.id)
+    return success_response({
+        "graphJson": version.graph_json,
+        "versionNo": version.version_no,
+        "nodes": [
+            {
+                "nodeKey": n.node_key,
+                "nodeType": n.node_type,
+                "nodeName": n.node_name,
+                "configJson": n.config_json,
+            }
+            for n in nodes
+        ],
+        "transitions": [
+            {
+                "fromNodeKey": t.from_node_key,
+                "toNodeKey": t.to_node_key,
+                "conditionExpr": t.condition_expr,
+            }
+            for t in transitions
+        ],
+    })
+
+
+# ---------------------------------------------------------------------------
+# 流程实例
+# ---------------------------------------------------------------------------
+
+
+@router.post("/instances")
+async def start_instance(
+    body: StartInstanceRequest,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    user_id = _user.get("user_id") or _user.get("id")
+
+    # 查找流程定义
+    all_defs = db.query(wf_crud.WfProcessDef).filter(
+        wf_crud.WfProcessDef.process_code == body.processCode,
+        wf_crud.WfProcessDef.del_flag == 0,
+        wf_crud.WfProcessDef.tenant_no == tenant_no,
+    ).first()
+    if not all_defs:
+        return error_response("流程定义不存在")
+    if all_defs.status != "1":
+        return error_response("流程已停用")
+
+    # 查找最新版本
+    version = wf_crud.get_latest_version(db, all_defs.id)
+    if not version:
+        return error_response("流程尚未发布版本")
+
+    engine = WorkflowEngine(db)
+    instance_id = engine.start_process(
+        process_version_id=version.id,
+        business_type=body.businessType,
+        business_id=body.businessId,
+        starter_user_id=user_id,
+        variables=body.variables,
+        callback_url=body.callbackUrl,
+        tenant_no=tenant_no,
+        user_id=user_id,
+    )
+    return success_response({"instanceId": instance_id})
+
+
+@router.get("/instances/{instance_id}")
+async def get_instance_detail(
+    instance_id: str,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    instance = wf_crud.get_instance(db, instance_id)
+    if not instance:
+        return error_response("流程实例不存在")
+    tasks = (
+        db.query(wf_crud.WfTask)
+        .filter(wf_crud.WfTask.instance_id == instance_id, wf_crud.WfTask.del_flag == 0)
+        .order_by(wf_crud.WfTask.create_time.asc())
+        .all()
+    )
+    return success_response({
+        "id": instance.id,
+        "processVersionId": instance.process_version_id,
+        "businessType": instance.business_type,
+        "businessId": instance.business_id,
+        "starterUserId": instance.starter_user_id,
+        "status": instance.status,
+        "variables": instance.variables_json,
+        "createTime": instance.create_time.strftime("%Y-%m-%d %H:%M:%S") if instance.create_time else "",
+        "tasks": [
+            {
+                "id": t.id,
+                "nodeKey": t.node_key,
+                "assigneeUserId": t.assignee_user_id,
+                "status": t.status,
+                "commentText": t.comment_text,
+                "createTime": t.create_time.strftime("%Y-%m-%d %H:%M:%S") if t.create_time else "",
+                "updateTime": t.update_time.strftime("%Y-%m-%d %H:%M:%S") if t.update_time else "",
+            }
+            for t in tasks
+        ],
+    })
+
+
+# ---------------------------------------------------------------------------
+# 任务办理
+# ---------------------------------------------------------------------------
+
+
+@router.get("/tasks/pending")
+async def list_pending(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100),
+    keyword: Optional[str] = None,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = _user.get("user_id") or _user.get("id")
+    tenant_no = _user.get("tenant_no", "zkxw")
+    rows, total = wf_crud.list_pending_tasks(
+        db, user_id=user_id, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    return success_response({
+        "list": rows,
+        "total": total,
+        "page": page,
+        "pageSize": pageSize,
+        "totalPages": wf_crud.total_pages(total, pageSize),
+    })
+
+
+@router.get("/tasks/completed")
+async def list_completed(
+    page: int = Query(1, ge=1),
+    pageSize: int = Query(10, ge=1, le=100),
+    keyword: Optional[str] = None,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    user_id = _user.get("user_id") or _user.get("id")
+    tenant_no = _user.get("tenant_no", "zkxw")
+    rows, total = wf_crud.list_completed_tasks(
+        db, user_id=user_id, page=page, page_size=pageSize, keyword=keyword, tenant_no=tenant_no
+    )
+    return success_response({
+        "list": rows,
+        "total": total,
+        "page": page,
+        "pageSize": pageSize,
+        "totalPages": wf_crud.total_pages(total, pageSize),
+    })
+
+
+@router.post("/tasks/{task_id}/approve")
+async def approve_task(
+    task_id: str,
+    body: ApproveRequest,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    try:
+        engine = WorkflowEngine(db)
+        engine.approve_task(task_id, comment=body.commentText, tenant_no=tenant_no)
+        return success_response(None, msg="审批通过")
+    except ValueError as e:
+        return error_response(str(e))
+
+
+@router.post("/tasks/{task_id}/reject")
+async def reject_task(
+    task_id: str,
+    body: ApproveRequest,
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    tenant_no = _user.get("tenant_no", "zkxw")
+    try:
+        engine = WorkflowEngine(db)
+        engine.reject_task(task_id, comment=body.commentText, tenant_no=tenant_no)
+        return success_response(None, msg="审批驳回")
+    except ValueError as e:
+        return error_response(str(e))
+```
+
+注意：`workflow.py` 路由中 `start_instance` 端点直接引用了 `wf_crud.WfProcessDef` 和 `wf_crud.WfTask`，这是因为 CRUD 模块没有导出模型。更干净的做法是在路由文件顶部直接 import 模型：
+
+```python
+from app.models.models import WfProcessDef, WfTask
+```
+
+并将 `wf_crud.WfProcessDef` 改为 `WfProcessDef`，`wf_crud.WfTask` 改为 `WfTask`。
+
+- [ ] **Step 2: 注册路由到 __init__.py**
+
+在 `backend/app/api/__init__.py` 追加：
+
+```python
+from app.api.workflow import router as workflow_router
+```
+
+并在 `__all__` 中添加 `"workflow_router"`。
+
+- [ ] **Step 3: 注册路由到 main.py**
+
+在 `backend/app/main.py` 中找到 `app.include_router(admin_router)` 等注册行，追加：
+
+```python
+from app.api.workflow import router as workflow_router
+app.include_router(workflow_router)
+```
+
+或者如果 main.py 从 `__init__.py` 导入，则追加对应 include_router 调用。
+
+- [ ] **Step 4: 验证路由加载**
+
+Run: `cd backend && python -c "from app.api.workflow import router; print(f'Routes: {len(router.routes)}')"`
+Expected: Routes: 13
+
+---
+
+## Phase 4: Frontend Foundation
+
+### Task 7: TypeScript Types + API Module
+
+**Files:**
+- Modify: `web-admin/src/types/api.d.ts`（追加 Workflow 命名空间）
+- Create: `web-admin/src/api/workflow.ts`
+
+- [ ] **Step 1: 在 api.d.ts 末尾追加 Workflow 类型**
+
+在 `declare namespace Api {` 的最后一个 namespace 之后（即文件最后的 `}` 之前）追加：
+
+```typescript
+  namespace Workflow {
+    interface ProcessDefItem {
+      id: string
+      processCode: string
+      processName: string
+      status: string
+      latestVersion: number | null
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+
+    interface VersionItem {
+      id: string
+      versionNo: number
+      isLatest: string
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+
+    interface DesignerData {
+      graphJson: string | null
+      versionNo: number
+      nodes: NodeData[]
+      transitions: TransitionData[]
+    }
+
+    interface NodeData {
+      nodeKey: string
+      nodeType: string
+      nodeName: string | null
+      configJson: string | null
+    }
+
+    interface TransitionData {
+      fromNodeKey: string
+      toNodeKey: string
+      conditionExpr: string | null
+    }
+
+    interface TaskItem {
+      id: string
+      instanceId: string
+      nodeKey: string | null
+      assigneeUserId: string | null
+      status: string | null
+      commentText: string | null
+      createTime: string
+      updateTime: string
+      processName: string | null
+      businessType: string | null
+      businessId: string | null
+      starterUserId: string | null
+      instanceStatus: string | null
+      instanceCreateTime: string | null
+    }
+
+    interface InstanceDetail {
+      id: string
+      processVersionId: string
+      businessType: string | null
+      businessId: string | null
+      starterUserId: string | null
+      status: string | null
+      variables: string
+      createTime: string
+      tasks: TaskDetail[]
+    }
+
+    interface TaskDetail {
+      id: string
+      nodeKey: string | null
+      assigneeUserId: string | null
+      status: string | null
+      commentText: string | null
+      createTime: string
+      updateTime: string
+    }
+  }
+```
+
+- [ ] **Step 2: 创建 workflow API 模块**
+
+Create: `web-admin/src/api/workflow.ts`
+
+```typescript
+import request from '@/utils/http'
+
+// ---------------------------------------------------------------------------
+// 流程定义
+// ---------------------------------------------------------------------------
+
+export function fetchProcessDefList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  status?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.ProcessDefItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/defs',
+    params,
+  })
+}
+
+export function fetchCreateProcessDef(data: {
+  processCode: string
+  processName: string
+  status?: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post<Api.Workflow.ProcessDefItem>({
+    url: '/web/admin/workflow/defs',
+    data,
+    showSuccessMessage: true,
+  })
+}
+
+export function fetchUpdateProcessDef(
+  id: string,
+  data: Partial<{
+    processCode: string
+    processName: string
+    status: string
+    orderNum: number
+    remark: string
+  }>,
+) {
+  return request.put<Api.Workflow.ProcessDefItem>({
+    url: `/web/admin/workflow/defs/${id}`,
+    data,
+    showSuccessMessage: true,
+  })
+}
+
+export function fetchDeleteProcessDef(id: string) {
+  return request.delete({
+    url: `/web/admin/workflow/defs/${id}`,
+    showSuccessMessage: true,
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 发布版本
+// ---------------------------------------------------------------------------
+
+export function fetchPublishVersion(
+  defId: string,
+  data: {
+    graphJson: string
+    nodes: Array<{
+      nodeKey: string
+      nodeType: string
+      nodeName?: string | null
+      configJson?: string | null
+    }>
+    transitions: Array<{
+      fromNodeKey: string
+      toNodeKey: string
+      conditionExpr?: string | null
+    }>
+    remark?: string
+  },
+) {
+  return request.post({
+    url: `/web/admin/workflow/defs/${defId}/publish`,
+    data,
+    showSuccessMessage: true,
+  })
+}
+
+export function fetchVersionList(defId: string) {
+  return request.get<Api.Workflow.VersionItem[]>({
+    url: `/web/admin/workflow/defs/${defId}/versions`,
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 设计器数据
+// ---------------------------------------------------------------------------
+
+export function fetchDesignerData(defId: string) {
+  return request.get<Api.Workflow.DesignerData>({
+    url: `/web/admin/workflow/defs/${defId}/designer`,
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 流程实例
+// ---------------------------------------------------------------------------
+
+export function fetchStartInstance(data: {
+  processCode: string
+  businessType?: string
+  businessId?: string
+  variables?: Record<string, any>
+  callbackUrl?: string
+}) {
+  return request.post<{ instanceId: string }>({
+    url: '/web/admin/workflow/instances',
+    data,
+  })
+}
+
+export function fetchInstanceDetail(instanceId: string) {
+  return request.get<Api.Workflow.InstanceDetail>({
+    url: `/web/admin/workflow/instances/${instanceId}`,
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 任务办理
+// ---------------------------------------------------------------------------
+
+export function fetchPendingTasks(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.TaskItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/tasks/pending',
+    params,
+  })
+}
+
+export function fetchCompletedTasks(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.TaskItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/tasks/completed',
+    params,
+  })
+}
+
+export function fetchApproveTask(taskId: string, data?: { commentText?: string }) {
+  return request.post({
+    url: `/web/admin/workflow/tasks/${taskId}/approve`,
+    data,
+    showSuccessMessage: true,
+  })
+}
+
+export function fetchRejectTask(taskId: string, data?: { commentText?: string }) {
+  return request.post({
+    url: `/web/admin/workflow/tasks/${taskId}/reject`,
+    data,
+    showSuccessMessage: true,
+  })
+}
+```
+
+- [ ] **Step 3: 验证前端编译**
+
+Run: `cd web-admin && npx vue-tsc --noEmit 2>&1 | head -20`
+Expected: 无新增类型错误（可能有预存错误）
+
+---
+
+### Task 8: Router Entries
+
+**Files:**
+- Modify: `web-admin/src/router/modules/sqxp.ts`
+- 菜单种子：见 `docs/sql/zkxw.sql` 内数据或 `docs/sql/` 增量脚本
+
+- [ ] **Step 1: 在 sqxp.ts 中新增3个路由**
+
+在 `sqxpAdminRoutes` 数组中，找到系统管理相关的 children，追加3个路由条目：
+
+```typescript
+      {
+        id: '10000000000000000000000000000wf01',
+        name: 'WorkflowProcess',
+        path: 'workflow/process',
+        component: '/system/workflow/process/index',
+        meta: { title: '流程配置', keepAlive: true, icon: 'workflow' },
+      },
+      {
+        id: '10000000000000000000000000000wf02',
+        name: 'WorkflowPending',
+        path: 'workflow/pending',
+        component: '/system/workflow/task-pending/index',
+        meta: { title: '待办中心', keepAlive: true },
+      },
+      {
+        id: '10000000000000000000000000000wf03',
+        name: 'WorkflowCompleted',
+        path: 'workflow/completed',
+        component: '/system/workflow/task-completed/index',
+        meta: { title: '已办中心', keepAlive: true },
+      },
+```
+
+- [ ] **Step 2: 创建菜单初始化SQL**
+
+在 `docs/sql/zkxw.sql` 或增量脚本中维护菜单数据（示例）：
+
+```sql
+-- 工作流管理菜单数据
+-- 将流程配置、待办中心、已办中心添加到系统管理菜单下
+
+-- 流程配置
+INSERT INTO sys_menu (id, menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms, icon, menu_code, tenant_no, create_time, update_time, del_flag)
+VALUES ('10000000000000000000000000000wf01', '流程配置', '0', 15, 'workflow/process', 'system/workflow/process/index', 'C', '0', '1', '', 'workflow', 'workflow:process', 'zkxw', NOW(), NOW(), 0);
+
+-- 待办中心
+INSERT INTO sys_menu (id, menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms, icon, menu_code, tenant_no, create_time, update_time, del_flag)
+VALUES ('10000000000000000000000000000wf02', '待办中心', '0', 16, 'workflow/pending', 'system/workflow/task-pending/index', 'C', '0', '1', '', 'bell', 'workflow:pending', 'zkxw', NOW(), NOW(), 0);
+
+-- 已办中心
+INSERT INTO sys_menu (id, menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms, icon, menu_code, tenant_no, create_time, update_time, del_flag)
+VALUES ('10000000000000000000000000000wf03', '已办中心', '0', 17, 'workflow/completed', 'system/workflow/task-completed/index', 'C', '0', '1', '', 'circle-check', 'workflow:completed', 'zkxw', NOW(), NOW(), 0);
+```
+
+---
+
+## Phase 5: Flow Designer
+
+### Task 9: AntV X6 Flow Designer
+
+**Files:**
+- Create: `web-admin/src/views/system/workflow/designer/FlowDesigner.vue`
+
+**前置条件**: 安装 AntV X6 依赖
+
+- [ ] **Step 1: 安装 AntV X6**
+
+Run: `cd web-admin && pnpm add @antv/x6 @antv/x6-plugin-selection @antv/x6-plugin-dnd @antv/x6-plugin-minimap @antv/x6-plugin-history`
+
+- [ ] **Step 2: 创建 FlowDesigner.vue**
+
+这是一个大型组件，实现三栏布局（节点面板 / 画布 / 属性面板）。
+
+关键实现要点：
+- 使用 `@antv/x6` 的 `Graph` 类初始化画布
+- 注册4种自定义节点（Start/End/Approval/Condition）使用 `Graph.registerNode`
+- 左侧面板提供拖拽源，使用 `@antv/x6-plugin-dnd` 实现拖入画布
+- 选中节点时右侧属性面板展示对应配置表单
+- 保存时序列化为 `{graphJson, nodes, transitions}` 格式
+- 发布调用 `fetchPublishVersion` API
+
+组件 props：
+```typescript
+const props = defineProps<{
+  visible: boolean
+  processDefId: string
+  processName: string
+}>()
+
+const emit = defineEmits<{
+  (e: 'update:visible', val: boolean): void
+  (e: 'saved'): void
+}>()
+```
+
+组件核心结构：
+```vue
+<template>
+  <el-dialog
+    :model-value="visible"
+    :title="`流程设计 - ${processName}`"
+    width="100%"
+    fullscreen
+    destroy-on-close
+    @update:model-value="$emit('update:visible', $event)"
+    class="flow-designer-dialog"
+  >
+    <div class="flow-designer">
+      <!-- 左侧节点面板 -->
+      <div class="designer-sidebar">
+        <div class="sidebar-title">节点组件</div>
+        <div
+          v-for="node in nodeTypes"
+          :key="node.type"
+          class="sidebar-node"
+          :style="{ borderColor: node.color }"
+          draggable="true"
+          @dragstart="onDragStart($event, node)"
+        >
+          <div class="sidebar-node-icon" :style="{ backgroundColor: node.color }">
+            {{ node.icon }}
+          </div>
+          <span>{{ node.label }}</span>
+        </div>
+      </div>
+
+      <!-- 中间画布 -->
+      <div class="designer-canvas" ref="canvasRef"></div>
+
+      <!-- 右侧属性面板 -->
+      <div class="designer-props">
+        <div v-if="selectedNode" class="props-content">
+          <h3>节点属性</h3>
+          <el-form label-position="top">
+            <el-form-item label="节点名称">
+              <el-input v-model="selectedNode.data.nodeName" @change="updateNodeData" />
+            </el-form-item>
+            <!-- 审批人节点配置 -->
+            <template v-if="selectedNode.data.nodeType === 'approval'">
+              <el-form-item label="审批人策略">
+                <el-select v-model="approvalConfig.strategy" @change="updateNodeData">
+                  <el-option label="指定用户" value="users" />
+                  <el-option label="指定角色" value="roles" />
+                  <el-option label="SQL查询" value="sql" />
+                </el-select>
+              </el-form-item>
+              <el-form-item v-if="approvalConfig.strategy === 'users'" label="选择用户">
+                <el-select v-model="approvalConfig.user_ids" multiple @change="updateNodeData">
+                  <!-- 动态加载用户列表 -->
+                </el-select>
+              </el-form-item>
+              <el-form-item v-if="approvalConfig.strategy === 'roles'" label="选择角色">
+                <el-select v-model="approvalConfig.role_ids" multiple @change="updateNodeData">
+                  <!-- 动态加载角色列表 -->
+                </el-select>
+              </el-form-item>
+              <el-form-item v-if="approvalConfig.strategy === 'sql'" label="SQL语句">
+                <el-input
+                  v-model="approvalConfig.sql"
+                  type="textarea"
+                  :rows="4"
+                  placeholder="SELECT user_id FROM ... WHERE dept_id = :dept_id"
+                  @change="updateNodeData"
+                />
+              </el-form-item>
+              <el-form-item label="通过策略">
+                <el-radio-group v-model="approvalConfig.pass_type" @change="updateNodeData">
+                  <el-radio value="any">任一通过即可</el-radio>
+                  <el-radio value="all">全部通过才行</el-radio>
+                </el-radio-group>
+              </el-form-item>
+            </template>
+            <!-- 条件分支配置（在出边上配置，此处提示） -->
+            <template v-if="selectedNode.data.nodeType === 'condition'">
+              <p class="props-hint">条件规则在连线上配置。点击连线设置条件表达式。</p>
+            </template>
+          </el-form>
+        </div>
+        <div v-else class="props-empty">
+          <p>选中节点以编辑属性</p>
+        </div>
+      </div>
+    </div>
+
+    <template #footer>
+      <el-button @click="$emit('update:visible', false)">取消</el-button>
+      <el-button class="btn-ghost" @click="handleSaveDraft">保存草稿</el-button>
+      <el-button class="btn-main" type="primary" @click="handlePublish">发布新版本</el-button>
+    </template>
+  </el-dialog>
+</template>
+```
+
+节点类型定义：
+```typescript
+const nodeTypes = [
+  { type: 'start', label: '开始节点', icon: '▶', color: '#10b981' },
+  { type: 'end', label: '结束节点', icon: '⏹', color: '#ef4444' },
+  { type: 'approval', label: '审批人节点', icon: '👤', color: '#3b82f6' },
+  { type: 'condition', label: '条件分支', icon: '◆', color: '#f59e0b' },
+]
+```
+
+核心方法：
+```typescript
+// 初始化画布
+function initGraph() {
+  const graph = new Graph({
+    container: canvasRef.value,
+    grid: true,
+    mousewheel: { enabled: true, modifiers: ['ctrl', 'meta'] },
+    connecting: {
+      router: 'manhattan',
+      connector: { name: 'rounded', args: { radius: 8 } },
+      anchor: 'center',
+      connectionPoint: 'anchor',
+      allowBlank: false,
+      allowLoop: false,
+      allowMulti: true,
+      snap: { radius: 30 },
+    },
+    highlighting: {
+      magnetAdsorbed: { name: 'stroke', args: { attrs: { fill: '#10b981', stroke: '#10b981' } } },
+    },
+    history: true,
+  })
+  // 选中节点事件
+  graph.on('node:click', ({ node }) => {
+    selectedNode.value = node
+  })
+  graph.on('blank:click', () => {
+    selectedNode.value = null
+  })
+  graphRef.value = graph
+}
+
+// 序列化
+function serializeGraph() {
+  const graph = graphRef.value
+  if (!graph) return null
+  const cells = graph.getCells()
+  const nodes = cells
+    .filter((c) => c.isNode())
+    .map((n) => ({
+      nodeKey: n.id,
+      nodeType: n.getData()?.nodeType || 'start',
+      nodeName: n.getData()?.nodeName || '',
+      configJson: JSON.stringify(n.getData()?.config || {}),
+    }))
+  const edges = cells
+    .filter((c) => c.isEdge())
+    .map((e) => ({
+      fromNodeKey: (e.getSourceCellId() || ''),
+      toNodeKey: (e.getTargetCellId() || ''),
+      conditionExpr: e.getData()?.conditionExpr || null,
+    }))
+  return {
+    graphJson: JSON.stringify(graph.toJSON()),
+    nodes,
+    transitions: edges,
+  }
+}
+```
+
+- [ ] **Step 3: 验证设计器组件编译**
+
+Run: `cd web-admin && npx vue-tsc --noEmit 2>&1 | grep -i "FlowDesigner" || echo "No FlowDesigner errors"`
+Expected: 无 FlowDesigner 相关错误
+
+---
+
+## Phase 6: Frontend Pages
+
+### Task 10: Process Management Page
+
+**Files:**
+- Create: `web-admin/src/views/system/workflow/process/index.vue`
+
+- [ ] **Step 1: 创建流程配置管理页面**
+
+参考 `unit/index.vue` 标准列表模板。功能：列表 + 新增/编辑弹窗 + 流程设计器弹窗。
+
+列表字段：流程编码、流程名称、状态（启用/停用 switch）、最新版本、创建时间、操作（设计/编辑/删除）。
+
+操作列宽度：4按钮（设计/编辑/停用启用/删除）= 400px。
+
+关键交互：
+- "流程设计"按钮 → 打开 FlowDesigner 全屏弹窗
+- "停用/启用"切换 → 调用 `fetchUpdateProcessDef` 修改 status
+- 新增/编辑弹窗使用 `.form-grid-2` + `label-position="top"`
+
+### Task 11: Approval Dialog + Status Tag Components
+
+**Files:**
+- Create: `web-admin/src/views/system/workflow/components/ApprovalDialog.vue`
+- Create: `web-admin/src/views/system/workflow/components/ProcessStatusTag.vue`
+
+- [ ] **Step 1: 创建审批弹窗组件**
+
+```vue
+<template>
+  <el-dialog
+    v-model="visible"
+    title="审批操作"
+    width="480px"
+    destroy-on-close
+    class="dialog-form-layout"
+    align-center
+  >
+    <el-form label-position="top">
+      <el-form-item label="审批结果">
+        <el-radio-group v-model="form.approved">
+          <el-radio :value="true">通过</el-radio>
+          <el-radio :value="false">驳回</el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="审批意见">
+        <el-input
+          v-model="form.commentText"
+          type="textarea"
+          :rows="3"
+          placeholder="请输入审批意见"
+        />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="visible = false">取消</el-button>
+      <el-button type="primary" @click="handleSubmit">确认提交</el-button>
+    </template>
+  </el-dialog>
+</template>
+```
+
+- [ ] **Step 2: 创建状态标签组件**
+
+```vue
+<template>
+  <el-tag :type="tagType" size="small">{{ label }}</el-tag>
+</template>
+
+<script setup lang="ts">
+const props = defineProps<{ status: string }>()
+
+const statusMap: Record<string, { label: string; type: string }> = {
+  running: { label: '进行中', type: 'warning' },
+  completed: { label: '已完成', type: 'success' },
+  rejected: { label: '已驳回', type: 'danger' },
+  cancelled: { label: '已取消', type: 'info' },
+  pending: { label: '待处理', type: 'warning' },
+  approved: { label: '已通过', type: 'success' },
+  withdrawn: { label: '已撤回', type: 'info' },
+}
+
+const tagType = computed(() => statusMap[props.status]?.type || 'info')
+const label = computed(() => statusMap[props.status]?.label || props.status)
+</script>
+```
+
+### Task 12: Pending Tasks Page
+
+**Files:**
+- Create: `web-admin/src/views/system/workflow/task-pending/index.vue`
+
+- [ ] **Step 1: 创建待办中心页面**
+
+参考 `order/index.vue` 复杂列表模板。
+
+筛选：流程名称关键词、发起时间范围（el-date-picker type="daterange"）。
+
+列表字段：流程名称、业务类型、业务单号、发起人、到达时间、操作。
+
+操作列：审批（打开ApprovalDialog）、查看详情（展开行或弹窗显示实例详情含任务列表）。
+
+操作列宽度：2按钮 = 260px。
+
+### Task 13: Completed Tasks Page
+
+**Files:**
+- Create: `web-admin/src/views/system/workflow/task-completed/index.vue`
+
+- [ ] **Step 1: 创建已办中心页面**
+
+参考标准列表模板。
+
+筛选：流程名称关键词、审批结果（通过/驳回 select）。
+
+列表字段：流程名称、业务类型、业务单号、发起人、审批结果（ProcessStatusTag）、审批意见、审批时间。
+
+操作列：查看详情。1按钮 = 260px。
+
+---
+
+## Phase 7: Integration
+
+### Task 14: App.vue Title Whitelist + Final Verification
+
+**Files:**
+- Modify: `web-admin/src/App.vue`
+
+- [ ] **Step 1: 在 App.vue panelTitleBarTextRules 中追加工作流标题**
+
+在 `panelTitleBarTextRules` 数组中追加：
+```typescript
+'流程配置',
+'待办列表',
+'已办列表',
+```
+
+- [ ] **Step 2: 运行后端验证**
+
+Run: `cd backend && python -c "from app.main import app; routes = [r.path for r in app.routes if hasattr(r, 'path')]; wf = [r for r in routes if 'workflow' in r]; print(f'Workflow routes: {len(wf)}'); [print(f'  {r}') for r in wf]"`
+Expected: 13 workflow routes listed
+
+- [ ] **Step 3: 运行前端编译检查**
+
+Run: `cd web-admin && pnpm build 2>&1 | tail -5`
+Expected: 构建成功（或仅有预存错误）
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add backend/ web-admin/ docs/
+git commit -m "feat: add workflow module (2.1.11) - process config, designer, task centers"
+```
diff --git a/docs/superpowers/plans/2026-05-15-operations-support.md b/docs/superpowers/plans/2026-05-15-operations-support.md
new file mode 100644
index 00000000..2c13fc52
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-15-operations-support.md
@@ -0,0 +1,618 @@
+# 运营支撑模块 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:** Implement 3 operations support modules (洁净室管理, 库位管理, 展馆预约) with backend API + frontend UI, following existing codebase patterns exactly.
+
+**Architecture:** FastAPI backend with flat-function CRUD (no service layer), Vue 3 + Element Plus frontend with standard list/tree page templates. All 3 modules share a new API route file `app/api/operations.py` and frontend route group.
+
+**Tech Stack:** Python 3.9 / FastAPI / SQLAlchemy / Pydantic v2 (backend); Vue 3 / TypeScript / Element Plus / Tailwind CSS 4 (frontend)
+
+**Design Spec:** `docs/superpowers/specs/2026-05-15-operations-support-design.md`
+
+**Key Reference Files (READ FIRST):**
+- Backend CRUD pattern: `backend/app/crud/item_unit.py`
+- Backend API pattern: `backend/app/api/basic_info.py` (lines 1-100 for simple CRUD)
+- Backend model pattern: `backend/app/models/models.py` (class BizItemUnit, lines 259-275)
+- Frontend standard list: `web-admin/src/views/system/unit/index.vue`
+- Frontend tree template: `web-admin/src/views/system/category/index.vue`
+- Frontend API pattern: `web-admin/src/api/admin.ts` (any CRUD section)
+- Frontend router: `web-admin/src/router/modules/sqxp.ts`
+
+---
+
+## File Structure
+
+### Backend (create/modify)
+| File | Action | Purpose |
+|------|--------|---------|
+| `backend/app/models/models.py` | MODIFY | Add 5 model classes at end of file |
+| `backend/app/crud/clean_room.py` | CREATE | CleanRoom + AccessLog CRUD functions |
+| `backend/app/crud/storage_facility.py` | CREATE | StorageFacility tree + Slot CRUD functions |
+| `backend/app/crud/exhibition_appointment.py` | CREATE | ExhibitionAppointment CRUD functions |
+| `backend/app/api/operations.py` | CREATE | All 3 modules API routes |
+| `backend/app/api/__init__.py` | MODIFY | Import + export operations_router |
+| `backend/app/main.py` | MODIFY | Import + register operations_router |
+| `backend/tests/test_operations_api.py` | CREATE | Backend API tests |
+
+### Frontend (create/modify)
+| File | Action | Purpose |
+|------|--------|---------|
+| `web-admin/src/api/admin.ts` | MODIFY | Add API functions for all 3 modules |
+| `web-admin/src/router/modules/sqxp.ts` | MODIFY | Add 运营支撑 route group |
+| `web-admin/src/views/operations/clean-room/index.vue` | CREATE | Clean room list page |
+| `web-admin/src/views/operations/storage-facility/index.vue` | CREATE | Storage facility tree page |
+| `web-admin/src/views/operations/exhibition-appointment/index.vue` | CREATE | Exhibition appointment list page |
+
+---
+
+## Task 1: Backend Models (5 SQLAlchemy models)
+
+**Files:**
+- Modify: `backend/app/models/models.py` (append at end, before EOF)
+
+- [ ] **Step 1: Add 5 model classes to models.py**
+
+Append the following after the last class in `backend/app/models/models.py`:
+
+```python
+# =============================================================================
+# V0.4 运营支撑（2.4 洁净室管理 / 库位管理 / 展馆预约）
+# =============================================================================
+
+
+class BizCleanRoom(Base):
+    """洁净室信息 biz_clean_room"""
+
+    __tablename__ = "biz_clean_room"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    room_code = Column(String(64), nullable=False, comment="编号")
+    room_name = Column(String(200), nullable=False, comment="名称")
+    room_grade = Column(String(8), nullable=True, comment="等级 A/B/C/D")
+    room_status = Column(String(16), nullable=False, default="zc", comment="zc正常 yc异常")
+    area_sqm = Column(Numeric(12, 2), nullable=True, comment="面积m²")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizCleanRoomAccessLog(Base):
+    """洁净室人员进出 biz_clean_room_access_log"""
+
+    __tablename__ = "biz_clean_room_access_log"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    clean_room_id = Column(String(64), nullable=False, comment="洁净室ID")
+    user_id = Column(String(64), nullable=True, comment="人员用户ID")
+    person_name = Column(String(100), nullable=True, comment="人员姓名（冗余）")
+    dept_name = Column(String(200), nullable=True, comment="部门")
+    enter_time = Column(DateTime, nullable=False, comment="进入时间")
+    purpose = Column(String(512), nullable=True, comment="目的")
+    leave_time = Column(DateTime, nullable=True, comment="离开时间")
+    body_temp = Column(String(32), nullable=True, comment="体温")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizStorageFacility(Base):
+    """细胞存储设施树节点 biz_storage_facility"""
+
+    __tablename__ = "biz_storage_facility"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    parent_id = Column(String(64), nullable=False, default="0", comment="父节点ID，0根")
+    node_name = Column(String(200), nullable=False, comment="节点名称（罐/层/盒等）")
+    node_type = Column(String(32), nullable=True, comment="facility/layer/box 等扩展")
+    is_leaf = Column(SmallInteger, nullable=False, default=0, comment="是否叶子存储位 1是")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizStorageFacilitySlot(Base):
+    """细胞存储设施储存位置（格子）biz_storage_facility_slot"""
+
+    __tablename__ = "biz_storage_facility_slot"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    facility_node_id = Column(String(64), nullable=False, comment="设施树叶子节点ID")
+    slot_code = Column(String(64), nullable=True, comment="小格编码/坐标")
+    slot_status = Column(String(16), nullable=True, comment="占用状态等扩展")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+
+
+class BizExhibitionAppointment(Base):
+    """展馆预约 biz_exhibition_appointment"""
+
+    __tablename__ = "biz_exhibition_appointment"
+
+    id = Column(String(64), primary_key=True, comment="主键ID")
+    appointment_no = Column(String(64), nullable=False, comment="预约编号")
+    visit_org = Column(String(200), nullable=True, comment="来访单位")
+    contact_name = Column(String(100), nullable=True, comment="联系人")
+    visit_date = Column(CHAR(8), nullable=True, comment="到访日期YYYYMMDD")
+    visitor_count = Column(Integer, nullable=True, comment="人数")
+    reception_user_id = Column(String(64), nullable=True, comment="接待人员用户ID")
+    tenant_no = Column(String(64), nullable=False, default="zkxw", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(512), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建人id")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新人id")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+```
+
+- [ ] **Step 2: Verify models load without errors**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.models.models import BizCleanRoom, BizCleanRoomAccessLog, BizStorageFacility, BizStorageFacilitySlot, BizExhibitionAppointment; print('All models imported OK')"`
+Expected: "All models imported OK"
+
+---
+
+## Task 2: Backend CRUD — Exhibition Appointment (simplest, start here)
+
+**Files:**
+- Create: `backend/app/crud/exhibition_appointment.py`
+
+- [ ] **Step 1: Create CRUD file**
+
+Create `backend/app/crud/exhibition_appointment.py` following the `item_unit.py` pattern exactly. Functions: `_row_to_dict`, `list_exhibition_appointments`, `get_exhibition_appointment`, `appointment_no_exists`, `create_exhibition_appointment`, `update_exhibition_appointment`, `soft_delete_exhibition_appointment`, `total_pages`. All queries filter by `del_flag==0` and `tenant_no`. List supports keyword search on `appointment_no`, `visit_org`, `contact_name`. Default sort by `create_time DESC`.
+
+- [ ] **Step 2: Verify import**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.crud import exhibition_appointment; print('OK')"`
+Expected: "OK"
+
+---
+
+## Task 3: Backend CRUD — Clean Room + Access Log
+
+**Files:**
+- Create: `backend/app/crud/clean_room.py`
+
+- [ ] **Step 1: Create CRUD file**
+
+Create `backend/app/crud/clean_room.py` with two sets of CRUD functions:
+
+**Clean Room functions:** `_row_to_dict`, `list_clean_rooms`, `get_clean_room`, `room_code_exists`, `create_clean_room`, `update_clean_room`, `soft_delete_clean_room`, `total_pages`. Keyword search on `room_code`, `room_name`. Filter by `tenant_no` and `del_flag==0`.
+
+**Access Log functions:** `_access_log_to_dict`, `list_access_logs` (filter by `clean_room_id`), `get_access_log`, `create_access_log`, `update_access_log`, `soft_delete_access_log`. List supports `clean_room_id` filter + keyword on `person_name`, `dept_name`.
+
+- [ ] **Step 2: Verify import**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.crud import clean_room; print('OK')"`
+Expected: "OK"
+
+---
+
+## Task 4: Backend CRUD — Storage Facility (tree) + Slot
+
+**Files:**
+- Create: `backend/app/crud/storage_facility.py`
+
+- [ ] **Step 1: Create CRUD file**
+
+Create `backend/app/crud/storage_facility.py` with:
+
+**Facility tree functions:** `_row_to_dict`, `list_all_facilities` (returns flat list, filtered by `tenant_no`, `del_flag==0`), `get_facility`, `create_facility`, `update_facility`, `soft_delete_facility` (cascade: soft-delete all children + their slots), `get_children` (find direct children of a node).
+
+**Slot functions:** `_slot_to_dict`, `list_slots` (filter by `facility_node_id`), `get_slot`, `create_slot`, `update_slot`, `soft_delete_slot`.
+
+**Tree helpers:** `build_tree` — converts flat list to nested tree structure with `children` array. `collect_descendant_ids` — recursively collects all descendant node IDs for cascade delete.
+
+- [ ] **Step 2: Verify import**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.crud import storage_facility; print('OK')"`
+Expected: "OK"
+
+---
+
+## Task 5: Backend API Routes — operations.py
+
+**Files:**
+- Create: `backend/app/api/operations.py`
+
+- [ ] **Step 1: Create the API route file**
+
+Create `backend/app/api/operations.py` with `router = APIRouter(prefix="/web/admin", tags=["运营支撑"])`. Include:
+
+**Clean Room endpoints:**
+- `GET /clean-rooms` — paginated list with keyword
+- `POST /clean-rooms` — create
+- `PUT /clean-rooms/{room_id}` — update
+- `DELETE /clean-rooms/{room_id}` — soft delete
+
+**Access Log endpoints:**
+- `GET /clean-room-access-logs` — list by clean_room_id, paginated
+- `POST /clean-room-access-logs` — create
+- `PUT /clean-room-access-logs/{log_id}` — update
+- `DELETE /clean-room-access-logs/{log_id}` — soft delete
+
+**Storage Facility endpoints:**
+- `GET /storage-facilities` — flat list (frontend builds tree)
+- `POST /storage-facilities` — create node
+- `PUT /storage-facilities/{node_id}` — update node
+- `DELETE /storage-facilities/{node_id}` — cascade soft delete
+
+**Storage Slot endpoints:**
+- `GET /storage-facility-slots` — list by facility_node_id
+- `POST /storage-facility-slots` — create
+- `PUT /storage-facility-slots/{slot_id}` — update
+- `DELETE /storage-facility-slots/{slot_id}` — soft delete
+
+**Exhibition Appointment endpoints:**
+- `GET /exhibition-appointments` — paginated list with keyword
+- `POST /exhibition-appointments` — create
+- `PUT /exhibition-appointments/{appointment_id}` — update
+- `DELETE /exhibition-appointments/{appointment_id}` — soft delete
+
+All endpoints use `Depends(require_admin_or_super_admin)` and `_get_tenant_no(db, user)`.
+
+Each endpoint follows the pattern from `basic_info.py`: Pydantic body classes inline with `ConfigDict(populate_by_name=True)` and `Field(..., alias="camelCase")`. List endpoints return `success_response({"list": items, "total": total, "page": page, "pageSize": pageSize, "totalPages": tp})`.
+
+- [ ] **Step 2: Verify import**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.api.operations import router; print(f'Routes: {len(router.routes)}')"`
+Expected: "Routes: 13"
+
+---
+
+## Task 6: Backend Router Registration
+
+**Files:**
+- Modify: `backend/app/api/__init__.py`
+- Modify: `backend/app/main.py`
+
+- [ ] **Step 1: Register in __init__.py**
+
+Add to `backend/app/api/__init__.py`:
+```python
+from app.api.operations import router as operations_router
+```
+And add `"operations_router"` to `__all__`.
+
+- [ ] **Step 2: Register in main.py**
+
+Add to `backend/app/main.py` line 13 import section:
+```python
+from app.api import public_router, menu_router, admin_router, workflow_router, basic_info_router, collection_protocol_router, leave_router, operations_router
+```
+Add after line 67:
+```python
+app.include_router(operations_router, prefix=settings.API_V1_PREFIX)
+```
+
+- [ ] **Step 3: Verify app starts**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.main import app; print(f'App routes: {len(app.routes)}')"`
+Expected: A number > previous route count
+
+---
+
+## Task 7: Backend Tests
+
+**Files:**
+- Create: `backend/tests/test_operations_api.py`
+
+- [ ] **Step 1: Write test file**
+
+Create `backend/tests/test_operations_api.py` with tests for each module:
+
+1. **Clean Room tests:** test_create_clean_room, test_list_clean_rooms, test_update_clean_room, test_delete_clean_room
+2. **Access Log tests:** test_create_access_log, test_list_access_logs_by_room
+3. **Storage Facility tests:** test_create_facility_node, test_list_facilities_flat, test_create_child_node, test_cascade_delete
+4. **Slot tests:** test_create_slot, test_list_slots_by_node
+5. **Exhibition Appointment tests:** test_create_appointment, test_list_appointments, test_update_appointment, test_delete_appointment
+
+Use `pytest` with FastAPI `TestClient`. Each test creates, reads, updates, deletes and verifies. Tests can use the running dev server or TestClient.
+
+- [ ] **Step 2: Run tests**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -m pytest tests/test_operations_api.py -v`
+Expected: All tests PASS
+
+---
+
+## Task 8: Frontend API Functions
+
+**Files:**
+- Modify: `web-admin/src/api/admin.ts`
+
+- [ ] **Step 1: Add API functions for all 3 modules**
+
+Append to `web-admin/src/api/admin.ts` three new section blocks:
+
+**Clean Room section:**
+```typescript
+// ---------------------------------------------------------------------------
+// 洁净室管理
+// ---------------------------------------------------------------------------
+export function fetchCleanRoomList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get({ url: '/web/admin/clean-rooms', params })
+}
+export function fetchCreateCleanRoom(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/clean-rooms', params: data })
+}
+export function fetchUpdateCleanRoom(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/clean-rooms/${id}`, params: data })
+}
+export function fetchDeleteCleanRoom(id: string) {
+  return request.del({ url: `/web/admin/clean-rooms/${id}` })
+}
+// 人员进出
+export function fetchAccessLogList(params?: { page?: number; pageSize?: number; cleanRoomId?: string; keyword?: string }) {
+  return request.get({ url: '/web/admin/clean-room-access-logs', params })
+}
+export function fetchCreateAccessLog(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/clean-room-access-logs', params: data })
+}
+export function fetchUpdateAccessLog(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/clean-room-access-logs/${id}`, params: data })
+}
+export function fetchDeleteAccessLog(id: string) {
+  return request.del({ url: `/web/admin/clean-room-access-logs/${id}` })
+}
+```
+
+**Storage Facility section:**
+```typescript
+// ---------------------------------------------------------------------------
+// 库位管理
+// ---------------------------------------------------------------------------
+export function fetchStorageFacilityList(params?: { keyword?: string }) {
+  return request.get({ url: '/web/admin/storage-facilities', params })
+}
+export function fetchCreateStorageFacility(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/storage-facilities', params: data })
+}
+export function fetchUpdateStorageFacility(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/storage-facilities/${id}`, params: data })
+}
+export function fetchDeleteStorageFacility(id: string) {
+  return request.del({ url: `/web/admin/storage-facilities/${id}` })
+}
+// 格子
+export function fetchStorageSlotList(params?: { facilityNodeId?: string }) {
+  return request.get({ url: '/web/admin/storage-facility-slots', params })
+}
+export function fetchCreateStorageSlot(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/storage-facility-slots', params: data })
+}
+export function fetchUpdateStorageSlot(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/storage-facility-slots/${id}`, params: data })
+}
+export function fetchDeleteStorageSlot(id: string) {
+  return request.del({ url: `/web/admin/storage-facility-slots/${id}` })
+}
+```
+
+**Exhibition Appointment section:**
+```typescript
+// ---------------------------------------------------------------------------
+// 展馆预约
+// ---------------------------------------------------------------------------
+export function fetchExhibitionAppointmentList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get({ url: '/web/admin/exhibition-appointments', params })
+}
+export function fetchCreateExhibitionAppointment(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/exhibition-appointments', params: data })
+}
+export function fetchUpdateExhibitionAppointment(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/exhibition-appointments/${id}`, params: data })
+}
+export function fetchDeleteExhibitionAppointment(id: string) {
+  return request.del({ url: `/web/admin/exhibition-appointments/${id}` })
+}
+```
+
+- [ ] **Step 2: Verify no TypeScript errors**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm build:typecheck 2>&1 | tail -5`
+Expected: No errors related to new functions
+
+---
+
+## Task 9: Frontend Router — Add 运营支撑 Group
+
+**Files:**
+- Modify: `web-admin/src/router/modules/sqxp.ts`
+
+- [ ] **Step 1: Add route group**
+
+Add before the closing `]` of `sqxpAdminRoutes` (before the last `}` or after the Workflow section):
+
+```typescript
+  ,
+  {
+    id: '60000000000000000000000000000001',
+    name: 'Operations',
+    path: '/operations',
+    component: '/index/index',
+    meta: {
+      title: '运营支撑',
+      icon: 'operation',
+      keepAlive: false,
+      roles: ['admin']
+    },
+    children: [
+      {
+        id: '60000000000000000000000000000002',
+        name: 'CleanRoom',
+        path: 'clean-room',
+        component: '/operations/clean-room/index',
+        meta: { title: '洁净室管理', keepAlive: true }
+      },
+      {
+        id: '60000000000000000000000000000003',
+        name: 'StorageFacility',
+        path: 'storage-facility',
+        component: '/operations/storage-facility/index',
+        meta: { title: '库位管理', keepAlive: true }
+      },
+      {
+        id: '60000000000000000000000000000004',
+        name: 'ExhibitionAppointment',
+        path: 'exhibition-appointment',
+        component: '/operations/exhibition-appointment/index',
+        meta: { title: '展馆预约', keepAlive: true }
+      }
+    ]
+  }
+```
+
+- [ ] **Step 2: Verify routes compile**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm build:typecheck 2>&1 | tail -5`
+Expected: No route-related errors
+
+---
+
+## Task 10: Frontend — Clean Room Page
+
+**Files:**
+- Create: `web-admin/src/views/operations/clean-room/index.vue`
+
+- [ ] **Step 1: Create the Vue page**
+
+Create `web-admin/src/views/operations/clean-room/index.vue` following the `system/unit/index.vue` template exactly:
+
+**Page structure:**
+- `page-container` → `header.page-head` → `section.panel`
+- Filter: keyword search
+- Table columns: 编号(roomCode), 名称(roomName), 等级(roomGrade, tag display: A级绿色/B级蓝色/C级黄色/D级灰色), 状态(roomStatus, tag: 正常=success/异常=danger), 面积(areaSqm), 操作
+- Toolbar: 新增按钮, 批量删除按钮
+- Dialog form (label-position="top", form-grid-2):
+  - 编号(roomCode, required), 名称(roomName, required), 等级(roomGrade, select: A/B/C/D), 状态(roomStatus, select: 正常zc/异常yc), 面积(areaSqm, number input, suffix "m²"), 备注(remark)
+- 操作列: 查看, 编辑, 人员进出, 删除
+- "人员进出"按钮 → 打开新弹窗显示该洁净室的进出记录列表(带分页), 弹窗内支持新增/编辑/删除进出记录
+- 进出记录表单: 人员姓名(personName), 部门(deptName), 进入时间(enterTime, datetime), 目的(purpose), 离开时间(leaveTime, datetime), 体温(bodyTemp), 备注(remark)
+- View dialog using SystemViewDialog component
+- API calls: `fetchCleanRoomList`, `fetchCreateCleanRoom`, `fetchUpdateCleanRoom`, `fetchDeleteCleanRoom`, `fetchAccessLogList`, `fetchCreateAccessLog`, `fetchUpdateAccessLog`, `fetchDeleteAccessLog`
+
+- [ ] **Step 2: Verify page renders**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm dev`, then navigate to `/#/operations/clean-room`
+Expected: Page loads without console errors, shows empty list with filter bar and toolbar
+
+---
+
+## Task 11: Frontend — Storage Facility Page (Tree)
+
+**Files:**
+- Create: `web-admin/src/views/operations/storage-facility/index.vue`
+
+- [ ] **Step 1: Create the Vue page**
+
+Create `web-admin/src/views/operations/storage-facility/index.vue` following the `system/category/index.vue` tree template:
+
+**Page structure:**
+- Left panel: tree structure display using `el-table` with `row-key="id"` and `:tree-props="{ children: 'children' }"`
+  - Data fetched as flat list via `fetchStorageFacilityList`, then `buildTree()` converts to nested tree
+  - Tree columns: 节点名称(nodeName), 节点类型(nodeType, display as tag: facility=设施/layer=层/box=盒), 是否叶子(isLeaf, icon or tag), 备注(remark)
+  - Toolbar: 新增根节点, 展开全部, 折叠全部
+  - 操作列: 新增子节点, 编辑, 删除(需确认)
+- Right panel: when a leaf node (`isLeaf===1`) is selected, show its slots (格子) list
+  - Slot table: 编码(slotCode), 状态(slotStatus), 操作(编辑/删除)
+  - Add slot button
+- Dialog form for facility node (label-position="top", form-grid-2):
+  - 父节点(parentId, select from tree list, show full path via `buildTreePathLabelFromFlat`), 节点名称(nodeName, required), 节点类型(nodeType, select: facility/layer/box), 是否叶子(isLeaf, switch), 备注(remark)
+- Dialog form for slot:
+  - 编码(slotCode, required), 状态(slotStatus, select), 备注(remark)
+- Tree utilities: import `buildTreePathLabelFromFlat` from `@/utils/tree-path`
+- API calls: `fetchStorageFacilityList`, `fetchCreateStorageFacility`, `fetchUpdateStorageFacility`, `fetchDeleteStorageFacility`, `fetchStorageSlotList`, `fetchCreateStorageSlot`, `fetchUpdateStorageSlot`, `fetchDeleteStorageSlot`
+
+- [ ] **Step 2: Verify page renders**
+
+Navigate to `/#/operations/storage-facility`
+Expected: Page loads, shows empty tree with toolbar
+
+---
+
+## Task 12: Frontend — Exhibition Appointment Page
+
+**Files:**
+- Create: `web-admin/src/views/operations/exhibition-appointment/index.vue`
+
+- [ ] **Step 1: Create the Vue page**
+
+Create `web-admin/src/views/operations/exhibition-appointment/index.vue` following the `system/unit/index.vue` standard list template:
+
+**Page structure:**
+- Filter: keyword search (搜索预约编号/来访单位/联系人)
+- Table columns: 预约编号(appointmentNo), 来访单位(visitOrg), 联系人(contactName), 到访日期(visitDate), 人数(visitorCount), 接待人员(receptionUserId → display name), 操作
+- Toolbar: 新增按钮, 批量删除按钮
+- Dialog form (label-position="top", form-grid-2):
+  - 预约编号(appointmentNo, required), 来访单位(visitOrg, required), 联系人(contactName), 到访日期(visitDate, date picker), 人数(visitorCount, number input), 接待人员(receptionUserId, select from user options), 备注(remark)
+- View dialog using SystemViewDialog component
+- API calls: `fetchExhibitionAppointmentList`, `fetchCreateExhibitionAppointment`, `fetchUpdateExhibitionAppointment`, `fetchDeleteExhibitionAppointment`
+
+- [ ] **Step 2: Verify page renders**
+
+Navigate to `/#/operations/exhibition-appointment`
+Expected: Page loads without errors, shows empty list
+
+---
+
+## Task 13: Integration Test & Verification
+
+- [ ] **Step 1: Start backend and verify all API endpoints**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -m pytest tests/test_operations_api.py -v`
+Expected: All tests pass
+
+- [ ] **Step 2: Start frontend and verify all 3 pages**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm dev`
+Navigate to each page:
+- `/#/operations/clean-room` — verify list, create dialog, access log dialog
+- `/#/operations/storage-facility` — verify tree display, node CRUD, slot CRUD
+- `/#/operations/exhibition-appointment` — verify list, create/edit dialog
+
+- [ ] **Step 3: Run frontend typecheck**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm build:typecheck`
+Expected: No TypeScript errors
+
+- [ ] **Step 4: Run frontend lint**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && pnpm lint`
+Expected: No lint errors (or only pre-existing ones)
+
+---
+
+## Self-Review Checklist
+
+1. **Spec coverage**: All 5 tables have models ✓, all 3 modules have CRUD ✓, API ✓, frontend ✓
+2. **Placeholder scan**: No TBD/TODO, all steps have actual code or descriptions ✓
+3. **Type consistency**: Model field names match CRUD `_row_to_dict` keys match API aliases ✓
+4. **Convention compliance**: tenant_no filter ✓, soft delete ✓, camelCase API ✓, Fresh Mint colors ✓
diff --git a/docs/superpowers/plans/2026-05-15-storage-facility-redesign.md b/docs/superpowers/plans/2026-05-15-storage-facility-redesign.md
new file mode 100644
index 00000000..80b3431b
--- /dev/null
+++ b/docs/superpowers/plans/2026-05-15-storage-facility-redesign.md
@@ -0,0 +1,924 @@
+# 库位管理页面改造 — 实现计划
+
+> **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:** 将库位管理页面从树形表格+右侧窄面板改为左右布局（左侧 el-tree 树形列表 + 右侧货架行格子卡片），并新增批量生成格子功能。
+
+**Architecture:** 前端完全重写 `index.vue`，参考 `user/index.vue` 的 el-tree 侧边栏模式。后端新增一个批量创建格子的 API 端点（rows×cols 参数 → 一次事务创建多个 slot）。前端格子区域使用 CSS flex 按行分组展示，每行左侧有行标（A/B/C），格子内编号+状态在第一行，下方预留空间。
+
+**Tech Stack:** FastAPI + SQLAlchemy（后端），Vue 3 + Element Plus + SCSS（前端）
+
+---
+
+## File Structure
+
+| File | Action | Responsibility |
+|------|--------|---------------|
+| `backend/app/crud/storage_facility.py` | Modify | 新增 `batch_create_slots()` 函数 |
+| `backend/app/api/operations.py` | Modify | 新增 `POST /storage-facility-slots/batch` 端点 |
+| `web-admin/src/api/admin.ts` | Modify | 新增 `fetchBatchCreateSlots()` 函数 |
+| `web-admin/src/views/operations/storage-facility/index.vue` | Rewrite | 完全重写为 el-tree + 货架行布局 |
+
+---
+
+### Task 1: 后端 — 批量创建格子 CRUD 函数
+
+**Files:**
+- Modify: `backend/app/crud/storage_facility.py` (在文件末尾 `soft_delete_slot` 之后追加)
+
+- [ ] **Step 1: 在 `storage_facility.py` 末尾添加 `batch_create_slots` 函数**
+
+在 `backend/app/crud/storage_facility.py` 文件末尾追加以下函数（在 `soft_delete_slot` 函数之后）：
+
+```python
+def batch_create_slots(
+    db: Session,
+    *,
+    facility_node_id: str,
+    rows: int,
+    cols: int,
+    code_prefix: str = "",
+    tenant_no: str = "zkxw",
+    user_id: Optional[str] = None,
+) -> List[Dict[str, Any]]:
+    """Batch create rows×cols slots for a leaf facility node in a single transaction."""
+    fid = (facility_node_id or "").strip()
+    if not fid:
+        raise ValueError("所属设施节点不能为空")
+    if rows < 1 or cols < 1:
+        raise ValueError("行数和列数必须大于 0")
+    if rows > 50 or cols > 50:
+        raise ValueError("单次最多生成 50×50 = 2500 个格子")
+
+    node = db.query(BizStorageFacility).filter(
+        and_(BizStorageFacility.id == fid, BizStorageFacility.del_flag == 0)
+    ).first()
+    if not node:
+        raise ValueError("所属设施节点不存在")
+    if not node.is_leaf:
+        raise ValueError("只能为叶子节点创建格子")
+
+    prefix = (code_prefix or "").strip()
+    now = datetime.now()
+    slots: List[BizStorageFacilitySlot] = []
+
+    for r in range(1, rows + 1):
+        for c in range(1, cols + 1):
+            code = f"{prefix}{r}-{c}" if prefix else f"{r}-{c}"
+            order = (r - 1) * cols + c
+            obj = BizStorageFacilitySlot(
+                id=generate_uuid(),
+                facility_node_id=fid,
+                slot_code=code,
+                slot_status="空",
+                tenant_no=tenant_no,
+                order_num=order,
+                remark=None,
+                create_by=user_id,
+                create_dept_id="",
+                create_time=now,
+                update_by=user_id,
+                update_time=now,
+                del_flag=0,
+            )
+            db.add(obj)
+            slots.append(obj)
+
+    db.commit()
+    for s in slots:
+        db.refresh(s)
+    return [_slot_to_dict(s) for s in slots]
+```
+
+- [ ] **Step 2: 验证语法无误**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.crud.storage_facility import batch_create_slots; print('OK')"`
+Expected: `OK`
+
+---
+
+### Task 2: 后端 — 批量创建格子 API 端点
+
+**Files:**
+- Modify: `backend/app/api/operations.py` (在 `StorageSlotCreateBody` 类之后、`list_storage_slots` 端点之前插入)
+
+- [ ] **Step 1: 添加 Pydantic body model 和 API 端点**
+
+在 `backend/app/api/operations.py` 中，在 `StorageSlotCreateBody` 类定义之后（约第 377 行之后），添加 body model：
+
+```python
+class StorageSlotBatchCreateBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    facility_node_id: str = Field(..., alias="facilityNodeId")
+    rows: int = Field(..., ge=1, le=50)
+    cols: int = Field(..., ge=1, le=50)
+    code_prefix: Optional[str] = Field("", alias="codePrefix")
+```
+
+然后在 `@router.post("/storage-facility-slots")` 端点之前（`StorageSlotBatchCreateBody` 定义之后），添加批量创建端点：
+
+```python
+@router.post("/storage-facility-slots/batch")
+async def batch_create_storage_slots(
+    body: StorageSlotBatchCreateBody,
+    user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = _get_tenant_no(db, user)
+        items = storage_facility_svc.batch_create_slots(
+            db,
+            facility_node_id=body.facility_node_id,
+            rows=body.rows,
+            cols=body.cols,
+            code_prefix=body.code_prefix,
+            tenant_no=tenant_no,
+            user_id=user.get("user_id"),
+        )
+        return success_response(items, message=f"批量创建 {len(items)} 个格子成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+```
+
+**重要**：这个端点必须放在 `/storage-facility-slots` 路由之前，否则 FastAPI 会把 `batch` 当做 `{slot_id}` 参数匹配。
+
+- [ ] **Step 2: 验证语法无误**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/backend && source venv/bin/activate && python -c "from app.api.operations import router; print('OK')"`
+Expected: `OK`
+
+---
+
+### Task 3: 前端 — 添加批量创建 API 函数
+
+**Files:**
+- Modify: `web-admin/src/api/admin.ts` (在 `fetchCreateStorageSlot` 函数之后)
+
+- [ ] **Step 1: 在 `admin.ts` 中 `fetchCreateStorageSlot` 之后添加批量创建函数**
+
+在 `web-admin/src/api/admin.ts` 中，在 `fetchCreateStorageSlot` 函数（第 1336-1338 行）之后插入：
+
+```typescript
+export function fetchBatchCreateSlots(data: { facilityNodeId: string; rows: number; cols: number; codePrefix?: string }) {
+  return request.post({ url: '/web/admin/storage-facility-slots/batch', params: data })
+}
+```
+
+- [ ] **Step 2: 验证 lint 通过**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && npx eslint src/api/admin.ts --no-error-on-unmatched-pattern 2>&1 | tail -5`
+Expected: 无错误输出
+
+---
+
+### Task 4: 前端 — 重写库位管理页面
+
+**Files:**
+- Rewrite: `web-admin/src/views/operations/storage-facility/index.vue`
+- Reference: `web-admin/src/views/system/user/index.vue` (el-tree 侧边栏模式)
+- Reference: `web-admin/storage-redesign-prototype.html` (视觉原型)
+
+这是最大的任务。完全重写页面，从树形表格+窄面板 → el-tree 侧边栏 + 货架行格子布局。
+
+- [ ] **Step 1: 重写整个 index.vue**
+
+用以下完整内容替换 `web-admin/src/views/operations/storage-facility/index.vue` 的全部内容。
+
+**关键设计决策：**
+
+1. **左侧 el-tree** — 参考 `user/index.vue` 的 `w-[280px] shrink-0 border-r` 布局。使用 `el-tree` 组件 + `buildTree()` 构建树形数据。树节点通过 `@node-click` 触发右侧面板更新。
+
+2. **右侧货架行格子** — 使用 flex 布局，按行分组。每行由行标 `.shelf-label` + 格子容器 `.shelf-cells` 组成。每个格子 `.shelf-cell` 内编号+状态在顶部一行，下方预留空间。
+
+3. **批量生成** — 点击"批量生成格子"弹出 dialog，输入行数、列数、编码前缀。确认后调用 `fetchBatchCreateSlots`。
+
+4. **格子编辑** — 点击格子弹出编辑 dialog，修改编码和状态。
+
+5. **节点 CRUD** — el-tree 节点 hover 显示操作按钮（新增子节点、编辑、删除），点击弹出 dialog。
+
+**完整代码如下：**
+
+```vue
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>库位管理</h1>
+      <p class="page-desc">维护库位设施树结构，以及叶子节点的格子管理。</p>
+    </header>
+
+    <section class="panel">
+      <div class="flex gap-4">
+        <div class="w-[280px] shrink-0 border-r border-[var(--mint-border)] pr-4">
+          <div class="panel-top sf-tree-aside__head">
+            <h2 class="title-bar-heading">库位树</h2>
+            <el-button class="btn-main" type="primary" size="small" @click="handleAddRoot">新增</el-button>
+          </div>
+          <el-input
+            v-model="treeKeyword"
+            placeholder="搜索节点"
+            clearable
+            class="sf-tree-search"
+          />
+          <el-tree
+            ref="treeRef"
+            :data="treeData"
+            :props="{ label: 'nodeName', children: 'children' }"
+            node-key="id"
+            highlight-current
+            default-expand-all
+            :filter-node-method="filterNode"
+            @node-click="handleNodeClick"
+          >
+            <template #default="{ node, data }">
+              <div class="sf-tree-node" @mouseenter="hoveredNodeId = data.id" @mouseleave="hoveredNodeId = ''">
+                <span class="sf-tree-node__label">{{ data.nodeName }}</span>
+                <span v-if="data.isLeaf === 1" class="sf-tree-node__leaf">叶</span>
+                <div v-if="hoveredNodeId === data.id" class="sf-tree-node__ops" @click.stop>
+                  <el-button v-if="data.isLeaf !== 1" link size="small" @click="handleAddChild(data)">+</el-button>
+                  <el-button link size="small" @click="handleEditNode(data)">编辑</el-button>
+                  <el-button link size="small" type="danger" @click="handleDeleteNode(data)">删除</el-button>
+                </div>
+              </div>
+            </template>
+          </el-tree>
+        </div>
+
+        <div class="flex-1 min-w-0">
+          <div v-if="!selectedNode" class="sf-empty">
+            <el-empty description="请在左侧选择一个叶子节点查看格子" />
+          </div>
+
+          <template v-if="selectedNode && selectedNode.isLeaf !== 1">
+            <div class="panel-top">
+              <h2 class="title-bar-heading">{{ selectedNode.nodeName }}</h2>
+            </div>
+            <el-empty description="非叶子节点，请继续选择子节点" />
+          </template>
+
+          <template v-if="selectedNode && selectedNode.isLeaf === 1">
+            <div class="panel-top">
+              <h2 class="title-bar-heading">
+                {{ buildTreePathLabelFromFlat(selectedNode.id, flatList, { nameKey: 'nodeName' }) }} — 格子管理
+              </h2>
+              <span class="sf-count">共 {{ slotList.length }} 个格子</span>
+            </div>
+
+            <div class="list-toolbar">
+              <div class="list-toolbar-row">
+                <el-button class="btn-main" type="primary" @click="handleBatchCreate">批量生成格子</el-button>
+                <el-button
+                  v-if="slotList.length > 0"
+                  class="btn-ghost"
+                  @click="handleClearAllSlots"
+                >
+                  清空格子
+                </el-button>
+              </div>
+            </div>
+
+            <div v-if="slotList.length === 0" class="sf-empty">
+              <el-empty description="暂无格子，点击「批量生成格子」创建" />
+            </div>
+
+            <div v-else class="sf-shelf-container">
+              <div v-for="(row, ri) in shelfRows" :key="ri" class="sf-shelf-row">
+                <div class="sf-shelf-label">{{ row.label }}</div>
+                <div class="sf-shelf-cells">
+                  <div
+                    v-for="cell in row.cells"
+                    :key="cell.id"
+                    class="sf-shelf-cell"
+                    :class="{ 'is-occupied': cell.slotStatus === '占用' }"
+                    @click="handleEditSlot(cell)"
+                  >
+                    <div class="sf-cell-top">
+                      <span class="sf-cell-code">{{ cell.slotCode }}</span>
+                      <span
+                        class="sf-cell-status"
+                        :class="cell.slotStatus === '占用' ? 'is-occupied' : 'is-empty'"
+                      >
+                        {{ cell.slotStatus || '空' }}
+                      </span>
+                    </div>
+                    <div class="sf-cell-body">
+                      <span class="sf-cell-reserved">—</span>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </template>
+        </div>
+      </div>
+    </section>
+
+    <el-dialog
+      v-model="nodeDialogVisible"
+      :title="nodeDialogTitle"
+      width="560px"
+      class="dialog-form-layout"
+      align-center
+      destroy-on-close
+      :close-on-click-modal="false"
+      @close="handleNodeDialogClose"
+    >
+      <el-form
+        ref="nodeFormRef"
+        :model="nodeFormData"
+        :rules="nodeFormRules"
+        label-position="top"
+        scroll-to-error
+        :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+      >
+        <div class="form-grid-2">
+          <el-form-item label="上级节点">
+            <el-select
+              v-model="nodeFormData.parentId"
+              placeholder="请选择上级节点（空为根节点）"
+              clearable
+              filterable
+            >
+              <el-option
+                v-for="item in flatList"
+                :key="item.id"
+                :label="buildTreePathLabelFromFlat(item.id, flatList, { nameKey: 'nodeName' })"
+                :value="item.id"
+              />
+            </el-select>
+          </el-form-item>
+          <el-form-item label="节点名称" prop="nodeName">
+            <el-input v-model="nodeFormData.nodeName" placeholder="请输入节点名称" />
+          </el-form-item>
+          <el-form-item label="节点类型">
+            <el-select v-model="nodeFormData.nodeType" placeholder="请选择节点类型">
+              <el-option label="设施" value="facility" />
+              <el-option label="层" value="layer" />
+              <el-option label="盒" value="box" />
+            </el-select>
+          </el-form-item>
+          <el-form-item label="是否叶子">
+            <el-switch v-model="nodeFormData.isLeaf" :active-value="1" :inactive-value="0" />
+          </el-form-item>
+          <el-form-item label="备注" class="form-col-span-2">
+            <el-input v-model="nodeFormData.remark" placeholder="可选" />
+          </el-form-item>
+        </div>
+      </el-form>
+      <template #footer>
+        <el-button class="btn-ghost" @click="nodeDialogVisible = false">取消</el-button>
+        <el-button class="btn-main" type="primary" @click="handleNodeSubmit" :loading="nodeSubmitLoading">确定</el-button>
+      </template>
+    </el-dialog>
+
+    <el-dialog
+      v-model="slotDialogVisible"
+      :title="slotDialogTitle"
+      width="480px"
+      class="dialog-form-layout"
+      align-center
+      destroy-on-close
+      :close-on-click-modal="false"
+      @close="handleSlotDialogClose"
+    >
+      <el-form
+        ref="slotFormRef"
+        :model="slotFormData"
+        :rules="slotFormRules"
+        label-position="top"
+        scroll-to-error
+        :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+      >
+        <div class="form-grid-2">
+          <el-form-item label="格子编码" prop="slotCode">
+            <el-input v-model="slotFormData.slotCode" placeholder="请输入格子编码" />
+          </el-form-item>
+          <el-form-item label="格子状态">
+            <el-select v-model="slotFormData.slotStatus" placeholder="请选择状态">
+              <el-option label="空" value="空" />
+              <el-option label="占用" value="占用" />
+            </el-select>
+          </el-form-item>
+        </div>
+      </el-form>
+      <template #footer>
+        <el-button class="btn-ghost" @click="slotDialogVisible = false">取消</el-button>
+        <el-button class="btn-main" type="primary" @click="handleSlotSubmit" :loading="slotSubmitLoading">确定</el-button>
+      </template>
+    </el-dialog>
+
+    <el-dialog
+      v-model="batchDialogVisible"
+      title="批量生成格子"
+      width="440px"
+      class="dialog-form-layout"
+      align-center
+      destroy-on-close
+      :close-on-click-modal="false"
+    >
+      <el-form label-position="top">
+        <div class="form-grid-2">
+          <el-form-item label="行数">
+            <el-input-number v-model="batchForm.rows" :min="1" :max="20" style="width: 100%" />
+          </el-form-item>
+          <el-form-item label="列数">
+            <el-input-number v-model="batchForm.cols" :min="1" :max="20" style="width: 100%" />
+          </el-form-item>
+        </div>
+        <el-form-item label="编码前缀">
+          <el-input v-model="batchForm.codePrefix" placeholder="如 A、B-、01-（可选）" />
+          <template #label>
+            编码前缀
+            <span class="form-label-tip">生成格式：前缀+行号-列号，如 A-1-1</span>
+          </template>
+        </el-form-item>
+        <div class="sf-batch-preview">
+          将生成 <strong>{{ batchForm.rows * batchForm.cols }}</strong> 个格子（{{ batchForm.rows }} 行 × {{ batchForm.cols }} 列）
+        </div>
+      </el-form>
+      <template #footer>
+        <el-button class="btn-ghost" @click="batchDialogVisible = false">取消</el-button>
+        <el-button class="btn-main" type="primary" @click="handleBatchSubmit" :loading="batchSubmitLoading">确认生成</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import {
+    fetchStorageFacilityList,
+    fetchCreateStorageFacility,
+    fetchUpdateStorageFacility,
+    fetchDeleteStorageFacility,
+    fetchStorageSlotList,
+    fetchBatchCreateSlots,
+    fetchUpdateStorageSlot,
+    fetchDeleteStorageSlot
+  } from '@/api/admin'
+  import { buildTreePathLabelFromFlat } from '@/utils/tree-path'
+
+  defineOptions({ name: 'StorageFacility' })
+
+  const ROW_LABELS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T']
+
+  const hoveredNodeId = ref('')
+  const treeKeyword = ref('')
+  const treeRef = ref()
+  const loading = ref(false)
+  const flatList = ref<any[]>([])
+  const treeData = ref<any[]>([])
+  const selectedNode = ref<any>(null)
+  const slotLoading = ref(false)
+  const slotList = ref<any[]>([])
+
+  const buildTree = (list: any[]) => {
+    const map = new Map<string, any>()
+    const roots: any[] = []
+    list.forEach(item => { map.set(item.id, { ...item, children: [] }) })
+    list.forEach(item => {
+      const node = map.get(item.id)!
+      if (item.parentId && item.parentId !== '0' && map.has(item.parentId)) {
+        map.get(item.parentId)!.children.push(node)
+      } else {
+        roots.push(node)
+      }
+    })
+    return roots
+  }
+
+  const loadData = async () => {
+    loading.value = true
+    try {
+      const res: any = await fetchStorageFacilityList({ keyword: treeKeyword.value || undefined })
+      const list = res?.list || res || []
+      flatList.value = list
+      treeData.value = buildTree(list)
+    } catch (error) {
+      console.error('加载库位数据失败:', error)
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const filterNode = (value: string, data: any) => {
+    if (!value) return true
+    return data.nodeName?.includes(value)
+  }
+
+  watch(treeKeyword, val => { treeRef.value?.filter(val) })
+
+  const handleNodeClick = async (data: any) => {
+    selectedNode.value = data
+    if (data.isLeaf === 1) {
+      await loadSlots(data.id)
+    } else {
+      slotList.value = []
+    }
+  }
+
+  const loadSlots = async (facilityNodeId: string) => {
+    slotLoading.value = true
+    try {
+      const res: any = await fetchStorageSlotList({ facilityNodeId })
+      slotList.value = res?.list || res || []
+    } catch (error) {
+      console.error('加载格子数据失败:', error)
+      slotList.value = []
+    } finally {
+      slotLoading.value = false
+    }
+  }
+
+  const shelfRows = computed(() => {
+    const cols = batchForm.cols
+    const result: { label: string; cells: any[] }[] = []
+    for (let r = 0; r * cols < slotList.value.length; r++) {
+      const rowCells = slotList.value.slice(r * cols, (r + 1) * cols)
+      if (rowCells.length > 0) {
+        result.push({ label: ROW_LABELS[r] || String(r + 1), cells: rowCells })
+      }
+    }
+    return result
+  })
+
+  const nodeDialogVisible = ref(false)
+  const nodeDialogTitle = ref('新增根节点')
+  const isNodeEdit = ref(false)
+  const nodeSubmitLoading = ref(false)
+  const nodeFormRef = ref()
+  const nodeFormData = reactive({
+    id: '',
+    parentId: '',
+    nodeName: '',
+    nodeType: 'facility',
+    isLeaf: 0 as 0 | 1,
+    remark: ''
+  })
+  const nodeFormRules = { nodeName: [{ required: true, message: '请输入节点名称', trigger: 'blur' }] }
+
+  const handleAddRoot = () => {
+    isNodeEdit.value = false
+    nodeDialogTitle.value = '新增根节点'
+    Object.assign(nodeFormData, { id: '', parentId: '', nodeName: '', nodeType: 'facility', isLeaf: 0, remark: '' })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleAddChild = (row: any) => {
+    isNodeEdit.value = false
+    nodeDialogTitle.value = '新增子节点'
+    Object.assign(nodeFormData, { id: '', parentId: row.id, nodeName: '', nodeType: 'layer', isLeaf: 0, remark: '' })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleEditNode = (row: any) => {
+    isNodeEdit.value = true
+    nodeDialogTitle.value = '编辑节点'
+    Object.assign(nodeFormData, {
+      id: row.id,
+      parentId: row.parentId || '',
+      nodeName: row.nodeName || '',
+      nodeType: row.nodeType || 'facility',
+      isLeaf: row.isLeaf ?? 0,
+      remark: row.remark || ''
+    })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleNodeSubmit = async () => {
+    await nodeFormRef.value?.validate?.()
+    nodeSubmitLoading.value = true
+    try {
+      const payload = {
+        parentId: nodeFormData.parentId || undefined,
+        nodeName: nodeFormData.nodeName.trim(),
+        nodeType: nodeFormData.nodeType,
+        isLeaf: nodeFormData.isLeaf,
+        remark: nodeFormData.remark?.trim() || undefined
+      }
+      if (isNodeEdit.value && nodeFormData.id) {
+        await fetchUpdateStorageFacility(nodeFormData.id, payload)
+      } else {
+        await fetchCreateStorageFacility(payload)
+      }
+      ElMessage.success(isNodeEdit.value ? '更新成功' : '创建成功')
+      nodeDialogVisible.value = false
+      await loadData()
+    } catch { /* handled globally */ } finally {
+      nodeSubmitLoading.value = false
+    }
+  }
+
+  const handleNodeDialogClose = () => {
+    Object.assign(nodeFormData, { id: '', parentId: '', nodeName: '', nodeType: 'facility', isLeaf: 0, remark: '' })
+    nodeFormRef.value?.clearValidate?.()
+  }
+
+  const handleDeleteNode = async (row: any) => {
+    try {
+      await ElMessageBox.confirm('删除节点将一并删除其子节点和格子。确定继续吗？', '提示', { type: 'warning' })
+      await fetchDeleteStorageFacility(row.id)
+      ElMessage.success('删除成功')
+      if (selectedNode.value?.id === row.id) {
+        selectedNode.value = null
+        slotList.value = []
+      }
+      await loadData()
+    } catch (error: any) {
+      if (error !== 'cancel') console.error('删除失败:', error)
+    }
+  }
+
+  const slotDialogVisible = ref(false)
+  const slotDialogTitle = ref('编辑格子')
+  const isSlotEdit = ref(false)
+  const slotSubmitLoading = ref(false)
+  const slotFormRef = ref()
+  const editingSlotId = ref<string | null>(null)
+  const slotFormData = reactive({ slotCode: '', slotStatus: '空' })
+  const slotFormRules = { slotCode: [{ required: true, message: '请输入格子编码', trigger: 'blur' }] }
+
+  const handleEditSlot = (row: any) => {
+    isSlotEdit.value = true
+    slotDialogTitle.value = '编辑格子'
+    editingSlotId.value = row.id
+    Object.assign(slotFormData, { slotCode: row.slotCode || '', slotStatus: row.slotStatus || '空' })
+    slotDialogVisible.value = true
+    nextTick(() => slotFormRef.value?.clearValidate?.())
+  }
+
+  const handleSlotSubmit = async () => {
+    await slotFormRef.value?.validate?.()
+    slotSubmitLoading.value = true
+    try {
+      const payload = {
+        facilityNodeId: selectedNode.value?.id,
+        slotCode: slotFormData.slotCode.trim(),
+        slotStatus: slotFormData.slotStatus
+      }
+      if (editingSlotId.value) {
+        await fetchUpdateStorageSlot(editingSlotId.value, payload)
+      }
+      ElMessage.success('更新成功')
+      slotDialogVisible.value = false
+      if (selectedNode.value?.id) await loadSlots(selectedNode.value.id)
+    } catch { /* handled globally */ } finally {
+      slotSubmitLoading.value = false
+    }
+  }
+
+  const handleSlotDialogClose = () => {
+    Object.assign(slotFormData, { slotCode: '', slotStatus: '空' })
+    editingSlotId.value = null
+    slotFormRef.value?.clearValidate?.()
+  }
+
+  const batchDialogVisible = ref(false)
+  const batchSubmitLoading = ref(false)
+  const batchForm = reactive({ rows: 4, cols: 6, codePrefix: '' })
+
+  const handleBatchCreate = () => {
+    Object.assign(batchForm, { rows: 4, cols: 6, codePrefix: '' })
+    batchDialogVisible.value = true
+  }
+
+  const handleBatchSubmit = async () => {
+    if (!selectedNode.value?.id) return
+    batchSubmitLoading.value = true
+    try {
+      await fetchBatchCreateSlots({
+        facilityNodeId: selectedNode.value.id,
+        rows: batchForm.rows,
+        cols: batchForm.cols,
+        codePrefix: batchForm.codePrefix || undefined
+      })
+      ElMessage.success('批量生成成功')
+      batchDialogVisible.value = false
+      await loadSlots(selectedNode.value.id)
+    } catch { /* handled globally */ } finally {
+      batchSubmitLoading.value = false
+    }
+  }
+
+  const handleClearAllSlots = async () => {
+    try {
+      await ElMessageBox.confirm(`确定要清空当前节点的全部 ${slotList.value.length} 个格子吗？`, '提示', { type: 'warning' })
+      for (const slot of slotList.value) {
+        await fetchDeleteStorageSlot(slot.id)
+      }
+      ElMessage.success('清空成功')
+      if (selectedNode.value?.id) await loadSlots(selectedNode.value.id)
+    } catch (error: any) {
+      if (error !== 'cancel') console.error('清空失败:', error)
+    }
+  }
+
+  onMounted(() => { loadData() })
+</script>
+
+<style lang="scss" scoped>
+.sf-tree-aside__head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.sf-tree-search {
+  margin-bottom: 12px;
+}
+
+.sf-tree-node {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  flex: 1;
+  font-size: 13px;
+  overflow: hidden;
+}
+
+.sf-tree-node__label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.sf-tree-node__leaf {
+  font-size: 10px;
+  padding: 0 4px;
+  border-radius: 3px;
+  background: var(--el-color-success-light-9, #ecfdf5);
+  color: var(--el-color-success, #10b981);
+  flex-shrink: 0;
+}
+
+.sf-tree-node__ops {
+  display: flex;
+  gap: 2px;
+  margin-left: auto;
+  flex-shrink: 0;
+}
+
+.sf-empty {
+  padding: 60px 0;
+}
+
+.sf-count {
+  font-size: 12px;
+  color: var(--el-text-color-secondary, #909399);
+  margin-left: 8px;
+}
+
+/* Shelf layout */
+.sf-shelf-container {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.sf-shelf-row {
+  display: flex;
+  align-items: stretch;
+}
+
+.sf-shelf-label {
+  width: 36px;
+  flex-shrink: 0;
+  background: #059669;
+  color: #fff;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 13px;
+  font-weight: 600;
+  border-radius: 6px 0 0 6px;
+}
+
+.sf-shelf-cells {
+  display: flex;
+  flex: 1;
+}
+
+.sf-shelf-cell {
+  flex: 1;
+  min-height: 80px;
+  border: 1px solid var(--el-border-color-lighter, #d1fae5);
+  border-right: none;
+  display: flex;
+  flex-direction: column;
+  cursor: pointer;
+  transition: background 0.15s;
+  background: #fff;
+  padding: 8px 6px;
+  position: relative;
+}
+
+.sf-shelf-cell:last-child {
+  border-right: 1px solid var(--el-border-color-lighter, #d1fae5);
+  border-radius: 0 6px 6px 0;
+}
+
+.sf-shelf-cell:first-child {
+  border-radius: 0;
+}
+
+.sf-shelf-cell:hover {
+  background: #ecfdf5;
+}
+
+.sf-shelf-cell.is-occupied {
+  background: #fffbeb;
+  border-color: #fde68a;
+}
+
+.sf-shelf-cell.is-occupied:hover {
+  background: #fef3c7;
+}
+
+.sf-cell-top {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 4px;
+}
+
+.sf-cell-code {
+  font-size: 14px;
+  font-weight: 600;
+  color: #303133;
+}
+
+.sf-shelf-cell.is-occupied .sf-cell-code {
+  color: #92400e;
+}
+
+.sf-cell-status {
+  font-size: 10px;
+  padding: 1px 6px;
+  border-radius: 10px;
+  white-space: nowrap;
+}
+
+.sf-cell-status.is-empty {
+  background: #ecfdf5;
+  color: #059669;
+}
+
+.sf-cell-status.is-occupied {
+  background: #fef3c7;
+  color: #b45309;
+}
+
+.sf-cell-body {
+  flex: 1;
+  margin-top: 6px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.sf-cell-reserved {
+  font-size: 11px;
+  color: #dcdfe6;
+}
+
+.sf-batch-preview {
+  background: #ecfdf5;
+  border-radius: 6px;
+  padding: 10px 14px;
+  font-size: 13px;
+  color: #059669;
+  margin-top: 8px;
+}
+</style>
+```
+
+- [ ] **Step 2: 验证 lint 通过**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && npx eslint src/views/operations/storage-facility/index.vue --no-error-on-unmatched-pattern 2>&1 | tail -10`
+Expected: 无错误输出
+
+- [ ] **Step 3: 验证 dev server 正常**
+
+Run: `cd /Users/wuzilong/work/00code/zkxw/web-admin && npx vite build --mode development 2>&1 | tail -5`
+Expected: 构建成功，无编译错误
+
+---
+
+## Self-Review
+
+**Spec coverage:**
+- ✅ 左侧 el-tree 树形列表（自由层级）
+- ✅ 右侧货架行布局格子展示（最末层叶子节点）
+- ✅ 编号+状态在格子顶部一行
+- ✅ 下方预留空间
+- ✅ 批量生成格子（指定行列数）
+- ✅ 格子点击编辑（dialog）
+- ✅ 节点 CRUD（弹窗）
+- ✅ 节点删除级联删除子节点和格子
+
+**Placeholder scan:** 无 TBD/TODO/待定内容。所有代码完整。
+
+**Type consistency:** 所有函数签名、变量名前后一致。`fetchBatchCreateSlots` 在 admin.ts 定义并在 index.vue 中使用。
diff --git a/docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md b/docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md
index 155052ef..c6458ec3 100644
--- a/docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md
+++ b/docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md
@@ -1,6 +1,6 @@
 # 细胞存储管理（2.2.6～2.2.10）— 实现设计（方案 C）
 
-**依据**：`docs/中科兴皖需求V0.3.md` 菜单 2.2.6～2.2.10；数据模型 `docs/sql/zkxw-requirements-v0.3-schema.sql`（`biz_collection_protocol` 及其子表）。
+**依据**：`docs/中科兴皖需求V0.3.md` 菜单 2.2.6～2.2.10；数据模型 `docs/sql/zkxw.sql`（`biz_collection_protocol` 及其子表）。
 
 **范围**：Web 管理端 `web-admin` + FastAPI `backend`；租户隔离与既有 `/web/admin` 响应风格保持一致。
 
@@ -76,7 +76,7 @@
 
 ### 3.3 列表默认排序
 
-- 无自定义排序时：`order_num ASC, create_time DESC`（与工程规范一致）；预警列表可按 `installment_due_date ASC` 等业务需求单独约定。
+- 无自定义排序时：`create_time DESC`（与工程规范一致）；预警列表可按 `installment_due_date ASC` 等业务需求单独约定。
 
 ---
 
diff --git a/docs/superpowers/specs/2026-05-13-workflow-module-design.md b/docs/superpowers/specs/2026-05-13-workflow-module-design.md
new file mode 100644
index 00000000..2bc8fff4
--- /dev/null
+++ b/docs/superpowers/specs/2026-05-13-workflow-module-design.md
@@ -0,0 +1,351 @@
+# 工作流模块设计文档
+
+**模块**: 2.1.11 流程管理  
+**日期**: 2026-05-13  
+**状态**: 待审核  
+**决策记录**:
+- 流程设计器: AntV X6（蚂蚁图编辑引擎）
+- V1范围: 全量实现（配置管理+设计器+待办中心+已办中心+后端引擎）
+- 业务集成: API调用+回调模式
+- 引擎架构: 图遍历引擎（方案A）
+
+---
+
+## 1. 整体架构与模块划分
+
+### 1.1 后端（`backend/app/`）
+
+```
+models/models.py          ← 新增6个wf_* SQLAlchemy模型
+schemas/workflow.py       ← Pydantic schemas（请求/响应模型）
+crud/workflow.py          ← 数据库CRUD操作
+services/
+  workflow_engine.py      ← 核心引擎：节点分发、条件评估、审批人解析
+  workflow_callback.py    ← 回调服务：通知业务模块状态变更
+api/workflow.py           ← API路由（注册到admin前缀）
+```
+
+### 1.2 前端（`web-admin/src/`）
+
+```
+api/workflow.ts                    ← API调用
+types/api.d.ts                     ← 新增Workflow相关TS类型
+views/system/workflow/
+  process/index.vue                ← 流程配置管理（列表+设计器弹窗）
+  designer/
+    FlowDesigner.vue               ← AntV X6流程设计器组件
+    nodes/                         ← 自定义节点组件（Start/End/Approval/Condition）
+    config/                        ← 节点属性配置面板
+  task-pending/index.vue           ← 待办中心
+  task-completed/index.vue         ← 已办中心
+  components/
+    ApprovalDialog.vue             ← 审批操作弹窗（通过/驳回+意见）
+    ProcessStatusTag.vue           ← 流程状态标签
+router/modules/sqxp.ts            ← 新增3个路由
+```
+
+### 1.3 核心数据流
+
+1. 管理员在流程配置页 → AntV X6设计器画流程 → 保存 `graph_json` + 同步写 `wf_node`/`wf_transition`
+2. 业务模块调用 `POST /api/admin/workflow/instances` 发起流程 → 引擎锁定当前版本 → 创建 start 任务
+3. 引擎按 `wf_transition` 遍历节点 → 审批节点创建 `wf_task` → 待办人收到待办
+4. 待办人审批 → 引擎判断 any/all 策略 → 推进到下一节点 → 到达 end 节点 → 回调业务模块
+
+---
+
+## 2. 数据库模型
+
+已有 6 张表 DDL 见全库导出 `docs/sql/zkxw.sql`（搜索 `wf_process_def` 等表名）；基线表结构以当前导出为准。
+
+| 表名 | 用途 | 关键字段 |
+|------|------|----------|
+| `wf_process_def` | 流程定义 | process_code, process_name, status |
+| `wf_process_version` | 流程版本 | process_def_id, version_no, graph_json, is_latest |
+| `wf_node` | 流程节点 | process_version_id, node_key, node_type, config_json |
+| `wf_transition` | 流程连线 | process_version_id, from_node_key, to_node_key, condition_expr |
+| `wf_process_instance` | 流程实例 | process_version_id, business_type, business_id, variables_json, status |
+| `wf_task` | 流程任务 | instance_id, node_key, assignee_user_id, status, comment_text |
+
+**node_type 枚举值**: `start`, `end`, `approval`, `condition`  
+**instance.status 枚举值**: `running`, `completed`, `rejected`, `cancelled`  
+**task.status 枚举值**: `pending`, `approved`, `rejected`, `withdrawn`
+
+所有表均遵循公共字段规范：id(VARCHAR 64 UUID) → 业务字段 → tenant_no → order_num → remark → create_by → create_dept_id → create_time → update_by → update_time → del_flag
+
+### 2.1 Schema 变更（需新增字段）
+
+`wf_process_instance` 需新增 `callback_url` 字段（VARCHAR 512, 可空），用于业务回调地址。DDL 变更将在实施阶段维护到 `docs/sql/`（全量基线为 `docs/sql/zkxw.sql`，或附加增量脚本）。
+
+### 2.2 双存储语义
+
+工作流存在两套数据，各有用途：
+- **`graph_json`**（wf_process_version）: 前端设计器画布快照，用于设计器加载/编辑/渲染。仅供前端使用，后端引擎不解析此字段。
+- **`wf_node` + `wf_transition`**（关系表）: 后端引擎运行时使用的规范化数据。引擎只读这些表来执行节点分发和条件评估。
+- 两者在"发布版本"时同步写入，保持一致。
+
+---
+
+## 3. 工作流引擎核心设计
+
+### 3.1 节点分发器模式
+
+每种节点类型对应一个 handler，引擎根据 node_type 调度：
+
+```
+WorkflowEngine
+  ├── StartNodeHandler      → 自动推进到下一个节点
+  ├── EndNodeHandler        → 标记实例完成，触发回调
+  ├── ApprovalNodeHandler   → 解析审批人，创建wf_task记录
+  └── ConditionNodeHandler  → 评估条件表达式，选择分支
+```
+
+引擎入口方法：`advance(instance_id, from_node_key)` — 从指定节点开始，执行当前节点逻辑，然后沿出边推进到下一个节点。
+
+### 3.2 条件表达式格式
+
+`wf_transition.condition_expr` 字段存储的是 JSON 规则格式（VARCHAR 512），不是任意文本表达式。安全可控，不支持任意代码执行：
+
+```json
+{
+  "rules": [
+    {"field": "amount", "op": "<=", "value": 100},
+    {"field": "amount", "op": ">", "value": 100, "and": [{"field": "amount", "op": "<", "value": 300}]},
+    {"field": "amount", "op": ">=", "value": 300}
+  ]
+}
+```
+
+**支持的操作符**: `==`, `!=`, `>`, `<`, `>=`, `<=`, `in`, `not_in`, `contains`
+
+**字段取值**: 从 `wf_process_instance.variables_json` 中读取。支持嵌套路径用 `.` 分隔（如 `applicant.dept_id`）。
+
+**条件评估逻辑**: ConditionNodeHandler 遍历所有出边（wf_transition），依次评估每条边的 condition_expr。第一条匹配的边即为执行路径。最后一条边可省略条件作为"其他情况"默认分支。
+
+### 3.3 审批人解析
+
+`config_json` 中的 `approver` 字段定义解析策略：
+
+```json
+{
+  "strategy": "users",
+  "pass_type": "any",
+  "user_ids": ["uuid1", "uuid2"]
+}
+```
+
+**strategy 枚举**:
+
+| 策略 | 配置字段 | 说明 |
+|------|----------|------|
+| `users` | `user_ids: string[]` | 指定具体用户 |
+| `roles` | `role_ids: string[]` | 指定角色，运行时解析角色下的所有用户 |
+| `sql` | `sql: string` | SQL查询，返回user_id列表 |
+
+**pass_type 枚举**:
+- `any` — 任一审批人通过即推进
+- `all` — 所有审批人都必须通过才推进
+
+**SQL策略安全约束**:
+- 只允许 SELECT 语句
+- 禁止包含 INSERT/UPDATE/DELETE/DROP/ALTER
+- 只取结果第一列作为 user_id
+- 流程变量作为参数注入（`:var_name` 占位符）
+- 查询结果受 tenant_no 隐式过滤
+
+### 3.4 版本锁定
+
+- 发起流程时，`wf_process_instance.process_version_id` 锁定当前 `is_latest=1` 的版本
+- 发布新版本时：将旧版本的 `is_latest` 置为 0，创建新版本记录 `is_latest=1`
+- 已发起的实例始终使用锁定的版本运行，不受后续版本变更影响
+
+### 3.5 实例状态流转
+
+```
+发起 → running → completed（到达end节点）
+                → rejected（审批驳回，无其他分支时）
+                → cancelled（业务主动取消）
+```
+
+### 3.6 任务状态流转
+
+```
+创建 → pending → approved（审批通过）
+               → rejected（审批驳回）
+               → withdrawn（发起人撤回）
+```
+
+---
+
+## 4. API路由设计
+
+共13个路由，全部走 `/api/admin/workflow/` 前缀，带JWT认证和租户隔离。
+
+### 4.1 流程定义管理
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `/api/admin/workflow/defs` | GET | 流程定义列表（分页+搜索，支持按名称/编码/状态筛选） |
+| `/api/admin/workflow/defs` | POST | 新建流程定义 |
+| `/api/admin/workflow/defs/{id}` | PUT | 更新流程定义基本信息 |
+| `/api/admin/workflow/defs/{id}` | DELETE | 软删除流程定义（del_flag=1） |
+| `/api/admin/workflow/defs/{id}/publish` | POST | 发布新版本（接收graph_json+nodes+transitions，创建新版本） |
+| `/api/admin/workflow/defs/{id}/versions` | GET | 版本历史列表 |
+
+### 4.2 流程实例
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `/api/admin/workflow/instances` | POST | 发起流程（业务模块调用，传入process_code+business_type+business_id+variables） |
+| `/api/admin/workflow/instances/{id}` | GET | 流程实例详情（含任务列表和流程图高亮当前节点） |
+
+### 4.3 任务办理
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `/api/admin/workflow/tasks/pending` | GET | 我的待办列表（按assignee_user_id=当前用户+status=pending过滤） |
+| `/api/admin/workflow/tasks/completed` | GET | 我的已办列表（按assignee_user_id=当前用户+status in [approved,rejected]过滤） |
+| `/api/admin/workflow/tasks/{id}/approve` | POST | 审批通过（传comment_text） |
+| `/api/admin/workflow/tasks/{id}/reject` | POST | 审批驳回（传comment_text） |
+
+### 4.4 请求/响应格式
+
+**发起流程请求**:
+```json
+POST /api/admin/workflow/instances
+{
+  "process_code": "agreement_payment",
+  "business_type": "agreement",
+  "business_id": "agr_uuid_123",
+  "variables": {
+    "amount": 5000,
+    "dept_id": "dept_001",
+    "applicant_id": "user_001"
+  },
+  "callback_url": "/api/admin/agreements/workflow-callback"
+}
+```
+
+**审批操作请求**:
+```json
+POST /api/admin/workflow/tasks/{id}/approve
+{
+  "comment_text": "同意，费用已核实"
+}
+```
+
+---
+
+## 5. 前端页面设计
+
+### 5.1 流程配置管理（`process/index.vue`）
+
+**模式**: 标准列表页（参考 `unit/index.vue` 模板）
+
+**列表字段**: 流程编码、流程名称、状态(启用/停用)、最新版本号、创建时间、操作
+
+**操作按钮**: 新增、编辑、**流程设计**（打开X6设计器弹窗）、发布新版本、停用/启用、删除
+
+**设计器入口**: 点击"流程设计"→ 全屏弹窗打开 AntV X6 设计器
+
+### 5.2 AntV X6 流程设计器（`designer/FlowDesigner.vue`）
+
+**三栏布局**:
+- **左侧**: 节点组件面板（开始/结束/审批人/条件分支），拖拽到画布
+- **中间**: 画布区域（AntV X6 Graph），支持节点拖拽、连线、删除、缩放
+- **右侧**: 属性配置面板（选中节点后展示，根据节点类型动态切换）
+  - 审批人节点: 策略选择(用户/角色/SQL)、具体配置、通过策略(any/all)
+  - 条件分支节点: 每条出边的条件规则编辑
+  - 开始/结束节点: 只显示名称编辑
+
+**顶部工具栏**: 保存草稿、发布新版本、撤销/重做、放大/缩小/适应画布
+
+**保存逻辑**: 保存时序列化为 `{graph_json, nodes: [{node_key, node_type, config_json, ...}], transitions: [{from_node_key, to_node_key, condition_expr, ...}]}` 提交到后端
+
+**自定义节点样式**: 每种节点类型使用不同的形状和颜色
+- 开始节点: 圆形，绿色
+- 结束节点: 圆形，红色
+- 审批人节点: 矩形，蓝色
+- 条件分支节点: 菱形，橙色
+
+### 5.3 待办中心（`task-pending/index.vue`）
+
+**模式**: 复杂列表页（参考 `order/index.vue`）
+
+**筛选**: 流程名称、业务类型、发起时间范围
+
+**列表字段**: 流程名称、业务类型、业务单号、发起人、发起时间、到达时间、操作
+
+**操作**: 审批（打开审批弹窗）、查看详情
+
+**审批弹窗**（`ApprovalDialog.vue`）: 通过/驳回选择 + 审批意见输入框 + 查看流程图（只读模式，高亮当前节点）
+
+### 5.4 已办中心（`task-completed/index.vue`）
+
+**模式**: 标准列表页
+
+**筛选**: 同待办中心 + 审批结果筛选(通过/驳回)
+
+**列表字段**: 流程名称、业务类型、业务单号、发起人、审批结果、审批意见、审批时间
+
+**操作**: 查看详情
+
+---
+
+## 6. 回调与业务集成
+
+### 6.1 回调机制
+
+引擎在以下事件触发 HTTP POST 回调到 `callback_url`：
+
+**实例完成**:
+```json
+{
+  "event": "completed",
+  "instance_id": "inst_uuid",
+  "process_code": "agreement_payment",
+  "business_type": "agreement",
+  "business_id": "agr_uuid_123"
+}
+```
+
+**实例驳回**:
+```json
+{
+  "event": "rejected",
+  "instance_id": "inst_uuid",
+  "process_code": "agreement_payment",
+  "business_type": "agreement",
+  "business_id": "agr_uuid_123",
+  "reject_comment": "费用异常，请核实"
+}
+```
+
+### 6.2 业务模块集成步骤
+
+1. 在流程配置页创建流程定义，发布版本
+2. 业务模块在需要触发审批的地方调用 `POST /api/admin/workflow/instances`
+3. 业务模块实现回调接口接收审批结果
+4. 用户在待办中心处理审批任务
+
+---
+
+## 7. 安全与权限
+
+- 所有API带JWT认证，租户隔离（tenant_no过滤）
+- SQL审批人解析策略限制为只读SELECT，禁止DDL/DML
+- 流程定义管理需要系统管理权限
+- 待办/已办中心只展示当前用户的任务
+- 审批操作只能操作 status=pending 且 assignee_user_id=当前用户 的任务
+
+---
+
+## 8. 已确认的约束
+
+- 遵循项目公共字段规范（id→业务→tenant_no→...→del_flag）
+- 软删除（del_flag 0/1）
+- 默认排序（create_time DESC）
+- Element Plus组件自动导入，不手动导入
+- Fresh Mint主题色 #10b981
+- label-position="top"，.form-grid-2 布局
+- 操作列固定右侧（2按钮260px，3按钮320px）
+- 标题绿色竖条（需注册到App.vue白名单）
diff --git a/docs/superpowers/specs/2026-05-15-operations-support-design.md b/docs/superpowers/specs/2026-05-15-operations-support-design.md
new file mode 100644
index 00000000..9278721e
--- /dev/null
+++ b/docs/superpowers/specs/2026-05-15-operations-support-design.md
@@ -0,0 +1,48 @@
+# 运营支撑模块设计规格
+
+## 概述
+实现需求文档 2.4 节中运营支撑下的三个子模块：洁净室管理、库位管理、展馆预约。
+新增一级菜单【运营支撑】，下设三个二级菜单。
+
+## SQL 表（已存在，无需新建）
+1. `biz_clean_room` - 洁净室信息（编号、名称、等级A/B/C/D、状态正常/异常、面积）
+2. `biz_clean_room_access_log` - 洁净室人员进出（人员、部门、进入时间、目的、离开时间、体温）
+3. `biz_storage_facility` - 细胞存储设施树节点（树形结构：parent_id, node_name, node_type, is_leaf）
+4. `biz_storage_facility_slot` - 存储位置格子（叶子节点下的小方格）
+5. `biz_exhibition_appointment` - 展馆预约（预约编号、来访单位、联系人、到访日期、人数、接待人员）
+
+## 模块设计
+
+### 模块 1: 洁净室管理
+- **类型**: 标准列表 + 子表模式
+- **后端**: Model + CRUD (`clean_room.py`) + API 路由
+- **前端**: 参照 `system/unit/index.vue`，增加"人员进出"按钮弹窗查看进出记录
+- **路由**: `/operations/clean-room`
+- **API**: `/web/admin/clean-rooms` + `/web/admin/clean-room-access-logs`
+
+### 模块 2: 库位管理
+- **类型**: 树形结构模式
+- **后端**: Model + CRUD (`storage_facility.py`) + API 路由（树查询 + 节点 CRUD + 格子 CRUD）
+- **前端**: 参照 `system/category/index.vue`，左侧树形结构，右侧节点详情+格子列表
+- **路由**: `/operations/storage-facility`
+- **API**: `/web/admin/storage-facilities` + `/web/admin/storage-facility-slots`
+- **工具**: 使用 `tree-path.ts` 构建完整路径
+
+### 模块 3: 展馆预约
+- **类型**: 标准列表模式
+- **后端**: Model + CRUD (`exhibition_appointment.py`) + API 路由
+- **前端**: 参照 `system/unit/index.vue` 标准列表
+- **路由**: `/operations/exhibition-appointment`
+- **API**: `/web/admin/exhibition-appointments`
+
+## 技术规范
+- 后端模式：flat 函数式 CRUD（参照 `app/crud/item_unit.py`），不用 service 层
+- 前端模式：API 函数加入 `admin.ts`，路由加入 `sqxp.ts`
+- 所有查询带 `tenant_no` 过滤，删除为软删除
+- Fresh Mint 配色 (`--primary #10b981`)
+- 树形模块使用 `tree-path.ts` 工具
+
+## 实施顺序
+1. 后端：Models → CRUD → API 路由 → 注册
+2. 前端：API 函数 → 路由 → 页面组件
+3. 测试：API 验证 + 页面功能验证
diff --git a/docs/中科兴皖需求V0.3.md b/docs/中科兴皖需求V0.3.md
index f10eb0f1..9722f394 100644
--- a/docs/中科兴皖需求V0.3.md
+++ b/docs/中科兴皖需求V0.3.md
@@ -67,11 +67,15 @@
   - 展馆预约[2.4.3、展馆预约]
   - 物料管理（暂时不开发，后续在完善）
 - 财务管理（暂时不开发，后续在完善）
-- 生产管理（暂时不开发，后续在完善）
-  - 耗材管理
-  - 耗材包管理
-  - 工艺库管理
-  - 工艺路线配置
+- 生产管理
+  - 耗材管理[2.5.1、耗材管理]
+  - 耗材包管理[2.5.2、耗材包管理]
+  - 试剂管理[2.5.3、试剂管理]
+  - SOP文档[2.5.4、SOP文档]
+  - 工艺工序分类[2.5.5、工艺工序分类]
+  - 工艺产出物类型[2.3.6、工艺产出物类型]
+  - 工艺库管理[2.3.7、工艺库管理]
+  - 工艺路线配置[2.3.8、工艺路线配置]
   - 细胞存储协议单
   - 中试服务单
   - 生产工单
@@ -84,6 +88,49 @@
   - 采集协议号管理[2.2.4、采集协议号管理]
   - 样本编码管理[2.2.5、样本编码管理]
 
+
+## 2.5、生产管理
+### 2.5.1、耗材管理
+- 此模块用于生产耗材管理，支持耗材的新增、修改、删除等功能
+- 生产耗材表核心字段：耗材编码、耗材名称、规格型号、标准用量、描述
+
+### 2.5.2、耗材包管理
+- 此模块将生产耗材组合成一个耗材包，方便日常数据录入
+- 耗材包主表：编号、名称、使用场景、类型（bzhcb - 标准耗材包、 zdyhcb - 自定义耗材包），状态 （1 - 启用 、 0 - 停用）、备注
+- 耗材包耗材明细表：耗材包id、耗材编码、耗材名称、耗材规格型号、标准用量、备注
+
+### 2.5.3、试剂管理
+- 此模块用于生产试剂信息的管理
+- 试剂信息表的核心字段：试剂编码、试剂名称、规格、标准用量、单位[下拉数据从 2.1.9、物品单位管理 获取]、描述
+
+### 2.5.4、SOP文档
+- 此模块用于管理SOP文档管理
+- SOP文档表核心字段：SOP编号、SOP文档名称、版本号、SOP文档附件
+
+### 2.5.5、工艺工序分类
+- 此模块用于工艺工序分类管理
+- 工艺工序分类表核心字段：分类编码、分类名称
+
+### 2.3.6、工艺产出物类型
+- 此模块用于工艺产出物类型管理
+- 工艺产出物类型表核心字段：类型编码、类型名称
+
+### 2.3.7、工艺库管理
+- 此模块用于定义细胞生产过程中的每个工艺的信息，包括预计使用的试剂、预计使用的耗材、预计产出物等关联信息。工艺信息理解就是一个预设的情况，等后续真正生产时候，有这些预制的值可以起到指导作用，同时也方便用户录入信息
+- 生产工艺主表 核心字段：工序代码、工序分类[下拉数据来自于 2.5.5、工艺工序分类]、工序名称、描述、预计使用设备名称、预估耗时、关联的SOP文[从 2.5.4、SOP文档 关联选择， 支持多个附件]
+  - 生产工艺试剂关联表 核心字段： 试剂编码、试剂名称、规格、标准用量、单位、是否关键物料 。 （通过关联2.5.3、试剂管理 下拉后，将试剂编码、试剂名称、规格、标准用量、单位都带过来，但是用户可以自己改 标准用量）
+  - 生产工艺耗材关联表：核心字段：耗材编码、耗材名称、耗材规格型号、标准用量、是否必需（1 - 必须 ， 0 - 可选）、备注， 可以通过从2.5.2、耗材包管理 关联一次性将耗材批量带过来，然后修改。 也可以从2.5.1、耗材管理 待过来
+  - 生产工艺产出关联表：核心字段：产出类型（下拉数据来源于 2.3.6、工艺产出物类型）、产出物名称、产出物条码。 产出物条码只有在真实生产时候才会有数据
+
+### 2.3.8、工艺路线配置
+- 此模块用于将多个生产工艺组织成一个工艺路线图，方便实验室人员在进行细胞生产过程中，快速勾选一个工艺路线图，调整后就可以将生产过程记录下来了
+- 工艺路线图主表 核心字段：路线编码、产品类型（下拉数据来自于 2.3.1、细胞产品类型管理）、路线名称、备注
+  - 工艺路线图工艺明细表：工序代码、工序分类[下拉数据来自于 2.5.5、工艺工序分类]、工序名称、描述、预计使用设备名称、预估耗时、关联的SOP文[从 2.5.4、SOP文档 关联选择， 支持多个附件]、排序号
+    - 工艺路线图工艺明细表试剂关联表 核心字段： 试剂编码、试剂名称、规格、标准用量、单位、是否关键物料 。 （通过关联2.5.3、试剂管理 下拉后，将试剂编码、试剂名称、规格、标准用量、单位都带过来，但是用户可以自己改 标准用量）
+    - 工艺路线图工艺明细表耗材关联表：核心字段：耗材编码、耗材名称、耗材规格型号、标准用量、是否必需（1 - 必须 ， 0 - 可选）、备注， 可以通过从2.5.2、耗材包管理 关联一次性将耗材批量带过来，然后修改。 也可以从2.5.1、耗材管理 待过来
+    - 工艺路线图工艺明细表产出关联表：核心字段：产出类型（下拉数据来源于 2.3.6、工艺产出物类型）、产出物名称、产出物条码。 产出物条码只有在真实生产时候才会有数据
+- 工艺路线配置这个界面，是可以做成拖拉配置的。界面分三部分、左边是内置的生产工艺的卡片、中间是生产工艺排版的界面，右侧是每个工艺对应的内容（工艺信息、试剂关联信息、耗材关联信息、产出物信息等）
+
 ## 2.4、运营支撑
 ### 2.4.1、洁净室管理
 - 此模块用于洁净室信息录入 和 人员出入数据录入就行了
diff --git a/login-success.png b/login-success.png
new file mode 100644
index 00000000..5a069088
Binary files /dev/null and b/login-success.png differ
diff --git a/openspec/changes/basic-info-management/.openspec.yaml b/openspec/changes/basic-info-management/.openspec.yaml
new file mode 100644
index 00000000..93831bd2
--- /dev/null
+++ b/openspec/changes/basic-info-management/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-13
diff --git a/openspec/changes/basic-info-management/design.md b/openspec/changes/basic-info-management/design.md
new file mode 100644
index 00000000..c5d7823d
--- /dev/null
+++ b/openspec/changes/basic-info-management/design.md
@@ -0,0 +1,77 @@
+## Context
+
+`docs/sql/zkxw.sql`（全库导出基线）已包含 `biz_customer`、`biz_cell_sample_type`、`biz_collection_region`、`biz_collection_hospital`、`biz_collection_protocol_no`、`biz_sample_code` 等表；需求文档 `docs/中科兴皖需求V0.3.md` 2.2.1～2.2.5 描述了字段与交互。后端 `app/models` 与路由中尚未覆盖上述业务主数据的完整 CRUD；Web 管理端缺少对应页面。
+
+**与需求文档的差异（以 DDL 为准）**：2.2.3 文案提到「医院名称逗号分隔」；当前 schema 为地区表 + 医院子表 1:N，实现 SHALL 以子表为准，弹窗内维护医院行，避免双写。
+
+**现有代码模式参考：**
+
+- 后端：`openspec/changes/dict-management` 与 `crud/tenant.py` 类独立函数、`api/admin.py` 路由风格；租户 `tenant_no`、软删 `del_flag`、列表默认排序 `create_time DESC`（见 engineering-standards）。
+- 前端：标准列表 `views/system/unit/index.vue`；复杂子表弹窗可参考字典「字典数据配置」或订单模块弹窗；API 封装于 `src/api/*.ts`。
+
+## Goals / Non-Goals
+
+**Goals:**
+
+- 五类主数据在租户范围内的分页列表、详情（可选）、创建、更新、软删除。
+- 客户身份证去重（同租户、非空身份证、未删除记录唯一）；样本类型编码、协议号、样本编码在租户内唯一。
+- 地区与医院：主列表为地区；「地区医院配置」弹窗内对 `biz_collection_hospital` 增删改查（按 `region_id`）。
+- Web UI 符合 `docs/web-admin-ui-spec-fresh-mint.md` 与 `.cursor/rules/web-admin-crud-dialog.mdc`。
+- 菜单与权限 SQL 或初始化说明写入 `docs/sql/`（与仓库惯例一致）。
+
+**Non-Goals:**
+
+- `biz_customer_follow` 客户随访（2.2.1 未在本次菜单范围单独展开时可列为后续）。
+- 小程序端维护上述主数据。
+- 协议号/样本编码的「下发」与下游业务流程联动（仅维护 `issued` 字段与展示）。
+- 批量导入导出、复杂审批流。
+
+## Decisions
+
+### D1: 后端路由组织
+
+**选择**：新增独立路由模块（例如 `app/api/basic_info.py` 或按域拆分为 `customer.py` + 聚合少量路由的文件），在 `app/api/__init__.py` 与 `app/main.py` 注册；路径前缀与现有 `/api` + admin 子前缀保持一致（如 `/web/admin/...` 或与 `dict` 同级命名空间）。
+
+**理由**：五组资源边界清晰，避免单个 `admin.py` 过度膨胀；仍属同一业务域「基础信息」。
+
+**替代方案**：全部写入 `admin.py` → 可行但不利于评审与合并冲突控制。
+
+### D2: SQLAlchemy 模型与 CRUD
+
+**选择**：在 `app/models/models.py`（或按项目惯例的拆分文件）增加与 DDL 一致的 ORM 模型；`app/crud/` 下每域独立模块或 `basic_info` 包内多文件，函数命名 `list_*`、`get_*`、`create_*`、`update_*`、`soft_delete_*`。
+
+**理由**：与现有 tenant、dict 等模式一致，满足 database-conventions 公共字段与软删查询约定。
+
+### D3: 客户身份证唯一校验
+
+**选择**：创建与更新时若 `id_card_no` 非空，则查询同租户下是否存在其他未删除记录占用相同证件号；存在则返回 4xx 与明确业务文案（与需求「不要重复创建…提醒」一致）。
+
+**理由**：表上已有 `idx_customer_idcard`；应用层给出可读错误信息。
+
+### D4: 前端信息架构
+
+**选择**：五个菜单入口（或二级菜单「基础信息」下五项），每页一个标准列表 + 表单弹窗；地区页主表 + 「地区医院配置」子弹窗（内嵌表格 + 分页）。
+
+**理由**：与需求操作描述及工程 UI 模板一致。
+
+### D5: 初始化数据（样本类型）
+
+**选择**：可选 SQL 种子插入三种需求既定编码（wcqzxgxb、qdjczgxb、tpyqngxb），若环境已手动录入则脚本需幂等（`INSERT IGNORE` 或先判存）。
+
+**理由**：需求 2.2.2 明确当前三种类型。
+
+## Risks / Trade-offs
+
+- **[需求与 DDL 不一致]**：2.2.3 逗号分隔 vs 子表 → **缓解**：以 DDL 为准，在 proposal/design 中写明，避免实现回退到反范式存储。
+- **[唯一索引与软删]**：`uk_sample_type` 等包含 `del_flag` → 删除后再建同编码可能冲突 → **缓解**：软删后「复活」走更新 `del_flag=0` 或换编码；接口文档说明。
+- **[权限与菜单遗漏]** → **缓解**：tasks 中单列菜单 SQL 与路由权限码登记。
+
+## Migration Plan
+
+- 无破坏性 schema 变更前提：部署顺序为 DB 已执行 V0.3 DDL → 后端 → 前端；回滚为下线路由与菜单，不物理删数据。
+- 若某环境缺表：以 `docs/sql/zkxw.sql` 为基线导入/对齐，或从其中摘取对应 `CREATE TABLE` 段落执行。
+
+## Open Questions
+
+- Web 菜单父级挂载在「Demo」下还是正式「业务/基础信息」根节点：建议与产品确认后写入 `docs/sql` 初始化脚本。
+- `biz_customer_follow` 是否与本迭代一并提供只读/编辑入口：默认本变更 Non-Goal，若需可追加 capability。
diff --git a/openspec/changes/basic-info-management/proposal.md b/openspec/changes/basic-info-management/proposal.md
new file mode 100644
index 00000000..03d0a555
--- /dev/null
+++ b/openspec/changes/basic-info-management/proposal.md
@@ -0,0 +1,34 @@
+## Why
+
+中科兴皖 V0.3「基础信息管理」下 2.2.1～2.2.5 为后续采集协议单、样本等业务的主数据入口；当前仓库仅有 SQL 模型定义，缺少租户内一致的 REST API 与 Web 管理端 CRUD，无法支撑业务录入与引用。
+
+## What Changes
+
+- 在 `backend` 为五类主数据提供租户隔离的列表/详情/新增/修改/软删接口，字段与校验对齐 `docs/sql/zkxw.sql` 与 `docs/中科兴皖需求V0.3.md` 2.2.1～2.2.5。
+- 在 `web-admin` 增加五个列表+弹窗表单页（或等价结构），遵循 Fresh Mint 规范与既有 Demo 模板页（如 `unit`、`dict` 类页面）的布局与交互。
+- 客户：同一租户下身份证号非空且重复时拒绝创建并提示；姓名不强制唯一。
+- 细胞样本类型：`type_code` 租户内唯一（与表 `uk_sample_type` 一致）。
+- 采集地区与医院：地区 CRUD；医院为子表（`biz_collection_hospital`），通过「地区医院配置」弹窗维护，**不**采用需求文中「医院名称逗号分隔」的冗余存储（以当前 schema 1:N 为准）。
+- 采集协议号池、样本编码池：`protocol_no` / `sample_code` 租户内唯一；维护 `issued`（是否下发）。
+- 提供初始化菜单/SQL 片段（若项目惯例为 `docs/sql/`），便于挂到 Web 侧栏。
+
+## Capabilities
+
+### New Capabilities
+
+- `customer-management`：客户 `biz_customer` 的展示、增删改、身份证重复校验、标签逗号分隔编辑。
+- `cell-sample-type-management`：细胞样本类型 `biz_cell_sample_type` 的展示与增删改、编码唯一性。
+- `collection-region-hospital-management`：采集地区 `biz_collection_region` 与下属医院 `biz_collection_hospital` 的维护及子表弹窗配置。
+- `collection-protocol-no-management`：采集协议号池 `biz_collection_protocol_no` 的维护与下发标记。
+- `sample-code-management`：样本编码池 `biz_sample_code` 的维护与下发标记。
+
+### Modified Capabilities
+
+- （无）不修改 `openspec/changes/zkxw-engineering-standards` 中既有 SHALL 语义；本变更在其实现约束下新增业务能力。
+
+## Impact
+
+- **后端**：新增路由模块（建议 `app/api/` 下业务域路由）、对应 `schemas/`、`crud/`、`services/`（如需）；在 `app/api/__init__.py` 与 `app/main.py` 注册；SQLAlchemy 模型若尚未覆盖上述表则补充。
+- **前端**：`src/api/`、`src/router/`、`src/views/`（建议 `views/business/` 或按项目惯例）、菜单静态或后端菜单数据。
+- **数据库**：以现有 `docs/sql/zkxw.sql` 全库导出基线为准；本变更可附带种子数据（如三种预设样本类型）的 **可选** 增量 SQL（置于 `docs/sql/`）。
+- **权限**：菜单与按钮权限与现有 `sys_menu` / 角色授权模式对齐。
diff --git a/openspec/changes/basic-info-management/specs/cell-sample-type-management/spec.md b/openspec/changes/basic-info-management/specs/cell-sample-type-management/spec.md
new file mode 100644
index 00000000..59d9f53b
--- /dev/null
+++ b/openspec/changes/basic-info-management/specs/cell-sample-type-management/spec.md
@@ -0,0 +1,37 @@
+## ADDED Requirements
+
+### Requirement: 租户内样本类型列表与分页
+
+系统 SHALL 提供细胞样本类型分页查询接口，数据限定为当前租户且排除已软删记录，默认排序 SHALL 为 `create_time DESC`。
+
+#### Scenario: 查询列表
+
+- **WHEN** 请求样本类型列表
+- **THEN** 系统返回当前租户下 `biz_cell_sample_type` 未删除数据分页结果
+
+### Requirement: 样本类型编码租户内唯一
+
+系统 SHALL 在创建与更新时保证 `type_code` 在同一租户、未删除记录范围内唯一；违反时返回可展示错误。
+
+#### Scenario: 重复编码拒绝
+
+- **WHEN** 创建或更新样本类型使 `type_code` 与同租户另一未删除记录冲突
+- **THEN** 系统拒绝操作并返回业务错误
+
+### Requirement: 样本类型字段维护
+
+系统 SHALL 支持样本类型的创建、更新与软删除，业务字段 SHALL 包含样本类型编码、样本类型名称、样本存储年份、样本存储价格（元）、备注等，与 `biz_cell_sample_type` 一致。
+
+#### Scenario: 完整字段保存
+
+- **WHEN** 提交包含编码、名称、存储年份、存储价格的合法创建请求
+- **THEN** 系统持久化各字段并在详情/列表中可回显
+
+### Requirement: Web 管理端样本类型页
+
+Web 管理端 SHALL 提供样本类型列表与新增/编辑/删除（软删）交互，UI SHALL 符合 Web 管理端工程 UI 规范。
+
+#### Scenario: 用户编辑一条记录
+
+- **WHEN** 用户在列表选择编辑并修改名称后保存
+- **THEN** 系统调用更新接口且列表展示更新后名称
diff --git a/openspec/changes/basic-info-management/specs/collection-protocol-no-management/spec.md b/openspec/changes/basic-info-management/specs/collection-protocol-no-management/spec.md
new file mode 100644
index 00000000..7614d668
--- /dev/null
+++ b/openspec/changes/basic-info-management/specs/collection-protocol-no-management/spec.md
@@ -0,0 +1,37 @@
+## ADDED Requirements
+
+### Requirement: 采集协议号池列表与分页
+
+系统 SHALL 提供 `biz_collection_protocol_no` 的分页查询，租户隔离且排除已软删记录，默认排序 SHALL 为 `create_time DESC`。
+
+#### Scenario: 列表查询
+
+- **WHEN** 请求采集协议号池列表
+- **THEN** 返回当前租户未删除记录分页数据
+
+### Requirement: 协议号租户内唯一
+
+系统 SHALL 保证 `protocol_no` 在同一租户、未删除记录范围内唯一；冲突时拒绝写入并返回业务错误。
+
+#### Scenario: 重复协议号
+
+- **WHEN** 创建或更新导致与同租户另一未删除记录 `protocol_no` 相同
+- **THEN** 系统拒绝并返回错误
+
+### Requirement: 是否下发字段维护
+
+系统 SHALL 支持维护 `issued` 字段，取值为 0（否）或 1（是），与 DDL 注释一致。
+
+#### Scenario: 更新下发标记
+
+- **WHEN** 请求将某条记录 `issued` 从 0 改为 1
+- **THEN** 系统持久化后查询结果反映新值
+
+### Requirement: 协议号池 CRUD 与 Web 页
+
+系统 SHALL 支持协议号池行的创建、更新、软删除。Web 管理端 SHALL 提供列表与表单弹窗完成上述维护。
+
+#### Scenario: 用户在页面保存新协议号
+
+- **WHEN** 用户提交合法新协议号与下发标记
+- **THEN** 系统创建成功且列表可见新行
diff --git a/openspec/changes/basic-info-management/specs/collection-region-hospital-management/spec.md b/openspec/changes/basic-info-management/specs/collection-region-hospital-management/spec.md
new file mode 100644
index 00000000..d21f83c5
--- /dev/null
+++ b/openspec/changes/basic-info-management/specs/collection-region-hospital-management/spec.md
@@ -0,0 +1,33 @@
+## ADDED Requirements
+
+### Requirement: 采集地区 CRUD
+
+系统 SHALL 提供采集地区 `biz_collection_region` 的分页列表、创建、更新与软删除，数据 SHALL 按当前用户租户隔离。
+
+#### Scenario: 地区列表仅本租户
+
+- **WHEN** 请求采集地区列表
+- **THEN** 返回结果仅含当前租户未删除地区
+
+### Requirement: 地区下属医院子表维护
+
+系统 SHALL 提供按 `region_id` 查询、创建、更新、软删除 `biz_collection_hospital` 记录的接口。医院与地区关系 SHALL 为数据库 1:N（子表），SHALL NOT 将多医院合并为地区表上的逗号分隔字段存储。
+
+#### Scenario: 某地区下新增医院
+
+- **WHEN** 请求为指定 `region_id` 创建医院行且医院名称合法
+- **THEN** 系统持久化 `biz_collection_hospital` 且关联正确 `region_id`
+
+#### Scenario: 软删除地区时级联软删下属医院
+
+- **WHEN** 用户软删除某地区
+- **THEN** 系统在同一事务中将该地区 `del_flag` 置 1，并将其下属未删除医院记录全部 `del_flag` 置 1
+
+### Requirement: Web 地区与医院配置交互
+
+Web 管理端 SHALL 展示采集地区列表，并提供「地区医院配置」入口打开弹窗；弹窗内 SHALL 展示该地区下属医院表格并支持医院的分页列表、新增、编辑、软删除。
+
+#### Scenario: 打开配置弹窗并新增医院
+
+- **WHEN** 用户点击某行的「地区医院配置」并在弹窗内新增一条医院
+- **THEN** 弹窗列表出现新医院且主列表无需离开当前页即可再次打开验证
diff --git a/openspec/changes/basic-info-management/specs/customer-management/spec.md b/openspec/changes/basic-info-management/specs/customer-management/spec.md
new file mode 100644
index 00000000..055b9fc0
--- /dev/null
+++ b/openspec/changes/basic-info-management/specs/customer-management/spec.md
@@ -0,0 +1,47 @@
+## ADDED Requirements
+
+### Requirement: 租户内客户列表与分页
+
+系统 SHALL 提供已认证管理端用户可用的客户分页查询接口，数据范围限定为当前用户所属租户，且默认排除 `del_flag=1` 的记录。列表默认排序 SHALL 为 `create_time DESC`（若无自定义排序）。
+
+#### Scenario: 分页查询成功
+
+- **WHEN** 调用方请求客户列表且传入合法分页参数
+- **THEN** 系统返回当前租户下未删除客户的分页数据，且不包含其他租户客户
+
+### Requirement: 客户新增与身份证去重
+
+系统 SHALL 支持创建客户，字段包含客户姓名（必填）、性别、身份证号、年龄、联系电话、客户标签（逗号分隔）、备注等，与 `biz_customer` 一致。当 `id_card_no` 非空时，系统 SHALL 拒绝在同一租户下创建与已有未删除客户相同身份证号的新记录，并返回可展示的业务错误信息。
+
+#### Scenario: 同名不同人可共存
+
+- **WHEN** 请求创建客户 A 与客户 B，二者 `customer_name` 相同但 `id_card_no` 不同或其一为空
+- **THEN** 系统允许分别创建成功
+
+#### Scenario: 身份证重复拒绝创建
+
+- **WHEN** 请求创建客户且 `id_card_no` 与同一租户下已存在未删除客户相同
+- **THEN** 系统拒绝创建并返回明确提示（含义与需求「已创建」一致）
+
+### Requirement: 客户修改与删除
+
+系统 SHALL 支持按主键更新未删除客户的可编辑字段；更新时若修改 `id_card_no` 为非空，SHALL 执行与同租户未删除记录的去重校验（排除自身）。系统 SHALL 仅支持软删除（`del_flag=1`），SHALL NOT 物理删除业务数据。
+
+#### Scenario: 更新身份证冲突
+
+- **WHEN** 将某客户的 `id_card_no` 改为另一未删除客户已占用的号码
+- **THEN** 系统拒绝更新并返回业务错误
+
+#### Scenario: 软删除客户
+
+- **WHEN** 请求删除某客户主键
+- **THEN** 系统将对应行 `del_flag` 置为 1，列表默认查询不再返回该记录
+
+### Requirement: Web 管理端客户维护页
+
+Web 管理端 SHALL 提供客户列表页，包含筛选（至少支持姓名/电话/身份证关键字类检索，若后端实现）、工具栏、表格、分页；SHALL 提供新增与编辑弹窗表单（`label-position="top"`，布局符合 Fresh Mint 与项目 CRUD 弹窗规范）。
+
+#### Scenario: 用户在页面完成一次新增
+
+- **WHEN** 用户在客户页填写合法信息并提交保存
+- **THEN** 系统调用后端创建接口并在成功后刷新列表
diff --git a/openspec/changes/basic-info-management/specs/sample-code-management/spec.md b/openspec/changes/basic-info-management/specs/sample-code-management/spec.md
new file mode 100644
index 00000000..46563f76
--- /dev/null
+++ b/openspec/changes/basic-info-management/specs/sample-code-management/spec.md
@@ -0,0 +1,37 @@
+## ADDED Requirements
+
+### Requirement: 样本编码池列表与分页
+
+系统 SHALL 提供 `biz_sample_code` 的分页查询，租户隔离且排除已软删记录，默认排序 SHALL 为 `create_time DESC`。
+
+#### Scenario: 列表查询
+
+- **WHEN** 请求样本编码池列表
+- **THEN** 返回当前租户未删除记录分页数据
+
+### Requirement: 样本编码租户内唯一
+
+系统 SHALL 保证 `sample_code` 在同一租户、未删除记录范围内唯一；冲突时拒绝写入并返回业务错误。
+
+#### Scenario: 重复样本编码
+
+- **WHEN** 创建或更新导致与同租户另一未删除记录 `sample_code` 相同
+- **THEN** 系统拒绝并返回错误
+
+### Requirement: 是否下发字段维护
+
+系统 SHALL 支持维护 `issued` 字段，取值为 0（否）或 1（是）。
+
+#### Scenario: 更新下发标记
+
+- **WHEN** 请求将某条记录 `issued` 从 0 改为 1
+- **THEN** 系统持久化后查询结果反映新值
+
+### Requirement: 样本编码池 CRUD 与 Web 页
+
+系统 SHALL 支持样本编码池行的创建、更新、软删除。Web 管理端 SHALL 提供列表与表单弹窗完成上述维护。
+
+#### Scenario: 用户在页面保存新样本编码
+
+- **WHEN** 用户提交合法新样本编码与下发标记
+- **THEN** 系统创建成功且列表可见新行
diff --git a/openspec/changes/basic-info-management/tasks.md b/openspec/changes/basic-info-management/tasks.md
new file mode 100644
index 00000000..1e1cdf72
--- /dev/null
+++ b/openspec/changes/basic-info-management/tasks.md
@@ -0,0 +1,35 @@
+## 1. 数据模型与 CRUD 基础
+
+- [ ] 1.1 在 `backend/app/models` 中为 `biz_customer`、`biz_cell_sample_type`、`biz_collection_region`、`biz_collection_hospital`、`biz_collection_protocol_no`、`biz_sample_code` 增加 ORM 定义（字段顺序与公共字段对齐 `database-conventions`）
+- [ ] 1.2 新增 `backend/app/crud/` 模块（按 design 拆分文件或包），实现各实体的 list/get/create/update/soft_delete，查询统一 `tenant_no` + `del_flag=0`，列表默认 `create_time DESC`
+- [ ] 1.3 实现客户 `id_card_no` 非空时的租户内去重校验（创建与更新排除自身）
+
+## 2. Pydantic Schema 与路由
+
+- [ ] 2.1 在 `backend/app/schemas/` 为六类资源（含医院子资源）定义请求/响应模型
+- [ ] 2.2 新增 API 路由（建议 `app/api/basic_info.py` 或等价拆分），挂载客户、样本类型、地区、医院、协议号池、样本编码池端点；注册到 `app/api/__init__.py` 与 `app/main.py`
+- [ ] 2.3 为地区软删实现「同级联软删下属医院」事务逻辑（与 `collection-region-hospital-management` spec 一致）
+- [ ] 2.4 唯一约束冲突（`type_code`、`protocol_no`、`sample_code`、客户身份证）映射为可读 HTTP 4xx 与业务 message
+
+## 3. 菜单与 SQL
+
+- [ ] 3.1 在 `docs/sql/` 增加 Web 端菜单初始化脚本（五项菜单 + 合理 `order_num` / `parent_id`），权限标识与路由 path 对齐现有 `sys_menu` 惯例
+- [ ] 3.2 （可选）增加三种细胞样本类型初始数据的幂等 SQL，与需求 2.2.2 编码一致
+
+## 4. Web 管理端 — API 与路由
+
+- [ ] 4.1 在 `web-admin/src/api/` 增加封装上述端点的模块（如 `basicInfo.ts` 或分文件）
+- [ ] 4.2 在 `web-admin/src/router/` 注册五个页面路由（hash 路径与菜单 component 一致）
+
+## 5. Web 管理端 — 页面实现
+
+- [ ] 5.1 客户管理页：列表 + 筛选 + 新增/编辑弹窗（`label-position="top"`、`.dialog-form-layout`），对齐 `unit` 模板与 Fresh Mint
+- [ ] 5.2 细胞样本类型管理页：同上
+- [ ] 5.3 采集地区管理页：主表 +「地区医院配置」弹窗（内嵌医院表分页与 CRUD）
+- [ ] 5.4 采集协议号管理页：列表字段含协议号、`issued`、公共审计列
+- [ ] 5.5 样本编码管理页：同上
+
+## 6. 验证
+
+- [ ] 6.1 本地启动后端，用 Swagger 或脚本验证各列表/创建/更新/软删与异常路径（身份证重复、编码重复、级联软删）
+- [ ] 6.2 `pnpm build` 或 `pnpm build:typecheck` 通过；关键页面手测无控制台错误
diff --git a/openspec/changes/cell-storage-protocol-modules/.openspec.yaml b/openspec/changes/cell-storage-protocol-modules/.openspec.yaml
new file mode 100644
index 00000000..93831bd2
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-13
diff --git a/openspec/changes/cell-storage-protocol-modules/design.md b/openspec/changes/cell-storage-protocol-modules/design.md
new file mode 100644
index 00000000..d12144f8
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/design.md
@@ -0,0 +1,43 @@
+## Context
+
+参见 `docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md`。当前仓库已实现基础信息管理 CRUD，但 `biz_collection_protocol` 及相关缴费/审核表在后端尚无 Model/API。
+
+## Goals / Non-Goals
+
+**Goals:**
+
+- 最小闭环：协议单列表 + 概要详情；审核记录；财务两确认；分期预警。
+- 租户隔离、软删除、默认排序符合 `zkxw-engineering-standards`。
+- 审核不改变 `protocol_status`；审核支持多条历史（A1）。
+
+**Non-Goals:**
+
+- 不对 2.2.6 全部子表做一次性完整表单。
+- 不实现退费发起与非 `jfqrz`/`tfqrz` 入口的财务动作。
+- 不用工作流引擎替换表驱动逻辑。
+
+## Decisions
+
+| 决策 | 选择 | 理由 |
+|------|------|------|
+| 建模范围 | 仅 `biz_collection_protocol`、`biz_protocol_audit`、`biz_protocol_payment`、`biz_protocol_payment_detail` | 方案 C，对齐已确认边界 |
+| API 前缀 | 延续 `/web/admin`，新路由文件例如 `collection_protocol.py`，在 `api/__init__.py` 注册 | 与 `basic_info.py` 一致 |
+| 审核 | 仅插入 `biz_protocol_audit` | 用户选定方案 A |
+| 财务确认 | 列表过滤固定状态；POST 校验当前行状态后更新 | 防止误操作 |
+| 预警日期 | 服务器日期与 `installment_due_date`（YYYYMMDD）比较 | 简单可靠 |
+| 前端路由 | `/cell-storage/*` 五页 | 已定稿 |
+
+## Risks / Trade-offs
+
+- **详情信息不足** → 第一版标注「概要」，后续迭代补子表 Tab。
+- **无退费发起** → 退费确认页可能长期为空，依赖外部流程或后续变更。
+- **并发确认** → 依赖数据库行更新与状态校验；必要时可加重试提示。
+
+## Migration Plan
+
+- 无破坏性 schema 变更：部署顺序为后端 → 前端；可选执行菜单 SQL 补丁（若有）。
+- 回滚：下线路由与菜单项，禁用新 API 路由注册。
+
+## Open Questions
+
+- 协议单第一版是否允许「新建/编辑」：若需求未定，建议第一版只读列表 + 详情，创建单独后续变更。
diff --git a/openspec/changes/cell-storage-protocol-modules/proposal.md b/openspec/changes/cell-storage-protocol-modules/proposal.md
new file mode 100644
index 00000000..d08a1947
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/proposal.md
@@ -0,0 +1,32 @@
+## Why
+
+需求文档 `docs/中科兴皖需求V0.3.md` 中「细胞存储管理」下 2.2.6～2.2.10 尚未在 web-admin 与后端落地；业务依赖 `biz_collection_protocol` 及缴费/审核表。需要在租户隔离与既有 `/web/admin` 约定下交付列表、审核与财务确认、分期预警的最小可用闭环。
+
+## What Changes
+
+- 新增一级菜单 **细胞存储管理**及 5 个子路由页面（与 `sqxp.ts`、`backend/app/api/menu.py` 静态菜单对齐）。
+- 后端新增采集协议单查询、审核写入、缴费明细财务确认、分期预警查询等 API；补充对应表的 SQLAlchemy Model 与 CRUD（方案 C：最小表集）。
+- 前端新增 `views/cell-storage/**` 五个列表页（及必要弹窗），对接上述接口；样式对齐 Fresh Mint 与 CRUD 模板页。
+- **不包含**：退费发起、协议单子表（采集信息/样本等）全量录入 UI；工作流引擎驱动本组菜单。
+
+## Capabilities
+
+### New Capabilities
+
+- `cell-storage-collection-protocol`: 采集协议单列表与概要详情 API；Web 列表/详情（第一版以主表 + 缴费概要为主）。
+- `cell-storage-protocol-audit`: 协议附件类审核（写入 `biz_protocol_audit`，不修改协议单状态）；多条审核历史（A1）；审核列表与提交。
+- `cell-storage-receipt-confirm`: 财务收款确认列表（仅 `jfqrz`）与确认动作（`jfqrz`→`yjf`）。
+- `cell-storage-refund-confirm`: 财务退费确认列表（仅 `tfqrz`）与确认动作（`tfqrz`→`ytf`）；不包含退费发起。
+- `cell-storage-installment-warning`: 分期应缴预警列表（仅 `dfj`、有分期序号；15 天内预警；逾期为应缴日早于今日）。
+
+### Modified Capabilities
+
+- （无）本变更为新增业务能力，不修改已归档基线 spec 的既有 REQUIREMENTS 表述。
+
+## Impact
+
+- **后端**：`backend/app/models/models.py`、`app/crud/`、`app/api/`（新建 `collection_protocol.py` 或合并至既有 router）、`app/api/__init__.py`、`app/main.py`。
+- **前端**：`web-admin/src/router/modules/sqxp.ts`、`web-admin/src/api/*.ts`、`web-admin/src/views/cell-storage/**`。
+- **菜单**：`backend/app/api/menu.py`。
+- **数据库**：沿用既有 DDL，原则上不新增表；若需菜单种子则可选 `docs/sql/` 补丁脚本。
+- **权威交叉**：`docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md`。
diff --git a/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-collection-protocol/spec.md b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-collection-protocol/spec.md
new file mode 100644
index 00000000..2b55eb61
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-collection-protocol/spec.md
@@ -0,0 +1,33 @@
+## ADDED Requirements
+
+### Requirement: 租户内采集协议单分页列表
+
+系统 SHALL 向已认证管理端用户提供采集协议单分页查询接口，数据来源为 `biz_collection_protocol`。查询 SHALL 限定当前用户所属 `tenant_no`，且默认排除 `del_flag=1`。列表默认排序 SHALL 为 `create_time DESC`（若无自定义排序）。列表 SHALL 至少包含协议号展示字段、协议状态、创建时间等便于识别的列。
+
+#### Scenario: 仅返回本租户数据
+
+- **WHEN** 用户请求采集协议单分页列表且租户为 T
+- **THEN** 响应中每条记录的 `tenant_no` SHALL 为 T，且不包含已软删除行
+
+### Requirement: 采集协议单概要详情
+
+系统 SHALL 提供按主键查询单条采集协议单的接口，返回 `biz_collection_protocol` 业务字段及公共字段。系统 SHOULD 在同响应或次级结构中附带同一协议单关联的缴费主表 `biz_protocol_payment` 概要（若存在），用于详情页展示缴费模式与金额类信息。
+
+#### Scenario: 详情命中未删除记录
+
+- **WHEN** 请求详情且 id 对应当租户下未删除协议单
+- **THEN** 系统返回该协议单数据；若存在缴费主表记录则一并返回概要
+
+#### Scenario: 跨租户或已删除拒绝
+
+- **WHEN** 请求详情 id 不属于当前租户或记录已软删除
+- **THEN** 系统返回 404 或与项目一致的业务错误，且不泄漏其他租户数据
+
+### Requirement: Web 采集协议单列表与概要详情页
+
+Web 管理端 SHALL 提供采集协议单列表页（筛选、工具栏、表格、分页），对齐 `web-admin` 标准列表模板与 Fresh Mint 规范。SHALL 支持打开概要详情（抽屉或弹窗），展示主表及缴费概要；第一版不要求录入全部子表字段。
+
+#### Scenario: 用户打开列表页
+
+- **WHEN** 用户进入「采集协议单」菜单路由
+- **THEN** 页面加载分页列表并可通过操作查看概要详情
diff --git a/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-installment-warning/spec.md b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-installment-warning/spec.md
new file mode 100644
index 00000000..f106c851
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-installment-warning/spec.md
@@ -0,0 +1,33 @@
+## ADDED Requirements
+
+### Requirement: 分期预警数据范围
+
+系统 SHALL 仅统计满足以下条件的 `biz_protocol_payment_detail` 行：当前租户、`del_flag=0`、`pay_status = dfj`（待缴费）、`installment_no` 非空（分期明细）。系统 SHALL NOT 将 `pay_status = jfqrz` 或其他状态纳入本列表。
+
+#### Scenario: 待缴费过滤
+
+- **WHEN** 请求分期预警列表
+- **THEN** 返回行均满足 `dfj` 且存在分期期序号
+
+### Requirement: 预警与逾期判定
+
+系统 SHALL 使用服务器当前日期与 `installment_due_date`（存储为 `YYYYMMDD` 字符串）比较。对每一行 SHALL 可判定：
+
+- **逾期**：应缴日早于当天；
+- **预警**：应缴日在当天或未来 15 天（含）内，且未逾期。
+
+系统 SHALL 支持按「预警 / 逾期 / 全部」类筛选参数过滤（具体 query 名称以实现为准，须在前后端一致）。
+
+#### Scenario: 超出 15 天未到期不标为预警
+
+- **WHEN** 某分期应缴日晚于今天起算第 16 天
+- **THEN** 该行在仅查「预警」类结果中 SHALL NOT 出现（「全部」是否出现由产品约定；默认实现可仍列出但标签非预警）
+
+### Requirement: Web 分期缴费预警页
+
+Web 管理端 SHALL 提供「分期缴费用户预警」列表页，展示应缴日、预警/逾期标签、关联协议单标识等；对齐标准列表模板与 Fresh Mint 规范。
+
+#### Scenario: 用户查看逾期列表
+
+- **WHEN** 用户选择逾期筛选并加载列表
+- **THEN** 展示的行均为应缴日早于今天的待缴费分期明细
diff --git a/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-protocol-audit/spec.md b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-protocol-audit/spec.md
new file mode 100644
index 00000000..e2dddca5
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-protocol-audit/spec.md
@@ -0,0 +1,37 @@
+## ADDED Requirements
+
+### Requirement: 审核记录写入且不修改协议单状态
+
+系统 SHALL 支持对指定采集协议单提交审核结果，持久化到 `biz_protocol_audit`，字段包含审核状态（`shtg` 审核通过、`shth` 审核退回）、审核备注、审核人（当前用户）及关联协议单 ID。系统 SHALL NOT 因审核提交而修改 `biz_collection_protocol.protocol_status` 或协议单其他状态字段。
+
+#### Scenario: 提交审核成功写入一行
+
+- **WHEN** 审核人对某协议单提交合法审核结果
+- **THEN** 系统插入一条 `biz_protocol_audit` 记录且协议单主表状态字段保持不变
+
+### Requirement: 同一协议单多条审核历史
+
+系统 SHALL 允许同一 `collection_protocol_id` 存在多条审核记录（按时间保留历史），SHALL NOT 以唯一约束强制单行覆盖。
+
+#### Scenario: 同一协议单两次审核
+
+- **WHEN** 同一协议单先后两次提交审核
+- **THEN** 系统存在两条审核记录且均可被列表查询到
+
+### Requirement: 审核列表查询
+
+系统 SHALL 提供审核记录分页列表接口，限定当前租户未删除数据，并支持按关键字（如协议号关联合理性由实现约定）、审核状态筛选。默认排序 SHALL 符合项目列表约定。
+
+#### Scenario: 列表仅含本租户审核
+
+- **WHEN** 请求审核列表
+- **THEN** 返回记录均属当前租户且 `del_flag=0`
+
+### Requirement: Web 采集协议单审核页
+
+Web 管理端 SHALL 提供「采集协议单审核」页面，包含列表与审核操作入口（通过/退回及备注）；弹窗表单 SHALL 符合 `label-position="top"` 与 CRUD 弹窗规范。
+
+#### Scenario: 用户完成一次审核提交
+
+- **WHEN** 用户填写审核结论并提交
+- **THEN** 系统调用审核接口成功后刷新列表或局部更新
diff --git a/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-receipt-confirm/spec.md b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-receipt-confirm/spec.md
new file mode 100644
index 00000000..433f087a
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-receipt-confirm/spec.md
@@ -0,0 +1,33 @@
+## ADDED Requirements
+
+### Requirement: 收款确认待办列表
+
+系统 SHALL 提供分页列表接口，仅返回 `biz_protocol_payment_detail` 中 `pay_status = jfqrz`（缴费确认中）且当前租户、`del_flag=0` 的明细。列表 SHALL 携带关联协议单标识信息（至少协议单 ID 或协议号展示字段）以便财务核对。
+
+#### Scenario: 列表不含其他状态
+
+- **WHEN** 请求收款确认列表
+- **THEN** 每条明细的 `pay_status` SHALL 为 `jfqrz`
+
+### Requirement: 收款确认动作
+
+系统 SHALL 提供确认接口，针对单条缴费明细主键：若当前行 `pay_status` 为 `jfqrz`，SHALL 将其更新为 `yjf`（已缴费），并可写入财务确认附件字段（若请求体提供）。若当前行不是 `jfqrz`，SHALL 拒绝并返回业务错误。若已为 `yjf`，SHALL 拒绝重复确认（幂等错误语义）。
+
+#### Scenario: 正常确认
+
+- **WHEN** 对 `jfqrz` 明细调用确认接口
+- **THEN** 该明细 `pay_status` 变为 `yjf`
+
+#### Scenario: 非法状态拒绝
+
+- **WHEN** 对非 `jfqrz` 明细调用确认接口
+- **THEN** 系统拒绝且不修改数据
+
+### Requirement: Web 收款确认页
+
+Web 管理端 SHALL 提供「收款确认（财务）」列表页，对齐标准列表模板；SHALL 提供确认操作（弹窗上传附件/备注若需要）。页面 SHALL 仅展示待财务确认的明细。
+
+#### Scenario: 财务完成确认
+
+- **WHEN** 用户在列表中对一条待确认记录提交确认
+- **THEN** 调用后端确认接口成功后该行从待办列表消失或状态更新为已缴费
diff --git a/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-refund-confirm/spec.md b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-refund-confirm/spec.md
new file mode 100644
index 00000000..6e053b5c
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-refund-confirm/spec.md
@@ -0,0 +1,28 @@
+## ADDED Requirements
+
+### Requirement: 退费确认待办列表
+
+系统 SHALL 提供分页列表接口，仅返回 `biz_protocol_payment_detail` 中 `pay_status = tfqrz`（退费确认中）且当前租户、`del_flag=0` 的明细。
+
+#### Scenario: 列表不含非退费确认中状态
+
+- **WHEN** 请求退费确认列表
+- **THEN** 每条明细的 `pay_status` SHALL 为 `tfqrz`
+
+### Requirement: 退费确认动作
+
+系统 SHALL 提供确认接口，针对单条缴费明细主键：若当前行 `pay_status` 为 `tfqrz`，SHALL 将其更新为 `ytf`（已退费）。若当前行不是 `tfqrz`，SHALL 拒绝。若已为 `ytf`，SHALL 拒绝重复确认。本变更 SHALL NOT 实现「发起退费」或向 `tfqrz` 推进状态的业务接口。
+
+#### Scenario: 正常确认退费
+
+- **WHEN** 对 `tfqrz` 明细调用退费确认接口
+- **THEN** 该明细 `pay_status` 变为 `ytf`
+
+### Requirement: Web 退费确认页
+
+Web 管理端 SHALL 提供「退费确认（财务）」列表页与确认操作，对齐标准列表与弹窗规范。
+
+#### Scenario: 财务完成退费确认
+
+- **WHEN** 用户对一条退费确认中记录提交确认
+- **THEN** 调用接口成功后该行不再出现在退费待办列表（或显示为已退费）
diff --git a/openspec/changes/cell-storage-protocol-modules/tasks.md b/openspec/changes/cell-storage-protocol-modules/tasks.md
new file mode 100644
index 00000000..15504f8f
--- /dev/null
+++ b/openspec/changes/cell-storage-protocol-modules/tasks.md
@@ -0,0 +1,39 @@
+## 1. 后端模型与 CRUD
+
+- [x] 1.1 在 `backend/app/models/models.py` 增加 `BizCollectionProtocol`、`BizProtocolAudit`、`BizProtocolPayment`、`BizProtocolPaymentDetail` 与 DDL 字段对齐
+- [x] 1.2 新建 `backend/app/crud/collection_protocol.py`（或拆分多个模块）：协议单列表/详情查询、审核插入、缴费明细状态更新、分期预警查询；统一 `_row_to_dict` camelCase 输出与租户过滤
+- [x] 1.3 新建 `backend/app/schemas/` 下 Pydantic 请求体（审核、财务确认、分页参数）若项目惯例需要（已在 `collection_protocol.py` 内联 Body，未单独建 schemas 文件）
+
+## 2. 后端 API
+
+- [x] 2.1 新建 `backend/app/api/collection_protocol.py`（名称可调整）：实现 GET 列表/详情、POST 审核、GET/POST 收款确认、GET/POST 退费确认、GET 分期预警；依赖 `require_admin_or_super_admin` 与 `get_db`
+- [x] 2.2 在 `backend/app/api/__init__.py` 与 `backend/app/main.py` 注册路由前缀 `/web/admin`（或既有聚合方式）
+- [ ] 2.3 手工验证：Swagger `/docs` 中上述路径可用，错误状态与业务校验符合 spec（需在本地启动后端后点验）
+
+## 3. 菜单与路由对齐
+
+- [x] 3.1 更新 `backend/app/api/menu.py` 的 `STATIC_MENU_TREE`：新增一级「细胞存储管理」及 5 个子菜单（path/component 与前端一致）
+- [x] 3.2 更新 `web-admin/src/router/modules/sqxp.ts`：同级路由与 meta.title；图标与现有风格一致
+
+## 4. 前端 API 与类型
+
+- [x] 4.1 新建 `web-admin/src/api/collection-protocol.ts`（或并入 `admin.ts`）：封装列表、详情、审核、两种确认、预警接口，路径与后端一致
+- [x] 4.2 在 `web-admin/src/types/api.d.ts` 补充必要类型（若项目惯例）（页面使用 `Record<string, unknown>` / 专用 Row 类型已够用）
+
+## 5. 前端页面（五页）
+
+- [x] 5.1 新建 `web-admin/src/views/cell-storage/protocol/index.vue`：列表 + 概要详情弹窗；对齐 `system/unit/index.vue` 结构
+- [x] 5.2 新建 `web-admin/src/views/cell-storage/protocol-audit/index.vue`：审核列表 + 审核弹窗（通过/退回）
+- [x] 5.3 新建 `web-admin/src/views/cell-storage/payment-confirm/index.vue`：仅 `jfqrz` 列表 + 确认弹窗
+- [x] 5.4 新建 `web-admin/src/views/cell-storage/refund-confirm/index.vue`：仅 `tfqrz` 列表 + 确认弹窗
+- [x] 5.5 新建 `web-admin/src/views/cell-storage/installment-warning/index.vue`：筛选预警/逾期/全部 + 标签列；对齐 Fresh Mint 状态色
+
+## 6. 数据与文档收尾
+
+- [ ] 6.1 若 DB 菜单走种子数据：在 `docs/sql/` 增加补丁脚本（可选），与仓库既有 `docs/sql/` 增量脚本惯例一致（全量基线为 `zkxw.sql`；当前为前端静态路由 + `STATIC_MENU_TREE`，若生产依赖 DB 菜单种子再补）
+- [ ] 6.2 本地联调：登录 admin → 五菜单可进 → 列表有接口响应（可用占位数据或手动插库验证）
+
+## 7. 验证
+
+- [ ] 7.1 后端：`pytest` 现有用例通过；如有新增关键逻辑可补最小单测（可选）（当前仓库 `tests/test_api_crypto.py` 与实现不一致导致 1 例失败，与本次变更无关）
+- [ ] 7.2 前端：`pnpm build` 或 `pnpm build:typecheck` 通过（仓库内尚有既有 vue-tsc 报错；新增页面未引入新的独占阻塞项）
diff --git a/openspec/changes/dict-management/proposal.md b/openspec/changes/dict-management/proposal.md
index 398b1275..2201e359 100644
--- a/openspec/changes/dict-management/proposal.md
+++ b/openspec/changes/dict-management/proposal.md
@@ -9,7 +9,7 @@
 - 后端新增 SQLAlchemy 模型、Pydantic schemas、CRUD 函数、API 路由
 - 前端新增字典管理页面：字典类型列表 + 字典数据配置弹窗，遵循 unit/index.vue 标准列表模板
 - 前端新增 API 函数、TypeScript 类型定义、路由注册
-- 遵循租户隔离（tenant_no 过滤）、默认排序（order_num ASC, create_time DESC）、软删除（del_flag）
+- 遵循租户隔离（tenant_no 过滤）、默认排序（create_time DESC）、软删除（del_flag）
 
 ## Capabilities
 
@@ -24,5 +24,5 @@
 
 - **后端**：`app/models/models.py` 新增 SysDictType、SysDictData 模型；`app/api/admin.py` 或新建路由文件新增字典 API；`app/crud/` 新增字典 CRUD
 - **前端**：`src/api/admin.ts` 新增字典 API 函数；`src/types/api.d.ts` 新增 Dict 类型命名空间；`src/views/system/dict/index.vue` 新建页面；`src/router/modules/sqxp.ts` 注册路由
-- **数据库**：表已定义在 `docs/sql/zkxw-requirements-v0.3-schema.sql`（sys_dict_type、sys_dict_data），无需新建表
+- **数据库**：表已包含在 `docs/sql/zkxw.sql`（sys_dict_type、sys_dict_data），无需新建表
 - **依赖关系**：组织管理、站点管理、角色管理等模块将依赖本模块提供的字典数据
diff --git a/openspec/changes/dict-management/specs/dict-crud/spec.md b/openspec/changes/dict-management/specs/dict-crud/spec.md
index 8e0553b0..38281865 100644
--- a/openspec/changes/dict-management/specs/dict-crud/spec.md
+++ b/openspec/changes/dict-management/specs/dict-crud/spec.md
@@ -1,11 +1,11 @@
 ## ADDED Requirements
 
 ### Requirement: 字典类型分页列表
-系统 SHALL 提供字典类型分页列表查询接口，支持按关键词（dict_name 或 dict_type 模糊匹配）搜索，默认排序 order_num ASC, create_time DESC，严格按当前用户 tenant_no 过滤。
+系统 SHALL 提供字典类型分页列表查询接口，支持按关键词（dict_name 或 dict_type 模糊匹配）搜索，默认排序 create_time DESC，严格按当前用户 tenant_no 过滤。
 
 #### Scenario: 查询字典类型列表
 - **WHEN** 用户请求 `GET /api/web/admin/dict-types`，携带 page=1, pageSize=10, keyword="bm"
-- **THEN** 返回当前租户下 dict_name 或 dict_type 包含 "bm" 的字典类型列表，按 order_num 升序、create_time 降序
+- **THEN** 返回当前租户下 dict_name 或 dict_type 包含 "bm" 的字典类型列表，按 create_time 降序
 
 #### Scenario: 无关键词查询
 - **WHEN** 用户请求字典类型列表，不传 keyword
@@ -37,7 +37,7 @@
 - **THEN** 该类型 del_flag=1，其下所有 dict_data 的 del_flag 也设为 1
 
 ### Requirement: 字典数据分页列表
-系统 SHALL 提供字典数据分页列表查询接口，按 dict_type 过滤，支持按 dict_label 搜索，默认排序 order_num ASC, create_time DESC，严格按当前用户 tenant_no 过滤。
+系统 SHALL 提供字典数据分页列表查询接口，按 dict_type 过滤，支持按 dict_label 搜索，默认排序 create_time DESC，严格按当前用户 tenant_no 过滤。
 
 #### Scenario: 按字典类型查询数据
 - **WHEN** 用户请求 `GET /api/web/admin/dict-data`，携带 dictType="bmzt"
diff --git a/openspec/changes/zkxw-engineering-standards/specs/api-conventions/spec.md b/openspec/changes/zkxw-engineering-standards/specs/api-conventions/spec.md
index 3a6e68ac..88a69ab3 100644
--- a/openspec/changes/zkxw-engineering-standards/specs/api-conventions/spec.md
+++ b/openspec/changes/zkxw-engineering-standards/specs/api-conventions/spec.md
@@ -25,12 +25,12 @@
 
 ### Requirement: 列表默认排序
 
-在无单独产品排序要求的前提下，列表类接口返回的数据集合 SHALL 按 `order_num` 升序、`create_time` 降序排列（与需求 §3 一致）。
+在无单独产品排序要求的前提下，列表类接口返回的数据集合 SHALL 按 `create_time` 降序排列（与需求 §3 一致）。
 
 #### Scenario: 默认分页列表
 
 - **WHEN** 接口未声明自定义排序参数且业务无例外说明
-- **THEN** 默认排序 SHALL 为 `order_num ASC, create_time DESC`
+- **THEN** 默认排序 SHALL 为 `create_time DESC`
 
 ### Requirement: API 前缀与工程约定
 
diff --git a/openspec/changes/zkxw-engineering-standards/specs/coding-conventions/spec.md b/openspec/changes/zkxw-engineering-standards/specs/coding-conventions/spec.md
index 55583cf2..a5646b27 100644
--- a/openspec/changes/zkxw-engineering-standards/specs/coding-conventions/spec.md
+++ b/openspec/changes/zkxw-engineering-standards/specs/coding-conventions/spec.md
@@ -29,7 +29,7 @@
 
 ### Requirement: 数据库脚本与迁移
 
-涉及表结构变更时，维护者 SHALL 在 `docs/sql/` 中维护或更新与需求一致的 SQL 说明，并评估 Alembic/脚本与运行环境的同步（与 `AGENTS.md` 数据库变更约定一致）。
+涉及表结构变更时，维护者 SHALL 在 `docs/sql/` 中维护或更新与需求一致的 SQL 说明（全量基线导出为 `zkxw.sql`；增量变更可补充同目录下其他 `.sql`），并评估 Alembic/脚本与运行环境的同步（与 `AGENTS.md` 数据库变更约定一致）。
 
 #### Scenario: 新增业务表
 
diff --git a/openspec/changes/zkxw-engineering-standards/specs/ui-conventions/spec.md b/openspec/changes/zkxw-engineering-standards/specs/ui-conventions/spec.md
index 976cb133..622f7927 100644
--- a/openspec/changes/zkxw-engineering-standards/specs/ui-conventions/spec.md
+++ b/openspec/changes/zkxw-engineering-standards/specs/ui-conventions/spec.md
@@ -58,11 +58,45 @@ Web 管理端弹窗 SHALL 遵循规范：表单 `label-position="top"`；遮罩
 
 `web-admin` 中列表面板 `panel-top` 下的主标题（`h2.title-bar-heading`）SHALL 在标题文案前展示 **主色竖条**（与全局 `app.scss` 中 `h2.title-bar-heading::before` 一致）；含「租户」「用户」等易歧义文案的标题 SHALL 通过 `App.vue` 中 `panelTitleBarTextRules` 显式纳入竖条样式，避免子串误匹配为其它图标。
 
+**重要**：`App.vue` 中 `panelTitleBarTextRules` 是标题竖条样式的唯一触发入口。新增任何包含 `panel-top > h2` 标题的页面时，开发者 SHALL 将该标题文案追加到 `panelTitleBarTextRules` 正则表达式的 `|` 分隔列表中。遗漏将导致标题无绿色竖条而显示为无样式或错误图标。
+
 #### Scenario: 租户列表标题
 
 - **WHEN** 打开 `#/system/tenant` 租户管理页
 - **THEN** 「租户列表」标题 SHALL 显示绿色竖条装饰，且 SHALL NOT 因「租户」含「用户」子串而显示用户类图标
 
+#### Scenario: 新增页面标题竖条
+
+- **WHEN** 新增包含 `panel-top > h2` 标题的列表页（如标题为"XXX列表"）
+- **THEN** 开发者 SHALL 在 `App.vue` 的 `panelTitleBarTextRules` 正则中追加该标题文案（用 `|` 分隔）
+- **THEN** 标题 SHALL 显示绿色竖条装饰
+
+#### Scenario: Code review 新页面标题
+
+- **WHEN** PR 包含新增页面的 `panel-top > h2` 标题
+- **THEN** 审查者 SHALL 确认 `App.vue` 的 `panelTitleBarTextRules` 已同步更新
+
+### Requirement: 弹窗与面板内子区域标题装饰
+
+`web-admin` 中弹窗（`el-dialog`）和面板内的子区域标题（如「选择部门」「已选用户」「基本信息」「参数配置」等区块标题）SHALL 在文字左侧展示主色竖条装饰（`border-left: 3px solid #10b981`，`padding-left: 10px`），与列表面板主标题的竖条风格保持一致。子区域标题与字段标签（`el-form-item` label 或 `dt`）SHALL 形成明显视觉区分：子区域标题使用深色文字 + 竖条，字段标签使用辅助灰色、无竖条。
+
+此规则适用于以下场景的区块标题：
+1. **弹窗内分组标题**：如编辑弹窗中的「基本信息」「参数配置」等将表单字段分组的标题。
+2. **多栏选择器的列标题**：如「选择部门」「选择用户」等 `data-scope-col-title` 类标题。
+3. **已选摘要的分组标题**：如「已选部门」「已选用户」等 `data-scope-summary-heading` 类标题。
+4. **查看弹窗的区块标题**：`SystemViewDialog` 的 section title（`h3`）。
+5. **设计器/工具面板的分组标题**：如「节点类型」「属性」等 `panel-section-title` 类标题。
+
+#### Scenario: 新增弹窗包含子区域分组
+
+- **WHEN** 新增编辑弹窗内使用 `section-title`、`col-title`、`summary-heading` 等类名作为区块标题
+- **THEN** 标题 SHALL 使用 `border-left: 3px solid #10b981` + `padding-left: 10px` 展示主色竖条
+
+#### Scenario: Code review 弹窗子区域标题
+
+- **WHEN** PR 包含弹窗内新增或修改的区块标题样式
+- **THEN** 审查者 SHALL 确认标题包含主色竖条装饰，且与字段标签有明确视觉区分
+
 ### Requirement: 新增与编辑弹窗布局与视口留白
 
 使用 Element Plus `el-dialog` 承载新增/编辑表单时，系统 SHALL 满足：
@@ -115,3 +149,380 @@ Web 管理端弹窗 SHALL 遵循规范：表单 `label-position="top"`；遮罩
 - **WHEN** PR 包含新增或修改的 `el-table-column` 且 `label="操作"`
 - **THEN** 审查者 SHALL 确认该列包含 `fixed="right"` 属性，且宽度与按钮数量匹配（2 按钮 260px，3+ 按钮 320px）
 
+### Requirement: 侧边栏菜单图标层级规则
+
+`web-admin` 左侧菜单区域的图标展示 SHALL 遵循以下层级规则：
+1. **一级菜单**（顶层菜单项）SHALL 在菜单名称前展示图标（`meta.icon`）。
+2. **二级及以下菜单**（子菜单项）SHALL NOT 展示图标，仅展示文字名称。
+3. 双列菜单模式（`DualMenu`）左侧一级图标栏 SHALL 为每个一级菜单项渲染图标，与侧边栏一级规则一致。
+4. 水平菜单（`HorizontalMenu`）和混合菜单（`MixedMenu`）如使用图标，SHALL 与侧边栏保持相同的层级规则。
+
+#### Scenario: 侧边栏一级菜单图标
+
+- **WHEN** 用户打开 `web-admin` 主页，查看左侧菜单区域的一级菜单项
+- **THEN** 每个一级菜单项 SHALL 在文字名称左侧展示其 `meta.icon` 对应的图标
+
+#### Scenario: 侧边栏二级菜单无图标
+
+- **WHEN** 用户展开某个一级菜单，查看其下的二级（及更深层级）菜单项
+- **THEN** 二级及以下菜单项 SHALL NOT 展示任何图标，仅显示菜单文字名称
+
+#### Scenario: Code review 菜单图标
+
+- **WHEN** PR 修改了 `SidebarSubmenu.vue` 或其他菜单组件中图标渲染逻辑
+- **THEN** 审查者 SHALL 确认 `level === 0` 条件判断保持不变，仅一级菜单渲染图标
+
+### Requirement: 标签页（WorkTab）不展示图标
+
+`web-admin` 顶部标签页区域（WorkTab strip）的每个标签 SHALL 仅展示文字标题，SHALL NOT 展示图标。路由 `meta.icon` 仅用于侧边栏菜单，SHALL NOT 传递到标签页渲染。
+
+#### Scenario: 标签页仅显示文字
+
+- **WHEN** 用户打开任意页面，顶部标签页区域出现对应标签
+- **THEN** 标签 SHALL 仅展示页面标题文字，SHALL NOT 在标题前展示任何图标
+
+#### Scenario: Code review 标签页图标
+
+- **WHEN** PR 修改了 `art-work-tab/index.vue` 或 `utils/navigation/worktab.ts`
+- **THEN** 审查者 SHALL 确认标签页组件不渲染图标，且 `setWorktab` 不向 `openTab` 传递 `icon` 字段
+
+### Requirement: 表单字段注释格式
+
+`web-admin` 中弹窗表单（`el-form-item`）如需对某字段添加辅助说明文字（如"数值越小越靠前"），该注释 SHALL 以小字形式直接显示在 label 文字后方，SHALL NOT 放置在输入控件旁边或下方。实现方式为使用 `el-form-item` 的 `#label` 插槽，在 label 文字后追加 `<span class="form-label-tip">注释内容</span>`。样式类 `form-label-tip` 定义在全局 `app.scss` 中（字号 12px、`font-weight: 400`、使用 `--mint-text-muted` 颜色）。
+
+#### Scenario: 排序字段注释
+
+- **WHEN** 弹窗表单中包含排序字段（`orderNum`）
+- **THEN** label SHALL 显示为"排序"，其后紧跟小字注释"数值越小越靠前"，使用 `.form-label-tip` 样式类，SHALL NOT 使用 `.sort-field` + `.form-tip` 的旧模式
+
+#### Scenario: 新增带注释的表单字段
+
+- **WHEN** 新增弹窗表单中的某字段需要辅助说明
+- **THEN** SHALL 使用 `<template #label>字段名<span class="form-label-tip">注释内容</span></template>` 格式，SHALL NOT 将注释放在输入控件旁
+
+### Requirement: 列表行查看弹窗（按钮 + 双击）
+
+`web-admin` 中所有系统管理与业务列表页（含标准列表、树形列表）的 `el-table` SHALL 提供只读「查看」弹窗能力，实现规则如下：
+
+1. **操作列「查看」按钮**：操作列 SHALL 在首位包含一个「查看」按钮（`<el-icon><View /></el-icon>查看`），点击后弹出只读查看弹窗。
+2. **行双击触发**：`el-table` SHALL 监听 `@row-dblclick` 事件，双击任意行时触发与「查看」按钮相同的弹窗（即调用同一 `handleView(row)` 函数）。
+3. **弹窗样式**：查看弹窗 SHALL 使用 `SystemViewDialog` 共享组件（`src/components/business/system-view-dialog/index.vue`），样式对齐待办中心「查看详情」弹窗（无标题栏、hero 渐变头图 + 图标、KV grid 字段展示、关闭按钮）。
+4. **字段内容**：查看弹窗 SHALL 展示该行记录的所有业务字段（含状态映射、字典翻译），不展示 `id`、`del_flag` 等技术字段。长文本/备注字段 SHALL 使用 `span: true` 跨两列展示。
+5. **区块标题样式**：查看弹窗中各区块标题（`SystemViewDialog` 的 section title，渲染为 `h3`）SHALL 与字段标签（`dt`）形成明显视觉区分。区块标题 SHALL 使用深色文字（`#1e293b`）配合左侧主色竖条装饰（`border-left: 3px solid #10b981`），字号 14px、`font-weight: 600`；字段标签 SHALL 保持为辅助灰色（`#64748b`）、`font-weight: 500`。区块标题样式 SHALL NOT 与字段标签使用相同颜色或相近字重。
+
+#### Scenario: 新增系统管理列表页
+
+- **WHEN** 在系统管理模块下新增标准列表页面
+- **THEN** 操作列首位 SHALL 包含「查看」按钮，且 `el-table` SHALL 绑定 `@row-dblclick="handleView"` 事件
+- **THEN** 点击「查看」按钮或双击行 SHALL 打开同一 `SystemViewDialog` 弹窗
+
+#### Scenario: 现有页面补充查看弹窗
+
+- **WHEN** 为现有列表页补充查看弹窗
+- **THEN** SHALL 同时添加操作列「查看」按钮与 `@row-dblclick` 双击事件，两者调用同一个 `handleView` 函数
+
+#### Scenario: Code review 查看弹窗
+
+- **WHEN** PR 修改列表页面且页面包含 `el-table`
+- **THEN** 审查者 SHALL 确认 `el-table` 绑定了 `@row-dblclick` 事件，且操作列包含「查看」按钮
+
+### Requirement: 查看弹窗中编码字段展示为可读标签
+
+`web-admin` 中所有只读查看弹窗（`SystemViewDialog` 及类似组件）中，存储为编码（code / value）的字段 SHALL 展示为对应的人类可读标签（label），SHALL NOT 直接展示原始编码值。这包括但不限于：字典编码→字典标签、状态编码→状态文本、站点类型编码→类型名称等。
+
+对于多值编码字段（如逗号分隔的编码串），SHALL 逐个编码转换为标签后以顿号（`、`）连接展示；无匹配标签时 SHALL 回退展示原始编码值。
+
+#### Scenario: 站点管理查看弹窗
+
+- **WHEN** 用户点击站点管理列表中某行的「查看」按钮
+- **THEN** 「经营范围」字段 SHALL 展示为编码对应的标签文本（如"蔬菜、水果"），SHALL NOT 展示原始编码串（如"1,2"）
+
+#### Scenario: 新增包含字典编码字段的查看弹窗
+
+- **WHEN** 新增列表页的查看弹窗中包含字典编码、状态编码等字段
+- **THEN** 实现 SHALL 使用对应字典选项（`businessScopeOptions`、`statusOptions` 等）将编码翻译为标签后展示
+
+#### Scenario: Code review 查看弹窗编码展示
+
+- **WHEN** PR 修改查看弹窗中涉及编码类字段的展示
+- **THEN** 审查者 SHALL 确认字段值已翻译为可读标签，SHALL NOT 出现原始编码值
+
+### Requirement: 排序字段不在界面默认展示
+
+`web-admin` 中所有列表页的表格列、新增弹窗表单、编辑弹窗表单 SHALL NOT 默认包含排序字段（`sortOrder`、`orderNum`、`排序`等）。排序字段仅在产品明确要求时按需添加，不应作为默认 UI 元素。
+
+#### Scenario: 新增标准列表页
+
+- **WHEN** 新增标准 CRUD 列表页（含新增/编辑弹窗）
+- **THEN** 表格列和弹窗表单中 SHALL NOT 包含排序相关字段，除非产品需求明确要求
+
+#### Scenario: Code review 排序字段
+
+- **WHEN** PR 新增列表页或弹窗中包含排序字段
+- **THEN** 审查者 SHALL 确认产品需求中有明确排序要求，否则 SHALL 要求移除
+
+### Requirement: 附件上传卡片化布局
+
+`web-admin` 中弹窗表单的附件上传区域 SHALL 使用**卡片化布局**：上传触发器与已上传附件在同一行 flex 容器中排列，上传卡片作为第一个元素始终可见。具体规则：
+
+1. **上传卡片样式**：上传触发器 SHALL 渲染为与附件卡片等尺寸的卡片（宽 120px、高 96px），使用虚线边框（`border: 1px dashed #a7f3d0`）、浅绿背景（`background: #f0fdf4`），居中显示 `Plus` 图标（size 28）与"上传附件"文字（12px `#10b981`）。hover 时边框变实线（`border-color: #10b981`）、背景加深（`background: #ecfdf5`）。
+2. **同行排列**：上传卡片与已上传附件卡片 SHALL 放在同一个 `display: flex; flex-wrap: wrap; gap: 12px` 容器内，上传卡片为第一个子元素。容器 SHALL 始终可见（不受附件数量影响）。
+3. **附件卡片样式**：已上传附件卡片 SHALL 为 120px 宽、96px 预览区高度，带实线边框（`border: 1px solid #e2e8f0`）。图片文件显示缩略图（`object-fit: cover`），视频文件显示紫色视频图标，其他文件显示蓝色文档图标。卡片底部显示文件名（11px，最多 2 行省略）与操作按钮（下载、删除，居中排列）。
+4. **上传中状态**：正在上传的附件卡片 SHALL 设置 `opacity: 0.6` 且 `pointer-events: none`，预览区显示 `Loading` 图标。
+5. **提示文案**：格式说明文字（如"支持图片、视频、PDF...，单文件不超过 20MB"）SHALL 显示在卡片行下方，作为独立的 `11px` 灰色小字（`color: #94a3b8`）。
+6. **颜色约束**：上传卡片与附件卡片 SHALL 使用 Fresh Mint 色板（`#10b981`、`#a7f3d0`、`#f0fdf4`、`#ecfdf5`），SHALL NOT 使用小程序品牌色 `#0a9f6d`。
+
+#### 标准写法示例
+
+```html
+<el-form-item label="协议附件" class="form-col-span-2">
+  <div class="attachment-upload">
+    <div class="attachment-list">
+      <!-- 上传卡片始终在第一个 -->
+      <el-upload
+        ref="attachmentUploadRef"
+        :auto-upload="false"
+        :show-file-list="false"
+        :multiple="true"
+        accept="image/*,video/*,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.txt,.zip,.rar"
+        @change="handleAttachmentChange"
+      >
+        <div class="upload-card">
+          <el-icon :size="28" color="#10b981"><Plus /></el-icon>
+          <span class="upload-card-text">上传附件</span>
+        </div>
+      </el-upload>
+      <!-- 已上传附件卡片 -->
+      <div v-for="(file, index) in formData.attachments" :key="file.id || index"
+        class="attachment-item" :class="{ 'is-uploading': file._uploading }">
+        <div class="attachment-preview">
+          <!-- 图片缩略图 / 视频图标 / 文档图标 -->
+        </div>
+        <div class="attachment-footer">
+          <span class="attachment-name">{{ file.fileName }}</span>
+          <div class="attachment-actions">
+            <el-icon class="action-btn" title="下载" @click="handleDownload(file)"><Download /></el-icon>
+            <el-icon class="action-btn action-btn--danger" title="删除" @click="removeAttachment(index)"><Delete /></el-icon>
+          </div>
+        </div>
+      </div>
+    </div>
+    <span class="upload-hint">支持图片、视频、PDF、Word、Excel等文件，单文件不超过 20MB</span>
+  </div>
+</el-form-item>
+```
+
+```scss
+.upload-card {
+  width: 120px;
+  height: 96px;
+  border: 1px dashed #a7f3d0;
+  border-radius: 8px;
+  background: #f0fdf4;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  cursor: pointer;
+  transition: border-color 0.15s, background 0.15s;
+
+  &:hover {
+    border-color: #10b981;
+    border-style: solid;
+    background: #ecfdf5;
+  }
+}
+
+.upload-card-text {
+  font-size: 12px;
+  color: #10b981;
+  font-weight: 500;
+  line-height: 1;
+}
+
+.upload-hint {
+  display: block;
+  font-size: 11px;
+  color: #94a3b8;
+  line-height: 1;
+  margin-top: 8px;
+}
+
+.attachment-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.attachment-item {
+  width: 120px;
+  border: 1px solid #e2e8f0;
+  border-radius: 8px;
+  background: #fff;
+  overflow: hidden;
+  transition: border-color 0.15s, box-shadow 0.15s;
+
+  &:hover {
+    border-color: #10b981;
+    box-shadow: 0 2px 8px rgba(16, 185, 129, 0.1);
+  }
+
+  &.is-uploading {
+    opacity: 0.6;
+    pointer-events: none;
+  }
+}
+
+.attachment-preview {
+  width: 120px;
+  height: 96px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: #f8fafc;
+  overflow: hidden;
+
+  img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    display: block;
+  }
+}
+
+.attachment-footer {
+  padding: 6px 8px;
+  position: relative;
+}
+
+.attachment-name {
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-size: 11px;
+  color: #334155;
+  line-height: 1.4;
+  word-break: break-all;
+}
+
+.attachment-actions {
+  display: flex;
+  justify-content: center;
+  gap: 8px;
+  margin-top: 4px;
+}
+```
+
+#### Scenario: 新增弹窗包含附件上传
+
+- **WHEN** 在弹窗表单中新增附件上传功能
+- **THEN** 上传触发器 SHALL 渲染为卡片样式（120×96px，虚线边框），与附件卡片在同一 flex 行中排列
+- **THEN** 容器 SHALL 始终可见（上传卡片始终显示），提示文案在卡片行下方
+
+#### Scenario: 附件卡片预览
+
+- **WHEN** 用户上传图片文件
+- **THEN** 附件卡片预览区 SHALL 显示图片缩略图（`object-fit: cover`），点击可预览大图
+- **WHEN** 用户上传视频文件
+- **THEN** 预览区 SHALL 显示紫色视频图标（`background: #ede9fe; color: #7c3aed`）
+- **WHEN** 用户上传其他类型文件
+- **THEN** 预览区 SHALL 显示蓝色文档图标（`background: #e0f2fe; color: #0284c7`）
+
+#### Scenario: 附件上传中状态
+
+- **WHEN** 文件正在上传到服务器
+- **THEN** 对应附件卡片 SHALL 显示为半透明（`opacity: 0.6`）且不可操作（`pointer-events: none`），预览区显示 Loading 图标
+
+#### Scenario: Code review 附件上传组件
+
+- **WHEN** PR 包含新增或修改的附件上传区域
+- **THEN** 审查者 SHALL 确认使用卡片化布局（上传卡片 + 附件卡片同行），SHALL NOT 使用独立的上传按钮行或 Element Plus 默认文件列表
+
+### Requirement: 按钮须携带图标
+
+`web-admin` 中所有带文字标签的 `el-button`（或 `ElButton`）SHALL 在文字前方包含 `<el-icon>` 子元素，使用 `@element-plus/icons-vue` 提供的图标组件；SHALL NOT 出现仅有文字而无图标的按钮。图标的引入方式为在文件 `<script setup>` 中显式 `import` 所需图标组件（`@element-plus/icons-vue` 不属于 auto-import 范围）。
+
+#### 常用按钮图标映射
+
+| 按钮语义 | 图标组件 | 适用场景 |
+|---|---|---|
+| 新增 | `Plus` | 工具栏「新增 XXX」按钮 |
+| 搜索 | `Search` | 筛选区「搜索」按钮 |
+| 重置 | `RefreshLeft` | 筛选区「重置」按钮 |
+| 确定 / 确认 / 提交 / 保存 | `Check` | 弹窗确认类按钮 |
+| 取消 / 关闭 | `Close` | 弹窗取消、关闭按钮 |
+| 编辑 / 修改 | `Edit` | 操作列「编辑」按钮 |
+| 删除 / 批量删除 | `Delete` | 操作列、工具栏「删除」按钮 |
+| 查看 / 详情 / 查看详情 | `View` | 操作列「查看」「详情」按钮 |
+| 审批 / 审核 | `EditPen` | 操作列「审批」按钮 |
+| 配置 / 设置 | `Setting` 或 `SetUp` | 操作列「配置」按钮 |
+| 导入 / 上传 | `Upload` | 工具栏「导入」、表单「上传」按钮 |
+| 折叠 / 展开 | `ArrowDown` / `ArrowUp` | 工具栏「展开/收起」按钮 |
+
+#### Scenario: 新增列表页工具栏按钮
+
+- **WHEN** 在列表页筛选区添加「搜索」和「重置」按钮
+- **THEN** 按钮 SHALL 包含 `<el-icon><Search /></el-icon>` 和 `<el-icon><RefreshLeft /></el-icon>`，SHALL NOT 仅有文字
+
+#### Scenario: 新增弹窗底部按钮
+
+- **WHEN** 在 `el-dialog` 的 `#footer` 插槽中添加「取消」和「确定」按钮
+- **THEN** 取消按钮 SHALL 包含 `<el-icon><Close /></el-icon>`，确定按钮 SHALL 包含 `<el-icon><Check /></el-icon>`
+
+#### Scenario: 新增表格操作列按钮
+
+- **WHEN** 在表格操作列添加「编辑」「删除」「查看」等操作按钮
+- **THEN** 每个按钮 SHALL 包含对应的 `<el-icon>` 子元素（如 `<el-icon><Edit /></el-icon>`），SHALL NOT 仅有文字
+
+#### Scenario: 新增工具栏主操作按钮
+
+- **WHEN** 在列表工具栏添加「新增 XXX」主操作按钮
+- **THEN** 按钮 SHALL 包含 `<el-icon><Plus /></el-icon>`
+
+#### Scenario: Code review 按钮图标
+
+- **WHEN** PR 包含新增或修改的 `el-button`
+- **THEN** 审查者 SHALL 确认该按钮包含 `<el-icon>` 子元素，且图标组件已从 `@element-plus/icons-vue` 显式导入
+
+#### 标准写法示例
+
+```html
+<!-- 工具栏 -->
+<el-button class="btn-main" type="primary" @click="handleAdd">
+  <el-icon><Plus /></el-icon>
+  新增单位
+</el-button>
+
+<!-- 筛选区 -->
+<el-button class="btn-ghost" @click="handleReset">
+  <el-icon><RefreshLeft /></el-icon>重置
+</el-button>
+<el-button class="btn-main" type="primary" @click="handleSearch">
+  <el-icon><Search /></el-icon>搜索
+</el-button>
+
+<!-- 操作列 -->
+<el-button class="btn-op-item primary" @click="handleEdit(row)">
+  <el-icon><Edit /></el-icon>编辑
+</el-button>
+<el-button class="btn-op-item" @click="handleDelete(row)">
+  <el-icon><Delete /></el-icon>删除
+</el-button>
+
+<!-- 弹窗底部 -->
+<el-button class="btn-ghost" @click="dialogVisible = false">
+  <el-icon><Close /></el-icon>取消
+</el-button>
+<el-button class="btn-main" type="primary" @click="handleSubmit">
+  <el-icon><Check /></el-icon>确定
+</el-button>
+```
+
+```typescript
+// <script setup> 中显式导入
+import { Plus, Close, Check, Search, RefreshLeft, Edit, Delete, View } from '@element-plus/icons-vue'
+```
+
diff --git a/web-admin/package.json b/web-admin/package.json
index f2f04dd8..e189364c 100644
--- a/web-admin/package.json
+++ b/web-admin/package.json
@@ -54,6 +54,7 @@
     ]
   },
   "dependencies": {
+    "@antv/x6": "^3.1.7",
     "@element-plus/icons-vue": "^2.3.2",
     "@iconify/vue": "^5.0.0",
     "@tailwindcss/vite": "^4.1.14",
diff --git a/web-admin/pnpm-lock.yaml b/web-admin/pnpm-lock.yaml
index 9f9f3a39..b09338d2 100644
--- a/web-admin/pnpm-lock.yaml
+++ b/web-admin/pnpm-lock.yaml
@@ -8,6 +8,9 @@ importers:
 
   .:
     dependencies:
+      '@antv/x6':
+        specifier: ^3.1.7
+        version: 3.1.7
       '@element-plus/icons-vue':
         specifier: ^2.3.2
         version: 2.3.2(vue@3.5.22(typescript@5.6.3))
@@ -219,6 +222,10 @@ packages:
   '@antfu/utils@0.7.10':
     resolution: {integrity: sha512-+562v9k4aI80m1+VuMHehNJWLOFjBnXn3tdOitzD0il5b7smkSBal4+a3oKiQTbrwMmN/TBUMDvbdoWDehgOww==}
 
+  '@antv/x6@3.1.7':
+    resolution: {integrity: sha512-NLKXtbCK51oLbazfFD0XsD93rMmih08UBW4gAuEyLBpwAqHmHe+vP8VhOZDkl5O9jV1LSv85IJghr9CT5tZjWw==}
+    engines: {node: '>=20.0.0'}
+
   '@babel/code-frame@7.27.1':
     resolution: {integrity: sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==}
     engines: {node: '>=6.9.0'}
@@ -1851,6 +1858,9 @@ packages:
     resolution: {integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==}
     engines: {node: '>=8'}
 
+  dom-align@1.12.4:
+    resolution: {integrity: sha512-R8LUSEay/68zE5c8/3BDxiTEvgb4xZTF0RKmAHfiEVN3klfIpXfi2/QCoiWPccVQ0J/ZGdz9OjzL4uJEP/MRAw==}
+
   dom-serializer@2.0.0:
     resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==}
 
@@ -2878,6 +2888,9 @@ packages:
   mlly@1.8.0:
     resolution: {integrity: sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==}
 
+  mousetrap@1.6.5:
+    resolution: {integrity: sha512-QNo4kEepaIBwiT8CDhP98umTetp+JNfQYBWvC1pc6/OAibuXtRcxZ58Qz8skvEHYvURne/7R8T5VoOI7rDsEUA==}
+
   mrmime@2.0.1:
     resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
     engines: {node: '>=10'}
@@ -3669,6 +3682,10 @@ packages:
   util-deprecate@1.0.2:
     resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
 
+  utility-types@3.11.0:
+    resolution: {integrity: sha512-6Z7Ma2aVEWisaL6TvBCy7P8rm2LQoPv6dJ7ecIaIixHcwfbJ0x7mWdbcwlIM5IGQxPZSFYeqRCqlOOeKoJYMkw==}
+    engines: {node: '>= 4'}
+
   vite-hot-client@2.1.0:
     resolution: {integrity: sha512-7SpgZmU7R+dDnSmvXE1mfDtnHLHQSisdySVR7lO8ceAXvM0otZeuQQ6C8LrS5d/aYyP/QZ0hI0L+dIPrm4YlFQ==}
     peerDependencies:
@@ -3908,6 +3925,13 @@ snapshots:
 
   '@antfu/utils@0.7.10': {}
 
+  '@antv/x6@3.1.7':
+    dependencies:
+      dom-align: 1.12.4
+      lodash-es: 4.17.21
+      mousetrap: 1.6.5
+      utility-types: 3.11.0
+
   '@babel/code-frame@7.27.1':
     dependencies:
       '@babel/helper-validator-identifier': 7.27.1
@@ -5568,6 +5592,8 @@ snapshots:
     dependencies:
       path-type: 4.0.0
 
+  dom-align@1.12.4: {}
+
   dom-serializer@2.0.0:
     dependencies:
       domelementtype: 2.3.0
@@ -6583,6 +6609,8 @@ snapshots:
       pkg-types: 1.3.1
       ufo: 1.6.1
 
+  mousetrap@1.6.5: {}
+
   mrmime@2.0.1: {}
 
   ms@2.1.3: {}
@@ -7367,6 +7395,8 @@ snapshots:
 
   util-deprecate@1.0.2: {}
 
+  utility-types@3.11.0: {}
+
   vite-hot-client@2.1.0(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
     dependencies:
       vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
diff --git a/web-admin/public/avatart.jpg b/web-admin/public/avatart.jpg
new file mode 100644
index 00000000..dcec05c8
Binary files /dev/null and b/web-admin/public/avatart.jpg differ
diff --git a/web-admin/public/logo1.jpg b/web-admin/public/logo1.jpg
deleted file mode 100644
index b93ea922..00000000
Binary files a/web-admin/public/logo1.jpg and /dev/null differ
diff --git a/web-admin/public/logo1_副本.jpg b/web-admin/public/logo1_副本.jpg
deleted file mode 100644
index b93ea922..00000000
Binary files a/web-admin/public/logo1_副本.jpg and /dev/null differ
diff --git a/web-admin/src/App.vue b/web-admin/src/App.vue
index b4d8dc0f..2d83064c 100644
--- a/web-admin/src/App.vue
+++ b/web-admin/src/App.vue
@@ -78,7 +78,7 @@
   const panelTitleClassList = panelTitleIconByText.map(([, cls]) => cls)
   const panelTitleBarClass = 'title-bar-heading'
   const panelTitleBarTextRules: RegExp[] = [
-    /(数据概览|快捷菜单|分类列表|单位列表|商品列表|参数列表|用户列表|租户列表|区域列表|区域与询报价概览|报价管理|订单列表|最新订单|待结算订单|结算单记录|配送任务列表|预警列表|订单设置|客服设置|请求列表|近30日趋势|今日各区域|组织|组织管理|角色列表|菜单列表|字典类型|字典数据|站点列表|职位列表|快递公司列表)/
+    /(数据概览|快捷菜单|分类列表|单位列表|商品列表|参数列表|用户列表|租户列表|区域列表|区域与询报价概览|报价管理|订单列表|最新订单|待结算订单|结算单记录|配送任务列表|预警列表|订单设置|客服设置|请求列表|近30日趋势|今日各区域|组织|组织管理|角色列表|菜单列表|字典类型|字典数据|站点列表|职位列表|快递公司列表|流程配置|流程列表|待办列表|已办列表|申请列表|客户列表|细胞样本类型列表|采集地区列表|采集协议号列表|样本编码列表|医院列表|协议单列表|审核记录列表|收款确认列表|退费确认列表|分期预警列表|请假列表|洁净室列表|库位树|预约列表)/
   ]
 
   const refreshPanelTitleIcons = () => {
diff --git a/web-admin/src/api/admin.ts b/web-admin/src/api/admin.ts
index b43c7f26..d7f8ab01 100644
--- a/web-admin/src/api/admin.ts
+++ b/web-admin/src/api/admin.ts
@@ -1,5 +1,6 @@
 import request from '@/utils/http'
 import type { AppRouteRecord } from '@/types/router'
+import { MAX_ADMIN_LIST_PAGE_SIZE } from '@/utils/fetch-paged-list'
 
 // ---------------------------------------------------------------------------
 // 后端菜单 / 角色（与 router 后端模式、用户弹窗对齐）
@@ -21,6 +22,20 @@ export function fetchGetRoleList() {
   })
 }
 
+/** 流程设计器：用户下拉选项（label=昵称，value=用户ID） */
+export function fetchUserOptions() {
+  return request.get<Array<{ label: string; value: string }>>({
+    url: '/web/admin/users/options'
+  })
+}
+
+/** 流程设计器：角色下拉选项（label=角色名，value=角色ID UUID） */
+export function fetchRoleOptions() {
+  return request.get<Array<{ label: string; value: string }>>({
+    url: '/web/admin/roles/options'
+  })
+}
+
 // ---------------------------------------------------------------------------
 // 租户（系统管理）
 // ---------------------------------------------------------------------------
@@ -219,7 +234,7 @@ export async function fetchNotDeletedRegions() {
   const cache = anyFn.__cache as undefined | { ts: number; data: Api.Region.RegionItem[] }
   if (cache && now - cache.ts < 5 * 60 * 1000) return cache.data
 
-  const pageSize = 100
+  const pageSize = MAX_ADMIN_LIST_PAGE_SIZE
   const all: Api.Region.RegionItem[] = []
   let page = 1
 
@@ -450,14 +465,20 @@ export function fetchProductBannerList(productId: string) {
   })
 }
 
-export function fetchCreateProductBanners(productId: string, items: Api.Product.ProductBannerCreate[]) {
+export function fetchCreateProductBanners(
+  productId: string,
+  items: Api.Product.ProductBannerCreate[]
+) {
   return request.post({
     url: `/web/admin/product-banners/product/${productId}`,
     params: items
   })
 }
 
-export function fetchUpdateProductBannerSort(productId: string, items: { id: string; sortOrder: number }[]) {
+export function fetchUpdateProductBannerSort(
+  productId: string,
+  items: { id: string; sortOrder: number }[]
+) {
   return request.put({
     url: `/web/admin/product-banners/product/${productId}/sort`,
     params: { items }
@@ -491,7 +512,10 @@ export function fetchCreateProductDetailMedia(
   })
 }
 
-export function fetchUpdateProductDetailMediaSort(productId: string, items: { id: string; sortOrder: number }[]) {
+export function fetchUpdateProductDetailMediaSort(
+  productId: string,
+  items: { id: string; sortOrder: number }[]
+) {
   return request.put({
     url: `/web/admin/product-detail-media/product/${productId}/sort`,
     params: { items }
@@ -526,7 +550,10 @@ export function fetchCategoryParameters(categoryId: string) {
   })
 }
 
-export function fetchUpdateCategoryParameters(categoryId: string, items: Api.Product.CategoryParameterCreate[]) {
+export function fetchUpdateCategoryParameters(
+  categoryId: string,
+  items: Api.Product.CategoryParameterCreate[]
+) {
   return request.put({
     url: `/web/admin/categories/${categoryId}/parameters`,
     params: { items }
@@ -558,11 +585,7 @@ export function fetchSaveProductParameterValues(
 // 字典类型
 // ---------------------------------------------------------------------------
 
-export function fetchDictTypeList(params?: {
-  page?: number
-  pageSize?: number
-  keyword?: string
-}) {
+export function fetchDictTypeList(params?: { page?: number; pageSize?: number; keyword?: string }) {
   return request.get<{
     list: Api.Dict.DictTypeItem[]
     total: number
@@ -703,12 +726,43 @@ export function fetchDeleteDept(id: string) {
 // ---------------------------------------------------------------------------
 
 export function fetchSiteList(params?: { page?: number; pageSize?: number; keyword?: string }) {
-  return request.get<{ list: Api.Site.SiteItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/sites', params })
+  return request.get<{
+    list: Api.Site.SiteItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({ url: '/web/admin/sites', params })
 }
-export function fetchCreateSite(data: { siteName: string; siteCode: string; siteType?: string; status?: string; address?: string; contactName?: string; contactPhone?: string; businessScope?: string; orderNum?: number; remark?: string }) {
+export function fetchCreateSite(data: {
+  siteName: string
+  siteCode: string
+  siteType?: string
+  status?: string
+  address?: string
+  contactName?: string
+  contactPhone?: string
+  businessScope?: string
+  orderNum?: number
+  remark?: string
+}) {
   return request.post({ url: '/web/admin/sites', params: data })
 }
-export function fetchUpdateSite(id: string, data: Partial<{ siteName: string; siteCode: string; siteType: string; status: string; address: string; contactName: string; contactPhone: string; businessScope: string; orderNum: number; remark: string }>) {
+export function fetchUpdateSite(
+  id: string,
+  data: Partial<{
+    siteName: string
+    siteCode: string
+    siteType: string
+    status: string
+    address: string
+    contactName: string
+    contactPhone: string
+    businessScope: string
+    orderNum: number
+    remark: string
+  }>
+) {
   return request.put({ url: `/web/admin/sites/${id}`, params: data })
 }
 export function fetchDeleteSite(id: string) {
@@ -720,46 +774,381 @@ export function fetchDeleteSite(id: string) {
 // ---------------------------------------------------------------------------
 
 export function fetchPostList(params?: { page?: number; pageSize?: number; keyword?: string }) {
-  return request.get<{ list: Api.Post.PostItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/posts', params })
+  return request.get<{
+    list: Api.Post.PostItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({ url: '/web/admin/posts', params })
 }
-export function fetchCreatePost(data: { postName: string; postCode: string; status?: string; orderNum?: number; remark?: string }) {
+export function fetchCreatePost(data: {
+  postName: string
+  postCode: string
+  status?: string
+  orderNum?: number
+  remark?: string
+}) {
   return request.post({ url: '/web/admin/posts', params: data })
 }
-export function fetchUpdatePost(id: string, data: Partial<{ postName: string; postCode: string; status: string; orderNum: number; remark: string }>) {
+export function fetchUpdatePost(
+  id: string,
+  data: Partial<{
+    postName: string
+    postCode: string
+    status: string
+    orderNum: number
+    remark: string
+  }>
+) {
   return request.put({ url: `/web/admin/posts/${id}`, params: data })
 }
 export function fetchDeletePost(id: string) {
   return request.del({ url: `/web/admin/posts/${id}` })
 }
 
+export function fetchPostBoundUserIds(postId: string) {
+  return request.get<{ userIds: string[] }>({ url: `/web/admin/posts/${postId}/users` })
+}
+
+export function fetchUpdatePostBoundUsers(postId: string, userIds: string[]) {
+  return request.put({
+    url: `/web/admin/posts/${postId}/users`,
+    params: { userIds },
+    showSuccessMessage: true
+  })
+}
+
 // ---------------------------------------------------------------------------
 // 物品单位管理
 // ---------------------------------------------------------------------------
 
 export function fetchItemUnitList(params?: { page?: number; pageSize?: number; keyword?: string }) {
-  return request.get<{ list: Api.ItemUnit.ItemUnitItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/item-units', params })
+  return request.get<{
+    list: Api.ItemUnit.ItemUnitItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({ url: '/web/admin/item-units', params })
 }
-export function fetchCreateItemUnit(data: { unitCode: string; unitName: string; orderNum?: number; remark?: string }) {
+export function fetchCreateItemUnit(data: {
+  unitCode: string
+  unitName: string
+  orderNum?: number
+  remark?: string
+}) {
   return request.post({ url: '/web/admin/item-units', params: data })
 }
-export function fetchUpdateItemUnit(id: string, data: Partial<{ unitCode: string; unitName: string; orderNum: number; remark: string }>) {
+export function fetchUpdateItemUnit(
+  id: string,
+  data: Partial<{ unitCode: string; unitName: string; orderNum: number; remark: string }>
+) {
   return request.put({ url: `/web/admin/item-units/${id}`, params: data })
 }
 export function fetchDeleteItemUnit(id: string) {
   return request.del({ url: `/web/admin/item-units/${id}` })
 }
 
+// ---------------------------------------------------------------------------
+// 基础信息管理
+// ---------------------------------------------------------------------------
+
+type PageResult<T> = {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+  totalPages: number
+}
+
+export function fetchCustomerList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<PageResult<Api.BizCustomer.CustomerItem>>({
+    url: '/web/admin/customers',
+    params
+  })
+}
+export function fetchCreateCustomer(data: {
+  customerName: string
+  sex?: string
+  idCardNo?: string
+  age?: number | null
+  phoneNo?: string
+  customerTags?: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/customers', params: data })
+}
+export function fetchUpdateCustomer(
+  id: string,
+  data: Partial<{
+    customerName: string
+    sex: string
+    idCardNo: string
+    age: number | null
+    phoneNo: string
+    customerTags: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/customers/${id}`, params: data })
+}
+export function fetchDeleteCustomer(id: string) {
+  return request.del({ url: `/web/admin/customers/${id}` })
+}
+
+export function fetchCellSampleTypeList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<PageResult<Api.BizCellSampleType.CellSampleTypeItem>>({
+    url: '/web/admin/cell-sample-types',
+    params
+  })
+}
+export function fetchCreateCellSampleType(data: {
+  typeCode: string
+  typeName: string
+  storageYears?: number | null
+  storagePrice?: number | null
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/cell-sample-types', params: data })
+}
+export function fetchUpdateCellSampleType(
+  id: string,
+  data: Partial<{
+    typeCode: string
+    typeName: string
+    storageYears: number | null
+    storagePrice: number | null
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/cell-sample-types/${id}`, params: data })
+}
+export function fetchDeleteCellSampleType(id: string) {
+  return request.del({ url: `/web/admin/cell-sample-types/${id}` })
+}
+
+export function fetchCollectionRegionList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<PageResult<Api.BizCollectionRegion.RegionItem>>({
+    url: '/web/admin/collection-regions',
+    params
+  })
+}
+export function fetchCreateCollectionRegion(data: {
+  regionName: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/collection-regions', params: data })
+}
+export function fetchUpdateCollectionRegion(
+  id: string,
+  data: Partial<{ regionName: string; orderNum: number; remark: string }>
+) {
+  return request.put({ url: `/web/admin/collection-regions/${id}`, params: data })
+}
+export function fetchDeleteCollectionRegion(id: string) {
+  return request.del({ url: `/web/admin/collection-regions/${id}` })
+}
+
+export function fetchHospitalList(
+  regionId: string,
+  params?: { page?: number; pageSize?: number; keyword?: string }
+) {
+  return request.get<PageResult<Api.BizCollectionHospital.HospitalItem>>({
+    url: `/web/admin/collection-regions/${regionId}/hospitals`,
+    params
+  })
+}
+export function fetchCreateHospital(
+  regionId: string,
+  data: { hospitalName: string; orderNum?: number; remark?: string }
+) {
+  return request.post({ url: `/web/admin/collection-regions/${regionId}/hospitals`, params: data })
+}
+export function fetchUpdateHospital(
+  regionId: string,
+  hospitalId: string,
+  data: Partial<{ hospitalName: string; orderNum: number; remark: string }>
+) {
+  return request.put({
+    url: `/web/admin/collection-regions/${regionId}/hospitals/${hospitalId}`,
+    params: data
+  })
+}
+export function fetchDeleteHospital(regionId: string, hospitalId: string) {
+  return request.del({ url: `/web/admin/collection-regions/${regionId}/hospitals/${hospitalId}` })
+}
+
+export function fetchCollectionProtocolNoList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<PageResult<Api.BizCollectionProtocolNo.ProtocolNoItem>>({
+    url: '/web/admin/collection-protocol-nos',
+    params
+  })
+}
+export function fetchCreateCollectionProtocolNo(data: {
+  protocolNo: string
+  issued?: number
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/collection-protocol-nos', params: data })
+}
+export function fetchUpdateCollectionProtocolNo(
+  id: string,
+  data: Partial<{ protocolNo: string; issued: number; orderNum: number; remark: string }>
+) {
+  return request.put({ url: `/web/admin/collection-protocol-nos/${id}`, params: data })
+}
+export function fetchDeleteCollectionProtocolNo(id: string) {
+  return request.del({ url: `/web/admin/collection-protocol-nos/${id}` })
+}
+
+export function fetchBatchGenerateProtocolNos(data: {
+  prefix: string
+  middle: string
+  seqStart: number
+  seqEnd: number
+  digitCount?: number
+}) {
+  return request.post({
+    url: '/web/admin/collection-protocol-nos/batch-generate',
+    params: data,
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+
+export function fetchBatchIssueProtocolNos(data: {
+  ids: string[]
+  issuedUserId: string
+  issuedUserName?: string
+}) {
+  return request.post({
+    url: '/web/admin/collection-protocol-nos/batch-issue',
+    params: data,
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+
+export function fetchBatchRevokeProtocolNos(ids: string[]) {
+  return request.post({
+    url: '/web/admin/collection-protocol-nos/batch-revoke',
+    params: { ids },
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+
+export function fetchSampleCodeList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<PageResult<Api.BizSampleCode.SampleCodeItem>>({
+    url: '/web/admin/sample-codes',
+    params
+  })
+}
+export function fetchCreateSampleCode(data: {
+  sampleCode: string
+  issued?: number
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/sample-codes', params: data })
+}
+export function fetchUpdateSampleCode(
+  id: string,
+  data: Partial<{ sampleCode: string; issued: number; orderNum: number; remark: string }>
+) {
+  return request.put({ url: `/web/admin/sample-codes/${id}`, params: data })
+}
+export function fetchDeleteSampleCode(id: string) {
+  return request.del({ url: `/web/admin/sample-codes/${id}` })
+}
+export function fetchBatchGenerateSampleCodes(data: {
+  sampleCodeType: string
+  middle: string
+  seqStart: number
+  seqEnd: number
+  digitCount?: number
+}) {
+  return request.post({
+    url: '/web/admin/sample-codes/batch-generate',
+    params: data,
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+export function fetchBatchIssueSampleCodes(data: {
+  ids: string[]
+  issuedUserId: string
+  issuedUserName?: string
+}) {
+  return request.post({
+    url: '/web/admin/sample-codes/batch-issue',
+    params: data,
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+
+export function fetchBatchRevokeSampleCodes(ids: string[]) {
+  return request.post({
+    url: '/web/admin/sample-codes/batch-revoke',
+    params: { ids },
+    showSuccessMessage: true,
+    timeout: 120_000
+  })
+}
+
 // ---------------------------------------------------------------------------
 // 快递公司管理
 // ---------------------------------------------------------------------------
 
-export function fetchExpressCompanyList(params?: { page?: number; pageSize?: number; keyword?: string }) {
-  return request.get<{ list: Api.ExpressCompany.ExpressCompanyItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/express-companies', params })
+export function fetchExpressCompanyList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.ExpressCompany.ExpressCompanyItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({ url: '/web/admin/express-companies', params })
 }
-export function fetchCreateExpressCompany(data: { expressCode: string; expressName: string; orderNum?: number; remark?: string }) {
+export function fetchCreateExpressCompany(data: {
+  expressCode: string
+  expressName: string
+  orderNum?: number
+  remark?: string
+}) {
   return request.post({ url: '/web/admin/express-companies', params: data })
 }
-export function fetchUpdateExpressCompany(id: string, data: Partial<{ expressCode: string; expressName: string; orderNum: number; remark: string }>) {
+export function fetchUpdateExpressCompany(
+  id: string,
+  data: Partial<{ expressCode: string; expressName: string; orderNum: number; remark: string }>
+) {
   return request.put({ url: `/web/admin/express-companies/${id}`, params: data })
 }
 export function fetchDeleteExpressCompany(id: string) {
@@ -821,13 +1210,38 @@ export function fetchDeleteMenu(id: string) {
 // ---------------------------------------------------------------------------
 
 export function fetchRoleList(params?: { page?: number; pageSize?: number; keyword?: string }) {
-  return request.get<{ list: Api.Role.RoleItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/role-management', params })
+  return request.get<{
+    list: Api.Role.RoleItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({ url: '/web/admin/role-management', params })
 }
-export function fetchCreateRole(data: { roleName: string; dataScope?: string; status?: string; orderNum?: number; remark?: string }) {
+export function fetchCreateRole(data: {
+  roleName: string
+  dataScope?: string
+  status?: string
+  orderNum?: number
+  remark?: string
+}) {
   return request.post({ url: '/web/admin/role-management', params: data, showSuccessMessage: true })
 }
-export function fetchUpdateRole(id: string, data: Partial<{ roleName: string; dataScope: string; status: string; orderNum: number; remark: string }>) {
-  return request.put({ url: `/web/admin/role-management/${id}`, params: data, showSuccessMessage: true })
+export function fetchUpdateRole(
+  id: string,
+  data: Partial<{
+    roleName: string
+    dataScope: string
+    status: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({
+    url: `/web/admin/role-management/${id}`,
+    params: data,
+    showSuccessMessage: true
+  })
 }
 export function fetchDeleteRole(id: string) {
   return request.del({ url: `/web/admin/role-management/${id}`, showSuccessMessage: true })
@@ -836,11 +1250,121 @@ export function fetchRoleMenuIds(roleId: string) {
   return request.get<{ menuIds: string[] }>({ url: `/web/admin/role-management/${roleId}/menus` })
 }
 export function fetchUpdateRoleMenus(roleId: string, menuIds: string[]) {
-  return request.put({ url: `/web/admin/role-management/${roleId}/menus`, params: { menuIds }, showSuccessMessage: true })
+  return request.put({
+    url: `/web/admin/role-management/${roleId}/menus`,
+    params: { menuIds },
+    showSuccessMessage: true
+  })
 }
 export function fetchRoleDataScope(roleId: string) {
-  return request.get<{ dataScope: string; scopeDetails: Array<{ scopeType: string; scopeValue: string }> }>({ url: `/web/admin/role-management/${roleId}/data-scope` })
+  return request.get<{
+    dataScope: string
+    scopeDetails: Array<{ scopeType: string; scopeValue: string }>
+  }>({ url: `/web/admin/role-management/${roleId}/data-scope` })
 }
-export function fetchUpdateRoleDataScope(roleId: string, data: { dataScope: string; scopeDetails?: Array<{ scopeType: string; scopeValue: string }> }) {
-  return request.put({ url: `/web/admin/role-management/${roleId}/data-scope`, params: data, showSuccessMessage: true })
+export function fetchUpdateRoleDataScope(
+  roleId: string,
+  data: { dataScope: string; scopeDetails?: Array<{ scopeType: string; scopeValue: string }> }
+) {
+  return request.put({
+    url: `/web/admin/role-management/${roleId}/data-scope`,
+    params: data,
+    showSuccessMessage: true
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 洁净室管理
+// ---------------------------------------------------------------------------
+
+export function fetchCleanRoomList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get({ url: '/web/admin/clean-rooms', params })
+}
+
+export function fetchCreateCleanRoom(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/clean-rooms', params: data })
+}
+
+export function fetchUpdateCleanRoom(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/clean-rooms/${id}`, params: data })
+}
+
+export function fetchDeleteCleanRoom(id: string) {
+  return request.del({ url: `/web/admin/clean-rooms/${id}` })
+}
+
+export function fetchAccessLogList(params?: { page?: number; pageSize?: number; cleanRoomId?: string; keyword?: string }) {
+  return request.get({ url: '/web/admin/clean-room-access-logs', params })
+}
+
+export function fetchCreateAccessLog(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/clean-room-access-logs', params: data })
+}
+
+export function fetchUpdateAccessLog(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/clean-room-access-logs/${id}`, params: data })
+}
+
+export function fetchDeleteAccessLog(id: string) {
+  return request.del({ url: `/web/admin/clean-room-access-logs/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 库位管理
+// ---------------------------------------------------------------------------
+
+export function fetchStorageFacilityList(params?: { keyword?: string }) {
+  return request.get({ url: '/web/admin/storage-facilities', params })
+}
+
+export function fetchCreateStorageFacility(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/storage-facilities', params: data })
+}
+
+export function fetchUpdateStorageFacility(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/storage-facilities/${id}`, params: data })
+}
+
+export function fetchDeleteStorageFacility(id: string) {
+  return request.del({ url: `/web/admin/storage-facilities/${id}` })
+}
+
+export function fetchStorageSlotList(params?: { facilityNodeId?: string }) {
+  return request.get({ url: '/web/admin/storage-facility-slots', params })
+}
+
+export function fetchCreateStorageSlot(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/storage-facility-slots', params: data })
+}
+
+export function fetchBatchCreateSlots(data: { facilityNodeId: string; rows: number; cols: number; codePrefix?: string }) {
+  return request.post({ url: '/web/admin/storage-facility-slots/batch', params: data })
+}
+
+export function fetchUpdateStorageSlot(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/storage-facility-slots/${id}`, params: data })
+}
+
+export function fetchDeleteStorageSlot(id: string) {
+  return request.del({ url: `/web/admin/storage-facility-slots/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 展馆预约
+// ---------------------------------------------------------------------------
+
+export function fetchExhibitionAppointmentList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get({ url: '/web/admin/exhibition-appointments', params })
+}
+
+export function fetchCreateExhibitionAppointment(data: Record<string, any>) {
+  return request.post({ url: '/web/admin/exhibition-appointments', params: data })
+}
+
+export function fetchUpdateExhibitionAppointment(id: string, data: Record<string, any>) {
+  return request.put({ url: `/web/admin/exhibition-appointments/${id}`, params: data })
+}
+
+export function fetchDeleteExhibitionAppointment(id: string) {
+  return request.del({ url: `/web/admin/exhibition-appointments/${id}` })
 }
diff --git a/web-admin/src/api/collection-protocol.ts b/web-admin/src/api/collection-protocol.ts
new file mode 100644
index 00000000..7f8d2695
--- /dev/null
+++ b/web-admin/src/api/collection-protocol.ts
@@ -0,0 +1,134 @@
+import request from '@/utils/http'
+
+type PageList<T> = {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+  totalPages: number
+}
+
+/** 采集协议单列表项（camelCase，与后端一致） */
+export type CollectionProtocolRow = Record<string, unknown>
+
+export function fetchCollectionProtocolList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  protocolStatus?: string
+}) {
+  return request.get<PageList<CollectionProtocolRow>>({
+    url: '/web/admin/collection-protocols',
+    params
+  })
+}
+
+export function fetchCollectionProtocolDetail(id: string) {
+  return request.get<{
+    protocol: Record<string, unknown>
+    partyCustomer: Record<string, unknown> | null
+    collectionInfo: Record<string, unknown> | null
+    samples: Array<Record<string, unknown>> | null
+    payment: Record<string, unknown> | null
+    paymentDetails: Array<Record<string, unknown>> | null
+    attachments?: Array<Record<string, unknown>>
+  }>({
+    url: `/web/admin/collection-protocols/${id}`
+  })
+}
+
+export function fetchCollectionProtocolAuditList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  auditStatus?: string
+}) {
+  return request.get<PageList<Record<string, unknown>>>({
+    url: '/web/admin/collection-protocol-audits',
+    params
+  })
+}
+
+export function fetchSubmitProtocolAudit(
+  protocolId: string,
+  data: { auditStatus: string; auditRemark?: string }
+) {
+  return request.post({
+    url: `/web/admin/collection-protocols/${protocolId}/audit`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchReceiptConfirmList(params?: { page?: number; pageSize?: number }) {
+  return request.get<PageList<Record<string, unknown>>>({
+    url: '/web/admin/protocol-payment-details/receipt-confirm',
+    params
+  })
+}
+
+export function fetchReceiptConfirmSubmit(
+  detailId: string,
+  data?: { financeConfirmAttachments?: string }
+) {
+  return request.post({
+    url: `/web/admin/protocol-payment-details/${detailId}/receipt-confirm`,
+    data: data || {},
+    showSuccessMessage: true
+  })
+}
+
+export function fetchRefundConfirmList(params?: { page?: number; pageSize?: number }) {
+  return request.get<PageList<Record<string, unknown>>>({
+    url: '/web/admin/protocol-payment-details/refund-confirm',
+    params
+  })
+}
+
+export function fetchRefundConfirmSubmit(
+  detailId: string,
+  data?: { financeConfirmAttachments?: string }
+) {
+  return request.post({
+    url: `/web/admin/protocol-payment-details/${detailId}/refund-confirm`,
+    data: data || {},
+    showSuccessMessage: true
+  })
+}
+
+export function fetchInstallmentWarningList(params?: {
+  page?: number
+  pageSize?: number
+  warningType?: string
+}) {
+  return request.get<PageList<Record<string, unknown>>>({
+    url: '/web/admin/protocol-payment-details/installment-warning',
+    params
+  })
+}
+
+export function fetchCreateCollectionProtocol(data: Record<string, unknown>) {
+  return request.post({
+    url: '/web/admin/collection-protocols',
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchUpdateCollectionProtocol(
+  id: string,
+  data: Record<string, unknown>
+) {
+  return request.put({
+    url: `/web/admin/collection-protocols/${id}`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchDeleteCollectionProtocol(id: string) {
+  return request.del({
+    url: `/web/admin/collection-protocols/${id}`,
+    showSuccessMessage: true
+  })
+}
diff --git a/web-admin/src/api/ethnic.ts b/web-admin/src/api/ethnic.ts
new file mode 100644
index 00000000..08c1a501
--- /dev/null
+++ b/web-admin/src/api/ethnic.ts
@@ -0,0 +1,15 @@
+import request from '@/utils/http'
+
+export type EthnicOption = {
+  id: string
+  ethnicName: string
+  ethnicCode: string
+  orderNum?: number | null
+}
+
+export function fetchEthnicList(params?: { keyword?: string; limit?: number }) {
+  return request.get<{ list: EthnicOption[] }>({
+    url: '/web/admin/ethnics',
+    params
+  })
+}
diff --git a/web-admin/src/api/leave.ts b/web-admin/src/api/leave.ts
new file mode 100644
index 00000000..cf837be6
--- /dev/null
+++ b/web-admin/src/api/leave.ts
@@ -0,0 +1,78 @@
+import request from '@/utils/http'
+
+/** 请假申请列表 */
+export function fetchLeaveList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  status?: string
+}) {
+  return request.get<{
+    list: Api.Leave.LeaveItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/leave',
+    params
+  })
+}
+
+/** 创建请假申请 */
+export function fetchCreateLeave(data: {
+  leaveType: string
+  startDate: string
+  endDate: string
+  days: number
+  reason?: string
+  remark?: string
+}) {
+  return request.post<Api.Leave.LeaveItem>({
+    url: '/web/admin/leave',
+    data,
+    showSuccessMessage: true
+  })
+}
+
+/** 编辑请假申请 */
+export function fetchUpdateLeave(
+  id: string,
+  data: Partial<{
+    leaveType: string
+    startDate: string
+    endDate: string
+    days: number
+    reason: string
+    remark: string
+  }>
+) {
+  return request.put<Api.Leave.LeaveItem>({
+    url: `/web/admin/leave/${id}`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+/** 删除请假申请 */
+export function fetchDeleteLeave(id: string) {
+  return request.del({
+    url: `/web/admin/leave/${id}`,
+    showSuccessMessage: true
+  })
+}
+
+/** 提交请假申请并发起审批 */
+export function fetchSubmitLeave(id: string) {
+  return request.post<{ instanceId: string; status: string }>({
+    url: `/web/admin/leave/${id}/submit`,
+    showSuccessMessage: true
+  })
+}
+
+/** 请假详情 */
+export function fetchLeaveDetail(id: string) {
+  return request.get<Api.Leave.LeaveItem>({
+    url: `/web/admin/leave/${id}`
+  })
+}
diff --git a/web-admin/src/api/workflow.ts b/web-admin/src/api/workflow.ts
new file mode 100644
index 00000000..f2ec1b03
--- /dev/null
+++ b/web-admin/src/api/workflow.ts
@@ -0,0 +1,206 @@
+import request from '@/utils/http'
+
+// ---------------------------------------------------------------------------
+// 流程定义
+// ---------------------------------------------------------------------------
+
+export function fetchProcessDefList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  status?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.ProcessDefItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/defs',
+    params
+  })
+}
+
+export function fetchCreateProcessDef(data: {
+  processCode: string
+  processName: string
+  status?: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post<Api.Workflow.ProcessDefItem>({
+    url: '/web/admin/workflow/defs',
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchUpdateProcessDef(
+  id: string,
+  data: Partial<{
+    processCode: string
+    processName: string
+    status: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put<Api.Workflow.ProcessDefItem>({
+    url: `/web/admin/workflow/defs/${id}`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchDeleteProcessDef(id: string) {
+  return request.del({
+    url: `/web/admin/workflow/defs/${id}`,
+    showSuccessMessage: true
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 发布版本
+// ---------------------------------------------------------------------------
+
+export function fetchPublishVersion(
+  defId: string,
+  data: {
+    graphJson: string
+    nodes: Array<{
+      nodeKey: string
+      nodeType: string
+      nodeName?: string | null
+      configJson?: string | null
+    }>
+    transitions: Array<{
+      fromNodeKey: string
+      toNodeKey: string
+      conditionExpr?: string | null
+    }>
+    remark?: string
+  }
+) {
+  return request.post({
+    url: `/web/admin/workflow/defs/${defId}/publish`,
+    data,
+  })
+}
+
+export function fetchVersionList(defId: string) {
+  return request.get<Api.Workflow.VersionItem[]>({
+    url: `/web/admin/workflow/defs/${defId}/versions`
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 设计器数据
+// ---------------------------------------------------------------------------
+
+export function fetchDesignerData(defId: string) {
+  return request.get<Api.Workflow.DesignerData>({
+    url: `/web/admin/workflow/defs/${defId}/designer`
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 流程实例
+// ---------------------------------------------------------------------------
+
+export function fetchStartInstance(data: {
+  processCode: string
+  businessType?: string
+  businessId?: string
+  variables?: Record<string, any>
+  callbackUrl?: string
+}) {
+  return request.post<{ instanceId: string }>({
+    url: '/web/admin/workflow/instances',
+    data
+  })
+}
+
+export function fetchInstanceDetail(instanceId: string) {
+  return request.get<Api.Workflow.InstanceDetail>({
+    url: `/web/admin/workflow/instances/${instanceId}`
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 任务办理
+// ---------------------------------------------------------------------------
+
+export function fetchPendingTasks(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.TaskItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/tasks/pending',
+    params
+  })
+}
+
+export function fetchCompletedTasks(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.TaskItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/tasks/completed',
+    params
+  })
+}
+
+export function fetchApproveTask(taskId: string, data?: { commentText?: string }) {
+  return request.post({
+    url: `/web/admin/workflow/tasks/${taskId}/approve`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchRejectTask(taskId: string, data?: { commentText?: string }) {
+  return request.post({
+    url: `/web/admin/workflow/tasks/${taskId}/reject`,
+    data,
+    showSuccessMessage: true
+  })
+}
+
+export function fetchMyInstances(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+  status?: string
+}) {
+  return request.get<{
+    list: Api.Workflow.MyInstanceItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/workflow/instances/my',
+    params
+  })
+}
+
+export function fetchBusinessAllTasks(businessType: string, businessId: string) {
+  return request.get<Api.Workflow.BusinessAllTasks>({
+    url: `/web/admin/workflow/instances/by-business/${businessType}/${businessId}`
+  })
+}
diff --git a/web-admin/src/assets/styles/core/app.scss b/web-admin/src/assets/styles/core/app.scss
index f233dbed..21ee0215 100755
--- a/web-admin/src/assets/styles/core/app.scss
+++ b/web-admin/src/assets/styles/core/app.scss
@@ -548,6 +548,7 @@ body {
     padding: 10px 16px 12px;
     border-top: 1px solid var(--mint-border);
     background: var(--mint-surface);
+    border-radius: 0 0 var(--mint-radius) var(--mint-radius);
   }
 
   .pagination {
@@ -657,6 +658,13 @@ body {
   font-size: 12px;
 }
 
+.form-label-tip {
+  margin-left: 4px;
+  color: var(--mint-text-muted);
+  font-size: 12px;
+  font-weight: 400;
+}
+
 @media (max-width: 900px) {
   .form-grid-3 {
     grid-template-columns: repeat(2, minmax(0, 1fr));
@@ -714,7 +722,8 @@ body {
   gap: 10px !important;
 }
 
-#app-header .flex-b.w-full {
+#app-header .flex-b.w-full,
+#app-header .worktab-strip.w-full {
   margin-bottom: 0 !important;
   padding: 0 24px 10px !important;
 }
diff --git a/web-admin/src/assets/styles/core/el-light.scss b/web-admin/src/assets/styles/core/el-light.scss
index ddf2bc54..f76b6acd 100644
--- a/web-admin/src/assets/styles/core/el-light.scss
+++ b/web-admin/src/assets/styles/core/el-light.scss
@@ -1,12 +1,13 @@
 // https://github.com/element-plus/element-plus/blob/dev/packages/theme-chalk/src/common/var.scss
 // 自定义Element 亮色主题
+// success 与 Fresh Mint 主色一致（见 fresh-mint-tokens.scss --mint-primary），便于 Message/Tag/Button 等语义统一
 
 @forward 'element-plus/theme-chalk/src/common/var.scss' with (
   $colors: (
     'white': #ffffff,
     'black': #000000,
     'success': (
-      'base': #13deb9
+      'base': #10b981
     ),
     'warning': (
       'base': #ffae1f
diff --git a/web-admin/src/assets/styles/core/el-ui.scss b/web-admin/src/assets/styles/core/el-ui.scss
index b871eb87..f1489c90 100644
--- a/web-admin/src/assets/styles/core/el-ui.scss
+++ b/web-admin/src/assets/styles/core/el-ui.scss
@@ -50,6 +50,14 @@
   line-height: var(--el-component-custom-height) !important;
 }
 
+// label-top 弹窗表单：13px 深色标签
+.el-form--label-top .el-form-item__label {
+  font-size: 13px !important;
+  font-weight: 500 !important;
+  color: var(--mint-text) !important;
+  padding: 0 0 4px !important;
+}
+
 // 日期选择器
 .el-date-range-picker {
   --el-datepicker-inrange-bg-color: var(--art-gray-200) !important;
@@ -636,16 +644,37 @@ body .el-table thead {
 }
 
 // 全局：列表表格内容居中展示（表头 + 单元格）
+// 列上设置 align / header-align 时，Element Plus 会加 is-left、is-right，须高于默认居中
 .el-table {
   th.el-table__cell,
   td.el-table__cell {
     text-align: center;
   }
 
+  th.el-table__cell.is-left,
+  td.el-table__cell.is-left {
+    text-align: left;
+  }
+
+  th.el-table__cell.is-right,
+  td.el-table__cell.is-right {
+    text-align: right;
+  }
+
   th.el-table__cell > .cell,
   td.el-table__cell > .cell {
     justify-content: center;
   }
+
+  th.el-table__cell.is-left > .cell,
+  td.el-table__cell.is-left > .cell {
+    justify-content: flex-start;
+  }
+
+  th.el-table__cell.is-right > .cell,
+  td.el-table__cell.is-right > .cell {
+    justify-content: flex-end;
+  }
 }
 // -------------------------------- el-table 全局样式 end --------------------------------
 
@@ -800,6 +829,31 @@ body .el-table thead {
 .el-cascader__suggestion-panel,
 .el-tree-select__popper {
   --el-text-color-placeholder: #9ca3af !important;
+  --el-select-multiple-input-color: #9ca3af !important;
+}
+
+/* 已选中值（placeholder 无 is-transparent）：保持正文深色 */
+.page-container .el-select__placeholder:not(.is-transparent),
+.console-container .el-select__placeholder:not(.is-transparent),
+.el-select__placeholder:not(.is-transparent) {
+  color: var(--mint-text) !important;
+  -webkit-text-fill-color: var(--mint-text) !important;
+}
+
+/* 已选值：必须保持正文深色，确保在 page-container / console-container 作用域下也正确 */
+.page-container .el-select .el-select__selected-item,
+.console-container .el-select .el-select__selected-item,
+.el-select .el-select__selected-item {
+  color: var(--mint-text) !important;
+  -webkit-text-fill-color: var(--mint-text) !important;
+}
+
+/* 未选中时 placeholder（is-transparent）应为灰色，区别于已选值 */
+.page-container .el-select__placeholder.is-transparent,
+.console-container .el-select__placeholder.is-transparent,
+.el-select__placeholder.is-transparent {
+  color: #9ca3af !important;
+  -webkit-text-fill-color: #9ca3af !important;
 }
 
 // 兜底：页面内原生 input/textarea placeholder（避免自绘控件不走 Element）
diff --git a/web-admin/src/components/business/system-view-dialog/index.vue b/web-admin/src/components/business/system-view-dialog/index.vue
new file mode 100644
index 00000000..0de14ac1
--- /dev/null
+++ b/web-admin/src/components/business/system-view-dialog/index.vue
@@ -0,0 +1,211 @@
+<!-- 通用查看弹窗 —— 样式对齐待办中心「查看详情」 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <el-dialog
+    v-model="innerVisible"
+    width="720px"
+    class="system-view-dialog"
+    align-center
+    destroy-on-close
+    :show-close="false"
+    style="backdrop-filter: none"
+  >
+    <div class="dialog-scroll">
+      <!-- hero -->
+      <div class="view-hero">
+        <div class="view-hero-icon">
+          <el-icon :size="28"><component :is="iconComponent" /></el-icon>
+        </div>
+        <div class="view-hero-main">
+          <h2>{{ title }}</h2>
+          <p v-if="meta" class="view-hero-meta">{{ meta }}</p>
+        </div>
+      </div>
+
+      <!-- sections -->
+      <div v-for="section in sections" :key="section.title" class="view-section">
+        <h3>{{ section.title }}</h3>
+        <dl class="view-kv-grid">
+          <div
+            v-for="field in section.fields"
+            :key="field.label"
+            class="view-kv"
+            :class="{ 'view-kv-span-2': field.span }"
+          >
+            <dt>{{ field.label }}</dt>
+            <dd>{{ field.value ?? '—' }}</dd>
+          </div>
+        </dl>
+      </div>
+    </div>
+
+    <template #footer>
+      <el-button class="btn-ghost" @click="innerVisible = false">
+        <el-icon><Close /></el-icon>关闭
+      </el-button>
+    </template>
+  </el-dialog>
+</template>
+
+<script setup lang="ts">
+  import { computed, type Component } from 'vue'
+  import { Close } from '@element-plus/icons-vue'
+
+  export interface ViewField {
+    label: string
+    value: string | number | boolean | null | undefined
+    span?: boolean
+  }
+
+  export interface ViewSection {
+    title: string
+    fields: ViewField[]
+  }
+
+  const props = defineProps<{
+    visible: boolean
+    title: string
+    icon?: Component
+    meta?: string
+    sections: ViewSection[]
+  }>()
+
+  const emit = defineEmits<{
+    (e: 'update:visible', val: boolean): void
+  }>()
+
+  const innerVisible = computed({
+    get: () => props.visible,
+    set: (val) => emit('update:visible', val)
+  })
+
+  const iconComponent = computed(() => props.icon || (() => null))
+</script>
+
+<style scoped lang="scss">
+  .dialog-scroll {
+    overflow-y: auto;
+    max-height: calc(100vh - 120px);
+  }
+
+  .view-hero {
+    display: flex;
+    gap: 16px;
+    padding: 20px 22px;
+    background: linear-gradient(135deg, #ecfdf5 0%, #ffffff 55%);
+    border-bottom: 1px solid #d9e8e2;
+    align-items: center;
+  }
+
+  .view-hero-icon {
+    width: 72px;
+    height: 72px;
+    border-radius: 12px;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.08);
+    color: #059669;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  .view-hero-main {
+    flex: 1;
+    min-width: 0;
+
+    h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 700;
+      color: #1e293b;
+      letter-spacing: -0.02em;
+    }
+  }
+
+  .view-hero-meta {
+    margin: 0;
+    font-size: 13px;
+    color: #64748b;
+    line-height: 1.5;
+  }
+
+  .view-section {
+    padding: 18px 22px;
+    border-bottom: 1px solid #ebeef5;
+
+    &:last-child {
+      border-bottom: none;
+    }
+
+    h3 {
+      margin: 0 0 14px;
+      padding-left: 10px;
+      font-size: 14px;
+      font-weight: 600;
+      color: #1e293b;
+      border-left: 3px solid #10b981;
+      line-height: 1;
+    }
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: 96px 1fr;
+    gap: 8px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  .view-kv-span-2 {
+    grid-column: 1 / -1;
+  }
+
+  @media (max-width: 640px) {
+    .view-kv-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .view-kv {
+      grid-template-columns: 1fr;
+      gap: 4px;
+    }
+  }
+</style>
+
+<style lang="scss">
+  .system-view-dialog {
+    .el-dialog__header {
+      display: none;
+    }
+
+    .el-dialog__body {
+      padding: 0;
+      overflow: hidden;
+    }
+
+    .el-dialog__footer {
+      padding: 12px 22px;
+      border-top: 1px solid #d9e8e2;
+      background: #f8fafc;
+    }
+  }
+</style>
diff --git a/web-admin/src/components/core/forms/art-form/index.vue b/web-admin/src/components/core/forms/art-form/index.vue
index 561e878a..226c090d 100644
--- a/web-admin/src/components/core/forms/art-form/index.vue
+++ b/web-admin/src/components/core/forms/art-form/index.vue
@@ -107,7 +107,6 @@
     ElDatePicker,
     ElInput,
     ElInputTag,
-    ElInputNumber,
     ElRadioGroup,
     ElRate,
     ElSelect,
@@ -125,7 +124,7 @@
   const componentMap = {
     input: ElInput, // 输入框
     inputtag: ElInputTag, // 标签输入框
-    number: ElInputNumber, // 数字输入框
+    number: ElInput, // 数字输入框
     select: ElSelect, // 选择器
     switch: ElSwitch, // 开关
     checkbox: ElCheckbox, // 复选框
@@ -414,9 +413,22 @@
   }
 
   const getProps = (item: FormItem) => {
-    if (item.props) return item.props
+    if (item.props) {
+      // number 类型使用 ElInput 渲染时需要注入 type="number"
+      if (item.type === 'number') {
+        return { type: 'number', step: 'any', ...item.props }
+      }
+      return item.props
+    }
     const props = { ...item }
     rootProps.forEach((key) => delete (props as Record<string, any>)[key])
+    // number 类型使用 ElInput 渲染时需要注入 type="number"
+    if (item.type === 'number') {
+      ;(props as Record<string, any>).type = 'number'
+      if (!(props as Record<string, any>).step) {
+        ;(props as Record<string, any>).step = 'any'
+      }
+    }
     return props
   }
 
diff --git a/web-admin/src/components/core/forms/art-search-bar/index.vue b/web-admin/src/components/core/forms/art-search-bar/index.vue
index 6786dcaa..56641b61 100644
--- a/web-admin/src/components/core/forms/art-search-bar/index.vue
+++ b/web-admin/src/components/core/forms/art-search-bar/index.vue
@@ -114,7 +114,6 @@
     ElDatePicker,
     ElInput,
     ElInputTag,
-    ElInputNumber,
     ElRadioGroup,
     ElRate,
     ElSelect,
@@ -132,7 +131,7 @@
   const componentMap = {
     input: ElInput, // 输入框
     inputTag: ElInputTag, // 标签输入框
-    number: ElInputNumber, // 数字输入框
+    number: ElInput, // 数字输入框
     select: ElSelect, // 选择器
     switch: ElSwitch, // 开关
     checkbox: ElCheckbox, // 复选框
@@ -297,9 +296,22 @@
   }))
 
   const getProps = (item: SearchFormItem) => {
-    if (item.props) return item.props
+    if (item.props) {
+      // number 类型使用 ElInput 渲染时需要注入 type="number"
+      if (item.type === 'number') {
+        return { type: 'number', step: 'any', ...item.props }
+      }
+      return item.props
+    }
     const props = { ...item }
     rootProps.forEach((key) => delete (props as Record<string, any>)[key])
+    // number 类型使用 ElInput 渲染时需要注入 type="number"
+    if (item.type === 'number') {
+      ;(props as Record<string, any>).type = 'number'
+      if (!(props as Record<string, any>).step) {
+        ;(props as Record<string, any>).step = 'any'
+      }
+    }
     return props
   }
 
diff --git a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue
index bd07d561..067ef6ae 100644
--- a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue
+++ b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue
@@ -36,12 +36,20 @@
                 }"
               >
                 <ArtSvgIcon
+                  v-if="menu.meta.icon"
                   class="menu-icon text-g-700 dark:text-g-800"
                   :icon="menu.meta.icon"
                   :style="{
                     marginBottom: dualMenuShowText ? '5px' : '0'
                   }"
                 />
+                <div
+                  v-else
+                  class="dual-menu-icon-placeholder"
+                  :style="{
+                    marginBottom: dualMenuShowText ? '5px' : '0'
+                  }"
+                />
                 <span v-if="dualMenuShowText" class="text-md text-g-700">
                   {{ $t(menu.meta.title) }}
                 </span>
diff --git a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss
index 5ef5ad4a..c3f54c3b 100755
--- a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss
+++ b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss
@@ -55,6 +55,14 @@
             font-size: 20px;
           }
 
+          .dual-menu-icon-placeholder {
+            display: block;
+            flex-shrink: 0;
+            width: 20px;
+            height: 20px;
+            margin: 0 auto;
+          }
+
           span {
             display: -webkit-box;
             width: 100%;
diff --git a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss
index 5dafa724..c3317dd2 100644
--- a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss
+++ b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss
@@ -112,12 +112,25 @@ $popup-menu-radius: 6px;
     }
   }
 
-  // 菜单图标
+  // 菜单图标（固定槽宽，无 icon 的一级项用空槽与文字对齐）
   .menu-icon {
+    box-sizing: border-box;
+    flex-shrink: 0;
+    width: $menu-icon-size;
+    min-width: $menu-icon-size;
+    height: $menu-icon-size;
     margin-right: 8px;
     font-size: $menu-icon-size;
   }
 
+  .menu-icon__virtual {
+    display: block;
+    flex: 0 0 0;
+    width: 0;
+    height: 0;
+    overflow: hidden;
+  }
+
   // 菜单高度
   .el-sub-menu__title,
   .el-menu-item {
diff --git a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue
index 12cd7d94..7a8853ff 100755
--- a/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue
+++ b/web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue
@@ -2,12 +2,17 @@
   <template v-for="(item, index) in filteredMenuItems" :key="getUniqueKey(item, index)">
     <ElSubMenu v-if="hasChildren(item)" :index="item.path || item.meta.title" :level="level">
       <template #title>
-        <div v-if="level === 0" class="menu-icon flex-cc">
+        <div
+          v-if="level === 0 && (item.meta.icon || item.meta.virtualMenuIcon)"
+          class="menu-icon flex-cc"
+        >
           <ArtSvgIcon
+            v-if="item.meta.icon"
             :icon="item.meta.icon"
             :color="theme?.iconColor"
             :style="{ color: theme.iconColor }"
           />
+          <span v-else class="menu-icon__virtual" aria-hidden="true" />
         </div>
         <span class="menu-name">
           {{ formatMenuTitle(item.meta.title) }}
@@ -30,12 +35,17 @@
       :level-item="level + 1"
       @click="goPage(item)"
     >
-      <div v-if="level === 0" class="menu-icon flex-cc">
+      <div
+        v-if="level === 0 && (item.meta.icon || item.meta.virtualMenuIcon)"
+        class="menu-icon flex-cc"
+      >
         <ArtSvgIcon
+          v-if="item.meta.icon"
           :icon="item.meta.icon"
           :color="theme?.iconColor"
           :style="{ color: theme.iconColor }"
         />
+        <span v-else class="menu-icon__virtual" aria-hidden="true" />
       </div>
       <div
         v-show="item.meta.showBadge && level === 0 && !menuOpen"
diff --git a/web-admin/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue b/web-admin/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue
index 57210275..2eb6c8ee 100644
--- a/web-admin/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue
+++ b/web-admin/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue
@@ -6,15 +6,15 @@
     <ElSwitch v-if="config.type === 'switch'" :model-value="modelValue" @change="handleChange" />
 
     <!-- 数字输入类型 -->
-    <ElInputNumber
+    <ElInput
+      type="number"
+      step="any"
       v-else-if="config.type === 'input-number'"
       :model-value="modelValue"
       :min="config.min"
       :max="config.max"
-      :step="config.step"
       :style="config.style"
-      :controls-position="config.controlsPosition"
-      @change="handleChange"
+      @input="handleChange"
     />
 
     <!-- 选择器类型 -->
diff --git a/web-admin/src/components/core/layouts/art-work-tab/index.vue b/web-admin/src/components/core/layouts/art-work-tab/index.vue
index 3b253c45..c49caf96 100644
--- a/web-admin/src/components/core/layouts/art-work-tab/index.vue
+++ b/web-admin/src/components/core/layouts/art-work-tab/index.vue
@@ -2,9 +2,9 @@
 <template>
   <div
     v-if="showWorkTab"
-    class="worktab-strip box-border flex-b w-full px-5 mb-3 select-none max-sm:px-[15px]"
+    class="worktab-strip box-border flex w-full items-center px-5 mb-3 select-none max-sm:px-[15px]"
   >
-    <div class="worktab-scroll-wrap w-full" ref="scrollRef">
+    <div class="worktab-scroll-wrap min-w-0 flex-1" ref="scrollRef">
       <ul
         class="float-left whitespace-nowrap !bg-transparent flex"
         :class="[tabStyle === 'tab-google' ? 'pl-1' : '']"
@@ -24,12 +24,6 @@
           @click="clickTab(item)"
           @contextmenu.prevent="(e) => showMenu(e, item.path)"
         >
-          <ArtSvgIcon
-            v-show="item.icon"
-            :icon="item.icon"
-            class="text-base mr-1 group-hover:text-theme"
-            :class="item.path === activeTab ? 'text-theme' : 'text-inherit'"
-          />
           {{ item.customTitle || formatMenuTitle(item.title) }}
           <span
             v-if="list.length > 1 && !item.fixedTab"
@@ -42,7 +36,7 @@
       </ul>
     </div>
 
-    <div class="flex">
+    <div class="flex shrink-0">
       <div
         class="worktab-menu-btn flex-cc relative top-0 size-8 leading-8 text-center c-p tad-200"
         @click="(e) => showMenu(e, activeTab)"
diff --git a/web-admin/src/router/index.ts b/web-admin/src/router/index.ts
index 286ae582..6cb089b2 100755
--- a/web-admin/src/router/index.ts
+++ b/web-admin/src/router/index.ts
@@ -20,4 +20,4 @@ export function initRouter(app: App<Element>): void {
 }
 
 // 主页路径，默认使用菜单第一个有效路径，配置后使用此路径
-export const HOME_PAGE_PATH = ''
+export const HOME_PAGE_PATH = '/console'
diff --git a/web-admin/src/router/modules/sqxp.ts b/web-admin/src/router/modules/sqxp.ts
index 649a402a..05d8ef35 100644
--- a/web-admin/src/router/modules/sqxp.ts
+++ b/web-admin/src/router/modules/sqxp.ts
@@ -1,153 +1,210 @@
 import type { AppRouteRecord } from '@/types/router'
 
 /**
- * 前端路由（Demo 参考页 + 系统管理）
+ * 前端路由（系统管理 + 基础信息管理 + 细胞存储 + 工作流）
  * 与后端菜单对齐时请同步 `backend/app/api/menu.py`。
  */
 export const sqxpAdminRoutes: AppRouteRecord[] = [
   {
-    id: '10000000000000000000000000000002',
-    name: 'Demo',
-    path: '/demo',
+    id: '10000000000000000000000000000001_child',
+    name: 'Console',
+    path: '/console',
+    component: '/dashboard/console/index',
+    meta: {
+      title: '工作台',
+      /** 无 icon：侧栏用与一级菜单同宽的虚拟槽对齐标题 */
+      virtualMenuIcon: true,
+      keepAlive: true,
+      fixedTab: true,
+      menuCode: 'dashboard'
+    }
+  },
+  {
+    id: '60000000000000000000000000000001',
+    name: 'Operations',
+    path: '/operations',
     component: '/index/index',
     meta: {
-      title: 'Demo',
-      icon: 'grid',
+      title: '运营支撑',
+      icon: 'operation',
       keepAlive: false,
       roles: ['admin']
     },
     children: [
       {
-        id: '10000000000000000000000000000001_child',
-        name: 'Console',
-        path: 'console',
-        component: '/dashboard/console/index',
-        meta: {
-          title: '工作台',
-          icon: 'home-filled',
-          keepAlive: true,
-          fixedTab: true,
-          menuCode: 'dashboard'
-        }
+        id: '60000000000000000000000000000002',
+        name: 'CleanRoom',
+        path: 'clean-room',
+        component: '/operations/clean-room/index',
+        meta: { title: '洁净室管理', keepAlive: true }
       },
       {
-        id: '10000000000000000000000000000005',
-        name: 'Unit',
-        path: 'unit',
-        component: '/system/unit/index',
-        meta: { title: '商品单位', keepAlive: true }
+        id: '60000000000000000000000000000003',
+        name: 'StorageFacility',
+        path: 'storage-facility',
+        component: '/operations/storage-facility/index',
+        meta: { title: '库位管理', keepAlive: true }
       },
       {
-        id: '10000000000000000000000000000021',
-        name: 'OrderList',
-        path: 'order',
-        component: '/system/order/index',
-        meta: { title: '订单列表', keepAlive: true }
+        id: '60000000000000000000000000000004',
+        name: 'ExhibitionAppointment',
+        path: 'exhibition-appointment',
+        component: '/operations/exhibition-appointment/index',
+        meta: { title: '展馆预约', keepAlive: true }
       },
       {
-        id: '10000000000000000000000000000006',
-        name: 'Product',
-        path: 'product',
-        component: '/system/product/index',
-        meta: { title: '商品管理', keepAlive: true }
-      },
-      {
-        id: '10000000000000000000000000000004',
-        name: 'Category',
-        path: 'category',
-        component: '/system/category/index',
-        meta: { title: '商品分类', keepAlive: true }
+        id: '60000000000000000000000000000005',
+        name: 'OperationsDemo',
+        path: 'demo',
+        component: '/operations/demo/index',
+        meta: { title: 'demo', keepAlive: true }
       }
     ]
   },
   {
-    id: '20000000000000000000000000000001',
-    name: 'System',
-    path: '/system',
+    id: '40000000000000000000000000000001',
+    name: 'BasicInfo',
+    path: '/basic-info',
     component: '/index/index',
     meta: {
-      title: '系统管理',
-      icon: 'setting',
+      title: '基础信息管理',
+      icon: 'folder-opened',
       keepAlive: false,
       roles: ['admin']
     },
     children: [
       {
-        id: '20000000000000000000000000000002',
-        name: 'Tenant',
-        path: 'tenant',
-        component: '/system/tenant/index',
-        meta: { title: '租户管理', keepAlive: true }
+        id: '40000000000000000000000000000002',
+        name: 'BizCustomer',
+        path: 'customer',
+        component: '/basic-info/customer/index',
+        meta: { title: '客户管理', keepAlive: true }
       },
       {
-        id: 'user-management-route',
-        name: 'SystemUser',
-        path: 'user',
-        component: '/system/user/index',
-        meta: { title: '用户管理', keepAlive: true }
+        id: '40000000000000000000000000000003',
+        name: 'BizCellSampleType',
+        path: 'cell-sample-type',
+        component: '/basic-info/cell-sample-type/index',
+        meta: { title: '细胞样本类型管理', keepAlive: true }
       },
       {
-        id: 'user-detail-route',
-        name: 'SystemUserDetail',
-        path: 'user/detail',
-        component: '/system/user/detail',
-        meta: { title: '用户详情', isHide: true, keepAlive: true }
+        id: '40000000000000000000000000000004',
+        name: 'BizCollectionRegion',
+        path: 'collection-region',
+        component: '/basic-info/collection-region/index',
+        meta: { title: '采集地区及医院管理', keepAlive: true }
       },
       {
-        id: 'role-management-route',
-        name: 'SystemRole',
-        path: 'role',
-        component: '/system/role/index',
-        meta: { title: '角色管理', keepAlive: true }
+        id: '40000000000000000000000000000005',
+        name: 'BizCollectionProtocolNo',
+        path: 'collection-protocol-no',
+        component: '/basic-info/collection-protocol-no/index',
+        meta: { title: '采集协议号管理', keepAlive: true }
       },
       {
-        id: 'menu-management-route',
-        name: 'SystemMenu',
-        path: 'menu',
-        component: '/system/menu/index',
-        meta: { title: '菜单管理', keepAlive: true }
+        id: '40000000000000000000000000000006',
+        name: 'BizSampleCode',
+        path: 'sample-code',
+        component: '/basic-info/sample-code/index',
+        meta: { title: '样本编码管理', keepAlive: true }
+      }
+    ]
+  },
+  {
+    id: '50000000000000000000000000000001',
+    name: 'CellStorage',
+    path: '/cell-storage',
+    component: '/index/index',
+    meta: {
+      title: '细胞存储管理',
+      icon: 'collection-tag',
+      keepAlive: false,
+      roles: ['admin']
+    },
+    children: [
+      {
+        id: '50000000000000000000000000000002',
+        name: 'CellStorageProtocol',
+        path: 'protocol',
+        component: '/cell-storage/protocol/index',
+        meta: { title: '采集协议单', keepAlive: true }
       },
       {
-        id: 'dept-management-route',
-        name: 'SystemDept',
-        path: 'dept',
-        component: '/system/dept/index',
-        meta: { title: '组织管理', keepAlive: true }
+        id: '50000000000000000000000000000003',
+        name: 'CellStorageProtocolAudit',
+        path: 'protocol-audit',
+        component: '/cell-storage/protocol-audit/index',
+        meta: { title: '采集协议单审核', keepAlive: true }
       },
       {
-        id: 'dict-management-route',
-        name: 'SystemDict',
-        path: 'dict',
-        component: '/system/dict/index',
-        meta: { title: '字典管理', keepAlive: true }
+        id: '50000000000000000000000000000004',
+        name: 'CellStoragePaymentConfirm',
+        path: 'payment-confirm',
+        component: '/cell-storage/payment-confirm/index',
+        meta: { title: '收款确认（财务）', keepAlive: true }
       },
       {
-        id: 'site-management-route',
-        name: 'SystemSite',
-        path: 'site',
-        component: '/system/site/index',
-        meta: { title: '站点管理', keepAlive: true }
+        id: '50000000000000000000000000000005',
+        name: 'CellStorageRefundConfirm',
+        path: 'refund-confirm',
+        component: '/cell-storage/refund-confirm/index',
+        meta: { title: '退费确认（财务）', keepAlive: true }
       },
       {
-        id: 'post-management-route',
-        name: 'SystemPost',
-        path: 'post',
-        component: '/system/post/index',
-        meta: { title: '职位管理', keepAlive: true }
+        id: '50000000000000000000000000000006',
+        name: 'CellStorageInstallmentWarning',
+        path: 'installment-warning',
+        component: '/cell-storage/installment-warning/index',
+        meta: { title: '分期缴费预警', keepAlive: true }
+      }
+    ]
+  },
+  {
+    id: '30000000000000000000000000000001',
+    name: 'Workflow',
+    path: '/workflow',
+    component: '/index/index',
+    meta: {
+      title: '工作流管理',
+      icon: 'workflow',
+      keepAlive: false,
+      roles: ['admin']
+    },
+    children: [
+      {
+        id: '10000000000000000000000000000wf01',
+        name: 'WorkflowProcess',
+        path: 'process',
+        component: '/system/workflow/process/index',
+        meta: { title: '流程配置', keepAlive: true, icon: 'workflow' }
       },
       {
-        id: 'unit-management-route',
-        name: 'SystemUnit',
-        path: 'unit',
-        component: '/system/unit/index',
-        meta: { title: '物品单位', keepAlive: true }
+        id: '10000000000000000000000000000wf02',
+        name: 'WorkflowPending',
+        path: 'pending',
+        component: '/system/workflow/task-pending/index',
+        meta: { title: '待办中心', keepAlive: true }
       },
       {
-        id: 'express-management-route',
-        name: 'SystemExpress',
-        path: 'express',
-        component: '/system/express/index',
-        meta: { title: '快递公司管理', keepAlive: true }
+        id: '10000000000000000000000000000wf03',
+        name: 'WorkflowCompleted',
+        path: 'completed',
+        component: '/system/workflow/task-completed/index',
+        meta: { title: '已办中心', keepAlive: true }
+      },
+      {
+        id: '10000000000000000000000000000wf05',
+        name: 'WorkflowMyApplications',
+        path: 'my-applications',
+        component: '/system/workflow/my-applications/index',
+        meta: { title: '我的申请', keepAlive: true }
+      },
+      {
+        id: '10000000000000000000000000000wf04',
+        name: 'LeaveRequest',
+        path: 'leave',
+        component: '/system/leave/index',
+        meta: { title: '请假申请', keepAlive: true }
       }
     ]
   }
diff --git a/web-admin/src/store/modules/worktab.ts b/web-admin/src/store/modules/worktab.ts
index be8e8cb3..9d34221f 100755
--- a/web-admin/src/store/modules/worktab.ts
+++ b/web-admin/src/store/modules/worktab.ts
@@ -89,13 +89,13 @@ export const useWorktabStore = defineStore(
       return !tab.fixedTab
     }
 
-    /**
-     * 过滤不应展示在 worktab 中的父级占位路由。
-     * `/demo` 仅用于承载与重定向，真实标签页为其子路由（如 `/demo/console`）。
-     */
-    const shouldIgnoreTab = (tab: Partial<WorkTab>): boolean => {
-      return tab.path === '/demo' || tab.path === '/system'
-    }
+  /**
+   * 过滤不应展示在 worktab 中的父级占位路由。
+   * `/system` 仅用于承载与重定向，真实标签页为其子路由（如 `/system/tenant`）。
+   */
+  const shouldIgnoreTab = (tab: Partial<WorkTab>): boolean => {
+    return tab.path === '/system'
+  }
 
     /**
      * 安全的路由跳转
diff --git a/web-admin/src/types/api.d.ts b/web-admin/src/types/api.d.ts
index 8fe8ce80..a6c8a060 100644
--- a/web-admin/src/types/api.d.ts
+++ b/web-admin/src/types/api.d.ts
@@ -14,7 +14,7 @@ declare namespace Api {
       regionName?: string
       email?: string
       roles?: string[]
-      /** 自定义头像 URL，空则前端使用中科兴皖 logo */
+      /** 自定义头像 URL，空则前端使用 `/avatart.jpg` */
       avatarUrl?: string | null
     }
 
@@ -479,6 +479,97 @@ declare namespace Api {
     }
   }
 
+  namespace BizCustomer {
+    interface CustomerItem {
+      id: string
+      customerName: string
+      sex: string
+      idCardNo: string
+      age: number | null
+      phoneNo: string
+      customerTags: string
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
+  namespace BizCellSampleType {
+    interface CellSampleTypeItem {
+      id: string
+      typeCode: string
+      typeName: string
+      storageYears: number | null
+      storagePrice: number | null
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
+  namespace BizCollectionRegion {
+    interface RegionItem {
+      id: string
+      regionName: string
+      hospitalNames: string[]
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
+  namespace BizCollectionHospital {
+    interface HospitalItem {
+      id: string
+      regionId: string
+      hospitalName: string
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
+  namespace BizCollectionProtocolNo {
+    interface ProtocolNoItem {
+      id: string
+      protocolNo: string
+      issued: number
+      issuedUserId: string
+      issuedUserName: string
+      issuedTime: string
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
+  namespace BizSampleCode {
+    interface SampleCodeItem {
+      id: string
+      sampleCode: string
+      sampleCodeType: string
+      issued: number
+      issuedUserId: string
+      issuedUserName: string
+      issuedTime: string
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+  }
+
   namespace Menu {
     interface MenuItem {
       id: string
@@ -526,6 +617,144 @@ declare namespace Api {
       updateTime: string
     }
   }
+
+  namespace Leave {
+    interface LeaveItem {
+      id: string
+      leaveType: string
+      leaveTypeLabel?: string
+      startDate: string
+      endDate: string
+      days: number
+      reason: string
+      wfInstanceId: string
+      status: string
+      tenantNo?: string
+      orderNum?: number
+      remark?: string
+      createBy?: string
+      createTime?: string
+      updateBy?: string
+      updateTime?: string
+    }
+  }
+
+  namespace Workflow {
+    interface ProcessDefItem {
+      id: string
+      processCode: string
+      processName: string
+      status: string
+      latestVersion: number | null
+      tenantNo: string
+      orderNum: number
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+
+    interface VersionItem {
+      id: string
+      versionNo: number
+      isLatest: string
+      remark: string
+      createTime: string
+      updateTime: string
+    }
+
+    interface NodeData {
+      nodeKey: string
+      nodeType: string
+      nodeName: string | null
+      configJson: string | null
+    }
+
+    interface TransitionData {
+      fromNodeKey: string
+      toNodeKey: string
+      conditionExpr: string | null
+    }
+
+    interface DesignerData {
+      graphJson: string | null
+      versionNo: number
+      nodes: NodeData[]
+      transitions: TransitionData[]
+    }
+
+    interface TaskItem {
+      id: string
+      instanceId: string
+      nodeKey: string | null
+      assigneeUserId: string | null
+      status: string | null
+      commentText: string | null
+      createTime: string
+      updateTime: string
+      processName: string | null
+      businessType: string | null
+      businessId: string | null
+      starterUserId: string | null
+      instanceStatus: string | null
+      instanceCreateTime: string | null
+    }
+
+    interface MyInstanceItem {
+      id: string
+      processName: string | null
+      businessType: string | null
+      businessId: string | null
+      starterUserId: string | null
+      status: string
+      createTime: string
+      updateTime: string
+      businessTypeLabel?: string
+      starterUserName?: string
+    }
+
+    interface TaskDetail {
+      id: string
+      nodeKey: string | null
+      nodeName?: string | null
+      assigneeUserId: string | null
+      assigneeUserName?: string | null
+      status: string | null
+      commentText: string | null
+      createTime: string
+      updateTime: string
+    }
+
+    interface InstanceDetail {
+      id: string
+      processVersionId: string
+      businessType: string | null
+      businessId: string | null
+      starterUserId: string | null
+      status: string | null
+      variables: string
+      createTime: string
+      tasks: TaskDetail[]
+    }
+
+    interface BusinessAllTasks {
+      businessType: string
+      businessId: string
+      businessFormFields: Array<{ label: string; value: string }>
+      tasks: Array<{
+        id: string
+        instanceId: string
+        instanceStatus: string
+        nodeKey: string | null
+        nodeName: string
+        assigneeUserId: string | null
+        assigneeUserName: string
+        status: string | null
+        commentText: string | null
+        createTime: string
+        updateTime: string
+      }>
+    }
+  }
 }
 
 declare module '*.vue' {
diff --git a/web-admin/src/types/router/index.ts b/web-admin/src/types/router/index.ts
index 0065b62f..2fc49ec8 100644
--- a/web-admin/src/types/router/index.ts
+++ b/web-admin/src/types/router/index.ts
@@ -29,8 +29,10 @@ import { RouteRecordRaw } from 'vue-router'
 export interface RouteMeta extends Record<string | number | symbol, unknown> {
   /** 路由标题 */
   title: string
-  /** 路由图标 */
+  /** 路由图标（Element / Iconify 名） */
   icon?: string
+  /** 无 `icon` 时仍在一级侧栏预留与图标同宽占位，使标题与其它一级菜单左对齐 */
+  virtualMenuIcon?: boolean
   /** 是否显示徽章 */
   showBadge?: boolean
   /** 文本徽章 */
diff --git a/web-admin/src/utils/fetch-paged-list.ts b/web-admin/src/utils/fetch-paged-list.ts
index 9d1c1c6d..ab0ca351 100644
--- a/web-admin/src/utils/fetch-paged-list.ts
+++ b/web-admin/src/utils/fetch-paged-list.ts
@@ -2,11 +2,15 @@
  * 分页循环请求直至拿全数据（接口需返回 { list, total }）。
  * 用于分类、单位、用户等列表接口，避免只取第一页导致下拉选项不全。
  */
+/** 与后端 `/web/admin/*` 列表普遍 `Query(..., le=100)` 一致，超出会 422 */
+export const MAX_ADMIN_LIST_PAGE_SIZE = 100
+
 export async function fetchAllPagedRecords<T>(
   fetchPage: (page: number, pageSize: number) => Promise<{ list?: T[]; total?: number }>,
   options?: { pageSize?: number; maxPages?: number }
 ): Promise<T[]> {
-  const pageSize = options?.pageSize ?? 100
+  const requested = options?.pageSize ?? MAX_ADMIN_LIST_PAGE_SIZE
+  const pageSize = Math.min(Math.max(1, requested), MAX_ADMIN_LIST_PAGE_SIZE)
   const maxPages = options?.maxPages ?? 50
   let page = 1
   const all: T[] = []
diff --git a/web-admin/src/utils/http/index.ts b/web-admin/src/utils/http/index.ts
index d40b7d56..b8a99f9b 100644
--- a/web-admin/src/utils/http/index.ts
+++ b/web-admin/src/utils/http/index.ts
@@ -23,7 +23,7 @@ import { BaseResponse } from '@/types'
 import { decryptJson, deriveKey, encryptJson, randomNonce } from './crypto'
 
 /** 请求配置常量 */
-const REQUEST_TIMEOUT = 15000
+const REQUEST_TIMEOUT = 60000
 const LOGOUT_DELAY = 500
 const RETRY_DELAY = 1000
 /** 幂等请求在网络抖动、唤醒后首包失败时自动重试次数 */
diff --git a/web-admin/src/utils/navigation/jump.ts b/web-admin/src/utils/navigation/jump.ts
index 320edb57..554f314e 100644
--- a/web-admin/src/utils/navigation/jump.ts
+++ b/web-admin/src/utils/navigation/jump.ts
@@ -17,6 +17,7 @@
 import { AppRouteRecord } from '@/types/router'
 import { router } from '@/router'
 import { isNavigableMenuItem } from './route'
+import { useSettingStore } from '@/store/modules/setting'
 
 // 打开外部链接
 export const openExternalLink = (link: string) => {
@@ -38,6 +39,10 @@ export const handleMenuJump = (item: AppRouteRecord, jumpToFirst: boolean = fals
 
   // 如果不需要跳转到第一个子菜单，或者没有子菜单，直接跳转当前路径
   if (!jumpToFirst || !item.children?.length) {
+    // 已经在当前页面时，刷新页面内容以重新加载列表数据
+    if (router.currentRoute.value.path === item.path) {
+      return useSettingStore().reload()
+    }
     return router.push(item.path)
   }
 
diff --git a/web-admin/src/utils/sort-order.ts b/web-admin/src/utils/sort-order.ts
index 9a50f455..34febf05 100644
--- a/web-admin/src/utils/sort-order.ts
+++ b/web-admin/src/utils/sort-order.ts
@@ -2,6 +2,8 @@
  * 新增时默认排序号：当前列表中最大 sortOrder + 1；无任何数据时为 0。
  * 依赖列表接口按 sort_order 升序分页（最后一页含最大排序号）。
  */
+import { MAX_ADMIN_LIST_PAGE_SIZE } from '@/utils/fetch-paged-list'
+
 export async function fetchNextSortOrder(
   fetchList: (params: {
     page: number
@@ -11,7 +13,8 @@ export async function fetchNextSortOrder(
   }) => Promise<{ list: { sortOrder?: number }[]; total: number }>,
   options?: { pageSize?: number }
 ): Promise<number> {
-  const pageSize = options?.pageSize ?? 100
+  const requested = options?.pageSize ?? MAX_ADMIN_LIST_PAGE_SIZE
+  const pageSize = Math.min(Math.max(1, requested), MAX_ADMIN_LIST_PAGE_SIZE)
   const first = await fetchList({ page: 1, pageSize })
   const total = first.total ?? 0
   if (total === 0) return 0
diff --git a/web-admin/src/utils/tree-path.ts b/web-admin/src/utils/tree-path.ts
index 9599c553..9dbf867b 100644
--- a/web-admin/src/utils/tree-path.ts
+++ b/web-admin/src/utils/tree-path.ts
@@ -11,8 +11,16 @@ export type TreePathFlatNode = Record<string, unknown>
 export function buildTreePathLabelFromFlat(
   nodeId: string | null | undefined,
   flatList: TreePathFlatNode[] | null | undefined,
-  separator: string = DEFAULT_TREE_PATH_SEPARATOR
+  separatorOrOpts?: string | { separator?: string; nameKey?: string }
 ): string {
+  const separator =
+    typeof separatorOrOpts === 'string'
+      ? separatorOrOpts
+      : separatorOrOpts?.separator ?? DEFAULT_TREE_PATH_SEPARATOR
+  const nameKey =
+    typeof separatorOrOpts === 'string'
+      ? 'name'
+      : separatorOrOpts?.nameKey ?? 'name'
   const cid = String(nodeId ?? '').trim()
   if (!cid) return ''
   const byId = new Map<string, TreePathFlatNode>()
@@ -26,7 +34,7 @@ export function buildTreePathLabelFromFlat(
   while (cur && byId.has(cur) && !seen.has(cur)) {
     seen.add(cur)
     const cat: TreePathFlatNode = byId.get(cur)!
-    const nm = String(cat?.name ?? '').trim()
+    const nm = String(cat?.[nameKey] ?? '').trim()
     if (nm) names.unshift(nm)
     const pid: string = String(cat?.parentId ?? cat?.parent_id ?? '').trim()
     cur = pid || null
@@ -70,12 +78,13 @@ export function resolveTreePathDisplay(
   flatList: TreePathFlatNode[] | null | undefined,
   fallbackName?: unknown,
   separator: string = DEFAULT_TREE_PATH_SEPARATOR,
-  emptyPlaceholder = '—'
+  emptyPlaceholder = '—',
+  nameKey?: string
 ): string {
   const path = buildTreePathLabelFromFlat(
     String(nodeId ?? '').trim() || undefined,
     flatList,
-    separator
+    { separator, nameKey }
   )
   if (path) return path
   const fb = String(fallbackName ?? '').trim()
diff --git a/web-admin/src/utils/ui/ep-icon-map.ts b/web-admin/src/utils/ui/ep-icon-map.ts
index 2b10f590..2316704b 100644
--- a/web-admin/src/utils/ui/ep-icon-map.ts
+++ b/web-admin/src/utils/ui/ep-icon-map.ts
@@ -13,13 +13,16 @@ import {
   CircleClose,
   Close,
   CloseBold,
+  CollectionTag,
+  Connection,
   DArrowRight,
   DataAnalysis,
+  DataBoard,
   Delete,
-  Document,
   Edit,
   Expand,
   Fold,
+  FolderOpened,
   FullScreen,
   Grid,
   HomeFilled,
@@ -109,7 +112,12 @@ export const epIconMap: Record<string, Component> = {
   smile: ChatDotRound,
   brush: Brush,
   // Status
-  warning: Warning
+  warning: Warning,
+  // Business
+  'folder-opened': FolderOpened,
+  'collection-tag': CollectionTag,
+  workflow: Connection,
+  'data-board': DataBoard
 }
 
 export function resolveEpIcon(name: string | undefined): Component | undefined {
diff --git a/web-admin/src/utils/user-avatar.ts b/web-admin/src/utils/user-avatar.ts
index cc9b614f..2fb3d566 100644
--- a/web-admin/src/utils/user-avatar.ts
+++ b/web-admin/src/utils/user-avatar.ts
@@ -1,12 +1,12 @@
-/** 未设置头像时统一使用中科兴皖 logo（与登录页、侧栏 ArtLogo 一致） */
-export const DEFAULT_USER_AVATAR_URL = '/logo.png'
+/** 未设置头像时使用 `public/avatart.jpg`（根路径 `/avatart.jpg`） */
+export const DEFAULT_USER_AVATAR_URL = '/avatart.jpg'
 
-/** @deprecated 各角色默认已统一为 logo，保留参数仅为兼容旧调用 */
+/** @deprecated 各角色默认已统一为默认头像图，保留参数仅为兼容旧调用 */
 export function defaultAvatarPathByRole(_role: string | undefined): string {
   return DEFAULT_USER_AVATAR_URL
 }
 
-/** 展示用头像：有自定义 URL 用自定义，否则用中科兴皖 logo */
+/** 展示用头像：`avatarUrl` 非空则用其值，否则用默认图 */
 export function resolveUserAvatarUrl(avatarUrl: string | null | undefined, role: string | undefined): string {
   const u = avatarUrl != null ? String(avatarUrl).trim() : ''
   if (u) return u
diff --git a/web-admin/src/views/basic-info/cell-sample-type/index.vue b/web-admin/src/views/basic-info/cell-sample-type/index.vue
new file mode 100644
index 00000000..2ec7515e
--- /dev/null
+++ b/web-admin/src/views/basic-info/cell-sample-type/index.vue
@@ -0,0 +1,403 @@
+<!-- 细胞样本类型管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>细胞样本类型</h1>
+      <p class="page-desc">维护样本类型编码、名称、存储年限与存储价格。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">细胞样本类型列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="类型编码/名称" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按编码、名称模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增类型
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="typeCode"
+            label="类型编码"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="typeName"
+            label="类型名称"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="storageYears"
+            label="存储年限(年)"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="storagePrice"
+            label="存储价格(元)"
+            width="120"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              {{ row.storagePrice != null ? row.storagePrice : '—' }}
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="640px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="biz-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="类型编码" prop="typeCode">
+              <el-input v-model="formData.typeCode" placeholder="租户内唯一" :disabled="isEdit" />
+            </el-form-item>
+            <el-form-item label="类型名称" prop="typeName">
+              <el-input v-model="formData.typeName" placeholder="必填" />
+            </el-form-item>
+            <el-form-item label="存储年限（年）">
+              <el-input
+                type="number"
+                step="any"
+                v-model="formData.storageYears"
+                :min="0"
+                :max="200"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="存储价格（元）">
+              <el-input
+                type="number"
+                step="any"
+                v-model="formData.storagePrice"
+                :min="0"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.typeName || '类型详情'"
+        :icon="Collection"
+        :meta="`类型编码：${viewRow?.typeCode || ''}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check, View, Collection } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchCellSampleTypeList,
+    fetchCreateCellSampleType,
+    fetchUpdateCellSampleType,
+    fetchDeleteCellSampleType
+  } from '@/api/admin'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+
+  defineOptions({ name: 'BizCellSampleType' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.BizCellSampleType.CellSampleTypeItem[]>([])
+  const selectedRows = ref<Api.BizCellSampleType.CellSampleTypeItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增类型')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.BizCellSampleType.CellSampleTypeItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '类型编码', value: row.typeCode },
+          { label: '类型名称', value: row.typeName },
+          { label: '存储年限(年)', value: row.storageYears },
+          { label: '存储价格(元)', value: row.storagePrice },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.BizCellSampleType.CellSampleTypeItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  const formData = reactive({
+    typeCode: '',
+    typeName: '',
+    storageYears: null as number | null,
+    storagePrice: null as number | null,
+    orderNum: 0,
+    remark: ''
+  })
+
+  const formRules = {
+    typeCode: [{ required: true, message: '请输入类型编码', trigger: 'blur' }],
+    typeName: [{ required: true, message: '请输入类型名称', trigger: 'blur' }]
+  }
+
+  const handleSelectionChange = (rows: Api.BizCellSampleType.CellSampleTypeItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCellSampleTypeList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.typeCode = ''
+    formData.typeName = ''
+    formData.storageYears = null
+    formData.storagePrice = null
+    formData.orderNum = 0
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增类型'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: Api.BizCellSampleType.CellSampleTypeItem) {
+    isEdit.value = true
+    dialogTitle.value = '编辑类型'
+    editingId.value = row.id
+    formData.typeCode = row.typeCode || ''
+    formData.typeName = row.typeName || ''
+    formData.storageYears = row.storageYears ?? null
+    formData.storagePrice = row.storagePrice ?? null
+    formData.orderNum = row.orderNum ?? 0
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        typeCode: formData.typeCode.trim(),
+        typeName: formData.typeName.trim(),
+        storageYears: formData.storageYears,
+        storagePrice: formData.storagePrice,
+        orderNum: formData.orderNum,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateCellSampleType(editingId.value, {
+          typeName: payload.typeName,
+          storageYears: payload.storageYears,
+          storagePrice: payload.storagePrice,
+          orderNum: payload.orderNum,
+          remark: payload.remark
+        })
+      } else {
+        await fetchCreateCellSampleType(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* 全局 */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  async function handleDelete(row: Api.BizCellSampleType.CellSampleTypeItem) {
+    await ElMessageBox.confirm('确定要删除该类型吗？', '提示', { type: 'warning' })
+    await fetchDeleteCellSampleType(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 条吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteCellSampleType(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .biz-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+  }
+</style>
diff --git a/web-admin/src/views/basic-info/collection-protocol-no/index.vue b/web-admin/src/views/basic-info/collection-protocol-no/index.vue
new file mode 100644
index 00000000..68fca413
--- /dev/null
+++ b/web-admin/src/views/basic-info/collection-protocol-no/index.vue
@@ -0,0 +1,684 @@
+<!-- 采集协议号管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>采集协议号</h1>
+      <p class="page-desc">维护采集协议号池及是否下发标记。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">采集协议号列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="协议号/备注" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增协议号
+          </el-button>
+          <el-button class="btn-ghost" @click="openBatchGenerate">
+            批量生成
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            :disabled="selectedRows.length === 0"
+            @click="openBatchIssue"
+          >
+            批量下发
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchRevoke"
+          >
+            批量收回
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="protocolNo"
+            label="采集协议号"
+            min-width="160"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="issued"
+            label="是否下发"
+            width="80"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <span>{{ row.issued === 1 ? '是' : '否' }}</span>
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="issuedUserName"
+            label="下发对象"
+            min-width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{ row.issuedUserName || '-' }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="issuedTime"
+            label="下发时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{ row.issuedTime || '-' }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 批量生成弹窗 -->
+      <el-dialog
+        v-model="batchGenVisible"
+        title="批量生成协议号"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="batchGenFormRef"
+          :model="batchGenForm"
+          :rules="batchGenRules"
+          label-position="top"
+          scroll-to-error
+        >
+          <div class="form-grid-2">
+            <el-form-item label="固定前缀" prop="prefix">
+              <el-input v-model="batchGenForm.prefix" placeholder="如 ZKZX" />
+            </el-form-item>
+            <el-form-item label="中间段" prop="middle">
+              <el-input v-model="batchGenForm.middle" placeholder="如 34" />
+            </el-form-item>
+            <el-form-item label="开始序号" prop="seqStart">
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.seqStart"
+                :min="0"
+                :max="99999"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="结束序号" prop="seqEnd">
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.seqEnd"
+                :min="0"
+                :max="99999"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="序号位数" prop="digitCount">
+              <template #label
+                >序号位数<span class="form-label-tip">补零后的总位数</span></template
+              >
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.digitCount"
+                :min="1"
+                :max="10"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="预览" class="form-col-span-2">
+              <span class="text-sm text-gray-500">{{ batchGenPreview }}</span>
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchGenVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="batchGenLoading" @click="handleBatchGenerate">
+            <el-icon><Check /></el-icon>
+            生成
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 批量下发弹窗 -->
+      <el-dialog
+        v-model="batchIssueVisible"
+        title="批量下发协议号"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="batchIssueFormRef"
+          :model="batchIssueForm"
+          :rules="batchIssueRules"
+          label-position="top"
+          scroll-to-error
+        >
+          <el-form-item label="下发用户" prop="issuedUserId">
+            <el-select
+              v-model="batchIssueForm.issuedUserId"
+              placeholder="请选择用户"
+              filterable
+              style="width: 100%"
+            >
+              <el-option
+                v-for="opt in userOptions"
+                :key="opt.value"
+                :label="opt.label"
+                :value="opt.value"
+              />
+            </el-select>
+          </el-form-item>
+          <el-form-item label="已选协议号">
+            <span class="text-sm text-gray-500">
+              已选 {{ selectedRows.length }} 条，下发后"是否下发"将变为"是"
+            </span>
+          </el-form-item>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchIssueVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="batchIssueLoading" @click="handleBatchIssue">
+            <el-icon><Check /></el-icon>
+            确定下发
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="biz-dialog-form"
+          scroll-to-error
+        >
+          <div class="form-grid-2">
+            <el-form-item label="采集协议号" prop="protocolNo">
+              <el-input
+                v-model="formData.protocolNo"
+                placeholder="租户内唯一，最多32位"
+                maxlength="32"
+              />
+            </el-form-item>
+            <el-form-item label="是否下发">
+              <el-switch
+                v-model="formData.issued"
+                :active-value="1"
+                :inactive-value="0"
+                inline-prompt
+                active-text="是"
+                inactive-text="否"
+              />
+            </el-form-item>
+            <el-form-item v-if="formData.issued === 1" label="下发用户">
+              <el-select
+                v-model="formData.issuedUserId"
+                placeholder="请选择用户"
+                filterable
+                style="width: 100%"
+              >
+                <el-option
+                  v-for="opt in userOptions"
+                  :key="opt.value"
+                  :label="opt.label"
+                  :value="opt.value"
+                />
+              </el-select>
+            </el-form-item>
+            <el-form-item v-if="formData.issued === 1 && formData.issuedTime" label="下发时间">
+              <span class="text-sm text-gray-500">{{ formData.issuedTime }}</span>
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.protocolNo || '协议号详情'"
+        :icon="Tickets"
+        :meta="viewRow?.createTime ? '创建时间：' + viewRow.createTime : ''"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check, View, Tickets } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchCollectionProtocolNoList,
+    fetchCreateCollectionProtocolNo,
+    fetchUpdateCollectionProtocolNo,
+    fetchDeleteCollectionProtocolNo,
+    fetchUserOptions,
+    fetchBatchGenerateProtocolNos,
+    fetchBatchIssueProtocolNos,
+    fetchBatchRevokeProtocolNos
+  } from '@/api/admin'
+
+  defineOptions({ name: 'BizCollectionProtocolNo' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.BizCollectionProtocolNo.ProtocolNoItem[]>([])
+  const selectedRows = ref<Api.BizCollectionProtocolNo.ProtocolNoItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增协议号')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.BizCollectionProtocolNo.ProtocolNoItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '采集协议号', value: row.protocolNo },
+          { label: '是否下发', value: row.issued === 1 ? '是' : '否' },
+          { label: '下发对象', value: row.issuedUserName || '-' },
+          { label: '下发时间', value: row.issuedTime || '-' },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.BizCollectionProtocolNo.ProtocolNoItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  // --- 批量生成 ---
+  const batchGenVisible = ref(false)
+  const batchGenLoading = ref(false)
+  const batchGenFormRef = ref()
+  const batchGenForm = reactive({
+    prefix: 'ZKZX',
+    middle: '34',
+    seqStart: 1,
+    seqEnd: 100,
+    digitCount: 6,
+  })
+  const batchGenRules = {
+    prefix: [{ required: true, message: '请输入固定前缀', trigger: 'blur' }],
+    middle: [{ required: true, message: '请输入中间段', trigger: 'blur' }],
+    seqStart: [{ required: true, message: '请输入开始序号', trigger: 'blur' }],
+    seqEnd: [{ required: true, message: '请输入结束序号', trigger: 'blur' }],
+    digitCount: [{ required: true, message: '请输入序号位数', trigger: 'blur' }],
+  }
+  const batchGenPreview = computed(() => {
+    const p = batchGenForm.prefix || ''
+    const m = batchGenForm.middle || ''
+    const s = batchGenForm.seqStart ?? 0
+    const e = batchGenForm.seqEnd ?? 0
+    const d = batchGenForm.digitCount ?? 6
+    if (!p || e < s) return '—'
+    const first = `${p}${m}${String(s).padStart(d, '0')}`
+    const last = `${p}${m}${String(e).padStart(d, '0')}`
+    return `${first} ~ ${last}（共 ${e - s + 1} 条）`
+  })
+
+  // --- 批量下发 ---
+  const batchIssueVisible = ref(false)
+  const batchIssueLoading = ref(false)
+  const batchIssueFormRef = ref()
+  const batchIssueForm = reactive({
+    issuedUserId: '',
+  })
+  const batchIssueRules = {
+    issuedUserId: [{ required: true, message: '请选择下发用户', trigger: 'change' }],
+  }
+  const userOptions = ref<Array<{ label: string; value: string }>>([])
+
+  const formData = reactive({
+    protocolNo: '',
+    issued: 0,
+    issuedUserId: '',
+    issuedUserName: '',
+    issuedTime: '',
+    orderNum: 0,
+    remark: ''
+  })
+
+  const formRules = {
+    protocolNo: [{ required: true, message: '请输入采集协议号', trigger: 'blur' }]
+  }
+
+  const handleSelectionChange = (rows: Api.BizCollectionProtocolNo.ProtocolNoItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCollectionProtocolNoList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.protocolNo = ''
+    formData.issued = 0
+    formData.issuedUserId = ''
+    formData.issuedUserName = ''
+    formData.issuedTime = ''
+    formData.orderNum = 0
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增协议号'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleEdit(row: Api.BizCollectionProtocolNo.ProtocolNoItem) {
+    isEdit.value = true
+    dialogTitle.value = '编辑协议号'
+    editingId.value = row.id
+    formData.protocolNo = row.protocolNo || ''
+    formData.issued = row.issued === 1 ? 1 : 0
+    formData.issuedUserId = row.issuedUserId || ''
+    formData.issuedUserName = row.issuedUserName || ''
+    formData.issuedTime = row.issuedTime || ''
+    formData.orderNum = row.orderNum ?? 0
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+    if (!userOptions.value.length) {
+      try {
+        userOptions.value = await fetchUserOptions()
+      } catch { /* ignore */ }
+    }
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        protocolNo: formData.protocolNo.trim(),
+        issued: formData.issued,
+        issuedUserId: formData.issued === 1 ? formData.issuedUserId || undefined : null,
+        issuedUserName: formData.issued === 1 ? formData.issuedUserName || undefined : null,
+        issuedTime: formData.issuedTime || undefined,
+        orderNum: formData.orderNum,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateCollectionProtocolNo(editingId.value, payload)
+      } else {
+        await fetchCreateCollectionProtocolNo(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  async function handleDelete(row: Api.BizCollectionProtocolNo.ProtocolNoItem) {
+    await ElMessageBox.confirm('确定要删除该协议号吗？', '提示', { type: 'warning' })
+    await fetchDeleteCollectionProtocolNo(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 条吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteCollectionProtocolNo(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  async function handleBatchRevoke() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(
+      `确定收回选中的 ${ids.length} 条吗？收回后将清除下发信息。`,
+      '提示',
+      { type: 'warning' }
+    )
+    await withFullscreenLoading(async () => {
+      await fetchBatchRevokeProtocolNos(ids)
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  // --- 批量生成 ---
+  function openBatchGenerate() {
+    batchGenForm.prefix = 'ZKZX'
+    batchGenForm.middle = '34'
+    batchGenForm.seqStart = 1
+    batchGenForm.seqEnd = 100
+    batchGenForm.digitCount = 6
+    batchGenVisible.value = true
+  }
+
+  async function handleBatchGenerate() {
+    await batchGenFormRef.value?.validate?.()
+    if (batchGenForm.seqStart > batchGenForm.seqEnd) {
+      ElMessage.warning('开始序号不能大于结束序号')
+      return
+    }
+    batchGenLoading.value = true
+    try {
+      await fetchBatchGenerateProtocolNos({
+        prefix: batchGenForm.prefix.trim(),
+        middle: batchGenForm.middle.trim(),
+        seqStart: batchGenForm.seqStart,
+        seqEnd: batchGenForm.seqEnd,
+        digitCount: batchGenForm.digitCount,
+      })
+      batchGenVisible.value = false
+      await loadData()
+    } finally {
+      batchGenLoading.value = false
+    }
+  }
+
+  // --- 批量下发 ---
+  async function openBatchIssue() {
+    if (!selectedRows.value.length) return
+    batchIssueForm.issuedUserId = ''
+    batchIssueVisible.value = true
+    // load user options
+    if (!userOptions.value.length) {
+      try {
+        userOptions.value = await fetchUserOptions()
+      } catch { /* ignore */ }
+    }
+  }
+
+  async function handleBatchIssue() {
+    await batchIssueFormRef.value?.validate?.()
+    batchIssueLoading.value = true
+    try {
+      const ids = selectedRows.value.map(r => r.id)
+      const userOpt = userOptions.value.find(u => u.value === batchIssueForm.issuedUserId)
+      await fetchBatchIssueProtocolNos({
+        ids,
+        issuedUserId: batchIssueForm.issuedUserId,
+        issuedUserName: userOpt?.label || undefined,
+      })
+      batchIssueVisible.value = false
+      selectedRows.value = []
+      await loadData()
+    } finally {
+      batchIssueLoading.value = false
+    }
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .biz-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+  }
+</style>
diff --git a/web-admin/src/views/basic-info/collection-region/index.vue b/web-admin/src/views/basic-info/collection-region/index.vue
new file mode 100644
index 00000000..4a52f3a2
--- /dev/null
+++ b/web-admin/src/views/basic-info/collection-region/index.vue
@@ -0,0 +1,665 @@
+<!-- 采集地区及医院管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>采集地区及医院</h1>
+      <p class="page-desc">维护采集地区；医院在子表中维护，可通过「地区医院配置」管理。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">采集地区列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="地区名称" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按地区名称模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增地区
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="regionName"
+            label="地区名称"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="医院信息"
+            min-width="240"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <template v-if="row.hospitalNames && row.hospitalNames.length">
+                <div
+                  v-for="(name, idx) in row.hospitalNames"
+                  :key="idx"
+                  class="hospital-cell-line"
+                >
+                  {{ name }}
+                </div>
+              </template>
+              <span v-else class="muted">—</span>
+            </template>
+          </el-table-column>
+          <el-table-column
+            label="操作"
+            width="400"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="openHospitalDialog(row)"
+                >地区医院配置</el-button
+              >
+              <el-button class="btn-op-item" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="regionDialogVisible"
+        :title="regionDialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="regionFormRef"
+          :model="regionForm"
+          :rules="regionFormRules"
+          label-position="top"
+          class="biz-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="地区名称" prop="regionName" class="form-col-span-2">
+              <el-input v-model="regionForm.regionName" placeholder="必填" />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="regionForm.remark" type="textarea" :rows="2" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="regionDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            @click="submitRegion"
+            :loading="regionSubmitLoading"
+          >
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <el-dialog
+        v-model="hospitalDialogVisible"
+        :title="hospitalDialogTitle"
+        width="800px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        @closed="onHospitalDialogClosed"
+      >
+        <div class="hospital-dialog-head">
+          <span class="muted">当前地区：{{ currentRegionName }}</span>
+        </div>
+        <div class="list-toolbar hospital-toolbar">
+          <div class="list-toolbar-row">
+            <div class="list-toolbar-selected">
+              已选 <span class="sel-num">{{ hospitalSelected.length }}</span> 项
+            </div>
+            <el-button class="btn-main" type="primary" @click="handleAddHospital">
+              <el-icon><Plus /></el-icon>
+              新增医院
+            </el-button>
+            <el-button
+              class="btn-ghost"
+              type="danger"
+              :disabled="hospitalSelected.length === 0"
+              @click="handleBatchDeleteHospital"
+            >
+              批量删除
+            </el-button>
+          </div>
+        </div>
+        <div class="list-body list-wrap hospital-table-wrap">
+          <el-table
+            class="list-table"
+            :data="hospitalTable"
+            v-loading="hospitalLoading"
+            stripe
+            row-key="id"
+            max-height="360"
+            @selection-change="onHospitalSelectionChange"
+          >
+            <el-table-column type="selection" width="55" align="center" header-align="center" />
+            <el-table-column
+              type="index"
+              label="序号"
+              width="68"
+              align="center"
+              header-align="center"
+            />
+            <el-table-column
+              prop="hospitalName"
+              label="医院名称"
+              min-width="200"
+              align="center"
+              header-align="center"
+            />
+            <el-table-column
+              label="操作"
+              width="260"
+              fixed="right"
+              align="center"
+              header-align="center"
+            >
+              <template #default="{ row }">
+                <el-button class="btn-op-item primary" @click="handleEditHospital(row)"
+                  >编辑</el-button
+                >
+                <el-button class="btn-op-item" @click="handleDeleteHospital(row)">删除</el-button>
+              </template>
+            </el-table-column>
+          </el-table>
+          <div class="pagination list-pager-bar">
+            <el-pagination
+              :current-page="hospitalPagination.page"
+              :page-size="hospitalPagination.pageSize"
+              :total="hospitalPagination.total"
+              :page-sizes="[10, 20, 50]"
+              layout="total, sizes, prev, pager, next"
+              @size-change="
+                (val) => (
+                  (hospitalPagination.page = 1),
+                  (hospitalPagination.pageSize = val),
+                  loadHospitals()
+                )
+              "
+              @current-change="(val) => ((hospitalPagination.page = val), loadHospitals())"
+            />
+          </div>
+        </div>
+
+        <el-dialog
+          v-model="hospitalFormVisible"
+          :title="hospitalFormTitle"
+          width="520px"
+          class="dialog-form-layout"
+          align-center
+          append-to-body
+          destroy-on-close
+          :close-on-click-modal="false"
+        >
+          <el-form
+            ref="hospitalFormRef"
+            :model="hospitalForm"
+            :rules="hospitalFormRules"
+            label-position="top"
+          >
+            <el-form-item label="医院名称" prop="hospitalName">
+              <el-input v-model="hospitalForm.hospitalName" placeholder="必填" />
+            </el-form-item>
+            <el-form-item label="备注">
+              <el-input
+                v-model="hospitalForm.remark"
+                type="textarea"
+                :rows="2"
+                placeholder="可选"
+              />
+            </el-form-item>
+          </el-form>
+          <template #footer>
+            <el-button class="btn-ghost" @click="hospitalFormVisible = false">
+              <el-icon><Close /></el-icon>
+              取消
+            </el-button>
+            <el-button
+              class="btn-main"
+              type="primary"
+              @click="submitHospital"
+              :loading="hospitalSubmitLoading"
+            >
+              <el-icon><Check /></el-icon>
+              确定
+            </el-button>
+          </template>
+        </el-dialog>
+        <template #footer>
+          <el-button class="btn-ghost" @click="hospitalDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            关闭
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.regionName || '地区详情'"
+        :icon="Location"
+        :meta="viewRow?.createTime ? '创建时间：' + viewRow.createTime : ''"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check, View, Location } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import {
+    fetchCollectionRegionList,
+    fetchCreateCollectionRegion,
+    fetchUpdateCollectionRegion,
+    fetchDeleteCollectionRegion,
+    fetchHospitalList,
+    fetchCreateHospital,
+    fetchUpdateHospital,
+    fetchDeleteHospital
+  } from '@/api/admin'
+
+  defineOptions({ name: 'BizCollectionRegion' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.BizCollectionRegion.RegionItem[]>([])
+  const selectedRows = ref<Api.BizCollectionRegion.RegionItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const regionDialogVisible = ref(false)
+  const regionDialogTitle = ref('新增地区')
+  const regionIsEdit = ref(false)
+  const regionSubmitLoading = ref(false)
+  const regionFormRef = ref()
+  const editingRegionId = ref<string | null>(null)
+  const regionForm = reactive({ regionName: '', orderNum: 0, remark: '' })
+  const regionFormRules = {
+    regionName: [{ required: true, message: '请输入地区名称', trigger: 'blur' }]
+  }
+
+  const hospitalDialogVisible = ref(false)
+  const hospitalDialogTitle = ref('地区医院配置')
+  const currentRegionId = ref('')
+  const currentRegionName = ref('')
+  const hospitalTable = ref<Api.BizCollectionHospital.HospitalItem[]>([])
+  const hospitalSelected = ref<Api.BizCollectionHospital.HospitalItem[]>([])
+  const hospitalLoading = ref(false)
+  const hospitalPagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const hospitalFormVisible = ref(false)
+  const hospitalFormTitle = ref('新增医院')
+  const hospitalIsEdit = ref(false)
+  const hospitalSubmitLoading = ref(false)
+  const hospitalFormRef = ref()
+  const editingHospitalId = ref<string | null>(null)
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.BizCollectionRegion.RegionItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    const hospitals =
+      row.hospitalNames && row.hospitalNames.length > 0
+        ? row.hospitalNames.join('、')
+        : '无'
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '地区名称', value: row.regionName },
+          { label: '创建时间', value: row.createTime },
+          { label: '关联医院', value: hospitals, span: true },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.BizCollectionRegion.RegionItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+  const hospitalForm = reactive({ hospitalName: '', orderNum: 0, remark: '' })
+  const hospitalFormRules = {
+    hospitalName: [{ required: true, message: '请输入医院名称', trigger: 'blur' }]
+  }
+
+  function onHospitalSelectionChange(rows: Api.BizCollectionHospital.HospitalItem[]) {
+    hospitalSelected.value = rows
+  }
+
+  const handleSelectionChange = (rows: Api.BizCollectionRegion.RegionItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCollectionRegionList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleAdd() {
+    regionIsEdit.value = false
+    regionDialogTitle.value = '新增地区'
+    editingRegionId.value = null
+    regionForm.regionName = ''
+    regionForm.orderNum = 0
+    regionForm.remark = ''
+    regionDialogVisible.value = true
+    regionFormRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: Api.BizCollectionRegion.RegionItem) {
+    regionIsEdit.value = true
+    regionDialogTitle.value = '编辑地区'
+    editingRegionId.value = row.id
+    regionForm.regionName = row.regionName || ''
+    regionForm.orderNum = row.orderNum ?? 0
+    regionForm.remark = row.remark || ''
+    regionDialogVisible.value = true
+    regionFormRef.value?.clearValidate?.()
+  }
+
+  async function submitRegion() {
+    await regionFormRef.value?.validate?.()
+    regionSubmitLoading.value = true
+    try {
+      const payload = {
+        regionName: regionForm.regionName.trim(),
+        orderNum: regionForm.orderNum,
+        remark: regionForm.remark?.trim() || undefined
+      }
+      if (regionIsEdit.value && editingRegionId.value) {
+        await fetchUpdateCollectionRegion(editingRegionId.value, payload)
+      } else {
+        await fetchCreateCollectionRegion(payload)
+      }
+      ElMessage.success(regionIsEdit.value ? '更新成功' : '创建成功')
+      regionDialogVisible.value = false
+      await loadData()
+    } catch {
+      /* */
+    } finally {
+      regionSubmitLoading.value = false
+    }
+  }
+
+  async function handleDelete(row: Api.BizCollectionRegion.RegionItem) {
+    await ElMessageBox.confirm('删除地区将同时软删除其下属全部医院，确定继续？', '提示', {
+      type: 'warning'
+    })
+    await fetchDeleteCollectionRegion(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(
+      `确定删除选中的 ${ids.length} 个地区吗？下属医院将一并软删除。`,
+      '提示',
+      {
+        type: 'warning'
+      }
+    )
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteCollectionRegion(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  function openHospitalDialog(row: Api.BizCollectionRegion.RegionItem) {
+    currentRegionId.value = row.id
+    currentRegionName.value = row.regionName || ''
+    hospitalPagination.page = 1
+    hospitalSelected.value = []
+    hospitalDialogTitle.value = `地区医院配置 — ${row.regionName}`
+    hospitalDialogVisible.value = true
+    loadHospitals()
+  }
+
+  async function loadHospitals() {
+    if (!currentRegionId.value) return
+    hospitalLoading.value = true
+    try {
+      const res = await fetchHospitalList(currentRegionId.value, {
+        page: hospitalPagination.page,
+        pageSize: hospitalPagination.pageSize
+      })
+      hospitalTable.value = res.list || []
+      hospitalPagination.total = res.total ?? 0
+    } finally {
+      hospitalLoading.value = false
+    }
+  }
+
+  function onHospitalDialogClosed() {
+    currentRegionId.value = ''
+    currentRegionName.value = ''
+    hospitalTable.value = []
+  }
+
+  function handleAddHospital() {
+    hospitalIsEdit.value = false
+    hospitalFormTitle.value = '新增医院'
+    editingHospitalId.value = null
+    hospitalForm.hospitalName = ''
+    hospitalForm.orderNum = 0
+    hospitalForm.remark = ''
+    hospitalFormVisible.value = true
+    hospitalFormRef.value?.clearValidate?.()
+  }
+
+  function handleEditHospital(row: Api.BizCollectionHospital.HospitalItem) {
+    hospitalIsEdit.value = true
+    hospitalFormTitle.value = '编辑医院'
+    editingHospitalId.value = row.id
+    hospitalForm.hospitalName = row.hospitalName || ''
+    hospitalForm.orderNum = row.orderNum ?? 0
+    hospitalForm.remark = row.remark || ''
+    hospitalFormVisible.value = true
+    hospitalFormRef.value?.clearValidate?.()
+  }
+
+  async function submitHospital() {
+    await hospitalFormRef.value?.validate?.()
+    hospitalSubmitLoading.value = true
+    try {
+      const rid = currentRegionId.value
+      const payload = {
+        hospitalName: hospitalForm.hospitalName.trim(),
+        orderNum: hospitalForm.orderNum,
+        remark: hospitalForm.remark?.trim() || undefined
+      }
+      if (hospitalIsEdit.value && editingHospitalId.value) {
+        await fetchUpdateHospital(rid, editingHospitalId.value, payload)
+      } else {
+        await fetchCreateHospital(rid, payload)
+      }
+      ElMessage.success(hospitalIsEdit.value ? '更新成功' : '创建成功')
+      hospitalFormVisible.value = false
+      await loadHospitals()
+    } catch {
+      /* */
+    } finally {
+      hospitalSubmitLoading.value = false
+    }
+  }
+
+  async function handleDeleteHospital(row: Api.BizCollectionHospital.HospitalItem) {
+    await ElMessageBox.confirm('确定删除该医院吗？', '提示', { type: 'warning' })
+    await fetchDeleteHospital(currentRegionId.value, row.id)
+    ElMessage.success('删除成功')
+    await loadHospitals()
+  }
+
+  async function handleBatchDeleteHospital() {
+    const ids = hospitalSelected.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 家医院吗？`, '提示', {
+      type: 'warning'
+    })
+    const rid = currentRegionId.value
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteHospital(rid, id)
+      }
+      ElMessage.success('批量删除成功')
+      hospitalSelected.value = []
+      await loadHospitals()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .biz-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+  }
+
+  .hospital-dialog-head {
+    margin-bottom: 12px;
+  }
+
+  .hospital-dialog-head .muted {
+    font-size: 13px;
+    color: var(--mint-text-muted);
+  }
+
+  .hospital-toolbar {
+    margin-bottom: 0;
+  }
+
+  .hospital-table-wrap {
+    padding-top: 0;
+  }
+
+  .hospital-cell-line {
+    line-height: 1.8;
+    text-align: left;
+    padding-left: 8px;
+  }
+
+  .muted {
+    color: var(--mint-text-muted);
+  }
+</style>
diff --git a/web-admin/src/views/basic-info/customer/index.vue b/web-admin/src/views/basic-info/customer/index.vue
new file mode 100644
index 00000000..1a9efdec
--- /dev/null
+++ b/web-admin/src/views/basic-info/customer/index.vue
@@ -0,0 +1,431 @@
+<!-- 客户管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>客户管理</h1>
+      <p class="page-desc">维护客户主数据；同一租户下身份证号不可重复。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">客户列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input
+                v-model="searchForm.keyword"
+                placeholder="姓名/电话/身份证/标签"
+                clearable
+              />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">支持模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增客户
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="customerName"
+            label="客户姓名"
+            min-width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column prop="sex" label="性别" width="72" align="center" header-align="center">
+            <template #default="{ row }">{{ sexLabel(row.sex) }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="idCardNo"
+            label="身份证号"
+            min-width="160"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="age"
+            label="年龄"
+            width="72"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="phoneNo"
+            label="联系电话"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="customerTags"
+            label="客户标签"
+            min-width="140"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="720px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="biz-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="客户姓名" prop="customerName">
+              <el-input v-model="formData.customerName" placeholder="必填" />
+            </el-form-item>
+            <el-form-item label="性别" prop="sex">
+              <el-select v-model="formData.sex" placeholder="选择" style="width: 100%">
+                <el-option label="男" value="0" />
+                <el-option label="女" value="1" />
+                <el-option label="未知" value="2" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="身份证号" prop="idCardNo">
+              <el-input
+                v-model="formData.idCardNo"
+                placeholder="可选；填写后租户内不可重复"
+                clearable
+              />
+            </el-form-item>
+            <el-form-item label="年龄">
+              <el-input
+                type="number"
+                step="any"
+                v-model="formData.age"
+                :min="0"
+                :max="150"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="联系电话">
+              <el-input v-model="formData.phoneNo" placeholder="可选" clearable />
+            </el-form-item>
+            <el-form-item label="客户标签" class="form-col-span-2">
+              <el-input v-model="formData.customerTags" placeholder="多个标签用英文逗号分隔" />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.customerName || '客户详情'"
+        :icon="User"
+        :meta="`身份证：${viewRow?.idCardNo || '—'}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check, View, User } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchCustomerList,
+    fetchCreateCustomer,
+    fetchUpdateCustomer,
+    fetchDeleteCustomer
+  } from '@/api/admin'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+
+  defineOptions({ name: 'BizCustomer' })
+
+  function sexLabel(s: string) {
+    if (s === '0') return '男'
+    if (s === '1') return '女'
+    return '未知'
+  }
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.BizCustomer.CustomerItem[]>([])
+  const selectedRows = ref<Api.BizCustomer.CustomerItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增客户')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.BizCustomer.CustomerItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '客户姓名', value: row.customerName },
+          { label: '性别', value: sexLabel(row.sex) },
+          { label: '身份证号', value: row.idCardNo },
+          { label: '年龄', value: row.age },
+          { label: '联系电话', value: row.phoneNo },
+          { label: '客户标签', value: row.customerTags, span: true },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.BizCustomer.CustomerItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  const formData = reactive({
+    customerName: '',
+    sex: '2',
+    idCardNo: '',
+    age: null as number | null,
+    phoneNo: '',
+    customerTags: '',
+    orderNum: 0,
+    remark: ''
+  })
+
+  const formRules = {
+    customerName: [{ required: true, message: '请输入客户姓名', trigger: 'blur' }]
+  }
+
+  const handleSelectionChange = (rows: Api.BizCustomer.CustomerItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCustomerList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.customerName = ''
+    formData.sex = '2'
+    formData.idCardNo = ''
+    formData.age = null
+    formData.phoneNo = ''
+    formData.customerTags = ''
+    formData.orderNum = 0
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增客户'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: Api.BizCustomer.CustomerItem) {
+    isEdit.value = true
+    dialogTitle.value = '编辑客户'
+    editingId.value = row.id
+    formData.customerName = row.customerName || ''
+    formData.sex = row.sex || '2'
+    formData.idCardNo = row.idCardNo || ''
+    formData.age = row.age ?? null
+    formData.phoneNo = row.phoneNo || ''
+    formData.customerTags = row.customerTags || ''
+    formData.orderNum = row.orderNum ?? 0
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        customerName: formData.customerName.trim(),
+        sex: formData.sex,
+        idCardNo: formData.idCardNo?.trim() || undefined,
+        age: formData.age,
+        phoneNo: formData.phoneNo?.trim() || undefined,
+        customerTags: formData.customerTags?.trim() || undefined,
+        orderNum: formData.orderNum,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateCustomer(editingId.value, payload)
+      } else {
+        await fetchCreateCustomer(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* 全局处理 */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  async function handleDelete(row: Api.BizCustomer.CustomerItem) {
+    await ElMessageBox.confirm('确定要删除该客户吗？', '提示', { type: 'warning' })
+    await fetchDeleteCustomer(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 条客户吗？`, '提示', {
+      type: 'warning'
+    })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteCustomer(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .biz-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+  }
+</style>
diff --git a/web-admin/src/views/basic-info/sample-code/index.vue b/web-admin/src/views/basic-info/sample-code/index.vue
new file mode 100644
index 00000000..a1594db5
--- /dev/null
+++ b/web-admin/src/views/basic-info/sample-code/index.vue
@@ -0,0 +1,710 @@
+<!-- 样本编码管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>样本编码</h1>
+      <p class="page-desc">维护样本编码池及是否下发标记。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">样本编码列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="样本编码/备注" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增样本编码
+          </el-button>
+          <el-button class="btn-ghost" @click="openBatchGenerate">
+            批量生成
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            :disabled="selectedRows.length === 0"
+            @click="openBatchIssue"
+          >
+            批量下发
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchRevoke"
+          >
+            批量收回
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="sampleCode"
+            label="样本编码"
+            min-width="160"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="sampleCodeType"
+            label="编码类型"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{ sampleCodeTypeLabel(row.sampleCodeType) }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="issued"
+            label="是否下发"
+            width="80"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <span>{{ row.issued === 1 ? '是' : '否' }}</span>
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="issuedUserName"
+            label="下发对象"
+            min-width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{ row.issuedUserName || '-' }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="issuedTime"
+            label="下发时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{ row.issuedTime || '-' }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 批量生成弹窗 -->
+      <el-dialog
+        v-model="batchGenVisible"
+        title="批量生成样本编码"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="batchGenFormRef"
+          :model="batchGenForm"
+          :rules="batchGenRules"
+          label-position="top"
+          scroll-to-error
+        >
+          <div class="form-grid-2">
+            <el-form-item label="编码类型" prop="sampleCodeType">
+              <el-select v-model="batchGenForm.sampleCodeType" placeholder="请选择" style="width: 100%">
+                <el-option label="造血编码 (ZKZX)" value="zxbm" />
+                <el-option label="脐带编码 (ZKQD)" value="qdbm" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="中间段" prop="middle">
+              <el-input v-model="batchGenForm.middle" placeholder="如 34" />
+            </el-form-item>
+            <el-form-item label="开始序号" prop="seqStart">
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.seqStart"
+                :min="0"
+                :max="99999"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="结束序号" prop="seqEnd">
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.seqEnd"
+                :min="0"
+                :max="99999"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="序号位数" prop="digitCount">
+              <template #label
+                >序号位数<span class="form-label-tip">补零后的总位数</span></template
+              >
+              <el-input
+                type="number"
+                step="any"
+                v-model="batchGenForm.digitCount"
+                :min="1"
+                :max="10"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="预览" class="form-col-span-2">
+              <span class="text-sm text-gray-500">{{ batchGenPreview }}</span>
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchGenVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="batchGenLoading" @click="handleBatchGenerate">
+            <el-icon><Check /></el-icon>
+            生成
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 批量下发弹窗 -->
+      <el-dialog
+        v-model="batchIssueVisible"
+        title="批量下发样本编码"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="batchIssueFormRef"
+          :model="batchIssueForm"
+          :rules="batchIssueRules"
+          label-position="top"
+          scroll-to-error
+        >
+          <el-form-item label="下发用户" prop="issuedUserId">
+            <el-select
+              v-model="batchIssueForm.issuedUserId"
+              placeholder="请选择用户"
+              filterable
+              style="width: 100%"
+            >
+              <el-option
+                v-for="opt in userOptions"
+                :key="opt.value"
+                :label="opt.label"
+                :value="opt.value"
+              />
+            </el-select>
+          </el-form-item>
+          <el-form-item label="已选编码">
+            <span class="text-sm text-gray-500">
+              已选 {{ selectedRows.length }} 条，下发后"是否下发"将变为"是"
+            </span>
+          </el-form-item>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchIssueVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="batchIssueLoading" @click="handleBatchIssue">
+            <el-icon><Check /></el-icon>
+            确定下发
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="biz-dialog-form"
+          scroll-to-error
+        >
+          <div class="form-grid-2">
+            <el-form-item label="样本编码" prop="sampleCode">
+              <el-input
+                v-model="formData.sampleCode"
+                placeholder="租户内唯一，最多32位"
+                maxlength="32"
+              />
+            </el-form-item>
+            <el-form-item v-if="isEdit" label="编码类型">
+              <span class="text-sm text-gray-500">{{ sampleCodeTypeLabel(formData.sampleCodeType) }}</span>
+            </el-form-item>
+            <el-form-item label="是否下发">
+              <el-switch
+                v-model="formData.issued"
+                :active-value="1"
+                :inactive-value="0"
+                inline-prompt
+                active-text="是"
+                inactive-text="否"
+              />
+            </el-form-item>
+            <el-form-item v-if="formData.issued === 1" label="下发用户">
+              <el-select
+                v-model="formData.issuedUserId"
+                placeholder="请选择用户"
+                filterable
+                style="width: 100%"
+              >
+                <el-option
+                  v-for="opt in userOptions"
+                  :key="opt.value"
+                  :label="opt.label"
+                  :value="opt.value"
+                />
+              </el-select>
+            </el-form-item>
+            <el-form-item v-if="formData.issued === 1 && formData.issuedTime" label="下发时间">
+              <span class="text-sm text-gray-500">{{ formData.issuedTime }}</span>
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.sampleCode || '样本编码详情'"
+        :icon="Ticket"
+        :meta="`编码类型：${sampleCodeTypeLabel(viewRow?.sampleCodeType || '')}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check, View, Ticket } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchSampleCodeList,
+    fetchCreateSampleCode,
+    fetchUpdateSampleCode,
+    fetchDeleteSampleCode,
+    fetchUserOptions,
+    fetchBatchGenerateSampleCodes,
+    fetchBatchIssueSampleCodes,
+    fetchBatchRevokeSampleCodes
+  } from '@/api/admin'
+
+  defineOptions({ name: 'BizSampleCode' })
+
+  function sampleCodeTypeLabel(t: string) {
+    if (t === 'zxbm') return '造血编码'
+    if (t === 'qdbm') return '脐带编码'
+    return t || '-'
+  }
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.BizSampleCode.SampleCodeItem[]>([])
+  const selectedRows = ref<Api.BizSampleCode.SampleCodeItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增样本编码')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.BizSampleCode.SampleCodeItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '样本编码', value: row.sampleCode },
+          { label: '编码类型', value: sampleCodeTypeLabel(row.sampleCodeType) },
+          { label: '是否下发', value: row.issued === 1 ? '是' : '否' },
+          { label: '下发对象', value: row.issuedUserName || '-' },
+          { label: '下发时间', value: row.issuedTime || '-' },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.BizSampleCode.SampleCodeItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  // --- 批量生成 ---
+  const batchGenVisible = ref(false)
+  const batchGenLoading = ref(false)
+  const batchGenFormRef = ref()
+  const batchGenForm = reactive({
+    sampleCodeType: 'zxbm',
+    middle: '34',
+    seqStart: 1,
+    seqEnd: 100,
+    digitCount: 6,
+  })
+  const batchGenRules = {
+    sampleCodeType: [{ required: true, message: '请选择编码类型', trigger: 'change' }],
+    middle: [{ required: true, message: '请输入中间段', trigger: 'blur' }],
+    seqStart: [{ required: true, message: '请输入开始序号', trigger: 'blur' }],
+    seqEnd: [{ required: true, message: '请输入结束序号', trigger: 'blur' }],
+    digitCount: [{ required: true, message: '请输入序号位数', trigger: 'blur' }],
+  }
+  const typePrefixMap: Record<string, string> = { zxbm: 'ZKZX', qdbm: 'ZKQD' }
+  const batchGenPreview = computed(() => {
+    const t = batchGenForm.sampleCodeType || ''
+    const m = batchGenForm.middle || ''
+    const s = batchGenForm.seqStart ?? 0
+    const e = batchGenForm.seqEnd ?? 0
+    const d = batchGenForm.digitCount ?? 6
+    const prefix = typePrefixMap[t] || ''
+    if (!prefix || e < s) return '—'
+    const first = `${prefix}${m}${String(s).padStart(d, '0')}`
+    const last = `${prefix}${m}${String(e).padStart(d, '0')}`
+    return `${first} ~ ${last}（共 ${e - s + 1} 条）`
+  })
+
+  // --- 批量下发 ---
+  const batchIssueVisible = ref(false)
+  const batchIssueLoading = ref(false)
+  const batchIssueFormRef = ref()
+  const batchIssueForm = reactive({
+    issuedUserId: '',
+  })
+  const batchIssueRules = {
+    issuedUserId: [{ required: true, message: '请选择下发用户', trigger: 'change' }],
+  }
+  const userOptions = ref<Array<{ label: string; value: string }>>([])
+
+  const formData = reactive({
+    sampleCode: '',
+    sampleCodeType: '',
+    issued: 0,
+    issuedUserId: '',
+    issuedUserName: '',
+    issuedTime: '',
+    orderNum: 0,
+    remark: ''
+  })
+
+  const formRules = {
+    sampleCode: [{ required: true, message: '请输入样本编码', trigger: 'blur' }]
+  }
+
+  const handleSelectionChange = (rows: Api.BizSampleCode.SampleCodeItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchSampleCodeList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.sampleCode = ''
+    formData.sampleCodeType = ''
+    formData.issued = 0
+    formData.issuedUserId = ''
+    formData.issuedUserName = ''
+    formData.issuedTime = ''
+    formData.orderNum = 0
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增样本编码'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleEdit(row: Api.BizSampleCode.SampleCodeItem) {
+    isEdit.value = true
+    dialogTitle.value = '编辑样本编码'
+    editingId.value = row.id
+    formData.sampleCode = row.sampleCode || ''
+    formData.sampleCodeType = row.sampleCodeType || ''
+    formData.issued = row.issued === 1 ? 1 : 0
+    formData.issuedUserId = row.issuedUserId || ''
+    formData.issuedUserName = row.issuedUserName || ''
+    formData.issuedTime = row.issuedTime || ''
+    formData.orderNum = row.orderNum ?? 0
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+    if (!userOptions.value.length) {
+      try {
+        userOptions.value = await fetchUserOptions()
+      } catch { /* ignore */ }
+    }
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        sampleCode: formData.sampleCode.trim(),
+        issued: formData.issued,
+        issuedUserId: formData.issued === 1 ? formData.issuedUserId || undefined : null,
+        issuedUserName: formData.issued === 1 ? formData.issuedUserName || undefined : null,
+        issuedTime: formData.issuedTime || undefined,
+        orderNum: formData.orderNum,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateSampleCode(editingId.value, payload)
+      } else {
+        await fetchCreateSampleCode(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  async function handleDelete(row: Api.BizSampleCode.SampleCodeItem) {
+    await ElMessageBox.confirm('确定要删除该样本编码吗？', '提示', { type: 'warning' })
+    await fetchDeleteSampleCode(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 条吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteSampleCode(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  async function handleBatchRevoke() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(
+      `确定收回选中的 ${ids.length} 条吗？收回后将清除下发信息。`,
+      '提示',
+      { type: 'warning' }
+    )
+    await withFullscreenLoading(async () => {
+      await fetchBatchRevokeSampleCodes(ids)
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  // --- 批量生成 ---
+  function openBatchGenerate() {
+    batchGenForm.sampleCodeType = 'zxbm'
+    batchGenForm.middle = '34'
+    batchGenForm.seqStart = 1
+    batchGenForm.seqEnd = 100
+    batchGenForm.digitCount = 6
+    batchGenVisible.value = true
+  }
+
+  async function handleBatchGenerate() {
+    await batchGenFormRef.value?.validate?.()
+    if (batchGenForm.seqStart > batchGenForm.seqEnd) {
+      ElMessage.warning('开始序号不能大于结束序号')
+      return
+    }
+    batchGenLoading.value = true
+    try {
+      await fetchBatchGenerateSampleCodes({
+        sampleCodeType: batchGenForm.sampleCodeType,
+        middle: batchGenForm.middle.trim(),
+        seqStart: batchGenForm.seqStart,
+        seqEnd: batchGenForm.seqEnd,
+        digitCount: batchGenForm.digitCount,
+      })
+      batchGenVisible.value = false
+      await loadData()
+    } finally {
+      batchGenLoading.value = false
+    }
+  }
+
+  // --- 批量下发 ---
+  async function openBatchIssue() {
+    if (!selectedRows.value.length) return
+    batchIssueForm.issuedUserId = ''
+    batchIssueVisible.value = true
+    if (!userOptions.value.length) {
+      try {
+        userOptions.value = await fetchUserOptions()
+      } catch { /* ignore */ }
+    }
+  }
+
+  async function handleBatchIssue() {
+    await batchIssueFormRef.value?.validate?.()
+    batchIssueLoading.value = true
+    try {
+      const ids = selectedRows.value.map(r => r.id)
+      const userOpt = userOptions.value.find(u => u.value === batchIssueForm.issuedUserId)
+      await fetchBatchIssueSampleCodes({
+        ids,
+        issuedUserId: batchIssueForm.issuedUserId,
+        issuedUserName: userOpt?.label || undefined,
+      })
+      batchIssueVisible.value = false
+      selectedRows.value = []
+      await loadData()
+    } finally {
+      batchIssueLoading.value = false
+    }
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .biz-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+  }
+</style>
diff --git a/web-admin/src/views/cell-storage/installment-warning/index.vue b/web-admin/src/views/cell-storage/installment-warning/index.vue
new file mode 100644
index 00000000..cb860a17
--- /dev/null
+++ b/web-admin/src/views/cell-storage/installment-warning/index.vue
@@ -0,0 +1,107 @@
+<!-- 分期缴费预警 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>分期缴费预警</h1>
+      <p class="page-desc">仅展示待缴费分期；预警窗口为未来 15 天内应缴；逾期为应缴日早于今日。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">分期预警列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="范围">
+              <el-select v-model="warningType" style="width: 100%" @change="handleSearch">
+                <el-option label="全部" value="all" />
+                <el-option label="预警（15天内）" value="warn" />
+                <el-option label="逾期" value="overdue" />
+              </el-select>
+            </el-form-item>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table class="list-table" :data="tableData" v-loading="loading" stripe row-key="id">
+          <el-table-column type="index" label="序号" width="68" align="center" header-align="center" />
+          <el-table-column prop="protocolNo" label="协议号" min-width="130" align="center" header-align="center" />
+          <el-table-column prop="installmentNo" label="期数" width="80" align="center" header-align="center" />
+          <el-table-column prop="installmentDueDate" label="应缴日" width="120" align="center" header-align="center" />
+          <el-table-column prop="warningType" label="分级" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-tag :type="warningTagType(String(row.warningType || ''))" effect="plain">{{
+                warningTypeLabel(String(row.warningType || ''))
+              }}</el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column prop="transferAmount" label="金额" width="120" align="center" header-align="center" />
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, onMounted } from 'vue'
+  import { fetchInstallmentWarningList } from '@/api/collection-protocol'
+
+  defineOptions({ name: 'CellStorageInstallmentWarning' })
+
+  function warningTypeLabel(w: string) {
+    if (w === 'overdue') return '逾期'
+    if (w === 'warn') return '预警'
+    if (w === 'upcoming') return '未到期'
+    return '其他'
+  }
+
+  function warningTagType(w: string) {
+    if (w === 'overdue') return 'danger'
+    if (w === 'warn') return 'warning'
+    return 'info'
+  }
+
+  const warningType = ref('all')
+  const tableData = ref<Record<string, unknown>[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchInstallmentWarningList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        warningType: warningType.value
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/cell-storage/payment-confirm/index.vue b/web-admin/src/views/cell-storage/payment-confirm/index.vue
new file mode 100644
index 00000000..0834a01d
--- /dev/null
+++ b/web-admin/src/views/cell-storage/payment-confirm/index.vue
@@ -0,0 +1,125 @@
+<!-- 收款确认（财务） -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>收款确认</h1>
+      <p class="page-desc">仅处理「缴费确认中」明细，确认后变为已缴费。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">收款确认列表</h2>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table class="list-table" :data="tableData" v-loading="loading" stripe row-key="id">
+          <el-table-column type="index" label="序号" width="68" align="center" header-align="center" />
+          <el-table-column prop="protocolNo" label="协议号" min-width="130" align="center" header-align="center" />
+          <el-table-column prop="installmentNo" label="期数" width="80" align="center" header-align="center" />
+          <el-table-column prop="installmentDueDate" label="应缴日" width="120" align="center" header-align="center" />
+          <el-table-column prop="transferAmount" label="金额" width="120" align="center" header-align="center" />
+          <el-table-column prop="payStatus" label="状态" width="120" align="center" header-align="center">
+            <template #default>缴费确认中</template>
+          </el-table-column>
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="140" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="openConfirm(row)">确认收款</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        title="确认收款"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+      >
+        <el-form label-position="top" class="biz-dialog-form">
+          <el-form-item label="财务确认附件（MinIO 地址，逗号分隔，可选）">
+            <el-input v-model="confirmAttachments" type="textarea" :rows="3" placeholder="可选" />
+          </el-form-item>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="submitLoading" @click="submitConfirm">
+            <el-icon><Check /></el-icon>
+            确认
+          </el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, onMounted } from 'vue'
+  import { Close, Check } from '@element-plus/icons-vue'
+  import { fetchReceiptConfirmList, fetchReceiptConfirmSubmit } from '@/api/collection-protocol'
+
+  defineOptions({ name: 'CellStoragePaymentConfirm' })
+
+  const tableData = ref<Record<string, unknown>[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const submitLoading = ref(false)
+  const confirmAttachments = ref('')
+  const currentDetailId = ref<string | null>(null)
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchReceiptConfirmList({
+        page: pagination.page,
+        pageSize: pagination.pageSize
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function openConfirm(row: Record<string, unknown>) {
+    currentDetailId.value = String(row.id)
+    confirmAttachments.value = ''
+    dialogVisible.value = true
+  }
+
+  async function submitConfirm() {
+    if (!currentDetailId.value) return
+    submitLoading.value = true
+    try {
+      await fetchReceiptConfirmSubmit(currentDetailId.value, {
+        financeConfirmAttachments: confirmAttachments.value || undefined
+      })
+      dialogVisible.value = false
+      loadData()
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/cell-storage/protocol-audit/index.vue b/web-admin/src/views/cell-storage/protocol-audit/index.vue
new file mode 100644
index 00000000..bf4b4a08
--- /dev/null
+++ b/web-admin/src/views/cell-storage/protocol-audit/index.vue
@@ -0,0 +1,410 @@
+<!-- 采集协议单审核 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>采集协议单审核</h1>
+      <p class="page-desc">查看与管理采集协议单审核数据。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">协议单列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="协议号/备注" clearable />
+            </el-form-item>
+            <el-form-item label="协议状态">
+              <el-select
+                v-model="searchForm.protocolStatus"
+                clearable
+                placeholder="全部"
+                style="width: 100%"
+              >
+                <el-option label="待生效" value="dsx" />
+                <el-option label="生效中" value="sxz" />
+                <el-option label="已过期" value="ygq" />
+                <el-option label="已作废" value="yzf" />
+                <el-option label="转科研" value="zky" />
+              </el-select>
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">列表为概要信息，详情见弹窗。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"
+                ><el-icon><RefreshLeft /></el-icon>重置</el-button
+              >
+              <el-button class="btn-main" type="primary" @click="handleSearch"
+                ><el-icon><Search /></el-icon>搜索</el-button
+              >
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button type="primary" class="btn-main" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增
+          </el-button>
+          <el-button class="btn-ghost" :disabled="!selectedRows.length" @click="handleBatchDelete">
+            <el-icon><Delete /></el-icon>
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="protocolNo"
+            label="协议号"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="protocolStatus"
+            label="状态"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              protocolStatusLabel(String(row.protocolStatus || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="registerDate"
+            label="登记日期"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherName"
+            label="母亲姓名"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherPhone"
+            label="母亲电话"
+            min-width="130"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherIdCard"
+            label="母亲身份证号"
+            min-width="190"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="fatherName"
+            label="父亲姓名"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="newbornSex"
+            label="新生儿性别"
+            width="110"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              newbornSexLabel(String(row.newbornSex || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="deliveryMode"
+            label="分娩方式"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              deliveryModeLabel(String(row.deliveryMode || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="newbornWeightGram"
+            label="新生儿体重(克)"
+            width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="regionName"
+            label="采集地区"
+            min-width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="hospitalName"
+            label="采集医院"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="collectorUserName"
+            label="采集专员"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="salesUserName"
+            label="销售人员"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="sampleCollectTime"
+            label="样本采集时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleEdit(row)"
+                ><el-icon><Edit /></el-icon>编辑</el-button
+              >
+              <el-button class="btn-op-item" @click="handleDelete(row)"
+                ><el-icon><Delete /></el-icon>删除</el-button
+              >
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 新增/编辑弹窗 -->
+      <ProtocolFormDialog
+        v-model="formDialogVisible"
+        :edit-id="formDialogEditId"
+        :list-row="formDialogRow"
+        @saved="onFormSaved"
+      />
+
+      <!-- 查看弹窗 -->
+      <ProtocolViewDialog v-model="viewVisible" :protocol-id="viewProtocolId" :list-row="viewRow" />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import {
+    Plus,
+    View,
+    Edit,
+    Delete,
+    Search,
+    RefreshLeft
+  } from '@element-plus/icons-vue'
+  import ProtocolFormDialog from '../protocol/ProtocolFormDialog.vue'
+  import ProtocolViewDialog from '../protocol/ProtocolViewDialog.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchCollectionProtocolList,
+    fetchDeleteCollectionProtocol,
+    type CollectionProtocolRow
+  } from '@/api/collection-protocol'
+
+  defineOptions({ name: 'CellStorageProtocolAudit' })
+
+  /* ====== 标签映射 ====== */
+  function protocolStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dsx: '待生效',
+      sxz: '生效中',
+      ygq: '已过期',
+      yzf: '已作废',
+      zky: '转科研'
+    }
+    return m[s] || s || '-'
+  }
+
+  function newbornSexLabel(s: string) {
+    if (s === '1') return '男'
+    if (s === '0') return '女'
+    return s || '-'
+  }
+
+  function deliveryModeLabel(s: string) {
+    if (s === 'sc') return '顺产'
+    if (s === 'pgc') return '剖宫产'
+    return s || '-'
+  }
+
+  /* ====== 列表 ====== */
+  const searchForm = reactive<{ keyword: string; protocolStatus: string }>({
+    keyword: '',
+    protocolStatus: ''
+  })
+  const tableData = ref<CollectionProtocolRow[]>([])
+  const selectedRows = ref<CollectionProtocolRow[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const handleSelectionChange = (rows: CollectionProtocolRow[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCollectionProtocolList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined,
+        protocolStatus: searchForm.protocolStatus || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    searchForm.protocolStatus = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  /* ====== 查看弹窗 ====== */
+  const viewVisible = ref(false)
+  const viewProtocolId = ref<string | null>(null)
+  const viewRow = ref<CollectionProtocolRow | null>(null)
+
+  function handleView(row: CollectionProtocolRow) {
+    viewProtocolId.value = String(row.id)
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  /* ====== 新增/编辑弹窗 ====== */
+  const formDialogVisible = ref(false)
+  const formDialogEditId = ref<string | null>(null)
+  const formDialogRow = ref<CollectionProtocolRow | null>(null)
+
+  function handleAdd() {
+    formDialogEditId.value = null
+    formDialogRow.value = null
+    formDialogVisible.value = true
+  }
+
+  function handleEdit(row: CollectionProtocolRow) {
+    formDialogEditId.value = row.id
+    formDialogRow.value = row
+    formDialogVisible.value = true
+  }
+
+  function onFormSaved() {
+    loadData()
+  }
+
+  /* ====== 删除 ====== */
+  function handleDelete(row: CollectionProtocolRow) {
+    ElMessageBox.confirm(`确认删除协议号「${row.protocolNo}」？`, '删除确认', {
+      confirmButtonText: '确定',
+      cancelButtonText: '取消',
+      type: 'warning'
+    })
+      .then(async () => {
+        await fetchDeleteCollectionProtocol(String(row.id))
+        loadData()
+      })
+      .catch(() => {})
+  }
+
+  async function handleBatchDelete() {
+    if (!selectedRows.value.length) return
+    await ElMessageBox.confirm(`确认删除选中的 ${selectedRows.value.length} 条记录？`, '批量删除', {
+      confirmButtonText: '确定',
+      cancelButtonText: '取消',
+      type: 'warning'
+    })
+    const rows = [...selectedRows.value]
+    await withFullscreenLoading(async () => {
+      for (const row of rows) {
+        await fetchDeleteCollectionProtocol(String(row.id))
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/cell-storage/protocol/ProtocolAttachmentReadonly.vue b/web-admin/src/views/cell-storage/protocol/ProtocolAttachmentReadonly.vue
new file mode 100644
index 00000000..6d385841
--- /dev/null
+++ b/web-admin/src/views/cell-storage/protocol/ProtocolAttachmentReadonly.vue
@@ -0,0 +1,208 @@
+<!-- 采集协议单 — 只读附件列表（样式对齐新增/编辑弹窗 attachment-upload） -->
+<template>
+  <span v-if="!files.length" class="protocol-attachment-empty">暂无附件</span>
+  <div v-else class="attachment-upload">
+    <div class="attachment-list">
+      <div
+        v-for="(file, index) in files"
+        :key="file.id || file.fileUrl || index"
+        class="attachment-item"
+      >
+        <div
+          class="attachment-preview"
+          @click="isImageFile(file) && file.fileUrl ? emit('preview', file) : undefined"
+        >
+          <template v-if="isImageFile(file) && file.fileUrl">
+            <img :src="resolveFileUrl(file.fileUrl)" :alt="file.fileName" />
+          </template>
+          <template v-else-if="isVideoFile(file)">
+            <div class="attachment-preview__icon attachment-preview__icon--video">
+              <el-icon :size="28"><VideoPlay /></el-icon>
+            </div>
+          </template>
+          <template v-else>
+            <div class="attachment-preview__icon attachment-preview__icon--doc">
+              <el-icon :size="28"><Document /></el-icon>
+            </div>
+          </template>
+        </div>
+        <div class="attachment-footer">
+          <span class="attachment-name" :title="file.fileName">{{
+            file.fileName || '未命名'
+          }}</span>
+          <div class="attachment-actions">
+            <el-icon class="action-btn" title="下载" @click.stop="emit('download', file)">
+              <Download />
+            </el-icon>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Document, Download, VideoPlay } from '@element-plus/icons-vue'
+
+  defineProps<{
+    files: Array<Record<string, any>>
+  }>()
+
+  const emit = defineEmits<{
+    (e: 'preview', file: Record<string, any>): void
+    (e: 'download', file: Record<string, any>): void
+  }>()
+
+  const minioBaseUrl = (import.meta.env.VITE_MINIO_BASE_URL || '').replace(/\/$/, '')
+
+  function resolveFileUrl(suffix: string) {
+    if (!suffix) return ''
+    if (suffix.startsWith('http://') || suffix.startsWith('https://') || suffix.startsWith('/')) {
+      return suffix
+    }
+    return `${minioBaseUrl}/${suffix}`
+  }
+
+  function isImageFile(file: { fileType?: string; fileName?: string; fileUrl?: string }) {
+    const url = (file.fileUrl || '').toLowerCase()
+    const name = (file.fileName || '').toLowerCase()
+    return (
+      /\.(jpg|jpeg|png|gif|bmp|webp|svg)(\?|$)/.test(url) ||
+      /\.(jpg|jpeg|png|gif|bmp|webp|svg)$/.test(name) ||
+      (file.fileType || '').startsWith('image/')
+    )
+  }
+
+  function isVideoFile(file: { fileType?: string; fileName?: string; fileUrl?: string }) {
+    const url = (file.fileUrl || '').toLowerCase()
+    const name = (file.fileName || '').toLowerCase()
+    return (
+      /\.(mp4|webm|ogg|mov|avi)(\?|$)/.test(url) ||
+      /\.(mp4|webm|ogg|mov|avi)$/.test(name) ||
+      (file.fileType || '').startsWith('video/')
+    )
+  }
+</script>
+
+<style scoped lang="scss">
+  .protocol-attachment-empty {
+    font-size: 13px;
+    color: #94a3b8;
+  }
+
+  .attachment-upload {
+    width: 100%;
+  }
+
+  .attachment-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 12px;
+  }
+
+  .attachment-item {
+    width: 140px;
+    display: flex;
+    flex-direction: column;
+    border: 1px solid #e2e8f0;
+    border-radius: 8px;
+    background: #fff;
+    overflow: hidden;
+    transition:
+      border-color 0.15s,
+      box-shadow 0.15s;
+
+    &:hover {
+      border-color: #10b981;
+      box-shadow: 0 2px 8px rgba(16, 185, 129, 0.1);
+    }
+  }
+
+  .attachment-preview {
+    width: 100%;
+    height: 96px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: #f8fafc;
+    overflow: hidden;
+    cursor: pointer;
+
+    img {
+      width: 100%;
+      height: 100%;
+      object-fit: cover;
+      display: block;
+    }
+  }
+
+  .attachment-preview__icon {
+    width: 48px;
+    height: 48px;
+    border-radius: 10px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+
+    &--video {
+      background: #ede9fe;
+      color: #7c3aed;
+    }
+
+    &--doc {
+      background: #e0f2fe;
+      color: #0284c7;
+    }
+  }
+
+  .attachment-footer {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    padding: 6px 8px;
+  }
+
+  .attachment-name {
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    font-size: 11px;
+    color: #334155;
+    line-height: 1.4;
+    word-break: break-all;
+    min-height: calc(11px * 1.4 * 2);
+  }
+
+  .attachment-actions {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    gap: 8px;
+    margin-top: 4px;
+    flex-shrink: 0;
+  }
+
+  .action-btn {
+    width: 22px;
+    height: 22px;
+    border-radius: 4px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 12px;
+    color: #64748b;
+    cursor: pointer;
+    background: #f1f5f9;
+    transition:
+      background 0.15s,
+      color 0.15s;
+
+    &:hover {
+      background: #10b981;
+      color: #fff;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/cell-storage/protocol/ProtocolFormDialog.vue b/web-admin/src/views/cell-storage/protocol/ProtocolFormDialog.vue
new file mode 100644
index 00000000..02b0a9fb
--- /dev/null
+++ b/web-admin/src/views/cell-storage/protocol/ProtocolFormDialog.vue
@@ -0,0 +1,3198 @@
+<template>
+      <!-- ========== 新增/编辑弹窗 ========== -->
+      <el-dialog
+        :model-value="modelValue"
+        :title="dialogTitle"
+        width="1600px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <div v-loading="dialogFormLoading" class="protocol-dialog-body min-h-[200px]">
+          <div class="detail-tabs">
+            <div
+              v-for="tab in formTabs"
+              :key="tab.key"
+              class="detail-tab"
+              :class="{ active: activeFormTab === tab.key }"
+              @click="scrollToSection(tab.key)"
+            >
+              {{ tab.label }}
+            </div>
+          </div>
+
+          <el-form
+            ref="formRef"
+            :model="formData"
+            :rules="formRules"
+            label-position="top"
+            scroll-to-error
+            class="protocol-form"
+          >
+            <!-- Tab 1: 基本信息 -->
+            <div id="form-section-basic" class="form-tab-pane">
+              <div class="form-grid-5">
+                <el-form-item label="协议号" prop="protocolNo">
+                  <el-select
+                    v-model="formData.protocolNoId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchProtocolNos"
+                    :loading="protocolNoLoading"
+                    placeholder="输入协议号检索"
+                    @change="onProtocolNoChange"
+                    @clear="onProtocolNoClear"
+                  >
+                    <el-option
+                      v-for="p in protocolNoOptions"
+                      :key="p.id"
+                      :label="p.issued ? `${p.protocolNo}（已使用）` : p.protocolNo"
+                      :value="p.id"
+                      :disabled="!!p.issued"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="协议状态" prop="protocolStatus">
+                  <el-select
+                    v-model="formData.protocolStatus"
+                    placeholder="请选择"
+                    style="width: 100%"
+                  >
+                    <el-option label="待生效" value="dsx" />
+                    <el-option label="生效中" value="sxz" />
+                    <el-option label="已过期" value="ygq" />
+                    <el-option label="已作废" value="yzf" />
+                    <el-option label="转科研" value="zky" />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="登记日期" prop="registerDate">
+                  <el-date-picker
+                    v-model="formData.registerDate"
+                    type="date"
+                    value-format="YYYYMMDD"
+                    format="YYYY-MM-DD"
+                    placeholder="选择登记日期"
+                    clearable
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="采集专员" prop="collectorUserId">
+                  <el-select
+                    v-model="collectorUserId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchCollectorUsers"
+                    :loading="collectorLoading"
+                    placeholder="输入姓名检索用户"
+                    @change="onCollectorUserChange"
+                  >
+                    <el-option
+                      v-for="u in collectorUserOptions"
+                      :key="u.id"
+                      :label="u.nickName + (u.phoneNo ? ' · ' + u.phoneNo : '')"
+                      :value="u.id"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="协议附件" class="form-col-span-2">
+                  <div class="attachment-upload">
+                    <div class="attachment-list">
+                      <el-upload
+                        ref="attachmentUploadRef"
+                        :auto-upload="false"
+                        :show-file-list="false"
+                        :multiple="true"
+                        accept="image/*,video/*,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.txt,.zip,.rar"
+                        @change="handleAttachmentChange"
+                      >
+                        <div class="upload-card">
+                          <el-icon :size="28" color="#10b981"><Plus /></el-icon>
+                          <span class="upload-card-text">上传附件</span>
+                        </div>
+                      </el-upload>
+                      <div
+                        v-for="(file, index) in formData.attachments"
+                        :key="file.id || index"
+                        class="attachment-item"
+                        :class="{ 'is-uploading': file._uploading }"
+                      >
+                        <div
+                          class="attachment-preview"
+                          @click="
+                            isImageFile(file) && file.fileUrl
+                              ? handlePreviewAttachment(file)
+                              : undefined
+                          "
+                        >
+                          <template v-if="isImageFile(file) && file.fileUrl">
+                            <img :src="fullFileUrl(file.fileUrl)" :alt="file.fileName" />
+                          </template>
+                          <template v-else-if="isImageFile(file) && !file.fileUrl">
+                            <el-icon :size="24" color="#94a3b8"><Loading /></el-icon>
+                          </template>
+                          <template v-else-if="isVideoFile(file)">
+                            <div class="attachment-preview__icon attachment-preview__icon--video">
+                              <el-icon :size="28"><VideoPlay /></el-icon>
+                            </div>
+                          </template>
+                          <template v-else>
+                            <div class="attachment-preview__icon attachment-preview__icon--doc">
+                              <el-icon :size="28"><Document /></el-icon>
+                            </div>
+                          </template>
+                        </div>
+                        <div class="attachment-footer">
+                          <span class="attachment-name" :title="file.fileName">{{
+                            file.fileName
+                          }}</span>
+                          <div class="attachment-actions">
+                            <el-icon
+                              class="action-btn"
+                              title="下载"
+                              @click="handleDownloadAttachment(file)"
+                              ><Download
+                            /></el-icon>
+                            <el-icon
+                              class="action-btn action-btn--danger"
+                              title="删除"
+                              @click="removeAttachment(index)"
+                              ><Delete
+                            /></el-icon>
+                          </div>
+                        </div>
+                      </div>
+                    </div>
+                    <span class="upload-hint"
+                      >支持图片、视频、PDF、Word、Excel等文件，单文件不超过 20MB</span
+                    >
+                  </div>
+                </el-form-item>
+                <el-form-item label="备注" class="form-col-span-2">
+                  <el-input
+                    v-model="formData.remark"
+                    type="textarea"
+                    :rows="3"
+                    placeholder="可选"
+                  />
+                </el-form-item>
+              </div>
+            </div>
+
+            <!-- Tab 2: 客户信息 -->
+            <div id="form-section-party" class="form-tab-pane">
+              <h3 class="detail-section-title">母亲信息</h3>
+              <div class="form-grid-5">
+                <el-form-item label="关联客户">
+                  <el-select
+                    v-model="customerId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchCustomers"
+                    :loading="customerLoading"
+                    placeholder="输入姓名/电话/身份证号检索客户"
+                    @change="onCustomerChange"
+                  >
+                    <el-option
+                      v-for="c in customerOptions"
+                      :key="c.id"
+                      :label="formatCustomerLabel(c)"
+                      :value="c.id"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="母亲姓名">
+                  <el-input v-model="formData.motherName" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="母亲联系电话">
+                  <el-input v-model="formData.motherPhone" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="母亲身份证号">
+                  <el-input v-model="formData.motherIdCard" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="母亲出生年月">
+                  <el-date-picker
+                    v-model="formData.motherBirthYm"
+                    type="month"
+                    value-format="YYYYMM"
+                    format="YYYY-MM"
+                    placeholder="选择月份"
+                    clearable
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="母亲民族">
+                  <el-select
+                    v-model="formData.motherEthnic"
+                    class="w-full"
+                    filterable
+                    clearable
+                    :loading="ethnicLoading"
+                    placeholder="请选择或检索民族"
+                  >
+                    <el-option
+                      v-for="e in ethnicOptions"
+                      :key="e.ethnicCode"
+                      :label="e.ethnicName"
+                      :value="e.ethnicName"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="母亲家庭住址" style="grid-column: span 2">
+                  <el-input v-model="formData.motherAddress" placeholder="请输入" />
+                </el-form-item>
+              </div>
+
+              <div class="form-section-divider" />
+              <h3 class="detail-section-title">父亲信息</h3>
+              <div class="form-grid-5">
+                <el-form-item label="父亲姓名">
+                  <el-input v-model="formData.fatherName" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="父亲电话">
+                  <el-input v-model="formData.fatherPhone" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="父亲身份证号">
+                  <el-input v-model="formData.fatherIdCard" placeholder="请输入" />
+                </el-form-item>
+              </div>
+
+              <div class="form-section-divider" />
+              <h3 class="detail-section-title">新生儿信息</h3>
+              <div class="form-grid-5">
+                <el-form-item label="新生儿姓名">
+                  <el-input v-model="formData.newbornName" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="新生儿身份证">
+                  <el-input v-model="formData.newbornIdCard" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="新生儿分娩时间">
+                  <el-date-picker
+                    v-model="formData.newbornDeliveryTime"
+                    type="datetime"
+                    value-format="YYYY-MM-DD HH:mm:ss"
+                    placeholder="选择分娩时间"
+                    clearable
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="新生儿性别">
+                  <el-radio-group v-model="formData.newbornSex">
+                    <el-radio label="1">男</el-radio>
+                    <el-radio label="0">女</el-radio>
+                  </el-radio-group>
+                </el-form-item>
+                <el-form-item label="分娩方式">
+                  <el-select
+                    v-model="formData.deliveryMode"
+                    placeholder="请选择"
+                    clearable
+                    style="width: 100%"
+                  >
+                    <el-option label="顺产" value="sc" />
+                    <el-option label="剖宫产" value="pgc" />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="胎次">
+                  <el-input
+                    v-model="formData.birthOrder"
+                    type="number"
+                    step="any"
+                    :min="1"
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="新生儿体重(克)">
+                  <el-input
+                    v-model="formData.newbornWeightGram"
+                    type="number"
+                    step="any"
+                    :min="0"
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="新生儿评分1分钟">
+                  <el-input
+                    v-model="formData.apgar1min"
+                    type="number"
+                    step="any"
+                    :min="0"
+                    :max="10"
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="新生儿评分5分钟">
+                  <el-input
+                    v-model="formData.apgar5min"
+                    type="number"
+                    step="any"
+                    :min="0"
+                    :max="10"
+                    style="width: 100%"
+                  />
+                </el-form-item>
+              </div>
+            </div>
+
+            <!-- Tab 3: 采集信息 -->
+            <div id="form-section-collection" class="form-tab-pane">
+              <div class="form-grid-5">
+                <el-form-item label="采集地区">
+                  <el-select
+                    v-model="formData.regionId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchRegions"
+                    :loading="regionLoading"
+                    placeholder="输入地区名称检索"
+                    @change="onRegionChange"
+                    @clear="onRegionClear"
+                  >
+                    <el-option
+                      v-for="r in regionOptions"
+                      :key="r.id"
+                      :label="r.regionName"
+                      :value="r.id"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="采集医院">
+                  <el-select
+                    v-model="formData.hospitalId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchHospitals"
+                    :loading="hospitalLoading"
+                    :disabled="!formData.regionId"
+                    placeholder="请先选择采集地区"
+                    @change="onHospitalChange"
+                  >
+                    <el-option
+                      v-for="h in hospitalOptions"
+                      :key="h.id"
+                      :label="h.hospitalName"
+                      :value="h.id"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="采集医护">
+                  <el-input v-model="formData.medicalStaff" placeholder="请输入" />
+                </el-form-item>
+                <el-form-item label="销售人员">
+                  <el-select
+                    v-model="salesUserId"
+                    class="w-full"
+                    filterable
+                    remote
+                    clearable
+                    reserve-keyword
+                    :remote-method="remoteSearchSalesUsers"
+                    :loading="salesLoading"
+                    placeholder="输入姓名检索用户"
+                    @change="onSalesUserChange"
+                  >
+                    <el-option
+                      v-for="u in salesUserOptions"
+                      :key="u.id"
+                      :label="u.nickName + (u.phoneNo ? ' · ' + u.phoneNo : '')"
+                      :value="u.id"
+                    />
+                  </el-select>
+                </el-form-item>
+                <el-form-item label="样本采集时间">
+                  <el-date-picker
+                    v-model="formData.sampleCollectTime"
+                    type="datetime"
+                    value-format="YYYY-MM-DD HH:mm:ss"
+                    placeholder="选择采集时间"
+                    clearable
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <el-form-item label="母血采集时间">
+                  <el-date-picker
+                    v-model="formData.maternalBloodCollectTime"
+                    type="datetime"
+                    value-format="YYYY-MM-DD HH:mm:ss"
+                    placeholder="选择采集时间"
+                    clearable
+                    style="width: 100%"
+                  />
+                </el-form-item>
+              </div>
+            </div>
+
+            <!-- Tab 4: 样本及运输信息 -->
+            <div id="form-section-sample" class="form-tab-pane">
+              <div class="sub-table-toolbar">
+                <el-button type="primary" @click="addSample">
+                  <el-icon><Plus /></el-icon>
+                  添加样本
+                </el-button>
+                <el-button
+                  class="btn-ghost"
+                  :disabled="!selectedSamples.length"
+                  @click="openBatchTransportDialog"
+                >
+                  应用到选中样本
+                </el-button>
+              </div>
+              <p v-if="formData.samples.length" class="sample-transport-hint"
+                >列表可直接查看运输信息；点击行首展开可编辑。勾选样本后，点击「应用到选中样本」可批量填写运输信息。</p
+              >
+              <el-table
+                :data="formData.samples"
+                row-key="_rowKey"
+                stripe
+                border
+                size="small"
+                class="sub-edit-table"
+                @selection-change="onSampleSelectionChange"
+              >
+                <el-table-column type="selection" width="44" align="center" />
+                <el-table-column type="expand" width="48">
+                  <template #default="{ row, $index }">
+                    <div class="sample-transport-panel">
+                      <h4 class="sample-transport-title"
+                        >运输信息 — {{ sampleRowLabel(row, $index) }}</h4
+                      >
+                      <div
+                        class="sample-transport-form-row"
+                        :class="{
+                          'sample-transport-form-row--ryxd':
+                            row.transport.transportType === 'ryxd'
+                        }"
+                      >
+                        <el-form-item label="运输类型">
+                          <el-select
+                            v-model="row.transport.transportType"
+                            placeholder="请选择"
+                            clearable
+                            size="small"
+                            style="width: 100%"
+                          >
+                            <el-option label="快递运输" value="kdys" />
+                            <el-option label="人员携带" value="ryxd" />
+                          </el-select>
+                        </el-form-item>
+                        <el-form-item label="目的站点">
+                          <el-select
+                            v-model="row.transport.destSiteId"
+                            placeholder="选择站点"
+                            filterable
+                            clearable
+                            size="small"
+                            style="width: 100%"
+                          >
+                            <el-option
+                              v-for="site in siteOptions"
+                              :key="site.id"
+                              :label="site.siteName"
+                              :value="site.id"
+                            />
+                          </el-select>
+                        </el-form-item>
+                        <el-form-item label="预计到达时间">
+                          <el-date-picker
+                            v-model="row.transport.etaTime"
+                            type="datetime"
+                            value-format="YYYY-MM-DD HH:mm:ss"
+                            format="YYYY-MM-DD HH:mm"
+                            placeholder="选择预计到达时间"
+                            clearable
+                            size="small"
+                            style="width: 100%"
+                          />
+                        </el-form-item>
+                        <template v-if="row.transport.transportType === 'kdys'">
+                          <el-form-item label="快递公司">
+                            <el-select
+                              v-model="row.transport.expressCompanyId"
+                              placeholder="选择快递公司"
+                              filterable
+                              clearable
+                              size="small"
+                              style="width: 100%"
+                            >
+                              <el-option
+                                v-for="ec in expressCompanyOptions"
+                                :key="ec.id"
+                                :label="ec.expressName"
+                                :value="ec.id"
+                              />
+                            </el-select>
+                          </el-form-item>
+                          <el-form-item label="快递单号">
+                            <el-input
+                              v-model="row.transport.waybillNo"
+                              placeholder="请输入快递单号"
+                              size="small"
+                            />
+                          </el-form-item>
+                          <el-form-item label="快递费用(元)">
+                            <el-input
+                              v-model="row.transport.expressFee"
+                              type="number"
+                              step="any"
+                              :min="0"
+                              size="small"
+                              style="width: 100%"
+                            />
+                          </el-form-item>
+                        </template>
+                        <template v-if="row.transport.transportType === 'ryxd'">
+                          <el-form-item label="携带人员姓名">
+                            <el-input
+                              v-model="row.transport.carrierName"
+                              placeholder="请输入姓名"
+                              size="small"
+                            />
+                          </el-form-item>
+                          <el-form-item label="携带人员电话">
+                            <el-input
+                              v-model="row.transport.carrierPhone"
+                              placeholder="请输入电话"
+                              size="small"
+                            />
+                          </el-form-item>
+                        </template>
+                      </div>
+                    </div>
+                  </template>
+                </el-table-column>
+                <el-table-column label="样本类型" min-width="160">
+                  <template #default="{ row }">
+                    <el-select
+                      v-model="row.sampleTypeId"
+                      placeholder="选择类型"
+                      size="small"
+                      style="width: 100%"
+                      @change="onSampleTypeChange(row)"
+                    >
+                      <el-option
+                        v-for="st in sampleTypeOptions"
+                        :key="st.id"
+                        :label="st.typeName + (st.typeCode ? ' (' + st.typeCode + ')' : '')"
+                        :value="st.id"
+                      />
+                    </el-select>
+                  </template>
+                </el-table-column>
+                <el-table-column label="样本编码" min-width="160">
+                  <template #default="{ row }">
+                    <el-select
+                      v-model="row.sampleCodeId"
+                      placeholder="选择编码"
+                      size="small"
+                      filterable
+                      style="width: 100%"
+                      @change="onSampleCodeChange(row)"
+                    >
+                      <el-option
+                        v-for="sc in sampleCodeOptions"
+                        :key="sc.id"
+                        :label="sc.issued ? `${sc.sampleCode}（已使用）` : sc.sampleCode"
+                        :value="sc.id"
+                        :disabled="!!sc.issued"
+                      />
+                    </el-select>
+                  </template>
+                </el-table-column>
+                <el-table-column label="采集量" width="110">
+                  <template #default="{ row }">
+                    <el-input
+                      v-model="row.collectAmount"
+                      type="number"
+                      step="any"
+                      :min="0"
+                      size="small"
+                      style="width: 100%"
+                    />
+                  </template>
+                </el-table-column>
+                <el-table-column label="单位" width="100">
+                  <template #default="{ row }">
+                    <el-select
+                      v-model="row.unitId"
+                      placeholder="单位"
+                      size="small"
+                      filterable
+                      style="width: 100%"
+                    >
+                      <el-option
+                        v-for="u in unitOptions"
+                        :key="u.id"
+                        :label="u.unitName"
+                        :value="u.id"
+                      />
+                    </el-select>
+                  </template>
+                </el-table-column>
+                <el-table-column label="价格" width="120">
+                  <template #default="{ row }">
+                    <el-input
+                      v-model="row.price"
+                      type="number"
+                      step="any"
+                      :min="0"
+                      size="small"
+                      style="width: 100%"
+                      @change="onSamplePriceChange"
+                    />
+                  </template>
+                </el-table-column>
+                <el-table-column label="存储年限(年)" width="120">
+                  <template #default="{ row }">
+                    <el-input
+                      v-model="row.storageYears"
+                      type="number"
+                      step="any"
+                      :min="0"
+                      size="small"
+                      style="width: 100%"
+                    />
+                  </template>
+                </el-table-column>
+                <el-table-column label="样本状态" width="120">
+                  <template #default="{ row }">
+                    <el-select
+                      v-model="row.sampleStatus"
+                      placeholder="状态"
+                      size="small"
+                      clearable
+                      style="width: 100%"
+                      @change="onSampleStatusChange(row)"
+                    >
+                      <el-option label="已采集" value="ycj" />
+                      <el-option label="检测中" value="jcz" />
+                      <el-option label="已入库" value="yrk" />
+                      <el-option label="已作废" value="yzf" />
+                    </el-select>
+                  </template>
+                </el-table-column>
+                <el-table-column label="运输类型" width="100" align="center">
+                  <template #default="{ row }">
+                    <span
+                      class="sample-transport-cell"
+                      :class="{ 'is-empty': !row.transport?.transportType }"
+                    >
+                      {{ transportTypeLabel(String(row.transport?.transportType || '')) }}
+                    </span>
+                  </template>
+                </el-table-column>
+                <el-table-column label="目的站点" min-width="110" show-overflow-tooltip>
+                  <template #default="{ row }">
+                    <span
+                      class="sample-transport-cell"
+                      :class="{ 'is-empty': !row.transport?.destSiteId }"
+                    >
+                      {{ siteName(String(row.transport?.destSiteId || '')) }}
+                    </span>
+                  </template>
+                </el-table-column>
+                <el-table-column label="预计到达" min-width="150" show-overflow-tooltip>
+                  <template #default="{ row }">
+                    <span
+                      class="sample-transport-cell"
+                      :class="{ 'is-empty': !row.transport?.etaTime }"
+                    >
+                      {{ row.transport?.etaTime || '-' }}
+                    </span>
+                  </template>
+                </el-table-column>
+                <el-table-column
+                  label="快递/携带"
+                  min-width="160"
+                  show-overflow-tooltip
+                >
+                  <template #default="{ row }">
+                    <span
+                      class="sample-transport-cell"
+                      :class="{ 'is-empty': sampleTransportExtra(row.transport) === '-' }"
+                    >
+                      {{ sampleTransportExtra(row.transport) }}
+                    </span>
+                  </template>
+                </el-table-column>
+                <el-table-column label="操作" width="70" align="center">
+                  <template #default="{ $index }">
+                    <el-button link type="danger" size="small" @click="removeSample($index)"
+                      >删除</el-button
+                    >
+                  </template>
+                </el-table-column>
+              </el-table>
+              <el-empty
+                v-if="!formData.samples.length"
+                description="暂无样本，点击上方按钮添加"
+                :image-size="48"
+              />
+            </div>
+
+            <!-- Tab 5: 缴费信息 -->
+            <div id="form-section-payment" class="form-tab-pane">
+              <h3 class="detail-section-title">缴费主表</h3>
+              <div class="form-grid-5">
+                <el-form-item label="缴费模式">
+                  <el-radio-group v-model="formData.payMode" @change="onPayModeChange">
+                    <el-radio label="dj">趸交</el-radio>
+                    <el-radio label="fq">分期</el-radio>
+                  </el-radio-group>
+                </el-form-item>
+                <el-form-item label="合同金额">
+                  <el-input
+                    v-model="formData.contractAmount"
+                    disabled
+                    placeholder="自动计算"
+                    style="width: 100%"
+                  />
+                </el-form-item>
+                <template v-if="formData.payMode === 'dj'">
+                  <el-form-item label="趸交截止时间">
+                    <el-date-picker
+                      v-model="formData.lumpSumDeadline"
+                      type="date"
+                      value-format="YYYYMMDD"
+                      format="YYYY-MM-DD"
+                      placeholder="选择截止时间"
+                      clearable
+                      style="width: 100%"
+                    />
+                  </el-form-item>
+                </template>
+                <template v-if="formData.payMode === 'fq'">
+                  <el-form-item label="分期期数">
+                    <el-input
+                      v-model="formData.installmentCount"
+                      type="number"
+                      step="any"
+                      :min="1"
+                      style="width: 100%"
+                      @change="tryGenerateInstallmentDetails"
+                    />
+                  </el-form-item>
+                  <el-form-item label="每期间隔(月)">
+                    <el-input
+                      v-model="formData.installmentIntervalMonths"
+                      type="number"
+                      step="any"
+                      :min="1"
+                      style="width: 100%"
+                      @change="tryGenerateInstallmentDetails"
+                    />
+                  </el-form-item>
+                  <el-form-item label="分期开始时间">
+                    <el-date-picker
+                      v-model="formData.installmentStartDate"
+                      type="date"
+                      value-format="YYYYMMDD"
+                      format="YYYY-MM-DD"
+                      placeholder="选择开始时间"
+                      clearable
+                      style="width: 100%"
+                      @change="tryGenerateInstallmentDetails"
+                    />
+                  </el-form-item>
+                </template>
+              </div>
+
+              <div class="form-section-divider" />
+              <h3 class="detail-section-title">缴费明细</h3>
+              <div class="sub-table-toolbar">
+                <el-button type="primary" @click="addPaymentDetail">
+                  <el-icon><Plus /></el-icon>
+                  添加明细
+                </el-button>
+              </div>
+              <div class="payment-detail-cards">
+                <div
+                  v-for="(detail, dIdx) in formData.paymentDetails"
+                  :key="dIdx"
+                  class="payment-detail-card"
+                  :class="{ 'is-collapsed': !detail._expanded }"
+                >
+                  <div
+                    class="payment-detail-card__header"
+                    role="button"
+                    tabindex="0"
+                    @click="togglePaymentDetailExpand(dIdx)"
+                    @keydown.enter.prevent="togglePaymentDetailExpand(dIdx)"
+                  >
+                    <div class="payment-detail-card__header-main">
+                      <el-icon class="payment-detail-card__chevron">
+                        <ArrowDown v-if="detail._expanded" />
+                        <ArrowRight v-else />
+                      </el-icon>
+                      <span class="payment-detail-card__title">缴费明细 #{{ dIdx + 1 }}</span>
+                      <span v-if="!detail._expanded" class="payment-detail-card__summary">
+                        {{ paymentDetailSummary(detail) }}
+                      </span>
+                    </div>
+                    <el-button
+                      link
+                      type="danger"
+                      size="small"
+                      @click.stop="formData.paymentDetails.splice(dIdx, 1)"
+                    >
+                      <el-icon><Delete /></el-icon>删除
+                    </el-button>
+                  </div>
+                  <div v-show="detail._expanded" class="payment-detail-card__body">
+                    <div class="form-grid-4">
+                      <el-form-item label="应缴费金额">
+                        <el-input
+                          v-model="detail.dueAmount"
+                          type="number"
+                          step="any"
+                          :min="0"
+                          disabled
+                          style="width: 100%"
+                        />
+                      </el-form-item>
+                      <el-form-item label="转账方式">
+                        <el-select
+                          v-model="detail.transferType"
+                          placeholder="请选择转账方式"
+                          style="width: 100%"
+                        >
+                          <el-option label="微信" value="wxzz" />
+                          <el-option label="支付宝" value="zzbzz" />
+                          <el-option label="银行卡" value="yhkzz" />
+                          <el-option label="现金" value="xj" />
+                        </el-select>
+                      </el-form-item>
+                      <el-form-item label="转账金额">
+                        <el-input
+                          v-model="detail.transferAmount"
+                          type="number"
+                          step="any"
+                          :min="0"
+                          style="width: 100%"
+                        />
+                      </el-form-item>
+                      <el-form-item label="转账时间">
+                        <el-date-picker
+                          v-model="detail.transferTime"
+                          type="datetime"
+                          value-format="YYYY-MM-DD HH:mm:ss"
+                          placeholder="选择时间"
+                          clearable
+                          style="width: 100%"
+                        />
+                      </el-form-item>
+                      <el-form-item label="缴费状态">
+                        <el-select
+                          v-model="detail.payStatus"
+                          placeholder="状态"
+                          style="width: 100%"
+                        >
+                          <el-option label="待缴费" value="dfj" />
+                          <el-option label="缴费确认中" value="jfqrz" />
+                          <el-option label="已缴费" value="yjf" />
+                          <el-option label="退费确认中" value="tfqrz" />
+                          <el-option label="已退费" value="ytf" />
+                        </el-select>
+                      </el-form-item>
+                      <el-form-item v-if="formData.payMode === 'fq'" label="应缴费时间">
+                        <el-date-picker
+                          v-model="detail.installmentDueDate"
+                          type="date"
+                          value-format="YYYYMMDD"
+                          format="YYYY-MM-DD"
+                          placeholder="选择应缴费时间"
+                          clearable
+                          style="width: 100%"
+                        />
+                      </el-form-item>
+                    </div>
+                    <!-- 每条明细的附件上传区 -->
+                    <div class="payment-detail-card__attachments">
+                      <div class="attachment-upload">
+                        <div class="attachment-list">
+                          <el-upload
+                            :auto-upload="false"
+                            :show-file-list="false"
+                            :multiple="true"
+                            accept="image/*,video/*,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.txt,.zip,.rar"
+                            @change="(f: any) => handleDetailAttachmentChange(dIdx, f)"
+                          >
+                            <div class="upload-card upload-card--sm">
+                              <el-icon :size="22" color="#10b981"><Plus /></el-icon>
+                              <span class="upload-card-text">上传凭证</span>
+                            </div>
+                          </el-upload>
+                          <div
+                            v-for="(file, fIdx) in detail.attachments"
+                            :key="file.id || fIdx"
+                            class="attachment-item"
+                            :class="{ 'is-uploading': file._uploading }"
+                          >
+                            <div
+                              class="attachment-preview"
+                              @click="
+                                isImageFile(file) && file.fileUrl
+                                  ? handlePreviewAttachment(file)
+                                  : undefined
+                              "
+                            >
+                              <template v-if="isImageFile(file) && file.fileUrl">
+                                <img :src="fullFileUrl(file.fileUrl)" :alt="file.fileName" />
+                              </template>
+                              <template v-else-if="isImageFile(file) && !file.fileUrl">
+                                <el-icon :size="24" color="#94a3b8"><Loading /></el-icon>
+                              </template>
+                              <template v-else-if="isVideoFile(file)">
+                                <div
+                                  class="attachment-preview__icon attachment-preview__icon--video"
+                                >
+                                  <el-icon :size="28"><VideoPlay /></el-icon>
+                                </div>
+                              </template>
+                              <template v-else>
+                                <div class="attachment-preview__icon attachment-preview__icon--doc">
+                                  <el-icon :size="28"><Document /></el-icon>
+                                </div>
+                              </template>
+                            </div>
+                            <div class="attachment-footer">
+                              <span class="attachment-name" :title="file.fileName">{{
+                                file.fileName
+                              }}</span>
+                              <div class="attachment-actions">
+                                <el-icon
+                                  class="action-btn"
+                                  title="下载"
+                                  @click="handleDownloadAttachment(file)"
+                                  ><Download
+                                /></el-icon>
+                                <el-icon
+                                  class="action-btn action-btn--danger"
+                                  title="删除"
+                                  @click="removeDetailAttachment(dIdx, fIdx)"
+                                  ><Delete
+                                /></el-icon>
+                              </div>
+                            </div>
+                          </div>
+                        </div>
+                        <span class="upload-hint"
+                          >支持图片、视频、PDF、Word、Excel等文件，单文件不超过 20MB</span
+                        >
+                      </div>
+                    </div>
+                  </div>
+                </div>
+                <el-empty
+                  v-if="!formData.paymentDetails.length"
+                  description="暂无缴费明细，点击上方按钮添加"
+                  :image-size="48"
+                />
+              </div>
+            </div>
+          </el-form>
+        </div>
+
+        <template #footer>
+          <el-button class="btn-ghost" @click="emit('update:modelValue', false)">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="submitLoading" @click="handleSubmit">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+
+      <!-- ========== 文件预览弹窗 ========== -->
+      <el-dialog
+        v-model="previewVisible"
+        title="文件预览"
+        width="800px"
+        align-center
+        destroy-on-close
+      >
+        <div v-if="previewType === 'image'" class="preview-container">
+          <img
+            :src="previewUrl"
+            alt="预览"
+            style="max-width: 100%; max-height: 70vh; display: block; margin: 0 auto"
+          />
+        </div>
+        <div v-else class="preview-container">
+          <video
+            :src="previewUrl"
+            controls
+            style="max-width: 100%; max-height: 70vh; display: block; margin: 0 auto"
+          />
+        </div>
+      </el-dialog>
+
+      <!-- ========== 批量运输信息弹窗 ========== -->
+      <el-dialog
+        v-model="batchTransportVisible"
+        title="批量运输信息"
+        width="1200px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <p class="sample-transport-hint batch-transport-dialog-hint">
+          将以下运输信息应用到已选中的 {{ selectedSamples.length }} 个样本。
+        </p>
+        <el-form label-position="top" class="biz-dialog-form">
+          <div
+            class="sample-transport-form-row"
+            :class="{
+              'sample-transport-form-row--ryxd': batchTransport.transportType === 'ryxd'
+            }"
+          >
+            <el-form-item label="运输类型">
+              <el-select
+                v-model="batchTransport.transportType"
+                placeholder="请选择"
+                clearable
+                style="width: 100%"
+              >
+                <el-option label="快递运输" value="kdys" />
+                <el-option label="人员携带" value="ryxd" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="目的站点">
+              <el-select
+                v-model="batchTransport.destSiteId"
+                placeholder="选择站点"
+                filterable
+                clearable
+                style="width: 100%"
+              >
+                <el-option
+                  v-for="site in siteOptions"
+                  :key="site.id"
+                  :label="site.siteName"
+                  :value="site.id"
+                />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="预计到达时间">
+              <el-date-picker
+                v-model="batchTransport.etaTime"
+                type="datetime"
+                value-format="YYYY-MM-DD HH:mm:ss"
+                format="YYYY-MM-DD HH:mm"
+                placeholder="选择预计到达时间"
+                clearable
+                style="width: 100%"
+              />
+            </el-form-item>
+            <template v-if="batchTransport.transportType === 'kdys'">
+              <el-form-item label="快递公司">
+                <el-select
+                  v-model="batchTransport.expressCompanyId"
+                  placeholder="选择快递公司"
+                  filterable
+                  clearable
+                  style="width: 100%"
+                >
+                  <el-option
+                    v-for="ec in expressCompanyOptions"
+                    :key="ec.id"
+                    :label="ec.expressName"
+                    :value="ec.id"
+                  />
+                </el-select>
+              </el-form-item>
+              <el-form-item label="快递单号">
+                <el-input v-model="batchTransport.waybillNo" placeholder="请输入快递单号" />
+              </el-form-item>
+              <el-form-item label="快递费用(元)">
+                <el-input
+                  v-model="batchTransport.expressFee"
+                  type="number"
+                  step="any"
+                  :min="0"
+                  style="width: 100%"
+                />
+              </el-form-item>
+            </template>
+            <template v-if="batchTransport.transportType === 'ryxd'">
+              <el-form-item label="携带人员姓名">
+                <el-input v-model="batchTransport.carrierName" placeholder="请输入姓名" />
+              </el-form-item>
+              <el-form-item label="携带人员电话">
+                <el-input v-model="batchTransport.carrierPhone" placeholder="请输入电话" />
+              </el-form-item>
+            </template>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchTransportVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="confirmBatchTransportApply">
+            <el-icon><Check /></el-icon>
+            确定应用
+          </el-button>
+        </template>
+      </el-dialog>
+</template>
+<script setup lang="ts">
+  import { ElMessage } from 'element-plus'
+  import {
+    Plus,
+    Close,
+    Check,
+    Delete,
+    Document,
+    VideoPlay,
+    Loading,
+    Download,
+    ArrowDown,
+    ArrowRight
+  } from '@element-plus/icons-vue'
+  import {
+    fetchCollectionProtocolDetail,
+    fetchCreateCollectionProtocol,
+    fetchUpdateCollectionProtocol,
+    type CollectionProtocolRow
+  } from '@/api/collection-protocol'
+  import { fetchUploadAttachment } from '@/api/business'
+  import {
+    fetchCustomerList,
+    fetchUserList,
+    fetchUserDetail,
+    fetchCellSampleTypeList,
+    fetchItemUnitList,
+    fetchCollectionRegionList,
+    fetchHospitalList,
+    fetchCollectionProtocolNoList,
+    fetchSampleCodeList,
+    fetchExpressCompanyList,
+    fetchSiteList
+  } from '@/api/admin'
+  import { fetchEthnicList, type EthnicOption } from '@/api/ethnic'
+  import { useUserStore } from '@/store/modules/user'
+
+  const userStore = useUserStore()
+
+  const customerId = ref<string | null>(null)
+  const customerOptions = ref<
+    Array<{ id: string; customerName: string; phoneNo: string; idCardNo: string }>
+  >([])
+  const customerLoading = ref(false)
+  const customerSnapshot = ref<{
+    id: string
+    customerName: string
+    phoneNo: string
+    idCardNo: string
+  } | null>(null)
+
+  const regionOptions = ref<Api.BizCollectionRegion.RegionItem[]>([])
+  const regionLoading = ref(false)
+  const hospitalOptions = ref<Api.BizCollectionHospital.HospitalItem[]>([])
+  const hospitalLoading = ref(false)
+
+  const collectorUserId = ref<string | null>(null)
+  const collectorUserOptions = ref<Api.User.UserItem[]>([])
+  const collectorLoading = ref(false)
+  const collectorSnapshot = ref<Api.User.UserItem | null>(null)
+
+  const salesUserId = ref<string | null>(null)
+  const salesUserOptions = ref<Api.User.UserItem[]>([])
+  const salesLoading = ref(false)
+  const salesSnapshot = ref<Api.User.UserItem | null>(null)
+
+  const sampleTypeOptions = ref<
+    Array<{
+      id: string
+      typeCode: string
+      typeName: string
+      storageYears: number | null
+      storagePrice: number | null
+    }>
+  >([])
+  const unitOptions = ref<Array<{ id: string; unitName: string; unitCode: string }>>([])
+  const protocolNoOptions = ref<Api.BizCollectionProtocolNo.ProtocolNoItem[]>([])
+  const protocolNoLoading = ref(false)
+  const sampleCodeOptions = ref<Api.BizSampleCode.SampleCodeItem[]>([])
+  const sampleCodeLoading = ref(false)
+  const expressCompanyOptions = ref<Api.ExpressCompany.ExpressCompanyItem[]>([])
+  const siteOptions = ref<Api.Site.SiteItem[]>([])
+  const selectedSamples = ref<Array<Record<string, any>>>([])
+  let sampleRowSeq = 0
+
+  type SampleTransportForm = {
+    transportType: string
+    expressCompanyId: string
+    waybillNo: string
+    destSiteId: string
+    expressFee: number | null
+    etaTime: string
+    carrierName: string
+    carrierPhone: string
+  }
+
+  function createEmptyTransport(): SampleTransportForm {
+    return {
+      transportType: '',
+      expressCompanyId: '',
+      waybillNo: '',
+      destSiteId: '',
+      expressFee: null,
+      etaTime: '',
+      carrierName: '',
+      carrierPhone: ''
+    }
+  }
+
+  const batchTransport = reactive<SampleTransportForm>(createEmptyTransport())
+  const batchTransportVisible = ref(false)
+  const ethnicOptions = ref<EthnicOption[]>([])
+  const ethnicLoading = ref(false)
+  const DEFAULT_MOTHER_ETHNIC = '汉族'
+  const minioBaseUrl = (import.meta.env.VITE_MINIO_BASE_URL || '').replace(/\/$/, '')
+
+  function fullFileUrl(suffix: string) {
+    if (!suffix) return ''
+    if (suffix.startsWith('http://') || suffix.startsWith('https://') || suffix.startsWith('/'))
+      return suffix
+    return `${minioBaseUrl}/${suffix}`
+  }
+
+  async function loadEthnicOptions() {
+    if (ethnicOptions.value.length) return
+    ethnicLoading.value = true
+    try {
+      const res = await fetchEthnicList({ limit: 200 })
+      ethnicOptions.value = res.list || []
+    } finally {
+      ethnicLoading.value = false
+    }
+  }
+
+  function ensureEthnicOptionInList(name: string) {
+    const n = (name || '').trim()
+    if (!n) return
+    if (ethnicOptions.value.some((e) => e.ethnicName === n)) return
+    ethnicOptions.value = [
+      { id: '', ethnicName: n, ethnicCode: '', orderNum: null },
+      ...ethnicOptions.value
+    ]
+  }
+
+  defineOptions({ name: 'ProtocolFormDialog' })
+
+  const props = defineProps<{
+    modelValue: boolean
+    editId: string | null
+    listRow?: CollectionProtocolRow | null
+  }>()
+
+  const emit = defineEmits<{
+    (e: 'update:modelValue', val: boolean): void
+    (e: 'saved'): void
+  }>()
+
+  /* ====== 标签映射 ====== */
+  function protocolStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dsx: '待生效',
+      sxz: '生效中',
+      ygq: '已过期',
+      yzf: '已作废',
+      zky: '转科研'
+    }
+    return m[s] || s || '-'
+  }
+
+  function payModeLabel(s: string) {
+    if (s === 'dj') return '趸交'
+    if (s === 'fq') return '分期'
+    return s || '-'
+  }
+
+  function newbornSexLabel(s: string) {
+    if (s === '1') return '男'
+    if (s === '0') return '女'
+    return s || '-'
+  }
+
+  function deliveryModeLabel(s: string) {
+    if (s === 'sc') return '顺产'
+    if (s === 'pgc') return '剖宫产'
+    return s || '-'
+  }
+
+  function sampleStatusLabel(s: string) {
+    const m: Record<string, string> = { ycj: '已采集', jcz: '检测中', yrk: '已入库', yzf: '已作废' }
+    return m[s] || s || '-'
+  }
+
+  function transportTypeLabel(s: string) {
+    if (s === 'kdys') return '快递运输'
+    if (s === 'ryxd') return '人员携带'
+    return s || '-'
+  }
+
+  function siteName(id: string) {
+    if (!id) return '-'
+    return siteOptions.value.find((x) => x.id === id)?.siteName || '-'
+  }
+
+  function expressName(id: string) {
+    if (!id) return '-'
+    return expressCompanyOptions.value.find((x) => x.id === id)?.expressName || '-'
+  }
+
+  function sampleTransportExtra(transport: Record<string, any> | undefined) {
+    if (!transport?.transportType) return '-'
+    if (transport.transportType === 'kdys') {
+      const parts: string[] = []
+      const ec = expressName(String(transport.expressCompanyId || ''))
+      if (ec !== '-') parts.push(ec)
+      if (transport.waybillNo) parts.push(String(transport.waybillNo))
+      if (transport.expressFee != null && transport.expressFee !== '') {
+        parts.push(`¥${transport.expressFee}`)
+      }
+      return parts.length ? parts.join(' · ') : '-'
+    }
+    if (transport.transportType === 'ryxd') {
+      const parts: string[] = []
+      if (transport.carrierName) parts.push(String(transport.carrierName))
+      if (transport.carrierPhone) parts.push(String(transport.carrierPhone))
+      return parts.length ? parts.join(' · ') : '-'
+    }
+    return '-'
+  }
+
+  function sampleRowLabel(row: Record<string, any>, index: number) {
+    if (row.sampleCode) return row.sampleCode
+    const st = sampleTypeOptions.value.find((x) => x.id === row.sampleTypeId)
+    if (st?.typeName) return st.typeName
+    return `样本 ${index + 1}`
+  }
+
+  function transferTypeLabel(s: string) {
+    const m: Record<string, string> = { wxzz: '微信', zzbzz: '支付宝', yhkzz: '银行卡', xj: '现金' }
+    return m[s] || s || '-'
+  }
+
+  function formatPaymentDateYmd(val: string) {
+    const s = String(val || '').trim()
+    if (s.length === 8 && /^\d{8}$/.test(s)) {
+      return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}`
+    }
+    return s || ''
+  }
+
+  function initPaymentDetailExpandFlags(details: Array<Record<string, any>>) {
+    details.forEach((d, i) => {
+      d._expanded = i === 0
+    })
+  }
+
+  function paymentDetailSummary(detail: Record<string, any>) {
+    const parts: string[] = []
+    if (detail.dueAmount != null && detail.dueAmount !== '') {
+      parts.push(`应缴 ¥${detail.dueAmount}`)
+    }
+    if (detail.transferType) {
+      parts.push(transferTypeLabel(String(detail.transferType)))
+    }
+    if (detail.transferAmount != null && detail.transferAmount !== '') {
+      parts.push(`转账 ¥${detail.transferAmount}`)
+    }
+    if (detail.transferTime) {
+      parts.push(String(detail.transferTime))
+    }
+    if (detail.payStatus) {
+      parts.push(payStatusLabel(String(detail.payStatus)))
+    }
+    if (formData.payMode === 'fq' && detail.installmentDueDate) {
+      parts.push(`应缴日 ${formatPaymentDateYmd(String(detail.installmentDueDate))}`)
+    }
+    const attCount = Array.isArray(detail.attachments) ? detail.attachments.length : 0
+    if (attCount > 0) {
+      parts.push(`凭证 ${attCount} 个`)
+    }
+    return parts.length ? parts.join(' · ') : '暂无填写'
+  }
+
+  function togglePaymentDetailExpand(dIdx: number) {
+    const d = formData.paymentDetails[dIdx]
+    if (d) {
+      d._expanded = !d._expanded
+    }
+  }
+
+  function payStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dfj: '待缴费',
+      jfqrz: '缴费确认中',
+      yjf: '已缴费',
+      tfqrz: '退费确认中',
+      ytf: '已退费'
+    }
+    return m[s] || s || '-'
+  }
+
+  /* ====== Tab 常量 ====== */
+  const formTabs = [
+    { key: 'basic', label: '基本信息' },
+    { key: 'party', label: '客户信息' },
+    { key: 'collection', label: '采集信息' },
+    { key: 'sample', label: '样本及运输信息' },
+    { key: 'payment', label: '缴费信息' }
+  ] as const
+
+  /* ====== 新增/编辑弹窗 ====== */
+  const dialogFormLoading = ref(false)
+  const dialogTitle = ref('新增协议单')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const editingId = ref<string | null>(null)
+  const formRef = ref()
+  const activeFormTab = ref('basic')
+
+  const formData = reactive({
+    // Basic
+    protocolNo: '',
+    protocolNoId: '',
+    protocolStatus: 'dsx',
+    registerDate: '',
+    collectorUserId: '',
+    protocolAttachments: '',
+    remark: '',
+    attachments: [] as Array<{
+      id?: string
+      fileName: string
+      fileUrl: string
+      fileSize: number
+      fileSizeDisplay?: string
+      fileType?: string
+      _uploading?: boolean
+    }>,
+    // Party Customer
+    customerId: '' as string,
+    motherName: '',
+    motherPhone: '',
+    motherIdCard: '',
+    motherBirthYm: '',
+    motherEthnic: '',
+    motherAddress: '',
+    fatherName: '',
+    fatherPhone: '',
+    fatherIdCard: '',
+    newbornName: '',
+    newbornIdCard: '',
+    newbornDeliveryTime: '',
+    newbornSex: '',
+    deliveryMode: '',
+    birthOrder: null as number | null,
+    newbornWeightGram: null as number | null,
+    apgar1min: null as number | null,
+    apgar5min: null as number | null,
+    // Collection Info
+    regionId: '',
+    hospitalId: '',
+    medicalStaff: '',
+    salesUserId: '',
+    sampleCollectTime: '',
+    maternalBloodCollectTime: '',
+    // Samples
+    samples: [] as Array<Record<string, any>>,
+    // Payment
+    payMode: 'dj',
+    contractAmount: null as number | null,
+    installmentCount: null as number | null,
+    installmentIntervalMonths: null as number | null,
+    lumpSumDeadline: '',
+    installmentStartDate: '',
+    // Payment Details
+    paymentDetails: [] as Array<Record<string, any>>
+  })
+
+  const formRules = {
+    protocolNo: [{ required: true, message: '请输入协议号', trigger: 'blur' }],
+    protocolStatus: [{ required: true, message: '请选择协议状态', trigger: 'change' }]
+  }
+
+  function resetForm() {
+    Object.assign(formData, {
+      protocolNo: '',
+      protocolNoId: '',
+      protocolStatus: 'dsx',
+      registerDate: '',
+      collectorUserId: '',
+      protocolAttachments: '',
+      attachments: [],
+      remark: '',
+      customerId: '',
+      motherName: '',
+      motherPhone: '',
+      motherIdCard: '',
+      motherBirthYm: '',
+      motherEthnic: '',
+      motherAddress: '',
+      fatherName: '',
+      fatherPhone: '',
+      fatherIdCard: '',
+      newbornName: '',
+      newbornIdCard: '',
+      newbornDeliveryTime: '',
+      newbornSex: '',
+      deliveryMode: '',
+      birthOrder: null,
+      newbornWeightGram: null,
+      apgar1min: null,
+      apgar5min: null,
+      regionId: '',
+      hospitalId: '',
+      medicalStaff: '',
+      salesUserId: '',
+      sampleCollectTime: '',
+      maternalBloodCollectTime: '',
+      samples: [],
+      payMode: 'dj',
+      contractAmount: null,
+      installmentCount: null,
+      installmentIntervalMonths: null,
+      lumpSumDeadline: '',
+      installmentStartDate: '',
+      paymentDetails: []
+    })
+    customerId.value = null
+    customerOptions.value = []
+    customerSnapshot.value = null
+    collectorUserId.value = null
+    collectorUserOptions.value = []
+    collectorSnapshot.value = null
+    salesUserId.value = null
+    salesUserOptions.value = []
+    salesSnapshot.value = null
+    regionOptions.value = []
+    hospitalOptions.value = []
+    protocolNoOptions.value = []
+    selectedSamples.value = []
+    batchTransportVisible.value = false
+    Object.assign(batchTransport, createEmptyTransport())
+    activeFormTab.value = 'basic'
+  }
+
+  function scrollToSection(key: string) {
+    activeFormTab.value = key
+    const el = document.getElementById(`form-section-${key}`)
+    if (el) {
+      el.scrollIntoView({ behavior: 'smooth', block: 'start' })
+    }
+  }
+
+  function normalizeSampleRow(raw: Record<string, any>, index: number) {
+    const transportRaw = raw.transport && typeof raw.transport === 'object' ? raw.transport : {}
+    const statusRaw = raw.sampleStatus
+    const sampleStatus =
+      statusRaw != null && String(statusRaw).trim() !== '' ? String(statusRaw).trim() : ''
+    return {
+      ...raw,
+      sampleStatus,
+      _rowKey: raw.id || raw._rowKey || `new-${++sampleRowSeq}`,
+      transport: {
+        ...createEmptyTransport(),
+        transportType: transportRaw.transportType || '',
+        expressCompanyId: transportRaw.expressCompanyId || '',
+        waybillNo: transportRaw.waybillNo || '',
+        destSiteId: transportRaw.destSiteId || '',
+        expressFee: transportRaw.expressFee ?? null,
+        etaTime: transportRaw.etaTime || '',
+        carrierName: transportRaw.carrierName || '',
+        carrierPhone: transportRaw.carrierPhone || ''
+      }
+    }
+  }
+
+  function onSampleSelectionChange(rows: Array<Record<string, any>>) {
+    selectedSamples.value = rows
+  }
+
+  function openBatchTransportDialog() {
+    if (!selectedSamples.value.length) {
+      ElMessage.warning('请先勾选需要应用运输信息的样本')
+      return
+    }
+    batchTransportVisible.value = true
+  }
+
+  function confirmBatchTransportApply() {
+    if (!batchTransport.transportType) {
+      ElMessage.warning('请选择运输类型')
+      return
+    }
+    const payload = { ...batchTransport }
+    for (const row of selectedSamples.value) {
+      if (!row.transport) row.transport = createEmptyTransport()
+      Object.assign(row.transport, payload)
+    }
+    batchTransportVisible.value = false
+    ElMessage.success(`已为 ${selectedSamples.value.length} 个样本应用运输信息`)
+  }
+
+  function addSample() {
+    formData.samples.push(
+      normalizeSampleRow(
+        {
+          sampleTypeId: '',
+          sampleCode: '',
+          sampleCodeId: '',
+          collectAmount: null,
+          unitId: '',
+          price: null,
+          storageYears: null,
+          sampleStatus: 'ycj'
+        },
+        formData.samples.length
+      )
+    )
+  }
+
+  function removeSample(index: number) {
+    formData.samples.splice(index, 1)
+    syncContractAmount()
+  }
+
+  function addPaymentDetail() {
+    const now = new Date()
+    const pad = (n: number) => String(n).padStart(2, '0')
+    const defaultTime = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`
+    const isFirst = formData.paymentDetails.length === 0
+    formData.paymentDetails.push({
+      transferType: '',
+      dueAmount: null,
+      transferAmount: null,
+      transferTime: defaultTime,
+      payStatus: 'dfj',
+      installmentDueDate: '',
+      _expanded: isFirst,
+      attachments: [] as Array<{
+        id?: string
+        fileName: string
+        fileUrl: string
+        fileSize: number
+        fileSizeDisplay?: string
+        fileType?: string
+        _uploading?: boolean
+      }>
+    })
+    syncPaymentDueAmounts()
+  }
+
+  /** 日期加 N 个月，返回 YYYYMMDD 格式（入参支持 YYYYMMDD 或 YYYY-MM-DD） */
+  function addMonths(dateStr: string, months: number): string {
+    const compact = dateStr.replace(/-/g, '')
+    const y = parseInt(compact.slice(0, 4), 10)
+    const m = parseInt(compact.slice(4, 6), 10) - 1
+    const d = parseInt(compact.slice(6, 8), 10)
+    const date = new Date(y, m + months, d)
+    const yy = date.getFullYear()
+    const mm = String(date.getMonth() + 1).padStart(2, '0')
+    const dd = String(date.getDate()).padStart(2, '0')
+    return `${yy}${mm}${dd}`
+  }
+
+  /** 分期模式：三个参数都填好后自动生成缴费明细行 */
+  function tryGenerateInstallmentDetails() {
+    if (formData.payMode !== 'fq') return
+    const count = formData.installmentCount
+    const interval = formData.installmentIntervalMonths
+    const startDate = formData.installmentStartDate
+    if (!count || !interval || !startDate) return
+
+    const dueAmounts = calcInstallmentDueAmounts(formData.contractAmount, count)
+    const details = []
+    for (let i = 0; i < count; i++) {
+      details.push({
+        transferType: '',
+        dueAmount: dueAmounts[i] ?? null,
+        transferAmount: null,
+        transferTime: '',
+        payStatus: 'dfj',
+        installmentDueDate: addMonths(startDate, i * interval),
+        attachments: [] as Array<{
+          id?: string
+          fileName: string
+          fileUrl: string
+          fileSize: number
+          fileSizeDisplay?: string
+          fileType?: string
+          _uploading?: boolean
+        }>
+      })
+    }
+    initPaymentDetailExpandFlags(details)
+    formData.paymentDetails = details
+  }
+
+  /** 缴费模式切换回调 */
+  function onPayModeChange(val: string) {
+    if (val === 'fq') {
+      tryGenerateInstallmentDetails()
+    } else {
+      syncPaymentDueAmounts()
+    }
+  }
+
+  function handleOpenForAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增协议单'
+    resetForm()
+    formData.motherEthnic = DEFAULT_MOTHER_ETHNIC
+    formData.registerDate = new Date().toISOString().slice(0, 10).replace(/-/g, '')
+    loadSampleOptions()
+    void loadEthnicOptions()
+
+    // 默认采集专员、销售人员为当前登录人
+    const currentUser = userStore.getUserInfo
+    const uid = String(currentUser?.id || currentUser?.userId || '')
+    if (uid) {
+      const displayName = currentUser?.realName || currentUser?.username || ''
+      const phone = currentUser?.phone || ''
+      const userStub = {
+        id: uid,
+        nickName: displayName,
+        phoneNo: phone,
+        deptId: '',
+        userNo: '',
+        email: '',
+        sex: '',
+        avatar: '',
+        status: '1',
+        tenantNo: '',
+        orderNum: 0,
+        remark: '',
+        createTime: '',
+        updateTime: ''
+      } as Api.User.UserItem
+
+      // 采集专员默认当前用户
+      collectorUserId.value = uid
+      formData.collectorUserId = uid
+      collectorSnapshot.value = { ...userStub }
+      collectorUserOptions.value = [{ ...userStub }]
+
+      // 销售人员默认当前用户
+      salesUserId.value = uid
+      formData.salesUserId = uid
+      salesSnapshot.value = { ...userStub }
+      salesUserOptions.value = [{ ...userStub }]
+    }
+  }
+
+  function applyProtocolBundleToForm(bundle: Record<string, any>, row: CollectionProtocolRow) {
+    const prot = bundle.protocol as Record<string, any> | null
+    if (prot) {
+      formData.collectorUserId = String(prot.collectorUserId || formData.collectorUserId || '')
+      formData.protocolNo = String(prot.protocolNo || formData.protocolNo || '')
+      formData.protocolNoId = String(prot.protocolNoId || formData.protocolNoId || '')
+      formData.protocolStatus = String(prot.protocolStatus || formData.protocolStatus || 'dsx')
+      formData.registerDate = String(prot.registerDate || formData.registerDate || '')
+      formData.remark = String(prot.remark ?? formData.remark ?? '')
+      if (formData.protocolNoId) {
+        protocolNoOptions.value = [
+          {
+            id: formData.protocolNoId,
+            protocolNo: formData.protocolNo,
+            issued: 0,
+            issuedUserId: '',
+            issuedUserName: '',
+            issuedTime: '',
+            tenantNo: '',
+            orderNum: 0,
+            remark: '',
+            createTime: '',
+            updateTime: ''
+          }
+        ]
+      }
+    }
+
+    const pc = bundle.partyCustomer as Record<string, any> | null
+    if (pc) {
+      formData.motherName = String(pc.motherName || '')
+      formData.motherPhone = String(pc.motherPhone || '')
+      formData.motherIdCard = String(pc.motherIdCard || '')
+      formData.motherBirthYm = String(pc.motherBirthYm || '')
+      formData.motherEthnic = String(pc.motherEthnic || '')
+      ensureEthnicOptionInList(formData.motherEthnic)
+      formData.motherAddress = String(pc.motherAddress || '')
+      formData.fatherName = String(pc.fatherName || '')
+      formData.fatherPhone = String(pc.fatherPhone || '')
+      formData.fatherIdCard = String(pc.fatherIdCard || '')
+      formData.newbornName = String(pc.newbornName || '')
+      formData.newbornIdCard = String(pc.newbornIdCard || '')
+      formData.newbornDeliveryTime = String(pc.newbornDeliveryTime || '')
+      formData.newbornSex = String(pc.newbornSex ?? '')
+      formData.deliveryMode = String(pc.deliveryMode || '')
+      formData.birthOrder = pc.birthOrder ?? null
+      formData.newbornWeightGram = pc.newbornWeightGram ?? null
+      formData.apgar1min = pc.apgar1min ?? null
+      formData.apgar5min = pc.apgar5min ?? null
+      formData.customerId = String(pc.customerId || '')
+    }
+
+    const ci = bundle.collectionInfo as Record<string, any> | null
+    if (ci) {
+      formData.regionId = String(ci.regionId || '')
+      formData.hospitalId = String(ci.hospitalId || '')
+      formData.medicalStaff = String(ci.medicalStaff || '')
+      formData.salesUserId = String(ci.salesUserId || '')
+      formData.sampleCollectTime = String(ci.sampleCollectTime || '')
+      formData.maternalBloodCollectTime = String(ci.maternalBloodCollectTime || '')
+    }
+
+    const samples = bundle.samples as Array<Record<string, any>> | null
+    if (samples && samples.length) {
+      formData.samples = samples.map((s, i) => normalizeSampleRow(s, i))
+    }
+
+    const pay = bundle.payment as Record<string, any> | null
+    if (pay) {
+      formData.payMode = String(pay.payMode || 'dj')
+      formData.contractAmount = pay.contractAmount ?? null
+      formData.lumpSumDeadline = String(pay.lumpSumDeadline || '')
+      formData.installmentCount = pay.installmentCount ?? null
+      formData.installmentIntervalMonths = pay.installmentIntervalMonths ?? null
+      formData.installmentStartDate = String(pay.installmentStartDate || '')
+    }
+
+    const pd = bundle.paymentDetails as Array<Record<string, any>> | null
+    if (pd && pd.length) {
+      const details = pd.map((d) => ({
+        ...d,
+        attachments: Array.isArray(d.attachments) ? d.attachments : []
+      }))
+      initPaymentDetailExpandFlags(details)
+      formData.paymentDetails = details
+    }
+
+    const pa =
+      (row as any).protocolAttachments || (bundle.protocol as any)?.protocolAttachments || ''
+    if (pa && typeof pa === 'string') {
+      // legacy URL-only field
+    }
+    const att = (bundle as any).attachments as Array<Record<string, any>> | null
+    if (att && att.length) {
+      formData.attachments = att.map((a) => ({ ...a })) as any
+    }
+
+    syncContractAmount()
+  }
+
+  async function handleOpenForEdit() {
+    const row = props.listRow
+    if (!row || !props.editId) return
+
+    isEdit.value = true
+    dialogTitle.value = '编辑协议单'
+    editingId.value = props.editId
+    resetForm()
+
+    formData.protocolNo = String(row.protocolNo || '')
+    formData.protocolNoId = String((row as any).protocolNoId || '')
+    formData.protocolStatus = String(row.protocolStatus || 'dsx')
+    formData.registerDate = String(row.registerDate || '')
+    formData.collectorUserId = String(row.collectorUserId || '')
+    if (formData.protocolNoId) {
+      protocolNoOptions.value = [
+        {
+          id: formData.protocolNoId,
+          protocolNo: formData.protocolNo,
+          issued: 0,
+          issuedUserId: '',
+          issuedUserName: '',
+          issuedTime: '',
+          tenantNo: '',
+          orderNum: 0,
+          remark: '',
+          createTime: '',
+          updateTime: ''
+        }
+      ]
+    }
+    formData.protocolAttachments = String((row as any).protocolAttachments || '')
+    formData.remark = String(row.remark || '')
+
+    dialogFormLoading.value = true
+
+    try {
+      const [, , bundle] = await Promise.all([
+        loadSampleOptions(),
+        loadEthnicOptions(),
+        fetchCollectionProtocolDetail(String(row.id)).catch(() => null)
+      ])
+      if (bundle) {
+        applyProtocolBundleToForm(bundle as Record<string, any>, row)
+      }
+
+      const hydrateTasks: Promise<void>[] = [
+        hydrateCollectorUserForEdit(
+          formData.collectorUserId,
+          String((row as any).collectorUserName || '')
+        ),
+        hydrateSalesUserForEdit(formData.salesUserId, String((row as any).salesUserName || '')),
+        hydrateCustomerForEdit(
+          formData.customerId,
+          formData.motherName,
+          formData.motherPhone,
+          formData.motherIdCard
+        )
+      ]
+      if (formData.regionId) {
+        hydrateTasks.push(
+          ensureRegionOptionForEdit(formData.regionId, String((row as any).regionName || ''))
+        )
+      }
+      if (formData.regionId && formData.hospitalId) {
+        hydrateTasks.push(
+          ensureHospitalOptionForEdit(
+            formData.regionId,
+            formData.hospitalId,
+            String((row as any).hospitalName || '')
+          )
+        )
+      }
+      await Promise.all(hydrateTasks)
+      if (formData.samples.length) {
+        ensureSampleCodesInOptions(formData.samples)
+      }
+    } catch {
+      /* 保留列表行已填基础字段 */
+    } finally {
+      dialogFormLoading.value = false
+    }
+  }
+
+  async function handleSubmit() {
+    if (!formRef.value) return
+    await formRef.value.validate()
+    submitLoading.value = true
+    try {
+      const protocolAttachmentUrls = formData.attachments
+        .map((a) => a.fileUrl)
+        .filter(Boolean)
+        .join(',')
+      const payload = {
+        protocolNo: formData.protocolNo,
+        protocolNoId: formData.protocolNoId || undefined,
+        protocolStatus: formData.protocolStatus,
+        registerDate: formData.registerDate || undefined,
+        collectorUserId: formData.collectorUserId || undefined,
+        protocolAttachments: protocolAttachmentUrls || formData.protocolAttachments || undefined,
+        attachments: formData.attachments.map((a) => ({
+          id: a.id,
+          fileName: a.fileName,
+          fileUrl: a.fileUrl,
+          fileSize: a.fileSize,
+          fileSizeDisplay: a.fileSizeDisplay,
+          fileType: a.fileType
+        })),
+        remark: formData.remark || undefined,
+        partyCustomer: {
+          customerId: formData.customerId || undefined,
+          motherName: formData.motherName || undefined,
+          motherPhone: formData.motherPhone || undefined,
+          motherIdCard: formData.motherIdCard || undefined,
+          motherBirthYm: formData.motherBirthYm || undefined,
+          motherEthnic: formData.motherEthnic || undefined,
+          motherAddress: formData.motherAddress || undefined,
+          fatherName: formData.fatherName || undefined,
+          fatherPhone: formData.fatherPhone || undefined,
+          fatherIdCard: formData.fatherIdCard || undefined,
+          newbornName: formData.newbornName || undefined,
+          newbornIdCard: formData.newbornIdCard || undefined,
+          newbornDeliveryTime: formData.newbornDeliveryTime || undefined,
+          newbornSex: formData.newbornSex || undefined,
+          deliveryMode: formData.deliveryMode || undefined,
+          birthOrder: formData.birthOrder ?? undefined,
+          newbornWeightGram: formData.newbornWeightGram ?? undefined,
+          apgar1min: formData.apgar1min ?? undefined,
+          apgar5min: formData.apgar5min ?? undefined
+        },
+        collectionInfo: {
+          regionId: formData.regionId || undefined,
+          hospitalId: formData.hospitalId || undefined,
+          medicalStaff: formData.medicalStaff || undefined,
+          salesUserId: formData.salesUserId || undefined,
+          sampleCollectTime: formData.sampleCollectTime || undefined,
+          maternalBloodCollectTime: formData.maternalBloodCollectTime || undefined
+        },
+        samples: formData.samples.map(({ _rowKey, transport, ...s }) => ({
+          ...s,
+          sampleStatus:
+            s.sampleStatus != null && String(s.sampleStatus).trim() !== ''
+              ? String(s.sampleStatus).trim()
+              : null,
+          transport: transport?.transportType ? { ...transport } : undefined
+        })),
+        payment: {
+          payMode: formData.payMode,
+          contractAmount: formData.contractAmount ?? undefined,
+          lumpSumDeadline: formData.lumpSumDeadline || undefined,
+          installmentCount: formData.installmentCount ?? undefined,
+          installmentIntervalMonths: formData.installmentIntervalMonths ?? undefined,
+          installmentStartDate: formData.installmentStartDate || undefined
+        },
+        paymentDetails: formData.paymentDetails.map(({ _expanded, ...d }) => ({
+          ...d,
+          attachments: (d.attachments || []).map((a: any) => ({
+            id: a.id,
+            fileName: a.fileName,
+            fileUrl: a.fileUrl,
+            fileSize: a.fileSize,
+            fileSizeDisplay: a.fileSizeDisplay,
+            fileType: a.fileType
+          }))
+        }))
+      }
+
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateCollectionProtocol(editingId.value, payload)
+      } else {
+        await fetchCreateCollectionProtocol(payload)
+      }
+      emit('update:modelValue', false)
+      emit('saved')
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  function createUserStub(id: string, nickName: string, phoneNo = ''): Api.User.UserItem {
+    return {
+      id,
+      nickName: nickName || id,
+      phoneNo,
+      deptId: '',
+      userNo: '',
+      email: '',
+      sex: '',
+      avatar: '',
+      status: '1',
+      tenantNo: '',
+      orderNum: 0,
+      remark: '',
+      createTime: '',
+      updateTime: ''
+    }
+  }
+
+  async function hydrateRemoteUserForEdit(
+    userId: string,
+    displayName: string | undefined,
+    assign: (user: Api.User.UserItem) => void,
+    clear: () => void
+  ) {
+    const uid = (userId || '').trim()
+    if (!uid) {
+      clear()
+      return
+    }
+    try {
+      const detail = await fetchUserDetail(uid)
+      assign(detail)
+      return
+    } catch {
+      /* 回退为列表/占位展示名 */
+    }
+    assign(createUserStub(uid, (displayName || '').trim()))
+  }
+
+  async function hydrateCollectorUserForEdit(userId: string, displayName?: string) {
+    await hydrateRemoteUserForEdit(
+      userId,
+      displayName,
+      (user) => {
+        collectorSnapshot.value = { ...user }
+        collectorUserId.value = user.id
+        collectorUserOptions.value = [{ ...user }]
+        formData.collectorUserId = user.id
+      },
+      () => {
+        collectorUserId.value = null
+        collectorSnapshot.value = null
+        collectorUserOptions.value = []
+        formData.collectorUserId = ''
+      }
+    )
+  }
+
+  async function hydrateSalesUserForEdit(userId: string, displayName?: string) {
+    await hydrateRemoteUserForEdit(
+      userId,
+      displayName,
+      (user) => {
+        salesSnapshot.value = { ...user }
+        salesUserId.value = user.id
+        salesUserOptions.value = [{ ...user }]
+        formData.salesUserId = user.id
+      },
+      () => {
+        salesUserId.value = null
+        salesSnapshot.value = null
+        salesUserOptions.value = []
+        formData.salesUserId = ''
+      }
+    )
+  }
+
+  async function hydrateCustomerForEdit(
+    customerIdVal: string,
+    motherName: string,
+    motherPhone: string,
+    motherIdCard: string
+  ) {
+    const cid = (customerIdVal || '').trim()
+    if (!cid) {
+      customerId.value = null
+      customerSnapshot.value = null
+      customerOptions.value = []
+      formData.customerId = ''
+      return
+    }
+    let snapshot = {
+      id: cid,
+      customerName: motherName,
+      phoneNo: motherPhone,
+      idCardNo: motherIdCard
+    }
+    const keyword = motherPhone || motherName || motherIdCard
+    if (keyword) {
+      try {
+        const res = await fetchCustomerList({ page: 1, pageSize: 50, keyword })
+        const match = (res.list || []).find((c) => c.id === cid)
+        if (match) {
+          snapshot = {
+            id: match.id,
+            customerName: match.customerName || motherName,
+            phoneNo: match.phoneNo || motherPhone,
+            idCardNo: match.idCardNo || motherIdCard
+          }
+        }
+      } catch {
+        /* 使用母亲信息占位 */
+      }
+    }
+    customerSnapshot.value = snapshot
+    customerId.value = cid
+    customerOptions.value = [snapshot]
+    formData.customerId = cid
+  }
+
+  async function ensureRegionOptionForEdit(regionId: string, regionName?: string) {
+    const rid = (regionId || '').trim()
+    if (!rid) return
+    await remoteSearchRegions('')
+    if (regionOptions.value.some((r) => r.id === rid)) return
+    const stub: Api.BizCollectionRegion.RegionItem = {
+      id: rid,
+      regionName: (regionName || '').trim() || rid,
+      hospitalNames: [],
+      tenantNo: '',
+      orderNum: 0,
+      remark: '',
+      createTime: '',
+      updateTime: ''
+    }
+    regionOptions.value = [stub, ...regionOptions.value]
+  }
+
+  async function ensureHospitalOptionForEdit(
+    regionId: string,
+    hospitalId: string,
+    hospitalName?: string
+  ) {
+    const hid = (hospitalId || '').trim()
+    if (!hid || !(regionId || '').trim()) return
+    await loadHospitalsByRegion(regionId, '')
+    if (hospitalOptions.value.some((h) => h.id === hid)) return
+    const stub: Api.BizCollectionHospital.HospitalItem = {
+      id: hid,
+      regionId,
+      hospitalName: (hospitalName || '').trim() || hid,
+      tenantNo: '',
+      orderNum: 0,
+      remark: '',
+      createTime: '',
+      updateTime: ''
+    }
+    hospitalOptions.value = [stub, ...hospitalOptions.value]
+  }
+
+  function ensureSampleCodesInOptions(samples: Array<Record<string, any>>) {
+    const merged = [...sampleCodeOptions.value]
+    for (const s of samples) {
+      const id = String(s.sampleCodeId || '')
+      if (!id || merged.some((x) => x.id === id)) continue
+      merged.push({
+        id,
+        sampleCode: String(s.sampleCode || id),
+        sampleCodeType: '',
+        issued: 0,
+        issuedUserId: '',
+        issuedUserName: '',
+        issuedTime: '',
+        tenantNo: '',
+        orderNum: 0,
+        remark: '',
+        createTime: '',
+        updateTime: ''
+      })
+    }
+    sampleCodeOptions.value = merged
+  }
+
+  /* ====== 客户检索（母亲信息） ====== */
+  function formatCustomerLabel(c: { customerName: string; phoneNo: string; idCardNo: string }) {
+    const parts = [c.customerName || '']
+    if (c.phoneNo) parts.push(c.phoneNo)
+    if (c.idCardNo) parts.push(c.idCardNo)
+    return parts.filter(Boolean).join(' · ')
+  }
+
+  async function remoteSearchCustomers(query: string) {
+    customerLoading.value = true
+    try {
+      const res = await fetchCustomerList({ page: 1, pageSize: 50, keyword: query || undefined })
+      let list = [...(res.list || [])]
+      // Keep current selection visible
+      if (
+        customerId.value &&
+        customerSnapshot.value?.id === customerId.value &&
+        !list.some((x) => x.id === customerId.value)
+      ) {
+        list = [customerSnapshot.value, ...list]
+      }
+      customerOptions.value = list
+    } catch {
+      customerOptions.value = []
+    } finally {
+      customerLoading.value = false
+    }
+  }
+
+  function onCustomerChange(val: string | null | undefined) {
+    if (!val) {
+      customerId.value = null
+      customerSnapshot.value = null
+      // Clear auto-filled fields only
+      formData.motherName = ''
+      formData.motherPhone = ''
+      formData.motherIdCard = ''
+      formData.motherBirthYm = ''
+      return
+    }
+    const c = customerOptions.value.find((x) => x.id === val) || customerSnapshot.value
+    if (!c) return
+    customerSnapshot.value = { ...c } as any
+    customerId.value = c.id
+    formData.customerId = c.id
+    formData.motherName = c.customerName?.trim() || ''
+    formData.motherPhone = c.phoneNo?.trim() || ''
+    formData.motherIdCard = c.idCardNo?.trim() || ''
+    calcBirthFromIdCard()
+  }
+
+  /* ====== 采集专员检索 ====== */
+  async function remoteSearchCollectorUsers(query: string) {
+    collectorLoading.value = true
+    try {
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: query || undefined,
+        status: '1'
+      })
+      let list = [...(res.list || [])]
+      if (
+        collectorUserId.value &&
+        collectorSnapshot.value?.id === collectorUserId.value &&
+        !list.some((x) => x.id === collectorUserId.value)
+      ) {
+        list = [collectorSnapshot.value, ...list]
+      }
+      collectorUserOptions.value = list
+    } catch {
+      collectorUserOptions.value = []
+    } finally {
+      collectorLoading.value = false
+    }
+  }
+
+  function onCollectorUserChange(val: string | null | undefined) {
+    if (!val) {
+      collectorUserId.value = null
+      collectorSnapshot.value = null
+      formData.collectorUserId = ''
+      return
+    }
+    const u = collectorUserOptions.value.find((x) => x.id === val) || collectorSnapshot.value
+    if (!u) return
+    collectorSnapshot.value = { ...u }
+    collectorUserId.value = u.id
+    formData.collectorUserId = u.id
+  }
+
+  /* ====== 销售人员检索 ====== */
+  async function remoteSearchSalesUsers(query: string) {
+    salesLoading.value = true
+    try {
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: query || undefined,
+        status: '1'
+      })
+      let list = [...(res.list || [])]
+      if (
+        salesUserId.value &&
+        salesSnapshot.value?.id === salesUserId.value &&
+        !list.some((x) => x.id === salesUserId.value)
+      ) {
+        list = [salesSnapshot.value, ...list]
+      }
+      salesUserOptions.value = list
+    } catch {
+      salesUserOptions.value = []
+    } finally {
+      salesLoading.value = false
+    }
+  }
+
+  function onSalesUserChange(val: string | null | undefined) {
+    if (!val) {
+      salesUserId.value = null
+      salesSnapshot.value = null
+      formData.salesUserId = ''
+      return
+    }
+    const u = salesUserOptions.value.find((x) => x.id === val) || salesSnapshot.value
+    if (!u) return
+    salesSnapshot.value = { ...u }
+    salesUserId.value = u.id
+    formData.salesUserId = u.id
+  }
+
+  /* ====== 样本类型/单位选项 ====== */
+  async function loadSampleOptions() {
+    try {
+      const [stRes, uRes, scRes, ecRes, siteRes] = await Promise.all([
+        fetchCellSampleTypeList({ page: 1, pageSize: 100 }),
+        fetchItemUnitList({ page: 1, pageSize: 100 }),
+        fetchSampleCodeList({ page: 1, pageSize: 100 }),
+        fetchExpressCompanyList({ page: 1, pageSize: 100 }),
+        fetchSiteList({ page: 1, pageSize: 100 })
+      ])
+      sampleTypeOptions.value = (stRes.list || []) as any
+      unitOptions.value = (uRes.list || []) as any
+      sampleCodeOptions.value = (scRes.list || []) as any
+      expressCompanyOptions.value = ecRes.list || []
+      siteOptions.value = siteRes.list || []
+    } catch {
+      /* ignore */
+    }
+  }
+
+  /* ====== 采集地区下拉检索 ====== */
+  async function remoteSearchRegions(query: string) {
+    regionLoading.value = true
+    try {
+      const res = await fetchCollectionRegionList({
+        page: 1,
+        pageSize: 100,
+        keyword: query || undefined
+      })
+      regionOptions.value = res.list || []
+    } catch {
+      regionOptions.value = []
+    } finally {
+      regionLoading.value = false
+    }
+  }
+
+  function onRegionChange(val: string | null | undefined) {
+    if (!val) {
+      formData.regionId = ''
+      hospitalOptions.value = []
+      formData.hospitalId = ''
+      return
+    }
+    formData.regionId = val
+    formData.hospitalId = ''
+    hospitalOptions.value = []
+    // 联动加载该地区下的医院
+    loadHospitalsByRegion(val)
+  }
+
+  function onRegionClear() {
+    formData.regionId = ''
+    formData.hospitalId = ''
+    hospitalOptions.value = []
+  }
+
+  async function loadHospitalsByRegion(regionId: string, keyword?: string) {
+    hospitalLoading.value = true
+    try {
+      const res = await fetchHospitalList(regionId, {
+        page: 1,
+        pageSize: 100,
+        keyword: keyword || undefined
+      })
+      hospitalOptions.value = res.list || []
+    } catch {
+      hospitalOptions.value = []
+    } finally {
+      hospitalLoading.value = false
+    }
+  }
+
+  /* ====== 采集医院下拉检索 ====== */
+  async function remoteSearchHospitals(query: string) {
+    if (!formData.regionId) {
+      hospitalOptions.value = []
+      return
+    }
+    await loadHospitalsByRegion(formData.regionId, query)
+  }
+
+  function onHospitalChange(val: string | null | undefined) {
+    if (!val) {
+      formData.hospitalId = ''
+      return
+    }
+    formData.hospitalId = val
+  }
+
+  /** 分期应缴费金额分配：前 n-1 期均分（分），最后一期补齐差额 */
+  function calcInstallmentDueAmounts(contractAmount: number | null, count: number): number[] {
+    if (contractAmount == null || !count || count < 1) return []
+    const totalCents = Math.round(Number(contractAmount) * 100)
+    const baseCents = Math.floor(totalCents / count)
+    const amounts: number[] = []
+    let sumCents = 0
+    for (let i = 0; i < count; i++) {
+      if (i === count - 1) {
+        amounts.push((totalCents - sumCents) / 100)
+      } else {
+        amounts.push(baseCents / 100)
+        sumCents += baseCents
+      }
+    }
+    return amounts
+  }
+
+  /** 按缴费模式同步各明细应缴费金额 */
+  function syncPaymentDueAmounts() {
+    const contract = formData.contractAmount
+    if (contract == null) return
+    if (formData.payMode === 'dj') {
+      formData.paymentDetails.forEach((d) => {
+        d.dueAmount = contract
+      })
+      return
+    }
+    if (formData.payMode === 'fq') {
+      const count = formData.installmentCount || formData.paymentDetails.length
+      if (!count) return
+      const amounts = calcInstallmentDueAmounts(Number(contract), count)
+      formData.paymentDetails.forEach((d, i) => {
+        if (amounts[i] !== undefined) d.dueAmount = amounts[i]
+      })
+    }
+  }
+
+  /** 根据非作废样本价格之和同步合同金额，并联动应缴费金额 */
+  function syncContractAmount() {
+    const total = formData.samples.reduce((sum, s) => {
+      if (s.sampleStatus === 'yzf') return sum
+      return sum + (Number(s.price) || 0)
+    }, 0)
+    formData.contractAmount = Math.round(total * 100) / 100
+    syncPaymentDueAmounts()
+  }
+
+  /** 样本价格或状态变更 */
+  function onSamplePriceChange() {
+    syncContractAmount()
+  }
+
+  function onSampleStatusChange(row: Record<string, any>) {
+    if (row.sampleStatus == null) {
+      row.sampleStatus = ''
+    }
+    onSamplePriceChange()
+  }
+
+  function onSampleTypeChange(row: Record<string, any>) {
+    const st = sampleTypeOptions.value.find((x) => x.id === row.sampleTypeId)
+    if (st) {
+      row.price = st.storagePrice
+      row.storageYears = st.storageYears
+    }
+    syncContractAmount()
+  }
+
+  /* ====== 协议号下拉检索 ====== */
+  async function remoteSearchProtocolNos(query: string) {
+    protocolNoLoading.value = true
+    try {
+      const res = await fetchCollectionProtocolNoList({
+        page: 1,
+        pageSize: 100,
+        keyword: query || undefined
+      })
+      protocolNoOptions.value = res.list || []
+    } catch {
+      protocolNoOptions.value = []
+    } finally {
+      protocolNoLoading.value = false
+    }
+  }
+
+  function onProtocolNoChange(val: string | null | undefined) {
+    if (!val) {
+      formData.protocolNo = ''
+      formData.protocolNoId = ''
+      return
+    }
+    const p = protocolNoOptions.value.find((x) => x.id === val)
+    if (p) {
+      formData.protocolNo = p.protocolNo
+      formData.protocolNoId = p.id
+    }
+  }
+
+  function onProtocolNoClear() {
+    formData.protocolNo = ''
+    formData.protocolNoId = ''
+  }
+
+  /* ====== 样本编码选择 ====== */
+  function onSampleCodeChange(row: Record<string, any>) {
+    const sc = sampleCodeOptions.value.find((x) => x.id === row.sampleCodeId)
+    if (sc) {
+      row.sampleCode = sc.sampleCode
+      row.sampleCodeId = sc.id
+    }
+  }
+
+  /* ====== 母亲身份证号 ↔ 出生年月联动 ====== */
+  function calcBirthFromIdCard() {
+    const idCard = (formData.motherIdCard || '').trim()
+    if (/^\d{17}[\dXx]$/.test(idCard)) {
+      formData.motherBirthYm = idCard.substring(6, 12)
+    } else if (/^\d{15}$/.test(idCard)) {
+      const yy = idCard.substring(6, 8)
+      const mm = idCard.substring(8, 10)
+      const prefix = parseInt(yy, 10) > 30 ? '19' : '20'
+      formData.motherBirthYm = prefix + yy + mm
+    } else if (!idCard) {
+      formData.motherBirthYm = ''
+    }
+  }
+
+  watch(
+    () => formData.motherIdCard,
+    () => calcBirthFromIdCard()
+  )
+
+  /* ====== 附件上传 ====== */
+  const attachmentUploadRef = ref()
+
+  function isImageFile(file: any) {
+    const url = (file.fileUrl || '').toLowerCase()
+    const name = (file.fileName || '').toLowerCase()
+    return (
+      /\.(jpg|jpeg|png|gif|bmp|webp|svg)(\?|$)/.test(url) ||
+      /\.(jpg|jpeg|png|gif|bmp|webp|svg)$/.test(name) ||
+      (file.fileType || '').startsWith('image/')
+    )
+  }
+
+  function isVideoFile(file: any) {
+    const url = (file.fileUrl || '').toLowerCase()
+    const name = (file.fileName || '').toLowerCase()
+    return (
+      /\.(mp4|webm|ogg|mov|avi)(\?|$)/.test(url) ||
+      /\.(mp4|webm|ogg|mov|avi)$/.test(name) ||
+      (file.fileType || '').startsWith('video/')
+    )
+  }
+
+  async function handleAttachmentChange(uploadFile: any) {
+    const file = uploadFile.raw || uploadFile
+    if (!file) return
+
+    const maxSizeMb = 20
+    if (file.size / 1024 / 1024 > maxSizeMb) {
+      ElMessage.error(`文件大小不能超过 ${maxSizeMb}MB`)
+      attachmentUploadRef.value?.clearFiles()
+      return
+    }
+
+    const tempId = `temp_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    formData.attachments.push({
+      id: tempId,
+      fileName: file.name,
+      fileUrl: '',
+      fileSize: file.size,
+      fileSizeDisplay: `${(file.size / 1024).toFixed(1)} KB`,
+      fileType: file.type || '',
+      _uploading: true
+    })
+    const idx = formData.attachments.length - 1
+
+    try {
+      const fd = new FormData()
+      fd.append('folder', 'protocol')
+      fd.append('file', file)
+      const res = await fetchUploadAttachment(fd)
+      formData.attachments[idx] = {
+        ...formData.attachments[idx],
+        id: res.id || tempId,
+        fileName: file.name || res.fileName,
+        fileUrl: res.fileUrl,
+        fileSize: res.fileSize || file.size,
+        fileSizeDisplay: res.fileSizeDisplay || `${(file.size / 1024).toFixed(1)} KB`,
+        fileType: res.fileType || file.type || '',
+        _uploading: false
+      }
+    } catch {
+      ElMessage.error('文件上传失败')
+      formData.attachments.splice(idx, 1)
+    } finally {
+      nextTick(() => attachmentUploadRef.value?.clearFiles())
+    }
+  }
+
+  function removeAttachment(index: number) {
+    formData.attachments.splice(index, 1)
+  }
+
+  /* ====== 缴费明细附件上传 ====== */
+  async function handleDetailAttachmentChange(detailIndex: number, uploadFile: any) {
+    const file = uploadFile.raw || uploadFile
+    if (!file) return
+
+    const maxSizeMb = 20
+    if (file.size / 1024 / 1024 > maxSizeMb) {
+      ElMessage.error(`文件大小不能超过 ${maxSizeMb}MB`)
+      return
+    }
+
+    const detail = formData.paymentDetails[detailIndex]
+    if (!detail) return
+
+    const tempId = `temp_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    detail.attachments.push({
+      id: tempId,
+      fileName: file.name,
+      fileUrl: '',
+      fileSize: file.size,
+      fileSizeDisplay: `${(file.size / 1024).toFixed(1)} KB`,
+      fileType: file.type || '',
+      _uploading: true
+    })
+    const aIdx = detail.attachments.length - 1
+
+    try {
+      const fd = new FormData()
+      fd.append('folder', 'protocol-payment')
+      fd.append('file', file)
+      const res = await fetchUploadAttachment(fd)
+      detail.attachments[aIdx] = {
+        ...detail.attachments[aIdx],
+        id: res.id || tempId,
+        fileName: file.name || res.fileName,
+        fileUrl: res.fileUrl,
+        fileSize: res.fileSize || file.size,
+        fileSizeDisplay: res.fileSizeDisplay || `${(file.size / 1024).toFixed(1)} KB`,
+        fileType: res.fileType || file.type || '',
+        _uploading: false
+      }
+    } catch {
+      ElMessage.error('文件上传失败')
+      detail.attachments.splice(aIdx, 1)
+    }
+  }
+
+  function removeDetailAttachment(detailIndex: number, attachmentIndex: number) {
+    const detail = formData.paymentDetails[detailIndex]
+    if (detail) {
+      detail.attachments.splice(attachmentIndex, 1)
+    }
+  }
+
+  /* 附件预览 */
+  const previewVisible = ref(false)
+  const previewUrl = ref('')
+  const previewType = ref<'image' | 'video'>('image')
+
+  function handlePreviewAttachment(file: any) {
+    if (file._uploading) return
+    previewUrl.value = fullFileUrl(file.fileUrl)
+    previewType.value = isVideoFile(file) ? 'video' : 'image'
+    previewVisible.value = true
+  }
+
+  function handleDownloadAttachment(file: any) {
+    const url = fullFileUrl(file.fileUrl)
+    if (!url) return
+    const a = document.createElement('a')
+    a.href = url
+    a.download = file.fileName || ''
+    a.target = '_blank'
+    document.body.appendChild(a)
+    a.click()
+    document.body.removeChild(a)
+  }
+
+  /* ====== 弹窗打开时自动初始化 ====== */
+  watch(
+    () => props.modelValue,
+    (visible) => {
+      if (visible) {
+        if (props.editId) {
+          handleOpenForEdit()
+        } else {
+          handleOpenForAdd()
+        }
+      }
+    }
+  )
+</script>
+<style scoped lang="scss">
+  .protocol-form {
+    :deep(.el-form-item) {
+      margin-bottom: 4px;
+    }
+  }
+
+  .detail-section-title {
+    margin: 8px 0 4px;
+    padding-left: 10px;
+    font-size: 14px;
+    font-weight: 600;
+    color: #1e293b;
+    border-left: 3px solid #10b981;
+  }
+
+  /* 自定义 Tab — sticky anchor nav */
+  .detail-tabs {
+    position: sticky;
+    top: 0;
+    z-index: 1000;
+    display: flex;
+    gap: 4px;
+    background: #f5f7fa;
+    padding: 4px;
+    border-radius: 8px;
+    margin-bottom: 16px;
+    width: fit-content;
+    isolation: isolate;
+    box-shadow: 0 1px 0 #f5f7fa;
+  }
+
+  .detail-tab {
+    padding: 10px 20px;
+    cursor: pointer;
+    border-radius: 6px;
+    font-size: 14px;
+    color: #606266;
+    transition: all 0.3s;
+
+    &.active {
+      background: #fff;
+      color: #059669;
+      font-weight: 500;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
+    }
+
+    &:hover:not(.active) {
+      color: #059669;
+    }
+  }
+
+  .form-tab-pane {
+    padding: 0 0 4px;
+
+    & + .form-tab-pane {
+      margin-top: 20px;
+      padding-top: 20px;
+      border-top: 1px dashed #e2e8f0;
+    }
+  }
+
+  .form-section-divider {
+    margin: 16px 0;
+    border: none;
+    border-top: 1px dashed #e2e8f0;
+    height: 0;
+  }
+
+  /* 可编辑子表格 */
+  .sub-table-toolbar {
+    margin-bottom: 10px;
+  }
+
+  .sample-transport-hint {
+    margin: 0 0 12px;
+    font-size: 12px;
+    color: var(--mint-text-muted, #64748b);
+    line-height: 1.5;
+  }
+
+  .batch-transport-dialog-hint {
+    margin-top: 0;
+  }
+
+  .sample-transport-panel {
+    padding: 12px 16px 4px;
+    background: #f8fafc;
+    border-radius: 8px;
+  }
+
+  .sample-transport-title {
+    margin: 0 0 12px;
+    font-size: 13px;
+    font-weight: 600;
+    color: #334155;
+  }
+
+  .sample-transport-cell {
+    font-size: 12px;
+    color: #334155;
+    line-height: 1.4;
+
+    &.is-empty {
+      color: #94a3b8;
+    }
+  }
+
+  .sample-transport-form-row {
+    display: grid;
+    grid-template-columns: repeat(6, minmax(0, 1fr));
+    gap: 12px 16px;
+    align-items: start;
+
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+
+    &--ryxd {
+      grid-template-columns: repeat(5, minmax(0, 1fr));
+    }
+  }
+
+  .sub-edit-table {
+    margin-bottom: 8px;
+
+    :deep(.el-table__body td.el-table__cell) {
+      padding-top: 10px;
+      padding-bottom: 10px;
+    }
+
+    :deep(.el-table__header th.el-table__cell) {
+      padding-top: 10px;
+      padding-bottom: 10px;
+    }
+
+    :deep(.el-input__wrapper),
+    :deep(.el-select__wrapper) {
+      min-height: 32px;
+      height: 32px;
+    }
+  }
+
+  /* 附件上传 */
+  .attachment-upload {
+    width: 100%;
+  }
+
+  .upload-card {
+    width: 140px;
+    height: 96px;
+    border: 1px dashed #a7f3d0;
+    border-radius: 8px;
+    background: #f0fdf4;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 6px;
+    cursor: pointer;
+    transition:
+      border-color 0.15s,
+      background 0.15s;
+
+    &:hover {
+      border-color: #10b981;
+      border-style: solid;
+      background: #ecfdf5;
+    }
+  }
+
+  .upload-card-text {
+    font-size: 12px;
+    color: #10b981;
+    font-weight: 500;
+    line-height: 1;
+  }
+
+  .upload-hint {
+    display: block;
+    font-size: 11px;
+    color: #94a3b8;
+    line-height: 1;
+    margin-top: 8px;
+  }
+
+  .attachment-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 12px;
+  }
+
+  .attachment-item {
+    width: 140px;
+    display: flex;
+    flex-direction: column;
+    border: 1px solid #e2e8f0;
+    border-radius: 8px;
+    background: #fff;
+    overflow: hidden;
+    transition:
+      border-color 0.15s,
+      box-shadow 0.15s;
+
+    &:hover {
+      border-color: #10b981;
+      box-shadow: 0 2px 8px rgba(16, 185, 129, 0.1);
+    }
+
+    &.is-uploading {
+      opacity: 0.6;
+      pointer-events: none;
+    }
+  }
+
+  .attachment-preview {
+    width: 100%;
+    height: 96px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: #f8fafc;
+    overflow: hidden;
+    cursor: pointer;
+
+    img {
+      width: 100%;
+      height: 100%;
+      object-fit: cover;
+      display: block;
+    }
+  }
+
+  .attachment-preview__icon {
+    width: 48px;
+    height: 48px;
+    border-radius: 10px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+
+    &--video {
+      background: #ede9fe;
+      color: #7c3aed;
+    }
+
+    &--doc {
+      background: #e0f2fe;
+      color: #0284c7;
+    }
+  }
+
+  .attachment-footer {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    padding: 6px 8px;
+  }
+
+  .attachment-name {
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    font-size: 11px;
+    color: #334155;
+    line-height: 1.4;
+    word-break: break-all;
+    /* 固定两行占位，避免文件名长短不一导致操作按钮纵向错位 */
+    min-height: calc(11px * 1.4 * 2);
+  }
+
+  .attachment-actions {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    gap: 8px;
+    margin-top: 4px;
+    flex-shrink: 0;
+    transition: opacity 0.15s;
+  }
+
+  .action-btn {
+    width: 22px;
+    height: 22px;
+    border-radius: 4px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 12px;
+    color: #64748b;
+    cursor: pointer;
+    background: #f1f5f9;
+    transition:
+      background 0.15s,
+      color 0.15s;
+
+    &:hover {
+      background: #10b981;
+      color: #fff;
+    }
+
+    &--danger:hover {
+      background: #ef4444;
+      color: #fff;
+    }
+  }
+
+  .preview-container {
+    text-align: center;
+  }
+
+  /* 缴费明细卡片 */
+  .payment-detail-cards {
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .payment-detail-card {
+    border: 1px solid #e2e8f0;
+    border-radius: 10px;
+    background: #fff;
+    overflow: hidden;
+    transition:
+      border-color 0.15s,
+      box-shadow 0.15s;
+
+    &:hover {
+      border-color: #10b981;
+      box-shadow: 0 2px 8px rgba(16, 185, 129, 0.08);
+    }
+  }
+
+  .payment-detail-card.is-collapsed .payment-detail-card__header {
+    border-bottom: none;
+  }
+
+  .payment-detail-card__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+    padding: 8px 16px;
+    background: #f8fafc;
+    border-bottom: 1px solid #e2e8f0;
+    cursor: pointer;
+    user-select: none;
+
+    &:hover {
+      background: #f1f5f9;
+    }
+  }
+
+  .payment-detail-card__header-main {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    flex: 1;
+    min-width: 0;
+  }
+
+  .payment-detail-card__chevron {
+    flex-shrink: 0;
+    font-size: 14px;
+    color: #64748b;
+  }
+
+  .payment-detail-card__title {
+    flex-shrink: 0;
+    font-size: 13px;
+    font-weight: 600;
+    color: #334155;
+  }
+
+  .payment-detail-card__summary {
+    flex: 1;
+    min-width: 0;
+    font-size: 12px;
+    color: #64748b;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .payment-detail-card__body {
+    padding: 12px 16px 8px;
+
+    :deep(.el-form-item) {
+      margin-bottom: 4px;
+    }
+  }
+
+  .payment-detail-card__attachments {
+    margin-top: 8px;
+    padding-top: 8px;
+    border-top: 1px dashed #e2e8f0;
+  }
+
+  .upload-card--sm {
+    width: 96px;
+    height: 76px;
+
+    .upload-card-text {
+      font-size: 11px;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/cell-storage/protocol/ProtocolViewDialog.vue b/web-admin/src/views/cell-storage/protocol/ProtocolViewDialog.vue
new file mode 100644
index 00000000..a7c6dfd8
--- /dev/null
+++ b/web-admin/src/views/cell-storage/protocol/ProtocolViewDialog.vue
@@ -0,0 +1,865 @@
+<!-- 采集协议单 — 只读查看（字段与新增/编辑弹窗一致） -->
+<template>
+  <el-dialog
+    :model-value="modelValue"
+    :title="dialogTitle"
+    width="1600px"
+    class="dialog-form-layout protocol-view-dialog"
+    align-center
+    destroy-on-close
+    :close-on-click-modal="false"
+    @update:model-value="emit('update:modelValue', $event)"
+    @closed="handleClosed"
+  >
+    <div v-loading="loading" class="protocol-view-body">
+      <div class="detail-tabs">
+        <div
+          v-for="tab in formTabs"
+          :key="tab.key"
+          class="detail-tab"
+          :class="{ active: activeTab === tab.key }"
+          @click="scrollToSection(tab.key)"
+        >
+          {{ tab.label }}
+        </div>
+      </div>
+
+      <template v-if="bundle">
+        <!-- 基本信息 -->
+        <div id="view-section-basic" class="form-tab-pane">
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>协议号</dt>
+              <dd>{{ dash(protocol?.protocolNo) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>协议状态</dt>
+              <dd>{{ protocolStatusLabel(String(protocol?.protocolStatus || '')) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>登记日期</dt>
+              <dd>{{ formatYmd(protocol?.registerDate) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>采集专员</dt>
+              <dd>{{ collectorDisplay }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>创建时间</dt>
+              <dd>{{ dash(protocol?.createTime) }}</dd>
+            </div>
+            <div class="view-field-block view-kv-span-2">
+              <div class="view-field-block__label">协议附件</div>
+              <ProtocolAttachmentReadonly
+                :files="protocolAttachments"
+                @preview="openPreview"
+                @download="downloadFile"
+              />
+            </div>
+            <div class="view-kv view-kv-span-2">
+              <dt>备注</dt>
+              <dd>{{ dash(protocol?.remark) }}</dd>
+            </div>
+          </dl>
+        </div>
+
+        <!-- 客户信息 -->
+        <div id="view-section-party" class="form-tab-pane">
+          <h3 class="detail-section-title">母亲信息</h3>
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>关联客户</dt>
+              <dd>{{ partyCustomer?.customerId ? dash(partyCustomer?.motherName) : '—' }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母亲姓名</dt>
+              <dd>{{ dash(partyCustomer?.motherName) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母亲联系电话</dt>
+              <dd>{{ dash(partyCustomer?.motherPhone) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母亲身份证号</dt>
+              <dd>{{ dash(partyCustomer?.motherIdCard) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母亲出生年月</dt>
+              <dd>{{ formatYm(partyCustomer?.motherBirthYm) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母亲民族</dt>
+              <dd>{{ dash(partyCustomer?.motherEthnic) }}</dd>
+            </div>
+            <div class="view-kv view-kv-span-2">
+              <dt>母亲家庭住址</dt>
+              <dd>{{ dash(partyCustomer?.motherAddress) }}</dd>
+            </div>
+          </dl>
+
+          <div class="form-section-divider" />
+          <h3 class="detail-section-title">父亲信息</h3>
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>父亲姓名</dt>
+              <dd>{{ dash(partyCustomer?.fatherName) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>父亲电话</dt>
+              <dd>{{ dash(partyCustomer?.fatherPhone) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>父亲身份证号</dt>
+              <dd>{{ dash(partyCustomer?.fatherIdCard) }}</dd>
+            </div>
+          </dl>
+
+          <div class="form-section-divider" />
+          <h3 class="detail-section-title">新生儿信息</h3>
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>新生儿姓名</dt>
+              <dd>{{ dash(partyCustomer?.newbornName) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿身份证</dt>
+              <dd>{{ dash(partyCustomer?.newbornIdCard) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿分娩时间</dt>
+              <dd>{{ dash(partyCustomer?.newbornDeliveryTime) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿性别</dt>
+              <dd>{{ newbornSexLabel(String(partyCustomer?.newbornSex || '')) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>分娩方式</dt>
+              <dd>{{ deliveryModeLabel(String(partyCustomer?.deliveryMode || '')) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>胎次</dt>
+              <dd>{{ dash(partyCustomer?.birthOrder) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿体重(克)</dt>
+              <dd>{{ dash(partyCustomer?.newbornWeightGram) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿评分1分钟</dt>
+              <dd>{{ dash(partyCustomer?.apgar1min) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>新生儿评分5分钟</dt>
+              <dd>{{ dash(partyCustomer?.apgar5min) }}</dd>
+            </div>
+          </dl>
+        </div>
+
+        <!-- 采集信息 -->
+        <div id="view-section-collection" class="form-tab-pane">
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>采集地区</dt>
+              <dd>{{ regionDisplay }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>采集医院</dt>
+              <dd>{{ hospitalDisplay }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>采集医护</dt>
+              <dd>{{ dash(collectionInfo?.medicalStaff) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>销售人员</dt>
+              <dd>{{ salesDisplay }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>样本采集时间</dt>
+              <dd>{{ dash(collectionInfo?.sampleCollectTime) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>母血采集时间</dt>
+              <dd>{{ dash(collectionInfo?.maternalBloodCollectTime) }}</dd>
+            </div>
+          </dl>
+        </div>
+
+        <!-- 样本及运输 -->
+        <div id="view-section-sample" class="form-tab-pane">
+          <el-table :data="samples" row-key="id" stripe border size="small" class="sub-view-table">
+            <el-table-column label="样本类型" min-width="140">
+              <template #default="{ row }">{{ sampleTypeName(row.sampleTypeId) }}</template>
+            </el-table-column>
+            <el-table-column prop="sampleCode" label="样本编码" min-width="140" />
+            <el-table-column prop="collectAmount" label="采集量" width="100" align="center" />
+            <el-table-column label="单位" width="100" align="center">
+              <template #default="{ row }">{{ unitName(row.unitId) }}</template>
+            </el-table-column>
+            <el-table-column prop="price" label="价格" width="100" align="center" />
+            <el-table-column prop="storageYears" label="存储年限(年)" width="120" align="center" />
+            <el-table-column label="样本状态" width="100" align="center">
+              <template #default="{ row }">{{
+                sampleStatusLabel(String(row.sampleStatus || ''))
+              }}</template>
+            </el-table-column>
+            <el-table-column label="运输类型" width="100" align="center">
+              <template #default="{ row }">
+                {{ transportTypeLabel(String(row.transport?.transportType || '')) }}
+              </template>
+            </el-table-column>
+            <el-table-column label="目的站点" min-width="110" show-overflow-tooltip>
+              <template #default="{ row }">
+                {{ siteName(String(row.transport?.destSiteId || '')) }}
+              </template>
+            </el-table-column>
+            <el-table-column label="预计到达" min-width="150" show-overflow-tooltip>
+              <template #default="{ row }">
+                {{ dash(row.transport?.etaTime) }}
+              </template>
+            </el-table-column>
+            <el-table-column label="快递/携带" min-width="160" show-overflow-tooltip>
+              <template #default="{ row }">
+                {{ sampleTransportExtra(row.transport) }}
+              </template>
+            </el-table-column>
+            <el-table-column prop="remark" label="备注" min-width="120" show-overflow-tooltip />
+          </el-table>
+          <el-empty v-if="!samples.length" description="暂无样本" :image-size="48" />
+        </div>
+
+        <!-- 缴费信息 -->
+        <div id="view-section-payment" class="form-tab-pane">
+          <h3 class="detail-section-title">缴费主表</h3>
+          <dl class="view-kv-grid view-kv-grid--5">
+            <div class="view-kv">
+              <dt>缴费模式</dt>
+              <dd>{{ payModeLabel(String(payment?.payMode || '')) }}</dd>
+            </div>
+            <div class="view-kv">
+              <dt>合同金额</dt>
+              <dd>{{ dash(payment?.contractAmount) }}</dd>
+            </div>
+            <template v-if="payment?.payMode === 'dj'">
+              <div class="view-kv">
+                <dt>趸交截止时间</dt>
+                <dd>{{ formatYmd(payment?.lumpSumDeadline) }}</dd>
+              </div>
+            </template>
+            <template v-if="payment?.payMode === 'fq'">
+              <div class="view-kv">
+                <dt>分期期数</dt>
+                <dd>{{ dash(payment?.installmentCount) }}</dd>
+              </div>
+              <div class="view-kv">
+                <dt>每期间隔(月)</dt>
+                <dd>{{ dash(payment?.installmentIntervalMonths) }}</dd>
+              </div>
+              <div class="view-kv">
+                <dt>分期开始时间</dt>
+                <dd>{{ formatYmd(payment?.installmentStartDate) }}</dd>
+              </div>
+            </template>
+          </dl>
+
+          <div class="form-section-divider" />
+          <h3 class="detail-section-title">缴费明细</h3>
+          <div v-if="paymentDetails.length" class="payment-detail-cards">
+            <div
+              v-for="(detail, dIdx) in paymentDetails"
+              :key="detail.id || dIdx"
+              class="payment-detail-card"
+            >
+              <div class="payment-detail-card__header">
+                <span class="payment-detail-card__title">缴费明细 #{{ dIdx + 1 }}</span>
+              </div>
+              <div class="payment-detail-card__body">
+                <dl class="view-kv-grid view-kv-grid--4">
+                  <div class="view-kv">
+                    <dt>应缴费金额</dt>
+                    <dd>{{ dash(detail.dueAmount) }}</dd>
+                  </div>
+                  <div class="view-kv">
+                    <dt>转账方式</dt>
+                    <dd>{{ transferTypeLabel(String(detail.transferType || '')) }}</dd>
+                  </div>
+                  <div class="view-kv">
+                    <dt>转账金额</dt>
+                    <dd>{{ dash(detail.transferAmount) }}</dd>
+                  </div>
+                  <div class="view-kv">
+                    <dt>转账时间</dt>
+                    <dd>{{ dash(detail.transferTime) }}</dd>
+                  </div>
+                  <div class="view-kv">
+                    <dt>缴费状态</dt>
+                    <dd>{{ payStatusLabel(String(detail.payStatus || '')) }}</dd>
+                  </div>
+                  <div v-if="payment?.payMode === 'fq'" class="view-kv">
+                    <dt>应缴费时间</dt>
+                    <dd>{{ formatYmd(detail.installmentDueDate) }}</dd>
+                  </div>
+                  <div v-if="payment?.payMode === 'fq'" class="view-kv">
+                    <dt>分期期序号</dt>
+                    <dd>{{ dash(detail.installmentNo) }}</dd>
+                  </div>
+                  <div class="view-field-block view-kv-span-2 payment-detail-card__attachments">
+                    <div class="view-field-block__label">转账凭证</div>
+                    <ProtocolAttachmentReadonly
+                      :files="detailAttachments(detail)"
+                      @preview="openPreview"
+                      @download="downloadFile"
+                    />
+                  </div>
+                </dl>
+              </div>
+            </div>
+          </div>
+          <el-empty v-else description="暂无缴费明细" :image-size="48" />
+        </div>
+      </template>
+    </div>
+
+    <template #footer>
+      <el-button class="btn-ghost" @click="emit('update:modelValue', false)">
+        <el-icon><Close /></el-icon>
+        关闭
+      </el-button>
+    </template>
+  </el-dialog>
+
+  <el-dialog v-model="previewVisible" title="文件预览" width="800px" align-center destroy-on-close>
+    <div v-if="previewType === 'image'" class="preview-container">
+      <img
+        :src="previewUrl"
+        alt="预览"
+        style="max-width: 100%; max-height: 70vh; display: block; margin: 0 auto"
+      />
+    </div>
+    <div v-else class="preview-container">
+      <video
+        :src="previewUrl"
+        controls
+        style="max-width: 100%; max-height: 70vh; display: block; margin: 0 auto"
+      />
+    </div>
+  </el-dialog>
+</template>
+
+<script setup lang="ts">
+  import { computed, nextTick, ref, watch } from 'vue'
+  import { Close } from '@element-plus/icons-vue'
+  import ProtocolAttachmentReadonly from './ProtocolAttachmentReadonly.vue'
+  import {
+    fetchCollectionProtocolDetail,
+    type CollectionProtocolRow
+  } from '@/api/collection-protocol'
+  import {
+    fetchCellSampleTypeList,
+    fetchItemUnitList,
+    fetchExpressCompanyList,
+    fetchSiteList,
+    fetchCollectionRegionList,
+    fetchHospitalList,
+    fetchUserList
+  } from '@/api/admin'
+
+  const props = defineProps<{
+    modelValue: boolean
+    protocolId: string | null
+    listRow?: CollectionProtocolRow | null
+  }>()
+
+  const emit = defineEmits<{
+    (e: 'update:modelValue', val: boolean): void
+  }>()
+
+  const formTabs = [
+    { key: 'basic', label: '基本信息' },
+    { key: 'party', label: '客户信息' },
+    { key: 'collection', label: '采集信息' },
+    { key: 'sample', label: '样本及运输信息' },
+    { key: 'payment', label: '缴费信息' }
+  ] as const
+
+  const loading = ref(false)
+  const bundle = ref<Record<string, any> | null>(null)
+  const activeTab = ref('basic')
+
+  const sampleTypeOptions = ref<Array<{ id: string; typeName: string }>>([])
+  const unitOptions = ref<Array<{ id: string; unitName: string }>>([])
+  const siteOptions = ref<Array<{ id: string; siteName: string }>>([])
+  const expressCompanyOptions = ref<Array<{ id: string; expressName: string }>>([])
+  const regionOptions = ref<Array<{ id: string; regionName: string }>>([])
+  const hospitalOptions = ref<Array<{ id: string; hospitalName: string }>>([])
+  const collectorUserOptions = ref<Array<{ id: string; nickName: string }>>([])
+  const salesUserOptions = ref<Array<{ id: string; nickName: string }>>([])
+
+  const minioBaseUrl = (import.meta.env.VITE_MINIO_BASE_URL || '').replace(/\/$/, '')
+
+  const protocol = computed(() => bundle.value?.protocol as Record<string, any> | undefined)
+  const partyCustomer = computed(() => bundle.value?.partyCustomer as Record<string, any> | null)
+  const collectionInfo = computed(() => bundle.value?.collectionInfo as Record<string, any> | null)
+  const payment = computed(() => bundle.value?.payment as Record<string, any> | null)
+  const samples = computed(() => (bundle.value?.samples as Array<Record<string, any>>) || [])
+  const paymentDetails = computed(
+    () => (bundle.value?.paymentDetails as Array<Record<string, any>>) || []
+  )
+  const protocolAttachments = computed(() => {
+    const list = bundle.value?.attachments
+    return Array.isArray(list) ? list : []
+  })
+
+  const dialogTitle = computed(() => {
+    const no = protocol.value?.protocolNo || props.listRow?.protocolNo
+    return no ? `查看协议单 — ${no}` : '查看协议单'
+  })
+
+  const collectorDisplay = computed(() => {
+    const fromList = props.listRow?.collectorUserName
+    if (fromList) return String(fromList)
+    const id = protocol.value?.collectorUserId
+    const u = collectorUserOptions.value.find((x) => x.id === id)
+    return u?.nickName || dash(id)
+  })
+
+  const salesDisplay = computed(() => {
+    const fromList = props.listRow?.salesUserName
+    if (fromList) return String(fromList)
+    const id = collectionInfo.value?.salesUserId
+    const u = salesUserOptions.value.find((x) => x.id === id)
+    return u?.nickName || dash(id)
+  })
+
+  const regionDisplay = computed(() => {
+    const fromList = props.listRow?.regionName
+    if (fromList) return String(fromList)
+    const id = collectionInfo.value?.regionId
+    const r = regionOptions.value.find((x) => x.id === id)
+    return r?.regionName || dash(id)
+  })
+
+  const hospitalDisplay = computed(() => {
+    const fromList = props.listRow?.hospitalName
+    if (fromList) return String(fromList)
+    const id = collectionInfo.value?.hospitalId
+    const h = hospitalOptions.value.find((x) => x.id === id)
+    return h?.hospitalName || dash(id)
+  })
+
+  function dash(val: unknown) {
+    if (val === null || val === undefined || val === '') return '—'
+    return String(val)
+  }
+
+  function formatYmd(val: unknown) {
+    const s = String(val || '').replace(/-/g, '')
+    if (s.length === 8) return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}`
+    return dash(val)
+  }
+
+  function formatYm(val: unknown) {
+    const s = String(val || '')
+    if (s.length === 6) return `${s.slice(0, 4)}-${s.slice(4, 6)}`
+    return dash(val)
+  }
+
+  function protocolStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dsx: '待生效',
+      sxz: '生效中',
+      ygq: '已过期',
+      yzf: '已作废',
+      zky: '转科研'
+    }
+    return m[s] || s || '—'
+  }
+
+  function payModeLabel(s: string) {
+    if (s === 'dj') return '趸交'
+    if (s === 'fq') return '分期'
+    return s || '—'
+  }
+
+  function newbornSexLabel(s: string) {
+    if (s === '1') return '男'
+    if (s === '0') return '女'
+    return s || '—'
+  }
+
+  function deliveryModeLabel(s: string) {
+    if (s === 'sc') return '顺产'
+    if (s === 'pgc') return '剖宫产'
+    return s || '—'
+  }
+
+  function sampleStatusLabel(s: string) {
+    const m: Record<string, string> = { ycj: '已采集', jcz: '检测中', yrk: '已入库', yzf: '已作废' }
+    return m[s] || s || '—'
+  }
+
+  function transportTypeLabel(s: string) {
+    if (s === 'kdys') return '快递运输'
+    if (s === 'ryxd') return '人员携带'
+    return s || '—'
+  }
+
+  function transferTypeLabel(s: string) {
+    const m: Record<string, string> = { wxzz: '微信', zzbzz: '支付宝', yhkzz: '银行卡', xj: '现金' }
+    return m[s] || s || '—'
+  }
+
+  function payStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dfj: '待缴费',
+      jfqrz: '缴费确认中',
+      yjf: '已缴费',
+      tfqrz: '退费确认中',
+      ytf: '已退费'
+    }
+    return m[s] || s || '—'
+  }
+
+  function sampleTypeName(id: string) {
+    return sampleTypeOptions.value.find((x) => x.id === id)?.typeName || dash(id)
+  }
+
+  function unitName(id: string) {
+    return unitOptions.value.find((x) => x.id === id)?.unitName || dash(id)
+  }
+
+  function siteName(id: string) {
+    return siteOptions.value.find((x) => x.id === id)?.siteName || dash(id)
+  }
+
+  function expressName(id: string) {
+    return expressCompanyOptions.value.find((x) => x.id === id)?.expressName || dash(id)
+  }
+
+  function sampleTransportExtra(transport: Record<string, any> | undefined) {
+    if (!transport?.transportType) return '—'
+    if (transport.transportType === 'kdys') {
+      const parts: string[] = []
+      const ec = expressName(String(transport.expressCompanyId || ''))
+      if (ec !== '—') parts.push(ec)
+      if (transport.waybillNo) parts.push(String(transport.waybillNo))
+      if (transport.expressFee != null && transport.expressFee !== '') {
+        parts.push(`¥${transport.expressFee}`)
+      }
+      return parts.length ? parts.join(' · ') : '—'
+    }
+    if (transport.transportType === 'ryxd') {
+      const parts: string[] = []
+      if (transport.carrierName) parts.push(String(transport.carrierName))
+      if (transport.carrierPhone) parts.push(String(transport.carrierPhone))
+      return parts.length ? parts.join(' · ') : '—'
+    }
+    return '—'
+  }
+
+  function detailAttachments(detail: Record<string, any>) {
+    return Array.isArray(detail.attachments) ? detail.attachments : []
+  }
+
+  function fullFileUrl(suffix: string) {
+    if (!suffix) return ''
+    if (suffix.startsWith('http://') || suffix.startsWith('https://') || suffix.startsWith('/'))
+      return suffix
+    return `${minioBaseUrl}/${suffix}`
+  }
+
+  function isVideoFile(file: { fileType?: string; fileName?: string }) {
+    const t = (file.fileType || '').toLowerCase()
+    if (t.startsWith('video/')) return true
+    return /\.(mp4|webm|ogg|mov)$/i.test(file.fileName || '')
+  }
+
+  const previewVisible = ref(false)
+  const previewUrl = ref('')
+  const previewType = ref<'image' | 'video'>('image')
+
+  function openPreview(file: Record<string, any>) {
+    if (!file.fileUrl) return
+    previewUrl.value = fullFileUrl(file.fileUrl)
+    previewType.value = isVideoFile(file) ? 'video' : 'image'
+    previewVisible.value = true
+  }
+
+  function downloadFile(file: Record<string, any>) {
+    const url = fullFileUrl(file.fileUrl)
+    if (!url) return
+    const a = document.createElement('a')
+    a.href = url
+    a.download = file.fileName || ''
+    a.target = '_blank'
+    document.body.appendChild(a)
+    a.click()
+    document.body.removeChild(a)
+  }
+
+  async function loadLookups(data: Record<string, any>) {
+    const [stRes, uRes, ecRes, siteRes] = await Promise.all([
+      fetchCellSampleTypeList({ page: 1, pageSize: 100 }),
+      fetchItemUnitList({ page: 1, pageSize: 100 }),
+      fetchExpressCompanyList({ page: 1, pageSize: 100 }),
+      fetchSiteList({ page: 1, pageSize: 100 })
+    ])
+    sampleTypeOptions.value = (stRes.list || []) as any
+    unitOptions.value = (uRes.list || []) as any
+    expressCompanyOptions.value = ecRes.list || []
+    siteOptions.value = siteRes.list || []
+
+    const ci = data.collectionInfo as Record<string, any> | null
+    const p = data.protocol as Record<string, any> | undefined
+    const tasks: Promise<void>[] = []
+
+    if (ci?.regionId) {
+      tasks.push(
+        fetchCollectionRegionList({ page: 1, pageSize: 100 }).then((res) => {
+          regionOptions.value = res.list || []
+        })
+      )
+      tasks.push(
+        fetchHospitalList(String(ci.regionId), { page: 1, pageSize: 100 }).then((res) => {
+          hospitalOptions.value = res.list || []
+        })
+      )
+    }
+    if (p?.collectorUserId) {
+      tasks.push(
+        fetchUserList({ page: 1, pageSize: 50, status: '1' }).then((res) => {
+          collectorUserOptions.value = res.list || []
+        })
+      )
+    }
+    if (ci?.salesUserId) {
+      tasks.push(
+        fetchUserList({ page: 1, pageSize: 50, status: '1' }).then((res) => {
+          salesUserOptions.value = res.list || []
+        })
+      )
+    }
+    await Promise.all(tasks)
+  }
+
+  async function loadDetail() {
+    if (!props.protocolId) return
+    loading.value = true
+    bundle.value = null
+    try {
+      const data = await fetchCollectionProtocolDetail(props.protocolId)
+      bundle.value = data as Record<string, any>
+      await loadLookups(data as Record<string, any>)
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function scrollToSection(key: string) {
+    activeTab.value = key
+    nextTick(() => {
+      document
+        .getElementById(`view-section-${key}`)
+        ?.scrollIntoView({ behavior: 'smooth', block: 'start' })
+    })
+  }
+
+  function handleClosed() {
+    bundle.value = null
+    activeTab.value = 'basic'
+  }
+
+  watch(
+    () => [props.modelValue, props.protocolId] as const,
+    ([visible, id]) => {
+      if (visible && id) loadDetail()
+    }
+  )
+</script>
+
+<style scoped lang="scss">
+  .protocol-view-body {
+    overflow: visible;
+  }
+
+  .detail-tabs {
+    position: sticky;
+    top: 0;
+    z-index: 1000;
+    display: flex;
+    gap: 4px;
+    background: #f5f7fa;
+    padding: 4px;
+    border-radius: 8px;
+    margin-bottom: 16px;
+    width: fit-content;
+    isolation: isolate;
+    box-shadow: 0 1px 0 #f5f7fa;
+  }
+
+  .detail-tab {
+    padding: 10px 20px;
+    cursor: pointer;
+    border-radius: 6px;
+    font-size: 14px;
+    color: #606266;
+    transition: all 0.3s;
+
+    &.active {
+      background: #fff;
+      color: #059669;
+      font-weight: 500;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
+    }
+
+    &:hover:not(.active) {
+      color: #059669;
+    }
+  }
+
+  .form-tab-pane {
+    padding: 0 0 4px;
+
+    & + .form-tab-pane {
+      margin-top: 20px;
+      padding-top: 20px;
+      border-top: 1px dashed #e2e8f0;
+    }
+  }
+
+  .detail-section-title {
+    margin: 8px 0 12px;
+    padding-left: 10px;
+    font-size: 14px;
+    font-weight: 600;
+    color: #1e293b;
+    border-left: 3px solid #10b981;
+  }
+
+  .form-section-divider {
+    margin: 16px 0;
+    border: none;
+    border-top: 1px dashed #e2e8f0;
+    height: 0;
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+
+    &--4 {
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+    }
+
+    &--5 {
+      grid-template-columns: repeat(5, minmax(0, 1fr));
+    }
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: auto 1fr;
+    gap: 4px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+      white-space: nowrap;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  .view-kv-span-2 {
+    grid-column: 1 / -1;
+  }
+
+  .view-field-empty {
+    font-size: 13px;
+    color: #94a3b8;
+  }
+
+  .sample-transport-panel {
+    padding: 12px 16px;
+    background: #f8fafc;
+    border-radius: 8px;
+  }
+
+  .sample-transport-title {
+    margin: 0 0 12px;
+    font-size: 13px;
+    font-weight: 600;
+    color: #334155;
+  }
+
+  .sub-view-table {
+    margin-bottom: 8px;
+  }
+
+  .payment-detail-cards {
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .payment-detail-card {
+    border: 1px solid #e2e8f0;
+    border-radius: 10px;
+    overflow: hidden;
+  }
+
+  .payment-detail-card__header {
+    padding: 10px 16px;
+    background: #f8fafc;
+    border-bottom: 1px solid #e2e8f0;
+  }
+
+  .payment-detail-card__title {
+    font-size: 13px;
+    font-weight: 600;
+    color: #334155;
+  }
+
+  .payment-detail-card__body {
+    padding: 14px 16px;
+  }
+
+  .payment-detail-card__attachments {
+    margin-top: 8px;
+    padding-top: 8px;
+    border-top: 1px dashed #e2e8f0;
+  }
+
+  .view-field-block {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    width: 100%;
+  }
+
+  .view-field-block__label {
+    font-size: 13px;
+    font-weight: 500;
+    color: #64748b;
+  }
+
+  .preview-container {
+    text-align: center;
+  }
+
+  @media (max-width: 1200px) {
+    .view-kv-grid--4,
+    .view-kv-grid--5 {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+  }
+</style>
diff --git a/web-admin/src/views/cell-storage/protocol/index.vue b/web-admin/src/views/cell-storage/protocol/index.vue
new file mode 100644
index 00000000..dd46aa54
--- /dev/null
+++ b/web-admin/src/views/cell-storage/protocol/index.vue
@@ -0,0 +1,410 @@
+<!-- 采集协议单 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>采集协议单</h1>
+      <p class="page-desc">查看与管理采集协议单主数据。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">协议单列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="协议号/备注" clearable />
+            </el-form-item>
+            <el-form-item label="协议状态">
+              <el-select
+                v-model="searchForm.protocolStatus"
+                clearable
+                placeholder="全部"
+                style="width: 100%"
+              >
+                <el-option label="待生效" value="dsx" />
+                <el-option label="生效中" value="sxz" />
+                <el-option label="已过期" value="ygq" />
+                <el-option label="已作废" value="yzf" />
+                <el-option label="转科研" value="zky" />
+              </el-select>
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">列表为概要信息，详情见弹窗。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"
+                ><el-icon><RefreshLeft /></el-icon>重置</el-button
+              >
+              <el-button class="btn-main" type="primary" @click="handleSearch"
+                ><el-icon><Search /></el-icon>搜索</el-button
+              >
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button type="primary" class="btn-main" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增
+          </el-button>
+          <el-button class="btn-ghost" :disabled="!selectedRows.length" @click="handleBatchDelete">
+            <el-icon><Delete /></el-icon>
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="protocolNo"
+            label="协议号"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="protocolStatus"
+            label="状态"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              protocolStatusLabel(String(row.protocolStatus || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="registerDate"
+            label="登记日期"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherName"
+            label="母亲姓名"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherPhone"
+            label="母亲电话"
+            min-width="130"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="motherIdCard"
+            label="母亲身份证号"
+            min-width="190"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="fatherName"
+            label="父亲姓名"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="newbornSex"
+            label="新生儿性别"
+            width="110"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              newbornSexLabel(String(row.newbornSex || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="deliveryMode"
+            label="分娩方式"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">{{
+              deliveryModeLabel(String(row.deliveryMode || ''))
+            }}</template>
+          </el-table-column>
+          <el-table-column
+            prop="newbornWeightGram"
+            label="新生儿体重(克)"
+            width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="regionName"
+            label="采集地区"
+            min-width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="hospitalName"
+            label="采集医院"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="collectorUserName"
+            label="采集专员"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="salesUserName"
+            label="销售人员"
+            min-width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="sampleCollectTime"
+            label="样本采集时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="320"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleEdit(row)"
+                ><el-icon><Edit /></el-icon>编辑</el-button
+              >
+              <el-button class="btn-op-item" @click="handleDelete(row)"
+                ><el-icon><Delete /></el-icon>删除</el-button
+              >
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 新增/编辑弹窗 -->
+      <ProtocolFormDialog
+        v-model="formDialogVisible"
+        :edit-id="formDialogEditId"
+        :list-row="formDialogRow"
+        @saved="onFormSaved"
+      />
+
+      <!-- 查看弹窗 -->
+      <ProtocolViewDialog v-model="viewVisible" :protocol-id="viewProtocolId" :list-row="viewRow" />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import {
+    Plus,
+    View,
+    Edit,
+    Delete,
+    Search,
+    RefreshLeft
+  } from '@element-plus/icons-vue'
+  import ProtocolFormDialog from './ProtocolFormDialog.vue'
+  import ProtocolViewDialog from './ProtocolViewDialog.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchCollectionProtocolList,
+    fetchDeleteCollectionProtocol,
+    type CollectionProtocolRow
+  } from '@/api/collection-protocol'
+
+  defineOptions({ name: 'CellStorageProtocol' })
+
+  /* ====== 标签映射 ====== */
+  function protocolStatusLabel(s: string) {
+    const m: Record<string, string> = {
+      dsx: '待生效',
+      sxz: '生效中',
+      ygq: '已过期',
+      yzf: '已作废',
+      zky: '转科研'
+    }
+    return m[s] || s || '-'
+  }
+
+  function newbornSexLabel(s: string) {
+    if (s === '1') return '男'
+    if (s === '0') return '女'
+    return s || '-'
+  }
+
+  function deliveryModeLabel(s: string) {
+    if (s === 'sc') return '顺产'
+    if (s === 'pgc') return '剖宫产'
+    return s || '-'
+  }
+
+  /* ====== 列表 ====== */
+  const searchForm = reactive<{ keyword: string; protocolStatus: string }>({
+    keyword: '',
+    protocolStatus: ''
+  })
+  const tableData = ref<CollectionProtocolRow[]>([])
+  const selectedRows = ref<CollectionProtocolRow[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const handleSelectionChange = (rows: CollectionProtocolRow[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCollectionProtocolList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined,
+        protocolStatus: searchForm.protocolStatus || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    searchForm.protocolStatus = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  /* ====== 查看弹窗 ====== */
+  const viewVisible = ref(false)
+  const viewProtocolId = ref<string | null>(null)
+  const viewRow = ref<CollectionProtocolRow | null>(null)
+
+  function handleView(row: CollectionProtocolRow) {
+    viewProtocolId.value = String(row.id)
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  /* ====== 新增/编辑弹窗 ====== */
+  const formDialogVisible = ref(false)
+  const formDialogEditId = ref<string | null>(null)
+  const formDialogRow = ref<CollectionProtocolRow | null>(null)
+
+  function handleAdd() {
+    formDialogEditId.value = null
+    formDialogRow.value = null
+    formDialogVisible.value = true
+  }
+
+  function handleEdit(row: CollectionProtocolRow) {
+    formDialogEditId.value = row.id
+    formDialogRow.value = row
+    formDialogVisible.value = true
+  }
+
+  function onFormSaved() {
+    loadData()
+  }
+
+  /* ====== 删除 ====== */
+  function handleDelete(row: CollectionProtocolRow) {
+    ElMessageBox.confirm(`确认删除协议号「${row.protocolNo}」？`, '删除确认', {
+      confirmButtonText: '确定',
+      cancelButtonText: '取消',
+      type: 'warning'
+    })
+      .then(async () => {
+        await fetchDeleteCollectionProtocol(String(row.id))
+        loadData()
+      })
+      .catch(() => {})
+  }
+
+  async function handleBatchDelete() {
+    if (!selectedRows.value.length) return
+    await ElMessageBox.confirm(`确认删除选中的 ${selectedRows.value.length} 条记录？`, '批量删除', {
+      confirmButtonText: '确定',
+      cancelButtonText: '取消',
+      type: 'warning'
+    })
+    const rows = [...selectedRows.value]
+    await withFullscreenLoading(async () => {
+      for (const row of rows) {
+        await fetchDeleteCollectionProtocol(String(row.id))
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/cell-storage/refund-confirm/index.vue b/web-admin/src/views/cell-storage/refund-confirm/index.vue
new file mode 100644
index 00000000..96af073d
--- /dev/null
+++ b/web-admin/src/views/cell-storage/refund-confirm/index.vue
@@ -0,0 +1,124 @@
+<!-- 退费确认（财务） -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>退费确认</h1>
+      <p class="page-desc">仅处理「退费确认中」明细，确认后变为已退费。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">退费确认列表</h2>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table class="list-table" :data="tableData" v-loading="loading" stripe row-key="id">
+          <el-table-column type="index" label="序号" width="68" align="center" header-align="center" />
+          <el-table-column prop="protocolNo" label="协议号" min-width="130" align="center" header-align="center" />
+          <el-table-column prop="installmentNo" label="期数" width="80" align="center" header-align="center" />
+          <el-table-column prop="transferAmount" label="金额" width="120" align="center" header-align="center" />
+          <el-table-column prop="payStatus" label="状态" width="120" align="center" header-align="center">
+            <template #default>退费确认中</template>
+          </el-table-column>
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="140" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="openConfirm(row)">确认退费</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        title="确认退费"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+      >
+        <el-form label-position="top" class="biz-dialog-form">
+          <el-form-item label="财务确认附件（MinIO 地址，逗号分隔，可选）">
+            <el-input v-model="confirmAttachments" type="textarea" :rows="3" placeholder="可选" />
+          </el-form-item>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="submitLoading" @click="submitConfirm">
+            <el-icon><Check /></el-icon>
+            确认
+          </el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, reactive, onMounted } from 'vue'
+  import { Close, Check } from '@element-plus/icons-vue'
+  import { fetchRefundConfirmList, fetchRefundConfirmSubmit } from '@/api/collection-protocol'
+
+  defineOptions({ name: 'CellStorageRefundConfirm' })
+
+  const tableData = ref<Record<string, unknown>[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const submitLoading = ref(false)
+  const confirmAttachments = ref('')
+  const currentDetailId = ref<string | null>(null)
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchRefundConfirmList({
+        page: pagination.page,
+        pageSize: pagination.pageSize
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function openConfirm(row: Record<string, unknown>) {
+    currentDetailId.value = String(row.id)
+    confirmAttachments.value = ''
+    dialogVisible.value = true
+  }
+
+  async function submitConfirm() {
+    if (!currentDetailId.value) return
+    submitLoading.value = true
+    try {
+      await fetchRefundConfirmSubmit(currentDetailId.value, {
+        financeConfirmAttachments: confirmAttachments.value || undefined
+      })
+      dialogVisible.value = false
+      loadData()
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/dashboard/console/index.vue b/web-admin/src/views/dashboard/console/index.vue
index 237e2c9b..26588b97 100644
--- a/web-admin/src/views/dashboard/console/index.vue
+++ b/web-admin/src/views/dashboard/console/index.vue
@@ -36,11 +36,11 @@
   const router = useRouter()
 
   const links = [
-    { label: '商品单位', path: '/demo/unit' },
-    { label: '订单列表', path: '/demo/order' },
-    { label: '商品管理', path: '/demo/product' },
-    { label: '商品分类', path: '/demo/category' },
-    { label: '用户管理', path: '/demo/user' }
+    { label: '商品单位', path: '/system/unit' },
+    { label: '用户管理', path: '/system/user' },
+    { label: '商品分类', path: '/system/category' },
+    { label: '租户管理', path: '/system/tenant' },
+    { label: '客户管理', path: '/basic-info/customer' }
   ]
 
   const go = (path: string) => {
diff --git a/web-admin/src/views/operations/clean-room/index.vue b/web-admin/src/views/operations/clean-room/index.vue
new file mode 100644
index 00000000..cd5e2962
--- /dev/null
+++ b/web-admin/src/views/operations/clean-room/index.vue
@@ -0,0 +1,829 @@
+<!-- 洁净室管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>洁净室管理</h1>
+      <p class="page-desc">维护洁净室信息及人员进出记录。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">洁净室列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="编号/名称" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按编号、名称模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增洁净室
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column prop="roomCode" label="编号" width="140" align="center" header-align="center" />
+          <el-table-column prop="roomName" label="名称" min-width="160" align="center" header-align="center" />
+          <el-table-column label="等级" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-tag :type="gradeTagType(row.roomGrade)" effect="plain">
+                {{ gradeLabel(row.roomGrade) }}
+              </el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column label="状态" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-tag :type="row.roomStatus === 'zc' ? 'success' : 'danger'" effect="plain">
+                {{ row.roomStatus === 'zc' ? '正常' : '异常' }}
+              </el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column prop="areaSqm" label="面积(m²)" width="120" align="center" header-align="center" />
+          <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">
+                <el-icon><Edit /></el-icon>编辑
+              </el-button>
+              <el-button class="btn-op-item" @click="handleAccessLog(row)">人员进出</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">
+                <el-icon><Delete /></el-icon>删除
+              </el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 新增/编辑 洁净室弹窗 -->
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="clean-room-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="编号" prop="roomCode">
+              <el-input v-model="formData.roomCode" placeholder="如：CR-001" />
+            </el-form-item>
+            <el-form-item label="名称" prop="roomName">
+              <el-input v-model="formData.roomName" placeholder="如：一号洁净室" />
+            </el-form-item>
+            <el-form-item label="等级" prop="roomGrade">
+              <el-select v-model="formData.roomGrade" placeholder="请选择等级" style="width: 100%">
+                <el-option label="A级" value="A" />
+                <el-option label="B级" value="B" />
+                <el-option label="C级" value="C" />
+                <el-option label="D级" value="D" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="状态" prop="roomStatus">
+              <el-select v-model="formData.roomStatus" placeholder="请选择状态" style="width: 100%">
+                <el-option label="正常" value="zc" />
+                <el-option label="异常" value="yc" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="面积" prop="areaSqm">
+              <el-input
+                type="number"
+                step="any"
+                v-model="formData.areaSqm"
+                :min="0"
+                :controls="false"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="3" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 查看详情 -->
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.roomName || '洁净室详情'"
+        :icon="OfficeBuilding"
+        :meta="viewRow?.createTime || ''"
+        :sections="viewSections"
+      />
+
+      <!-- 人员进出记录弹窗 -->
+      <el-dialog
+        v-model="accessLogVisible"
+        :title="`人员进出记录 — ${accessLogRoom?.roomName || ''}`"
+        width="960px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <div class="list-toolbar" style="margin-bottom: 12px">
+          <div class="list-toolbar-row">
+            <el-button class="btn-main" type="primary" size="small" @click="handleAddLog">
+              <el-icon><Plus /></el-icon>
+              新增记录
+            </el-button>
+          </div>
+        </div>
+        <el-table
+          :data="accessLogData"
+          v-loading="accessLogLoading"
+          stripe
+          size="small"
+          row-key="id"
+          @row-dblclick="handleViewLog"
+        >
+          <el-table-column
+            type="index"
+            label="序号"
+            width="60"
+            align="center"
+            header-align="center"
+            :index="(index) => (logPagination.page - 1) * logPagination.pageSize + index + 1"
+          />
+          <el-table-column prop="personName" label="人员姓名" min-width="100" align="center" header-align="center" />
+          <el-table-column prop="deptName" label="部门" min-width="100" align="center" header-align="center" />
+          <el-table-column prop="enterTime" label="进入时间" min-width="160" align="center" header-align="center" />
+          <el-table-column prop="purpose" label="目的" min-width="120" align="center" header-align="center" show-overflow-tooltip />
+          <el-table-column prop="leaveTime" label="离开时间" min-width="160" align="center" header-align="center" />
+          <el-table-column prop="bodyTemp" label="体温(℃)" width="90" align="center" header-align="center" />
+          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleViewLog(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleEditLog(row)">
+                <el-icon><Edit /></el-icon>编辑
+              </el-button>
+              <el-button class="btn-op-item" @click="handleDeleteLog(row)">
+                <el-icon><Delete /></el-icon>删除
+              </el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar" style="margin-top: 12px">
+          <el-pagination
+            :current-page="logPagination.page"
+            :page-size="logPagination.pageSize"
+            :total="logPagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((logPagination.page = 1), (logPagination.pageSize = val), loadAccessLogData())"
+            @current-change="(val) => ((logPagination.page = val), loadAccessLogData())"
+          />
+        </div>
+
+        <!-- 进出记录新增/编辑弹窗（嵌套） -->
+        <el-dialog
+          v-model="logDialogVisible"
+          :title="logDialogTitle"
+          width="520px"
+          class="dialog-form-layout"
+          align-center
+          destroy-on-close
+          :close-on-click-modal="false"
+          append-to-body
+        >
+          <el-form
+            ref="logFormRef"
+            :model="logFormData"
+            :rules="logFormRules"
+            label-position="top"
+            class="access-log-dialog-form"
+            scroll-to-error
+            :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+          >
+            <div class="form-grid-2">
+              <el-form-item label="人员姓名" prop="personName">
+                <el-select
+                  v-model="logFormData.personName"
+                  class="w-full"
+                  filterable
+                  remote
+                  clearable
+                  allow-create
+                  default-first-option
+                  :remote-method="remoteSearchUsers"
+                  :loading="userSearchLoading"
+                  placeholder="输入姓名检索或手填"
+                  @change="onPersonSelectChange"
+                >
+                  <el-option
+                    v-for="u in userOptions"
+                    :key="u.id"
+                    :label="formatUserLabel(u)"
+                    :value="(u.nickName || '').trim()"
+                  />
+                </el-select>
+              </el-form-item>
+              <el-form-item label="部门" prop="deptName">
+                <el-input v-model="logFormData.deptName" placeholder="选择人员后自动填入，可手填修改" />
+              </el-form-item>
+              <el-form-item label="进入时间" prop="enterTime">
+                <el-date-picker
+                  v-model="logFormData.enterTime"
+                  type="datetime"
+                  placeholder="选择日期时间"
+                  value-format="YYYY-MM-DD HH:mm:ss"
+                  style="width: 100%"
+                />
+              </el-form-item>
+              <el-form-item label="离开时间">
+                <el-date-picker
+                  v-model="logFormData.leaveTime"
+                  type="datetime"
+                  placeholder="选择日期时间"
+                  value-format="YYYY-MM-DD HH:mm:ss"
+                  style="width: 100%"
+                />
+              </el-form-item>
+              <el-form-item label="目的" class="form-col-span-2">
+                <el-input
+                  v-model="logFormData.purpose"
+                  type="textarea"
+                  :rows="2"
+                  placeholder="请输入目的"
+                />
+              </el-form-item>
+              <el-form-item label="体温(℃)">
+                <el-input
+                  type="number"
+                  step="any"
+                  v-model="logFormData.bodyTemp"
+                  :min="34"
+                  :max="42"
+                  :controls="false"
+                  style="width: 100%"
+                />
+              </el-form-item>
+              <el-form-item label="备注">
+                <el-input v-model="logFormData.remark" placeholder="可选" />
+              </el-form-item>
+            </div>
+          </el-form>
+          <template #footer>
+            <el-button class="btn-ghost" @click="logDialogVisible = false">
+              <el-icon><Close /></el-icon>
+              取消
+            </el-button>
+            <el-button class="btn-main" type="primary" @click="handleLogSubmit" :loading="logSubmitLoading">
+              <el-icon><Check /></el-icon>
+              确定
+            </el-button>
+          </template>
+        </el-dialog>
+
+        <!-- 进出记录查看详情 -->
+        <SystemViewDialog
+          v-model:visible="logViewVisible"
+          :title="logViewRow?.personName || '进出记录详情'"
+          :icon="User"
+          :meta="logViewRow?.enterTime || ''"
+          :sections="logViewSections"
+        />
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Plus, Close, Check, View, Edit, Delete, User, OfficeBuilding } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import { buildTreePathLabelFromFlat } from '@/utils/tree-path'
+  import {
+    fetchCleanRoomList,
+    fetchCreateCleanRoom,
+    fetchUpdateCleanRoom,
+    fetchDeleteCleanRoom,
+    fetchAccessLogList,
+    fetchCreateAccessLog,
+    fetchUpdateAccessLog,
+    fetchDeleteAccessLog,
+    fetchUserList,
+    fetchDeptTree
+  } from '@/api/admin'
+
+  defineOptions({ name: 'CleanRoom' })
+
+  // ── 主表 ──────────────────────────────────────────
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<any[]>([])
+  const selectedRows = ref<any[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增洁净室')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+  const viewVisible = ref(false)
+  const viewRow = ref<any>(null)
+
+  const formData = reactive({
+    roomCode: '',
+    roomName: '',
+    roomGrade: '',
+    roomStatus: 'zc',
+    areaSqm: null as number | null,
+    remark: ''
+  })
+
+  const formRules = {
+    roomCode: [{ required: true, message: '请输入编号', trigger: 'blur' }],
+    roomName: [{ required: true, message: '请输入名称', trigger: 'blur' }]
+  }
+
+  // ── 等级映射 ──────────────────────────────────────
+  const gradeOptions = [
+    { label: 'A级', value: 'A' },
+    { label: 'B级', value: 'B' },
+    { label: 'C级', value: 'C' },
+    { label: 'D级', value: 'D' }
+  ]
+
+  function gradeTagType(grade: string) {
+    const map: Record<string, string> = { A: 'warning', B: '', C: 'info', D: 'info' }
+    return map[grade] ?? ''
+  }
+
+  function gradeLabel(grade: string) {
+    return gradeOptions.find((o) => o.value === grade)?.label ?? grade
+  }
+
+  // ── 选择 ──────────────────────────────────────────
+  const handleSelectionChange = (rows: any[]) => {
+    selectedRows.value = rows
+  }
+
+  // ── 查看详情 sections ────────────────────────────
+  const viewSections = computed(() => {
+    if (!viewRow.value) return []
+    const row = viewRow.value
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '编号', value: row.roomCode },
+          { label: '名称', value: row.roomName },
+          { label: '等级', value: gradeLabel(row.roomGrade) },
+          { label: '状态', value: row.roomStatus === 'zc' ? '正常' : '异常' },
+          { label: '面积', value: row.areaSqm ? `${row.areaSqm} m²` : '' },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
+  // ── 主表 加载 ─────────────────────────────────────
+  async function loadData() {
+    loading.value = true
+    try {
+      const res: any = await fetchCleanRoomList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  // ── 主表 表单重置 ─────────────────────────────────
+  function resetForm() {
+    formData.roomCode = ''
+    formData.roomName = ''
+    formData.roomGrade = ''
+    formData.roomStatus = 'zc'
+    formData.areaSqm = null
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增洁净室'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: any) {
+    isEdit.value = true
+    dialogTitle.value = '编辑洁净室'
+    editingId.value = row.id
+    formData.roomCode = row.roomCode || ''
+    formData.roomName = row.roomName || ''
+    formData.roomGrade = row.roomGrade || ''
+    formData.roomStatus = row.roomStatus || 'zc'
+    formData.areaSqm = row.areaSqm ?? null
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        roomCode: formData.roomCode.trim(),
+        roomName: formData.roomName.trim(),
+        roomGrade: formData.roomGrade || undefined,
+        roomStatus: formData.roomStatus || 'zc',
+        areaSqm: formData.areaSqm ?? undefined,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateCleanRoom(editingId.value, payload)
+      } else {
+        await fetchCreateCleanRoom(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  function handleView(row: any) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  async function handleDelete(row: any) {
+    await ElMessageBox.confirm('确定要删除该洁净室吗？', '提示', { type: 'warning' })
+    await fetchDeleteCleanRoom(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个洁净室吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteCleanRoom(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  // ── 人员进出记录 ──────────────────────────────────
+  const accessLogVisible = ref(false)
+  const accessLogRoom = ref<any>(null)
+  const accessLogData = ref<any[]>([])
+  const accessLogLoading = ref(false)
+  const logPagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const logDialogVisible = ref(false)
+  const logDialogTitle = ref('新增记录')
+  const logIsEdit = ref(false)
+  const logSubmitLoading = ref(false)
+  const logFormRef = ref()
+  const logEditingId = ref<string | null>(null)
+  const logViewVisible = ref(false)
+  const logViewRow = ref<any>(null)
+
+  const logFormData = reactive({
+    personName: '',
+    deptName: '',
+    enterTime: '',
+    purpose: '',
+    leaveTime: '',
+    bodyTemp: null as number | null,
+    remark: ''
+  })
+
+  const logFormRules = {
+    personName: [{ required: true, message: '请输入人员姓名', trigger: 'blur' }]
+  }
+
+  // ── 人员检索 ──────────────────────────────────────
+  const userOptions = ref<Api.User.UserItem[]>([])
+  const userSearchLoading = ref(false)
+  const flatDeptList = ref<any[]>([])
+
+  function formatUserLabel(u: Api.User.UserItem) {
+    const name = (u.nickName || '').trim() || '-'
+    const no = (u.userNo || '').trim()
+    const phone = (u.phoneNo || '').trim()
+    const parts = [name]
+    if (no) parts.push(no)
+    if (phone) parts.push(phone)
+    return parts.join(' · ')
+  }
+
+  async function remoteSearchUsers(query: string) {
+    userSearchLoading.value = true
+    try {
+      const q = (query || '').trim()
+      const res: any = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: q || undefined,
+        status: '1'
+      })
+      userOptions.value = res.list || []
+    } catch (e) {
+      console.error('检索用户失败:', e)
+      userOptions.value = []
+    } finally {
+      userSearchLoading.value = false
+    }
+  }
+
+  function onPersonSelectChange(val: string | null | undefined) {
+    if (!val) {
+      logFormData.deptName = ''
+      return
+    }
+    const user = userOptions.value.find((u) => (u.nickName || '').trim() === val)
+    if (user && user.deptId) {
+      const deptPath = buildTreePathLabelFromFlat(user.deptId, flatDeptList.value, {
+        nameKey: 'deptName'
+      })
+      logFormData.deptName = deptPath || (user.deptName || '').trim()
+    }
+  }
+
+  async function loadDeptData() {
+    try {
+      const tree: any = await fetchDeptTree()
+      const flat: any[] = []
+      const walk = (nodes: any[]) => {
+        for (const n of nodes || []) {
+          flat.push(n)
+          if (n.children?.length) walk(n.children)
+        }
+      }
+      walk(tree || [])
+      flatDeptList.value = flat
+    } catch (e) {
+      console.error('加载部门数据失败:', e)
+    }
+  }
+
+  async function resolvePersonForEdit(name: string) {
+    if (!name) return
+    userSearchLoading.value = true
+    try {
+      const res: any = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: name,
+        status: '1'
+      })
+      const list = res.list || []
+      const match = list.find((u: any) => (u.nickName || '').trim() === name)
+      if (match) {
+        userOptions.value = list
+      }
+    } catch (e) {
+      console.error('匹配用户失败:', e)
+    } finally {
+      userSearchLoading.value = false
+    }
+  }
+
+  function handleAccessLog(row: any) {
+    accessLogRoom.value = row
+    logPagination.page = 1
+    accessLogVisible.value = true
+    loadAccessLogData()
+  }
+
+  async function loadAccessLogData() {
+    if (!accessLogRoom.value) return
+    accessLogLoading.value = true
+    try {
+      const res: any = await fetchAccessLogList({
+        page: logPagination.page,
+        pageSize: logPagination.pageSize,
+        cleanRoomId: accessLogRoom.value.id
+      })
+      accessLogData.value = res.list || []
+      logPagination.total = res.total ?? 0
+    } finally {
+      accessLogLoading.value = false
+    }
+  }
+
+  function resetLogForm() {
+    logFormData.personName = ''
+    logFormData.deptName = ''
+    logFormData.enterTime = ''
+    logFormData.purpose = ''
+    logFormData.leaveTime = ''
+    logFormData.bodyTemp = null
+    logFormData.remark = ''
+    logEditingId.value = null
+    userOptions.value = []
+  }
+
+  function handleAddLog() {
+    logIsEdit.value = false
+    logDialogTitle.value = '新增记录'
+    resetLogForm()
+    logDialogVisible.value = true
+    logFormRef.value?.clearValidate?.()
+  }
+
+  function handleEditLog(row: any) {
+    logIsEdit.value = true
+    logDialogTitle.value = '编辑记录'
+    logEditingId.value = row.id
+    logFormData.personName = row.personName || ''
+    logFormData.deptName = row.deptName || ''
+    logFormData.enterTime = row.enterTime || ''
+    logFormData.purpose = row.purpose || ''
+    logFormData.leaveTime = row.leaveTime || ''
+    logFormData.bodyTemp = row.bodyTemp ?? null
+    logFormData.remark = row.remark || ''
+    logDialogVisible.value = true
+    logFormRef.value?.clearValidate?.()
+    resolvePersonForEdit(row.personName || '')
+  }
+
+  async function handleLogSubmit() {
+    await logFormRef.value?.validate?.()
+    logSubmitLoading.value = true
+    try {
+      const payload = {
+        cleanRoomId: accessLogRoom.value.id,
+        personName: logFormData.personName.trim(),
+        deptName: logFormData.deptName?.trim() || undefined,
+        enterTime: logFormData.enterTime || undefined,
+        purpose: logFormData.purpose?.trim() || undefined,
+        leaveTime: logFormData.leaveTime || undefined,
+        bodyTemp: logFormData.bodyTemp != null ? String(logFormData.bodyTemp) : undefined,
+        remark: logFormData.remark?.trim() || undefined
+      }
+      if (logIsEdit.value && logEditingId.value) {
+        await fetchUpdateAccessLog(logEditingId.value, payload)
+      } else {
+        await fetchCreateAccessLog(payload)
+      }
+      ElMessage.success(logIsEdit.value ? '更新成功' : '创建成功')
+      logDialogVisible.value = false
+      await loadAccessLogData()
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      logSubmitLoading.value = false
+    }
+  }
+
+  async function handleDeleteLog(row: any) {
+    await ElMessageBox.confirm('确定要删除该记录吗？', '提示', { type: 'warning' })
+    await fetchDeleteAccessLog(row.id)
+    ElMessage.success('删除成功')
+    await loadAccessLogData()
+  }
+
+  // ── 进出记录查看详情 ──────────────────────────────
+  const logViewSections = computed(() => {
+    if (!logViewRow.value) return []
+    const row = logViewRow.value
+    return [
+      {
+        title: '进出记录',
+        fields: [
+          { label: '人员姓名', value: row.personName },
+          { label: '部门', value: row.deptName },
+          { label: '进入时间', value: row.enterTime },
+          { label: '离开时间', value: row.leaveTime },
+          { label: '目的', value: row.purpose, span: true },
+          { label: '体温(℃)', value: row.bodyTemp ? `${row.bodyTemp}` : '' },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
+  function handleViewLog(row: any) {
+    logViewRow.value = row
+    logViewVisible.value = true
+  }
+
+  // ── 初始化 ────────────────────────────────────────
+  onMounted(() => {
+    loadData()
+    loadDeptData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .clean-room-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+  }
+
+  .access-log-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/operations/demo/index.vue b/web-admin/src/views/operations/demo/index.vue
new file mode 100644
index 00000000..f4c1c850
--- /dev/null
+++ b/web-admin/src/views/operations/demo/index.vue
@@ -0,0 +1,35 @@
+<!-- Demo 下拉框示例 -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>demo</h1>
+      <p class="page-desc">下拉框示例页面。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">选择项</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="form" label-position="top" @submit.prevent>
+          <el-form-item label="请选择">
+            <el-select v-model="form.value" placeholder="请选择" clearable style="width: 240px">
+              <el-option label="A" value="A" />
+              <el-option label="B" value="B" />
+              <el-option label="C" value="C" />
+            </el-select>
+          </el-form-item>
+        </el-form>
+      </div>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { reactive } from 'vue'
+
+const form = reactive({
+  value: ''
+})
+</script>
diff --git a/web-admin/src/views/operations/exhibition-appointment/index.vue b/web-admin/src/views/operations/exhibition-appointment/index.vue
new file mode 100644
index 00000000..56f6d06a
--- /dev/null
+++ b/web-admin/src/views/operations/exhibition-appointment/index.vue
@@ -0,0 +1,363 @@
+<!-- 展馆预约管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>展馆预约</h1>
+      <p class="page-desc">管理展馆来访预约信息，包括来访单位、联系人及到访日期等。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">预约列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="searchForm.keyword" placeholder="预约编号/来访单位/联系人" clearable />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按预约编号、来访单位、联系人模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增预约
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column prop="appointmentNo" label="预约编号" min-width="150" align="center" header-align="center" />
+          <el-table-column prop="visitOrg" label="来访单位" min-width="150" align="center" header-align="center" />
+          <el-table-column prop="contactName" label="联系人" min-width="120" align="center" header-align="center" />
+          <el-table-column prop="visitDate" label="到访日期" min-width="180" align="center" header-align="center" />
+          <el-table-column prop="visitorCount" label="人数" min-width="80" align="center" header-align="center" />
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          class="appointment-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="预约编号">
+              <el-input v-model="formData.appointmentNo" placeholder="提交后自动生成" :disabled="true" />
+            </el-form-item>
+            <el-form-item label="来访单位" prop="visitOrg">
+              <el-input v-model="formData.visitOrg" placeholder="请输入来访单位" />
+            </el-form-item>
+            <el-form-item label="联系人">
+              <el-input v-model="formData.contactName" placeholder="请输入联系人" />
+            </el-form-item>
+            <el-form-item label="到访日期">
+              <el-date-picker
+                v-model="formData.visitDate"
+                type="datetime"
+                value-format="YYYY-MM-DD HH:mm:ss"
+                placeholder="请选择到访日期"
+                style="width: 100%"
+              />
+            </el-form-item>
+            <el-form-item label="人数">
+              <el-input type="number" step="any" v-model="formData.visitorCount" :min="1" style="width: 100%" />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="formData.remark" type="textarea" :rows="3" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.appointmentNo || '预约详情'"
+        :icon="Calendar"
+        :meta="viewRow?.createTime || ''"
+        :sections="viewSections"
+      />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Plus, Close, Check, View, Calendar } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchExhibitionAppointmentList,
+    fetchCreateExhibitionAppointment,
+    fetchUpdateExhibitionAppointment,
+    fetchDeleteExhibitionAppointment
+  } from '@/api/admin'
+
+  defineOptions({ name: 'ExhibitionAppointment' })
+
+  interface AppointmentRow {
+    id: string
+    appointmentNo: string
+    visitOrg: string
+    contactName: string
+    visitDate: string
+    visitorCount: number
+    remark: string
+    createTime: string
+    [key: string]: any
+  }
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<AppointmentRow[]>([])
+  const selectedRows = ref<AppointmentRow[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增预约')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+  const viewVisible = ref(false)
+  const viewRow = ref<AppointmentRow | null>(null)
+
+  const formData = reactive({
+    appointmentNo: '',
+    visitOrg: '',
+    contactName: '',
+    visitDate: '',
+    visitorCount: 1,
+    remark: ''
+  })
+
+  const formRules = {
+    visitOrg: [{ required: true, message: '请输入来访单位', trigger: 'blur' }]
+  }
+
+  const handleSelectionChange = (rows: AppointmentRow[]) => {
+    selectedRows.value = rows
+  }
+
+  const viewSections = computed(() => {
+    if (!viewRow.value) return []
+    const row = viewRow.value
+    return [
+      {
+        title: '预约信息',
+        fields: [
+          { label: '预约编号', value: row.appointmentNo },
+          { label: '来访单位', value: row.visitOrg },
+          { label: '联系人', value: row.contactName },
+          { label: '到访日期', value: row.visitDate },
+          { label: '人数', value: row.visitorCount },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchExhibitionAppointmentList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.appointmentNo = '提交后自动生成'
+    formData.visitOrg = ''
+    formData.contactName = ''
+    formData.visitDate = ''
+    formData.visitorCount = 1
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增预约'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: AppointmentRow) {
+    isEdit.value = true
+    dialogTitle.value = '编辑预约'
+    editingId.value = row.id
+    formData.appointmentNo = row.appointmentNo || ''
+    formData.visitOrg = row.visitOrg || ''
+    formData.contactName = row.contactName || ''
+    formData.visitDate = row.visitDate || ''
+    formData.visitorCount = row.visitorCount ?? 1
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload: Record<string, any> = {
+        visitOrg: formData.visitOrg.trim(),
+        contactName: formData.contactName?.trim() || undefined,
+        visitDate: formData.visitDate || undefined,
+        visitorCount: formData.visitorCount,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateExhibitionAppointment(editingId.value, payload)
+      } else {
+        await fetchCreateExhibitionAppointment(payload)
+      }
+      ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  function handleView(row: AppointmentRow) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
+  async function handleDelete(row: AppointmentRow) {
+    await ElMessageBox.confirm('确定要删除该预约吗？', '提示', { type: 'warning' })
+    await fetchDeleteExhibitionAppointment(row.id)
+    ElMessage.success('删除成功')
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个预约吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteExhibitionAppointment(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .appointment-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/operations/storage-facility/index.vue b/web-admin/src/views/operations/storage-facility/index.vue
new file mode 100644
index 00000000..3d85f7ae
--- /dev/null
+++ b/web-admin/src/views/operations/storage-facility/index.vue
@@ -0,0 +1,1285 @@
+<!-- 库位管理（左树 + 右货架行布局） -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container storage-page" ref="pageContainerRef" :style="pageContainerStyle" v-loading="clearSlotsLoading" element-loading-text="正在清空格子..." element-loading-background="rgba(255,255,255,0.7)">
+    <header class="page-head">
+      <h1>库位管理</h1>
+      <p class="page-desc">维护库位设施树结构（罐→层→盒），以及叶子节点的格子管理。</p>
+    </header>
+
+    <section class="panel">
+      <div class="flex gap-4">
+        <!-- 左侧：库位树 -->
+        <div class="w-[280px] shrink-0 border-r border-[var(--mint-border)] pr-4">
+          <div class="panel-top storage-aside__head">
+            <h2 class="title-bar-heading">库位树</h2>
+            <el-button type="primary" size="small" @click="handleAddRoot">
+              <el-icon><Plus /></el-icon>
+              新增
+            </el-button>
+          </div>
+
+          <el-input
+            v-model="treeKeyword"
+            placeholder="搜索节点"
+            clearable
+            class="storage-tree-search"
+          />
+
+          <el-tree
+            ref="treeRef"
+            :data="treeData"
+            :props="{ label: 'nodeName', children: 'children' }"
+            node-key="id"
+            highlight-current
+            default-expand-all
+            :filter-node-method="filterNode"
+            @node-click="handleNodeClick"
+          >
+            <template #default="{ data }">
+              <div class="storage-tree-node">
+                <span v-if="data.isLeaf === 1 && slotStatsMap[data.id]" class="storage-tree-node__stats">
+                  {{ slotStatsMap[data.id].occupied }}/{{ slotStatsMap[data.id].total }}
+                </span>
+                <span class="storage-tree-node__name">{{ data.nodeName }}</span>
+                <span v-if="data.isLeaf === 1" class="storage-tree-node__leaf">存</span>
+                <div class="storage-tree-node__actions">
+                  <button title="新增子节点" @click.stop="handleAddChild(data)">+</button>
+                  <button title="编辑" @click.stop="handleEditNode(data)">✎</button>
+                  <button title="删除" @click.stop="handleDeleteNode(data)">×</button>
+                </div>
+              </div>
+            </template>
+          </el-tree>
+        </div>
+
+        <!-- 右侧：格子内容 -->
+        <div class="flex-1 min-w-0">
+          <template v-if="!selectedNode">
+            <el-empty description="请在左侧选择一个叶子节点查看格子" />
+          </template>
+
+          <template v-else-if="selectedNode.isLeaf !== 1">
+            <div class="storage-content-header">
+              <div>
+                <h3 class="title-bar-heading">
+                  {{
+                    buildTreePathLabelFromFlat(selectedNode.id, flatList, { nameKey: 'nodeName' })
+                  }}
+                </h3>
+                <p class="storage-content-subtitle">非叶子节点，请继续选择子节点</p>
+              </div>
+            </div>
+            <el-empty description="此节点下还有子节点，请展开选择叶子节点查看格子" />
+          </template>
+
+          <template v-else>
+            <div class="storage-content-header">
+              <div>
+                <h3 class="title-bar-heading">
+                  {{
+                    buildTreePathLabelFromFlat(selectedNode.id, flatList, { nameKey: 'nodeName' })
+                  }}
+                </h3>
+                <div class="storage-content-stats">
+                  <span>总数 <strong>{{ slotStats.total }}</strong></span>
+                  <span class="stats-dot">·</span>
+                  <span>空闲 <strong>{{ slotStats.empty }}</strong></span>
+                  <span class="stats-dot">·</span>
+                  <span>占用 <strong>{{ slotStats.occupied }}</strong></span>
+                </div>
+              </div>
+            </div>
+
+            <div class="storage-toolbar">
+              <el-button type="primary" @click="batchDialogVisible = true">
+                批量生成格子
+              </el-button>
+              <el-button
+                v-if="slotList.length > 0"
+                class="btn-ghost"
+                :loading="clearSlotsLoading"
+                @click="handleClearSlots"
+              >
+                清空格子
+              </el-button>
+            </div>
+
+            <div v-if="slotList.length === 0" class="storage-empty-cells">
+              <el-empty description="暂无格子" />
+            </div>
+
+            <div v-else class="shelf-scroll-wrapper" v-loading="slotLoading">
+              <div class="shelf-container">
+                <div v-for="(row, ri) in shelfRows" :key="ri" class="shelf-row-wrapper">
+                  <div class="shelf-row">
+                    <div class="shelf-label">{{ row.label }}</div>
+                    <div class="shelf-cells">
+                      <div
+                        class="shelf-cell shelf-cell--add"
+                        title="在此行前面增加格子"
+                        @click="handleAddSlotInRow(ri)"
+                      >
+                        <span class="add-icon">+</span>
+                      </div>
+                      <div
+                        v-for="cell in row.cells"
+                        :key="cell.id"
+                        class="shelf-cell"
+                        :class="{ occupied: cell.slotStatus === '占用' }"
+                        @click="handleEditSlot(cell)"
+                      >
+                        <button class="cell-delete-btn" @click.stop="handleDeleteSlot(cell)" title="删除">×</button>
+                        <span class="cell-code">{{ cell.slotCode }}</span>
+                      </div>
+                    </div>
+                  </div>
+                  <div class="shelf-add-row" title="在下方新增一行" @click="handleOpenAddRowDialog(ri)">
+                    <span class="add-row-icon">+ 新增行</span>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </template>
+        </div>
+      </div>
+
+      <!-- 节点新增/编辑弹窗 -->
+      <el-dialog
+        v-model="nodeDialogVisible"
+        :title="nodeDialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        @close="handleNodeDialogClose"
+      >
+        <el-form
+          ref="nodeFormRef"
+          :model="nodeFormData"
+          :rules="nodeFormRules"
+          label-position="top"
+          class="storage-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="上级节点">
+              <el-select
+                v-model="nodeFormData.parentId"
+                placeholder="请选择上级节点（空为根节点）"
+                clearable
+                filterable
+              >
+                <el-option
+                  v-for="item in flatList"
+                  :key="item.id"
+                  :label="buildTreePathLabelFromFlat(item.id, flatList, { nameKey: 'nodeName' })"
+                  :value="item.id"
+                />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="节点名称" prop="nodeName">
+              <el-input v-model="nodeFormData.nodeName" placeholder="请输入节点名称" />
+            </el-form-item>
+            <el-form-item label="节点类型">
+              <el-select v-model="nodeFormData.nodeType" placeholder="请选择节点类型">
+                <el-option label="设施" value="facility" />
+                <el-option label="层" value="layer" />
+                <el-option label="盒" value="box" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="是否存储格">
+              <el-switch v-model="nodeFormData.isLeaf" :active-value="1" :inactive-value="0" />
+            </el-form-item>
+            <el-form-item label="备注" class="form-col-span-2">
+              <el-input v-model="nodeFormData.remark" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="nodeDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            :loading="nodeSubmitLoading"
+            @click="handleNodeSubmit"
+          >
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 格子编辑弹窗 -->
+      <el-dialog
+        v-model="slotDialogVisible"
+        :title="slotDialogTitle"
+        width="480px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        @close="handleSlotDialogClose"
+      >
+        <el-form
+          ref="slotFormRef"
+          :model="slotFormData"
+          :rules="slotFormRules"
+          label-position="top"
+          class="storage-dialog-form"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="格子编码" prop="slotCode">
+              <el-input v-model="slotFormData.slotCode" placeholder="请输入格子编码" />
+            </el-form-item>
+            <el-form-item label="格子状态">
+              <el-select v-model="slotFormData.slotStatus" placeholder="请选择状态">
+                <el-option label="空" value="空" />
+                <el-option label="占用" value="占用" />
+              </el-select>
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="slotDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            :loading="slotSubmitLoading"
+            @click="handleSlotSubmit"
+          >
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 批量生成格子弹窗 -->
+      <el-dialog
+        v-model="batchDialogVisible"
+        title="批量生成格子"
+        width="480px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        @close="handleBatchDialogClose"
+      >
+        <el-form
+          ref="batchFormRef"
+          :model="batchForm"
+          label-position="top"
+          class="storage-dialog-form"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="行数">
+              <el-input type="number" step="any" v-model="batchForm.rows" :min="1" :max="20" style="width: 100%" />
+            </el-form-item>
+            <el-form-item label="列数">
+              <el-input type="number" step="any" v-model="batchForm.cols" :min="1" :max="20" style="width: 100%" />
+            </el-form-item>
+            <el-form-item label="编码前缀" class="form-col-span-2">
+              <template #label>
+                编码前缀<span class="form-label-tip">可选，生成格式：前缀 + 行号-列号</span>
+              </template>
+              <el-input v-model="batchForm.codePrefix" placeholder="如 A、B-、01-" />
+            </el-form-item>
+            <div class="form-col-span-2 storage-batch-preview">
+              将生成 <strong>{{ batchForm.rows * batchForm.cols }}</strong> 个格子（{{
+                batchForm.rows
+              }}
+              行 × {{ batchForm.cols }} 列）
+            </div>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="batchDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            :loading="batchSubmitLoading"
+            @click="handleBatchSubmit"
+          >
+            <el-icon><Check /></el-icon>
+            确认生成
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <!-- 新增行弹窗 -->
+      <el-dialog
+        v-model="addRowDialogVisible"
+        title="新增行"
+        width="400px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        @close="handleAddRowDialogClose"
+      >
+        <el-form :model="addRowForm" label-position="top" class="storage-dialog-form">
+          <el-form-item label="列数">
+            <el-input type="number" step="any" v-model="addRowForm.cols" :min="1" :max="20" style="width: 100%" />
+          </el-form-item>
+          <div class="storage-batch-preview">
+            将在当前行下方新增 <strong>{{ addRowForm.cols }}</strong> 个格子
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="addRowDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            :loading="addSlotLoading"
+            @click="handleAddRowBelowConfirm"
+          >
+            <el-icon><Check /></el-icon>
+            确认
+          </el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ElMessage, ElMessageBox } from 'element-plus'
+  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import {
+    fetchStorageFacilityList,
+    fetchCreateStorageFacility,
+    fetchUpdateStorageFacility,
+    fetchDeleteStorageFacility,
+    fetchStorageSlotList,
+    fetchBatchCreateSlots,
+    fetchCreateStorageSlot,
+    fetchUpdateStorageSlot,
+    fetchDeleteStorageSlot
+  } from '@/api/admin'
+  import { buildTreePathLabelFromFlat } from '@/utils/tree-path'
+
+  defineOptions({ name: 'StorageFacility' })
+
+  // Row labels use sequential numbers (1, 2, 3...)
+
+  // ==================== 树形数据 ====================
+  const loading = ref(false)
+  const flatList = ref<any[]>([])
+  const treeData = ref<any[]>([])
+  const treeRef = ref()
+  const treeKeyword = ref('')
+
+  const buildTree = (list: any[]) => {
+    const map = new Map<string, any>()
+    const roots: any[] = []
+    list.forEach((item) => {
+      map.set(item.id, { ...item, children: [] })
+    })
+    list.forEach((item) => {
+      const node = map.get(item.id)!
+      if (item.parentId && item.parentId !== '0' && map.has(item.parentId)) {
+        map.get(item.parentId)!.children.push(node)
+      } else {
+        roots.push(node)
+      }
+    })
+    return roots
+  }
+
+  const loadData = async () => {
+    loading.value = true
+    try {
+      const res: any = await fetchStorageFacilityList()
+      const list = res?.list || res || []
+      flatList.value = list
+      treeData.value = buildTree(list)
+      nextTick(loadAllSlotStats)
+    } catch (error) {
+      console.error('加载库位数据失败:', error)
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const filterNode = (value: string, data: any) => {
+    if (!value) return true
+    return data.nodeName?.includes(value)
+  }
+
+  watch(treeKeyword, (val) => {
+    treeRef.value?.filter(val)
+  })
+
+  // ==================== 节点选中 → 格子面板 ====================
+  const selectedNode = ref<any>(null)
+  const slotLoading = ref(false)
+  const slotList = ref<any[]>([])
+
+  // 各叶子节点的格子统计 { id: { total, occupied, empty } }
+  const slotStatsMap = ref<Record<string, { total: number; occupied: number; empty: number }>>({})
+
+  /** 当前选中节点的格子统计 */
+  const slotStats = computed(() => {
+    const total = slotList.value.length
+    const occupied = slotList.value.filter((s) => s.slotStatus === '占用').length
+    return { total, occupied, empty: total - occupied }
+  })
+
+  /** slotList 变化时同步更新统计 Map */
+  watch(slotList, () => {
+    if (selectedNode.value?.id) {
+      const total = slotList.value.length
+      const occupied = slotList.value.filter((s) => s.slotStatus === '占用').length
+      slotStatsMap.value = {
+        ...slotStatsMap.value,
+        [selectedNode.value.id]: { total, occupied, empty: total - occupied }
+      }
+    }
+  })
+
+  /** 加载所有叶子节点的格子统计 */
+  const loadAllSlotStats = async () => {
+    const leafNodes = flatList.value.filter((item) => item.isLeaf === 1)
+    if (leafNodes.length === 0) return
+    const results = await Promise.allSettled(
+      leafNodes.map(async (node) => {
+        const res: any = await fetchStorageSlotList({ facilityNodeId: node.id })
+        const list = res?.list || res || []
+        const total = list.length
+        const occupied = list.filter((s: any) => s.slotStatus === '占用').length
+        return { id: node.id, total, occupied, empty: total - occupied }
+      })
+    )
+    const map: Record<string, any> = { ...slotStatsMap.value }
+    results.forEach((r) => {
+      if (r.status === 'fulfilled') {
+        map[r.value.id] = r.value
+      }
+    })
+    slotStatsMap.value = map
+  }
+
+  const handleNodeClick = (data: any) => {
+    selectedNode.value = data
+    if (data.isLeaf === 1) {
+      loadSlots(data.id)
+    } else {
+      slotList.value = []
+    }
+  }
+
+  const loadSlots = async (facilityNodeId: string) => {
+    slotLoading.value = true
+    try {
+      const res: any = await fetchStorageSlotList({ facilityNodeId })
+      slotList.value = res?.list || res || []
+    } catch (error) {
+      console.error('加载格子数据失败:', error)
+      slotList.value = []
+    } finally {
+      slotLoading.value = false
+    }
+  }
+
+  // ==================== 货架行计算（按 slotCode 中的行号分组） ====================
+  const batchForm = reactive({
+    rows: 4,
+    cols: 6,
+    codePrefix: ''
+  })
+
+  /** 解析 slotCode "{prefix}{row}-{col}" 格式，提取行号和列号 */
+  const parseSlotCode = (
+    code: string
+  ): { prefix: string; row: number; col: number } | null => {
+    const match = code.match(/^(.*?)(\d+)-(\d+)$/)
+    if (!match) return null
+    return { prefix: match[1], row: parseInt(match[2], 10), col: parseInt(match[3], 10) }
+  }
+
+  const shelfRows = computed(() => {
+    const rowMap = new Map<number, { prefix: string; cells: any[] }>()
+    const ungrouped: any[] = []
+
+    for (const slot of slotList.value) {
+      const parsed = parseSlotCode(slot.slotCode || '')
+      if (parsed) {
+        if (!rowMap.has(parsed.row)) {
+          rowMap.set(parsed.row, { prefix: parsed.prefix, cells: [] })
+        }
+        rowMap.get(parsed.row)!.cells.push(slot)
+      } else {
+        ungrouped.push(slot)
+      }
+    }
+
+    // 按行号排序，每个行内按列号排序
+    const result: { label: string; cells: any[]; rowNum: number; prefix: string }[] = []
+    const sortedEntries = [...rowMap.entries()].sort(([a], [b]) => a - b)
+
+    for (const [rowNum, data] of sortedEntries) {
+      data.cells.sort((a, b) => {
+        const pa = parseSlotCode(a.slotCode || '')
+        const pb = parseSlotCode(b.slotCode || '')
+        return (pa?.col ?? 0) - (pb?.col ?? 0)
+      })
+      result.push({
+        label: String(result.length + 1),
+        cells: data.cells,
+        rowNum,
+        prefix: data.prefix
+      })
+    }
+
+    // 无法解析编码的格子归入末尾
+    if (ungrouped.length > 0) {
+      result.push({
+        label: String(result.length + 1),
+        cells: ungrouped,
+        rowNum: result.length + 1,
+        prefix: ''
+      })
+    }
+
+    return result
+  })
+
+  // ==================== 节点弹窗 ====================
+  const nodeDialogVisible = ref(false)
+  const nodeDialogTitle = ref('新增根节点')
+  const isNodeEdit = ref(false)
+  const nodeSubmitLoading = ref(false)
+  const nodeFormRef = ref()
+
+  const nodeFormData = reactive({
+    id: '',
+    parentId: '',
+    nodeName: '',
+    nodeType: 'facility',
+    isLeaf: 0 as 0 | 1,
+    remark: ''
+  })
+
+  const nodeFormRules = {
+    nodeName: [{ required: true, message: '请输入节点名称', trigger: 'blur' }]
+  }
+
+  const handleAddRoot = () => {
+    isNodeEdit.value = false
+    nodeDialogTitle.value = '新增根节点'
+    Object.assign(nodeFormData, {
+      id: '',
+      parentId: '',
+      nodeName: '',
+      nodeType: 'facility',
+      isLeaf: 0,
+      remark: ''
+    })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleAddChild = (data: any) => {
+    isNodeEdit.value = false
+    nodeDialogTitle.value = '新增子节点'
+    Object.assign(nodeFormData, {
+      id: '',
+      parentId: data.id,
+      nodeName: '',
+      nodeType: 'layer',
+      isLeaf: 0,
+      remark: ''
+    })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleEditNode = (data: any) => {
+    isNodeEdit.value = true
+    nodeDialogTitle.value = '编辑节点'
+    Object.assign(nodeFormData, {
+      id: data.id,
+      parentId: data.parentId || '',
+      nodeName: data.nodeName || '',
+      nodeType: data.nodeType || 'facility',
+      isLeaf: data.isLeaf ?? 0,
+      remark: data.remark || ''
+    })
+    nodeDialogVisible.value = true
+    nextTick(() => nodeFormRef.value?.clearValidate?.())
+  }
+
+  const handleNodeSubmit = async () => {
+    await nodeFormRef.value?.validate?.()
+    nodeSubmitLoading.value = true
+    try {
+      const payload = {
+        parentId: nodeFormData.parentId || undefined,
+        nodeName: nodeFormData.nodeName.trim(),
+        nodeType: nodeFormData.nodeType,
+        isLeaf: nodeFormData.isLeaf,
+        remark: nodeFormData.remark?.trim() || undefined
+      }
+      if (isNodeEdit.value && nodeFormData.id) {
+        await fetchUpdateStorageFacility(nodeFormData.id, payload)
+      } else {
+        await fetchCreateStorageFacility(payload)
+      }
+      ElMessage.success(isNodeEdit.value ? '更新成功' : '创建成功')
+      nodeDialogVisible.value = false
+      await loadData()
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      nodeSubmitLoading.value = false
+    }
+  }
+
+  const handleNodeDialogClose = () => {
+    Object.assign(nodeFormData, {
+      id: '',
+      parentId: '',
+      nodeName: '',
+      nodeType: 'facility',
+      isLeaf: 0,
+      remark: ''
+    })
+    nodeFormRef.value?.clearValidate?.()
+  }
+
+  const handleDeleteNode = async (data: any) => {
+    try {
+      const hasChildren = data.children?.length > 0
+      const msg = hasChildren
+        ? '该节点下有子节点，删除将一并删除。确定继续吗？'
+        : '确定要删除该节点吗？'
+      await ElMessageBox.confirm(msg, '提示', { type: 'warning' })
+      await fetchDeleteStorageFacility(data.id)
+      ElMessage.success('删除成功')
+      if (selectedNode.value?.id === data.id) {
+        selectedNode.value = null
+        slotList.value = []
+      }
+      await loadData()
+    } catch (error: any) {
+      if (error !== 'cancel') console.error('删除失败:', error)
+    }
+  }
+
+  // ==================== 格子弹窗 ====================
+  const slotDialogVisible = ref(false)
+  const slotDialogTitle = ref('编辑格子')
+  const isSlotEdit = ref(false)
+  const slotSubmitLoading = ref(false)
+  const slotFormRef = ref()
+  const editingSlotId = ref<string | null>(null)
+
+  const slotFormData = reactive({
+    slotCode: '',
+    slotStatus: '空',
+    remark: ''
+  })
+
+  const slotFormRules = {
+    slotCode: [{ required: true, message: '请输入格子编码', trigger: 'blur' }]
+  }
+
+  const handleEditSlot = (row: any) => {
+    isSlotEdit.value = true
+    slotDialogTitle.value = '编辑格子'
+    editingSlotId.value = row.id
+    Object.assign(slotFormData, {
+      slotCode: row.slotCode || '',
+      slotStatus: row.slotStatus || '空',
+      remark: row.remark || ''
+    })
+    slotDialogVisible.value = true
+    nextTick(() => slotFormRef.value?.clearValidate?.())
+  }
+
+  const handleSlotSubmit = async () => {
+    await slotFormRef.value?.validate?.()
+    slotSubmitLoading.value = true
+    try {
+      const payload = {
+        facilityNodeId: selectedNode.value?.id,
+        slotCode: slotFormData.slotCode.trim(),
+        slotStatus: slotFormData.slotStatus,
+        remark: slotFormData.remark?.trim() || undefined
+      }
+      if (isSlotEdit.value && editingSlotId.value) {
+        await fetchUpdateStorageSlot(editingSlotId.value, payload)
+      }
+      ElMessage.success('更新成功')
+      slotDialogVisible.value = false
+      if (selectedNode.value?.id) await loadSlots(selectedNode.value.id)
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      slotSubmitLoading.value = false
+    }
+  }
+
+  const handleSlotDialogClose = () => {
+    Object.assign(slotFormData, { slotCode: '', slotStatus: '空', remark: '' })
+    editingSlotId.value = null
+    slotFormRef.value?.clearValidate?.()
+  }
+
+  const handleDeleteSlot = async (row: any) => {
+    try {
+      await ElMessageBox.confirm('确定要删除该格子吗？', '提示', { type: 'warning' })
+      await fetchDeleteStorageSlot(row.id)
+      ElMessage.success('删除成功')
+      if (selectedNode.value?.id) await loadSlots(selectedNode.value.id)
+    } catch (error: any) {
+      if (error !== 'cancel') console.error('删除失败:', error)
+    }
+  }
+
+  // ==================== 批量生成 ====================
+  const batchDialogVisible = ref(false)
+  const batchSubmitLoading = ref(false)
+  const batchFormRef = ref()
+
+  const handleBatchSubmit = async () => {
+    if (!selectedNode.value?.id) return
+    batchSubmitLoading.value = true
+    try {
+      await fetchBatchCreateSlots({
+        facilityNodeId: selectedNode.value.id,
+        rows: batchForm.rows,
+        cols: batchForm.cols,
+        codePrefix: batchForm.codePrefix || undefined
+      })
+      ElMessage.success('批量生成成功')
+      batchDialogVisible.value = false
+      await loadSlots(selectedNode.value.id)
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      batchSubmitLoading.value = false
+    }
+  }
+
+  const handleBatchDialogClose = () => {
+    batchForm.rows = 4
+    batchForm.cols = 6
+    batchForm.codePrefix = ''
+  }
+
+  // ==================== 清空格子 ====================
+  const clearSlotsLoading = ref(false)
+
+  const handleClearSlots = async () => {
+    if (slotList.value.length === 0) return
+    try {
+      await ElMessageBox.confirm(
+        `确定清空当前节点下所有 ${slotList.value.length} 个格子吗？此操作不可恢复。`,
+        '提示',
+        { type: 'warning' }
+      )
+      clearSlotsLoading.value = true
+      for (const slot of slotList.value) {
+        await fetchDeleteStorageSlot(slot.id)
+      }
+      ElMessage.success('已清空所有格子')
+      slotList.value = []
+    } catch (error: any) {
+      if (error !== 'cancel') console.error('清空失败:', error)
+    } finally {
+      clearSlotsLoading.value = false
+    }
+  }
+
+  // ==================== 单独新增行/格子 ====================
+  const addSlotLoading = ref(false)
+
+  /** 在指定行前面追加一个格子 */
+  const handleAddSlotInRow = async (rowIndex: number) => {
+    if (!selectedNode.value?.id || addSlotLoading.value) return
+    const row = shelfRows.value[rowIndex]
+    if (!row) return
+
+    // 计算该行下一个列号
+    let nextCol = 1
+    for (const cell of row.cells) {
+      const parsed = parseSlotCode(cell.slotCode || '')
+      if (parsed && parsed.col >= nextCol) nextCol = parsed.col + 1
+    }
+
+    const slotCode = `${row.prefix}${row.rowNum}-${nextCol}`
+    addSlotLoading.value = true
+    try {
+      await fetchCreateStorageSlot({
+        facilityNodeId: selectedNode.value.id,
+        slotCode,
+        slotStatus: '空'
+      })
+      ElMessage.success('新增格子成功')
+      await loadSlots(selectedNode.value.id)
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      addSlotLoading.value = false
+    }
+  }
+
+  /** 在指定行下方新增一行（弹窗确认，含行号重排插入） */
+  const addRowDialogVisible = ref(false)
+  const addRowForm = reactive({ cols: 4 })
+  const addRowTargetIndex = ref(-1)
+
+  const handleOpenAddRowDialog = (rowIndex: number) => {
+    addRowTargetIndex.value = rowIndex
+    addRowForm.cols = 4
+    addRowDialogVisible.value = true
+  }
+
+  const handleAddRowDialogClose = () => {
+    addRowForm.cols = 4
+    addRowTargetIndex.value = -1
+  }
+
+  const handleAddRowBelowConfirm = async () => {
+    if (!selectedNode.value?.id || addSlotLoading.value) return
+    const rowIndex = addRowTargetIndex.value
+    if (rowIndex < 0 || rowIndex >= shelfRows.value.length) return
+
+    const currentRow = shelfRows.value[rowIndex]
+    const insertRowNum = currentRow.rowNum + 1
+    const prefix = currentRow.prefix
+    const numCols = addRowForm.cols
+
+    addSlotLoading.value = true
+    try {
+      // 1. 将当前行之后的所有行号 +1（从大到小排，避免行号冲突）
+      const rowsToShift = shelfRows.value
+        .filter((r) => r.rowNum > currentRow.rowNum)
+        .sort((a, b) => b.rowNum - a.rowNum)
+
+      for (const row of rowsToShift) {
+        for (const cell of row.cells) {
+          const parsed = parseSlotCode(cell.slotCode || '')
+          if (parsed) {
+            const newCode = `${parsed.prefix}${parsed.row + 1}-${parsed.col}`
+            await fetchUpdateStorageSlot(cell.id, { slotCode: newCode })
+          }
+        }
+      }
+
+      // 2. 在插入位置创建新行的格子
+      for (let c = 1; c <= numCols; c++) {
+        await fetchCreateStorageSlot({
+          facilityNodeId: selectedNode.value.id,
+          slotCode: `${prefix}${insertRowNum}-${c}`,
+          slotStatus: '空'
+        })
+      }
+
+      ElMessage.success('新增行成功')
+      addRowDialogVisible.value = false
+      await loadSlots(selectedNode.value.id)
+    } catch {
+      /* 校验或接口错误已由全局处理 */
+    } finally {
+      addSlotLoading.value = false
+    }
+  }
+
+  // ==================== 容器高度自适应 ====================
+  const pageContainerRef = ref<HTMLElement>()
+  const pageContainerStyle = ref<Record<string, string>>({})
+
+  const updateContainerHeight = () => {
+    const el = pageContainerRef.value
+    if (!el) return
+    const top = Math.ceil(el.getBoundingClientRect().top)
+    // 减去父容器 .layout-content 的 bottom padding
+    const parentPaddingBottom = parseInt(getComputedStyle(el.parentElement!).paddingBottom) || 0
+    pageContainerStyle.value = {
+      height: `calc(100vh - ${top + parentPaddingBottom}px - 15px)`,
+      overflow: 'hidden'
+    }
+  }
+
+  // ==================== 初始化 ====================
+  onMounted(() => {
+    loadData()
+    nextTick(updateContainerHeight)
+    window.addEventListener('resize', updateContainerHeight)
+  })
+
+  onBeforeUnmount(() => {
+    window.removeEventListener('resize', updateContainerHeight)
+  })
+</script>
+
+<style lang="scss" scoped>
+  /* Full-height layout: panel stops 15px from viewport bottom */
+  .storage-page {
+    display: flex;
+    flex-direction: column;
+    min-height: unset !important;
+  }
+
+  .page-head {
+    flex-shrink: 0;
+  }
+
+  .panel {
+    flex: 1;
+    min-height: 0;
+    overflow: hidden;
+    display: flex;
+    flex-direction: column;
+    padding: 0;
+
+    /* The flex row (left tree + right content) */
+    > .flex {
+      flex: 1;
+      min-height: 0;
+      overflow: hidden;
+    }
+  }
+
+  /* Left tree area — scroll independently */
+  .panel > .flex > :first-child {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: hidden;
+  }
+
+  .panel > .flex > :first-child :deep(.el-tree) {
+    flex: 1;
+    min-height: 0;
+    overflow-y: auto;
+    scrollbar-width: none;
+
+    &::-webkit-scrollbar {
+      display: none;
+    }
+  }
+
+  /* Right content area — scroll independently */
+  .panel > .flex > :last-child {
+    overflow-y: auto;
+    padding: 0 4px;
+    scrollbar-width: none;
+
+    &::-webkit-scrollbar {
+      display: none;
+    }
+  }
+
+  .storage-aside__head {
+    flex-direction: column;
+    align-items: stretch;
+    justify-content: flex-start;
+    flex-wrap: nowrap;
+    gap: 8px;
+  }
+
+  .storage-tree-search {
+    margin-bottom: 12px;
+    flex-shrink: 0;
+  }
+
+  .storage-tree-node {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    flex: 1;
+    font-size: 13px;
+    overflow: hidden;
+
+    &__stats {
+      font-size: 10px;
+      padding: 1px 5px;
+      border-radius: 3px;
+      background: #d1fae5;
+      color: #059669;
+      flex-shrink: 0;
+      font-weight: 600;
+      white-space: nowrap;
+    }
+
+    &__name {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    &__leaf {
+      font-size: 11px;
+      padding: 1px 6px;
+      border-radius: 3px;
+      background: #ecfdf5;
+      color: #059669;
+      flex-shrink: 0;
+    }
+
+    &__actions {
+      display: flex;
+      gap: 2px;
+      margin-left: auto;
+      opacity: 0;
+      transition: opacity 0.15s;
+      flex-shrink: 0;
+
+      button {
+        background: none;
+        border: none;
+        cursor: pointer;
+        padding: 2px 4px;
+        font-size: 12px;
+        color: #909399;
+        line-height: 1;
+
+        &:hover {
+          color: #10b981;
+        }
+      }
+    }
+
+    &:hover .storage-tree-node__actions {
+      opacity: 1;
+    }
+  }
+
+  :deep(.el-tree-node__content) {
+    &:hover .storage-tree-node__actions {
+      opacity: 1;
+    }
+  }
+
+  .storage-content-header {
+    margin-top: 10px;
+    margin-bottom: 16px;
+    padding-bottom: 12px;
+    border-bottom: 1px solid #f0f0f0;
+  }
+
+  .storage-content-stats {
+    font-size: 12px;
+    color: #909399;
+    margin-top: 4px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+
+    strong {
+      color: #303133;
+    }
+
+    .stats-dot {
+      color: #dcdfe6;
+    }
+  }
+
+  .storage-toolbar {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 16px;
+  }
+
+  .storage-empty-cells {
+    padding: 20px 0;
+  }
+
+  .storage-dialog-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
+    }
+  }
+
+  .storage-batch-preview {
+    background: #ecfdf5;
+    border-radius: 6px;
+    padding: 10px 14px;
+    font-size: 13px;
+    color: #059669;
+    margin-top: 4px;
+  }
+
+  /* Shelf layout — scroll wrapper for overflow */
+  .shelf-scroll-wrapper {
+    overflow: auto;
+    max-height: 100%;
+  }
+
+  .shelf-container {
+    display: flex;
+    flex-direction: column;
+    gap: 0;
+  }
+
+  .shelf-row-wrapper {
+    display: flex;
+    flex-direction: column;
+  }
+
+  .shelf-row {
+    display: flex;
+    align-items: stretch;
+  }
+
+  .shelf-add-row {
+    display: flex;
+    align-items: center;
+    justify-content: flex-start;
+    padding: 4px 0 4px 32px;
+    cursor: pointer;
+    opacity: 0;
+    transition: opacity 0.15s;
+
+    .shelf-row-wrapper:hover & {
+      opacity: 1;
+    }
+
+    .add-row-icon {
+      font-size: 12px;
+      color: #6ee7b7;
+      padding: 2px 12px;
+      border: 1px dashed #a7f3d0;
+      border-radius: 4px;
+      transition: all 0.15s;
+    }
+
+    &:hover .add-row-icon {
+      color: #10b981;
+      border-color: #10b981;
+      background: #ecfdf5;
+    }
+  }
+
+  .shelf-label {
+    width: 28px;
+    flex-shrink: 0;
+    background: #059669;
+    color: #fff;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 12px;
+    font-weight: 600;
+    border-radius: 4px 0 0 4px;
+  }
+
+  .shelf-cells {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 4px;
+  }
+
+  .shelf-cell {
+    width: 40px;
+    height: 40px;
+    border: 1px solid #d1fae5;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    transition: all 0.15s;
+    position: relative;
+    border-radius: 4px;
+    flex-shrink: 0;
+
+    &:hover {
+      background: #ecfdf5;
+    }
+
+    /* 占用状态 — 深绿背景 */
+    &.occupied {
+      background: #059669;
+      border-color: #047857;
+
+      &:hover {
+        background: #047857;
+      }
+
+      .cell-code {
+        color: #fff;
+      }
+    }
+
+    /* 新增格子按钮 */
+    &--add {
+      border: 1px dashed #a7f3d0;
+      background: transparent;
+
+      &:hover {
+        background: #ecfdf5;
+        border-color: #10b981;
+      }
+
+      .add-icon {
+        font-size: 20px;
+        color: #6ee7b7;
+        line-height: 1;
+      }
+
+      &:hover .add-icon {
+        color: #10b981;
+      }
+    }
+  }
+
+  .cell-delete-btn {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 14px;
+    height: 14px;
+    border: none;
+    border-radius: 0 4px 0 4px;
+    background: rgba(245, 108, 108, 0.85);
+    color: #fff;
+    font-size: 10px;
+    line-height: 14px;
+    text-align: center;
+    cursor: pointer;
+    padding: 0;
+    opacity: 0;
+    transition: opacity 0.15s;
+    z-index: 1;
+
+    &:hover {
+      background: #f56c6c;
+    }
+
+    .shelf-cell:hover & {
+      opacity: 1;
+    }
+  }
+
+  .cell-code {
+    font-size: 10px;
+    font-weight: 600;
+    color: #303133;
+    text-align: center;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    max-width: 34px;
+  }
+</style>
diff --git a/web-admin/src/views/system/category/index.vue b/web-admin/src/views/system/category/index.vue
index 55f6ec1a..e31b3847 100644
--- a/web-admin/src/views/system/category/index.vue
+++ b/web-admin/src/views/system/category/index.vue
@@ -89,6 +89,7 @@
       row-key="id"
       :tree-props="{ children: 'children', hasChildren: 'hasChildren' }"
       @selection-change="handleCategoryTableSelectionChange"
+      @row-dblclick="handleView"
     >
       <el-table-column type="selection" width="55" align="center" header-align="center" />
       <el-table-column
@@ -136,7 +137,6 @@
           <span>{{ formatPriceCoefficient(row.priceCoefficient) }}</span>
         </template>
       </el-table-column>
-      <el-table-column prop="sortOrder" label="排序" width="80" align="center" header-align="center" />
       <el-table-column prop="isActive" label="状态" width="80" align="center" header-align="center">
         <template #default="{ row }">
           <el-tag :type="row.isActive ? 'success' : 'info'" size="small">
@@ -144,9 +144,10 @@
           </el-tag>
         </template>
       </el-table-column>
-      <el-table-column prop="createAt" label="创建时间" width="160" align="center" header-align="center" />
-      <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
+      <el-table-column prop="createAt" label="创建时间" width="180" align="center" header-align="center" />
+      <el-table-column label="操作" width="400" fixed="right" align="center" header-align="center">
         <template #default="{ row }">
+          <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
           <el-button class="btn-op-item primary" @click="handleAddChild(row)" v-if="!row.parentId">
             新增子分类
           </el-button>
@@ -193,12 +194,12 @@
             <div class="form-row">
               <el-form-item label="价格系数" prop="priceCoefficient" class="flex-1">
                 <div class="price-coefficient-field">
-                  <el-input-number
+                  <el-input
+                    type="number"
+                    step="any"
                     v-model="formData.priceCoefficient"
                     :min="0"
                     :max="100"
-                    :precision="2"
-                    :step="0.5"
                     controls-position="right"
                     class="price-coefficient-input"
                   />
@@ -228,9 +229,6 @@
                   </el-upload>
                 </div>
               </el-form-item>
-              <el-form-item label="排序" class="flex-1">
-                <el-input-number v-model="formData.sortOrder" :min="0" />
-              </el-form-item>
             </div>
             <div class="form-row">
               <el-form-item label="状态" v-if="isEdit" class="flex-1">
@@ -425,6 +423,14 @@
         </el-button>
       </template>
     </el-dialog>
+
+    <SystemViewDialog
+      v-model:visible="viewVisible"
+      :title="viewRow?.name || '分类详情'"
+      :icon="Files"
+      :meta="`${viewRow?.isActive ? '启用' : '禁用'}${viewRow?.createAt ? ' · ' + viewRow.createAt : ''}`"
+      :sections="viewSections"
+    />
     </section>
   </div>
 </template>
@@ -434,9 +440,10 @@
   import { ref, reactive, onMounted, nextTick, watch, computed } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
   import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
-  import { Plus, Search, Rank, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Search, Rank, Close, Check, View, Files } from '@element-plus/icons-vue'
   import { VueDraggable as draggable } from 'vue-draggable-plus'
   import type { UploadFile } from 'element-plus'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
   import {
     fetchCategoryList,
     fetchCreateCategory,
@@ -459,6 +466,31 @@
   const categoryList = ref<any[]>([])
   const parentCategoryList = ref<any[]>([])
 
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<any>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '分类名称', value: row.name },
+          { label: '上级分类', value: row.parentId ? parentCategoryList.value.find((c: any) => c.id === row.parentId)?.name || row.parentId : '无' },
+          { label: '价格系数', value: formatPriceCoefficient(row.priceCoefficient) },
+          { label: '状态', value: row.isActive ? '启用' : '禁用' },
+          { label: '图片', value: row.imageUrl || '无' },
+          { label: '创建时间', value: row.createAt }
+        ]
+      }
+    ]
+  })
+  function handleView(row: any) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   const handleCategoryTableSelectionChange = (rows: any[]) => {
     selectedRows.value = rows
   }
@@ -1248,15 +1280,7 @@
   border-top: none !important;
 }
 
-.category-dialog-form {
-  :deep(.el-form-item__label) {
-    font-size: 11px;
-    font-weight: 500;
-    color: var(--mint-text-muted);
-    padding: 0 0 4px;
-    line-height: 1.2;
-  }
-}
+
 
 .category-image-row { display: flex; gap: 12px; align-items: center; }
 .category-image-placeholder {
@@ -1289,7 +1313,9 @@
   color: #303133;
   margin-bottom: 16px;
   padding-bottom: 12px;
+  padding-left: 10px;
   border-bottom: 1px solid #ebeef5;
+  border-left: 3px solid #10b981;
 }
 
 .form-row {
diff --git a/web-admin/src/views/system/dept/index.vue b/web-admin/src/views/system/dept/index.vue
index 6113be77..f6b1db33 100644
--- a/web-admin/src/views/system/dept/index.vue
+++ b/web-admin/src/views/system/dept/index.vue
@@ -55,17 +55,15 @@
           :tree-props="{ children: 'children', hasChildren: 'hasChildren' }"
           :default-expand-all="isExpandAll"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
-          <el-table-column
-            type="selection"
-            width="55"
-            align="center"
-            header-align="center"
-          />
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
             prop="deptName"
             label="组织名称"
-            min-width="200"
+            min-width="140"
+            align="left"
+            header-align="left"
           />
           <el-table-column
             prop="deptCategoryCode"
@@ -94,32 +92,28 @@
           <el-table-column
             prop="leader"
             label="负责人"
-            width="120"
+            width="160"
             align="center"
             header-align="center"
           />
           <el-table-column
             prop="leaderPhone"
             label="联系电话"
-            width="140"
+            width="180"
             align="center"
             header-align="center"
           />
           <el-table-column
-            prop="orderNum"
-            label="排序"
-            width="80"
-            align="center"
-            header-align="center"
-          />
-           <el-table-column
-             label="操作"
-             width="320"
-             fixed="right"
+            label="操作"
+            width="400"
+            fixed="right"
             align="center"
             header-align="center"
           >
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)">
+                <el-icon><View /></el-icon>查看
+              </el-button>
               <el-button class="btn-op-item primary" @click="handleAddChild(row)">
                 新增子组织
               </el-button>
@@ -154,11 +148,7 @@
               <el-input v-model="formData.deptName" placeholder="请输入组织名称" />
             </el-form-item>
             <el-form-item label="组织类别">
-              <el-select
-                v-model="formData.deptCategoryCode"
-                placeholder="请选择组织类别"
-                clearable
-              >
+              <el-select v-model="formData.deptCategoryCode" placeholder="请选择组织类别" clearable>
                 <el-option
                   v-for="opt in deptCategoryOptions"
                   :key="opt.value"
@@ -178,26 +168,34 @@
               </el-select>
             </el-form-item>
             <el-form-item label="负责人">
-              <el-input v-model="formData.leader" placeholder="可选" />
+              <el-select
+                v-model="leaderUserId"
+                class="w-full"
+                filterable
+                remote
+                clearable
+                reserve-keyword
+                :remote-method="remoteSearchLeaderUsers"
+                :loading="leaderUserLoading"
+                placeholder="输入关键词检索用户"
+                @change="onLeaderUserChange"
+              >
+                <el-option
+                  v-for="u in leaderUserOptions"
+                  :key="u.id"
+                  :label="formatLeaderUserLabel(u)"
+                  :value="u.id"
+                />
+              </el-select>
             </el-form-item>
             <el-form-item label="联系电话">
-              <el-input v-model="formData.leaderPhone" placeholder="可选" />
-            </el-form-item>
-            <el-form-item label="排序">
-              <el-input-number
-                v-model="formData.orderNum"
-                :min="0"
-                :max="9999"
-                controls-position="right"
+              <el-input
+                v-model="formData.leaderPhone"
+                placeholder="可选，选择负责人后自动填入，可修改"
               />
             </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
-              <el-input
-                v-model="formData.remark"
-                type="textarea"
-                :rows="2"
-                placeholder="可选"
-              />
+              <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
           </div>
         </el-form>
@@ -206,31 +204,36 @@
             <el-icon><Close /></el-icon>
             取消
           </el-button>
-          <el-button
-            class="btn-main"
-            type="primary"
-            @click="handleSubmit"
-            :loading="submitLoading"
-          >
+          <el-button class="btn-main" type="primary" @click="handleSubmit" :loading="submitLoading">
             <el-icon><Check /></el-icon>
             确定
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.deptName || '组织详情'"
+        :icon="OfficeBuilding"
+        :meta="`${viewRow?.leader ? '负责人：' + viewRow.leader : ''}${viewRow?.leader && viewRow?.createTime ? ' · ' : ''}${viewRow?.createTime || ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, computed, onMounted, nextTick } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, OfficeBuilding } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
   import {
     fetchDeptTree,
     fetchCreateDept,
     fetchUpdateDept,
     fetchDeleteDept,
-    fetchDictDataOptions
+    fetchDictDataOptions,
+    fetchUserList
   } from '@/api/admin'
 
   defineOptions({ name: 'SystemDept' })
@@ -249,6 +252,9 @@
   const formRef = ref()
   const editingId = ref<string | null>(null)
 
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Dept.DeptItem | null>(null)
+
   const formData = reactive({
     parentId: '',
     deptName: '',
@@ -267,6 +273,107 @@
   const deptCategoryOptions = ref<Api.Dict.DictDataOption[]>([])
   const statusOptions = ref<Api.Dict.DictDataOption[]>([])
 
+  /** 负责人：关联 sys_user，提交仍写 leader / leaderPhone 字符串 */
+  const leaderUserId = ref<string | null>(null)
+  const leaderUserOptions = ref<Api.User.UserItem[]>([])
+  const leaderSelectedSnapshot = ref<Api.User.UserItem | null>(null)
+  const leaderUserLoading = ref(false)
+
+  function formatLeaderUserLabel(u: Api.User.UserItem) {
+    const name = (u.nickName || '').trim() || '-'
+    const no = (u.userNo || '').trim()
+    const phone = (u.phoneNo || '').trim()
+    const parts = [name]
+    if (no) parts.push(no)
+    if (phone) parts.push(phone)
+    return parts.join(' · ')
+  }
+
+  async function remoteSearchLeaderUsers(query: string) {
+    leaderUserLoading.value = true
+    try {
+      const q = (query || '').trim()
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: q || undefined,
+        status: '1'
+      })
+      let list = [...(res.list || [])]
+      const curId = leaderUserId.value
+      if (
+        curId &&
+        leaderSelectedSnapshot.value?.id === curId &&
+        !list.some((x) => x.id === curId)
+      ) {
+        list = [leaderSelectedSnapshot.value, ...list]
+      }
+      leaderUserOptions.value = list
+    } catch (e) {
+      console.error('检索用户失败:', e)
+      leaderUserOptions.value = []
+    } finally {
+      leaderUserLoading.value = false
+    }
+  }
+
+  function onLeaderUserChange(val: string | null | undefined) {
+    if (!val) {
+      leaderUserId.value = null
+      leaderSelectedSnapshot.value = null
+      leaderUserOptions.value = []
+      formData.leader = ''
+      formData.leaderPhone = ''
+      return
+    }
+    const u =
+      leaderUserOptions.value.find((x) => x.id === val) ||
+      (leaderSelectedSnapshot.value?.id === val ? leaderSelectedSnapshot.value : undefined)
+    if (!u) return
+    leaderSelectedSnapshot.value = { ...u }
+    formData.leader = (u.nickName || '').trim()
+    formData.leaderPhone = (u.phoneNo || '').trim()
+  }
+
+  async function resolveLeaderUserForEdit() {
+    leaderUserId.value = null
+    leaderSelectedSnapshot.value = null
+    leaderUserOptions.value = []
+    const name = (formData.leader || '').trim()
+    const phone = (formData.leaderPhone || '').trim()
+    if (!name && !phone) return
+    leaderUserLoading.value = true
+    try {
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: name || phone || undefined,
+        status: '1'
+      })
+      const list = res.list || []
+      const match =
+        list.find(
+          (u) =>
+            (u.nickName || '').trim() === name && (!phone || (u.phoneNo || '').trim() === phone)
+        ) ||
+        (name ? list.find((u) => (u.nickName || '').trim() === name) : undefined) ||
+        (name ? list.find((u) => (u.userNo || '').trim() === name) : undefined)
+      if (match) {
+        leaderUserOptions.value = list
+        leaderUserId.value = match.id
+        leaderSelectedSnapshot.value = { ...match }
+        formData.leader = (match.nickName || '').trim()
+        if ((match.phoneNo || '').trim()) {
+          formData.leaderPhone = (match.phoneNo || '').trim()
+        }
+      }
+    } catch (e) {
+      console.error('匹配负责人用户失败:', e)
+    } finally {
+      leaderUserLoading.value = false
+    }
+  }
+
   const loadDictOptions = async () => {
     try {
       const [zzlbbm, bmzt] = await Promise.all([
@@ -286,10 +393,53 @@
     return opt ? opt.label : code
   }
 
+  const viewSections = computed(() => [
+    {
+      title: '基本信息',
+      fields: [
+        { label: '组织名称', value: viewRow.value?.deptName },
+        { label: '组织类别', value: getDeptCategoryLabel(viewRow.value?.deptCategoryCode || '') },
+        { label: '状态', value: viewRow.value?.status === '1' ? '正常' : '停用' },
+        { label: '负责人', value: viewRow.value?.leader },
+        { label: '联系电话', value: viewRow.value?.leaderPhone },
+        { label: '备注', value: viewRow.value?.remark, span: true }
+      ]
+    }
+  ])
+
+  function handleView(row: Api.Dept.DeptItem) {
+    viewRow.value = { ...row }
+    viewVisible.value = true
+  }
+
   const handleSelectionChange = (rows: Api.Dept.DeptItem[]) => {
     selectedRows.value = rows
   }
 
+  /** 树表格的 default-expand-all 只在初次挂载生效，展开态需用表格 API 同步 */
+  function applyTreeExpand(expand: boolean) {
+    const table = tableRef.value
+    if (!table?.toggleRowExpansion) return
+    const preorder = (items: Api.Dept.DeptItem[]) => {
+      for (const row of items) {
+        if (row.children?.length) {
+          table.toggleRowExpansion(row, expand)
+          preorder(row.children)
+        }
+      }
+    }
+    const postorder = (items: Api.Dept.DeptItem[]) => {
+      for (const row of items) {
+        if (row.children?.length) {
+          postorder(row.children)
+          table.toggleRowExpansion(row, expand)
+        }
+      }
+    }
+    if (expand) preorder(tableData.value)
+    else postorder(tableData.value)
+  }
+
   async function loadData() {
     loading.value = true
     try {
@@ -297,6 +447,8 @@
         keyword: searchForm.keyword || undefined
       })
       tableData.value = res || []
+      await nextTick()
+      applyTreeExpand(isExpandAll.value)
     } catch (error) {
       console.error('加载组织数据失败:', error)
     } finally {
@@ -315,7 +467,9 @@
 
   function toggleExpand() {
     isExpandAll.value = !isExpandAll.value
-    tableData.value = [...tableData.value]
+    nextTick(() => {
+      applyTreeExpand(isExpandAll.value)
+    })
   }
 
   function resetForm() {
@@ -328,6 +482,9 @@
     formData.orderNum = 0
     formData.remark = ''
     editingId.value = null
+    leaderUserId.value = null
+    leaderUserOptions.value = []
+    leaderSelectedSnapshot.value = null
   }
 
   function handleAdd() {
@@ -362,6 +519,9 @@
     formData.remark = row.remark || ''
     dialogVisible.value = true
     formRef.value?.clearValidate?.()
+    nextTick(() => {
+      resolveLeaderUserForEdit()
+    })
   }
 
   async function handleSubmit() {
@@ -425,13 +585,5 @@
     :deep(.el-form-item) {
       margin-bottom: 0;
     }
-
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/dict/index.vue b/web-admin/src/views/system/dict/index.vue
index 630e25d3..8f16644c 100644
--- a/web-admin/src/views/system/dict/index.vue
+++ b/web-admin/src/views/system/dict/index.vue
@@ -62,6 +62,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column
             type="selection"
@@ -91,36 +92,31 @@
             align="center"
             header-align="center"
           />
-          <el-table-column
-            prop="orderNum"
-            label="排序"
-            width="80"
-            align="center"
-            header-align="center"
-          />
           <el-table-column
             prop="remark"
             label="备注"
             min-width="150"
-            show-overflow-tooltip
             align="center"
             header-align="center"
           />
           <el-table-column
             prop="createTime"
             label="创建时间"
-            min-width="160"
+            min-width="180"
             align="center"
             header-align="center"
           />
           <el-table-column
             label="操作"
-            width="320"
+            width="400"
             fixed="right"
             align="center"
             header-align="center"
           >
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)">
+                <el-icon><View /></el-icon>查看
+              </el-button>
               <el-button
                 class="btn-op-item primary"
                 @click="handleDictData(row)"
@@ -180,17 +176,6 @@
                 :disabled="isEdit"
               />
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input
                 v-model="formData.remark"
@@ -217,6 +202,14 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.dictName || '字典详情'"
+        :icon="Collection"
+        :meta="`字典类型编码：${viewRow?.dictType || ''}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
     </section>
 
     <el-dialog
@@ -256,13 +249,6 @@
           align="center"
           header-align="center"
         />
-        <el-table-column
-          prop="orderNum"
-          label="排序"
-          width="80"
-          align="center"
-          header-align="center"
-        />
         <el-table-column
           prop="remark"
           label="备注"
@@ -337,17 +323,6 @@
             <el-form-item label="数据值" prop="dictValue">
               <el-input v-model="dictDataFormData.dictValue" placeholder="数据值" />
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="dictDataFormData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input
                 v-model="dictDataFormData.remark"
@@ -381,7 +356,9 @@
 <script setup lang="ts">
   import { ref, reactive, onMounted, computed } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, Collection } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
   import {
     fetchDictTypeList,
     fetchCreateDictType,
@@ -407,6 +384,10 @@
   const formRef = ref()
   const editingId = ref<string | null>(null)
 
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Dict.DictTypeItem | null>(null)
+  const viewDictDataList = ref<Api.Dict.DictDataItem[]>([])
+
   const formData = reactive({
     dictName: '',
     dictType: '',
@@ -457,6 +438,47 @@
     editingId.value = null
   }
 
+  const viewSections = computed(() => {
+    const sections: any[] = [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '字典名称', value: viewRow.value?.dictName },
+          { label: '字典类型编码', value: viewRow.value?.dictType },
+          { label: '备注', value: viewRow.value?.remark, span: true },
+          { label: '创建时间', value: viewRow.value?.createTime }
+        ]
+      }
+    ]
+    if (viewDictDataList.value.length > 0) {
+      sections.push({
+        title: '字典数据',
+        fields: viewDictDataList.value.map((item) => ({
+          label: item.dictLabel || '',
+          value: item.dictValue || '',
+          span: false
+        }))
+      })
+    }
+    return sections
+  })
+
+  async function handleView(row: Api.Dict.DictTypeItem) {
+    viewRow.value = { ...row }
+    viewDictDataList.value = []
+    viewVisible.value = true
+    try {
+      const res = await fetchDictDataList({
+        page: 1,
+        pageSize: 100,
+        dictType: row.dictType
+      })
+      viewDictDataList.value = res.list || []
+    } catch (e) {
+      console.error('加载字典数据失败:', e)
+    }
+  }
+
   function handleAdd() {
     isEdit.value = false
     dialogTitle.value = '新增字典类型'
@@ -518,11 +540,14 @@
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个字典类型吗？`, '提示', {
       type: 'warning'
     })
-    for (const id of ids) {
-      await fetchDeleteDictType(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteDictType(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   const dictDataDialogVisible = ref(false)
@@ -646,12 +671,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/express/index.vue b/web-admin/src/views/system/express/index.vue
index a6acd712..9a27d256 100644
--- a/web-admin/src/views/system/express/index.vue
+++ b/web-admin/src/views/system/express/index.vue
@@ -57,6 +57,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
@@ -69,10 +70,12 @@
           />
           <el-table-column prop="expressCode" label="快递编码" min-width="120" align="center" header-align="center" />
           <el-table-column prop="expressName" label="快递名称" min-width="140" align="center" header-align="center" />
-          <el-table-column prop="orderNum" label="排序" width="80" align="center" header-align="center" />
-          <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
             </template>
@@ -116,17 +119,6 @@
             <el-form-item label="快递名称" prop="expressName">
               <el-input v-model="formData.expressName" placeholder="请输入快递名称" />
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注">
               <el-input v-model="formData.remark" placeholder="可选" />
             </el-form-item>
@@ -143,14 +135,24 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.expressName || '快递公司详情'"
+        :icon="Van"
+        :meta="viewRow?.createTime || ''"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, onMounted, computed } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, Van } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
   import {
     fetchExpressCompanyList,
     fetchCreateExpressCompany,
@@ -171,6 +173,8 @@
   const submitLoading = ref(false)
   const formRef = ref()
   const editingId = ref<string | null>(null)
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.ExpressCompany.ExpressCompanyItem | null>(null)
 
   const formData = reactive({
     expressCode: '',
@@ -188,6 +192,21 @@
     selectedRows.value = rows
   }
 
+  const viewSections = computed(() => {
+    if (!viewRow.value) return []
+    const row = viewRow.value
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '快递编码', value: row.expressCode },
+          { label: '快递名称', value: row.expressName },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
   async function loadData() {
     loading.value = true
     try {
@@ -267,6 +286,11 @@
     }
   }
 
+  function handleView(row: Api.ExpressCompany.ExpressCompanyItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   async function handleDelete(row: Api.ExpressCompany.ExpressCompanyItem) {
     await ElMessageBox.confirm(`确定删除快递公司「${row.expressName}」吗？`, '提示', { type: 'warning' })
     await fetchDeleteExpressCompany(row.id)
@@ -278,11 +302,14 @@
     const ids = selectedRows.value.map((r) => r.id)
     if (!ids.length) return
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个快递公司吗？`, '提示', { type: 'warning' })
-    for (const id of ids) {
-      await fetchDeleteExpressCompany(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteExpressCompany(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   onMounted(() => {
@@ -296,12 +323,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/leave/index.vue b/web-admin/src/views/system/leave/index.vue
new file mode 100644
index 00000000..9e556f94
--- /dev/null
+++ b/web-admin/src/views/system/leave/index.vue
@@ -0,0 +1,331 @@
+<!-- 请假申请 — 工作流测试页面 -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>请假申请</h1>
+      <p class="page-desc">测试工作流审批流程</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">请假列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="filterForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input v-model="filterForm.keyword" placeholder="搜索原因/类型" clearable />
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-select v-model="filterForm.status" placeholder="全部" clearable style="width: 120px">
+                <el-option label="草稿" value="draft" />
+                <el-option label="审批中" value="pending" />
+                <el-option label="已通过" value="approved" />
+                <el-option label="已驳回" value="rejected" />
+              </el-select>
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按原因、类型模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset">重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">新增请假</el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          stripe
+          row-key="id"
+          v-loading="loading"
+          @selection-change="handleSelectionChange"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column prop="leaveTypeLabel" label="请假类型" width="100" align="center" header-align="center" />
+          <el-table-column prop="startDate" label="开始日期" width="120" align="center" header-align="center" />
+          <el-table-column prop="endDate" label="结束日期" width="120" align="center" header-align="center" />
+          <el-table-column prop="days" label="天数" width="80" align="center" header-align="center" />
+          <el-table-column prop="reason" label="请假原因" min-width="180" show-overflow-tooltip />
+          <el-table-column prop="status" label="状态" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-tag :type="statusTagType(row.status)" size="small">{{ statusLabel(row.status) }}</el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column prop="createTime" label="创建时间" width="180" align="center" header-align="center" />
+          <el-table-column label="操作" fixed="right" min-width="260" align="center" header-align="center">
+            <template #default="{ row }">
+              <template v-if="row.status === 'draft' || row.status === 'rejected'">
+                <el-button type="primary" link size="small" @click="handleEdit(row)">编辑</el-button>
+                <el-button type="success" link size="small" @click="handleSubmit(row.id)">提交审批</el-button>
+                <el-button type="danger" link size="small" @click="handleDelete(row.id)">删除</el-button>
+              </template>
+              <template v-else-if="row.status === 'pending'">
+                <el-tag type="warning" size="small">审批中</el-tag>
+              </template>
+              <template v-else>
+                <span style="color: #9ca3af; font-size: 12px">已结束</span>
+              </template>
+            </template>
+          </el-table-column>
+        </el-table>
+
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            v-model:current-page="pagination.page"
+            v-model:page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="loadData"
+            @current-change="loadData"
+          />
+        </div>
+      </div>
+    </section>
+
+    <el-dialog
+      v-model="dialogVisible"
+      :title="isEdit ? '编辑请假' : '新增请假'"
+      width="600px"
+      class="dialog-form-layout"
+      align-center
+      destroy-on-close
+      :close-on-click-modal="false"
+    >
+      <el-form
+        :model="formData"
+        label-position="top"
+        scroll-to-error
+        :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+      >
+        <div class="form-grid-2">
+          <el-form-item label="请假类型" required>
+            <el-select v-model="formData.leaveType" placeholder="请选择" style="width: 100%">
+              <el-option label="事假" value="personal" />
+              <el-option label="病假" value="sick" />
+              <el-option label="年假" value="annual" />
+              <el-option label="其他" value="other" />
+            </el-select>
+          </el-form-item>
+          <el-form-item label="请假天数" required>
+            <el-input
+              type="number"
+              step="any"
+              v-model="formData.days"
+              :min="0.5"
+              :max="30"
+              style="width: 100%"
+            />
+          </el-form-item>
+          <el-form-item label="开始日期" required>
+            <el-date-picker
+              v-model="formData.startDate"
+              type="date"
+              value-format="YYYY-MM-DD"
+              format="YYYY-MM-DD"
+              placeholder="选择开始日期"
+              clearable
+              style="width: 100%"
+            />
+          </el-form-item>
+          <el-form-item label="结束日期" required>
+            <el-date-picker
+              v-model="formData.endDate"
+              type="date"
+              value-format="YYYY-MM-DD"
+              format="YYYY-MM-DD"
+              placeholder="选择结束日期"
+              clearable
+              style="width: 100%"
+            />
+          </el-form-item>
+          <el-form-item label="请假原因" class="form-col-span-2">
+            <el-input v-model="formData.reason" type="textarea" :rows="3" placeholder="请输入请假原因" />
+          </el-form-item>
+          <el-form-item label="备注" class="form-col-span-2">
+            <el-input v-model="formData.remark" placeholder="选填" />
+          </el-form-item>
+        </div>
+      </el-form>
+      <template #footer>
+        <el-button class="btn-ghost" @click="dialogVisible = false">
+          <el-icon><Close /></el-icon>
+          取消
+        </el-button>
+        <el-button class="btn-main" type="primary" :loading="submitting" @click="handleSave">
+          <el-icon><Check /></el-icon>
+          保存
+        </el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { Close, Check } from '@element-plus/icons-vue'
+import {
+  fetchLeaveList,
+  fetchCreateLeave,
+  fetchUpdateLeave,
+  fetchDeleteLeave,
+  fetchSubmitLeave
+} from '@/api/leave'
+
+defineOptions({ name: 'LeaveRequest' })
+
+const loading = ref(false)
+const tableData = ref<Api.Leave.LeaveItem[]>([])
+const selectedRows = ref<Api.Leave.LeaveItem[]>([])
+const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+const filterForm = reactive({ keyword: '', status: '' })
+
+const dialogVisible = ref(false)
+const isEdit = ref(false)
+const editingId = ref('')
+const submitting = ref(false)
+
+const formData = reactive({
+  leaveType: 'personal',
+  startDate: '',
+  endDate: '',
+  days: 1,
+  reason: '',
+  remark: ''
+})
+
+const statusMap: Record<string, { label: string; type: string }> = {
+  draft: { label: '草稿', type: 'info' },
+  pending: { label: '审批中', type: 'warning' },
+  approved: { label: '已通过', type: 'success' },
+  rejected: { label: '已驳回', type: 'danger' },
+  cancelled: { label: '已取消', type: 'info' }
+}
+
+function statusLabel(s: string) {
+  return statusMap[s]?.label || s
+}
+
+function statusTagType(s: string) {
+  return statusMap[s]?.type || 'info'
+}
+
+function resetForm() {
+  formData.leaveType = 'personal'
+  formData.startDate = ''
+  formData.endDate = ''
+  formData.days = 1
+  formData.reason = ''
+  formData.remark = ''
+}
+
+function handleSelectionChange(rows: Api.Leave.LeaveItem[]) {
+  selectedRows.value = rows
+}
+
+async function loadData() {
+  loading.value = true
+  try {
+    const res = await fetchLeaveList({
+      page: pagination.page,
+      pageSize: pagination.pageSize,
+      keyword: filterForm.keyword || undefined,
+      status: filterForm.status || undefined
+    })
+    tableData.value = res.list || []
+    pagination.total = res.total || 0
+  } catch {
+    // error shown by http util
+  } finally {
+    loading.value = false
+  }
+}
+
+function handleSearch() {
+  pagination.page = 1
+  loadData()
+}
+
+function handleReset() {
+  filterForm.keyword = ''
+  filterForm.status = ''
+  pagination.page = 1
+  loadData()
+}
+
+function handleAdd() {
+  isEdit.value = false
+  editingId.value = ''
+  resetForm()
+  dialogVisible.value = true
+}
+
+function handleEdit(row: Api.Leave.LeaveItem) {
+  isEdit.value = true
+  editingId.value = row.id
+  formData.leaveType = row.leaveType
+  formData.startDate = row.startDate
+  formData.endDate = row.endDate
+  formData.days = row.days
+  formData.reason = row.reason
+  formData.remark = row.remark || ''
+  dialogVisible.value = true
+}
+
+async function handleSave() {
+  if (!formData.leaveType || !formData.startDate || !formData.endDate || !formData.days) {
+    ElMessage.warning('请填写必填项')
+    return
+  }
+  submitting.value = true
+  try {
+    if (isEdit.value) {
+      await fetchUpdateLeave(editingId.value, { ...formData })
+    } else {
+      await fetchCreateLeave({ ...formData })
+    }
+    dialogVisible.value = false
+    loadData()
+  } catch {
+    // error shown by http util
+  } finally {
+    submitting.value = false
+  }
+}
+
+async function handleSubmit(id: string) {
+  try {
+    await ElMessageBox.confirm('确定提交审批？提交后将进入审批流程。', '提示', { type: 'warning' })
+    await fetchSubmitLeave(id)
+    loadData()
+  } catch {
+    // cancelled or error
+  }
+}
+
+async function handleDelete(id: string) {
+  try {
+    await ElMessageBox.confirm('确定删除此请假申请？', '提示', { type: 'warning' })
+    await fetchDeleteLeave(id)
+    loadData()
+  } catch {
+    // cancelled or error
+  }
+}
+
+onMounted(() => loadData())
+</script>
diff --git a/web-admin/src/views/system/menu/index.vue b/web-admin/src/views/system/menu/index.vue
index 1e064f56..845af9de 100644
--- a/web-admin/src/views/system/menu/index.vue
+++ b/web-admin/src/views/system/menu/index.vue
@@ -54,6 +54,7 @@
           :tree-props="{ children: 'children', hasChildren: 'hasChildren' }"
           :default-expand-all="isExpandAll"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column
             type="selection"
@@ -65,6 +66,8 @@
             prop="menuName"
             label="菜单名称"
             min-width="180"
+            align="left"
+            header-align="left"
           />
           <el-table-column
             prop="menuType"
@@ -141,21 +144,17 @@
               </el-tag>
             </template>
           </el-table-column>
-          <el-table-column
-            prop="orderNum"
-            label="排序"
-            width="70"
-            align="center"
-            header-align="center"
-          />
-           <el-table-column
-             label="操作"
-             width="320"
-             fixed="right"
-            align="center"
-            header-align="center"
-          >
+            <el-table-column
+              label="操作"
+              width="400"
+              fixed="right"
+              align="center"
+              header-align="center"
+            >
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)">
+                <el-icon><View /></el-icon>查看
+              </el-button>
               <el-button class="btn-op-item primary" @click="handleAddChild(row)">
                 新增子菜单
               </el-button>
@@ -230,14 +229,6 @@
                 <el-option label="停用" value="0" />
               </el-select>
             </el-form-item>
-            <el-form-item label="排序">
-              <el-input-number
-                v-model="formData.orderNum"
-                :min="0"
-                :max="9999"
-                controls-position="right"
-              />
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input
                 v-model="formData.remark"
@@ -264,14 +255,23 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.menuName || '菜单详情'"
+        :icon="MenuIcon"
+        :meta="`类型：${menuTypeTagMap[viewRow?.menuType || '']?.label || viewRow?.menuType || ''}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, computed, onMounted } from 'vue'
+  import { ref, reactive, computed, onMounted, nextTick } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, Menu as MenuIcon } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
   import {
     fetchMenuTree,
     fetchCreateMenu,
@@ -301,6 +301,9 @@
   const formRef = ref()
   const editingId = ref<string | null>(null)
 
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Menu.MenuItem | null>(null)
+
   const formData = reactive({
     parentId: '0',
     menuName: '',
@@ -335,10 +338,56 @@
     return findName(tableData.value)
   })
 
+  const viewSections = computed(() => [
+    {
+      title: '基本信息',
+      fields: [
+        { label: '菜单名称', value: viewRow.value?.menuName },
+        { label: '菜单类型', value: menuTypeTagMap[viewRow.value?.menuType || '']?.label || viewRow.value?.menuType },
+        { label: '路由路径', value: viewRow.value?.path },
+        { label: '组件路径', value: viewRow.value?.component },
+        { label: '权限标识', value: viewRow.value?.perms },
+        { label: '是否外链', value: viewRow.value?.isFrame === 1 ? '否' : '是' },
+        { label: '显示状态', value: viewRow.value?.visible === '1' ? '显示' : '隐藏' },
+        { label: '状态', value: viewRow.value?.status === '1' ? '正常' : '停用' },
+        { label: '备注', value: viewRow.value?.remark, span: true }
+      ]
+    }
+  ])
+
+  function handleView(row: Api.Menu.MenuItem) {
+    viewRow.value = { ...row }
+    viewVisible.value = true
+  }
+
   const handleSelectionChange = (rows: Api.Menu.MenuItem[]) => {
     selectedRows.value = rows
   }
 
+  /** 树表格的 default-expand-all 只在初次挂载生效，展开态需用表格 API 同步 */
+  function applyTreeExpand(expand: boolean) {
+    const table = tableRef.value
+    if (!table?.toggleRowExpansion) return
+    const preorder = (items: Api.Menu.MenuItem[]) => {
+      for (const row of items) {
+        if (row.children?.length) {
+          table.toggleRowExpansion(row, expand)
+          preorder(row.children)
+        }
+      }
+    }
+    const postorder = (items: Api.Menu.MenuItem[]) => {
+      for (const row of items) {
+        if (row.children?.length) {
+          postorder(row.children)
+          table.toggleRowExpansion(row, expand)
+        }
+      }
+    }
+    if (expand) preorder(tableData.value)
+    else postorder(tableData.value)
+  }
+
   async function loadData() {
     loading.value = true
     try {
@@ -346,6 +395,8 @@
         keyword: searchForm.keyword || undefined
       })
       tableData.value = Array.isArray(res) ? res : []
+      await nextTick()
+      applyTreeExpand(isExpandAll.value)
     } catch (error) {
       console.error('加载菜单数据失败:', error)
     } finally {
@@ -364,7 +415,9 @@
 
   function toggleExpand() {
     isExpandAll.value = !isExpandAll.value
-    tableData.value = [...tableData.value]
+    nextTick(() => {
+      applyTreeExpand(isExpandAll.value)
+    })
   }
 
   function resetForm() {
@@ -483,12 +536,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/order/index.vue b/web-admin/src/views/system/order/index.vue
index 35151b37..75389355 100644
--- a/web-admin/src/views/system/order/index.vue
+++ b/web-admin/src/views/system/order/index.vue
@@ -182,7 +182,7 @@
           </div>
         </template>
       </el-table-column>
-      <el-table-column prop="orderNo" label="订单编号" min-width="180">
+      <el-table-column prop="orderNo" label="订单编号" min-width="200">
         <template #default="{ row }">
           <el-button link type="primary" @click="toggleRowExpand(row)">{{ row.orderNo }}</el-button>
         </template>
@@ -1221,8 +1221,8 @@
         </el-form-item>
       </el-form>
       <template #footer>
-        <el-button @click="cancelVisible = false">取消</el-button>
-        <el-button type="primary" @click="confirmCancel" :loading="submitLoading">确定</el-button>
+        <el-button @click="cancelVisible = false"><el-icon><Close /></el-icon>取消</el-button>
+        <el-button type="primary" @click="confirmCancel" :loading="submitLoading"><el-icon><Check /></el-icon>确定</el-button>
       </template>
     </el-dialog>
 
@@ -1265,9 +1265,9 @@
         </el-form-item>
       </el-form>
       <template #footer>
-        <el-button @click="cancelDialogVisible = false">取消</el-button>
+        <el-button @click="cancelDialogVisible = false"><el-icon><Close /></el-icon>取消</el-button>
         <el-button type="danger" @click="confirmCancelOrder" :loading="cancelDialogLoading"
-          >确认取消</el-button
+          ><el-icon><Check /></el-icon>确认取消</el-button
         >
       </template>
     </el-dialog>
@@ -1329,7 +1329,9 @@
         </el-table-column>
         <el-table-column label="新数量" min-width="140" align="center">
           <template #default="{ row }">
-            <el-input-number
+            <el-input
+              type="number"
+              step="any"
               v-model="row.newQuantity"
               :min="0"
               :controls-position="'right'"
@@ -1363,8 +1365,8 @@
       </el-form>
 
       <template #footer>
-        <el-button @click="adjustDialogVisible = false">取消</el-button>
-        <el-button type="primary" @click="confirmAdjustOrder" :loading="adjustDialogLoading">确认提交</el-button>
+        <el-button @click="adjustDialogVisible = false"><el-icon><Close /></el-icon>取消</el-button>
+        <el-button type="primary" @click="confirmAdjustOrder" :loading="adjustDialogLoading"><el-icon><Check /></el-icon>确认提交</el-button>
       </template>
     </el-dialog>
 
diff --git a/web-admin/src/views/system/post/index.vue b/web-admin/src/views/system/post/index.vue
index c1c97cee..cbed1062 100644
--- a/web-admin/src/views/system/post/index.vue
+++ b/web-admin/src/views/system/post/index.vue
@@ -57,6 +57,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
@@ -76,10 +77,14 @@
               </el-tag>
             </template>
           </el-table-column>
-          <el-table-column prop="orderNum" label="排序" width="80" align="center" header-align="center" />
-          <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="480" fixed="right" align="center" header-align="center">
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handlePostBindUsers(row)">
+                <el-icon><User /></el-icon>
+                关联用户
+              </el-button>
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
             </template>
@@ -133,17 +138,6 @@
                 />
               </el-select>
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
@@ -160,20 +154,138 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <!-- 关联用户（布局对齐角色管理「数据权限」自定义范围） -->
+      <el-dialog
+        v-model="postBindDialogVisible"
+        title="关联用户"
+        width="1120px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+      >
+        <div v-loading="postBindLoading" class="post-bind-dialog-body">
+          <p v-if="postBindPostName" class="post-bind-subtitle">
+            职位：<strong>{{ postBindPostName }}</strong>
+          </p>
+          <el-form label-position="top" class="data-scope-form">
+            <el-form-item label="绑定用户" class="data-scope-custom-form-item">
+              <div class="data-scope-custom-grid">
+                <div class="data-scope-custom-col">
+                  <div>
+                    <div class="data-scope-col-title">选择部门</div>
+                    <div class="data-scope-col-tip">点击部门名称可按该部门及子部门筛选右侧用户</div>
+                  </div>
+                  <div class="data-scope-tree-wrap">
+                    <el-tree
+                      ref="postBindDeptTreeRef"
+                      :data="postBindDeptTreeData"
+                      highlight-current
+                      node-key="id"
+                      :props="{ label: 'deptName', children: 'children' }"
+                      default-expand-all
+                      :expand-on-click-node="false"
+                      @node-click="handlePostBindDeptNodeClick"
+                    />
+                  </div>
+                </div>
+                <div class="data-scope-custom-col">
+                  <div class="data-scope-col-head-row">
+                    <span class="data-scope-col-title">选择用户</span>
+                    <el-button
+                      v-if="postBindUserFilterDeptId"
+                      class="btn-ghost"
+                      size="small"
+                      @click="clearPostBindUserDeptFilter"
+                    >
+                      清除部门筛选
+                    </el-button>
+                  </div>
+                  <el-input
+                    v-model="postBindUserKeyword"
+                    class="data-scope-user-filter"
+                    clearable
+                    placeholder="按姓名、账号过滤"
+                  />
+                  <div class="data-scope-user-list-wrap">
+                    <el-checkbox-group
+                      v-if="postBindFilteredUsers.length > 0"
+                      v-model="postBindUserCheckedKeys"
+                    >
+                      <div
+                        v-for="u in postBindFilteredUsers"
+                        :key="u.id"
+                        class="data-scope-user-row"
+                      >
+                        <el-checkbox :value="u.id">{{ postBindUserOptionLabel(u) }}</el-checkbox>
+                      </div>
+                    </el-checkbox-group>
+                    <el-empty v-else :description="postBindUserEmptyDesc" :image-size="40" />
+                  </div>
+                </div>
+              </div>
+              <div class="data-scope-selection-summary">
+                <template v-if="postBindSelectedUserSummaries.length > 0">
+                  <div class="data-scope-summary-block">
+                    <div class="data-scope-summary-heading">已选用户</div>
+                    <ul class="data-scope-summary-list">
+                      <li v-for="row in postBindSelectedUserSummaries" :key="'u-' + row.id">
+                        {{ row.label }}
+                      </li>
+                    </ul>
+                  </div>
+                </template>
+                <p v-else class="data-scope-summary-empty">暂未勾选用户</p>
+              </div>
+            </el-form-item>
+          </el-form>
+        </div>
+        <template #footer>
+          <el-button class="btn-ghost" @click="postBindDialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button
+            class="btn-main"
+            type="primary"
+            @click="handlePostBindSubmit"
+            :loading="postBindSubmitLoading"
+          >
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.postName || '职位详情'"
+        :icon="Briefcase"
+        :meta="`职位编码：${viewRow?.postCode || ''}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, computed, onMounted, nextTick } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, User, View, Briefcase } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { MAX_ADMIN_LIST_PAGE_SIZE } from '@/utils/fetch-paged-list'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
   import {
     fetchPostList,
     fetchCreatePost,
     fetchUpdatePost,
     fetchDeletePost,
-    fetchDictDataOptions
+    fetchDictDataOptions,
+    fetchDeptTree,
+    fetchUserList,
+    fetchPostBoundUserIds,
+    fetchUpdatePostBoundUsers
   } from '@/api/admin'
 
   defineOptions({ name: 'SystemPost' })
@@ -205,6 +317,221 @@
 
   const statusOptions = ref<Api.Dict.DictDataOption[]>([])
 
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Post.PostItem | null>(null)
+  const viewBoundUserNames = ref<string[]>([])
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    const sections: any[] = [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '职位名称', value: row.postName },
+          { label: '职位编码', value: row.postCode },
+          { label: '状态', value: row.status === '1' ? '正常' : '停用' },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+    if (viewBoundUserNames.value.length > 0) {
+      sections.push({
+        title: '关联用户',
+        fields: [
+          { label: '已关联用户', value: viewBoundUserNames.value.join('、'), span: true }
+        ]
+      })
+    }
+    return sections
+  })
+  async function handleView(row: Api.Post.PostItem) {
+    viewRow.value = row
+    viewBoundUserNames.value = []
+    viewVisible.value = true
+    try {
+      const [boundRes] = await Promise.all([
+        fetchPostBoundUserIds(row.id),
+        fetchDeptTree()
+      ])
+      const boundIds = boundRes?.userIds || []
+      if (boundIds.length === 0) return
+      const users = await fetchAllUsersForPostBind()
+      const idToName = new Map(users.map((u) => [u.id, u.nickName || u.userNo || u.id]))
+      viewBoundUserNames.value = boundIds.map((id: string) => idToName.get(id) || id)
+    } catch (e) {
+      console.error('加载关联用户失败:', e)
+    }
+  }
+
+  // ---- 关联用户弹窗（布局对齐角色管理「数据权限」自定义范围）----
+  const postBindDialogVisible = ref(false)
+  const postBindLoading = ref(false)
+  const postBindSubmitLoading = ref(false)
+  const postBindPostId = ref('')
+  const postBindPostName = ref('')
+  const postBindDeptTreeRef = ref()
+  const postBindDeptTreeData = ref<Api.Dept.DeptItem[]>([])
+  const postBindAllUsers = ref<
+    Array<{ id: string; nickName: string; userNo: string; deptId: string; deptName?: string }>
+  >([])
+  const postBindUserCheckedKeys = ref<string[]>([])
+  const postBindUserFilterDeptId = ref<string | null>(null)
+  const postBindUserKeyword = ref('')
+
+  function findPostBindDeptNodeById(nodes: Api.Dept.DeptItem[], id: string): Api.Dept.DeptItem | null {
+    for (const n of nodes) {
+      if (n.id === id) return n
+      if (n.children?.length) {
+        const found = findPostBindDeptNodeById(n.children, id)
+        if (found) return found
+      }
+    }
+    return null
+  }
+
+  function collectPostBindDeptSubtreeIds(node: Api.Dept.DeptItem): string[] {
+    const ids = [node.id]
+    for (const c of node.children || []) ids.push(...collectPostBindDeptSubtreeIds(c))
+    return ids
+  }
+
+  function collectAllPostBindDeptIds(nodes: Api.Dept.DeptItem[]): string[] {
+    const ids: string[] = []
+    const walk = (list: Api.Dept.DeptItem[]) => {
+      for (const n of list) {
+        ids.push(n.id)
+        if (n.children?.length) walk(n.children)
+      }
+    }
+    walk(nodes)
+    return ids
+  }
+
+  async function expandPostBindDeptTree() {
+    await nextTick()
+    const tree = postBindDeptTreeRef.value
+    const keys = collectAllPostBindDeptIds(postBindDeptTreeData.value)
+    if (tree && keys.length && typeof tree.setExpandedKeys === 'function') {
+      tree.setExpandedKeys(keys)
+    }
+  }
+
+  const postBindDeptFilterIdSet = computed(() => {
+    const id = postBindUserFilterDeptId.value
+    if (!id) return null
+    const node = findPostBindDeptNodeById(postBindDeptTreeData.value, id)
+    if (!node) return new Set<string>([id])
+    return new Set(collectPostBindDeptSubtreeIds(node))
+  })
+
+  const postBindFilteredUsers = computed(() => {
+    const kw = postBindUserKeyword.value.trim().toLowerCase()
+    const deptSet = postBindDeptFilterIdSet.value
+    return postBindAllUsers.value.filter((u) => {
+      if (deptSet && !deptSet.has(u.deptId)) return false
+      if (!kw) return true
+      const name = (u.nickName || '').toLowerCase()
+      const no = (u.userNo || '').toLowerCase()
+      return name.includes(kw) || no.includes(kw)
+    })
+  })
+
+  const postBindUserEmptyDesc = computed(() => {
+    if (postBindAllUsers.value.length === 0) return '暂无用户数据'
+    const hasDept = Boolean(postBindUserFilterDeptId.value)
+    const kw = postBindUserKeyword.value.trim()
+    if (hasDept && kw) return '该部门下无匹配用户'
+    if (hasDept) return '该部门下暂无用户'
+    if (kw) return '无匹配用户'
+    return '无匹配用户'
+  })
+
+  const postBindSelectedUserSummaries = computed(() =>
+    postBindUserCheckedKeys.value.map((id) => {
+      const u = postBindAllUsers.value.find((x) => x.id === id)
+      return { id, label: u ? postBindUserOptionLabel(u) : id }
+    })
+  )
+
+  function postBindUserOptionLabel(u: {
+    id: string
+    nickName: string
+    userNo: string
+    deptName?: string
+  }) {
+    const base = u.nickName || u.userNo || u.id
+    if (u.deptName) return `${base}（${u.deptName}）`
+    return base
+  }
+
+  function handlePostBindDeptNodeClick(data: Api.Dept.DeptItem) {
+    postBindUserFilterDeptId.value = data.id
+    postBindDeptTreeRef.value?.setCurrentKey?.(data.id)
+  }
+
+  function clearPostBindUserDeptFilter() {
+    postBindUserFilterDeptId.value = null
+    postBindDeptTreeRef.value?.setCurrentKey?.(null)
+  }
+
+  async function fetchAllUsersForPostBind(): Promise<
+    Array<{ id: string; nickName: string; userNo: string; deptId: string; deptName?: string }>
+  > {
+    const pageSize = MAX_ADMIN_LIST_PAGE_SIZE
+    const raw: any[] = []
+    let page = 1
+    for (;;) {
+      const res = await fetchUserList({ page, pageSize })
+      const list = res?.list || []
+      raw.push(...list)
+      if (list.length < pageSize) break
+      if (typeof res?.total === 'number' && raw.length >= res.total) break
+      page += 1
+    }
+    return raw.map((u: any) => ({
+      id: u.id,
+      deptId: u.deptId || '',
+      nickName: u.nickName || u.realName || '',
+      userNo: u.userNo || '',
+      deptName: u.deptName
+    }))
+  }
+
+  async function handlePostBindUsers(row: Api.Post.PostItem) {
+    postBindPostId.value = row.id
+    postBindPostName.value = row.postName || row.postCode || ''
+    postBindUserCheckedKeys.value = []
+    postBindUserFilterDeptId.value = null
+    postBindUserKeyword.value = ''
+    postBindDialogVisible.value = true
+    postBindLoading.value = true
+    try {
+      const [boundRes, deptTree, users] = await Promise.all([
+        fetchPostBoundUserIds(row.id),
+        fetchDeptTree(),
+        fetchAllUsersForPostBind()
+      ])
+      postBindUserCheckedKeys.value = [...(boundRes?.userIds || [])]
+      postBindDeptTreeData.value = deptTree || []
+      postBindAllUsers.value = users
+      await expandPostBindDeptTree()
+    } finally {
+      postBindLoading.value = false
+    }
+  }
+
+  async function handlePostBindSubmit() {
+    postBindSubmitLoading.value = true
+    try {
+      await fetchUpdatePostBoundUsers(postBindPostId.value, [...postBindUserCheckedKeys.value])
+      postBindDialogVisible.value = false
+    } finally {
+      postBindSubmitLoading.value = false
+    }
+  }
+
   const loadDictOptions = async () => {
     try {
       const bmzt = await fetchDictDataOptions('bmzt')
@@ -311,11 +638,14 @@
     const ids = selectedRows.value.map((r) => r.id)
     if (!ids.length) return
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个职位吗？`, '提示', { type: 'warning' })
-    for (const id of ids) {
-      await fetchDeletePost(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeletePost(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   onMounted(() => {
@@ -329,13 +659,142 @@
     :deep(.el-form-item) {
       margin-bottom: 0;
     }
+  }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
+  .post-bind-dialog-body {
+    min-height: 200px;
+  }
+
+  .post-bind-subtitle {
+    margin: 0 0 12px;
+    font-size: 13px;
+    line-height: 1.5;
+    color: var(--el-text-color-regular);
+  }
+
+  .data-scope-form {
+    :deep(.el-form-item) {
+      margin-bottom: 0;
     }
   }
+
+  .data-scope-custom-form-item {
+    margin-top: 0;
+
+    :deep(.el-form-item__content) {
+      display: block;
+    }
+  }
+
+  .data-scope-custom-grid {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 16px;
+    width: 100%;
+  }
+
+  .data-scope-custom-col {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    min-width: 0;
+  }
+
+  .data-scope-col-title {
+    padding-left: 10px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--el-text-color-regular);
+    border-left: 3px solid #10b981;
+  }
+
+  .data-scope-col-tip {
+    margin-top: 4px;
+    font-size: 11px;
+    line-height: 1.45;
+    color: var(--mint-text-muted, var(--el-text-color-secondary));
+  }
+
+  .data-scope-col-head-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: 8px;
+  }
+
+  .data-scope-tree-wrap {
+    max-height: 280px;
+    padding: 8px;
+    overflow: auto;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+  }
+
+  .data-scope-user-filter {
+    width: 100%;
+  }
+
+  .data-scope-user-list-wrap {
+    max-height: 236px;
+    padding: 8px;
+    overflow: auto;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+  }
+
+  .data-scope-user-row {
+    padding: 4px 0;
+  }
+
+  .data-scope-selection-summary {
+    margin-top: 12px;
+    padding: 10px 12px;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+    background: var(--el-fill-color-blank);
+  }
+
+  .data-scope-summary-block + .data-scope-summary-block {
+    margin-top: 10px;
+    padding-top: 10px;
+    border-top: 1px solid var(--el-border-color-lighter);
+  }
+
+  .data-scope-summary-heading {
+    margin-bottom: 6px;
+    padding-left: 10px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--el-text-color-regular);
+    border-left: 3px solid #10b981;
+  }
+
+  .data-scope-summary-list {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: 8px 12px;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    font-size: 12px;
+    line-height: 1.45;
+    color: var(--el-text-color-primary);
+  }
+
+  .data-scope-summary-list li {
+    min-width: 0;
+    padding: 6px 8px;
+    overflow-wrap: anywhere;
+    word-break: break-word;
+    border-radius: 6px;
+    background: var(--el-fill-color-light);
+  }
+
+  .data-scope-summary-empty {
+    margin: 0;
+    font-size: 12px;
+    line-height: 1.5;
+    color: var(--mint-text-muted, var(--el-text-color-secondary));
+  }
 </style>
diff --git a/web-admin/src/views/system/product/index.vue b/web-admin/src/views/system/product/index.vue
index 8a73c61f..5f7db1b8 100644
--- a/web-admin/src/views/system/product/index.vue
+++ b/web-admin/src/views/system/product/index.vue
@@ -120,7 +120,7 @@
         </template>
       </el-table-column>
       <el-table-column prop="skuCode" label="SKU编码" min-width="140" align="center" header-align="center" />
-      <el-table-column prop="categoryName" label="分类" min-width="120" align="center" header-align="center">
+      <el-table-column prop="categoryName" label="分类" min-width="180" align="center" header-align="center" show-overflow-tooltip>
         <template #default="{ row }">
           {{ categoryPathForProductRow(row) }}
         </template>
@@ -131,14 +131,14 @@
         </template>
       </el-table-column>
       <el-table-column prop="unitName" label="单位" min-width="80" align="center" header-align="center" />
-      <el-table-column prop="isActive" label="状态" min-width="70" align="center" header-align="center">
+      <el-table-column prop="isActive" label="状态" min-width="90" align="center" header-align="center">
         <template #default="{ row }">
           <el-tag :type="row.isActive ? 'success' : 'info'" size="small">
             {{ row.isActive ? '启用' : '禁用' }}
           </el-tag>
         </template>
       </el-table-column>
-      <el-table-column prop="createAt" label="创建时间" min-width="160" align="center" header-align="center" />
+      <el-table-column prop="createAt" label="创建时间" min-width="180" align="center" header-align="center" />
       <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
         <template #default="{ row }">
           <el-button class="btn-op-item primary" @click="handleView(row)">查看</el-button>
@@ -231,11 +231,11 @@
               <el-col :span="12">
                 <el-form-item label="计量/单位">
                   <div class="measure-unit-inline">
-                    <el-input-number
+                    <el-input
+                      type="number"
+                      step="any"
                       v-model="formData.measureValue"
                       :min="0"
-                      :precision="3"
-                      :step="1"
                       controls-position="right"
                       placeholder="如 500、1"
                       class="measure-number"
@@ -323,10 +323,10 @@
               </el-col>
               <el-col :span="12">
                 <el-form-item label="调价系数(%)" prop="priceCoefficient">
-                  <el-input-number
+                  <el-input
+                    type="number"
+                    step="any"
                     v-model="formData.priceCoefficient"
-                    :precision="2"
-                    :step="0.1"
                     controls-position="right"
                     style="width: 100%"
                     @change="handlePriceCoefficientChange"
@@ -2518,7 +2518,9 @@
   color: var(--mint-text);
   margin-bottom: 12px;
   padding-bottom: 10px;
+  padding-left: 10px;
   border-bottom: 1px solid var(--mint-border);
+  border-left: 3px solid #10b981;
 
   .section-tip {
     font-size: 12px;
@@ -2539,14 +2541,7 @@
     margin-bottom: 12px;
   }
 
-  :deep(.el-form-item__label) {
-    height: auto !important;
-    line-height: 1.25 !important;
-    padding: 0 0 6px !important;
-    font-size: 11px;
-    color: var(--mint-text-muted);
-    font-weight: 600;
-  }
+
 }
 
 .region-prices-empty {
@@ -2913,7 +2908,9 @@
   color: #303133;
   margin-bottom: 12px;
   padding-bottom: 8px;
+  padding-left: 10px;
   border-bottom: 1px solid #ebeef5;
+  border-left: 3px solid #10b981;
 }
 
 .view-banner-list {
diff --git a/web-admin/src/views/system/role/index.vue b/web-admin/src/views/system/role/index.vue
index e71a1ce3..9df7e04b 100644
--- a/web-admin/src/views/system/role/index.vue
+++ b/web-admin/src/views/system/role/index.vue
@@ -57,6 +57,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
@@ -67,25 +68,59 @@
             header-align="center"
             :index="(index: number) => (pagination.page - 1) * pagination.pageSize + index + 1"
           />
-          <el-table-column prop="roleName" label="角色名称" min-width="140" align="center" header-align="center" />
-          <el-table-column prop="dataScope" label="数据权限" min-width="120" align="center" header-align="center">
+          <el-table-column
+            prop="roleName"
+            label="角色名称"
+            min-width="140"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="dataScope"
+            label="数据权限"
+            min-width="120"
+            align="center"
+            header-align="center"
+          >
             <template #default="{ row }">
               {{ dataScopeLabel(row.dataScope) }}
             </template>
           </el-table-column>
-          <el-table-column prop="status" label="状态" width="100" align="center" header-align="center">
+          <el-table-column
+            prop="status"
+            label="状态"
+            width="100"
+            align="center"
+            header-align="center"
+          >
             <template #default="{ row }">
               <el-tag :type="row.status === '1' ? 'success' : 'danger'" size="small">
                 {{ row.status === '1' ? '正常' : '停用' }}
               </el-tag>
             </template>
           </el-table-column>
-          <el-table-column prop="orderNum" label="排序" width="80" align="center" header-align="center" />
-          <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-          <el-table-column label="操作" width="400" fixed="right" align="center" header-align="center">
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            label="操作"
+            width="480"
+            fixed="right"
+            align="center"
+            header-align="center"
+          >
             <template #default="{ row }">
-              <el-button class="btn-op-item primary" @click="handleMenuConfig(row)">菜单配置</el-button>
-              <el-button class="btn-op-item primary" @click="handleDataScope(row)">数据权限</el-button>
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
+              <el-button class="btn-op-item primary" @click="handleMenuConfig(row)"
+                >菜单配置</el-button
+              >
+              <el-button class="btn-op-item primary" @click="handleDataScope(row)"
+                ><el-icon><DataAnalysis /></el-icon>数据权限</el-button
+              >
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
             </template>
@@ -98,7 +133,9 @@
             :total="pagination.total"
             :page-sizes="[10, 20, 50]"
             layout="total, sizes, prev, pager, next"
-            @size-change="(val: number) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @size-change="
+              (val: number) => ((pagination.page = 1), (pagination.pageSize = val), loadData())
+            "
             @current-change="(val: number) => ((pagination.page = val), loadData())"
           />
         </div>
@@ -133,12 +170,6 @@
                 <el-option label="停用" value="0" />
               </el-select>
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number v-model="formData.orderNum" :min="0" :max="9999" controls-position="right" />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
@@ -167,6 +198,7 @@
         :close-on-click-modal="false"
       >
         <div v-loading="menuDialogLoading" style="min-height: 200px">
+          <!-- 父子关联勾选：选父级全选子级，选子级自动带上父级（与 check-strictly 互斥，故不加） -->
           <el-tree
             ref="menuTreeRef"
             :data="menuTreeData"
@@ -174,7 +206,6 @@
             node-key="id"
             :props="{ label: 'menuName', children: 'children' }"
             :default-checked-keys="menuCheckedKeys"
-            check-strictly
             style="max-height: 500px; overflow-y: auto"
           />
         </div>
@@ -183,7 +214,12 @@
             <el-icon><Close /></el-icon>
             取消
           </el-button>
-          <el-button class="btn-main" type="primary" @click="handleMenuSubmit" :loading="menuSubmitLoading">
+          <el-button
+            class="btn-main"
+            type="primary"
+            @click="handleMenuSubmit"
+            :loading="menuSubmitLoading"
+          >
             <el-icon><Check /></el-icon>
             确定
           </el-button>
@@ -194,7 +230,7 @@
       <el-dialog
         v-model="dataScopeDialogVisible"
         title="数据权限配置"
-        width="700px"
+        width="1120px"
         class="dialog-form-layout"
         align-center
         destroy-on-close
@@ -212,26 +248,91 @@
           </el-form-item>
 
           <template v-if="dataScopeForm.dataScope === '5'">
-            <el-form-item label="选择部门">
-              <el-tree
-                ref="deptTreeRef"
-                :data="deptTreeData"
-                show-checkbox
-                node-key="id"
-                :props="{ label: 'deptName', children: 'children' }"
-                :default-checked-keys="scopeDeptCheckedKeys"
-                check-strictly
-                style="max-height: 260px; overflow-y: auto; border: 1px solid var(--el-border-color-lighter); border-radius: 4px; padding: 8px"
-              />
-            </el-form-item>
-            <el-form-item label="选择用户">
-              <div style="border: 1px solid var(--el-border-color-lighter); border-radius: 4px; padding: 8px; max-height: 260px; overflow-y: auto; width: 100%">
-                <el-checkbox-group v-model="scopeUserCheckedKeys">
-                  <div v-for="u in allUsers" :key="u.id" style="padding: 4px 0">
-                    <el-checkbox :value="u.id">{{ u.nickName || u.userNo }}</el-checkbox>
+            <el-form-item label="自定义范围" class="data-scope-custom-form-item">
+              <div class="data-scope-custom-grid">
+                <div class="data-scope-custom-col">
+                  <div>
+                    <div class="data-scope-col-title">选择部门</div>
+                    <div class="data-scope-col-tip">
+                      仅通过复选框勾选授权范围；点击部门名称可筛选右侧用户
+                    </div>
                   </div>
-                </el-checkbox-group>
-                <el-empty v-if="allUsers.length === 0" description="暂无用户数据" :image-size="40" />
+                  <div class="data-scope-tree-wrap">
+                    <el-tree
+                      ref="deptTreeRef"
+                      :data="deptTreeData"
+                      show-checkbox
+                      highlight-current
+                      node-key="id"
+                      :props="{ label: 'deptName', children: 'children' }"
+                      :default-checked-keys="scopeDeptCheckedKeys"
+                      default-expand-all
+                      :check-on-click-node="false"
+                      :check-on-click-leaf="false"
+                      check-strictly
+                      @check="syncDataScopeDeptCheckedFromTree"
+                      @node-click="handleDataScopeDeptNodeClick"
+                    />
+                  </div>
+                </div>
+                <div class="data-scope-custom-col">
+                  <div class="data-scope-col-head-row">
+                    <span class="data-scope-col-title">选择用户</span>
+                    <el-button
+                      v-if="dataScopeUserFilterDeptId"
+                      class="btn-ghost"
+                      size="small"
+                      @click="clearDataScopeUserDeptFilter"
+                    >
+                      清除部门筛选
+                    </el-button>
+                  </div>
+                  <el-input
+                    v-model="dataScopeUserKeyword"
+                    class="data-scope-user-filter"
+                    clearable
+                    placeholder="按姓名、账号过滤"
+                  />
+                  <div class="data-scope-user-list-wrap">
+                    <el-checkbox-group
+                      v-if="dataScopeFilteredUsers.length > 0"
+                      v-model="scopeUserCheckedKeys"
+                    >
+                      <div
+                        v-for="u in dataScopeFilteredUsers"
+                        :key="u.id"
+                        class="data-scope-user-row"
+                      >
+                        <el-checkbox :value="u.id">{{ userOptionLabel(u) }}</el-checkbox>
+                      </div>
+                    </el-checkbox-group>
+                    <el-empty v-else :description="dataScopeUserEmptyDesc" :image-size="40" />
+                  </div>
+                </div>
+              </div>
+              <div class="data-scope-selection-summary">
+                <template v-if="dataScopeHasCustomSelectionSummary">
+                  <div v-if="dataScopeSelectedDeptRows.length > 0" class="data-scope-summary-block">
+                    <div class="data-scope-summary-heading">已选部门</div>
+                    <ul class="data-scope-summary-list">
+                      <li v-for="row in dataScopeSelectedDeptRows" :key="'d-' + row.id">
+                        {{ row.label }}
+                      </li>
+                    </ul>
+                  </div>
+                  <div
+                    v-if="dataScopeSelectedUserSummaries.length > 0"
+                    class="data-scope-summary-block"
+                  >
+                    <div class="data-scope-summary-heading">已选用户</div>
+                    <ul class="data-scope-summary-list">
+                      <li v-for="row in dataScopeSelectedUserSummaries" :key="'u-' + row.id">
+                        {{ row.label }}
+                      </li>
+                    </ul>
+                  </div>
+                </template>
+                <p v-else class="data-scope-summary-empty">暂未勾选部门或用户</p>
               </div>
             </el-form-item>
           </template>
@@ -241,20 +342,37 @@
             <el-icon><Close /></el-icon>
             取消
           </el-button>
-          <el-button class="btn-main" type="primary" @click="handleDataScopeSubmit" :loading="dataScopeSubmitLoading">
+          <el-button
+            class="btn-main"
+            type="primary"
+            @click="handleDataScopeSubmit"
+            :loading="dataScopeSubmitLoading"
+          >
             <el-icon><Check /></el-icon>
             确定
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.roleName || '角色详情'"
+        :icon="Stamp"
+        :meta="`数据权限：${dataScopeLabel(viewRow?.dataScope || '')}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, computed, onMounted, nextTick, watch } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, DataAnalysis, View, Stamp } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { MAX_ADMIN_LIST_PAGE_SIZE } from '@/utils/fetch-paged-list'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import { buildPathLabelMapFromTreeRoots } from '@/utils/tree-path'
   import {
     fetchRoleList,
     fetchCreateRole,
@@ -323,13 +441,137 @@
   const dataScopeEditingRoleId = ref<string>('')
   const deptTreeRef = ref()
   const deptTreeData = ref<Api.Dept.DeptItem[]>([])
-  const allUsers = ref<Array<{ id: string; nickName: string; userNo: string }>>([])
+  const allUsers = ref<
+    Array<{ id: string; nickName: string; userNo: string; deptId: string; deptName?: string }>
+  >([])
   const scopeDeptCheckedKeys = ref<string[]>([])
   const scopeUserCheckedKeys = ref<string[]>([])
+  /** 左侧部门树当前行（用于筛选右侧用户，不含子部门勾选逻辑） */
+  const dataScopeUserFilterDeptId = ref<string | null>(null)
+  const dataScopeUserKeyword = ref('')
   const dataScopeForm = reactive({
     dataScope: '1'
   })
 
+  function findDeptNodeById(nodes: Api.Dept.DeptItem[], id: string): Api.Dept.DeptItem | null {
+    for (const n of nodes) {
+      if (n.id === id) return n
+      if (n.children?.length) {
+        const found = findDeptNodeById(n.children, id)
+        if (found) return found
+      }
+    }
+    return null
+  }
+
+  function collectDeptSubtreeIds(node: Api.Dept.DeptItem): string[] {
+    const ids = [node.id]
+    for (const c of node.children || []) ids.push(...collectDeptSubtreeIds(c))
+    return ids
+  }
+
+  /** 收集部门树全部节点 id（异步灌入数据后仍保持整树展开） */
+  function collectAllDeptIds(nodes: Api.Dept.DeptItem[]): string[] {
+    const ids: string[] = []
+    const walk = (list: Api.Dept.DeptItem[]) => {
+      for (const n of list) {
+        ids.push(n.id)
+        if (n.children?.length) walk(n.children)
+      }
+    }
+    walk(nodes)
+    return ids
+  }
+
+  async function expandDataScopeDeptTree() {
+    await nextTick()
+    const tree = deptTreeRef.value
+    const keys = collectAllDeptIds(deptTreeData.value)
+    if (tree && keys.length && typeof tree.setExpandedKeys === 'function') {
+      tree.setExpandedKeys(keys)
+    }
+  }
+
+  const dataScopeDeptFilterIdSet = computed(() => {
+    const id = dataScopeUserFilterDeptId.value
+    if (!id) return null
+    const node = findDeptNodeById(deptTreeData.value, id)
+    if (!node) return new Set<string>([id])
+    return new Set(collectDeptSubtreeIds(node))
+  })
+
+  const dataScopeFilteredUsers = computed(() => {
+    const kw = dataScopeUserKeyword.value.trim().toLowerCase()
+    const deptSet = dataScopeDeptFilterIdSet.value
+    return allUsers.value.filter((u) => {
+      if (deptSet && !deptSet.has(u.deptId)) return false
+      if (!kw) return true
+      const name = (u.nickName || '').toLowerCase()
+      const no = (u.userNo || '').toLowerCase()
+      return name.includes(kw) || no.includes(kw)
+    })
+  })
+
+  const dataScopeUserEmptyDesc = computed(() => {
+    if (allUsers.value.length === 0) return '暂无用户数据'
+    const hasDept = Boolean(dataScopeUserFilterDeptId.value)
+    const kw = dataScopeUserKeyword.value.trim()
+    if (hasDept && kw) return '该部门下无匹配用户'
+    if (hasDept) return '该部门下暂无用户'
+    if (kw) return '无匹配用户'
+    return '无匹配用户'
+  })
+
+  /** 与 el-tree 勾选状态同步，供已选摘要与提交一致 */
+  function syncDataScopeDeptCheckedFromTree() {
+    const keys = deptTreeRef.value?.getCheckedKeys?.() as string[] | undefined
+    scopeDeptCheckedKeys.value = Array.isArray(keys) ? [...keys] : []
+  }
+
+  const dataScopeDeptPathLabelMap = computed(() =>
+    buildPathLabelMapFromTreeRoots(deptTreeData.value, {
+      idKey: 'id',
+      nameKey: 'deptName',
+      childrenKey: 'children'
+    })
+  )
+
+  const dataScopeSelectedDeptRows = computed(() => {
+    const map = dataScopeDeptPathLabelMap.value
+    return scopeDeptCheckedKeys.value.map((id) => ({
+      id,
+      label: map.get(id) || findDeptNodeById(deptTreeData.value, id)?.deptName || id
+    }))
+  })
+
+  const dataScopeSelectedUserSummaries = computed(() =>
+    scopeUserCheckedKeys.value.map((id) => {
+      const u = allUsers.value.find((x) => x.id === id)
+      return { id, label: u ? userOptionLabel(u) : id }
+    })
+  )
+
+  const dataScopeHasCustomSelectionSummary = computed(
+    () =>
+      dataScopeSelectedDeptRows.value.length > 0 || dataScopeSelectedUserSummaries.value.length > 0
+  )
+
+  function userOptionLabel(u: { id: string; nickName: string; userNo: string; deptName?: string }) {
+    const base = u.nickName || u.userNo || u.id
+    if (u.deptName) return `${base}（${u.deptName}）`
+    return base
+  }
+
+  function handleDataScopeDeptNodeClick(data: Api.Dept.DeptItem) {
+    dataScopeUserFilterDeptId.value = data.id
+    deptTreeRef.value?.setCurrentKey?.(data.id)
+  }
+
+  function clearDataScopeUserDeptFilter() {
+    dataScopeUserFilterDeptId.value = null
+    deptTreeRef.value?.setCurrentKey?.(null)
+  }
+
   const handleSelectionChange = (rows: Api.Role.RoleItem[]) => {
     selectedRows.value = rows
   }
@@ -424,12 +666,17 @@
       ElMessage.warning('请至少选择一项')
       return
     }
-    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个角色吗？`, '提示', { type: 'warning' })
-    for (const id of ids) {
-      await fetchDeleteRole(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个角色吗？`, '提示', {
+      type: 'warning'
+    })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteRole(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   // ---- 菜单配置 ----
@@ -446,29 +693,61 @@
     }
   }
 
+  /**
+   * 提交角色菜单：只持久化叶子菜单 ID（去重），避免树控件偶发重复 key。
+   * 父子关联下「半选」父节点在 getHalfCheckedKeys；若与 getCheckedKeys 一起入库，重开弹窗会把父节点当全选，误勾整棵子树。
+   * 侧栏按 menuCode 过滤时会保留有权限子项的父级，无需单独存父菜单行。
+   */
   async function handleMenuSubmit() {
     menuSubmitLoading.value = true
     try {
       const tree = menuTreeRef.value
-      const checkedKeys: string[] = tree?.getCheckedKeys() || []
-      const halfCheckedKeys: string[] = tree?.getHalfCheckedKeys() || []
-      const allKeys = [...checkedKeys, ...halfCheckedKeys]
-      await fetchUpdateRoleMenus(menuEditingRoleId.value, allKeys)
+      const rawKeys: string[] = tree?.getCheckedKeys(true) || []
+      const leafKeys = [...new Set(rawKeys)]
+      await fetchUpdateRoleMenus(menuEditingRoleId.value, leafKeys)
       menuDialogVisible.value = false
     } finally {
       menuSubmitLoading.value = false
     }
   }
 
+  /**
+   * 分页拉取租户用户列表供「数据权限」多选；单页 pageSize 超过 100 时接口会 422。
+   */
+  async function fetchAllUsersForDataScope(): Promise<
+    Array<{ id: string; nickName: string; userNo: string; deptId: string; deptName?: string }>
+  > {
+    const pageSize = MAX_ADMIN_LIST_PAGE_SIZE
+    const raw: any[] = []
+    let page = 1
+    for (;;) {
+      const res = await fetchUserList({ page, pageSize })
+      const list = res?.list || []
+      raw.push(...list)
+      if (list.length < pageSize) break
+      if (typeof res?.total === 'number' && raw.length >= res.total) break
+      page += 1
+    }
+    return raw.map((u: any) => ({
+      id: u.id,
+      deptId: u.deptId || '',
+      nickName: u.nickName || u.realName || '',
+      userNo: u.userNo || '',
+      deptName: u.deptName
+    }))
+  }
+
   // ---- 数据权限配置 ----
   async function handleDataScope(row: Api.Role.RoleItem) {
     dataScopeEditingRoleId.value = row.id
     dataScopeForm.dataScope = row.dataScope || '1'
     scopeDeptCheckedKeys.value = []
     scopeUserCheckedKeys.value = []
+    dataScopeUserFilterDeptId.value = null
+    dataScopeUserKeyword.value = ''
     dataScopeDialogVisible.value = true
 
-    const [, deptTree, userRes] = await Promise.all([
+    const [, deptTree, users] = await Promise.all([
       fetchRoleDataScope(row.id).then((res) => {
         if (res?.scopeDetails) {
           scopeDeptCheckedKeys.value = res.scopeDetails
@@ -481,15 +760,12 @@
         dataScopeForm.dataScope = res?.dataScope || row.dataScope || '1'
       }),
       fetchDeptTree(),
-      fetchUserList({ pageSize: 200 })
+      fetchAllUsersForDataScope()
     ])
 
     deptTreeData.value = deptTree || []
-    allUsers.value = (userRes?.list || []).map((u: any) => ({
-      id: u.id,
-      nickName: u.nickName || u.realName || '',
-      userNo: u.userNo || ''
-    }))
+    allUsers.value = users
+    await expandDataScopeDeptTree()
   }
 
   async function handleDataScopeSubmit() {
@@ -516,6 +792,40 @@
     }
   }
 
+  watch(
+    () => dataScopeForm.dataScope,
+    async (v) => {
+      if (v !== '5' || !dataScopeDialogVisible.value) return
+      await expandDataScopeDeptTree()
+    }
+  )
+
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Role.RoleItem | null>(null)
+
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '角色名称', value: row.roleName },
+          { label: '数据权限', value: dataScopeLabel(row.dataScope) },
+          { label: '状态', value: row.status === '1' ? '正常' : '停用' },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
+  function handleView(row: Api.Role.RoleItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   onMounted(() => {
     loadData()
   })
@@ -527,13 +837,125 @@
     :deep(.el-form-item) {
       margin-bottom: 0;
     }
+  }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
+  .data-scope-custom-form-item {
+    margin-top: 12px;
+
+    :deep(.el-form-item__content) {
+      display: block;
     }
   }
+
+  .data-scope-custom-grid {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 16px;
+    width: 100%;
+  }
+
+  .data-scope-custom-col {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    min-width: 0;
+  }
+
+  .data-scope-col-title {
+    padding-left: 10px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--el-text-color-regular);
+    border-left: 3px solid #10b981;
+  }
+
+  .data-scope-col-tip {
+    margin-top: 4px;
+    font-size: 11px;
+    line-height: 1.45;
+    color: var(--mint-text-muted, var(--el-text-color-secondary));
+  }
+
+  .data-scope-col-head-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: 8px;
+  }
+
+  .data-scope-tree-wrap {
+    max-height: 280px;
+    padding: 8px;
+    overflow: auto;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+  }
+
+  .data-scope-user-filter {
+    width: 100%;
+  }
+
+  .data-scope-user-list-wrap {
+    max-height: 236px;
+    padding: 8px;
+    overflow: auto;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+  }
+
+  .data-scope-user-row {
+    padding: 4px 0;
+  }
+
+  .data-scope-selection-summary {
+    margin-top: 12px;
+    padding: 10px 12px;
+    border: 1px solid var(--el-border-color-lighter);
+    border-radius: 8px;
+    background: var(--el-fill-color-blank);
+  }
+
+  .data-scope-summary-block + .data-scope-summary-block {
+    margin-top: 10px;
+    padding-top: 10px;
+    border-top: 1px solid var(--el-border-color-lighter);
+  }
+
+  .data-scope-summary-heading {
+    margin-bottom: 6px;
+    padding-left: 10px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--el-text-color-regular);
+    border-left: 3px solid #10b981;
+  }
+
+  .data-scope-summary-list {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: 8px 12px;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    font-size: 12px;
+    line-height: 1.45;
+    color: var(--el-text-color-primary);
+  }
+
+  .data-scope-summary-list li {
+    min-width: 0;
+    padding: 6px 8px;
+    overflow-wrap: anywhere;
+    word-break: break-word;
+    border-radius: 6px;
+    background: var(--el-fill-color-light);
+  }
+
+  .data-scope-summary-empty {
+    margin: 0;
+    font-size: 12px;
+    line-height: 1.5;
+    color: var(--mint-text-muted, var(--el-text-color-secondary));
+  }
 </style>
diff --git a/web-admin/src/views/system/site/index.vue b/web-admin/src/views/system/site/index.vue
index 26d7992d..4f6e3d0d 100644
--- a/web-admin/src/views/system/site/index.vue
+++ b/web-admin/src/views/system/site/index.vue
@@ -57,6 +57,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
@@ -83,11 +84,11 @@
           </el-table-column>
           <el-table-column prop="address" label="地址" min-width="160" align="center" header-align="center" show-overflow-tooltip />
           <el-table-column prop="contactName" label="联系人" min-width="100" align="center" header-align="center" />
-          <el-table-column prop="contactPhone" label="联系电话" min-width="120" align="center" header-align="center" />
-          <el-table-column prop="orderNum" label="排序" width="80" align="center" header-align="center" />
-          <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+          <el-table-column prop="contactPhone" label="联系电话" min-width="140" align="center" header-align="center" />
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
             </template>
@@ -114,6 +115,7 @@
         align-center
         destroy-on-close
         :close-on-click-modal="false"
+        @close="handleDialogClose"
       >
         <el-form
           ref="formRef"
@@ -155,10 +157,31 @@
               <el-input v-model="formData.address" placeholder="请输入地址" />
             </el-form-item>
             <el-form-item label="联系人">
-              <el-input v-model="formData.contactName" placeholder="可选" />
+              <el-select
+                v-model="contactUserId"
+                class="w-full"
+                filterable
+                remote
+                clearable
+                reserve-keyword
+                :remote-method="remoteSearchContactUsers"
+                :loading="contactUserLoading"
+                placeholder="输入关键词检索用户"
+                @change="onContactUserChange"
+              >
+                <el-option
+                  v-for="u in contactUserOptions"
+                  :key="u.id"
+                  :label="formatContactUserLabel(u)"
+                  :value="u.id"
+                />
+              </el-select>
             </el-form-item>
             <el-form-item label="联系电话">
-              <el-input v-model="formData.contactPhone" placeholder="可选" />
+              <el-input
+                v-model="formData.contactPhone"
+                placeholder="可选，选择联系人后自动填入，可修改"
+              />
             </el-form-item>
             <el-form-item label="经营范围" style="grid-column: 1 / -1">
               <el-select
@@ -175,17 +198,6 @@
                 />
               </el-select>
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
@@ -202,24 +214,81 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.siteName || '站点详情'"
+        :icon="Location"
+        :meta="`站点编码：${viewRow?.siteCode || ''}${viewRow?.createTime ? ' · ' + viewRow.createTime : ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, computed, onMounted, nextTick } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, Location } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
   import {
     fetchSiteList,
     fetchCreateSite,
     fetchUpdateSite,
     fetchDeleteSite,
-    fetchDictDataOptions
+    fetchDictDataOptions,
+    fetchUserList
   } from '@/api/admin'
 
   defineOptions({ name: 'SystemSite' })
 
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Site.SiteItem | null>(null)
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '站点名称', value: row.siteName },
+          { label: '站点编码', value: row.siteCode },
+          { label: '站点类型', value: getSiteTypeLabel(row.siteType) },
+          { label: '状态', value: row.status === '1' ? '正常' : '停用' },
+          { label: '地址', value: row.address, span: true }
+        ]
+      },
+      {
+        title: '联系信息',
+        fields: [
+          { label: '联系人', value: row.contactName },
+          { label: '联系电话', value: row.contactPhone },
+          {
+            label: '经营范围',
+            value: row.businessScope
+              ? row.businessScope
+                  .split(',')
+                  .map((code) => {
+                    const opt = businessScopeOptions.value.find((o) => o.value === code)
+                    return opt ? opt.label : code
+                  })
+                  .join('、')
+              : '无',
+            span: true,
+          },
+          { label: '备注', value: row.remark, span: true },
+          { label: '创建时间', value: row.createTime }
+        ]
+      }
+    ]
+  })
+  function handleView(row: Api.Site.SiteItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   const searchForm = reactive<{ keyword: string }>({ keyword: '' })
   const tableData = ref<Api.Site.SiteItem[]>([])
   const selectedRows = ref<Api.Site.SiteItem[]>([])
@@ -254,6 +323,107 @@
   const statusOptions = ref<Api.Dict.DictDataOption[]>([])
   const businessScopeOptions = ref<Api.Dict.DictDataOption[]>([])
 
+  /** 联系人：关联 sys_user，提交仍写 contactName / contactPhone 字符串 */
+  const contactUserId = ref<string | null>(null)
+  const contactUserOptions = ref<Api.User.UserItem[]>([])
+  const contactSelectedSnapshot = ref<Api.User.UserItem | null>(null)
+  const contactUserLoading = ref(false)
+
+  function formatContactUserLabel(u: Api.User.UserItem) {
+    const name = (u.nickName || '').trim() || '-'
+    const no = (u.userNo || '').trim()
+    const phone = (u.phoneNo || '').trim()
+    const parts = [name]
+    if (no) parts.push(no)
+    if (phone) parts.push(phone)
+    return parts.join(' · ')
+  }
+
+  async function remoteSearchContactUsers(query: string) {
+    contactUserLoading.value = true
+    try {
+      const q = (query || '').trim()
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: q || undefined,
+        status: '1'
+      })
+      let list = [...(res.list || [])]
+      const curId = contactUserId.value
+      if (
+        curId &&
+        contactSelectedSnapshot.value?.id === curId &&
+        !list.some((x) => x.id === curId)
+      ) {
+        list = [contactSelectedSnapshot.value, ...list]
+      }
+      contactUserOptions.value = list
+    } catch (e) {
+      console.error('检索用户失败:', e)
+      contactUserOptions.value = []
+    } finally {
+      contactUserLoading.value = false
+    }
+  }
+
+  function onContactUserChange(val: string | null | undefined) {
+    if (!val) {
+      contactUserId.value = null
+      contactSelectedSnapshot.value = null
+      contactUserOptions.value = []
+      formData.contactName = ''
+      formData.contactPhone = ''
+      return
+    }
+    const u =
+      contactUserOptions.value.find((x) => x.id === val) ||
+      (contactSelectedSnapshot.value?.id === val ? contactSelectedSnapshot.value : undefined)
+    if (!u) return
+    contactSelectedSnapshot.value = { ...u }
+    formData.contactName = (u.nickName || '').trim()
+    formData.contactPhone = (u.phoneNo || '').trim()
+  }
+
+  async function resolveContactUserForEdit() {
+    contactUserId.value = null
+    contactSelectedSnapshot.value = null
+    contactUserOptions.value = []
+    const name = (formData.contactName || '').trim()
+    const phone = (formData.contactPhone || '').trim()
+    if (!name && !phone) return
+    contactUserLoading.value = true
+    try {
+      const res = await fetchUserList({
+        page: 1,
+        pageSize: 50,
+        keyword: name || phone || undefined,
+        status: '1'
+      })
+      const list = res.list || []
+      const match =
+        list.find(
+          (u) =>
+            (u.nickName || '').trim() === name && (!phone || (u.phoneNo || '').trim() === phone)
+        ) ||
+        (name ? list.find((u) => (u.nickName || '').trim() === name) : undefined) ||
+        (name ? list.find((u) => (u.userNo || '').trim() === name) : undefined)
+      if (match) {
+        contactUserOptions.value = list
+        contactUserId.value = match.id
+        contactSelectedSnapshot.value = { ...match }
+        formData.contactName = (match.nickName || '').trim()
+        if ((match.phoneNo || '').trim()) {
+          formData.contactPhone = (match.phoneNo || '').trim()
+        }
+      }
+    } catch (e) {
+      console.error('匹配联系人用户失败:', e)
+    } finally {
+      contactUserLoading.value = false
+    }
+  }
+
   const loadDictOptions = async () => {
     try {
       const [zdlx, bmzt, zdywfw] = await Promise.all([
@@ -317,6 +487,14 @@
     formData.orderNum = 0
     formData.remark = ''
     editingId.value = null
+    contactUserId.value = null
+    contactUserOptions.value = []
+    contactSelectedSnapshot.value = null
+  }
+
+  function handleDialogClose() {
+    resetForm()
+    formRef.value?.clearValidate()
   }
 
   function handleAdd() {
@@ -343,6 +521,9 @@
     formData.remark = row.remark || ''
     dialogVisible.value = true
     formRef.value?.clearValidate?.()
+    nextTick(() => {
+      resolveContactUserForEdit()
+    })
   }
 
   async function handleSubmit() {
@@ -387,11 +568,14 @@
     const ids = selectedRows.value.map((r) => r.id)
     if (!ids.length) return
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个站点吗？`, '提示', { type: 'warning' })
-    for (const id of ids) {
-      await fetchDeleteSite(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteSite(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   onMounted(() => {
@@ -406,12 +590,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/tenant/index.vue b/web-admin/src/views/system/tenant/index.vue
index abfec81d..4ce6f651 100644
--- a/web-admin/src/views/system/tenant/index.vue
+++ b/web-admin/src/views/system/tenant/index.vue
@@ -61,6 +61,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column
             type="selection"
@@ -113,32 +114,28 @@
           <el-table-column
             prop="contactPhone"
             label="联系电话"
-            min-width="120"
-            align="center"
-            header-align="center"
-          />
-          <el-table-column
-            prop="orderNum"
-            label="排序"
-            width="80"
+            min-width="140"
             align="center"
             header-align="center"
           />
           <el-table-column
             prop="createTime"
             label="创建时间"
-            min-width="160"
+            min-width="180"
             align="center"
             header-align="center"
           />
           <el-table-column
             label="操作"
-            width="260"
+            width="320"
             fixed="right"
             align="center"
             header-align="center"
           >
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button
                 class="btn-op-item"
@@ -198,17 +195,6 @@
             <el-form-item label="联系电话">
               <el-input v-model="formData.contactPhone" placeholder="可选" />
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
@@ -225,6 +211,14 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.tenantName || '租户详情'"
+        :icon="OfficeBuilding"
+        :meta="viewRow?.createTime || ''"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
@@ -232,7 +226,9 @@
 <script setup lang="ts">
   import { ref, reactive, onMounted, computed } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, OfficeBuilding } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
   import {
     fetchTenantList,
     fetchCreateTenant,
@@ -256,6 +252,8 @@
   const submitLoading = ref(false)
   const formRef = ref()
   const editingId = ref<string | null>(null)
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.Tenant.TenantItem | null>(null)
 
   const formData = reactive({
     tenantNo: '',
@@ -275,6 +273,23 @@
     selectedRows.value.filter((r) => !isDefaultTenantRow(r))
   )
 
+  const viewSections = computed(() => {
+    if (!viewRow.value) return []
+    const row = viewRow.value
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '租户编号', value: row.tenantNo },
+          { label: '租户名称', value: row.tenantName },
+          { label: '联系人', value: row.contactName },
+          { label: '联系电话', value: row.contactPhone },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
   function isDefaultTenantNo(no: string) {
     return (no || '').trim() === DEFAULT_TENANT_NO
   }
@@ -375,6 +390,11 @@
     }
   }
 
+  function handleView(row: Api.Tenant.TenantItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   async function handleDelete(row: Api.Tenant.TenantItem) {
     if (isDefaultTenantRow(row)) {
       ElMessage.warning('默认租户不可删除')
@@ -394,11 +414,14 @@
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个租户吗？`, '提示', {
       type: 'warning'
     })
-    for (const id of ids) {
-      await fetchDeleteTenant(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteTenant(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   onMounted(() => {
@@ -412,12 +435,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/unit/index.vue b/web-admin/src/views/system/unit/index.vue
index ec59e604..f5b415ec 100644
--- a/web-admin/src/views/system/unit/index.vue
+++ b/web-admin/src/views/system/unit/index.vue
@@ -57,6 +57,7 @@
           stripe
           row-key="id"
           @selection-change="handleSelectionChange"
+          @row-dblclick="handleView"
         >
           <el-table-column type="selection" width="55" align="center" header-align="center" />
           <el-table-column
@@ -69,10 +70,12 @@
           />
           <el-table-column prop="unitName" label="单位名称" min-width="150" align="center" header-align="center" />
           <el-table-column prop="unitCode" label="单位编码" min-width="120" align="center" header-align="center" />
-          <el-table-column prop="orderNum" label="排序" width="80" align="center" header-align="center" />
-          <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+          <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+          <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
             <template #default="{ row }">
+              <el-button class="btn-op-item" @click="handleView(row)"
+                ><el-icon><View /></el-icon>查看</el-button
+              >
               <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
               <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
             </template>
@@ -116,17 +119,6 @@
             <el-form-item label="单位编码" prop="unitCode">
               <el-input v-model="formData.unitCode" placeholder="如：jin、kg、ge" />
             </el-form-item>
-            <el-form-item label="排序">
-              <div class="sort-field">
-                <el-input-number
-                  v-model="formData.orderNum"
-                  :min="0"
-                  :max="9999"
-                  controls-position="right"
-                />
-                <span class="form-tip">数值越小越靠前</span>
-              </div>
-            </el-form-item>
             <el-form-item label="备注">
               <el-input v-model="formData.remark" placeholder="可选" />
             </el-form-item>
@@ -143,14 +135,24 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.unitName || '单位详情'"
+        :icon="ScaleToOriginal"
+        :meta="viewRow?.createTime || ''"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted } from 'vue'
+  import { ref, reactive, onMounted, computed } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, ScaleToOriginal } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
   import {
     fetchItemUnitList,
     fetchCreateItemUnit,
@@ -171,6 +173,8 @@
   const submitLoading = ref(false)
   const formRef = ref()
   const editingId = ref<string | null>(null)
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.ItemUnit.ItemUnitItem | null>(null)
 
   const formData = reactive({
     unitName: '',
@@ -188,6 +192,21 @@
     selectedRows.value = rows
   }
 
+  const viewSections = computed(() => {
+    if (!viewRow.value) return []
+    const row = viewRow.value
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '单位名称', value: row.unitName },
+          { label: '单位编码', value: row.unitCode },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
   async function loadData() {
     loading.value = true
     try {
@@ -267,6 +286,11 @@
     }
   }
 
+  function handleView(row: Api.ItemUnit.ItemUnitItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   async function handleDelete(row: Api.ItemUnit.ItemUnitItem) {
     await ElMessageBox.confirm('确定要删除该单位吗？', '提示', { type: 'warning' })
     await fetchDeleteItemUnit(row.id)
@@ -278,11 +302,14 @@
     const ids = selectedRows.value.map((r) => r.id)
     if (!ids.length) return
     await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个单位吗？`, '提示', { type: 'warning' })
-    for (const id of ids) {
-      await fetchDeleteItemUnit(id)
-    }
-    selectedRows.value = []
-    await loadData()
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteItemUnit(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
   }
 
   onMounted(() => {
@@ -296,12 +323,5 @@
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/user/detail.vue b/web-admin/src/views/system/user/detail.vue
index 595a2e9c..1d3fa7c0 100644
--- a/web-admin/src/views/system/user/detail.vue
+++ b/web-admin/src/views/system/user/detail.vue
@@ -211,8 +211,8 @@
         </el-form-item>
       </el-form>
       <template #footer>
-        <el-button @click="editVisible = false">取消</el-button>
-        <el-button type="primary" @click="confirmEdit" :loading="submitLoading">确定</el-button>
+        <el-button @click="editVisible = false"><el-icon><Close /></el-icon>取消</el-button>
+        <el-button type="primary" @click="confirmEdit" :loading="submitLoading"><el-icon><Check /></el-icon>确定</el-button>
       </template>
     </el-dialog>
 
@@ -242,8 +242,8 @@
         </el-form-item>
       </el-form>
       <template #footer>
-        <el-button @click="addressVisible = false">取消</el-button>
-        <el-button type="primary" @click="confirmAddress" :loading="submitLoading">确定</el-button>
+        <el-button @click="addressVisible = false"><el-icon><Close /></el-icon>取消</el-button>
+        <el-button type="primary" @click="confirmAddress" :loading="submitLoading"><el-icon><Check /></el-icon>确定</el-button>
       </template>
     </el-dialog>
   </div>
@@ -254,7 +254,7 @@ import { ref, reactive, computed, onMounted, watch } from 'vue'
 import { useRouter, useRoute } from 'vue-router'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
-import { ArrowLeft } from '@element-plus/icons-vue'
+import { ArrowLeft, Close, Check } from '@element-plus/icons-vue'
 import { fetchUserDetail, fetchUpdateUser, fetchActiveRegions } from '@/api/admin'
 import { resolveUserAvatarUrl } from '@/utils/user-avatar'
 import type { FormInstance, FormRules } from 'element-plus'
@@ -381,7 +381,7 @@ const formatAmount = (amount: number | string) => {
 
 // 返回列表
 const goBack = () => {
-  router.push('/demo/user')
+  router.push('/system/user')
 }
 
 // 加载数据
diff --git a/web-admin/src/views/system/user/index.vue b/web-admin/src/views/system/user/index.vue
index 324ccf90..43949d50 100644
--- a/web-admin/src/views/system/user/index.vue
+++ b/web-admin/src/views/system/user/index.vue
@@ -11,12 +11,14 @@
       <div class="flex gap-4">
         <!-- 左侧：组织树 -->
         <div class="w-[280px] shrink-0 border-r border-[var(--mint-border)] pr-4">
-          <div class="panel-top">
+          <!-- 标题与搜索同处 panel-top：避免标题栏底边与独立输入框之间出现不可控的视觉断层 -->
+          <div class="panel-top user-dept-aside__head">
             <h2 class="title-bar-heading">组织</h2>
+            <el-input v-model="deptKeyword" placeholder="搜索组织" clearable />
           </div>
-          <el-input v-model="deptKeyword" placeholder="搜索组织" clearable class="mb-3" />
           <el-tree
             ref="deptTreeRef"
+            class="user-dept-aside__tree"
             :data="deptTree"
             :props="{ label: 'deptName', children: 'children' }"
             node-key="id"
@@ -74,6 +76,7 @@
               v-loading="loading"
               stripe
               row-key="id"
+              @row-dblclick="handleView"
             >
               <el-table-column
                 type="index"
@@ -85,12 +88,12 @@
               />
               <el-table-column prop="userNo" label="用户账号" min-width="120" align="center" header-align="center" />
               <el-table-column prop="nickName" label="用户名" min-width="100" align="center" header-align="center" />
-              <el-table-column prop="deptName" label="所属组织" min-width="120" align="center" header-align="center">
+              <el-table-column prop="deptName" label="所属组织" min-width="160" align="center" header-align="center">
                 <template #default="{ row }">
                   {{ row.deptName || '-' }}
                 </template>
               </el-table-column>
-              <el-table-column prop="phoneNo" label="手机号" min-width="120" align="center" header-align="center">
+              <el-table-column prop="phoneNo" label="手机号" min-width="140" align="center" header-align="center">
                 <template #default="{ row }">
                   {{ row.phoneNo || '-' }}
                 </template>
@@ -102,9 +105,10 @@
                   </el-tag>
                 </template>
               </el-table-column>
-              <el-table-column prop="createTime" label="创建时间" min-width="160" align="center" header-align="center" />
-              <el-table-column label="操作" width="320" fixed="right" align="center" header-align="center">
+              <el-table-column prop="createTime" label="创建时间" min-width="180" align="center" header-align="center" />
+              <el-table-column label="操作" width="400" fixed="right" align="center" header-align="center">
                 <template #default="{ row }">
+                  <el-button class="btn-op-item" @click="handleView(row)"><el-icon><View /></el-icon>查看</el-button>
                   <el-button class="btn-op-item primary" @click="handleEdit(row)">编辑</el-button>
                   <el-button class="btn-op-item" @click="handleResetPwd(row)">重置密码</el-button>
                   <el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
@@ -175,9 +179,6 @@
                 <el-option label="停用" value="0" />
               </el-select>
             </el-form-item>
-            <el-form-item label="排序">
-              <el-input-number v-model="formData.orderNum" :min="0" :max="9999" controls-position="right" />
-            </el-form-item>
             <el-form-item label="备注" style="grid-column: 1 / -1">
               <el-input v-model="formData.remark" type="textarea" :rows="2" placeholder="可选" />
             </el-form-item>
@@ -194,14 +195,23 @@
           </el-button>
         </template>
       </el-dialog>
+
+      <SystemViewDialog
+        v-model:visible="viewVisible"
+        :title="viewRow?.nickName || '用户详情'"
+        :icon="UserFilled"
+        :meta="`${viewRow?.deptName || ''}${viewRow?.deptName && viewRow?.createTime ? ' · ' : ''}${viewRow?.createTime || ''}`"
+        :sections="viewSections"
+      />
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
-  import { ref, reactive, onMounted, watch } from 'vue'
+  import { ref, reactive, computed, onMounted, watch } from 'vue'
   import { ElMessage, ElMessageBox } from 'element-plus'
-  import { Plus, Close, Check } from '@element-plus/icons-vue'
+  import { Plus, Close, Check, View, UserFilled } from '@element-plus/icons-vue'
+  import SystemViewDialog from '@/components/business/system-view-dialog/index.vue'
   import {
     fetchUserList,
     fetchCreateUser,
@@ -399,6 +409,39 @@
     await fetchResetPassword(row.id)
   }
 
+  // ---- 查看弹窗 ----
+  const viewVisible = ref(false)
+  const viewRow = ref<Api.User.UserItem | null>(null)
+
+  const viewSections = computed(() => {
+    const row = viewRow.value
+    if (!row) return []
+    return [
+      {
+        title: '基本信息',
+        fields: [
+          { label: '用户账号', value: row.userNo },
+          { label: '用户名', value: row.nickName },
+          { label: '所属组织', value: row.deptName },
+          { label: '手机号', value: row.phoneNo },
+          { label: '邮箱', value: row.email },
+          {
+            label: '性别',
+            value: ({ '0': '男', '1': '女', '2': '未知' } as Record<string, string>)[row.sex] || '未知'
+          },
+          { label: '状态', value: row.status === '1' ? '正常' : '停用' },
+          { label: '创建时间', value: row.createTime },
+          { label: '备注', value: row.remark, span: true }
+        ]
+      }
+    ]
+  })
+
+  function handleView(row: Api.User.UserItem) {
+    viewRow.value = row
+    viewVisible.value = true
+  }
+
   onMounted(() => {
     loadDeptTree()
     loadData()
@@ -406,17 +449,23 @@
 </script>
 
 <style scoped lang="scss">
+  /* 侧栏标题区纵向排布：与全局 panel-top 横排工具栏区分，收紧标题与搜索的间距节奏 */
+  .user-dept-aside__head {
+    flex-direction: column;
+    align-items: stretch;
+    justify-content: flex-start;
+    flex-wrap: nowrap;
+    gap: 8px;
+  }
+
+  .user-dept-aside__tree {
+    margin-top: 12px;
+  }
+
   .user-dialog-form {
     :deep(.el-form-item) {
       margin-bottom: 0;
     }
 
-    :deep(.el-form-item__label) {
-      font-size: 11px;
-      font-weight: 500;
-      color: var(--mint-text-muted);
-      padding: 0 0 4px;
-      line-height: 1.2;
-    }
   }
 </style>
diff --git a/web-admin/src/views/system/user/modules/user-dialog.vue b/web-admin/src/views/system/user/modules/user-dialog.vue
index 7675fa95..60c6e1a4 100644
--- a/web-admin/src/views/system/user/modules/user-dialog.vue
+++ b/web-admin/src/views/system/user/modules/user-dialog.vue
@@ -32,14 +32,15 @@
     </ElForm>
     <template #footer>
       <div class="dialog-footer">
-        <ElButton class="btn-ghost" @click="dialogVisible = false">取消</ElButton>
-        <ElButton class="btn-main" type="primary" @click="handleSubmit">提交</ElButton>
+        <ElButton class="btn-ghost" @click="dialogVisible = false"><el-icon><Close /></el-icon>取消</ElButton>
+        <ElButton class="btn-main" type="primary" @click="handleSubmit"><el-icon><Check /></el-icon>提交</ElButton>
       </div>
     </template>
   </ElDialog>
 </template>
 
 <script setup lang="ts">
+  import { Close, Check } from '@element-plus/icons-vue'
   import { fetchGetRoleList } from '@/api/admin'
   import type { FormInstance, FormRules } from 'element-plus'
 
diff --git a/web-admin/src/views/system/workflow/components/ApprovalDialog.vue b/web-admin/src/views/system/workflow/components/ApprovalDialog.vue
new file mode 100644
index 00000000..3ca38ee4
--- /dev/null
+++ b/web-admin/src/views/system/workflow/components/ApprovalDialog.vue
@@ -0,0 +1,288 @@
+<!-- 审批操作弹窗 -->
+<template>
+  <el-dialog
+    v-model="visible"
+    width="640px"
+    destroy-on-close
+    class="workflow-module-dialog"
+    align-center
+    :close-on-click-modal="false"
+    :show-close="false"
+    style="backdrop-filter: none"
+  >
+    <div v-if="bizLoading" v-loading="true" class="dialog-scroll" style="min-height: 120px" />
+    <div v-else class="dialog-scroll">
+      <!-- Hero header -->
+      <div class="view-hero">
+        <div class="view-hero-icon">
+          <el-icon :size="28"><Checked /></el-icon>
+        </div>
+        <div class="view-hero-main">
+          <h2>{{ instanceData?.processName || '审批操作' }}</h2>
+          <div class="view-hero-tags">
+            <el-tag size="small" type="info">{{ instanceData?.businessTypeLabel || instanceData?.businessType || '--' }}</el-tag>
+          </div>
+          <p v-if="instanceData" class="view-hero-meta">
+            发起人：{{ instanceData.starterUserName || '--' }}
+            <span class="dot">·</span>
+            业务单号：{{ instanceData.businessId || '--' }}
+            <span class="dot">·</span>
+            {{ instanceData.createTime || '--' }}
+          </p>
+        </div>
+      </div>
+
+      <!-- 申请信息 -->
+      <div v-if="formFields.length" class="view-section">
+        <h3>申请信息</h3>
+        <dl class="view-kv-grid">
+          <div v-for="field in formFields" :key="field.label" class="view-kv">
+            <dt>{{ field.label }}</dt>
+            <dd>{{ field.value || '--' }}</dd>
+          </div>
+        </dl>
+      </div>
+
+      <!-- 审批操作 -->
+      <div class="view-section">
+        <h3>审批操作</h3>
+        <el-form :model="form" label-position="top">
+          <el-form-item label="审批结果">
+            <el-radio-group v-model="form.approved">
+              <el-radio :value="true">通过</el-radio>
+              <el-radio :value="false">驳回</el-radio>
+            </el-radio-group>
+          </el-form-item>
+          <el-form-item label="审批意见">
+            <el-input
+              v-model="form.commentText"
+              type="textarea"
+              :rows="3"
+              placeholder="请输入审批意见"
+            />
+          </el-form-item>
+        </el-form>
+      </div>
+    </div>
+    <template #footer>
+      <el-button class="btn-ghost" @click="visible = false"><el-icon><Close /></el-icon>取消</el-button>
+      <el-button type="primary" class="btn-main" :loading="submitting" @click="handleSubmit">
+        <el-icon><Check /></el-icon>
+        确认提交
+      </el-button>
+    </template>
+  </el-dialog>
+</template>
+
+<script setup lang="ts">
+  import { fetchApproveTask, fetchRejectTask, fetchInstanceDetail } from '@/api/workflow'
+  import { Checked, Close, Check } from '@element-plus/icons-vue'
+
+  defineOptions({ name: 'ApprovalDialog' })
+
+  const props = defineProps<{
+    visible: boolean
+    taskId: string
+    instanceId?: string
+  }>()
+
+  const emit = defineEmits<{
+    (e: 'update:visible', val: boolean): void
+    (e: 'done'): void
+  }>()
+
+  const visible = computed({
+    get: () => props.visible,
+    set: (val) => emit('update:visible', val)
+  })
+
+  const submitting = ref(false)
+  const form = reactive({
+    approved: true,
+    commentText: ''
+  })
+
+  const bizLoading = ref(false)
+  const formFields = ref<Array<{ label: string; value: string }>>([])
+  const instanceData = ref<Record<string, any> | null>(null)
+
+  async function loadFormData() {
+    if (!props.instanceId) return
+    bizLoading.value = true
+    formFields.value = []
+    instanceData.value = null
+    try {
+      const data = await fetchInstanceDetail(props.instanceId)
+      instanceData.value = data
+      formFields.value = data.businessFormFields || []
+    } catch {
+      // 加载失败不影响审批操作
+    } finally {
+      bizLoading.value = false
+    }
+  }
+
+  watch(
+    () => props.visible,
+    (val) => {
+      if (val) {
+        form.approved = true
+        form.commentText = ''
+        loadFormData()
+      }
+    }
+  )
+
+  async function handleSubmit() {
+    submitting.value = true
+    try {
+      const data = { commentText: form.commentText?.trim() || undefined }
+      if (form.approved) {
+        await fetchApproveTask(props.taskId, data)
+      } else {
+        await fetchRejectTask(props.taskId, data)
+      }
+      visible.value = false
+      emit('done')
+    } catch {
+      // 错误已由全局处理
+    } finally {
+      submitting.value = false
+    }
+  }
+</script>
+
+<style scoped lang="scss">
+  .dialog-scroll {
+    overflow-y: auto;
+    max-height: calc(100vh - 120px);
+  }
+
+  .view-hero {
+    display: flex;
+    gap: 16px;
+    padding: 20px 22px;
+    background: linear-gradient(135deg, #ecfdf5 0%, #ffffff 55%);
+    border-bottom: 1px solid #d9e8e2;
+    align-items: center;
+  }
+
+  .view-hero-icon {
+    width: 72px;
+    height: 72px;
+    border-radius: 12px;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.08);
+    color: #059669;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  .view-hero-main {
+    flex: 1;
+    min-width: 0;
+
+    h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 700;
+      color: #1e293b;
+      letter-spacing: -0.02em;
+    }
+  }
+
+  .view-hero-tags {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 8px;
+    flex-wrap: wrap;
+  }
+
+  .view-hero-meta {
+    margin: 0;
+    font-size: 13px;
+    color: #64748b;
+    line-height: 1.5;
+
+    .dot {
+      margin: 0 6px;
+      opacity: 0.7;
+    }
+  }
+
+  .view-section {
+    padding: 18px 22px;
+    border-bottom: 1px solid #ebeef5;
+
+    &:last-child {
+      border-bottom: none;
+    }
+
+    h3 {
+      margin: 0 0 14px;
+      font-size: 13px;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      color: #64748b;
+    }
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: 96px 1fr;
+    gap: 8px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  @media (max-width: 640px) {
+    .view-kv-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .view-kv {
+      grid-template-columns: 1fr;
+      gap: 4px;
+    }
+  }
+</style>
+
+<style lang="scss">
+  .workflow-module-dialog {
+    .el-dialog__header {
+      display: none;
+    }
+
+    .el-dialog__body {
+      padding: 0;
+      overflow: hidden;
+    }
+
+    .el-dialog__footer {
+      padding: 12px 22px;
+      border-top: 1px solid #d9e8e2;
+      background: #f8fafc;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/system/workflow/components/ProcessStatusTag.vue b/web-admin/src/views/system/workflow/components/ProcessStatusTag.vue
new file mode 100644
index 00000000..bb107f21
--- /dev/null
+++ b/web-admin/src/views/system/workflow/components/ProcessStatusTag.vue
@@ -0,0 +1,25 @@
+<!-- 流程/任务状态标签 -->
+<template>
+  <el-tag :type="tagType" size="small">{{ label }}</el-tag>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ProcessStatusTag' })
+
+  const props = defineProps<{
+    status: string
+  }>()
+
+  const statusMap: Record<string, { type: string; label: string }> = {
+    running: { type: 'warning', label: '进行中' },
+    completed: { type: 'success', label: '已完成' },
+    rejected: { type: 'danger', label: '已驳回' },
+    cancelled: { type: 'info', label: '已取消' },
+    pending: { type: 'warning', label: '待处理' },
+    approved: { type: 'success', label: '已通过' },
+    withdrawn: { type: 'info', label: '已撤回' }
+  }
+
+  const tagType = computed(() => statusMap[props.status]?.type ?? 'info')
+  const label = computed(() => statusMap[props.status]?.label ?? props.status)
+</script>
diff --git a/web-admin/src/views/system/workflow/designer/FlowDesigner.vue b/web-admin/src/views/system/workflow/designer/FlowDesigner.vue
new file mode 100644
index 00000000..a5c2a679
--- /dev/null
+++ b/web-admin/src/views/system/workflow/designer/FlowDesigner.vue
@@ -0,0 +1,1641 @@
+<!-- 流程设计器 — AntV X6 图形化编辑 -->
+<template>
+  <el-dialog
+    :model-value="visible"
+    width="90vw"
+    :align-center="false"
+    destroy-on-close
+    :close-on-click-modal="false"
+    :show-close="false"
+    class="flow-designer-dialog"
+    top="50px"
+    @open="handleOpen"
+    @close="handleClose"
+  >
+    <template #header>
+      <div class="designer-header">
+        <span class="designer-title">{{ processName || '流程设计器' }}</span>
+        <div class="designer-actions">
+          <div class="zoom-controls">
+            <span class="zoom-btn" @click="handleZoomOut" title="缩小">
+              <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8" /><line x1="21" y1="21" x2="16.65" y2="16.65" /><line x1="8" y1="11" x2="14" y2="11" /></svg>
+            </span>
+            <span class="zoom-level">{{ zoomLevel }}%</span>
+            <span class="zoom-btn" @click="handleZoomIn" title="放大">
+              <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8" /><line x1="21" y1="21" x2="16.65" y2="16.65" /><line x1="11" y1="8" x2="11" y2="14" /><line x1="8" y1="11" x2="14" y2="11" /></svg>
+            </span>
+            <span class="zoom-btn" @click="handleZoomReset" title="适应画布">
+              <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2" /><line x1="9" y1="3" x2="9" y2="21" /><line x1="3" y1="9" x2="21" y2="9" /></svg>
+            </span>
+          </div>
+          <el-button class="btn-ghost" @click="handleCancel"><el-icon><Close /></el-icon>取消</el-button>
+          <el-button class="btn-ghost" type="primary" plain :loading="saving" @click="handleSaveDraft">
+            <el-icon><Document /></el-icon>
+            保存草稿
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="publishing" @click="handlePublish">
+            <el-icon><Check /></el-icon>
+            发布新版本
+          </el-button>
+        </div>
+      </div>
+    </template>
+
+    <div class="designer-body">
+      <!-- 左侧节点面板 -->
+      <aside class="node-panel">
+        <div class="panel-section-title">节点类型</div>
+        <div
+          v-for="item in nodeTypes"
+          :key="item.type"
+          class="node-card"
+          draggable="true"
+          @dragstart="(e) => onDragStart(e, item)"
+        >
+          <span class="node-icon" :style="{ background: item.color }">{{ item.icon }}</span>
+          <span class="node-label">{{ item.label }}</span>
+        </div>
+
+        <div class="panel-section-title" style="margin-top: 24px">操作提示</div>
+        <ul class="tips-list">
+          <li>拖拽左侧节点到画布创建</li>
+          <li>从节点连接点拖出连线</li>
+          <li>点击连线编辑条件规则</li>
+          <li>Ctrl + 滚轮缩放画布</li>
+          <li>点击节点编辑属性</li>
+          <li>选中节点后按 Delete 键删除</li>
+          <li>Ctrl+Z 撤销，Ctrl+Y 重做</li>
+        </ul>
+      </aside>
+
+      <!-- 中间画布 -->
+      <main class="canvas-area" @dragover.prevent @drop="onDrop">
+        <div ref="containerRef" class="graph-container" />
+      </main>
+
+      <!-- 右侧属性面板 -->
+      <aside class="props-panel">
+        <!-- 节点选中状态 -->
+        <template v-if="selectedNode">
+          <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 8px">
+            <span class="panel-section-title" style="margin: 0">节点属性</span>
+            <el-button
+              v-if="selectedNode.nodeType !== 'start' && selectedNode.nodeType !== 'end'"
+              type="danger"
+              text
+              size="small"
+              @click="deleteSelectedNode"
+            >
+              删除节点
+            </el-button>
+          </div>
+          <el-form label-position="top" class="props-form">
+            <el-form-item label="节点名称">
+              <el-input v-model="selectedNode.nodeName" placeholder="请输入节点名称" @input="syncNodeData" />
+            </el-form-item>
+
+            <template v-if="selectedNode.nodeType === 'approval'">
+              <el-form-item label="审批人策略">
+                <el-select v-model="selectedNode.config.strategy" placeholder="选择策略" style="width: 100%" @change="syncNodeData">
+                  <el-option label="指定用户" value="users" />
+                  <el-option label="指定角色" value="roles" />
+                  <el-option label="SQL查询" value="sql" />
+                </el-select>
+              </el-form-item>
+
+              <el-form-item v-if="selectedNode.config.strategy === 'users'" label="选择用户">
+                <el-select
+                  v-model="selectedNode.config.userIds"
+                  multiple
+                  filterable
+                  placeholder="选择用户"
+                  style="width: 100%"
+                  @change="syncNodeData"
+                >
+                  <el-option
+                    v-for="u in userOptions"
+                    :key="u.value"
+                    :label="u.label"
+                    :value="u.value"
+                  />
+                </el-select>
+              </el-form-item>
+
+              <el-form-item v-if="selectedNode.config.strategy === 'roles'" label="选择角色">
+                <el-select
+                  v-model="selectedNode.config.roleIds"
+                  multiple
+                  filterable
+                  placeholder="选择角色"
+                  style="width: 100%"
+                  @change="syncNodeData"
+                >
+                  <el-option
+                    v-for="r in roleOptions"
+                    :key="r.value"
+                    :label="r.label"
+                    :value="r.value"
+                  />
+                </el-select>
+              </el-form-item>
+
+              <el-form-item v-if="selectedNode.config.strategy === 'sql'" label="SQL查询语句">
+                <el-input
+                  v-model="selectedNode.config.sqlExpr"
+                  type="textarea"
+                  :rows="4"
+                  placeholder="SELECT user_id FROM sys_user WHERE ..."
+                  @input="syncNodeData"
+                />
+                <div class="sql-help">
+                  <p><strong>SQL审批人策略说明：</strong></p>
+                  <ul>
+                    <li>必须以 <code>SELECT</code> 开头，只允许只读查询</li>
+                    <li>查询结果第一列将作为审批人 user_id</li>
+                    <li>可使用流程变量作为参数：<code>:var_name</code> 占位符</li>
+                    <li>禁止 INSERT / UPDATE / DELETE / DROP 等写操作</li>
+                  </ul>
+                  <p class="sql-example">示例：<code>SELECT id FROM sys_user WHERE dept_id = :dept_id AND del_flag = 0</code></p>
+                </div>
+              </el-form-item>
+
+              <el-form-item label="通过条件">
+                <el-radio-group v-model="selectedNode.config.passType" @change="syncNodeData">
+                  <el-radio value="any">任一通过即可</el-radio>
+                  <el-radio value="all">全部通过才行</el-radio>
+                </el-radio-group>
+              </el-form-item>
+            </template>
+
+            <template v-if="selectedNode.nodeType === 'condition'">
+              <el-form-item>
+                <div class="hint-text">条件规则在连线上配置，请点击连线编辑条件</div>
+              </el-form-item>
+            </template>
+          </el-form>
+        </template>
+
+        <!-- 连线选中状态（条件编辑） -->
+        <template v-else-if="selectedEdge">
+          <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 8px">
+            <span class="panel-section-title" style="margin: 0">连线条件</span>
+            <el-button type="danger" text size="small" @click="deleteSelectedEdge">删除连线</el-button>
+          </div>
+          <div class="edge-info">
+            <span class="edge-from">{{ selectedEdge.fromNodeName }}</span>
+            <span class="edge-arrow">→</span>
+            <span class="edge-to">{{ selectedEdge.toNodeName }}</span>
+          </div>
+
+          <el-form label-position="top" class="props-form" style="margin-top: 12px">
+            <el-form-item>
+              <el-checkbox v-model="selectedEdge.isDefault" @change="syncEdgeCondition">
+                默认分支（其他分支都不满足时走此路径）
+              </el-checkbox>
+            </el-form-item>
+
+            <template v-if="!selectedEdge.isDefault">
+              <div v-for="(group, gIdx) in selectedEdge.groups" :key="gIdx" class="condition-group">
+                <div class="group-header">
+                  <span class="group-label">条件组 {{ gIdx + 1 }}</span>
+                  <span class="group-logic-badge">组内全部满足 (AND)</span>
+                  <el-button
+                    v-if="selectedEdge.groups.length > 1"
+                    type="danger"
+                    text
+                    size="small"
+                    style="margin-left: auto"
+                    @click="removeConditionGroup(gIdx)"
+                  >
+                    删除组
+                  </el-button>
+                </div>
+                <div v-for="(rule, rIdx) in group.rules" :key="rIdx" class="condition-rule-row">
+                  <el-input v-model="rule.field" placeholder="字段名" style="width: 28%" @input="syncEdgeCondition" />
+                  <el-select v-model="rule.op" style="width: 20%" @change="syncEdgeCondition">
+                    <el-option label="==" value="==" />
+                    <el-option label="!=" value="!=" />
+                    <el-option label=">" value=">" />
+                    <el-option label="<" value="<" />
+                    <el-option label=">=" value=">=" />
+                    <el-option label="<=" value="<=" />
+                    <el-option label="包含" value="contains" />
+                    <el-option label="不包含" value="not_in" />
+                  </el-select>
+                  <el-input v-model="rule.value" placeholder="值" style="width: 28%" @input="syncEdgeCondition" />
+                  <el-button
+                    v-if="group.rules.length > 1"
+                    text
+                    type="danger"
+                    size="small"
+                    @click="removeConditionRule(gIdx, rIdx)"
+                  >
+                    ×
+                  </el-button>
+                </div>
+                <el-button type="primary" link size="small" @click="addConditionRule(gIdx)">
+                  + 添加条件
+                </el-button>
+              </div>
+              <div class="group-logic-hint">组间关系：任一条件组满足即可 (OR)</div>
+              <el-button type="primary" link @click="addConditionGroup">+ 添加条件组 (OR)</el-button>
+
+              <div class="field-hint">
+                <p><strong>流程变量说明：</strong></p>
+                <p>字段名为流程发起时传入的变量名，支持嵌套路径（如 <code>order.amount</code>）</p>
+                <p>常见变量：<code>amount</code> 金额 · <code>department</code> 部门 · <code>applicant.dept_id</code> 发起人部门</p>
+              </div>
+            </template>
+          </el-form>
+        </template>
+
+        <!-- 空状态 -->
+        <template v-else>
+          <div class="panel-section-title">属性</div>
+          <div class="empty-hint">点击节点编辑属性，点击连线编辑条件</div>
+        </template>
+      </aside>
+    </div>
+  </el-dialog>
+</template>
+
+<script setup lang="ts">
+import { Graph } from '@antv/x6'
+import { Close, Document, Check } from '@element-plus/icons-vue'
+import { fetchDesignerData, fetchPublishVersion } from '@/api/workflow'
+import { fetchUserOptions, fetchRoleOptions } from '@/api/admin'
+
+defineOptions({ name: 'FlowDesigner' })
+
+const props = defineProps<{
+  visible: boolean
+  processDefId: string
+  processName: string
+}>()
+
+const emit = defineEmits<{
+  (e: 'update:visible', val: boolean): void
+  (e: 'saved'): void
+}>()
+
+// ---------------------------------------------------------------------------
+// 节点类型定义
+// ---------------------------------------------------------------------------
+
+interface NodeTypeInfo {
+  type: string
+  label: string
+  icon: string
+  color: string
+}
+
+const nodeTypes: NodeTypeInfo[] = [
+  { type: 'start', label: '开始节点', icon: '▶', color: '#10b981' },
+  { type: 'end', label: '结束节点', icon: '⏹', color: '#ef4444' },
+  { type: 'approval', label: '审批节点', icon: '👤', color: '#3b82f6' },
+  { type: 'condition', label: '条件节点', icon: '◆', color: '#f59e0b' },
+]
+
+// ---------------------------------------------------------------------------
+// 状态
+// ---------------------------------------------------------------------------
+
+const containerRef = ref<HTMLElement>()
+const saving = ref(false)
+const publishing = ref(false)
+
+interface SelectedNodeData {
+  id: string
+  nodeType: string
+  nodeName: string
+  config: {
+    strategy: string
+    userIds: string[]
+    roleIds: string[]
+    sqlExpr: string
+    passType: string
+    [key: string]: unknown
+  }
+}
+
+const selectedNode = ref<SelectedNodeData | null>(null)
+
+const userOptions = ref<Array<{ label: string; value: string }>>([])
+const roleOptions = ref<Array<{ label: string; value: string }>>([])
+
+interface ConditionRule {
+  field: string
+  op: string
+  value: string
+}
+
+interface ConditionGroup {
+  logic: 'and'
+  rules: ConditionRule[]
+}
+
+interface SelectedEdgeData {
+  id: string
+  fromNodeName: string
+  toNodeName: string
+  groups: ConditionGroup[]
+  isDefault: boolean
+}
+
+const selectedEdge = ref<SelectedEdgeData | null>(null)
+
+const canUndo = ref(false)
+const canRedo = ref(false)
+const zoomLevel = ref(100)
+
+let graph: Graph | null = null
+
+// ---------------------------------------------------------------------------
+// 注册自定义节点形状
+// ---------------------------------------------------------------------------
+
+function registerShapes() {
+  // 开始节点 — 绿色圆形
+  Graph.registerNode(
+    'flow-start',
+    {
+      inherit: 'circle',
+      width: 50,
+      height: 50,
+      attrs: {
+        body: {
+          fill: '#10b981',
+          stroke: '#059669',
+          strokeWidth: 2,
+        },
+        label: {
+          fill: '#ffffff',
+          fontSize: 13,
+          fontWeight: 600,
+        },
+      },
+      ports: {
+        groups: {
+          bottom: {
+            position: 'bottom',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#10b981',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+        },
+      },
+    },
+    true,
+  )
+
+  // 结束节点 — 红色圆形
+  Graph.registerNode(
+    'flow-end',
+    {
+      inherit: 'circle',
+      width: 50,
+      height: 50,
+      attrs: {
+        body: {
+          fill: '#ef4444',
+          stroke: '#dc2626',
+          strokeWidth: 2,
+        },
+        label: {
+          fill: '#ffffff',
+          fontSize: 13,
+          fontWeight: 600,
+        },
+      },
+      ports: {
+        groups: {
+          top: {
+            position: 'top',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#ef4444',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+        },
+      },
+    },
+    true,
+  )
+
+  // 审批节点 — 蓝色圆角矩形
+  Graph.registerNode(
+    'flow-approval',
+    {
+      inherit: 'rect',
+      width: 180,
+      height: 40,
+      attrs: {
+        body: {
+          fill: '#3b82f6',
+          stroke: '#2563eb',
+          strokeWidth: 2,
+          rx: 8,
+          ry: 8,
+        },
+        label: {
+          fill: '#ffffff',
+          fontSize: 13,
+          fontWeight: 500,
+        },
+      },
+      ports: {
+        groups: {
+          top: {
+            position: 'top',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#3b82f6',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          bottom: {
+            position: 'bottom',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#3b82f6',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          left: {
+            position: 'left',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#3b82f6',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          right: {
+            position: 'right',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#3b82f6',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+        },
+      },
+    },
+    true,
+  )
+
+  // 条件节点 — 橙色菱形 (polygon)
+  Graph.registerNode(
+    'flow-condition',
+    {
+      inherit: 'polygon',
+      width: 80,
+      height: 80,
+      attrs: {
+        body: {
+          fill: '#f59e0b',
+          stroke: '#d97706',
+          strokeWidth: 2,
+          refPoints: '50,0 100,50 50,100 0,50',
+        },
+        label: {
+          fill: '#ffffff',
+          fontSize: 12,
+          fontWeight: 500,
+        },
+      },
+      ports: {
+        groups: {
+          top: {
+            position: 'top',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#f59e0b',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          bottom: {
+            position: 'bottom',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#f59e0b',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          left: {
+            position: 'left',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#f59e0b',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+          right: {
+            position: 'right',
+            attrs: {
+              circle: {
+                r: 5,
+                magnet: true,
+                stroke: '#f59e0b',
+                fill: '#fff',
+                strokeWidth: 1.5,
+              },
+            },
+          },
+        },
+      },
+    },
+    true,
+  )
+}
+
+// ---------------------------------------------------------------------------
+// 获取节点默认端口
+// ---------------------------------------------------------------------------
+
+function getDefaultPorts(nodeType: string) {
+  switch (nodeType) {
+    case 'start':
+      return { items: [{ group: 'bottom', id: 'port-out' }] }
+    case 'end':
+      return { items: [{ group: 'top', id: 'port-in' }] }
+    case 'approval':
+      return {
+        items: [
+          { group: 'top', id: 'port-in' },
+          { group: 'bottom', id: 'port-out' },
+        ],
+      }
+    case 'condition':
+      return {
+        items: [
+          { group: 'top', id: 'port-in' },
+          { group: 'left', id: 'port-yes' },
+          { group: 'right', id: 'port-no' },
+        ],
+      }
+    default:
+      return { items: [] }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 形状名映射
+// ---------------------------------------------------------------------------
+
+const shapeMap: Record<string, string> = {
+  start: 'flow-start',
+  end: 'flow-end',
+  approval: 'flow-approval',
+  condition: 'flow-condition',
+}
+
+// ---------------------------------------------------------------------------
+// 手动历史记录栈（替代插件）
+// ---------------------------------------------------------------------------
+
+const historyStack: string[] = []
+const historyIndex = ref(-1)
+const maxHistory = 50
+
+function pushHistory() {
+  if (!graph) return
+  const json = JSON.stringify(graph.toJSON())
+  // 如果在历史中间位置做了修改，截断后面的记录
+  if (historyIndex.value < historyStack.length - 1) {
+    historyStack.splice(historyIndex.value + 1)
+  }
+  historyStack.push(json)
+  if (historyStack.length > maxHistory) {
+    historyStack.shift()
+  }
+  historyIndex.value = historyStack.length - 1
+  canUndo.value = historyIndex.value > 0
+  canRedo.value = false
+}
+
+function undoAction() {
+  if (historyIndex.value <= 0 || !graph) return
+  historyIndex.value--
+  const json = historyStack[historyIndex.value]
+  graph.fromJSON(JSON.parse(json))
+  selectedNode.value = null
+  selectedEdge.value = null
+  canUndo.value = historyIndex.value > 0
+  canRedo.value = historyIndex.value < historyStack.length - 1
+}
+
+function redoAction() {
+  if (historyIndex.value >= historyStack.length - 1 || !graph) return
+  historyIndex.value++
+  const json = historyStack[historyIndex.value]
+  graph.fromJSON(JSON.parse(json))
+  selectedNode.value = null
+  selectedEdge.value = null
+  canUndo.value = historyIndex.value > 0
+  canRedo.value = historyIndex.value < historyStack.length - 1
+}
+
+// ---------------------------------------------------------------------------
+// 键盘事件处理
+// ---------------------------------------------------------------------------
+
+function handleKeyDown(e: KeyboardEvent) {
+  if (!graph) return
+
+  const isDelete = e.key === 'Delete' || e.key === 'Backspace'
+  const isUndo = (e.ctrlKey || e.metaKey) && e.key === 'z' && !e.shiftKey
+  const isRedo = (e.ctrlKey || e.metaKey) && (e.key === 'y' || (e.key === 'z' && e.shiftKey))
+
+  // Don't handle if user is typing in an input/textarea
+  const tag = (e.target as HTMLElement)?.tagName?.toLowerCase()
+  if (tag === 'input' || tag === 'textarea' || tag === 'select') return
+
+  if (isDelete) {
+    e.preventDefault()
+    // Delete selected node (from selectedNode or selectedEdge)
+    if (selectedNode.value) {
+      const data = selectedNode.value
+      if (data.nodeType !== 'start' && data.nodeType !== 'end') {
+        const cell = graph.getCellById(data.id)
+        if (cell) graph.removeCell(cell)
+        selectedNode.value = null
+      }
+    } else if (selectedEdge.value) {
+      const cell = graph.getCellById(selectedEdge.value.id)
+      if (cell) graph.removeCell(cell)
+      selectedEdge.value = null
+    }
+  }
+
+  if (isUndo) {
+    e.preventDefault()
+    undoAction()
+  }
+
+  if (isRedo) {
+    e.preventDefault()
+    redoAction()
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 初始化画布
+// ---------------------------------------------------------------------------
+
+function initGraph() {
+  if (!containerRef.value) return
+
+  graph = new Graph({
+    container: containerRef.value,
+    autoResize: true,
+    grid: {
+      visible: true,
+      type: 'doubleMesh',
+      args: [
+        { color: '#e5e7eb', thickness: 1 },
+        { color: '#d1d5db', thickness: 1, factor: 4 },
+      ],
+    },
+    background: { color: '#f9fafb' },
+    panning: true,
+    mousewheel: {
+      enabled: true,
+      modifiers: ['ctrl', 'meta'],
+    },
+    connecting: {
+      router: { name: 'manhattan' },
+      connector: {
+        name: 'rounded',
+        args: { radius: 8 },
+      },
+      anchor: 'center',
+      connectionPoint: 'anchor',
+      allowBlank: false,
+      allowLoop: false,
+      allowMulti: true,
+      snap: { radius: 30 },
+      createEdge() {
+        return graph!.createEdge({
+          shape: 'edge',
+          data: { conditionExpr: '' },
+          attrs: {
+            line: {
+              stroke: '#6b7280',
+              strokeWidth: 1.5,
+              targetMarker: {
+                name: 'block',
+                width: 10,
+                height: 6,
+              },
+            },
+          },
+          router: { name: 'manhattan' },
+          connector: { name: 'rounded', args: { radius: 8 } },
+        })
+      },
+    },
+  })
+
+  // 监听键盘事件
+  document.addEventListener('keydown', handleKeyDown)
+
+  // 缩放变化时更新显示
+  graph.on('scale', () => {
+    zoomLevel.value = Math.round(graph!.zoom() * 100)
+  })
+
+  // 节点点击 → 选中
+  graph.on('node:click', ({ node }) => {
+    // 先同步当前选中节点的数据到 graph
+    if (selectedNode.value) syncNodeData()
+    if (selectedEdge.value) syncEdgeCondition()
+    selectedEdge.value = null
+    const data = node.getData() || {}
+    selectedNode.value = {
+      id: node.id,
+      nodeType: data.nodeType || 'start',
+      nodeName: data.nodeName || '',
+      config: {
+        strategy: data.config?.strategy || 'users',
+        userIds: data.config?.userIds || [],
+        roleIds: data.config?.roleIds || [],
+        sqlExpr: data.config?.sqlExpr || '',
+        passType: data.config?.passType || 'any',
+      },
+    }
+  })
+
+  // 空白点击 → 取消选中
+  graph.on('blank:click', () => {
+    if (selectedNode.value) syncNodeData()
+    if (selectedEdge.value) syncEdgeCondition()
+    selectedNode.value = null
+    selectedEdge.value = null
+  })
+
+  // 连线点击 → 选中
+  graph.on('edge:click', ({ edge }) => {
+    // 先同步当前选中节点的数据到 graph
+    if (selectedNode.value) syncNodeData()
+    const sourceId = edge.getSourceCellId() || ''
+    const sourceNode = graph!.getCellById(sourceId)
+    const sourceData = sourceNode?.getData() || {}
+    const targetId = edge.getTargetCellId() || ''
+    const targetNode = graph!.getCellById(targetId)
+    const targetData = targetNode?.getData() || {}
+
+    const edgeData = edge.getData() || {}
+    let normalizedGroups: ConditionGroup[] = []
+    if (edgeData.conditionExpr) {
+      try {
+        const parsed = JSON.parse(edgeData.conditionExpr)
+        if (Array.isArray(parsed)) {
+          // Engine format: [{and: [{field,op,value},...]}, ...]
+          normalizedGroups = parsed.map((item: any) => {
+            if (item.and) {
+              return { logic: 'and' as const, rules: item.and.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+            }
+            if (item.or) {
+              return { logic: 'and' as const, rules: item.or.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+            }
+            const rawRules = item.rules || [item]
+            return { logic: 'and' as const, rules: rawRules.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }
+          })
+        } else if (parsed.rules) {
+          normalizedGroups = [{ logic: 'and', rules: parsed.rules.map((r: any) => ({ field: r.field || '', op: r.op || '==', value: String(r.value ?? '') })) }]
+        }
+      } catch {
+        // ignore parse errors
+      }
+    }
+    if (normalizedGroups.length === 0) {
+      normalizedGroups = [{ logic: 'and', rules: [{ field: '', op: '==', value: '' }] }]
+    }
+
+    selectedEdge.value = {
+      id: edge.id,
+      fromNodeName: sourceData.nodeName || sourceId,
+      toNodeName: targetData.nodeName || targetId,
+      groups: normalizedGroups,
+      isDefault: !edgeData.conditionExpr || edgeData.conditionExpr === '[]',
+    }
+    selectedNode.value = null
+  })
+
+  graph.on('cell:removed', () => {
+    selectedNode.value = null
+    selectedEdge.value = null
+    pushHistory()
+  })
+
+  graph.on('edge:connected', () => {
+    pushHistory()
+  })
+
+  graph.on('node:moved', () => {
+    pushHistory()
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 拖拽 — 左侧面板
+// ---------------------------------------------------------------------------
+
+function onDragStart(e: DragEvent, item: NodeTypeInfo) {
+  e.dataTransfer?.setData('nodeType', item.type)
+  e.dataTransfer!.effectAllowed = 'copy'
+}
+
+// ---------------------------------------------------------------------------
+// 拖拽 — 画布放置
+// ---------------------------------------------------------------------------
+
+function onDrop(e: DragEvent) {
+  if (!graph) return
+  const nodeType = e.dataTransfer?.getData('nodeType')
+  if (!nodeType) return
+
+  const localPos = graph.clientToLocal(e.clientX, e.clientY)
+
+  const typeInfo = nodeTypes.find((n) => n.type === nodeType)
+  const defaultName = typeInfo?.label || nodeType
+
+  graph.addNode({
+    shape: shapeMap[nodeType] || 'rect',
+    x: localPos.x - 40,
+    y: localPos.y - 25,
+    label: defaultName,
+    ports: getDefaultPorts(nodeType),
+    data: {
+      nodeType,
+      nodeName: defaultName,
+      config: {
+        strategy: 'users',
+        userIds: [],
+        roleIds: [],
+        sqlExpr: '',
+        passType: 'any',
+      },
+    },
+  })
+  pushHistory()
+}
+
+function syncNodeData() {
+  if (!graph || !selectedNode.value) return
+  const node = graph.getCellById(selectedNode.value.id)
+  if (node && node.isNode()) {
+    node.setData(
+      {
+        ...node.getData(),
+        nodeName: selectedNode.value.nodeName,
+        config: { ...selectedNode.value.config },
+      },
+      { overwrite: true },
+    )
+    node.attr('label/text', selectedNode.value.nodeName)
+  }
+}
+
+// 同步条件表达式到 edge 并更新标签
+function syncEdgeCondition() {
+  if (!selectedEdge.value || !graph) return
+  const edge = graph.getCellById(selectedEdge.value.id)
+  if (!edge || !edge.isEdge()) return
+
+  if (selectedEdge.value.isDefault) {
+    edge.setData({ ...edge.getData(), conditionExpr: '' })
+    edge.setLabels([
+      {
+        attrs: {
+          label: { text: '其他情况', fill: '#9ca3af', fontSize: 11, textAnchor: 'middle', textVerticalAnchor: 'bottom', fontStyle: 'italic' },
+          rect: { fill: '#f9fafb', stroke: '#d1d5db', strokeWidth: 1, rx: 4, ry: 4, strokeDasharray: '3,3' },
+        },
+        position: { distance: 0.5 },
+      },
+    ])
+  } else {
+    const groups = selectedEdge.value.groups
+      .filter((g) => g.rules.some((r) => r.field.trim()))
+      .map((g) => ({
+        and: g.rules
+          .filter((r) => r.field.trim())
+          .map((r) => ({ field: r.field, op: r.op, value: r.value })),
+      }))
+    const expr = JSON.stringify(groups)
+    edge.setData({ ...edge.getData(), conditionExpr: expr })
+    const parts = groups.map((g) => g.and.map((r) => `${r.field} ${r.op} ${r.value}`).join(' & '))
+    const summary = parts.join(' | ')
+    edge.setLabels([
+      {
+        attrs: {
+          label: { text: summary || '条件', fill: '#374151', fontSize: 11, textAnchor: 'middle', textVerticalAnchor: 'bottom' },
+          rect: { fill: '#fff', stroke: '#d1d5db', strokeWidth: 1, rx: 4, ry: 4 },
+        },
+        position: { distance: 0.5 },
+      },
+    ])
+  }
+}
+
+function addConditionGroup() {
+  if (selectedEdge.value) {
+    selectedEdge.value.groups.push({ logic: 'and', rules: [{ field: '', op: '==', value: '' }] })
+  }
+}
+
+function removeConditionGroup(gIdx: number) {
+  if (selectedEdge.value && selectedEdge.value.groups.length > 1) {
+    selectedEdge.value.groups.splice(gIdx, 1)
+    syncEdgeCondition()
+  }
+}
+
+function addConditionRule(gIdx: number) {
+  if (selectedEdge.value) {
+    selectedEdge.value.groups[gIdx].rules.push({ field: '', op: '==', value: '' })
+  }
+}
+
+function removeConditionRule(gIdx: number, rIdx: number) {
+  if (selectedEdge.value && selectedEdge.value.groups[gIdx].rules.length > 1) {
+    selectedEdge.value.groups[gIdx].rules.splice(rIdx, 1)
+    syncEdgeCondition()
+  }
+}
+
+function deleteSelectedNode() {
+  if (!selectedNode.value || !graph) return
+  const cell = graph.getCellById(selectedNode.value.id)
+  if (cell) graph.removeCell(cell)
+  selectedNode.value = null
+}
+
+function deleteSelectedEdge() {
+  if (!selectedEdge.value || !graph) return
+  const cell = graph.getCellById(selectedEdge.value.id)
+  if (cell) graph.removeCell(cell)
+  selectedEdge.value = null
+}
+
+function handleUndo() {
+  undoAction()
+}
+
+function handleRedo() {
+  redoAction()
+}
+
+function handleZoomIn() {
+  if (!graph) return
+  const cur = graph.zoom()
+  if (cur >= 3) return
+  graph.zoom(0.1)
+  zoomLevel.value = Math.round(graph.zoom() * 100)
+}
+
+function handleZoomOut() {
+  if (!graph) return
+  const cur = graph.zoom()
+  if (cur <= 0.2) return
+  graph.zoom(-0.1)
+  zoomLevel.value = Math.round(graph.zoom() * 100)
+}
+
+function handleZoomReset() {
+  if (!graph) return
+  graph.zoomToFit({ padding: 40, maxScale: 1 })
+  zoomLevel.value = Math.round(graph.zoom() * 100)
+}
+
+// ---------------------------------------------------------------------------
+// 验证
+// ---------------------------------------------------------------------------
+
+interface ValidationError {
+  type: 'error' | 'warning'
+  message: string
+  nodeId?: string
+}
+
+function validateGraph(): ValidationError[] {
+  const errors: ValidationError[] = []
+  if (!graph) return errors
+
+  const cells = graph.getCells()
+  const nodes = cells.filter((c) => c.isNode())
+  const edges = cells.filter((c) => c.isEdge())
+
+  const startNodes = nodes.filter((n) => (n.getData() || {}).nodeType === 'start')
+  if (startNodes.length === 0) {
+    errors.push({ type: 'error', message: '必须有一个开始节点' })
+  } else if (startNodes.length > 1) {
+    errors.push({ type: 'error', message: '只能有一个开始节点', nodeId: startNodes[1].id })
+  }
+
+  const endNodes = nodes.filter((n) => (n.getData() || {}).nodeType === 'end')
+  if (endNodes.length === 0) {
+    errors.push({ type: 'error', message: '必须至少有一个结束节点' })
+  }
+
+  if (startNodes.length === 1) {
+    const hasOutEdge = edges.some((e) => e.getSourceCellId() === startNodes[0].id)
+    if (!hasOutEdge) {
+      errors.push({ type: 'error', message: '开始节点必须连接到下游节点', nodeId: startNodes[0].id })
+    }
+  }
+
+  endNodes.forEach((en) => {
+    const hasInEdge = edges.some((e) => e.getTargetCellId() === en.id)
+    if (!hasInEdge) {
+      errors.push({ type: 'error', message: '结束节点必须有入边连接', nodeId: en.id })
+    }
+  })
+
+  nodes.filter((n) => (n.getData() || {}).nodeType === 'approval').forEach((n) => {
+    const data = n.getData() || {}
+    const config = data.config || {}
+    const strategy = config.strategy || 'users'
+    const name = data.nodeName || n.id
+    if (strategy === 'users' && (!config.userIds || config.userIds.length === 0)) {
+      errors.push({ type: 'error', message: `审批节点"${name}"未选择审批用户`, nodeId: n.id })
+    }
+    if (strategy === 'roles' && (!config.roleIds || config.roleIds.length === 0)) {
+      errors.push({ type: 'error', message: `审批节点"${name}"未选择审批角色`, nodeId: n.id })
+    }
+    if (strategy === 'sql' && (!config.sqlExpr || !config.sqlExpr.trim())) {
+      errors.push({ type: 'error', message: `审批节点"${name}"未填写SQL查询`, nodeId: n.id })
+    }
+  })
+
+  nodes.filter((n) => (n.getData() || {}).nodeType === 'condition').forEach((n) => {
+    const data = n.getData() || {}
+    const outEdges = edges.filter((e) => e.getSourceCellId() === n.id)
+    if (outEdges.length < 2) {
+      errors.push({ type: 'error', message: `条件节点"${data.nodeName || n.id}"至少需要2条出边`, nodeId: n.id })
+    }
+  })
+
+  nodes.forEach((n) => {
+    const nodeType = (n.getData() || {}).nodeType
+    if (nodeType === 'start' || nodeType === 'end') return
+    const hasIn = edges.some((e) => e.getTargetCellId() === n.id)
+    const hasOut = edges.some((e) => e.getSourceCellId() === n.id)
+    if (!hasIn || !hasOut) {
+      errors.push({ type: 'warning', message: `节点"${(n.getData() || {}).nodeName || n.id}"未完全连接`, nodeId: n.id })
+    }
+  })
+
+  return errors
+}
+
+// ---------------------------------------------------------------------------
+// 序列化画布数据
+// ---------------------------------------------------------------------------
+
+interface SerializedData {
+  graphJson: string
+  nodes: Array<{
+    nodeKey: string
+    nodeType: string
+    nodeName: string | null
+    configJson: string | null
+  }>
+  transitions: Array<{
+    fromNodeKey: string
+    toNodeKey: string
+    conditionExpr: string | null
+  }>
+}
+
+function serializeGraph(): SerializedData {
+  if (!graph) {
+    return { graphJson: '{}', nodes: [], transitions: [] }
+  }
+  const cells = graph.getCells()
+  return {
+    graphJson: JSON.stringify(graph.toJSON()),
+    nodes: cells
+      .filter((c) => c.isNode())
+      .map((n) => {
+        const data = n.getData() || {}
+        return {
+          nodeKey: n.id,
+          nodeType: data.nodeType || 'start',
+          nodeName: data.nodeName || null,
+          configJson: data.config ? JSON.stringify(data.config) : null,
+        }
+      }),
+    transitions: cells
+      .filter((c) => c.isEdge())
+      .map((e) => ({
+        fromNodeKey: e.getSourceCellId() || '',
+        toNodeKey: e.getTargetCellId() || '',
+        conditionExpr: e.getData()?.conditionExpr || null,
+      })),
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 加载已有数据
+// ---------------------------------------------------------------------------
+
+async function loadDesignerData() {
+  if (!props.processDefId || !graph) return
+  try {
+    const res = await fetchDesignerData(props.processDefId)
+    if (res.graphJson) {
+      try {
+        graph.fromJSON(JSON.parse(res.graphJson))
+      } catch {
+        // JSON 解析失败则忽略，保持空画布
+      }
+    }
+  } catch {
+    // 加载失败则保持空画布
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 保存 / 发布
+// ---------------------------------------------------------------------------
+
+async function handleSaveDraft() {
+  if (saving.value || publishing.value) return
+  if (!props.processDefId) return
+  saving.value = true
+  try {
+    syncNodeData()
+    if (selectedEdge.value) syncEdgeCondition()
+    const data = serializeGraph()
+    await fetchPublishVersion(props.processDefId, {
+      ...data,
+      remark: '草稿',
+    })
+    ElMessage.success('草稿保存成功')
+  } catch {
+    // 错误已由全局处理
+  } finally {
+    saving.value = false
+  }
+}
+
+async function handlePublish() {
+  if (publishing.value || saving.value) return
+  // 验证
+  const errors = validateGraph()
+  const blockers = errors.filter((e) => e.type === 'error')
+  if (blockers.length > 0) {
+    ElMessage.error(blockers[0].message)
+    if (blockers[0].nodeId && graph) {
+      const cell = graph.getCellById(blockers[0].nodeId)
+      if (cell) graph.resetSelection(cell)
+    }
+    return
+  }
+  if (!props.processDefId) return
+  publishing.value = true
+  try {
+    syncNodeData()
+    if (selectedEdge.value) syncEdgeCondition()
+    const data = serializeGraph()
+    await fetchPublishVersion(props.processDefId, {
+      ...data,
+      remark: `版本发布 - ${new Date().toLocaleString('zh-CN')}`,
+    })
+    ElMessage.success('发布成功')
+    emit('saved')
+  } catch {
+    // 错误已由全局处理
+  } finally {
+    publishing.value = false
+  }
+}
+
+function handleCancel() {
+  emit('update:visible', false)
+}
+
+// ---------------------------------------------------------------------------
+// 对话框打开 / 关闭
+// ---------------------------------------------------------------------------
+
+function handleOpen() {
+  selectedNode.value = null
+  selectedEdge.value = null
+  historyStack.length = 0
+  historyIndex.value = -1
+  canUndo.value = false
+  canRedo.value = false
+  registerShapes()
+  nextTick(async () => {
+    initGraph()
+    await loadDesignerData()
+    loadOptions()
+    pushHistory()
+  })
+}
+
+async function loadOptions() {
+  try {
+    const [users, roles] = await Promise.all([fetchUserOptions(), fetchRoleOptions()])
+    userOptions.value = users || []
+    roleOptions.value = roles || []
+  } catch {
+    // 加载失败则保持空选项
+  }
+}
+
+function handleClose() {
+  document.removeEventListener('keydown', handleKeyDown)
+  if (graph) {
+    graph.dispose()
+    graph = null
+  }
+  selectedNode.value = null
+  selectedEdge.value = null
+}
+
+// ---------------------------------------------------------------------------
+// 清理
+// ---------------------------------------------------------------------------
+
+onUnmounted(() => {
+  document.removeEventListener('keydown', handleKeyDown)
+  if (graph) {
+    graph.dispose()
+    graph = null
+  }
+})
+</script>
+
+<style scoped lang="scss">
+// dialog 样式放在下面的非 scoped style 块中
+// scoped :deep(.el-dialog) 无法命中，因为 .flow-designer-dialog 本身就是 .el-dialog
+
+.designer-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 12px 20px;
+}
+
+.designer-title {
+  font-size: 16px;
+  font-weight: 600;
+  color: #111827;
+}
+
+.designer-actions {
+  display: flex;
+  gap: 8px;
+}
+
+.designer-body {
+  display: flex;
+  height: 100%;
+}
+
+// ---- 左侧节点面板 ----
+
+.node-panel {
+  width: 200px;
+  flex-shrink: 0;
+  padding: 16px;
+  background: #f9fafb;
+  border-right: 1px solid #e5e7eb;
+  overflow-y: auto;
+}
+
+.panel-section-title {
+  margin-bottom: 12px;
+  padding-left: 10px;
+  font-size: 12px;
+  font-weight: 600;
+  color: #6b7280;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  border-left: 3px solid #10b981;
+}
+
+.node-card {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 12px;
+  margin-bottom: 8px;
+  background: #fff;
+  border: 1px solid #e5e7eb;
+  border-radius: 6px;
+  cursor: grab;
+  transition:
+    box-shadow 0.2s,
+    border-color 0.2s;
+
+  &:hover {
+    border-color: #10b981;
+    box-shadow: 0 2px 8px rgba(16, 185, 129, 0.15);
+  }
+
+  &:active {
+    cursor: grabbing;
+  }
+}
+
+.node-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border-radius: 6px;
+  font-size: 14px;
+  color: #fff;
+  flex-shrink: 0;
+}
+
+.node-label {
+  font-size: 13px;
+  color: #374151;
+  font-weight: 500;
+}
+
+.tips-list {
+  margin: 0;
+  padding-left: 16px;
+  font-size: 12px;
+  color: #9ca3af;
+  line-height: 2;
+}
+
+// ---- 中间画布 ----
+
+.canvas-area {
+  flex: 1;
+  min-width: 0;
+  position: relative;
+  overflow: hidden;
+}
+
+.graph-container {
+  position: absolute;
+  inset: 0;
+}
+
+// ---- 右侧属性面板 ----
+
+.props-panel {
+  width: 300px;
+  flex-shrink: 0;
+  padding: 16px;
+  border-left: 1px solid #e5e7eb;
+  overflow-y: auto;
+  background: #fff;
+}
+
+
+
+.empty-hint {
+  padding: 24px 0;
+  text-align: center;
+  font-size: 13px;
+  color: #9ca3af;
+}
+
+.hint-text {
+  font-size: 13px;
+  color: #9ca3af;
+  line-height: 1.6;
+}
+
+.edge-info {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 12px;
+  background: #f9fafb;
+  border-radius: 6px;
+  font-size: 13px;
+  color: #374151;
+}
+
+.edge-from {
+  font-weight: 500;
+}
+
+.edge-arrow {
+  color: #9ca3af;
+}
+
+.edge-to {
+  font-weight: 500;
+}
+
+.condition-rule-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+
+.zoom-controls {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin-right: 12px;
+  padding-right: 12px;
+  border-right: 1px solid #e5e7eb;
+}
+
+.zoom-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border-radius: 6px;
+  color: #374151;
+  cursor: pointer;
+  transition: background-color 0.15s, color 0.15s;
+
+  &:hover {
+    background-color: #f3f4f6;
+    color: #111827;
+  }
+
+  &:active {
+    background-color: #e5e7eb;
+  }
+}
+
+.zoom-level {
+  font-size: 12px;
+  color: #6b7280;
+  min-width: 36px;
+  text-align: center;
+}
+
+.condition-group {
+  background: #f9fafb;
+  border: 1px solid #e5e7eb;
+  border-radius: 6px;
+  padding: 10px;
+  margin-bottom: 10px;
+}
+
+.group-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+
+.group-label {
+  font-size: 13px;
+  font-weight: 500;
+  color: #374151;
+}
+
+.group-logic-badge {
+  font-size: 11px;
+  color: #6b7280;
+  background: #e5e7eb;
+  padding: 2px 6px;
+  border-radius: 3px;
+}
+
+.group-logic-hint {
+  font-size: 12px;
+  color: #6b7280;
+  margin: 8px 0;
+  padding: 4px 8px;
+  background: #fef3c7;
+  border-radius: 4px;
+}
+
+.field-hint {
+  margin-top: 12px;
+  padding: 8px 10px;
+  background: #eff6ff;
+  border: 1px solid #bfdbfe;
+  border-radius: 6px;
+  font-size: 12px;
+  color: #1e40af;
+  line-height: 1.6;
+
+  p {
+    margin: 0 0 2px;
+  }
+
+  code {
+    background: #dbeafe;
+    padding: 1px 4px;
+    border-radius: 3px;
+    font-size: 11px;
+  }
+}
+
+.sql-help {
+  margin-top: 8px;
+  padding: 10px 12px;
+  background: #f0fdf4;
+  border: 1px solid #bbf7d0;
+  border-radius: 6px;
+  font-size: 12px;
+  color: #374151;
+  line-height: 1.6;
+
+  p {
+    margin: 0 0 4px;
+  }
+
+  ul {
+    margin: 4px 0;
+    padding-left: 18px;
+  }
+
+  li {
+    margin-bottom: 2px;
+  }
+
+  code {
+    background: #e0f2fe;
+    padding: 1px 4px;
+    border-radius: 3px;
+    font-size: 11px;
+    color: #0369a1;
+  }
+}
+
+.sql-example {
+  margin-top: 6px !important;
+  color: #059669;
+}
+</style>
+
+<!-- 非 scoped 样式：Element Plus Dialog 的 .el-dialog 是 teleport 到 body 的，
+     scoped :deep() 无法命中因为 .flow-designer-dialog 本身就是 .el-dialog -->
+<style lang="scss">
+.el-dialog.flow-designer-dialog {
+  backdrop-filter: none;
+  margin-top: 50px !important;
+  margin-bottom: 0 !important;
+  height: calc(100vh - 100px) !important;
+  max-height: calc(100vh - 100px) !important;
+  display: flex;
+  flex-direction: column;
+
+  .el-dialog__header {
+    margin: 0;
+    padding: 0;
+    border-bottom: 1px solid #e5e7eb;
+    flex-shrink: 0;
+  }
+
+  .el-dialog__body {
+    padding: 0;
+    flex: 1;
+    min-height: 0;
+    overflow: hidden;
+  }
+}
+</style>
diff --git a/web-admin/src/views/system/workflow/my-applications/index.vue b/web-admin/src/views/system/workflow/my-applications/index.vue
new file mode 100644
index 00000000..89847b31
--- /dev/null
+++ b/web-admin/src/views/system/workflow/my-applications/index.vue
@@ -0,0 +1,518 @@
+<!-- 我的申请 -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>我的申请</h1>
+      <p class="page-desc">查看我发起的所有审批申请及进度。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">申请列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input
+                v-model="searchForm.keyword"
+                placeholder="流程名称/业务单号"
+                clearable
+                @keyup.enter="handleSearch"
+              />
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-select v-model="searchForm.status" placeholder="全部" clearable style="width: 140px">
+                <el-option label="进行中" value="running" />
+                <el-option label="已完成" value="completed" />
+                <el-option label="已驳回" value="rejected" />
+              </el-select>
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按流程名称、业务单号模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"><el-icon><RefreshLeft /></el-icon>重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch"><el-icon><Search /></el-icon>搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+        >
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="processName"
+            label="流程名称"
+            min-width="160"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="businessTypeLabel"
+            label="业务类型"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="businessId"
+            label="业务单号"
+            min-width="200"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="status"
+            label="状态"
+            width="100"
+            align="center"
+            header-align="center"
+          >
+            <template #default="{ row }">
+              <ProcessStatusTag :status="row.status || ''" />
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="createTime"
+            label="发起时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="操作" width="160" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="handleViewDetail(row)"><el-icon><View /></el-icon>查看详情</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 详情弹窗 -->
+      <el-dialog
+        v-model="detailVisible"
+        width="720px"
+        class="workflow-module-dialog"
+        align-center
+        destroy-on-close
+        :show-close="false"
+        style="backdrop-filter: none"
+      >
+        <div v-loading="detailLoading" class="dialog-scroll">
+          <template v-if="detailData">
+            <div class="view-hero">
+              <div class="view-hero-icon">
+                <el-icon :size="28"><Document /></el-icon>
+              </div>
+              <div class="view-hero-main">
+                <h2>{{ detailRow?.processName || '流程详情' }}</h2>
+                <div class="view-hero-tags">
+                  <ProcessStatusTag :status="detailRow?.status || ''" />
+                  <el-tag size="small" type="info">{{ detailRow?.businessTypeLabel || detailData.businessType || '--' }}</el-tag>
+                </div>
+                <p class="view-hero-meta">
+                  业务单号：{{ detailData.businessId || '--' }}
+                  <span class="dot">·</span>
+                  {{ detailRow?.createTime || '--' }}
+                </p>
+              </div>
+            </div>
+
+            <div v-if="detailData.businessFormFields && detailData.businessFormFields.length" class="view-section">
+              <h3>申请信息</h3>
+              <dl class="view-kv-grid">
+                <div v-for="field in detailData.businessFormFields" :key="field.label" class="view-kv">
+                  <dt>{{ field.label }}</dt>
+                  <dd>{{ field.value || '--' }}</dd>
+                </div>
+              </dl>
+            </div>
+
+            <div v-if="detailData.tasks && detailData.tasks.length" class="view-section">
+              <h3>审批节点（含历史）</h3>
+              <div class="htl-scroll">
+                <div class="htl">
+                  <div
+                    v-for="(task, idx) in detailData.tasks"
+                    :key="task.id"
+                    class="htl-item"
+                    :class="getTimelineStatusClass(task.status)"
+                  >
+                    <div class="htl-rail">
+                      <span class="htl-node" />
+                      <span v-if="idx < detailData.tasks.length - 1" class="htl-line" />
+                    </div>
+                    <div class="htl-body">
+                      <div class="htl-name">{{ task.nodeName || '--' }}</div>
+                      <div class="htl-user">{{ task.assigneeUserName || '--' }}</div>
+                      <div class="htl-status">
+                        <ProcessStatusTag :status="task.status || ''" />
+                      </div>
+                      <div v-if="task.updateTime" class="htl-time">{{ task.updateTime }}</div>
+                      <div v-if="task.commentText" class="htl-comment">{{ task.commentText }}</div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </template>
+        </div>
+        <template #footer>
+          <el-button class="btn-ghost" @click="detailVisible = false"><el-icon><Close /></el-icon>关闭</el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchMyInstances, fetchBusinessAllTasks } from '@/api/workflow'
+  import ProcessStatusTag from '../components/ProcessStatusTag.vue'
+  import { Document, View, Search, RefreshLeft, Close } from '@element-plus/icons-vue'
+
+  defineOptions({ name: 'WorkflowMyApplications' })
+
+  const searchForm = reactive<{ keyword: string; status: string }>({ keyword: '', status: '' })
+  const tableData = ref<Api.Workflow.MyInstanceItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  const detailVisible = ref(false)
+  const detailLoading = ref(false)
+  const detailData = ref<Api.Workflow.BusinessAllTasks | null>(null)
+  const detailRow = ref<Api.Workflow.MyInstanceItem | null>(null)
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchMyInstances({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined,
+        status: searchForm.status || undefined,
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    searchForm.status = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  async function handleViewDetail(row: Api.Workflow.MyInstanceItem) {
+    detailVisible.value = true
+    detailLoading.value = true
+    detailData.value = null
+    detailRow.value = row
+    try {
+      const data = await fetchBusinessAllTasks(
+        row.businessType || '',
+        row.businessId || ''
+      )
+      detailData.value = data
+    } catch {
+      // error handled globally
+    } finally {
+      detailLoading.value = false
+    }
+  }
+
+  function getTimelineStatusClass(status: string) {
+    if (['approved', 'completed'].includes(status)) return 'htl-done'
+    if (['running', 'pending'].includes(status)) return 'htl-active'
+    if (status === 'rejected') return 'htl-reject'
+    return 'htl-muted'
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .dialog-scroll {
+    overflow-y: auto;
+    max-height: calc(100vh - 120px);
+  }
+
+  .view-hero {
+    display: flex;
+    gap: 16px;
+    padding: 20px 22px;
+    background: linear-gradient(135deg, #ecfdf5 0%, #ffffff 55%);
+    border-bottom: 1px solid #d9e8e2;
+    align-items: center;
+  }
+
+  .view-hero-icon {
+    width: 72px;
+    height: 72px;
+    border-radius: 12px;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.08);
+    color: #059669;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  .view-hero-main {
+    flex: 1;
+    min-width: 0;
+
+    h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 700;
+      color: #1e293b;
+      letter-spacing: -0.02em;
+    }
+  }
+
+  .view-hero-tags {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 8px;
+    flex-wrap: wrap;
+  }
+
+  .view-hero-meta {
+    margin: 0;
+    font-size: 13px;
+    color: #64748b;
+    line-height: 1.5;
+
+    .dot {
+      margin: 0 6px;
+      opacity: 0.7;
+    }
+  }
+
+  .view-section {
+    padding: 18px 22px;
+    border-bottom: 1px solid #ebeef5;
+
+    &:last-child {
+      border-bottom: none;
+    }
+
+    h3 {
+      margin: 0 0 14px;
+      font-size: 13px;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      color: #64748b;
+    }
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: 96px 1fr;
+    gap: 8px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  @media (max-width: 640px) {
+    .view-kv-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .view-kv {
+      grid-template-columns: 1fr;
+      gap: 4px;
+    }
+  }
+
+  /* horizontal timeline */
+  .htl-scroll {
+    overflow-x: auto;
+    padding: 0 0 4px 12px;
+
+    &::-webkit-scrollbar {
+      height: 4px;
+    }
+
+    &::-webkit-scrollbar-thumb {
+      background: #d1d5db;
+      border-radius: 2px;
+    }
+  }
+
+  .htl {
+    display: inline-flex;
+    min-width: 100%;
+  }
+
+  .htl-item {
+    display: flex;
+    flex-direction: column;
+    min-width: 140px;
+    flex: 1 0 140px;
+  }
+
+  .htl-rail {
+    position: relative;
+    display: flex;
+    align-items: center;
+    height: 22px;
+  }
+
+  .htl-node {
+    position: relative;
+    z-index: 1;
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    flex-shrink: 0;
+    background: #10b981;
+    border: 2px solid #fff;
+    box-shadow: 0 0 0 1px #10b981;
+  }
+
+  .htl-line {
+    flex: 1;
+    height: 2px;
+    background: #d1d5db;
+    margin-left: 0;
+  }
+
+  .htl-body {
+    padding: 8px 4px 0 0;
+    font-size: 13px;
+    line-height: 1.45;
+  }
+
+  .htl-name {
+    font-weight: 600;
+    color: #1e293b;
+    margin-bottom: 2px;
+  }
+
+  .htl-user {
+    color: #64748b;
+    font-size: 12px;
+    margin-bottom: 4px;
+  }
+
+  .htl-status {
+    margin-bottom: 4px;
+  }
+
+  .htl-time {
+    font-size: 11px;
+    color: #94a3b8;
+    margin-bottom: 2px;
+  }
+
+  .htl-comment {
+    font-size: 12px;
+    color: #64748b;
+    word-break: break-word;
+  }
+
+  .htl-active .htl-node {
+    background: #fff;
+    border: 3px solid #10b981;
+    box-shadow: 0 0 0 2px rgba(16, 185, 129, 0.25);
+  }
+
+  .htl-reject .htl-node {
+    background: #ef4444;
+    border-color: #fff;
+    box-shadow: 0 0 0 1px #ef4444;
+  }
+
+  .htl-muted .htl-node {
+    background: #d1d5db;
+    border-color: #fff;
+    box-shadow: none;
+  }
+
+  .htl-done + .htl-active .htl-line,
+  .htl-done + .htl-done .htl-line {
+    background: #10b981;
+  }
+
+  .htl-active + .htl-done .htl-line {
+    background: #10b981;
+  }
+</style>
+
+<style lang="scss">
+  .workflow-module-dialog {
+    .el-dialog__header {
+      display: none;
+    }
+
+    .el-dialog__body {
+      padding: 0;
+      overflow: hidden;
+    }
+
+    .el-dialog__footer {
+      padding: 12px 22px;
+      border-top: 1px solid #d9e8e2;
+      background: #f8fafc;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/system/workflow/process/index.vue b/web-admin/src/views/system/workflow/process/index.vue
new file mode 100644
index 00000000..8ce78588
--- /dev/null
+++ b/web-admin/src/views/system/workflow/process/index.vue
@@ -0,0 +1,352 @@
+<!-- 流程定义管理 -->
+<!-- eslint-disable vue/no-v-model-argument -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>流程管理</h1>
+      <p class="page-desc">管理审批流程定义，支持图形化设计、版本发布与启停控制。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">流程列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input
+                v-model="searchForm.keyword"
+                placeholder="流程名称/编码"
+                clearable
+                @keyup.enter="handleSearch"
+              />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按流程名称、编码模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"><el-icon><RefreshLeft /></el-icon>重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch"><el-icon><Search /></el-icon>搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-toolbar">
+        <div class="list-toolbar-row">
+          <div class="list-toolbar-selected">
+            已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
+          </div>
+          <el-button class="btn-main" type="primary" @click="handleAdd">
+            <el-icon><Plus /></el-icon>
+            新增流程
+          </el-button>
+          <el-button
+            class="btn-ghost"
+            type="danger"
+            :disabled="selectedRows.length === 0"
+            @click="handleBatchDelete"
+          >
+            <el-icon><Delete /></el-icon>
+            批量删除
+          </el-button>
+        </div>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+          @selection-change="handleSelectionChange"
+        >
+          <el-table-column type="selection" width="55" align="center" header-align="center" />
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="processCode"
+            label="流程编码"
+            width="150"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="processName"
+            label="流程名称"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="状态" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-switch
+                :model-value="row.status"
+                active-value="1"
+                inactive-value="0"
+                @change="(val) => handleStatusChange(row, val)"
+              />
+            </template>
+          </el-table-column>
+          <el-table-column label="最新版本" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              {{ row.latestVersion != null ? `V${row.latestVersion}` : '--' }}
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="createTime"
+            label="创建时间"
+            width="160"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="操作" width="400" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="handleDesign(row)"><el-icon><SetUp /></el-icon>流程设计</el-button>
+              <el-button class="btn-op-item" @click="handleEdit(row)"><el-icon><Edit /></el-icon>编辑</el-button>
+              <el-button class="btn-op-item" @click="handleDelete(row)"><el-icon><Delete /></el-icon>删除</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 新增/编辑弹窗 -->
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="560px"
+        class="dialog-form-layout"
+        align-center
+        destroy-on-close
+        :close-on-click-modal="false"
+        style="backdrop-filter: none"
+      >
+        <el-form
+          ref="formRef"
+          :model="formData"
+          :rules="formRules"
+          label-position="top"
+          scroll-to-error
+          :scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
+        >
+          <div class="form-grid-2">
+            <el-form-item label="流程编码" prop="processCode">
+              <el-input v-model="formData.processCode" placeholder="请输入流程编码" />
+            </el-form-item>
+            <el-form-item label="流程名称" prop="processName">
+              <el-input v-model="formData.processName" placeholder="请输入流程名称" />
+            </el-form-item>
+            <el-form-item label="备注">
+              <el-input v-model="formData.remark" placeholder="可选" />
+            </el-form-item>
+          </div>
+        </el-form>
+        <template #footer>
+          <el-button class="btn-ghost" @click="dialogVisible = false">
+            <el-icon><Close /></el-icon>
+            取消
+          </el-button>
+          <el-button class="btn-main" type="primary" :loading="submitLoading" @click="handleSubmit">
+            <el-icon><Check /></el-icon>
+            确定
+          </el-button>
+        </template>
+      </el-dialog>
+    </section>
+
+    <!-- 流程设计器 -->
+    <FlowDesigner
+      v-model:visible="designerVisible"
+      :process-def-id="designerDefId"
+      :process-name="designerDefName"
+      @saved="handleDesignerSaved"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Plus, Close, Check, Search, RefreshLeft, Delete, SetUp, Edit } from '@element-plus/icons-vue'
+  import { withFullscreenLoading, fullscreenLoadingText } from '@/utils/fullscreen-loading'
+  import {
+    fetchProcessDefList,
+    fetchCreateProcessDef,
+    fetchUpdateProcessDef,
+    fetchDeleteProcessDef
+  } from '@/api/workflow'
+  import FlowDesigner from '../designer/FlowDesigner.vue'
+
+  defineOptions({ name: 'WorkflowProcess' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.Workflow.ProcessDefItem[]>([])
+  const selectedRows = ref<Api.Workflow.ProcessDefItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  // 新增/编辑
+  const dialogVisible = ref(false)
+  const dialogTitle = ref('新增流程')
+  const isEdit = ref(false)
+  const submitLoading = ref(false)
+  const formRef = ref()
+  const editingId = ref<string | null>(null)
+
+  const formData = reactive({
+    processCode: '',
+    processName: '',
+    orderNum: 0,
+    remark: ''
+  })
+
+  const formRules = {
+    processCode: [{ required: true, message: '请输入流程编码', trigger: 'blur' }],
+    processName: [{ required: true, message: '请输入流程名称', trigger: 'blur' }]
+  }
+
+  // 设计器
+  const designerVisible = ref(false)
+  const designerDefId = ref('')
+  const designerDefName = ref('')
+
+  const handleSelectionChange = (rows: Api.Workflow.ProcessDefItem[]) => {
+    selectedRows.value = rows
+  }
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchProcessDefList({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function resetForm() {
+    formData.processCode = ''
+    formData.processName = ''
+    formData.orderNum = 0
+    formData.remark = ''
+    editingId.value = null
+  }
+
+  function handleAdd() {
+    isEdit.value = false
+    dialogTitle.value = '新增流程'
+    resetForm()
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  function handleEdit(row: Api.Workflow.ProcessDefItem) {
+    isEdit.value = true
+    dialogTitle.value = '编辑流程'
+    editingId.value = row.id
+    formData.processCode = row.processCode || ''
+    formData.processName = row.processName || ''
+    formData.orderNum = row.orderNum ?? 0
+    formData.remark = row.remark || ''
+    dialogVisible.value = true
+    formRef.value?.clearValidate?.()
+  }
+
+  async function handleSubmit() {
+    await formRef.value?.validate?.()
+    submitLoading.value = true
+    try {
+      const payload = {
+        processCode: formData.processCode.trim(),
+        processName: formData.processName.trim(),
+        orderNum: formData.orderNum,
+        remark: formData.remark?.trim() || undefined
+      }
+      if (isEdit.value && editingId.value) {
+        await fetchUpdateProcessDef(editingId.value, payload)
+      } else {
+        await fetchCreateProcessDef(payload)
+      }
+      dialogVisible.value = false
+      await loadData()
+    } catch {
+      // 校验或接口错误已由全局处理
+    } finally {
+      submitLoading.value = false
+    }
+  }
+
+  async function handleStatusChange(row: Api.Workflow.ProcessDefItem, val: string | number | boolean) {
+    const newStatus = String(val)
+    await fetchUpdateProcessDef(row.id, { status: newStatus })
+    await loadData()
+  }
+
+  async function handleDelete(row: Api.Workflow.ProcessDefItem) {
+    await ElMessageBox.confirm('确定要删除该流程吗？', '提示', { type: 'warning' })
+    await fetchDeleteProcessDef(row.id)
+    await loadData()
+  }
+
+  async function handleBatchDelete() {
+    const ids = selectedRows.value.map((r) => r.id)
+    if (!ids.length) return
+    await ElMessageBox.confirm(`确定删除选中的 ${ids.length} 个流程吗？`, '提示', { type: 'warning' })
+    await withFullscreenLoading(async () => {
+      for (const id of ids) {
+        await fetchDeleteProcessDef(id)
+      }
+      ElMessage.success('批量删除成功')
+      selectedRows.value = []
+      await loadData()
+    }, fullscreenLoadingText.batchDelete)
+  }
+
+  function handleDesign(row: Api.Workflow.ProcessDefItem) {
+    designerDefId.value = row.id
+    designerDefName.value = row.processName
+    designerVisible.value = true
+  }
+
+  function handleDesignerSaved() {
+    loadData()
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
diff --git a/web-admin/src/views/system/workflow/task-completed/index.vue b/web-admin/src/views/system/workflow/task-completed/index.vue
new file mode 100644
index 00000000..3396fa3d
--- /dev/null
+++ b/web-admin/src/views/system/workflow/task-completed/index.vue
@@ -0,0 +1,532 @@
+<!-- 已办任务 -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>已办任务</h1>
+      <p class="page-desc">查看已处理的审批任务及审批结果。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">已办列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input
+                v-model="searchForm.keyword"
+                placeholder="流程名称"
+                clearable
+                @keyup.enter="handleSearch"
+              />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按流程名称模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"><el-icon><RefreshLeft /></el-icon>重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch"><el-icon><Search /></el-icon>搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+        >
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="processName"
+            label="流程名称"
+            min-width="160"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="businessTypeLabel"
+            label="业务类型"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="businessId"
+            label="业务单号"
+            min-width="200"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="starterUserName"
+            label="发起人"
+            width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="审批结果" width="100" align="center" header-align="center">
+            <template #default="{ row }">
+              <ProcessStatusTag :status="row.status || ''" />
+            </template>
+          </el-table-column>
+          <el-table-column
+            prop="commentText"
+            label="审批意见"
+            min-width="150"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="updateTime"
+            label="审批时间"
+            min-width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="handleViewDetail(row)"><el-icon><View /></el-icon>查看详情</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 详情弹窗 -->
+      <el-dialog
+        v-model="detailVisible"
+        width="720px"
+        class="workflow-module-dialog"
+        align-center
+        destroy-on-close
+        :show-close="false"
+        style="backdrop-filter: none"
+      >
+        <div v-loading="detailLoading" class="dialog-scroll">
+          <template v-if="detailData">
+            <div class="view-hero">
+              <div class="view-hero-icon">
+                <el-icon :size="28"><Document /></el-icon>
+              </div>
+              <div class="view-hero-main">
+                <h2>{{ detailData.processName || '流程详情' }}</h2>
+                <div class="view-hero-tags">
+                  <ProcessStatusTag :status="detailData.status || ''" />
+                  <el-tag size="small" type="info">{{ detailData.businessTypeLabel || detailData.businessType || '--' }}</el-tag>
+                </div>
+                <p class="view-hero-meta">
+                  发起人：{{ detailData.starterUserName || '--' }}
+                  <span class="dot">·</span>
+                  业务单号：{{ detailData.businessId || '--' }}
+                  <span class="dot">·</span>
+                  {{ detailData.createTime || '--' }}
+                </p>
+              </div>
+            </div>
+
+            <div v-if="detailData.businessFormFields && detailData.businessFormFields.length" class="view-section">
+              <h3>申请信息</h3>
+              <dl class="view-kv-grid">
+                <div v-for="field in detailData.businessFormFields" :key="field.label" class="view-kv">
+                  <dt>{{ field.label }}</dt>
+                  <dd>{{ field.value || '--' }}</dd>
+                </div>
+              </dl>
+            </div>
+
+            <div v-if="detailData.tasks && detailData.tasks.length" class="view-section">
+              <h3>审批节点</h3>
+              <div class="htl-scroll">
+                <div class="htl">
+                  <div
+                    v-for="(task, idx) in detailData.tasks"
+                    :key="idx"
+                    class="htl-item"
+                    :class="getTimelineStatusClass(task.status)"
+                  >
+                    <div class="htl-rail">
+                      <span class="htl-node" />
+                      <span v-if="idx < detailData.tasks.length - 1" class="htl-line" />
+                    </div>
+                    <div class="htl-body">
+                      <div class="htl-name">{{ task.nodeName || '--' }}</div>
+                      <div class="htl-user">{{ task.assigneeUserName || '--' }}</div>
+                      <div class="htl-status">
+                        <ProcessStatusTag :status="task.status || ''" />
+                      </div>
+                      <div v-if="task.updateTime" class="htl-time">{{ task.updateTime }}</div>
+                      <div v-if="task.commentText" class="htl-comment">{{ task.commentText }}</div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </template>
+        </div>
+        <template #footer>
+          <el-button class="btn-ghost" @click="detailVisible = false"><el-icon><Close /></el-icon>关闭</el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchCompletedTasks, fetchInstanceDetail } from '@/api/workflow'
+  import ProcessStatusTag from '../components/ProcessStatusTag.vue'
+  import { Document, View, Search, RefreshLeft, Close } from '@element-plus/icons-vue'
+
+  defineOptions({ name: 'WorkflowTaskCompleted' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.Workflow.TaskItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  // 详情
+  const detailVisible = ref(false)
+  const detailLoading = ref(false)
+  const detailData = ref<Api.Workflow.InstanceDetail | null>(null)
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchCompletedTasks({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  async function handleViewDetail(row: Api.Workflow.TaskItem) {
+    detailVisible.value = true
+    detailLoading.value = true
+    detailData.value = null
+    try {
+      const data = await fetchInstanceDetail(row.instanceId)
+      detailData.value = {
+        ...data,
+        processName: row.processName,
+        businessType: row.businessType,
+        businessTypeLabel: row.businessTypeLabel,
+        businessId: row.businessId,
+        starterUserId: row.starterUserId,
+        starterUserName: row.starterUserName,
+      } as Api.Workflow.InstanceDetail & {
+        processName?: string
+        businessType?: string
+        businessTypeLabel?: string
+        businessId?: string
+        starterUserId?: string
+        starterUserName?: string
+      }
+    } catch {
+      // 错误已由全局处理
+    } finally {
+      detailLoading.value = false
+    }
+  }
+
+  function getTimelineStatusClass(status: string) {
+    if (['approved', 'completed'].includes(status)) return 'htl-done'
+    if (['running', 'pending'].includes(status)) return 'htl-active'
+    if (status === 'rejected') return 'htl-reject'
+    return 'htl-muted'
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .dialog-scroll {
+    overflow-y: auto;
+    max-height: calc(100vh - 120px);
+  }
+
+  .view-hero {
+    display: flex;
+    gap: 16px;
+    padding: 20px 22px;
+    background: linear-gradient(135deg, #ecfdf5 0%, #ffffff 55%);
+    border-bottom: 1px solid #d9e8e2;
+    align-items: center;
+  }
+
+  .view-hero-icon {
+    width: 72px;
+    height: 72px;
+    border-radius: 12px;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.08);
+    color: #059669;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  .view-hero-main {
+    flex: 1;
+    min-width: 0;
+
+    h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 700;
+      color: #1e293b;
+      letter-spacing: -0.02em;
+    }
+  }
+
+  .view-hero-tags {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 8px;
+    flex-wrap: wrap;
+  }
+
+  .view-hero-meta {
+    margin: 0;
+    font-size: 13px;
+    color: #64748b;
+    line-height: 1.5;
+
+    .dot {
+      margin: 0 6px;
+      opacity: 0.7;
+    }
+  }
+
+  .view-section {
+    padding: 18px 22px;
+    border-bottom: 1px solid #ebeef5;
+
+    &:last-child {
+      border-bottom: none;
+    }
+
+    h3 {
+      margin: 0 0 14px;
+      font-size: 13px;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      color: #64748b;
+    }
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: 96px 1fr;
+    gap: 8px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  @media (max-width: 640px) {
+    .view-kv-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .view-kv {
+      grid-template-columns: 1fr;
+      gap: 4px;
+    }
+  }
+
+  /* ── horizontal timeline ── */
+  .htl-scroll {
+    overflow-x: auto;
+    padding: 0 0 4px 12px;
+
+    &::-webkit-scrollbar {
+      height: 4px;
+    }
+
+    &::-webkit-scrollbar-thumb {
+      background: #d1d5db;
+      border-radius: 2px;
+    }
+  }
+
+  .htl {
+    display: inline-flex;
+    min-width: 100%;
+  }
+
+  .htl-item {
+    display: flex;
+    flex-direction: column;
+    min-width: 140px;
+    flex: 1 0 140px;
+  }
+
+  /* rail: node circle + connecting line */
+  .htl-rail {
+    position: relative;
+    display: flex;
+    align-items: center;
+    height: 22px;
+  }
+
+  .htl-node {
+    position: relative;
+    z-index: 1;
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    flex-shrink: 0;
+    background: #10b981;
+    border: 2px solid #fff;
+    box-shadow: 0 0 0 1px #10b981;
+  }
+
+  .htl-line {
+    flex: 1;
+    height: 2px;
+    background: #d1d5db;
+    margin-left: 0;
+  }
+
+  .htl-body {
+    padding: 8px 4px 0 0;
+    font-size: 13px;
+    line-height: 1.45;
+  }
+
+  .htl-name {
+    font-weight: 600;
+    color: #1e293b;
+    margin-bottom: 2px;
+  }
+
+  .htl-user {
+    color: #64748b;
+    font-size: 12px;
+    margin-bottom: 4px;
+  }
+
+  .htl-status {
+    margin-bottom: 4px;
+  }
+
+  .htl-time {
+    font-size: 11px;
+    color: #94a3b8;
+    margin-bottom: 2px;
+  }
+
+  .htl-comment {
+    font-size: 12px;
+    color: #64748b;
+    word-break: break-word;
+  }
+
+  /* status variants */
+  .htl-active .htl-node {
+    background: #fff;
+    border: 3px solid #10b981;
+    box-shadow: 0 0 0 2px rgba(16, 185, 129, 0.25);
+  }
+
+  .htl-reject .htl-node {
+    background: #ef4444;
+    border-color: #fff;
+    box-shadow: 0 0 0 1px #ef4444;
+  }
+
+  .htl-muted .htl-node {
+    background: #d1d5db;
+    border-color: #fff;
+    box-shadow: none;
+  }
+
+  .htl-done + .htl-active .htl-line,
+  .htl-done + .htl-done .htl-line {
+    background: #10b981;
+  }
+
+  .htl-active + .htl-done .htl-line {
+    background: #10b981;
+  }
+</style>
+
+<style lang="scss">
+  .workflow-module-dialog {
+    .el-dialog__header {
+      display: none;
+    }
+
+    .el-dialog__body {
+      padding: 0;
+      overflow: hidden;
+    }
+
+    .el-dialog__footer {
+      padding: 12px 22px;
+      border-top: 1px solid #d9e8e2;
+      background: #f8fafc;
+    }
+  }
+</style>
diff --git a/web-admin/src/views/system/workflow/task-pending/index.vue b/web-admin/src/views/system/workflow/task-pending/index.vue
new file mode 100644
index 00000000..50f44051
--- /dev/null
+++ b/web-admin/src/views/system/workflow/task-pending/index.vue
@@ -0,0 +1,545 @@
+<!-- 待办任务 -->
+<template>
+  <div class="page-container">
+    <header class="page-head">
+      <h1>待办任务</h1>
+      <p class="page-desc">查看并处理待审批的工作流任务。</p>
+    </header>
+
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">待办列表</h2>
+      </div>
+
+      <div class="filter-block">
+        <el-form :model="searchForm" class="filter-form" @submit.prevent>
+          <div class="filter-grid">
+            <el-form-item label="关键词">
+              <el-input
+                v-model="searchForm.keyword"
+                placeholder="流程名称"
+                clearable
+                @keyup.enter="handleSearch"
+              />
+            </el-form-item>
+          </div>
+          <div class="filter-actions-row">
+            <span class="filter-hint">按流程名称模糊查询。</span>
+            <div class="filter-actions-end">
+              <el-button class="btn-ghost" @click="handleReset"><el-icon><RefreshLeft /></el-icon>重置</el-button>
+              <el-button class="btn-main" type="primary" @click="handleSearch"><el-icon><Search /></el-icon>搜索</el-button>
+            </div>
+          </div>
+        </el-form>
+      </div>
+
+      <div class="list-body list-wrap">
+        <el-table
+          class="list-table"
+          :data="tableData"
+          v-loading="loading"
+          stripe
+          row-key="id"
+        >
+          <el-table-column
+            type="index"
+            label="序号"
+            width="68"
+            align="center"
+            header-align="center"
+            :index="(index) => (pagination.page - 1) * pagination.pageSize + index + 1"
+          />
+          <el-table-column
+            prop="processName"
+            label="流程名称"
+            width="160"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="businessTypeLabel"
+            label="业务类型"
+            width="120"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="businessId"
+            label="业务单号"
+            min-width="200"
+            align="center"
+            header-align="center"
+            show-overflow-tooltip
+          />
+          <el-table-column
+            prop="starterUserName"
+            label="发起人"
+            width="100"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column
+            prop="createTime"
+            label="到达时间"
+            width="180"
+            align="center"
+            header-align="center"
+          />
+          <el-table-column label="操作" width="260" fixed="right" align="center" header-align="center">
+            <template #default="{ row }">
+              <el-button class="btn-op-item primary" @click="handleApprove(row)"><el-icon><EditPen /></el-icon>审批</el-button>
+              <el-button class="btn-op-item" @click="handleViewDetail(row)"><el-icon><View /></el-icon>查看详情</el-button>
+            </template>
+          </el-table-column>
+        </el-table>
+        <div class="pagination list-pager-bar">
+          <el-pagination
+            :current-page="pagination.page"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            :page-sizes="[10, 20, 50]"
+            layout="total, sizes, prev, pager, next"
+            @size-change="(val) => ((pagination.page = 1), (pagination.pageSize = val), loadData())"
+            @current-change="(val) => ((pagination.page = val), loadData())"
+          />
+        </div>
+      </div>
+
+      <!-- 审批弹窗 -->
+      <ApprovalDialog
+        v-model:visible="approvalVisible"
+        :task-id="approvalTaskId"
+        :instance-id="approvalInstanceId"
+        @done="handleApprovalDone"
+      />
+
+      <!-- 详情弹窗 -->
+      <el-dialog
+        v-model="detailVisible"
+        width="720px"
+        class="workflow-module-dialog"
+        align-center
+        destroy-on-close
+        :show-close="false"
+        style="backdrop-filter: none"
+      >
+        <div v-loading="detailLoading" class="dialog-scroll">
+          <template v-if="detailData">
+            <div class="view-hero">
+              <div class="view-hero-icon">
+                <el-icon :size="28"><Document /></el-icon>
+              </div>
+              <div class="view-hero-main">
+                <h2>{{ detailData.processName || '流程详情' }}</h2>
+                <div class="view-hero-tags">
+                  <ProcessStatusTag :status="detailData.status || ''" />
+                  <el-tag size="small" type="info">{{ detailData.businessTypeLabel || detailData.businessType || '--' }}</el-tag>
+                </div>
+                <p class="view-hero-meta">
+                  发起人：{{ detailData.starterUserName || '--' }}
+                  <span class="dot">·</span>
+                  业务单号：{{ detailData.businessId || '--' }}
+                  <span class="dot">·</span>
+                  {{ detailData.createTime || '--' }}
+                </p>
+              </div>
+            </div>
+
+            <div v-if="detailData.businessFormFields && detailData.businessFormFields.length" class="view-section">
+              <h3>申请信息</h3>
+              <dl class="view-kv-grid">
+                <div v-for="field in detailData.businessFormFields" :key="field.label" class="view-kv">
+                  <dt>{{ field.label }}</dt>
+                  <dd>{{ field.value || '--' }}</dd>
+                </div>
+              </dl>
+            </div>
+
+            <div v-if="detailData.tasks && detailData.tasks.length" class="view-section">
+              <h3>审批节点</h3>
+              <div class="htl-scroll">
+                <div class="htl">
+                  <div
+                    v-for="(task, idx) in detailData.tasks"
+                    :key="idx"
+                    class="htl-item"
+                    :class="getTimelineStatusClass(task.status)"
+                  >
+                    <div class="htl-rail">
+                      <span class="htl-node" />
+                      <span v-if="idx < detailData.tasks.length - 1" class="htl-line" />
+                    </div>
+                    <div class="htl-body">
+                      <div class="htl-name">{{ task.nodeName || '--' }}</div>
+                      <div class="htl-user">{{ task.assigneeUserName || '--' }}</div>
+                      <div class="htl-status">
+                        <ProcessStatusTag :status="task.status || ''" />
+                      </div>
+                      <div v-if="task.updateTime" class="htl-time">{{ task.updateTime }}</div>
+                      <div v-if="task.commentText" class="htl-comment">{{ task.commentText }}</div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </template>
+        </div>
+        <template #footer>
+          <el-button class="btn-ghost" @click="detailVisible = false"><el-icon><Close /></el-icon>关闭</el-button>
+        </template>
+      </el-dialog>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchPendingTasks, fetchInstanceDetail } from '@/api/workflow'
+  import ApprovalDialog from '../components/ApprovalDialog.vue'
+  import ProcessStatusTag from '../components/ProcessStatusTag.vue'
+  import { Document, EditPen, View, Search, RefreshLeft, Close } from '@element-plus/icons-vue'
+
+  defineOptions({ name: 'WorkflowTaskPending' })
+
+  const searchForm = reactive<{ keyword: string }>({ keyword: '' })
+  const tableData = ref<Api.Workflow.TaskItem[]>([])
+  const loading = ref(false)
+  const pagination = reactive({ page: 1, pageSize: 10, total: 0 })
+
+  // 审批
+  const approvalVisible = ref(false)
+  const approvalTaskId = ref('')
+  const approvalInstanceId = ref('')
+
+  // 详情
+  const detailVisible = ref(false)
+  const detailLoading = ref(false)
+  const detailData = ref<Api.Workflow.InstanceDetail | null>(null)
+
+  async function loadData() {
+    loading.value = true
+    try {
+      const res = await fetchPendingTasks({
+        page: pagination.page,
+        pageSize: pagination.pageSize,
+        keyword: searchForm.keyword || undefined
+      })
+      tableData.value = res.list || []
+      pagination.total = res.total ?? 0
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function handleSearch() {
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleReset() {
+    searchForm.keyword = ''
+    pagination.page = 1
+    loadData()
+  }
+
+  function handleApprove(row: Api.Workflow.TaskItem) {
+    approvalTaskId.value = row.id
+    approvalInstanceId.value = row.instanceId || ''
+    approvalVisible.value = true
+  }
+
+  function handleApprovalDone() {
+    loadData()
+  }
+
+  async function handleViewDetail(row: Api.Workflow.TaskItem) {
+    detailVisible.value = true
+    detailLoading.value = true
+    detailData.value = null
+    try {
+      const data = await fetchInstanceDetail(row.instanceId)
+      detailData.value = {
+        ...data,
+        processName: row.processName,
+        businessType: row.businessType,
+        businessTypeLabel: row.businessTypeLabel,
+        businessId: row.businessId,
+        starterUserId: row.starterUserId,
+        starterUserName: row.starterUserName,
+      } as Api.Workflow.InstanceDetail & {
+        processName?: string
+        businessType?: string
+        businessTypeLabel?: string
+        businessId?: string
+        starterUserId?: string
+        starterUserName?: string
+      }
+    } catch {
+      // 错误已由全局处理
+    } finally {
+      detailLoading.value = false
+    }
+  }
+
+  function getTimelineStatusClass(status: string) {
+    if (['approved', 'completed'].includes(status)) return 'htl-done'
+    if (['running', 'pending'].includes(status)) return 'htl-active'
+    if (status === 'rejected') return 'htl-reject'
+    return 'htl-muted'
+  }
+
+  onMounted(() => {
+    loadData()
+  })
+</script>
+
+<style scoped lang="scss">
+  .dialog-scroll {
+    overflow-y: auto;
+    max-height: calc(100vh - 120px);
+  }
+
+  .view-hero {
+    display: flex;
+    gap: 16px;
+    padding: 20px 22px;
+    background: linear-gradient(135deg, #ecfdf5 0%, #ffffff 55%);
+    border-bottom: 1px solid #d9e8e2;
+    align-items: center;
+  }
+
+  .view-hero-icon {
+    width: 72px;
+    height: 72px;
+    border-radius: 12px;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.08);
+    color: #059669;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  .view-hero-main {
+    flex: 1;
+    min-width: 0;
+
+    h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 700;
+      color: #1e293b;
+      letter-spacing: -0.02em;
+    }
+  }
+
+  .view-hero-tags {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 8px;
+    flex-wrap: wrap;
+  }
+
+  .view-hero-meta {
+    margin: 0;
+    font-size: 13px;
+    color: #64748b;
+    line-height: 1.5;
+
+    .dot {
+      margin: 0 6px;
+      opacity: 0.7;
+    }
+  }
+
+  .view-section {
+    padding: 18px 22px;
+    border-bottom: 1px solid #ebeef5;
+
+    &:last-child {
+      border-bottom: none;
+    }
+
+    h3 {
+      margin: 0 0 14px;
+      font-size: 13px;
+      font-weight: 700;
+      letter-spacing: 0.06em;
+      color: #64748b;
+    }
+  }
+
+  .view-kv-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px 28px;
+  }
+
+  .view-kv {
+    display: grid;
+    grid-template-columns: 96px 1fr;
+    gap: 8px 12px;
+    font-size: 13px;
+    align-items: start;
+
+    dt {
+      margin: 0;
+      color: #64748b;
+      font-weight: 500;
+    }
+
+    dd {
+      margin: 0;
+      color: #1e293b;
+      word-break: break-word;
+    }
+  }
+
+  @media (max-width: 640px) {
+    .view-kv-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .view-kv {
+      grid-template-columns: 1fr;
+      gap: 4px;
+    }
+  }
+
+  /* ── horizontal timeline ── */
+  .htl-scroll {
+    overflow-x: auto;
+    padding: 0 0 4px 12px;
+
+    &::-webkit-scrollbar {
+      height: 4px;
+    }
+
+    &::-webkit-scrollbar-thumb {
+      background: #d1d5db;
+      border-radius: 2px;
+    }
+  }
+
+  .htl {
+    display: inline-flex;
+    min-width: 100%;
+  }
+
+  .htl-item {
+    display: flex;
+    flex-direction: column;
+    min-width: 140px;
+    flex: 1 0 140px;
+  }
+
+  /* rail: node circle + connecting line */
+  .htl-rail {
+    position: relative;
+    display: flex;
+    align-items: center;
+    height: 22px;
+  }
+
+  .htl-node {
+    position: relative;
+    z-index: 1;
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    flex-shrink: 0;
+    background: #10b981;
+    border: 2px solid #fff;
+    box-shadow: 0 0 0 1px #10b981;
+  }
+
+  .htl-line {
+    flex: 1;
+    height: 2px;
+    background: #d1d5db;
+    margin-left: 0;
+  }
+
+  .htl-body {
+    padding: 8px 4px 0 0;
+    font-size: 13px;
+    line-height: 1.45;
+  }
+
+  .htl-name {
+    font-weight: 600;
+    color: #1e293b;
+    margin-bottom: 2px;
+  }
+
+  .htl-user {
+    color: #64748b;
+    font-size: 12px;
+    margin-bottom: 4px;
+  }
+
+  .htl-status {
+    margin-bottom: 4px;
+  }
+
+  .htl-time {
+    font-size: 11px;
+    color: #94a3b8;
+    margin-bottom: 2px;
+  }
+
+  .htl-comment {
+    font-size: 12px;
+    color: #64748b;
+    word-break: break-word;
+  }
+
+  /* status variants */
+  .htl-active .htl-node {
+    background: #fff;
+    border: 3px solid #10b981;
+    box-shadow: 0 0 0 2px rgba(16, 185, 129, 0.25);
+  }
+
+  .htl-reject .htl-node {
+    background: #ef4444;
+    border-color: #fff;
+    box-shadow: 0 0 0 1px #ef4444;
+  }
+
+  .htl-muted .htl-node {
+    background: #d1d5db;
+    border-color: #fff;
+    box-shadow: none;
+  }
+
+  .htl-done + .htl-active .htl-line,
+  .htl-done + .htl-done .htl-line {
+    background: #10b981;
+  }
+
+  .htl-active + .htl-done .htl-line {
+    background: #10b981;
+  }
+</style>
+
+<style lang="scss">
+  .workflow-module-dialog {
+    .el-dialog__header {
+      display: none;
+    }
+
+    .el-dialog__body {
+      padding: 0;
+      overflow: hidden;
+    }
+
+    .el-dialog__footer {
+      padding: 12px 22px;
+      border-top: 1px solid #d9e8e2;
+      background: #f8fafc;
+    }
+  }
+</style>
diff --git a/代码助手.md b/代码助手.md
deleted file mode 100644
index 5c381b0d..00000000
--- a/代码助手.md
+++ /dev/null
@@ -1,125 +0,0 @@
-# 代码助手（zkxw）— 五步工作流 × Superpowers × OpenSpec
-
-在 Cursor / Agent 对话中 **`@代码助手.md`**（建议同时 **`@AGENTS.md`**），必要时再 **`@`** 本次 **`openspec/changes/<变更名>/`** 下的 `proposal.md`、`tasks.md` 等，使助手按本文节奏执行。
-
-**指令优先级**：你在对话中的明确要求 > `AGENTS.md` / `.cursorrules` > **本文件** > Superpowers 技能 > 默认行为。技能与项目 SHALL 冲突时，以项目文档与 OpenSpec spec 为准。若你写明「跳过某步 / 不建 OpenSpec」，仅对**当句及你明确指明的范围**生效。
-
----
-
-## 当本文件已在上下文中时：会话契约（拉近「自动流程」）
-
-下列约定在**本文件已被读取**（例如用户 **`@代码助手.md`**）且用户请求涉及**实现、开发、新增、改造、修复、做功能**时，助手 **MUST** 遵守；除非用户在同一条消息里**明确**覆盖（例如「只改拼写、不要 OpenSpec」「允许直接改代码」）。
-
-### 对「帮我实现 XXX」类请求的默认认定
-
-- 默认按 **完整五步 + OpenSpec 变更（若无则先创建）** 处理；不把「实现」理解为「立刻堆代码」。
-- **首轮不得**批量修改业务代码、新建多文件路由/API，除非用户已声明「极小改动」且满足下文「压缩流程」条件。
-
-### 首轮回复 MUST 依次交代（建议用小标题列出，便于你扫读）
-
-1. **当前阶段**：写明处于五步中第几步（通常从第一步或第二步开始）。
-2. **目标复述**：一句话重述要做的 XXX。
-3. **待确认问题**：逐条列出仍不清晰处；没有则写「无，可继续」。
-4. **OpenSpec**：若已有变更，写出目录 **`openspec/changes/<kebab-name>/`**；若无，**建议 `kebab-case` 变更名** 并说明将执行 `openspec new change` 或按 `.cursor/skills/openspec-propose/SKILL.md` 补齐制品。
-5. **下一步**：唯一、可执行的具体动作（例如先问清验收，或跑 `openspec status` / `openspec instructions apply`）。
-
-### 硬性门禁（助手 MUST NOT）
-
-| 在未满足条件前 | 禁止 |
-|----------------|------|
-| 需求边界、验收方式仍含混且用户未确认 | 大篇幅编写 `tasks.md`、直接改 API/库表/核心业务 |
-| 本次走 OpenSpec，但尚未读完 **`openspec instructions apply --change "<名>" --json`** 返回的 **全部 `contextFiles`** | 开始本次变更的**主要实现编码**（除为跑通 CLI 的微小编排外） |
-| 当前 `tasks.md` 条目未约定本条的可验证方式（见第四步：测试或等价检查） | 为该条编写「为通过验收服务」的生产代码 |
-| 未运行 **`AGENTS.md`** 中与本次改动相关的验证命令 | 下「已完成」「没问题」「全部搞定」等**完成断言** |
-
-### 每一批改动提交前：自检三问（心中执行，复杂时写入回复）
-
-1. 上一小步的 **lint / test / build**（以 `AGENTS.md` 为准）是否已通过？  
-2. 是否只推进 **`tasks.md` 中一项或一小块**？  
-3. 行为是否与 **`spec.md` 的 `#### Scenario`**（若有）一致？
-
-### 压缩流程（仅当用户明确声明时）
-
-用户写清「单文件小改、不动接口与权限 / 仅文案或格式」等，可 **不新建 OpenSpec 变更**，但仍须：**说明影响面 + 运行相关验证命令 + 不满足上表最后一行门禁**。
-
----
-
-## 总览：五步与 OpenSpec、Superpowers 的对应关系
-
-| 步骤 | 你要达到的状态 | OpenSpec（制品 / 动作） | Superpowers（建议 @ 的技能） |
-|------|----------------|------------------------|------------------------------|
-| 一 | 需求清晰，不清楚就问清 | `proposal.md` 定边界；必要时新建变更 `openspec new change "<kebab-name>"` | `.agents/skills/brainstorming/SKILL.md` |
-| 二 | 懂框架、规范、参考案例 | 读 `openspec/config.yaml` 的 context；apply 前读 **`openspec instructions apply --change "<名>" --json`** 返回的 **全部 `contextFiles`**（含 `proposal`、`specs/**/spec.md`、`design`、`tasks`） | `.agents/skills/using-superpowers/SKILL.md`（何时加载其他技能） |
-| 三 | 分步实现思路 | `design.md` + **`tasks.md` 拆条**；依赖用 `openspec status --change "<名>" --json` 看顺序 | `.agents/skills/writing-plans/SKILL.md` |
-| 四 | 测试驱动开发 | 每条 task 落地时：**先测后码**；行为写在 spec 的 Scenario 里，测试与之对齐 | `.agents/skills/test-driven-development/SKILL.md` |
-| 五 | 开发—验证循环直到完成 | 按 `tasks.md` 逐项勾选；每步跑约定验证；全完后 **`openspec-archive-change`** / 归档流程 | `.agents/skills/verification-before-completion/SKILL.md` |
-
-**OpenSpec 技能入口（本仓库）**：`.cursor/skills/openspec-propose/SKILL.md`（立项与生成制品）、`.cursor/skills/openspec-apply-change/SKILL.md`（按 tasks 实现）、`.cursor/skills/openspec-explore/SKILL.md`、`.cursor/skills/openspec-archive-change/SKILL.md`；命令说明见 `.cursor/commands/opsx-*.md`。
-
----
-
-## 第一步：必须清楚「要干啥」— 不清晰就反馈、对齐后再写代码
-
-- **产出**：口头/文档无歧义；对应 OpenSpec 里 **`proposal.md`**（做什么、不做什么、Capabilities 与后续 `specs/<能力>/spec.md` 一一对应）。
-- **权威交叉**：`docs/中科兴皖需求V0.3.md`；Web / 小程序 UI 分别以 `docs/web-admin-ui-spec-fresh-mint.md`、`docs/miniprogram-ui-spec-sanqiang.md` 为准。
-- **Superpowers**：需求或方案未定型时，先 **@`.agents/skills/brainstorming/SKILL.md`**，再进入写 proposal / 拆 spec。
-- **禁止**：在需求含混时直接大改 `tasks.md` 或批量改业务代码。
-
----
-
-## 第二步：掌握项目框架、规范与参考案例
-
-- **工程与 monorepo**：以 **`AGENTS.md`** 为准（后端 `backend/`、管理端 `web-admin/`、小程序 `miniprogram/` 等）。
-- **SHALL 级规范**：`.cursor/rules/openspec-zkxw-standards.mdc`；活跃变更下 **`openspec/changes/*/specs/*/spec.md`**；若已归档则 **`openspec/specs/`** 为基线，与 `changes/` 并存时 **以 `openspec/specs/` 为准**。
-- **进入实现前**：执行 **`openspec instructions apply --change "<变更名>" --json`**，阅读返回的 **全部 `contextFiles`**，不得跳过。
-- **Web 管理端界面模板**（新页面对照，勿另起一套）：`web-admin/src/views/system/unit|order|product|category|user/index.vue` 等（路由与菜单见 `AGENTS.md` / `.cursorrules`）。
-- **树路径等业务约定**：`web-admin/src/utils/tree-path.ts`；弹窗与列表细节：`.cursor/rules/web-admin-crud-dialog.mdc`。
-
----
-
-## 第三步：整理实现思路 — 坚持分步实施
-
-- **产出**：**`design.md`**（如何做）+ **`tasks.md`**（可执行、可勾选、粒度适合单 PR 或单会话块）。
-- **顺序**：用 **`openspec status --change "<变更名>" --json`** 看制品依赖与 `applyRequires`，缺什么先补什么，再进入大量编码。
-- **Superpowers**：多步骤任务在写 `tasks.md` 前可 **@`.agents/skills/writing-plans/SKILL.md`**，保证「一步一事」、依赖清晰。
-- **原则**：实现只推进 **`tasks.md` 当前项**；避免无关重构与范围蔓延。
-
----
-
-## 第四步：测试驱动开发（TDD）
-
-- **Superpowers**：实现或修 Bug 写生产代码前 **@`.agents/skills/test-driven-development/SKILL.md`**，遵循 Red → Green → Refactor；先看到**有意义的失败**再写最少通过代码。
-- **与 OpenSpec 对齐**：**`spec.md` 中 `#### Scenario`** 描述可验收行为；自动化测试（或本项目约定的可重复检查）应能指向这些场景。若某层（如纯 UI）难以单测，在 `tasks.md` 或对话中**显式约定**可替代的验证方式（例如 E2E、手工 checklist），并与用户确认——**不得默认定「不写测」**。
-
----
-
-## 第五步：开发与验证循环，直到目标完成
-
-- **开发**：严格按 **`tasks.md`** 逐项完成；需要并行子任务时可参考 **@`.agents/skills/dispatching-parallel-agents/SKILL.md`** 或 **@`.agents/skills/subagent-driven-development/SKILL.md`**（与当前环境是否支持子代理一致）。
-- **验证**：每步完成后跑项目约定命令（见 **`AGENTS.md`**，如 `web-admin` 的 `pnpm lint`、`pnpm build:typecheck`，后端 `pytest` 等）。声称完成前 **@`.agents/skills/verification-before-completion/SKILL.md`**，**有命令输出再下结论**。
-- **收尾**：变更完成后走 OpenSpec **归档**（**@`.cursor/skills/openspec-archive-change/SKILL.md`** 或仓库文档中的 archive 流程），使基线与 `openspec/specs/` 同步。
-
----
-
-## 对话里可复制的「开任务」示例
-
-**精简（你已习惯流程时）：**
-
-> @代码助手.md @AGENTS.md  
-> OpenSpec 变更：`<kebab-change-name>`。请按五步：先对齐 proposal/spec 中未决点；再读 apply 的 contextFiles；按 tasks 分步执行；每步 TDD；每步验证；最后对照 spec 与需求文档自检。
-
-**严格（更接近自动流程，只 @ 代码助手时推荐附带）：**
-
-> @代码助手.md @AGENTS.md  
-> 帮我实现：XXX（验收：……；端：web-admin / 后端 / 小程序；是否新建 OpenSpec 变更：是/否；若否请说明原因）。  
-> 你必须遵守根目录 `代码助手.md` 中的**会话契约**：首轮只对齐阶段与缺口，不得直接大改代码；有变更名则 `openspec instructions apply --change "<名>" --json` 并读完所有 contextFiles 后再实现；每 task 先 TDD 或等价验收约定；每步跑 `AGENTS.md` 中的验证命令后再断言完成。
-
-**说明**：Cursor **不会**在后台替你执行命令；「自动」指模型**必须**按上文契约与五步组织行为。你仍可用 **`/opsx-propose`**、**`/opsx-apply`** 等命令（见 `.cursor/commands/opsx-*.md`）减少口述步骤。
-
----
-
-## 维护说明
-
-- 变更 OpenSpec 目录结构或 CLI 子命令时，同步更新本文「OpenSpec」小节与 `openspec/config.yaml` 中的 **context** 摘要。
-- Superpowers 技能路径以仓库 **`.agents/skills/`** 为准；若本机安装位置不同，在对话中用实际可 `@` 的路径替换即可。
-- **边界**：本文提高模型**遵守流程的概率**，不是 IDE 插件或 CI 强制门禁；若要更强约束，可把「会话契约」摘要写入 **`.cursor/rules/*.mdc`（alwaysApply）** 或使用 **`.cursor/commands/`** 固定组合 `@` 与口令。
diff --git a/民族.sql b/民族.sql
new file mode 100644
index 00000000..b4ab55ee
--- /dev/null
+++ b/民族.sql
@@ -0,0 +1,118 @@
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (1, '汉族', '01');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (2, '蒙古族', '02');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (3, '回族', '03');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (4, '藏族', '04');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (5, '维吾尔族', '05');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (6, '苗族', '06');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (7, '彝族', '07');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (8, '壮族', '08');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (9, '布依族', '09');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (10, '朝鲜族', '10');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (11, '满族', '11');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (12, '侗族', '12');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (13, '瑶族', '13');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (14, '白族', '14');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (15, '土家族', '15');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (16, '哈尼族', '16');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (17, '哈萨克族', '17');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (18, '傣族', '18');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (19, '黎族', '19');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (20, '傈僳族', '20');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (21, '佤族', '21');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (22, '畲族', '22');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (23, '高山族', '23');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (24, '拉祜族', '24');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (25, '水族', '25');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (26, '东乡族', '26');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (27, '纳西族', '27');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (28, '景颇族', '28');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (29, '柯尔克孜族', '29');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (30, '土族', '30');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (31, '达斡尔族', '31');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (32, '仫佬族', '32');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (33, '羌族', '33');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (34, '布朗族', '34');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (35, '撒拉族', '35');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (36, '毛难族', '36');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (37, '仡佬族', '37');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (38, '锡伯族', '38');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (39, '阿昌族', '39');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (40, '普米族', '40');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (41, '塔吉克族', '41');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (42, '怒族', '42');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (43, '乌孜别克族', '43');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (44, '俄罗斯族', '44');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (45, '鄂温克族', '45');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (46, '德昂族', '46');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (47, '保安族', '47');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (48, '裕固族', '48');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (49, '京族', '49');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (50, '塔塔尔族', '50');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (51, '独龙族', '51');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (52, '鄂伦春族', '52');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (53, '赫哲族', '53');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (54, '门巴族', '54');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (55, '珞巴族', '55');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (56, '基诺族', '56');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (57, '穿青人族', '81');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (58, '其他', '97');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (59, '外国血统中国籍人士', '98');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (60, '阿昌族', 'AC');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (61, '白族', 'BA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (62, '布朗族', 'BL');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (63, '保安族', 'BN');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (64, '布依族', 'BY');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (65, '穿青人族', 'CQ');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (66, '朝鲜族', 'CS');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (67, '傣族', 'DA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (68, '德昂族', 'DE');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (69, '侗族', 'DO');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (70, '独龙族', 'DR');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (71, '达斡尔族', 'DU');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (72, '东乡族', 'DX');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (73, '鄂温克族', 'EW');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (74, '京族', 'GI');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (75, '仡佬族', 'GL');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (76, '高山族', 'GS');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (77, '汉族', 'HA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (78, '哈尼族', 'HN');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (79, '回族', 'HU');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (80, '赫哲族', 'HZ');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (81, '基诺族', 'JN');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (82, '景颇族', 'JP');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (83, '柯尔克孜族', 'KG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (84, '哈萨克族', 'KZ');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (85, '珞巴族', 'LB');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (86, '拉祜族', 'LG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (87, '黎族', 'LI');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (88, '傈僳族', 'LS');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (89, '满族', 'MA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (90, '门巴族', 'MB');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (91, '蒙古族', 'MG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (92, '苗族', 'MH');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (93, '仫佬族', 'ML');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (94, '毛难族', 'MN');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (95, '怒族', 'NU');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (96, '纳西族', 'NX');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (97, '鄂伦春族', 'OR');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (98, '普米族', 'PM');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (99, '羌族', 'QI');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (100, '其他', 'QT');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (101, '俄罗斯族', 'RS');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (102, '畲族', 'SH');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (103, '撒拉族', 'SL');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (104, '水族', 'SU');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (105, '塔吉克族', 'TA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (106, '土家族', 'TJ');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (107, '塔塔尔族', 'TT');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (108, '土族', 'TU');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (109, '维吾尔族', 'UG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (110, '乌孜别克族', 'UZ');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (111, '佤族', 'VA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (112, '外国血统中国籍人士', 'WG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (113, '锡伯族', 'XB');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (114, '瑶族', 'YA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (115, '裕固族', 'YG');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (116, '彝族', 'YI');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (117, '藏族', 'ZA');
+INSERT INTO `` (`dict_sort`, `dict_label`, `dict_value`) VALUES (118, '壮族', 'ZH');
\ No newline at end of file