cloudnativedata/bank-account-rest-service

银行账户REST服务镜像文档

镜像概述

本镜像是一个基于Spring Boot框架开发的REST服务，实现了Open Bank Project 银行账户服务接口的基本读写功能，用于处理银行账户相关的API请求。

核心功能与特性

• 基于Spring Boot构建，提供RESTful API接口
• 遵循Open Bank Project OBPv4.0.0账户服务规范
• 支持账户创建(POST)和账户查询(GET)操作
• 依赖Apache Geode/GemFire分布式集群作为数据存储
• 支持本地环境和Kubernetes环境部署

使用场景

适用于需要集成Open Bank Project账户服务接口的***科技应用，可作为银行账户管理的后端服务组件，支持账户信息的存储与查询操作。

部署与配置说明

环境依赖

• Apache Geode或GemFire集群（用于数据存储）
• JDK 8+环境
• Kubernetes集群（如采用容器化部署）

本地环境部署

1. 部署Apache Geode集群

参考Apache Geode快速入门安装并启动Geode集群。

2. 创建数据区域

使用gfsh工具连接集群并创建必要的数据区域：

shell
create region --name=BankAccount --type=PARTITION

3. 启动服务

（此处需补充服务启动命令，原文档未提供，可根据Spring Boot应用常规启动方式执行）

Kubernetes环境部署

1. 部署GemFire集群

安装并部署GemFire集群（具体步骤需参考GemFire Kubernetes部署文档）。

2. 创建数据区域

执行以下命令在GemFire集群中创建数据区域：

shell
kubectl exec gemfire1-locator-0 -- gfsh -e "connect" -e "create region --name=BankAccount --type=PARTITION"

3. 部署服务

shell
kubectl apply -f cloud/k8/apps/account-rest-service

4. 删除服务（如需）

shell
kubectl delete -f cloud/k8/apps/account-rest-service

5. 端口转发

将服务端口映射到本地：

shell
kubectl port-forward deployments/account-rest-service 4001:4001

接口测试

创建账户（POST）

shell
curl -X 'POST' \
  'http://localhost:4001/obp/v4.0.0/banks/gh.29.uk/accounts' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{  
  "user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",  
  "label":"My Account",  
  "product_code":"AC",  
  "balance":{    "currency":"EUR",    "amount":"0"  },  
  "branch_id":"DERBY6",  
  "account_routings":[{    "scheme":"AccountNumber",    "address":"4930396"  }]}'

查询账户（GET）

shell
curl -X 'GET' \
  'http://localhost:4001/obp/v4.0.0/banks/gh.29.uk/accounts/20211130162851787-571565789/account' \
  -H 'accept: */*';echo

注：查询时需将20211130162851787-571565789替换为实际创建的账户ID