agilelabs-fx-docs main samples/tutorials/backend-starter/README.md

backend-starter

这是后端初始化主线的最终样例目录。它保持“最新可运行状态”，教程正文会按步骤指出当前该关注哪些文件，而不是为每一步单独拆一套阶段目录。

适合什么时候看

  • 想确认后端初始化主线最终会落成什么目录结构。
  • 想快速定位 Program.cs、控制器、仓储接口和认证处理器分别应该放在哪里。
  • 想在不翻完整教程的情况下，先看一个最小后端骨架的完成态。

服务哪些教程

当前目录约定

  • BackendStarter.sln：后端教程使用的解决方案文件。
  • NuGet.config：项目级包源配置，指向 nuget.feinian.net。
  • src/BackendStarter.Api/Program.cs：宿主入口、Swagger、认证和服务注册。
  • src/BackendStarter.Api/Properties/launchSettings.json：固定本地开发端口为 http://localhost:5000。
  • src/BackendStarter.Api/Controllers/DemoController.cs：最小 API 与受保护接口。
  • src/BackendStarter.Api/Repositories/：数据访问骨架，当前先用内存实现承接接口。
  • src/BackendStarter.Api/Security/HeaderTokenAuthHandler.cs：最小认证骨架。
  • bin/、obj/：本地验证时会生成，但不属于仓库维护内容。

运行方式

dotnet run --project src/BackendStarter.Api/BackendStarter.Api.csproj
  • 默认本地开发地址固定为 http://localhost:5000。
  • 公开验证接口为 /healthz 和 /api/demo/hello。
  • 受保护接口为 /api/demo/secure，默认安全头是 X-Demo-Token: tutorial-token。

当前最终状态

  • 可以通过 dotnet run --project src/BackendStarter.Api/BackendStarter.Api.csproj 启动。
  • 提供 /healthz、/api/demo/hello 和 /api/demo/secure 三个验证入口。
  • 默认本地开发地址固定为 http://localhost:5000，方便和前端代理约定保持一致。
  • 默认安全头为 X-Demo-Token: tutorial-token。
  • 数据访问仍是最小骨架，但目录和注册位置已经固定，后续可替换为 Dapper / SQL 实现。

相关页面