落地报价模板主账与后台：合同映射、灌种 SQL/脚本、智能体填表，并补测服运维探针与合同文档对齐。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-14 14:09:45 +08:00
parent 8bdf4990a2
commit a70bce3c8f
138 changed files with 7239 additions and 1085 deletions
@@ -14,7 +14,7 @@
 | `08-管理后台.md` | Jeecg Vue / Online 后台提示词 |
 | `09-企微通道.md` | 企微/H5/存档；入站身份 `sender_id` |
 | `10-TMS对接.md` | TMS V2 协议提示词 |
-| `11-部署运维.md` | Windows 部署与发布提示词（现网对照 + 并存） |
+| `11-部署运维.md` | Windows 部署与发布提示词（现网并存 + 切流） |
 | `12-测试环境部署.md` | 同机测试环境：目录、端口、库、企微、禁碰现网 |
 | `13-环境对照.md` | 正式 vs 测试：域名、端口、库变量、切流只换 `.env` |
 | `14-LangGraph与Redis.md` | 何时用 Graph / Redis、怎么用、禁止当真相的边界 |
@@ -83,7 +83,7 @@
 | TMS（友商/自有 TMS V2） | 报价查询、详情、字典、空运锁舱/释放；外部报价与舱位事实 Owner |
 | DeepSeek API | 意图路由（A）+ 字段语义（B） |
 | 阿里云百炼/DashScope 千问 | 附件/图片、报价表映射等 |
-| 现网 Git | 旧仓仅作对照；新项目用自己的远程 |
+| 现网 Git | 对照地址见 `03`；本仓库用自己的远程 |

 ## 部署环境

@@ -111,7 +111,7 @@
 | `https://ai.ytd-scm.com/inquiry-form/upload` | H5 询价附件上传 |
 | `/jeecgboot`（生产前端 `VITE_GLOB_API_URL`） | 浏览器到 Java 的反代前缀 |
 | Java context-path | `/jeecg-boot`（服务端口 8080） |
-| 现网 Git | 旧仓地址见 `03`；新项目用新远程 |
+| 现网 Git | 地址见 `03`；本仓库用新远程 |
 | `https://work.weixin.qq.com/` | 企微卡片跳转占位 |
 | `https://open.wshoto.com` | 微盛 Archive API 默认基址 |
 | `https://api.deepseek.com` / `/beta` | DeepSeek |
@@ -26,7 +26,7 @@

 ## 4. 管理后台 Web（Vue3）

-正式入口为 **新仓库 `inquiry-backend/`**（Jeecg Vue3 + Vite）。与旧仓 Jeecg 前端**运行无关**；旧项目仅对照页面与 API 语义。  
+正式入口为 **新仓库 `inquiry-backend/`**（Jeecg Vue3 + Vite）。只打新主账；不要挂现网 8080 前端进程。  
 启动：在 `inquiry-backend/` 执行 `pnpm run dev`。业务只打新主账 `inquiry-api/`（8180）。

 询价相关页面（新仓目录示例）：
@@ -1,15 +1,15 @@
 # 提示词：工单 / TMS 主账 API

-你负责新系统的 **业务主账**。产品决策（2026-09-12）：主账以 **JeecgBoot + 低代码（Online / cgform / 代码生成器）** 为正式方式，对齐旧现网用法；库与端口走新系统（`inquiry_robot`、并存期 **8180**），禁止写现网 `jeecg-boot`。
+你负责新系统的 **业务主账**。产品决策（2026-09-12）：主账以 **JeecgBoot + 低代码（Online / cgform / 代码生成器）** 为正式方式；库与端口走新系统（`inquiry_robot`、并存期 **8180**），禁止写现网 `jeecg-boot`。

 决策说明见 `docs/2026-09-12-jeecg-lowcode-ledger-decision.md`。正式主账工程目录为 **`inquiry-api/`**（JeecgBoot）。

-## 与旧项目一致的方式（已定 · 低代码）
+## 正式方式（已定 · 低代码）

- **主账工程 = JeecgBoot**（建议从旧仓 `java-backend` 拷贝后改配置，保留 `jeecg-module-inquiry`）。
+- **主账工程 = JeecgBoot**（工程目录 `inquiry-api/`，保留手写 `jeecg-module-inquiry`）。
 - **允许** Online / cgform / 积木报表 / 代码生成器配置询价相关表单、列表、简单 CRUD 与菜单。
 - 登录、用户、角色、菜单走 Jeecg `/sys/*` + 低代码权限模型。
