330 lines
5.9 KiB
Markdown
330 lines
5.9 KiB
Markdown
# 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` | 云仓库创建与首次推送 | 已补充 |
|