sr2020/billing

经济微服务镜像（sr2020/billing）

镜像概述

sr2020/billing是一个轻量级经济微服务镜像，用于处理账户余额管理、交易操作及相关数据查询。镜像支持MySQL数据库连接，提供Swagger文档接口便于调试，适合作为小型应用的支付或交易模块集成使用。

核心功能

1. 账户信息查询：获取指定账户的余额及交易历史记录
2. 单次转账操作：支持账户间的金额转移，包含参数校验（如非负金额、余额充足等）
3. 数据库调试接口：提供直接访问数据库的方法（仅限内部调试使用）
4. Swagger文档：自动生成接口文档，便于快速了解和测试所有可用接口

使用场景

• 小型电商平台的订单支付模块
• 内部系统的虚拟货币交易管理
• 开发环境中模拟账户交易流程的调试场景

配置说明

镜像通过环境变量配置MySQL连接信息：

• 必填变量：
  • MYSQL_HOST：MySQL服务器地址
  • MYSQL_PASSWORD：MySQL登录密码
• 可选变量：
  • MYSQL_USER：MySQL登录用户名（默认：root）
  • MYSQL_DATABASE：数据库名称（默认：billing）

部署示例

构建镜像

bash
docker build -t sr2020/billing:latest .

运行容器

bash
docker run -d -p 3000:3000 \
  -e MYSQL_HOST=your_mysql_host \
  -e MYSQL_PASSWORD=your_mysql_password \
  -e MYSQL_USER=your_mysql_user \
  -e MYSQL_DATABASE=your_database \
  sr2020/billing:latest

访问接口文档

容器启动后，通过以下地址访问Swagger文档：
http://localhost:3000/explorer/

接口示例

查询账户信息

请求：GET http://localhost:3000/account_info/<sin>
响应示例：

json
{
  "sin": 123,
  "balance": 0,
  "history": [
    {
      "id": 0,
      "created_at": "2019-05-16T21:36:07.523Z",
      "sin_from": 1,
      "sin_to": 2,
      "amount": 100,
      "comment": "For cookies"
    }
  ]
}

单次转账

请求：POST http://localhost:3000/transfer
请求体示例：

json
{
  "sin_from": 1,
  "sin_to": 2,
  "amount": 100,
  "comment": "For cookies"
}

响应：成功时返回空对象{}，参数错误时返回400状态码。