- 复杂领域（六态 transition、TMS 适配、报价版本采用/调价、智能体唤醒）可继续用手写 `jeecg-module-inquiry`（与现网「低代码 + 手写模块」混合一致）；路径风格仍如 `/inquiry/workOrder/...`、`/inquiry/quotes/...`。
+- 复杂领域（六态 transition、TMS 适配、报价版本采用/调价、智能体唤醒）可继续用手写 `jeecg-module-inquiry`（低代码 + 手写模块混合）；路径风格仍如 `/inquiry/workOrder/...`、`/inquiry/quotes/...`。
 - 后台以 Jeecg Vue3 为正式入口（本仓库 `inquiry-backend/`）；`defHttp` + `X-Access-Token`；Nginx `/jeecgboot` → 新主账端口（`inquiry-api/`）。

 ## 模块划分
@@ -38,7 +38,7 @@

 - 工单：创建、校验、查询、聚合视图、六态 transition、异常 handle/retry。
 - TMS：query、template-fields、detail、health、字典 sync。lock/release 接口可留，**与现网共用 TMS 密钥期间默认关闭出站**。
- 报价决策：采用、调价、成本/售价基线（空运与海陆规则不同，与现网语义对齐）。
+- 报价决策：采用、调价、成本/售价基线（空运与海陆规则不同，与合同语义对齐）。
 - 模板、识别任务、生成任务的查询接口（任务执行可在智能体，主账存结果指针）。
 - 智能体回调：唤醒 Graph 的事件要鉴权 `agentCallbackToken`，打到智能体**唯一 HTTP**（不要假设还存在 8809 `bridge_api`）。
 - 人员：按入站已有的 `wecom_id` 查角色；**不负责**替智能体向企微换 userid。
@@ -56,7 +56,7 @@
 - 熔断、超时、最多 3 次、query 对 code 1/1002 短缓存。
 - `tmsEnabled=false` 时不得出站。生产现网为 `YTD_TMS_V2_ENABLED=true`。

-路径默认：`/quote/v2/query`、`/quote/v2/detail`、`/quote/template-fields`、`/air/cabin/lock`、`/air/cabin/release`、`/auth/token`。地址与 Client 三件套、字典 Token **直接用 `03` 现网值**，不要另要一套 TMS。智能体仍只打**新主账**，不直连 TMS、不打旧 Java 8080。
+路径默认：`/quote/v2/query`、`/quote/v2/detail`、`/quote/template-fields`、`/air/cabin/lock`、`/air/cabin/release`、`/auth/token`。地址与 Client 三件套、字典 Token **直接用 `03` 现网值**，不要另要一套 TMS。智能体仍只打**新主账**，不直连 TMS、不打现网 Java 8080。

 ## 字典投影

@@ -7,7 +7,7 @@
 ## 正式前端（Jeecg Vue）

 - **正式入口** = Jeecg Vue3（本仓库 `inquiry-backend/`）。登录、菜单、Online 表单/列表、权限码均走 Jeecg。
- 旧仓 `inquiry_robot/web-frontend` 与现网 Jeecg 前端仅作**对照**；新系统进程不要挂现网 8080。
+- 正式前端为本仓库 `inquiry-backend/`；新系统进程不要挂现网 8080。
 - **允许** Online / cgform / 积木报表 / 代码生成器配置询价相关生产页。
 - 复杂询价页（工单六态、TMS、报价版本）可继续用手写 `views/inquiry/*`（与现网混合模式一致）。
 - **鉴权**：`X-Access-Token`；生产 `API_URL` 同域 `/jeecgboot` → 新主账 8180（工程目录 `inquiry-api/`）。域名 `https://ai.ytd-scm.com`（见 `13`）。
@@ -7,7 +7,7 @@
 1. `client_credentials` 取 `accessToken`（Basic clientId:clientSecret）。
 2. 查询/详情/模板字段：`Authorization: Bearer`。
 3. 空运锁舱/释放：额外 HMAC 签名头，正文原字节参与签名。
-4. 生产明文见 `03`，**新系统直接复用现网 TMS 信息**（同机并行，不再另开测试 TMS）：`TMS_V2_BASE_URL=http://113.106.62.254:3100/sangoe-boot`；ClientId/Secret/SignatureSecret 均为 `WVRELUFpQWdlbnQk`。`YTD_TMS_V2_ENABLED=true`。字典同步 Token 也用 `03` 现网值。凭证放新系统自己的 `.env`，不要改 `C:\yutongda\secure\` 给旧 Java 用的那份。
+4. 生产明文见 `03`，**新系统直接复用现网 TMS 信息**（同机并行，不再另开测试 TMS）：`TMS_V2_BASE_URL=http://113.106.62.254:3100/sangoe-boot`；ClientId/Secret/SignatureSecret 均为 `WVRELUFpQWdlbnQk`。`YTD_TMS_V2_ENABLED=true`。字典同步 Token 也用 `03` 现网值。凭证放新系统自己的 `.env`，不要改 `C:\yutongda\secure\` 给现网 Java 用的那份。

 **不要**把密钥写进代码或前端。旧字段 `tmsServiceToken`/`tmsSignatureKey` 不要在 V2 再使用。

