# 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。
