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

296
working1/05-验收证据.md Normal file
View File

@@ -0,0 +1,296 @@
# 05-验收证据
本文件记录项目推进过程中的可复核证据包括命令、文件、页面、job_id、report_id、PDF、截图和接口响应。
## 1. 当前资料证据
### E001 - `working` 分析资料清单
日期2026-07-02
命令:
```powershell
Get-ChildItem -LiteralPath 'E:\通讯服务器20251217\通讯服务器20251217\working' -Force |
Select-Object Name,Length,LastWriteTime |
Sort-Object Name
```
关键输出:
```text
MESCommonBase程序梳理.md
MESCommonBase流程图.mmd
MESCommonBase流程图.png
MESCommonBase响应输出与SqlWebCall默认分支详细文档.md
MESCommonBase响应输出与SqlWebCall主流程图.mmd
MESCommonBase响应输出与SqlWebCall主流程图.png
MESCommonBase响应输出与SqlWebCall次流程图.mmd
MESCommonBase响应输出与SqlWebCall次流程图.png
MES通用WebAPI多数据库迁移技术路线.md
MESCommonBase迁移分析资料包.pptx
```
结论:
- `working` 已具备源程序梳理、流程图、默认分支详细文档和迁移技术路线。
### E002 - 技术路线文档读取
日期2026-07-02
命令:
```powershell
Get-Content -LiteralPath 'E:\通讯服务器20251217\通讯服务器20251217\working\MES通用WebAPI多数据库迁移技术路线.md' -TotalCount 80
```
结论:
- 技术路线文档确认了目标Linux WebAPI、MySQL/PostgreSQL/SQL Server、多数据库 Provider、actionId 白名单、旧协议兼容。
### E003 - `working1` 目录状态
日期2026-07-02
命令:
```powershell
Get-ChildItem -LiteralPath 'E:\通讯服务器20251217\通讯服务器20251217\working1' -Force
```
结论:
- 文档创建前 `working1` 为空,可安全写入项目移植文档。
### E004 - `working1` 文档写入
日期2026-07-02
新增文件:
```text
working1/README.md
working1/01-项目功能内容.md
working1/02-项目程序开发详细步骤.md
working1/03-推进台账.md
working1/04-任务矩阵.md
working1/05-验收证据.md
working1/06-决策记录.md
```
验收方式:
```powershell
Get-ChildItem -LiteralPath 'E:\通讯服务器20251217\通讯服务器20251217\working1' -Force |
Select-Object Name,Length,LastWriteTime |
Sort-Object Name
```
预期:
- 以上 7 个文件均存在。
### E005 - 当前开发机 .NET SDK 状态
日期2026-07-02
命令:
```powershell
dotnet --list-sdks
```
关键输出:
```text
9.0.311 [C:\Program Files\dotnet\sdk]
```
结论:
- 目标 SDK 虽已确定为 `.NET 10`,但当前开发机尚未安装 `.NET 10 SDK`
- 本轮只做文档、目录和基线准备,不执行 `net10.0` 项目脚手架创建。
### E006 - 新移植目录 `MesUniversalApi` 骨架创建
日期2026-07-02
命令:
```powershell
Get-ChildItem -LiteralPath 'E:\通讯服务器20251217\通讯服务器20251217\MesUniversalApi' -Recurse -Depth 2 |
Select-Object FullName, PSIsContainer
```
关键输出摘要:
```text
MesUniversalApi\src
MesUniversalApi\tests
MesUniversalApi\deploy
MesUniversalApi\deploy\docker
MesUniversalApi\deploy\systemd
MesUniversalApi\docs
MesUniversalApi\tools
MesUniversalApi\evidence
```
结论:
- 新移植项目目录已独立创建,后续源码、测试、部署和证据文件有明确落点。
## 2. 后续开发证据模板
### API 启动证据模板
任务编号:
命令:
```bash
dotnet run --project src/MesUniversalApi.Api
```
证据:
```text
Now listening on: http://localhost:xxxx
Application started.
```
页面:
```text
http://localhost:xxxx/swagger
```
结论:
### 健康检查证据模板
任务编号:
命令:
```bash
curl http://localhost:8080/health
```
响应:
```json
{
"status": "Healthy"
}
```
结论:
### 数据库连接证据模板
任务编号:
数据库:
命令或接口:
```bash
curl -H "Authorization: Bearer ..." http://localhost:8080/api/v1/admin/datasources/mes-main/test
```
响应:
```json
{
"code": "200",
"message": "",
"data": {
"connected": true,
"databaseKind": "SqlServer"
}
}
```
结论:
### Legacy 接口回归证据模板
任务编号:
旧请求:
```json
{
"type": "11",
"name": "...",
"param": "..."
}
```
旧接口响应摘要:
```text
行数:
字段:
关键值:
```
新接口响应摘要:
```text
行数:
字段:
关键值:
```
结论:
### 文件下载证据模板
任务编号:
命令:
```bash
curl -OJ -H "Authorization: Bearer ..." "http://localhost:8080/api/v1/files/xxx/download?fileId=123"
```
证据:
```text
文件名:
大小:
SHA256
Content-Disposition
```
结论:
### 截图/PDF/报告证据模板
任务编号:
文件:
```text
working1/evidence/...
```
说明:
结论:
## 3. 任务证据跟踪
| 任务编号 | 证据项 | 状态 |
| --- | --- | --- |
| `T000` | SDK 基线与新移植目录骨架 | 已补充 |
| `T001` | 旧接口资产盘点表 | 待补充 |
| `T002` | 新 WebAPI 启动截图或命令输出 | 待补充 |
| `T003` | 三类数据源配置样例 | 待补充 |
| `T007` | SQL Server Provider 连接测试 | 待补充 |
| `T008` | Legacy Type=11 回归响应 | 待补充 |
| `T014` | PostgreSQL Provider 连接测试 | 待补充 |
| `T015` | MySQL Provider 连接测试 | 待补充 |
| `T018` | Linux Docker 启动证据 | 待补充 |