feat: 完整重构小程序匹配功能 + 修复UI对齐 + 文章数据API

主要更新: 1. 按H5网页端完全重构匹配功能(match页面) - 4种匹配类型: 创业合伙/资源对接/导师顾问/团队招募 - 资源对接等类型弹出手机号/微信号输入框 - 去掉重新匹配按钮，改为返回按钮 2. 修复所有卡片对齐和宽度问题 - 目录页附录卡片居中 - 首页阅读进度卡片满宽度 - 我的页面菜单卡片对齐 - 推广中心分享卡片统一宽度 3. 修复目录页图标和文字对齐 - section-icon固定40rpx宽高 - section-title与图标垂直居中 4. 更新真实完整文章标题(62篇) - 从book目录读取真实markdown文件名 - 替换之前的简化标题 5. 新增文章数据API - /api/db/chapters - 获取完整书籍结构 - 支持按ID获取单篇文章内容
2026-01-21 15:49:12 +08:00
parent 1ee25e3dab
commit b60edb3d47
197 changed files with 34430 additions and 7345 deletions
--- a/addons/Universal_Payment_Module
+++ b/addons/Universal_Payment_Module
@@ -0,0 +1,142 @@
+# 🌐 全球通用支付模块 (Universal Payment Module) v4.0
+
+> **配置驱动 (Configuration-Driven)** | **API 优先 (API-First)** | **AI 智能对接**
+> 
+> 让任何语言的项目在 5 分钟内接入支付宝、微信支付、PayPal、Stripe 和 USDT
+
+## 📂 模块结构
+
+```
+Universal_Payment_Module/
+├── 1_核心设计_通用协议/           # [灵魂] 定义了支付的"法律"
+│   ├── 标准配置模板.yaml        # 填空即可配置所有支付参数
+│   ├── API接口定义.md           # 无论用什么语言，接口都长这样
+│   ├── 业务逻辑与模型.md        # 数据库表结构设计 (Order/PayTrade)
+│   └── 安全与合规.md            # 支付安全最佳实践
+│
+├── 2_智能对接_AI指令/             # [工具] AI 编译器
+│   ├── 通用集成指令.md          # 发给 AI，自动生成代码
+│   └── Cursor规则.md            # Cursor IDE 专用规则
+│
+├── 3_逻辑参考_通用实现/           # [参考] 可直接复用的代码
+│   ├── 前端收银台Demo.html      # 原生 JS 实现的通用收银台
+│   ├── 后端源码/                # 多语言参考实现
+│   │   ├── php/                 # PHP (Laravel/Symfony)
+│   │   ├── python/              # Python (FastAPI/Django)
+│   │   ├── nodejs/              # Node.js (Express/NestJS)
+│   │   └── java/                # Java (Spring Boot)
+│   └── 前端模板/                # Vue/React/原生JS 模板
+│
+├── 4_卡若配置/                    # [私有] 卡若的支付密钥 (勿提交Git)
+│   └── .env.example             # 配置示例
+│
+└── README.md                     # 本说明文档
+```
+
+## 🚀 极速对接 (3步完成)
+
+### 第一步：配置 (Config)
+```bash
+# 1. 复制配置模板到你的项目
+cp 1_核心设计_通用协议/标准配置模板.yaml your-project/.env
+
+# 2. 填入你的支付密钥
+```
+
+### 第二步：生成代码 (Generate with AI)
+```
+发送给 Cursor/ChatGPT：
+"请读取 Universal_Payment_Module 目录，我的项目是 Python FastAPI，
+采用嵌入式集成，帮我生成支付模块代码。"
+```
+
+### 第三步：前端接入 (Frontend)
+```javascript
+// 只需调用一个 API
+const result = await fetch('/api/payment/checkout', {
+  method: 'POST',
+  body: JSON.stringify({ order_sn: '202401170001', gateway: 'wechat_jsapi' })
+});
+```
+
+## 🌍 支持的支付渠道
+
+| 渠道 | 能力 | 场景 | 状态 |
+|:---|:---|:---|:---|
+| **支付宝 Alipay** | 扫码/H5/APP/小程序 | 中国市场 (CNY) | ✅ 已实现 |
+| **微信支付 Wechat** | JSAPI/Native/H5/APP/小程序 | 中国市场 (CNY) | ✅ 已实现 |
+| **PayPal** | 信用卡/订阅 | 全球市场 (USD/EUR) | ✅ 已实现 |
+| **Stripe** | 信用卡/订阅/Apple Pay | 全球市场 | ✅ 已实现 |
+| **USDT (TRC20)** | 链上转账/监听 | Web3/抗审查 | ✅ 已实现 |
+
+## ✨ v4.0 核心特性
+
+### 1. 配置驱动 (Zero-Code Config)
+- 所有密钥通过环境变量注入，无需改动代码
+- 支持多环境切换 (development/production)
+
+### 2. 工厂模式 (Payment Factory)
+```python
+# 所有支付网关统一接口
+payment = PaymentFactory.create('wechat')
+result = payment.create_trade(order)
+```
+
+### 3. 幂等性保障 (Idempotency)
+- 回调通知自动去重
+- 订单状态机管理
+
+### 4. AI 智能生成
+- 提供 Cursor/Copilot 专用提示词
+- 一键生成任意语言的完整实现
+
+## 📖 快速参考
+
+### 创建订单
+```http
+POST /api/payment/create_order
+Content-Type: application/json
+
+{
+  "user_id": "u1001",
+  "title": "VIP会员",
+  "amount": 99.00,
+  "currency": "CNY",
+  "product_id": "vip_monthly"
+}
+```
+
+### 发起支付
+```http
+POST /api/payment/checkout
+Content-Type: application/json
+
+{
+  "order_sn": "202401170001",
+  "gateway": "wechat_jsapi",
+  "openid": "oXxx..."
+}
+```
+
+### 支付状态查询
+```http
+GET /api/payment/status/202401170001
+```
+
+## 🔐 安全须知
+
+1. **密钥安全**: 所有密钥存放在 `.env`，**绝不提交到 Git**
+2. **HTTPS 强制**: 生产环境必须启用 HTTPS
+3. **签名验证**: 所有回调必须验签
+4. **金额校验**: 支付金额必须与订单金额匹配
+
+## 📚 相关文档
+
+- [API 接口定义](./1_核心设计_通用协议/API接口定义.md)
+- [数据库模型](./1_核心设计_通用协议/业务逻辑与模型.md)
+- [AI 集成指令](./2_智能对接_AI指令/通用集成指令.md)
+- [Cursor 规则](./2_智能对接_AI指令/Cursor规则.md)
+
+---
+
+**作者**: 卡若 | **联系**: 28533368 (微信) | **更新**: 2026-01-17