From 4db4f542a59ffc3c57e8c53d657ef5ea8f407b2c Mon Sep 17 00:00:00 2001
From: wkc <978997012@qq.com>
Date: Tue, 31 Mar 2026 16:04:59 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=94=9F=E4=BA=A7=E5=88=9D?=
 =?UTF-8?q?=E5=A7=8B=E5=8C=96=E6=95=B0=E6=8D=AE=E5=BA=93=E5=AF=BC=E5=87=BA?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...-03-31-production-db-init-export-design.md | 218 ++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-03-31-production-db-init-export-design.md

diff --git a/docs/superpowers/specs/2026-03-31-production-db-init-export-design.md b/docs/superpowers/specs/2026-03-31-production-db-init-export-design.md
new file mode 100644
index 0000000..f67e7e2
--- /dev/null
+++ b/docs/superpowers/specs/2026-03-31-production-db-init-export-design.md
@@ -0,0 +1,218 @@
+# 生产初始化数据库导出设计文档
+
+## 1. 背景
+
+当前项目已经存在若依基础库脚本 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql)，也存在历史的全量结构导出文件和“必要数据”导出文件。但本次目标不是继续导出业务数据，而是为生产部署准备一个单一、可直接执行的数据库初始化脚本。
+
+该脚本需要满足以下要求：
+
+- 以若依基础表和初始化数据为基线
+- 在此基础上补齐贷款定价项目新增的所有业务表
+- 不携带任何业务数据
+- 最终导出为一个文件，生产环境可直接执行
+
+## 2. 已确认约束
+
+- 最终产物必须是一个单一 `.sql` 文件
+- 若依基础部分直接复用 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql)
+- 不从当前数据库重新抽取 `sys_*` 管理数据
+- 不导出任何业务数据
+- 不拆分为“基础脚本 + 增量脚本”多步执行
+- 不增加兼容性、补丁性或兜底性方案
+- 方案必须保持最短路径实现
+
+## 3. 当前资产与现状
+
+### 3.1 已有基础脚本
+
+[sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql) 已包含若依基础表结构以及初始化管理数据，覆盖部门、用户、岗位、角色、菜单、字典、参数、通知、定时任务等基础能力。
+
+### 3.2 已有历史导出文件
+
+仓库内已有以下历史文件，可作为字段和表范围核对依据：
+
+- [sql/loan_pricing_schema_20260328.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/loan_pricing_schema_20260328.sql)
+- [sql/loan_pricing_required_data_20260328.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/loan_pricing_required_data_20260328.sql)
+
+其中 `loan_pricing_required_data_20260328.sql` 带有业务数据，不符合本次生产初始化目标，因此本次不能直接复用。
+
+### 3.3 业务增量表范围
+
+相对于若依基础脚本，当前项目新增的业务表结构只有以下 3 张：
+
+- `loan_pricing_workflow`
+- `model_corp_output_fields`
+- `model_retail_output_fields`
+
+本次生产初始化导出只需要将这 3 张表的最终结构追加到若依基础脚本之后。
+
+## 4. 方案对比
+
+### 方案一：生成单一生产初始化总脚本
+
+做法：
+
+- 以 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql) 为主体
+- 追加 3 张业务表的最终 `DROP TABLE` 与 `CREATE TABLE`
+- 形成一个新的、可直接执行的生产初始化 SQL 文件
+
+优点：
+
+- 与本次“一个文件直接执行”的目标完全一致
+- 路径最短，执行成本最低
+- 不依赖实时连库导出，不会误带当前库中的业务数据
+- 基础初始化内容与现有若依脚本保持一致，可控性高
+
+缺点：
+
+- 后续业务表结构变化后，需要重新生成该文件
+
+### 方案二：保留若依基础脚本，再新增一个业务表增量脚本
+
+做法：
+
+- 保持 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql) 不变
+- 额外新增一个只包含业务表结构的 SQL 文件
+- 生产执行时先跑基础脚本，再跑增量脚本
+
+优点：
+
+- 文件职责分离较清晰
+
+缺点：
+
+- 不满足“导出到一个文件内”的明确要求
+- 生产执行需要多步操作
+- 增加人为漏执行或执行顺序错误的风险
+
+### 方案三：从当前数据库重新导出全库，再手工删除不需要的内容
+
+做法：
+
+- 基于当前数据库重新导出结构与数据
+- 人工删除业务数据和不需要的表内容
+
+优点：
+
+- 理论上能快速拿到一个初稿
+
+缺点：
+
+- 风险最高，容易混入业务数据、运行态数据和测试数据
+- 结果依赖当前库状态，不稳定
+- 不符合最短路径且可控的实现要求
+
+## 5. 设计结论
+
+采用方案一：生成单一生产初始化总脚本。
+
+最终产物是一个新的 SQL 文件，放在 [sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql) 目录，用于生产数据库初始化。该文件以若依基础脚本为主体，追加 3 张业务表结构，不包含任何业务表数据。
+
+## 6. 导出文件设计
+
+### 6.1 文件职责
+
+该文件只负责“生产数据库初始化”，不承担历史数据迁移、业务数据灌库或环境差异兼容职责。
+
+### 6.2 文件内容组成
+
+建议内容结构如下：
+
+1. 头部说明
+2. 数据库创建与切库语句
+3. 若依基础表结构与初始化数据
+4. 贷款定价业务表结构
+5. 执行结束后的环境恢复语句
+
+### 6.3 文件命名
+
+建议命名为：
+
+- `sql/loan_pricing_prod_init_20260331.sql`
+
+命名目标是明确表达“生产初始化”用途，并带上生成日期，方便后续版本追踪。
+
+## 7. 保留与排除范围
+
+### 7.1 保留内容
+
+保留内容分为两部分：
+
+第一部分是若依基础脚本中的全部基础表与初始化数据，直接复用 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql) 的现有内容。
+
+第二部分是项目业务增量表结构，仅保留如下 3 张表的结构定义：
+
+- `loan_pricing_workflow`
+- `model_corp_output_fields`
+- `model_retail_output_fields`
+
+### 7.2 排除内容
+
+以下内容明确不进入生产初始化脚本：
+
+- `loan_pricing_workflow` 的任何记录数据
+- `model_corp_output_fields` 的任何记录数据
+- `model_retail_output_fields` 的任何记录数据
+- 从当前数据库重新抽取的 `sys_*` 数据
+- 任何日志、运行历史、流程历史、演示数据、测试数据
+
+## 8. 业务表结构来源
+
+3 张业务表的结构应以当前仓库中已经确认的最终版本为准，结构来源优先按以下顺序核定：
+
+1. [sql/loan_pricing_schema_20260328.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/loan_pricing_schema_20260328.sql) 中对应表的最终结构
+2. [sql/loan_pricing_workflow.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/loan_pricing_workflow.sql)、[sql/model_corp.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/model_corp.sql)、[sql/model_retail.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/model_retail.sql)
+3. 其后的结构修正脚本，例如字段补充、字段注释修复、执行利率字段补充等 SQL
+
+如果存在同名表的多份定义，应以能反映当前最终字段状态的版本为准，避免把旧结构写入生产初始化脚本。
+
+## 9. 生成方式
+
+本次采用静态拼装方式生成，不依赖实时数据库导出。
+
+生成步骤如下：
+
+1. 复制 [sql/ry_20250522.sql](/Users/wkc/Desktop/loan-pricing/loan-pricing/sql/ry_20250522.sql) 的基础内容
+2. 从最终结构来源中提取 3 张业务表的 `DROP TABLE` 与 `CREATE TABLE`
+3. 将业务表结构追加到基础内容后方
+4. 在文件头部补充脚本说明，明确用途、范围和排除项
+
+该方式可以保证结果稳定、内容可审查，并且不会因为当前数据库状态不同而发生漂移。
+
+## 10. 验证设计
+
+本次验证只围绕“单文件是否可用于生产初始化”展开，必须覆盖以下检查：
+
+1. 检查脚本是否为单文件，且可独立执行
+2. 检查脚本中是否完整包含若依基础内容
+3. 检查脚本中是否完整包含 3 张业务表结构
+4. 检查脚本中业务表不存在任何 `INSERT` 数据语句
+5. 在测试库执行脚本，验证建库建表流程可跑通
+6. 导入完成后核对若依基础表存在初始化数据
+7. 导入完成后核对 3 张业务表为空表
+
+## 11. 风险与控制
+
+主要风险如下：
+
+1. 如果业务表结构来源选择错误，可能把旧字段定义带入生产脚本
+2. 如果直接复用带数据的历史导出文件，可能误将业务数据带入生产
+3. 如果脚本顺序错误，可能导致执行时报表不存在或环境切换错误
+
+控制方式如下：
+
+- 明确以若依基础脚本为唯一基础来源
+- 明确业务增量仅限 3 张表结构
+- 明确禁止业务表 `INSERT` 语句进入最终脚本
+- 通过测试库执行验证最终脚本的可执行性
+
+## 12. 非目标
+
+本次不包含以下内容：
+
+- 不迁移任何业务数据
+- 不重建当前环境中的真实用户与权限现状
+- 不处理生产数据回灌
+- 不新增多环境兼容脚本
+- 不生成多文件执行方案
+