FreeKit 共享功能与技术参考

共享技术基础

身份认证与授权

所有模块共享的认证与授权机制：

• JWT 令牌认证（Bearer Token）
• 基于角色的权限访问控制（RBAC）
• 访问令牌与刷新令牌机制
• 多租户支持（ITenant 接口过滤器）

数据访问模式

• 仓储模式（IAuditBaseRepository<T>）
• 工作单元模式（Unit of Work，由 Autofac 模块管理）
• FreeSql 作为 ORM（CodeFirst，自动同步表结构）

API 标准

• RESTful API 设计
• 统一 ApiResponse<T> 响应格式
• RapiDoc / Swagger UI 文档
• Area 分组（[Area("cms")]、[Area("identity")] 等）

跨模块共享实体概念

基础实体类

各个模块实体继承自通用基类，包含标准字段：

• FullAuditEntity类：

  • Id：实体主键，根据配置可以是Guid或long类型
  • CreateTime：创建时间
  • CreateUserName：创建人
  • CreateUserId：创建用户ID
  • UpdateTime：最后修改时间
  • UpdateUserId：最后修改人Id
  • UpdateUserName：修改人
  • DeleteUserId 删除人ID
  • DeleteUserName 删除人
  • DeleteTime 删除时间
  • IsDeleted：软删除标记（支持软删除功能）

• ITenant

  • TenantId：租户ID（支持多租户）