docs: simplify migration documentation

This commit is contained in:
2026-07-28 16:22:50 +08:00
parent b8d14e8a7e
commit 5732df8886
13 changed files with 484 additions and 2016 deletions

View File

@@ -2,11 +2,11 @@
`operation-inventory.csv` 是旧 NestJS 与当前 .NET 运行时 OpenAPI 的机械比较结果。
状态说明
状态:
- `exact_match`HTTP 方法和路径完全一致仍需核对 DTO、响应、权限和业务错误。
- `legacy_only`:只存在于旧 NestJS后续决定迁移、替代或删除。
- `target_only`:只存在于 .NET通常是新 REST 设计、诊断接口或路径调整。
- `exact_match`HTTP 方法和路径完全一致仍需核对 DTO、响应、权限和业务错误。
- `legacy_only`:只存在于旧 NestJS后续决定迁移、替代或删除。
- `target_only`:只存在于 .NET通常是新 REST 设计、诊断接口或路径调整。
重新生成:
@@ -17,4 +17,4 @@ python3 scripts/compare_openapi.py \
--output docs/migration/contracts/operation-inventory.csv
```
旧 NestJS 开发环境文档默认是 `/openapi.json`,当前 .NET 开发环境文档是 `/openapi/v1.json`原始 OpenAPI 文件可能较大且会频繁变化,不提交仓库;提交归一化后的 CSV 基线。
原始 OpenAPI 文件较大且变化频繁,不提交仓库;提交归一化后的 CSV 基线。