# 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
```

结论：

- 新移植项目目录已独立创建，后续源码、测试、部署和证据文件有明确落点。

### E007 - 云仓库创建与首次推送

日期：2026-07-02

仓库：

```text
http://154.8.160.151:3000/wangdequan/MesUniversalApi-Migration
```

关键动作：

```powershell
git init -b main
git add .
git commit -m "chore: initialize migration workspace"
git push http://wangdequan:***@154.8.160.151:3000/wangdequan/MesUniversalApi-Migration.git main
```

关键结果：

```text
远端仓库创建成功
main -> main 推送成功
commit = 705aec6ab2b4d896496f17dc68c13a544810dd70
```

结论：

- 云仓库已成功建立并完成首次提交。
- 当前远端只包含迁移资料与新移植目录，不包含旧系统全量源码和本地凭据文件。

## 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 启动证据 | 待补充 |
| `T025` | 云仓库创建与首次推送 | 已补充 |
