171 lines
5.1 KiB
Markdown
171 lines
5.1 KiB
Markdown
# 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 项目骨架创建`。
|