chore: initialize migration workspace

This commit is contained in:
2026-07-02 10:38:13 +08:00
commit 705aec6ab2
44 changed files with 5988 additions and 0 deletions

86
working1/README.md Normal file
View File

@@ -0,0 +1,86 @@
# MES 通用 WebAPI 多数据库迁移项目文档索引
本文档目录用于承接 `working` 中对 `MESCommonBase.ashx``DataLink.SqlWebCall`、响应输出、流程图和多数据库迁移路线的分析,形成后续项目推进时可持续维护的项目移植资料。
## 文档清单
| 编号 | 文档 | 用途 |
| --- | --- | --- |
| 01 | [01-项目功能内容.md](./01-项目功能内容.md) | 定义新项目要实现的功能范围、旧系统能力映射和目标边界 |
| 02 | [02-项目程序开发详细步骤.md](./02-项目程序开发详细步骤.md) | 按阶段说明从建项目到多数据库落地的开发方法 |
| 03 | [03-推进台账.md](./03-推进台账.md) | 记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么 |
| 04 | [04-任务矩阵.md](./04-任务矩阵.md) | 汇总任务编号、状态、验收标准,防止重复做 |
| 05 | [05-验收证据.md](./05-验收证据.md) | 存放命令、文件、截图、报告、页面、job_id、report_id 等证据索引 |
| 06 | [06-决策记录.md](./06-决策记录.md) | 记录关键技术决策和原因,避免后续重复争论 |
## 目录分工
- `working`:保留旧系统分析资料、流程图、路线文档和演示材料,不放新项目代码。
- `working1`:保留项目管理文档、任务矩阵、推进台账、验收证据和决策记录。
- `MesUniversalApi`:新移植项目根目录,承载后续 WebAPI 源码、测试、部署文件、工具脚本和证据附件。
## 来源资料
本目录内容基于 `working` 目录中的分析资料整理:
- `working/MESCommonBase程序梳理.md`
- `working/MESCommonBase流程图.mmd`
- `working/MESCommonBase流程图.png`
- `working/MESCommonBase响应输出与SqlWebCall默认分支详细文档.md`
- `working/MESCommonBase响应输出与SqlWebCall主流程图.mmd`
- `working/MESCommonBase响应输出与SqlWebCall主流程图.png`
- `working/MESCommonBase响应输出与SqlWebCall次流程图.mmd`
- `working/MESCommonBase响应输出与SqlWebCall次流程图.png`
- `working/MES通用WebAPI多数据库迁移技术路线.md`
- `working/MESCommonBase迁移分析资料包.pptx`
## 后续推进规则
1. 新增任务先写入 `04-任务矩阵.md`,获得编号后再实施。
2. 每轮完成后更新 `03-推进台账.md`,记录改动、验证和下一步。
3. 所有可复核结果写入 `05-验收证据.md`,包括命令、文件路径、截图、报告和接口响应。
4. 影响架构、技术选型、安全边界、数据兼容的决定写入 `06-决策记录.md`
5. 需求范围、功能边界或旧 Type 映射变化时,同步更新 `01-项目功能内容.md`
6. 开发步骤、脚手架、部署或测试方法变化时,同步更新 `02-项目程序开发详细步骤.md`
## 当前环境基线
- 目标 SDK`.NET 10`
- 目标 `TargetFramework``net10.0`
- 新移植代码目录:`MesUniversalApi/`
- 当前开发机实际 SDK 状态2026-07-02仅检测到 `.NET SDK 9.0.311`
- 本轮处理原则:先完成文档、目录、任务和证据基线准备;待 `.NET 10 SDK` 安装完成后,再在 `MesUniversalApi/` 内执行 `T002` 创建项目骨架并锁定 `global.json`
## 当前推荐主线
```text
资产盘点
-> ASP.NET Core WebAPI 项目骨架
-> SQL Server Provider 优先兼容
-> Legacy Type 兼容入口
-> actionId 白名单
-> PostgreSQL Provider
-> MySQL Provider
-> 高风险 Type 退场
-> Linux 部署与验收
```
## 当前状态
截至本目录创建时,已完成:
-`MESCommonBase.ashx` 程序梳理。
- 响应输出与 `DataLink.SqlWebCall` 默认分支详细分析。
- 主流程图和次流程图。
- 通用 WebAPI 多数据库迁移技术路线。
- 本目录的项目移植管理文档框架。
- 目标 SDK 已固定为 `.NET 10`
- 新移植目录 `MesUniversalApi/` 已创建基础骨架。
- 当前开发机尚未安装 `.NET 10 SDK`,还不能开始 `net10.0` 项目脚手架生成。
下一步建议:
- 安装并验证 `.NET 10 SDK`
-`04-任务矩阵.md``T001 旧接口资产盘点` 开始推进。
-`MesUniversalApi/` 下执行 `T002 新 WebAPI 项目骨架创建`
- 明确首批迁移 Type 和首批业务 action。