# 03-推进台账

本台账记录每轮推进做了什么、改了哪些文件、验证了什么、下一步是什么。

## 记录规则

每轮新增一条记录，格式如下：

```text
轮次：
日期：
目标：
完成内容：
改动文件：
验证证据：
遗留问题：
下一步：
```

## R001 - 分析资料整理与项目移植文档框架建立

日期：2026-07-02

目标：

- 根据 `working` 中对 `MESCommonBase.ashx` 的分析资料，建立 `working1` 项目移植文档。
- 形成后续可持续推进的 README、功能、开发步骤、台账、任务矩阵、验收证据、决策记录。

完成内容：

- 盘点 `working` 目录已有分析资料。
- 确认 `working1` 目录存在且为空。
- 编写项目文档索引。
- 编写项目功能内容。
- 编写程序开发详细步骤。
- 编写推进台账。
- 编写任务矩阵。
- 编写验收证据。
- 编写决策记录。

改动文件：

- `working1/README.md`
- `working1/01-项目功能内容.md`
- `working1/02-项目程序开发详细步骤.md`
- `working1/03-推进台账.md`
- `working1/04-任务矩阵.md`
- `working1/05-验收证据.md`
- `working1/06-决策记录.md`

验证证据：

- 已读取 `working/MES通用WebAPI多数据库迁移技术路线.md`。
- 已列出 `working` 目录文件。
- 已确认 `working1` 原为空目录。
- 已通过文件清单检查确认文档写入。

遗留问题：

- 尚未创建真实 WebAPI 项目代码。
- 尚未盘点所有前台实际调用的旧 Type/Name/Param。
- 尚未连接任何真实数据库。
- 尚未确定首批迁移的业务 action。

下一步：

1. 执行 `T001 旧接口资产盘点`。
2. 执行 `T002 新 WebAPI 项目骨架创建`。
3. 执行 `T003 数据源配置模型设计`。
4. 明确首批 SQL Server 兼容接口。

## R002 - 固定 .NET 10 目标基线并创建新移植目录

日期：2026-07-02

目标：

- 固定新项目目标 SDK 为 `.NET 10`。
- 完善 `working1` 文档中的移植前准备内容。
- 创建独立的新移植目录，避免与旧系统代码混做。

完成内容：

- 确认目标 SDK 固定为 `.NET 10`，目标框架固定为 `net10.0`。
- 确认当前开发机仅安装 `.NET SDK 9.0.311`，尚未具备生成 `net10.0` 项目的条件。
- 在仓库根目录创建 `MesUniversalApi/` 及其 `src/`、`tests/`、`deploy/`、`docs/`、`tools/`、`evidence/` 目录骨架。
- 补充 `working1` 中关于目录分工、前置条件、SDK 基线、启动规则和目录边界的文档内容。
- 为新移植目录创建说明文件和占位文件，明确后续代码、测试、部署和证据落点。

改动文件：

- `working1/README.md`
- `working1/01-项目功能内容.md`
- `working1/02-项目程序开发详细步骤.md`
- `working1/03-推进台账.md`
- `working1/04-任务矩阵.md`
- `working1/05-验收证据.md`
- `working1/06-决策记录.md`
- `MesUniversalApi/README.md`
- `MesUniversalApi/.gitignore`
- `MesUniversalApi/src/README.md`
- `MesUniversalApi/tests/README.md`
- `MesUniversalApi/docs/README.md`
- `MesUniversalApi/deploy/README.md`
- `MesUniversalApi/deploy/docker/README.md`
- `MesUniversalApi/deploy/systemd/README.md`
- `MesUniversalApi/tools/README.md`
- `MesUniversalApi/evidence/README.md`

验证证据：

- `dotnet --list-sdks` 输出仅包含 `9.0.311`。
- `Get-ChildItem -LiteralPath 'MesUniversalApi' -Recurse -Depth 2` 已确认目录骨架创建成功。

遗留问题：

- `.NET 10 SDK` 尚未安装，当前还不能执行 `T002` 生成 `net10.0` 项目。
- 尚未进行 `T001` 旧接口资产盘点明细输出。
- 尚未建立新项目 git 仓库。

下一步：

1. 安装并验证 `.NET 10 SDK`。
2. 执行 `T001 旧接口资产盘点`。
3. 在 `MesUniversalApi/` 下执行 `T002 新 WebAPI 项目骨架创建`。
4. 补充 `global.json`、解决方案和项目文件。

## R003 - 云仓库初始化与首次提交

日期：2026-07-02

目标：

- 将当前迁移工作提交到云仓库。
- 控制提交范围，只同步迁移资料和新移植目录。

完成内容：

- 在本地根目录初始化 git 仓库，默认分支为 `main`。
- 新增根目录 `.gitignore`，只跟踪 `working/`、`working1/`、`MesUniversalApi/` 和根目录仓库说明。
- 新增根目录 `README.md`，说明迁移工作仓库范围。
- 在云端创建仓库 `wangdequan/MesUniversalApi-Migration`。
- 完成首次提交并推送到远端 `main` 分支。

改动文件：

- `.gitignore`
- `README.md`
- `working1/03-推进台账.md`
- `working1/04-任务矩阵.md`
- `working1/05-验收证据.md`
- `working1/06-决策记录.md`

验证证据：

- 云端仓库地址：`http://154.8.160.151:3000/wangdequan/MesUniversalApi-Migration`
- 首次提交 SHA：`705aec6ab2b4d896496f17dc68c13a544810dd70`
- `git push` 已成功创建远端 `main` 分支。

遗留问题：

- 当前仓库未包含旧系统全量源码，这一行为是刻意范围控制。
- `.NET 10 SDK` 仍未安装。
- `T001` 旧接口资产盘点尚未开始。

下一步：

1. 安装并验证 `.NET 10 SDK`。
2. 执行 `T001 旧接口资产盘点`。
3. 在 `MesUniversalApi/` 下执行 `T002 新 WebAPI 项目骨架创建`。
