我们上线了一个多项目订单支付管理系统

AI 知识库3天前发布
645 0 0
熊猫办公
随着Vibe Coding的项目越来越多,功能也越来越丰富,我们终于打通了支付这一关。于是我们从零开始完成了一个支付中台系统,可以接入各种项目的支付,准备将之前的实时互动数字人系统、数字人智能课程系统、3D数字人从生成到动作的工作流等项目一一接入进来,这样我们就从内测系统直接转变成全生态链的系统了,方便大家随时体验。

目标:构建一个统一的订单支付中台,支持多个内部工具/系统(例如数字人项目)接入支付功能(微信支付、支付宝)。实现订单统一管理、资金对账、分账、发票标记、报表导出等功能,方便追踪每个项目的收支情况。技术栈(前端)

  • React 18+ + Vite
  • Tailwind CSS
  • 推荐:TypeScript、TanStack Query(数据 fetching)、Zustand 、React Router v6、Ant、Recharts 图表)

核心价值

  • 多项目(多租户)隔离:每个项目独立 Project ID,订单归属项目。
  • 标准化 API:其他系统通过 HTTP 接口推送订单/支付回调。
  • 资金透明:用户支付金额、入账金额、手续费、分账、结余清晰可见。
  • 扩展性:支持发票标记、点数消耗场景。

用户角色与权限

  • 超级管理员
    管理所有项目、用户、报表、全局配置。
  • 项目管理员
    查看/管理自己项目的订单、报表。
  • 财务/运营
    查看资金对账、分账、导出报表。
  • API 调用方
    通过接口推送订单,无界面。

3. 核心功能模块
3.1 项目管理

  • 新建项目:名称、描述、负责人、联系方式等 → 自动生成唯一Project ID
  • 项目列表:搜索、筛选、状态(活跃/停用)。
  • 项目详情:关联订单统计、累计收入、当前结余等。

3.2 订单管理

  • 订单列表:支持按项目、支付渠道(微信/支付宝)、状态(待支付、支付成功、失败、退款)、时间范围筛选。
  • 订单详情:
    • 订单号、Project ID、外部系统订单ID、用户ID、金额(用户支付金额)。
    • 实际入账金额、手续费(微信/支付宝费率配置)、分账明细。
    • 支付时间、回调状态、支付凭证。
    • 发票标记:手动标记“已开票”/“无需发票”,记录发票信息。
  • 订单创建:支持手动录入(后台)和 API 推送。
  • 状态同步:接收支付成功/失败回调,更新订单状态并返回响应。

3.3 支付渠道与配置

  • 支持微信支付、支付宝。
  • 渠道配置:商户号、AppID、密钥、费率(支持不同项目不同费率)。
  • 支付回调处理:标准 webhook 接口。
  • 测试模式与生产模式切换。

3.4 分账功能(合伙人分账)

  • 订单分账规则:按比例、固定金额、自定义规则。
  • 分账记录:每次订单的分账明细(合伙人ID、金额、状态)。
  • 合伙人管理:添加合伙人、设置分账比例/规则。

3.5 资金对账与报表

  • 资金总览仪表盘:总收入、入账金额、总手续费、净结余、按项目/渠道饼图、趋势图。
  • 明细对账:用户支付 vs 系统入账 vs 手续费 vs 分账 vs 结余。
  • 报表导出:
    • 支持 Excel/CSV(订单列表、资金明细、项目汇总)。
    • 按时间、项目、渠道筛选。
  • 每日/月度对账单生成。

3.6 其他通用功能

  • 用户/权限管理(RBAC)。
  • 操作日志、审计。
  • 通知(站内信支付成功)。
  • 数据导入导出、搜索、分页、筛选。
  • 暗黑模式、响应式布局。

3.7. 非功能需求

  • 安全性:JWT 认证、数据加密、防止重复支付。
  • 性能:支持高并发订单查询,数据库索引。
  • 可扩展性:易于添加新支付渠道。
  • 部署:Vite 构建静态资源,前端可独立部署。
  • 数据持久化:配套后端(Node.js)+PostgreSQL + Redis。

4. API 接口(供其他项目调用)使用 RESTful + Webhook

  1. 创建订单
    POST /api/ordersBody: { projectId, externalOrderId, amount, description, userId, notifyUrl, returnUrl, … }
    Response: 支付参数(QR code / JSAPI 参数等)。
  2. 支付回调
    (平台主动回调其他系统,或提供查询接口)。
  3. 查询订单
    GET /api/orders/{orderId}
  4. 退款

提供 OpenAPI/Swagger 文档。支持签名验证和 IP 白名单安全。示例场景(数字人项目)

  • 用户充值 → 调用 API 创建订单 → 支付成功 → 系统增加用户点数 → 标记是否开发票 → 消耗点数记录(可选关联)。

5. 页面结构

  • 登录页
    我们上线了一个多项目订单支付管理系统
  • 仪表盘
    我们上线了一个多项目订单支付管理系统
  • 项目管理
    我们上线了一个多项目订单支付管理系统
  • 订单列表 + 详情
    我们上线了一个多项目订单支付管理系统
    我们上线了一个多项目订单支付管理系统
  • 分账管理
    我们上线了一个多项目订单支付管理系统
  • API 文档
    我们上线了一个多项目订单支付管理系统
  • 用户 & 设置
    我们上线了一个多项目订单支付管理系统
这次重点尝试了微信和支付宝的两个官方支付Skills,在Claude安装后,很快就帮我接通了最新版本的支付功能。
我们上线了一个多项目订单支付管理系统
1. 微信支付Skills

https://github.com/wechatpay-apiv3/wechatpay-skills微信支付全产品接入指引,支持 JSAPI、Native、H5、App、付款码 等各种场景。

npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --yes

2. 支付宝Skills

https://www.modelscope.cn/skills/PantherAng/alipay-payment-integration/

npx skills add ./skills/alipay-payment-integration --yes

写在最后:
有了这套系统,今后就再也不采用出售代码的方式了,今后所有对外体验的产品都接入支付,准备躺着赚钱了,从To B 转向To C业务,相应的产品质量也会提升的。
关于作者
做一只爬的最久的乌龟,保持学习保持好奇,即使慢一点,遇到一点困难,只要最后能到达终点,又有什么关系呢。
毕竟人生没有白走的路,每一步都算数。
© 版权声明

相关文章