memory-bank/systemPatterns.md

# 系统模式 (System Patterns)

## 架构概述
本项目将采用基于 FastAPI 的微服务架构。核心是一个 FastAPI 应用，负责接收所有进来的请求，并根据配置将请求转发到相应的后端服务。

```mermaid
graph LR
    Client --> Proxy[FastAPI Proxy]
    Proxy --> BackendA[Backend Service A]
    Proxy --> BackendB[Backend Service B]
    Proxy --> BackendC[Backend Service C]
```

## 设计模式
- **API Gateway Pattern**: FastAPI 应用充当 API 网关，作为客户端访问后端服务的单一入口点。
- **Configuration Pattern**: 代理规则将通过配置文件进行管理，以便于修改和扩展。
- **Middleware Pattern**: 利用 FastAPI 的中间件功能处理请求和响应的通用逻辑（如日志、认证等）。

## 关键组件
- **FastAPI Application**: 核心应用，处理路由和请求转发。
- **Configuration Loader**: 负责加载和解析代理规则配置文件。
- **HTTP Client**: 用于向后端服务发起请求（例如使用 `httpx` 库）。
- **Request/Response Transformer (Optional)**: 根据配置修改请求和响应。

## 数据流
1. 客户端发起请求到 FastAPI Proxy。
2. FastAPI Proxy 接收请求。
3. Configuration Loader 解析配置，查找匹配的代理规则。
4. 如果找到匹配规则，HTTP Client 根据规则向后端服务发起请求。
5. 后端服务返回响应。
6. Request/Response Transformer (如果存在) 修改响应。
7. FastAPI Proxy 将响应返回给客户端。