From bc9f15d340d8788bbb903550b75247bc73c17496 Mon Sep 17 00:00:00 2001
From: wkc <978997012@qq.com>
Date: Wed, 15 Apr 2026 11:12:59 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=85=A8=E9=87=8F=E8=BF=81?=
 =?UTF-8?q?=E7=A7=BB892-without-redis=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

---
 ...¨é‡�è¿�移892-without-redis分支功能设计文档.md | 403 ++++++++++++++++++
 1 file changed, 403 insertions(+)
 create mode 100644 doc/2026-04-15-全��移892-without-redis分支功能设计文档.md

diff --git a/doc/2026-04-15-全��移892-without-redis分支功能设计文档.md b/doc/2026-04-15-全��移892-without-redis分支功能设计文档.md
new file mode 100644
index 0000000..118964f
--- /dev/null
+++ b/doc/2026-04-15-全��移892-without-redis分支功能设计文档.md
@@ -0,0 +1,403 @@
+# 全��移 `892-without-redis` 分支功能设计文档
+
+## 1. 背景
+
+当�分支为 `892-jdk-8-without-redis`，已�完� JDK8 适�与 Redis 移除改造。目标分支 `origin/892-without-redis` 包�贷款定价业务�登录安全�部署脚本�生产�始化 SQL�文档与实施记录等多类改动。
+
+本次需求已确认如下：
+
+- �移范围为目标分支中的全部功能，���于贷款定价主链
+- �移目标以“功能行为完全对�目标分支�为准
+- ��求�交历�一致，也��求�文件原样��
+- 当�分支已完�的 JDK8 与去 Redis 基线必须�留，�能被回退
+
+由于两个分支�存在共� `merge base`，�能按常规增��并处�。本次应采用“以当�分支为基线，按功能行为对��移�的方��地。
+
+## 2. 已确认约�
+
+- 当�分支�留：
+  - JDK8 �行基线
+  - 去 Redis �的内存缓存实现
+- 目标分支中的所有业务能力�脚本能力��始化能力都��入当�分支
+- �移完�的判断标准是“当�分支行为与目标分支一致�，�是“文件内容完全一致�
+- �采用补��兜底方案，�引入�外兼容分支
+- 所有本次改动需�在 `doc/` 目录留下文档记录
+- ��端�时涉�改动时，�续必须分别输出�端实施计划和�端实施计划
+
+## 3. 现状分�
+
+### 3.1 分支关系现状
+
+当�仓库中：
+
+- 本地分支：`892-jdk-8-without-redis`
+- 远端�考分支：`origin/892-without-redis`
+
+两者没有共��并基线，说明�能通过简� `merge`�`cherry-pick` 或三点 diff �安全�移全部功能。
+
+### 3.2 目标分支改动构�
+
+�核对，目标分支包�以下几类内容：
+
+1. 贷款定价主业务
+- �程列表的测算利率�执行利率�更新时间
+- �程详情字段补�与详情�片顺�调整
+- 个人最终测算利率展示
+- 个人测算入�对�
+- �感信�存储加密�接�脱��模型调用�解密
+
+2. 登录与账�相关
+- 登录页默认账�密�移除
+- 登录密�传输相关��端改造
+
+3. �行与部署相关
+- �端��脚本
+- 生产一键部署脚本
+- 压缩包目录结构与进程识别规则调整
+- 多环境�置文件补充
+
+4. 数��始化与数�库脚本
+- 贷款定价相关表结构脚本
+- ���始化脚本
+- 生产�始化数�库脚本
+
+5. 文档与测试资产
+- 业务设计文档�实施计划�实施记录
+- `test_api` 示例
+- �端��测试脚本
+
+### 3.3 当�分支�移风险
+
+如果直接套用目标分支文件，会出现以下风险：
+
+- 覆盖当�分支已�完�的去 Redis 实现
+- 引入�适� JDK8 的实现方�
+- 将目标分支中与当�分支冲�的�置整文件覆盖
+- 把脚本和 SQL �进�但没有�步��端行为，导致�调失败
+
+因此，本次需�以“�留当�底座�按业务行为�建目标功能�的方�推进。
+
+## 4. 方案对比
+
+### 方案一：按业务域�行为对��移
+
+�法：
+
+- 以当�分支为基线
+- 按功能域拆分�移目标分支能力
+- 对于冲�文件采用手工整�
+- 最终以页�表现�接�行为�脚本效果与目标分支一致为准
+
+优点：
+
+- 最适�当�两�独立历�的情况
+- �以稳定��当�分支 JDK8 与去 Redis 基线
+- 更容易分�验�与回归
+
+缺点：
+
+- 需��模�核对行为
+- 人工整��本高于直接覆盖
+
+### 方案二：大�积覆盖目标分支文件�回补当�基线
+
+�法：
+
+- 尽�把目标分支文件整体覆盖到当�分支
+- �回头修� JDK8 和去 Redis 冲�
+
+优点：
+
+- �期拷�速度快
+
+缺点：
+
+- �易冲掉当�分支已�验�过的基础改造
+- �置修��本高
+- 很难确认哪些回归�自覆盖行为
+
+### 方案三：按�交批��移
+
+�法：
+
+- �试对目标分支�交� `cherry-pick` 或补��移
+
+优点：
+
+- �论上��更清晰
+
+缺点：
+
+- 两个分支无共�基线，冲�会�常多
+- 目标分支�交混�，难以按�交边界安全�移
+
+## 5. 设计结论
+
+采用方案一：按业务域�行为对��移。
+
+核心原则如下：
+
+- �留当�分支的 JDK8 与去 Redis 基线
+- �移目标分支中的全部功能，但�强求原样�代�
+- 所有冲��置以“行为一致 + 当�底座�回退�为判定标准
+- �移顺�固定为“基线对� -> �端能力 -> �端行为 -> 验�收��
+
+## 6. �移边界设计
+
+本次将目标分支改动拆分为 5 个�移包：
+
+### 6.1 贷款定价主业务包
+
+包�：
+
+- �程列表字段与刷新行为
+- 详情展示与�片顺�调整
+- 个人与�业建�链路
+- 个人测算入�对�
+- 最终测算利率展示
+- �感信�加密�脱��模型调用链路
+- 相关 SQL 脚本与测试文件
+
+### 6.2 登录与账�包
+
+包�：
+
+- 登录页默认账�密�移除
+- 登录密�传输相关��端链路
+- 控制器�API�工具函数与测试
+
+### 6.3 部署与�行包
+
+包�：
+
+- ��脚本
+- 生产一键部署脚本
+- 环境安装脚本
+- 目录结构与 jar 进程识别规则
+- 多环境�置文件
+
+### 6.4 �始化与交付包
+
+包�：
+
+- 生产�始化数�库脚本
+- ��脚本
+- 表结构�更脚本
+- `deploy/` 目录与交付物�置
+
+### 6.5 文档与验�包
+
+包�：
+
+- 本次�移设计文档
+- �端实施计划
+- �端实施计划
+- 本次�移实施记录
+- 必�测试说明
+
+## 7. �移顺�设计
+
+### 7.1 第一阶段：基线对�
+
+目标：
+
+- �定当�分支��留的 JDK8 与去 Redis 底座
+- 识别目标分支需�补入的�赖��置�脚本�SQL 基础设施
+
+输出：
+
+- �移差异清�
+- 需整�的�置与脚本列表
+
+### 7.2 第二阶段：�端能力�移
+
+目标：
+
+- 先完�贷款定价�登录安全�脚本能力��始化 SQL 的�端与脚本�移
+
+原因：
+
+- �端页�行为�赖�端接�契约
+- 先稳定接��字段和脚本能力，�续�端�能一次性对�
+
+### 7.3 第三阶段：�端行为�移
+
+目标：
+
+- 完� `ruoyi-ui` 页��API�工具函数�页�测试脚本�移
+
+�点页�：
+
+- 贷款定价�程列表
+- �程详情
+- 个人/�业建�弹窗
+- 登录页
+- 缓存监控页
+
+### 7.4 第四阶段：验�与收�
+
+目标：
+
+- 对�移�的当�分支�构建�测试与关键链路核验
+- 输出实施文档并确认最终行为一致
+
+## 8. 冲�处�设计
+
+### 8.1 Redis 冲�处�
+
+凡是目标分支使用 Redis 的旧实现，统一�留当�分支的内存缓存能力，��移与业务行为相关的部分，�回退技术实现。
+
+### 8.2 JDK8 冲�处�
+
+凡是目标分支中使用高版本 JDK 写法的地方，统一改为当�分支��行的 JDK8 写法，��行为一致��。
+
+### 8.3 �文件多��冲�处�
+
+如果�一文件�时存在：
+
+- 当�分支的去 Redis/JDK8 适�
+- 目标分支的新业务功能
+
+则采用手工整�，��整文件覆盖。
+
+### 8.4 脚本与环境冲�处�
+
+部署脚本与环境�置以目标分支行为为目标，但需��新核对：
+
+- 端�
+- 目录
+- 进程识别规则
+- 当�仓库的�动方�
+
+### 8.5 文档路径处�
+
+目标分支中存在 `docs/superpowers/...` 路径文档，但当�仓库规范�求将本次文档统一�到 `doc/`。因此文档��移内容，�沿用目标分支文档目录结构。
+
+## 9. 详细�移清�
+
+### 9.1 贷款定价主业务
+
+- 列表：
+  - 测算利率
+  - 执行利率
+  - 更新时间
+  - 返回列表自动刷新
+- 详情：
+  - 个人详情字段补�
+  - 详情�片顺�调整
+  - 最终测算利率展示
+- 建�：
+  - 个人测算入�对�
+  - 创建请求字段与模型调用字段统一
+- 安全：
+  - `custName`
+  - `idNum`
+  - 存储加密�查询脱��模型调用�解密
+- 数�：
+  - �程表�输出表字段脚本
+  - ��脚本
+  - 测试 API 文件
+
+### 9.2 登录与账�相关
+
+- 登录页默认账�密�移除
+- 密�传输工具函数
+- 登录�注册�个人中心�用户管�相关��端接�对�
+- 对应测试补�
+
+### 9.3 �行与部署相关
+
+- `bin/restart_java_backend.sh`
+- `bin/prod/*`
+- `deploy/*`
+- 环境�置文件
+- 目录结构与压缩包处�
+- ��测试脚本
+
+### 9.4 �始化与交付物
+
+- �始化数�库脚本
+- 贷款定价��脚本
+- 生产交付压缩包相关目录
+- 其他目标分支新增 SQL
+
+## 10. 验收�径
+
+�移完�需�时满足以下�件：
+
+### 10.1 �端
+
+- �影�模�测试�通过
+- 新增关键测试覆盖关键行为
+- 当�分支能正常�动�端�务
+
+### 10.2 �端
+
+- `ruoyi-ui` 在 `nvm use` ��安装�赖
+- `npm run build:prod` �功
+- 登录��程列表�详情�建��缓存监控等关键页��正常访问
+
+### 10.3 业务行为
+
+- 贷款定价链路行为与目标分支一致
+- 登录行为与目标分支一致
+- 部署脚本的执行逻辑与目标分支一致
+- 目标分支新增 SQL 在当�分支具备等价能力
+
+### 10.4 文档
+
+- 在 `doc/` 目录补�本次：
+  - 设计文档
+  - �端实施计划
+  - �端实施计划
+  - 实施记录
+
+## 11. 测试与验�设计
+
+### 11.1 �端验�
+
+- �元或控制器测试：
+  - 列表字段返回
+  - 详情脱�
+  - 登录密�传输
+  - 缓存监控接�
+- �置与脚本核对：
+  - 多环境�置
+  - 端�
+  - 路径
+  - 进程识别规则
+- �动验�：
+  - 至少确认�移��正常�动
+
+### 11.2 �端验�
+
+- ��构建验�：
+  - `nvm use`
+  - `npm install`
+  - `npm run build:prod`
+- 页�链路验�：
+  - 登录
+  - �程列表
+  - �程详情
+  - 个人建�
+  - 缓存监控页
+
+### 11.3 进程清��求
+
+若验�过程中�动��端进程，验�结��统一关闭，��留测试进程。
+
+## 12. �目标
+
+- �追求与目标分支�文件完全一致
+- ��移目标分支 git 历�
+- �为了�刻目标分支而回退当� JDK8 或去 Redis 基线
+- �新增需求之外的兼容或�级逻辑
+
+## 13. �续实施方�
+
+设计确认�，�续实施将拆分为两份计划：
+
+- �端实施计划
+- �端实施计划
+
+实施时采用“分包�移 + �包自验��的方�推进，��完�并验�，��一次性大批��地��集中排错。