MesUniversalApi-Migration/MesUniversalApi/README.md

MesUniversalApi 移植目录

本目录用于承载新的通用 WebAPI 移植项目代码、测试、部署文件、工具脚本和验收附件。

目标基线

• 目标 SDK：.NET 10
• 目标框架：net10.0
• 目标形态：ASP.NET Core Web API
• 目录角色：新项目代码根目录，不与旧 MES_Manage/、02DataLinkMesWork/ 混做

当前状态

截至 2026-07-02：

• 仅创建目录骨架和说明文件。
• 尚未生成 .sln 和 .csproj。
• 当前开发机仅检测到 .NET SDK 9.0.311，尚未满足 net10.0 项目生成条件。

目录说明

MesUniversalApi/
  src/        新项目源码
  tests/      单元测试和集成测试
  deploy/     Docker、systemd、Nginx 等部署资产
  docs/       项目内技术文档和补充说明
  tools/      辅助脚本
  evidence/   验收附件、截图、报告、回归样本

开工前检查

1. 安装 .NET 10 SDK。
2. 运行 dotnet --list-sdks，确认输出包含 10.0.x。
3. 在本目录创建 global.json，锁定实际安装的 10.0.x。
4. 按 working1/04-任务矩阵.md 先执行 T001，再执行 T002。

安装 SDK 后的首批命令

cd MesUniversalApi
dotnet new globaljson --sdk-version 10.0.xxx
dotnet new sln -n MesUniversalApi
dotnet new webapi -f net10.0 -n MesUniversalApi.Api -o src/MesUniversalApi.Api
dotnet new classlib -f net10.0 -n MesUniversalApi.Application -o src/MesUniversalApi.Application
dotnet new classlib -f net10.0 -n MesUniversalApi.Contracts -o src/MesUniversalApi.Contracts
dotnet new classlib -f net10.0 -n MesUniversalApi.Domain -o src/MesUniversalApi.Domain
dotnet new classlib -f net10.0 -n MesUniversalApi.Infrastructure -o src/MesUniversalApi.Infrastructure
dotnet sln add src/**/*.csproj

10.0.xxx 需替换为开发机实际安装的 SDK 版本号。