memory-bank/systemPatterns.md

系统模式 (System Patterns)

架构概述

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

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 将响应返回给客户端。