chore: initialize migration workspace

This commit is contained in:
2026-07-02 10:38:13 +08:00
commit 705aec6ab2
44 changed files with 5988 additions and 0 deletions

11
MesUniversalApi/.gitignore vendored Normal file
View File

@@ -0,0 +1,11 @@
bin/
obj/
.vs/
TestResults/
artifacts/
publish/
*.user
*.suo
*.log
.env
.env.*

53
MesUniversalApi/README.md Normal file
View File

@@ -0,0 +1,53 @@
# 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 版本号。

View File

@@ -0,0 +1,8 @@
# deploy
本目录用于放置部署相关文件:
- `docker/`Dockerfile、compose、镜像说明
- `systemd/`service 文件和 Linux 启动说明
后续如需 Nginx 配置、环境变量模板,也统一放在本目录。

View File

@@ -0,0 +1,7 @@
# docker
本目录预留给 Docker 部署资产:
- `Dockerfile`
- `docker-compose.yml`
- 镜像构建与运行说明

View File

@@ -0,0 +1,7 @@
# systemd
本目录预留给 Linux `systemd` 部署资产:
- `MesUniversalApi.Api.service`
- 环境变量说明
- 启停命令说明

View File

@@ -0,0 +1,10 @@
# docs
本目录用于放置新项目内部技术文档,例如:
- action 白名单设计
- 数据源配置样例
- 部署补充说明
- 回归对比样本说明
项目级推进和任务记录仍以 `working1/` 为主。

View File

@@ -0,0 +1,10 @@
# evidence
本目录用于存放验收附件原件,例如:
- 启动截图
- Swagger 页面截图
- 回归响应样本
- PDF、Excel、压测报告
证据索引和结论仍记录在 `working1/05-验收证据.md`

View File

@@ -0,0 +1,11 @@
# src
本目录用于放置新 WebAPI 解决方案中的源码项目:
- `MesUniversalApi.Api`
- `MesUniversalApi.Application`
- `MesUniversalApi.Contracts`
- `MesUniversalApi.Domain`
- `MesUniversalApi.Infrastructure`
`.NET 10 SDK` 安装完成后创建对应项目文件。

View File

@@ -0,0 +1,8 @@
# tests
本目录用于放置测试项目:
- `MesUniversalApi.Tests`
- `MesUniversalApi.IntegrationTests`
测试项目创建时同步纳入解决方案,并按任务矩阵记录验收证据。

View File

@@ -0,0 +1,8 @@
# tools
本目录用于放置迁移过程中的辅助脚本,例如:
- 旧接口资产盘点脚本
- 配置检查脚本
- 回归对比脚本
- 数据样本整理脚本