msumshk/TakeoutSaaS.Docs

Fork 0

Files

MSuMshk 88ad71041b docs: 初始化 Docs 仓库

2026-01-29 01:58:15 +00:00

10 KiB

Raw Blame History

外卖SaaS系统 - 技术架构

1. 技术栈

1.1 后端技术栈

.NET 10：最新的.NET平台，提供高性能和现代化开发体验
ASP.NET Core Web API：构建RESTful API服务
Entity Framework Core 10：最新ORM框架，用于复杂查询和实体管理
Dapper 2.1+：轻量级ORM，用于高性能查询和批量操作
PostgreSQL 16+：主数据库，支持JSON、全文搜索等高级特性
Redis 7.0+：缓存和会话存储
RabbitMQ 3.12+：消息队列，处理异步任务

1.2 开发工具和框架

AutoMapper：对象映射
FluentValidation：数据验证
Serilog：结构化日志
MediatR：CQRS和中介者模式实现
Hangfire：后台任务调度
Polly：弹性和瞬态故障处理
Swagger/Swashbuckle：API文档生成

1.3 认证授权

JWT (JSON Web Token)：无状态身份认证
IdentityServer/Duende IdentityServer：OAuth2.0和OpenID Connect
ASP.NET Core Identity：用户身份管理

1.4 测试框架

xUnit：单元测试框架
Moq：Mock框架
FluentAssertions：断言库
Testcontainers：集成测试容器化

1.5 DevOps工具

Docker：容器化部署
Docker Compose：本地开发环境
GitHub Actions/GitLab CI：CI/CD流水线
Nginx：反向代理和负载均衡

2. 系统架构

2.1 整体架构

┌─────────────────────────────────────────────────────────────┐
│                        客户端层                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────────┐             │
│  │ Web管理端 │  │ Web用户端 │  │ 小程序端（用户） │             │
│  └──────────┘  └──────────┘  └──────────────┘             │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                      API网关层                               │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  Nginx / API Gateway (路由、限流、认证、日志)          │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                      应用服务层                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │租户服务   │  │商家服务   │  │订单服务   │  │配送服务   │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │用户服务   │  │支付服务   │  │营销服务   │  │通知服务   │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                      基础设施层                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │PostgreSQL │  │  Redis   │  │ RabbitMQ │  │  MinIO   │   │
│  │  (主库)   │  │  (缓存)   │  │ (消息队列)│  │(对象存储) │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
└─────────────────────────────────────────────────────────────┘

2.2 分层架构

2.2.1 表现层 (Presentation Layer)

TakeoutSaaS.AdminApi：管理后台 Web API 项目（/api/admin/v1）
- Controllers：后台管理API控制器
- Filters：过滤器（异常处理、日志、验证）
- Middleware：中间件（认证、租户识别、RBAC）
- Models：请求/响应DTO
TakeoutSaaS.MiniApi：小程序/用户端 Web API 项目（/api/mini/v1）
- Controllers：用户端API控制器
- Filters：过滤器（异常处理、限流、签名校验）
- Middleware：中间件（小程序登录态、租户识别、CORS）
- Models：请求/响应DTO

2.2.2 应用层 (Application Layer)

TakeoutSaaS.Application：应用逻辑
- Services：应用服务
- DTOs：数据传输对象
- Interfaces：服务接口
- Validators：FluentValidation验证器
- Mappings：AutoMapper配置
- Commands/Queries：CQRS命令和查询

2.2.3 领域层 (Domain Layer)

TakeoutSaaS.Domain：领域模型
- Entities：实体类
- ValueObjects：值对象
- Enums：枚举
- Events：领域事件
- Interfaces：仓储接口
- Specifications：规约模式

2.2.4 基础设施层 (Infrastructure Layer)

TakeoutSaaS.Infrastructure：基础设施实现
- Data：数据访问
  - EFCore：EF Core DbContext和配置
  - Dapper：Dapper查询实现
  - Repositories：仓储实现
  - Migrations：数据库迁移
- Cache：Redis缓存实现
- MessageQueue：RabbitMQ实现
- ExternalServices：第三方服务集成

2.2.5 共享层 (Shared Layer)

TakeoutSaaS.Shared：共享组件
- Constants：常量定义
- Exceptions：自定义异常
- Extensions：扩展方法
- Helpers：辅助类
- Results：统一返回结果

