From d0af9d481c1a7dc42c155dfcb8a3934e0ac0f252 Mon Sep 17 00:00:00 2001
From: chenxing <chenxing@bestsch.com>
Date: Sat, 17 Oct 2026 23:44:18 +0800
Subject: [PATCH] =?UTF-8?q?[ysch-flow]=20S3.1~S3.2=20=E6=8E=A5=E5=85=A5=20?=
 =?UTF-8?q?ysch-flow=20starter=20=E5=B9=B6=E5=A3=B0=E6=98=8E=20yh.flow-biz?=
 =?UTF-8?q?=20=E8=AF=AD=E4=B9=89=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

依赖不写版本（BOM 托管）；存量 callback 件显式声明保留（回退绳类仍需其 SPI 类型）。
yaml 增 biz-type=notice、四态码 10/20/30/40（取 FlowAuditStatusEnum，0=待提交是本应用
特有暂态不入映射）、variables=[deptId,deptName]、detail-route=/list/detail?serid={bizId}
（与迁移前 JumpTarget 产物逐字节相同）。密钥段一字未动。
另修一处与本次无关的环境断点：appearance 件只由 feat/appearance-sdk 分支的 BOM 托管，
本分支 BOM 无该条目，notice/svc-hall/UserBase 均解析失败；给 notice 自己的依赖补显式
1.0.0-SNAPSHOT（jar 已在本地仓库），合流后应删本行回落 BOM。
---
 pom.xml                            | 14 ++++++++++++++
 src/main/resources/application.yml | 11 +++++++++++
 2 files changed, 25 insertions(+)

diff --git a/pom.xml b/pom.xml
index 49ea2f7..6a0ff8c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -126,6 +126,11 @@
         <dependency>
             <groupId>com.yunhai.platform</groupId>
             <artifactId>yh-appearance-spring-boot-starter</artifactId>
+            <!-- 显式版本（2026-10-17 过夜任务环境修复）：该件由 BasePlatform 的 feat/appearance-sdk
+                 分支引入并只在该分支的 yh-platform-dependencies 里托管；本次接入件工作基于
+                 feat/flow-embed（BOM 无此条目），按 BOM 解析会缺版本导致整仓编译断。jar 本体已在本地仓库，
+                 补版本号即可恢复。appearance 分支合流后应删掉本行回到 BOM 托管。 -->
+            <version>1.0.0-SNAPSHOT</version>
         </dependency>
 
         <!-- 流程中心回调接收端 starter（2026-09-20 迁移）：验签外置（/oapi/* 平台验签），
@@ -135,6 +140,15 @@
             <artifactId>yh-flow-callback-spring-boot-starter</artifactId>
         </dependency>
 
+        <!-- Tier 3 语义接入件迁移试点（2026-10-17 ysch-flow 最小闭环 T3）：事件→状态声明化 +
+             发起编排模板 + 变量契约预检 + bizUrl 自动装配。它聚合传递上面 callback 件与 openapi 件，
+             本处保留 callback 显式声明（NoticeFlowCallbackHandler 作为回退绳仍在编译期需要其 SPI 类型）。
+             业务映射见 NoticeFlowBizAdapter，版本由 yh-platform-dependencies BOM 管理。 -->
+        <dependency>
+            <groupId>com.yunhai.platform</groupId>
+            <artifactId>ysch-flow-spring-boot-starter</artifactId>
+        </dependency>
+
         <!-- CAS 客户端（浏览器 SSO 重定向 / ticket 校验 / getRemoteUser 包装）。
              版本 3.5.1 已在本地 .m2 仓库。 -->
         <dependency>
diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml
index 10cdb7a..e6a1419 100644
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -119,6 +119,17 @@ yh:
     # ⇒ 生产 = http://open-gateway-service:10013 + /notice + /oapi/flow/callback
     # base-path 可不填（运行时会自证出与真实 ctx 同源的值；显式配置仅作覆盖/逃生口保留）。
     # 改地址回滚：把全地址写回 callback-url 即可（回滚绳），无需回滚镜像。
+  flow-biz:
+    # ysch-flow 语义接入件（2026-10-17 T3 迁移试点）：装配总闸是本键——删掉本块即整体不装配，
+    # NoticeFlowCallbackHandler 回退绳随之复位（两者互斥，同一上下文只允许一个 FlowCallbackHandler）。
+    biz-type: notice
+    # 四语义态 → audit_status 码表（FlowAuditStatusEnum；0=待提交是 Notice 特有暂态，不在映射内）
+    states: {approving: 10, passed: 20, rejected: 30, withdrawn: 40}
+    # 变量契约：条件路由表达式取的两个键（发起前本地预检 + 启动自检依据；与 NoticeFlowService.buildFormData 同口径）
+    variables: [deptId, deptName]
+    # bizUrl 自动装配模式：与迁移前 JumpTarget.page("list/detail").param("serid", id) 的产物
+    # 逐字节相同（/list/detail?serid=27，裸相对路径，绝对化由接收方按页面归属拼）
+    detail-route: /list/detail?serid={bizId}
   open:
     # 四域服务目录零配置：userbase/userclass/usermsg/flow-center 枚举兜底 = base-host + 默认 ctx
     base-host: http://base.yunhaixingtong.com