# 第一阶段：仓库转正基线

基线日期：2026-07-27。

## 仓库身份

- 本仓库是 ASP.NET Core 目标后端，后续新功能只在这里开发。
- 旧 NestJS 后端只用于核对业务行为、接口契约和数据迁移。
- 保留现有 Git 历史，不重新初始化仓库。
- 正式远程使用 `https://git.gongxue100.com/xiongyuxing/tiku-backend.net.git`。
- 默认分支统一为 `main`，远程创建后再设置保护规则。

## 当前可验证基线

| 项目 | 结果 |
| --- | ---: |
| 旧 NestJS OpenAPI 路径 | 283 |
| 旧 NestJS OpenAPI 操作 | 342 |
| 当前 .NET OpenAPI 路径 | 192 |
| 当前 .NET OpenAPI 操作 | 237 |
| 方法和路径完全一致 | 165 |
| 仅旧 NestJS 存在 | 177 |
| 仅当前 .NET 存在 | 72 |
| 当前 .NET Controller 文件 | 20 |
| 当前 EF Core Migration | 7 |

OpenAPI 数字来自开发环境运行时文档，不以 Controller 特性数量或 README 手工统计为准。详细清单见 [operation-inventory.csv](contracts/operation-inventory.csv)。

## 权威来源

| 内容 | 权威来源 |
| --- | --- |
| 目标架构 | `docs/adr/0001-authoritative-dotnet-backend.md` |
| API 契约 | 运行时 `/openapi/v1.json` |
| 数据库模型 | EF Core 实体和 Fluent Configuration |
| 数据库结构历史 | `Tiku.Infrastructure/Persistence/Migrations/` |
| 生产迁移入口 | `Tiku.DbMigrator` |
| 迁移范围与取舍 | `docs/migration/contracts/operation-inventory.csv` 及后续决策记录 |

## 自建 Git 接入

远程仓库创建完成后，在仓库根目录执行：

```bash
git remote add origin https://git.gongxue100.com/xiongyuxing/tiku-backend.net.git
git push -u origin main
```

如果服务端已经自动创建了 README 或初始提交，不要强制推送；先拉取并确认如何合并历史。

## 基线验证

2026-07-27 在 macOS、.NET SDK 10.0.301 上完成：

```text
dotnet restore：通过
dotnet build：通过，0 warning / 0 error
dotnet test：通过，261/261
dotnet format --verify-no-changes：通过
EF Core migration script：通过，生成 4166 行 SQL
API 契约清单校验：通过，414 个唯一操作
```

首次 restore 曾因 `api.nuget.org` TLS EOF 和下载超时失败；串行重试成功。这是依赖源网络故障，不是源码或项目路径问题。

## 第一阶段退出条件

- [x] 明确 .NET 是唯一目标后端。
- [x] 保留并接续现有 Git 历史。
- [x] 仓库命令不依赖开发者机器的绝对路径。
- [x] 建立旧 NestJS 与当前 .NET 的 OpenAPI 操作基线。
- [x] 固定 EF Core Migration 的权威地位。
- [x] 配置自建 Git remote。
- [ ] 首次推送 `main`。
- [ ] 在自建 Git 上启用 `main` 分支保护和 CI（等待远程仓库）。