# 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` 项目生成条件。

## 目录说明

```text
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 后的首批命令

```bash
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 版本号。