chore: initialize migration workspace
This commit is contained in:
11
MesUniversalApi/.gitignore
vendored
Normal file
11
MesUniversalApi/.gitignore
vendored
Normal file
@@ -0,0 +1,11 @@
|
||||
bin/
|
||||
obj/
|
||||
.vs/
|
||||
TestResults/
|
||||
artifacts/
|
||||
publish/
|
||||
*.user
|
||||
*.suo
|
||||
*.log
|
||||
.env
|
||||
.env.*
|
||||
53
MesUniversalApi/README.md
Normal file
53
MesUniversalApi/README.md
Normal 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 版本号。
|
||||
8
MesUniversalApi/deploy/README.md
Normal file
8
MesUniversalApi/deploy/README.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# deploy
|
||||
|
||||
本目录用于放置部署相关文件:
|
||||
|
||||
- `docker/`:Dockerfile、compose、镜像说明
|
||||
- `systemd/`:service 文件和 Linux 启动说明
|
||||
|
||||
后续如需 Nginx 配置、环境变量模板,也统一放在本目录。
|
||||
7
MesUniversalApi/deploy/docker/README.md
Normal file
7
MesUniversalApi/deploy/docker/README.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# docker
|
||||
|
||||
本目录预留给 Docker 部署资产:
|
||||
|
||||
- `Dockerfile`
|
||||
- `docker-compose.yml`
|
||||
- 镜像构建与运行说明
|
||||
7
MesUniversalApi/deploy/systemd/README.md
Normal file
7
MesUniversalApi/deploy/systemd/README.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# systemd
|
||||
|
||||
本目录预留给 Linux `systemd` 部署资产:
|
||||
|
||||
- `MesUniversalApi.Api.service`
|
||||
- 环境变量说明
|
||||
- 启停命令说明
|
||||
10
MesUniversalApi/docs/README.md
Normal file
10
MesUniversalApi/docs/README.md
Normal file
@@ -0,0 +1,10 @@
|
||||
# docs
|
||||
|
||||
本目录用于放置新项目内部技术文档,例如:
|
||||
|
||||
- action 白名单设计
|
||||
- 数据源配置样例
|
||||
- 部署补充说明
|
||||
- 回归对比样本说明
|
||||
|
||||
项目级推进和任务记录仍以 `working1/` 为主。
|
||||
10
MesUniversalApi/evidence/README.md
Normal file
10
MesUniversalApi/evidence/README.md
Normal file
@@ -0,0 +1,10 @@
|
||||
# evidence
|
||||
|
||||
本目录用于存放验收附件原件,例如:
|
||||
|
||||
- 启动截图
|
||||
- Swagger 页面截图
|
||||
- 回归响应样本
|
||||
- PDF、Excel、压测报告
|
||||
|
||||
证据索引和结论仍记录在 `working1/05-验收证据.md`。
|
||||
11
MesUniversalApi/src/README.md
Normal file
11
MesUniversalApi/src/README.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# src
|
||||
|
||||
本目录用于放置新 WebAPI 解决方案中的源码项目:
|
||||
|
||||
- `MesUniversalApi.Api`
|
||||
- `MesUniversalApi.Application`
|
||||
- `MesUniversalApi.Contracts`
|
||||
- `MesUniversalApi.Domain`
|
||||
- `MesUniversalApi.Infrastructure`
|
||||
|
||||
在 `.NET 10 SDK` 安装完成后创建对应项目文件。
|
||||
8
MesUniversalApi/tests/README.md
Normal file
8
MesUniversalApi/tests/README.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# tests
|
||||
|
||||
本目录用于放置测试项目:
|
||||
|
||||
- `MesUniversalApi.Tests`
|
||||
- `MesUniversalApi.IntegrationTests`
|
||||
|
||||
测试项目创建时同步纳入解决方案,并按任务矩阵记录验收证据。
|
||||
8
MesUniversalApi/tools/README.md
Normal file
8
MesUniversalApi/tools/README.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# tools
|
||||
|
||||
本目录用于放置迁移过程中的辅助脚本,例如:
|
||||
|
||||
- 旧接口资产盘点脚本
|
||||
- 配置检查脚本
|
||||
- 回归对比脚本
|
||||
- 数据样本整理脚本
|
||||
Reference in New Issue
Block a user