87 lines
4.2 KiB
Markdown
87 lines
4.2 KiB
Markdown
# 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。
|