Tikkl Bank

蒂克尔银行

人工智能联合创始人培训课程MCP-灰尘银行服务

技术堆栈

• 后端：Java 17，Spring Boot 3.2.0
• 数据库：MySQL 8.0
• 对象关系映射：Spring数据JPA/Hibernate
• 生成工具：8.5级
• 容器：Docker，Docker Compose

快速启动（Quick Start）

以Docker Compose运行（建议）

这是最简单的方法。必须安装Docker和Docker Compose。

# 1. 저장소 클론
git clone https://github.com/yksoo00/tikkl-bank.git
cd tikkl-bank

# 2. Docker Compose로 실행 (MySQL + 애플리케이션)
docker-compose up -d

# 3. 로그 확인
docker-compose logs -f app

# 4. 종료
docker-compose down

# 5. 데이터 포함 완전 삭제
docker-compose down -v

服务器运行后 http://localhost:8080/index.html可以在中测试API。

本地开发环境

如果直接在本地安装和开发MySQL：

# 1. MySQL 설치 및 데이터베이스 생성
mysql -u root -p
CREATE DATABASE tikklbank CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 2. 빌드
./gradlew build

# 3. 실행
./gradlew bootRun

仅使用Docker（MySQL在本地）

# Docker 이미지 빌드
docker build -t tikkl-bank .

# Docker 컨테이너 실행 (로컬 MySQL에 연결)
docker run -p 8080:8080 \
  -e MYSQL_HOST=host.docker.internal \
  -e MYSQL_PORT=3306 \
  -e MYSQL_DATABASE=tikklbank \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=password \
  tikkl-bank

API测试页面

服务器运行后 http://localhost:8080/index.html可以在中测试所有API。

支持：

• 认证（会员注册/登录）
• 仪表板（综合查询储蓄余额、利息、信用卡使用情况、账单计划等）
• 账户管理（注册、存款、取款）
• 卡管理（注册，连接储蓄账户，设定月目标）
• 刷卡和自动储蓄
• 管理卡优惠（折扣、现金回扣、积分等）
• 查看帐单历史记录
• 搜索交易历史记录
• 查询金融产品

项目结构

src/
├── main/
│   ├── java/com/tikkl/bank/
│   │   ├── common/        # 공통 응답 (ApiResponse)
│   │   ├── controller/    # REST API 컨트롤러
│   │   ├── dto/
│   │   │   ├── request/   # 요청 DTO
│   │   │   └── response/  # 응답 DTO
│   │   ├── entity/        # JPA 엔티티
│   │   ├── exception/     # 예외 처리
│   │   ├── repository/    # JPA 레포지토리
│   │   └── service/       # 비즈니스 로직
│   └── resources/
│       └── application.properties
└── test/
    └── java/com/tikkl/bank/

实体

API端点

认证（Auth）

会员（Member）

홈 （主页）

계좌 账户

卡（Card）

信用卡优惠（CardBenefit）

帐单（CardBilling）

交易历史记录（Transaction）

金融产品（Product）

响应结构

成功响应

{
  "success": true,
  "data": { ... },
  "message": "성공 메시지"
}

错误响应

{
  "code": "ERROR_CODE",
  "message": "에러 메시지"
}

错误码

// Common errors
INTERNAL_SERVER_ERROR, VALIDATION_ERROR, INVALID_REQUEST, NOT_FOUND, UNAUTHORIZED, FORBIDDEN

// Member errors
MEMBER_NOT_FOUND, DUPLICATE_LOGIN_ID, DUPLICATE_PHONE_NUMBER, INVALID_PASSWORD

// Account errors
ACCOUNT_NOT_FOUND, DUPLICATE_ACCOUNT, INSUFFICIENT_BALANCE

// Card errors
CARD_NOT_FOUND, INVALID_CARD_TYPE

// Savings errors
SAVINGS_ACCOUNT_NOT_FOUND, SAVINGS_ACCOUNT_ALREADY_EXISTS

// Transaction errors
TRANSACTION_NOT_FOUND, TRANSACTION_FAILED

// Product errors
PRODUCT_NOT_FOUND

环境变量