fengling-console/.planning/codebase/STACK.md
movingsam b8d2a93c9f docs: 添加代码库分析文档(中文)
- STACK.md - 技术栈和依赖
- INTEGRATIONS.md - 外部集成
- ARCHITECTURE.md - 架构设计
- STRUCTURE.md - 代码库结构
- CONVENTIONS.md - 编码规范
- TESTING.md - 测试模式
- CONCERNS.md - 技术债务和问题
2026-02-28 18:38:17 +08:00

2.0 KiB
Raw Blame History

技术栈

分析日期: 2026-02-28

语言

主要:

  • C# (.NET 10.0) - 后端 API 开发

次要:

  • JSON - 配置文件和数据交换格式

运行时

环境:

  • .NET 10.0.103 SDK
  • ASP.NET Core 10.0 Web 应用

包管理:

  • NuGet
  • global.json 指定 SDK 版本 10.0.103rollForward: latestMinor

框架

核心:

  • ASP.NET Core 10.0 - Web 框架
  • Entity Framework Core - ORM用于数据访问
  • Npgsql.EntityFrameworkCore.PostgreSQL - PostgreSQL 数据库驱动

身份认证:

  • OpenIddict - OAuth 2.0 / OIDC 身份提供商
  • Microsoft.AspNetCore.Authentication.JwtBearer - JWT 令牌认证

其他:

  • Swashbuckle.AspNetCore - Swagger/OpenAPI 文档
  • QRCoder + SkiaSharp - 二维码生成
  • NetCorePal.Extensions - 扩展库集合

关键依赖

核心业务:

  • Npgsql.EntityFrameworkCore.PostgreSQL - PostgreSQL 数据库访问
  • OpenIddict.* - 身份认证和授权
  • Microsoft.AspNetCore.Identity.EntityFrameworkCore - 用户身份管理

扩展库:

  • NetCorePal.Extensions.AspNetCore - ASP.NET Core 扩展
  • NetCorePal.Extensions.DistributedLocks.Redis - 分布式锁
  • NetCorePal.Extensions.Repository.EntityFrameworkCore - 仓储模式

工具库:

  • Swashbuckle.AspNetCore - API 文档
  • QRCoder + SkiaSharp - 二维码生成
  • Microsoft.OpenApi - OpenAPI 支持

项目引用

  • YarpGateway - 反向代理网关
  • Fengling.Platform.Infrastructure - 平台基础设施

配置

环境配置:

  • appsettings.json - 默认配置
  • appsettings.Development.json - 开发环境配置
  • launchSettings.json - 启动配置

数据库连接:

  • DefaultConnection - 平台数据库 (PlatformDbContext)
  • GatewayConnection - 网关数据库 (GatewayDbContext)

平台要求

开发:

  • .NET 10.0 SDK
  • PostgreSQL 数据库
  • Visual Studio Code / Rider / Visual Studio

生产:

  • Docker 容器化部署
  • Linux 服务器
  • PostgreSQL 数据库

技术栈分析2026-02-28