Mycontent/addons/Universal_Payment_Module/2_智能对接_AI指令/通用集成指令.md

通用支付模块智能对接指令 (AI Integration Prompt) v3.0

角色设定: 你是一位精通全球支付架构（Alipay/Wechat/PayPal/Stripe/USDT）的资深全栈架构师。

任务目标: 我提供了一个完全配置驱动 (Configuration-Driven) 的通用支付模块设计。 请你根据我的目标项目环境，将此支付功能无缝集成进去。

核心资源 (Input):

1. 标准配置模板: 1_核心设计_通用协议/标准配置模板.yaml (所有支付参数的 Key)
2. API 接口契约: 1_核心设计_通用协议/API接口定义.md (标准 RESTful 接口)
3. 核心业务模型: 1_核心设计_通用协议/业务逻辑与模型.md (数据库表结构)

集成模式 (选择一种):

模式 A: 嵌入式集成 (Library Mode) - 推荐

适用于将支付功能直接写在现有的后端项目中 (如 Django app, NestJS module)。

步骤:

1. 环境识别: 检查我的项目语言 (Python/Node/Go/Java)。
2. 依赖安装: 根据语言推荐 SDK (e.g. alipay-sdk-python, stripe).
3. 配置加载: 创建代码读取 标准配置模板.yaml 中的环境变量。
4. 模型生成: 根据 业务逻辑与模型.md 生成 ORM 代码 (User/Order/PayTrade)。
5. 接口实现: 严格按照 API接口定义.md 实现 Controller/View。
   • 要求: 使用工厂模式 (PaymentFactory) 管理不同网关。

模式 B: 微服务集成 (Microservice Mode)

适用于将支付功能独立部署为一个 Docker 容器。

步骤:

1. 服务生成: 用 Go (Gin) 或 Node.js (Express) 生成一个独立服务。
2. Docker化: 编写 Dockerfile 和 docker-compose.yml。
3. 网关代理: 配置 Nginx 或 API Gateway 将 /api/payment 转发给此服务。

---

给 AI 的执行指令 (Prompt):

"请读取 Universal_Payment_Module 目录下的所有设计文档。 我的当前项目是基于 [你的语言/框架] 的。 请采用 [模式 A / 模式 B] 为我集成支付功能。

1. 首先生成依赖安装命令。
2. 然后生成数据库模型代码。
3. 最后实现符合 API接口定义.md 的核心接口代码。"