45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
|
# 通用支付模块智能对接指令 (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` 的核心接口代码。"
|