@@ -29,7 +29,7 @@
 - 1003 或投影失败 → 用户/合同缺项，**不是**无价
 - HTTP 5xx/超时/熔断 → 技术失败

-锁舱/释放：**与旧系统共用同一套 TMS Client 时，新系统默认关闭**（API 返回未开放，企微/后台不展示）。只做 query / detail / template-fields / 字典同步。切流替换旧系统前再打开 lock/release，避免两套应用抢舱。
+锁舱/释放：**与现网共用同一套 TMS Client 时，新系统默认关闭**（API 返回未开放，企微/后台不展示）。只做 query / detail / template-fields / 字典同步。切流接管前再打开 lock/release，避免两套应用抢舱。

 ## 观测

@@ -1,6 +1,6 @@
 # 提示词：部署与运行环境

-目标环境：甲方 **同一台** Windows Server（`129.211.181.80` / `10_206_0_15`）。现网继续跑 `C:\yutongda`。新系统是**另一套应用**，不要切旧 `ops\active-release.json`，不要占用 8080/8810/8813。现网发布仍按甲方原流程；测试环境用本目录 `12`。
+目标环境：甲方 **同一台** Windows Server（`129.211.181.80` / `10_206_0_15`）。现网继续跑 `C:\yutongda`。新系统是**另一套应用**，不要改动现网 `ops\active-release.json`，不要占用 8080/8810/8813。现网发布仍按甲方原流程；测试环境用本目录 `12`。

 ## 同机并存

@@ -14,26 +14,26 @@
 | 企微询价应用 | `1000010` | **同一套**，配置抄 `03` |
 | 企微运维通知 | `1000014` | **同一套** |

-切流替换旧系统时，再把 Nginx 反代指到新端口并停现网 AIBOT 桥，企微后台回调 URL 不用改。然后停下面这份旧清单。
+切流替换现网进程时，再把 Nginx 反代指到新端口并停现网 AIBOT 桥，企微后台回调 URL 不用改。然后停下面这份现网清单。

-## 切流时停旧：域名与端口
+## 切流时停现网：域名与端口

-**域名（旧站点，切流后由新系统接管同一名或下线）**
+**域名（现网站点，切流后由新系统接管同一名或下线）**

 | 地址 | 用途 |
 |---|---|
 | `https://ai.ytd-scm.com` | 后台静态 + 总入口 |
-| `https://ai.ytd-scm.com/jeecgboot/`、`/jeecg-boot/` | 反代旧 Java 8080 |
-| `https://ai.ytd-scm.com/wecom/callback` | 企微应用回调 → 旧 8811 |
-| `https://ai.ytd-scm.com/wecom/robot/callback` | 群机器人（现网空配置）→ 旧 8812 |
-| `https://ai.ytd-scm.com/inquiry-form/` | H5 → 旧 8810 |
-| `https://ai.ytd-scm.com/inquiry-form/upload/` | H5 上传 → 旧 8810 |
+| `https://ai.ytd-scm.com/jeecgboot/`、`/jeecg-boot/` | 反代现网 Java 8080 |
+| `https://ai.ytd-scm.com/wecom/callback` | 企微应用回调 → 现网 8811 |
+| `https://ai.ytd-scm.com/wecom/robot/callback` | 群机器人（现网空配置）→ 现网 8812 |
+| `https://ai.ytd-scm.com/inquiry-form/` | H5 → 现网 8810 |
+| `https://ai.ytd-scm.com/inquiry-form/upload/` | H5 上传 → 现网 8810 |

-机器公网 `129.211.181.80`、SSH `22`、Nginx `80/443` **不要关**（新系统还要用）。`www.waxonai.cn` 只是仓库里旧示例 conf，生产以 `ai.ytd-scm.com` 为准。
+机器公网 `129.211.181.80`、SSH `22`、Nginx `80/443` **不要关**（新系统还要用）。`www.waxonai.cn` 只是仓库里示例 conf，生产以 `ai.ytd-scm.com` 为准。

-**本机进程口（停旧应用服务）**
+**本机进程口（停现网应用服务）**

