第一阶段：仓库转正基线

基线日期：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。

权威来源

内容	权威来源
目标架构	`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 接入

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

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 上完成：

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 和下载超时失败；串行重试成功。这是依赖源网络故障，不是源码或项目路径问题。

第一阶段退出条件

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

2.7 KiB Raw Blame History Unescape Escape