MesUniversalApi-Migration/working1/README.md

MES 通用 WebAPI 多数据库迁移项目文档索引

本文档目录用于承接 working 中对 MESCommonBase.ashx、DataLink.SqlWebCall、响应输出、流程图和多数据库迁移路线的分析，形成后续项目推进时可持续维护的项目移植资料。

文档清单

编号	文档	用途
01	01-项目功能内容.md	定义新项目要实现的功能范围、旧系统能力映射和目标边界
02	02-项目程序开发详细步骤.md	按阶段说明从建项目到多数据库落地的开发方法
03	03-推进台账.md	记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么
04	04-任务矩阵.md	汇总任务编号、状态、验收标准，防止重复做
05	05-验收证据.md	存放命令、文件、截图、报告、页面、job_id、report_id 等证据索引
06	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

当前推荐主线

资产盘点
  -> 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。