-| 端口 | 旧进程 | 切流后 |
+| 端口 | 现网进程 | 切流后 |
 |---|---|---|
 | 8080 | Java JeecgBoot | 停 |
 | 8809 | Python bridge_api | 停 |
@@ -43,7 +43,7 @@
 | 8813 | AIBOT 仅 127.0.0.1 | 停 |
 | （无端口） | wecom/llm/recognition/quote/archive Worker | 停 NSSM |

-**不要当「旧询价服务」关掉的**
+**不要当「询价服务」误关的**

 | 地址 | 原因 |
 |---|---|
@@ -57,7 +57,7 @@
 ## 必须保留的运维原则

 1. 制品不可变：新版本写入 `releases\` 新目录，禁止覆盖活动目录。
-2. 原子切换指针：`ops\active-release.json` 等；失败自动回指旧版。
+2. 原子切换指针：`ops\active-release.json` 等；失败自动回指上一活动版。
 3. 互斥锁：禁止两人同时部署。
 4. 构建不含 `.env`、密钥、日志、用户附件、数据库 dump。
 5. 健康检查 ≠ 业务验收。
@@ -67,7 +67,7 @@

 新系统自己监听（避开现网）：**8180** 主账、**8910** 智能体 HTTP、**8913** AIBOT 回环、一个 Worker。现网 8080/8810/8813 保持原样。

-旧 release 的 8809/8811/8812 以及五个旧 Worker：**切流前不要停**。新系统用自己的服务名与端口。发布新版本时停的是 `C:\ytd-test\` 里的旧号，不是 `C:\yutongda`。切流时才把 `ai.conf` 的 inquiry-form / wecom/callback 反代到新 HTTP 端口。不要 Redis 全局单例锁。
+现网 release 的 8809/8811/8812 以及五个 Worker：**切流前不要停**。新系统用自己的服务名与端口。发布测试版时停的是测试目录里的进程，不是 `C:\yutongda`。切流时才把 `ai.conf` 的 inquiry-form / wecom/callback 反代到新 HTTP 端口。不要 Redis 全局单例锁。

 ## 基础设施

@@ -30,7 +30,7 @@

 不要开 8809/8811/8812。不要 Redis 全局单例锁。Nginx 80/443、SSH 22、3306/5432/6379、9000 不要关。

-`MYSQL_*` / `PG_*` / `REDIS_URL`（**db1**）/ `REDIS_KEY_PREFIX=inquiry_robot:` / `OBJECT_STORAGE_BUCKET=inquiry_robot` 完整对照见 `13`。口令新开，勿把旧现网 `MYSQL_PASSWORD`/`PG_PASSWORD` 写进新系统 `.env`。
+`MYSQL_*` / `PG_*` / `REDIS_URL`（**db1**）/ `REDIS_KEY_PREFIX=inquiry_robot:` / `OBJECT_STORAGE_BUCKET=inquiry_robot` 完整对照见 `13`。口令新开，勿把现网 `MYSQL_PASSWORD`/`PG_PASSWORD` 写进新系统 `.env`。

 ## 域名与企微（与正式相同）

@@ -66,7 +66,7 @@ WECOM_AIBOT_INGRESS_URL=http://127.0.0.1:8910/internal/aibot/inbound

 1. 新版本写入 `E:\wwwroot\` 的 `agent\releases` / `admin\releases`，再切 `current` 联接；禁止覆盖正在跑的 current 目标目录内容（先发 release 再切联接）。
 2. 用测试自己的指针；失败回指上一测试版本。
-3. 先停 **测试** 旧进程再起新的；禁止停现网服务。
+3. 先停 **测试** 侧进程再起新的；禁止停现网服务。
 4. 禁止 scp 几个文件当正式发布。
 5. 构建不含 `.env`、密钥、日志、用户附件、dump。
 6. 健康检查 200 ≠ 业务验收。
@@ -1,4 +1,4 @@
-# 旧现网 vs 新系统 inquiry_robot（切换只改配置，不改代码）
+# 现网 vs 新系统 inquiry_robot（切换只改配置，不改代码）

 同一套制品。用 `YTD_ENV=prod` 或 `YTD_ENV=test` 区分阶段（变量名仍叫 YTD_*，与 `03` 对齐）。  
 **域名与企微与现网相同**（`ai.ytd-scm.com`、应用 `1000010`）。  
@@ -7,13 +7,13 @@

 切流目标（方案 B）：`E:\wwwroot` 取代 `C:\yutongda`。清单见 `deploy/CUTOVER-TO-PROD.md`。

-对照表是切换清单。旧现网发布仍走甲方原流程与 `C:\yutongda` 指针；新系统只写 `E:\wwwroot`。
+对照表是切换清单。现网发布仍走甲方原流程与 `C:\yutongda` 指针；新系统只写 `E:\wwwroot`。

 ## 对照

-| 项 | 旧现网（仍在跑） | 新系统 `inquiry_robot` |
+| 项 | 现网（仍在跑） | 新系统 `inquiry_robot` |
 |---|---|---|
-| `YTD_ENV` | `prod`（旧进程） | 切流前可用 `test`；切流日改 `prod` |
+| `YTD_ENV` | `prod`（现网进程） | 切流前可用 `test`；切流日改 `prod` |
 | 公网域名 | `ai.ytd-scm.com` | **同一域名** |
 | DNS / 证书 / Nginx | 已有 `ai.conf` | **不要另开域名/证书**；反代按切流改 |
 | 站点 / H5 / 企微回调 | 同左 | 配置字符串相同；企微回调 URL **不用改** |
@@ -37,15 +37,15 @@

 ## 数据库与存储（同一套变量名）

-代码、YAML 只读变量名，**禁止**写死库名。旧现网明文见 `03`；新系统口令新开，写入 `E:\wwwroot\.env`。
+代码、YAML 只读变量名，**禁止**写死库名。现网明文见 `03`；新系统口令新开，写入 `E:\wwwroot\.env`。

-| 变量 | 旧现网 | 新系统 |
+| 变量 | 现网 | 新系统 |
 |---|---|---|
 | `MYSQL_HOST` | `10.206.0.14` | 同左 |
 | `MYSQL_PORT` | `3306` | 同左 |
 | `MYSQL_DB` | `jeecg-boot` | **`inquiry_robot`** |
 | `MYSQL_USER` | `ytd_jeecg` | **`inquiry_robot`** |
-| `MYSQL_PASSWORD` | 见 `03` | **新开，勿抄旧现网** |
+| `MYSQL_PASSWORD` | 见 `03` | **新开，勿抄现网口令** |
 | `YTD_MYSQL_URL` / JDBC | `.../jeecg-boot?...` | `.../inquiry_robot?...` |
 | `PG_HOST` | `10.206.0.14` | 同左 |
 | `PG_PORT` | `5432` | 同左 |
@@ -99,7 +99,7 @@ MYSQL_DB=inquiry_robot
 OBJECT_STORAGE_BUCKET=inquiry_robot
 ```