3. 核心设计模式

3.1 多租户模式

数据隔离策略：每个租户独立Schema
租户识别：通过HTTP Header或JWT Token识别租户
动态切换：运行时动态切换数据库连接

3.2 CQRS模式

命令（Command）：处理写操作，修改数据
查询（Query）：处理读操作，不修改数据
分离优势：读写分离，优化性能

3.3 仓储模式

抽象数据访问：统一数据访问接口
EF Core仓储：复杂查询和事务处理
Dapper仓储：高性能查询和批量操作

3.4 工作单元模式

事务管理：统一管理数据库事务
批量提交：减少数据库往返次数

3.5 领域驱动设计（DDD）

聚合根：定义实体边界
值对象：不可变对象
领域事件：解耦业务逻辑

4. 数据访问策略

4.1 EF Core使用场景

复杂的实体关系查询
需要变更跟踪的操作
事务性操作
数据库迁移管理

4.2 Dapper使用场景

高性能查询（大数据量）
复杂SQL查询
批量插入/更新
报表统计查询
存储过程调用

4.3 混合使用策略

// EF Core - 复杂查询和实体管理
public async Task<Order> GetOrderWithDetailsAsync(Guid orderId)
{
    return await _dbContext.Orders
        .Include(o => o.OrderItems)
        .Include(o => o.Customer)
        .FirstOrDefaultAsync(o => o.Id == orderId);
}

// Dapper - 高性能统计查询
public async Task<OrderStatistics> GetOrderStatisticsAsync(DateTime startDate, DateTime endDate)
{
    var sql = @"
        SELECT 
            COUNT(*) as TotalOrders,
            SUM(total_amount) as TotalAmount,
            AVG(total_amount) as AvgAmount
        FROM orders
        WHERE created_at BETWEEN @StartDate AND @EndDate";
    
    return await _connection.QueryFirstOrDefaultAsync<OrderStatistics>(sql, 
        new { StartDate = startDate, EndDate = endDate });
}

5. 缓存策略

5.1 缓存层次

L1缓存：内存缓存（IMemoryCache）- 进程内缓存
L2缓存：Redis缓存 - 分布式缓存

5.2 缓存场景

商家信息缓存（30分钟）
菜品信息缓存（15分钟）
用户会话缓存（2小时）
配置信息缓存（1小时）
热点数据缓存（动态过期）

5.3 缓存更新策略

Cache-Aside：旁路缓存，先查缓存，未命中查数据库
Write-Through：写入时同步更新缓存
Write-Behind：异步更新缓存

6. 消息队列应用

6.1 异步任务

订单状态变更通知
短信/邮件发送
数据统计计算
日志持久化

6.2 事件驱动

订单创建事件
支付成功事件
配送状态变更事件

7. 安全设计

7.1 认证机制

JWT Token认证
Refresh Token刷新
Token过期管理

7.2 授权机制

基于角色的访问控制（RBAC）
基于策略的授权
资源级权限控制

7.3 数据安全

敏感数据加密（密码、支付信息）
HTTPS传输加密
SQL注入防护
XSS防护

7.4 接口安全

请求签名验证
接口限流（Rate Limiting）
防重放攻击
CORS跨域配置

10 KiB Raw Blame History Unescape Escape

外卖SaaS系统 - 技术架构

1. 技术栈

1.1 后端技术栈

1.2 开发工具和框架

1.3 认证授权

1.4 测试框架

1.5 DevOps工具

2. 系统架构

2.1 整体架构

2.2 分层架构

2.2.1 表现层 (Presentation Layer)

2.2.2 应用层 (Application Layer)

2.2.3 领域层 (Domain Layer)

2.2.4 基础设施层 (Infrastructure Layer)

2.2.5 共享层 (Shared Layer)

3. 核心设计模式

3.1 多租户模式

3.2 CQRS模式

3.3 仓储模式

3.4 工作单元模式

3.5 领域驱动设计（DDD）

4. 数据访问策略

4.1 EF Core使用场景

4.2 Dapper使用场景

4.3 混合使用策略

5. 缓存策略

5.1 缓存层次

5.2 缓存场景

5.3 缓存更新策略

6. 消息队列应用

6.1 异步任务

6.2 事件驱动

7. 安全设计

7.1 认证机制

7.2 授权机制

7.3 数据安全

7.4 接口安全

10 KiB

Raw Blame History