|
|
1 mês atrás | |
|---|---|---|
| .agents | 1 mês atrás | |
| app | 1 mês atrás | |
| docs | 2 meses atrás | |
| scripts | 1 mês atrás | |
| tests | 1 mês atrás | |
| .env | 1 mês atrás | |
| .gitignore | 10 meses atrás | |
| Dockerfile | 10 meses atrás | |
| README.md | 1 mês atrás | |
| docker-compose.yml | 2 meses atrás | |
| migrate_plugin_cols.py | 1 mês atrás | |
| requirements.txt | 1 mês atrás | |
| starter.py | 2 meses atrás |
基于 FastAPI + SQLAlchemy + MySQL/Redis 的现代化异步后端服务系统,主要提供签证预约调度协调(Coordinate)、增值服务任务管理(VAS Task)、订单与多渠道支付、智能 Agent 与大模型工具调用、以及消息通知等能力。
签证预约与调度协同 (Coordinate & Free Config)
云端插件热升级与分发系统 (Plugins & Node Management)
订单、账单与多渠道支付 (Orders & Payment)
增值服务与工单系统 (VAS Tasks & Tickets)
大语言模型与 Agent 引擎 (LLM & Intelligent Agent)
多渠道通知分发引擎 (Iris Messenger)
uvloop + httptools)asyncmy / psycopg2-binary) + MySQL 8.xjerry_webapp_2/
├── app/
│ ├── api/ # API 路由层 (公共路由、登录保护路由、管理员路由)
│ │ └── endpoints/ # 各业务领域控制器 (auth, order, payment, plugin, proxy 等)
│ ├── core/ # 核心基础设施 (配置 settings, 数据库 database, 权限 auth, 日志 logger)
│ ├── models/ # SQLAlchemy ORM 数据模型
│ ├── schemas/ # Pydantic 请求/响应数据模型
│ ├── services/ # 核心业务逻辑与服务实现
│ │ └── agent/ # 智能 Agent 引擎、Memory 与内置 Tools
│ ├── utils/ # 公共工具类 (限流 throttler, 优先级队列, 代理辅助, 统一响应等)
│ ├── visa_free_config_fetchers/# 各签证中心自动化抓取适配器
│ └── main.py # FastAPI 应用主入口及中间件、全局异常处理
├── docs/ # 系统详细设计文档 (如 plugin.md 插件管理系统设计)
├── scripts/ # 运维与后台脚本 (如 iris.py 消息推送 Worker、数据库迁移脚本)
├── tests/ # 单元测试与集成测试套件
├── starter.py # 服务启动入口脚本 (支持 DEV / PROD 环境模式切换)
├── requirements.txt # Python 依赖清单
├── Dockerfile # 容器化构建镜像配置
├── docker-compose.yml # Docker Compose 编排文件 (API Backend + Iris Messenger)
└── .env # 环境变量配置文件 (模板/本地环境)
在项目根目录创建或修改 .env 配置文件(参考 .env 模板):
# 全局环境配置: DEV (开发测试) | PROD (生产正式)
ENV=DEV
# 数据库连接 (MySQL 异步驱动)
DATABASE_URL=mysql+asyncmy://<username>:<password>@<host>:<port>/<dbname>?charset=utf8mb4
# Redis 缓存与 Pub/Sub
REDIS_URL=redis://:<password>@<host>:<port>/0
# LLM 大模型配置 (兼容 OpenAI 规范)
LLM_API_KEY=sk-xxxx
LLM_BASE_URL=https://api.deepseek.com
LLM_MODEL=deepseek-v4-flash
# 支付网关配置 (按 ENV 自动路由 PROD 或 TEST 密钥)
STRIPE_PROD_API_KEY=
STRIPE_PROD_WEBHOOK_SECRET=
STRIPE_TEST_API_KEY=
STRIPE_TEST_WEBHOOK_SECRET=
CREEM_PROD_API_KEY=
CREEM_PROD_WEBHOOK_SECRET=
CREEM_TEST_API_KEY=
CREEM_TEST_WEBHOOK_SECRET=
# 消息通知网关配置
TELEGRAM_API_TOKEN=
WECHAT_API_TOKEN=
WHATSAPP_API_BASE_URL=
WHATSAPP_API_KEY=
# 对象存储配置 (Cloudflare R2)
R2_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_BUCKET_NAME=
推荐在虚拟环境中执行:
pip install -r requirements.txt
使用项目统一启动器 starter.py:
开发模式(默认,热重载 + 开启 Swagger 文档):
python starter.py
生产模式(多工作进程 + uvloop + 关闭公网 API 文档):
# Linux / macOS
ENV=PROD WORKERS=4 python starter.py
# Windows PowerShell
$env:ENV="PROD"; $env:WORKERS="4"; python starter.py
服务默认监听 0.0.0.0:8888。
通过容器化方式一键编排启动后端 API 和 Iris 消息队列服务:
# 构建并启动后台容器
docker-compose up -d --build
# 查看运行状态
docker-compose ps
# 查看日志
docker-compose logs -f backend
为确保根包模块 app 正确被解析,在执行单元测试时建议使用 -m pytest 或设置 PYTHONPATH:
# 执行全部单元测试
python -m pytest
# 执行指定模块测试 (例如插件管理或 RBAC 防护测试)
python -m pytest tests/test_plugin_api.py
python -m pytest tests/test_rbac_idor_guards.py
在开发环境(ENV=DEV)启动后,可通过浏览器访问交互式 API 文档:
注:在生产环境(
ENV=PROD)下,出于安全考虑,文档路由将自动关闭。
独立后台服务负责异步消息发送(邮件、微信、Telegram、WhatsApp),具备指数退避重试和频道并发锁防护:
python scripts/iris.py
在 Docker 环境中,docker-compose.yml 已配置该服务作为独立容器 (textskin-messenger) 运行。