-两套 `.env` 分开放：旧现网仍在 `C:\yutongda\...`，新系统在 `E:\wwwroot\.env`。不要互相覆盖。
+两套 `.env` 分开放：现网仍在 `C:\yutongda\...`，新系统在 `E:\wwwroot\.env`。不要互相覆盖。

 ## 以后切到正式（新系统接管）

@@ -108,7 +108,7 @@ OBJECT_STORAGE_BUCKET=inquiry_robot
 1. 新进程在隔离库 `inquiry_robot*` 验收通过。
 2. `.env`：`YTD_ENV=prod`；库继续 `inquiry_robot*`（或甲方最终名）。
 3. Nginx 反代切到新主账/智能体；企微回调 URL 不用改。
-4. 停旧 8813，再起 8913。
+4. 停现网 8813，再起 8913。
 5. 去掉告警 `[test]`。

 ## 禁止
@@ -36,7 +36,7 @@
   绑会话/工单。新开询价新 thread；旧单 `resume` 精确断点。禁止拿新消息重放已提交的建单/查价。

 3. **Checkpointer 在 PostgreSQL**  
-   正式旧现网：`ytd_runtime`。新系统：`inquiry_robot_runtime`。进程重启后按 `thread_id` 捞图。不要把 checkpoint 放 Redis。
+   现网运行账：`ytd_runtime`（新进程禁止写）。新系统：`inquiry_robot_runtime`。进程重启后按 `thread_id` 捞图。不要把 checkpoint 放 Redis。

 4. **谁启动图**  
   - 入站 → DeepSeek A →「继续本单」→ `invoke` / `resume`。无 `sender_id` 不进图。  
@@ -83,7 +83,7 @@

 1. **连接**  
   只用 `REDIS_URL` + `REDIS_KEY_PREFIX`（或代码里统一前缀函数）。  
-   旧现网：db0，前缀 `ytd:prod:…`。新系统：db1，前缀 `inquiry_robot:`。禁止新进程写旧现网前缀。
+   现网：db0，前缀 `ytd:prod:…`。新系统：db1，前缀 `inquiry_robot:`。禁止新进程写现网前缀。

 2. **键必须带环境前缀**  
   所有 key：`{REDIS_KEY_PREFIX}:…`。LLM 队列 namespace 也要能随环境错开，避免测服抢走现网任务。