Feat: 백엔드(Core API) 세팅

[YuSoeun]

Description

Finora 프로젝트의 백엔드(Core API) 환경을 준비하기 위한 세팅 작업을 정리합니다.

Todo

• 프로젝트 생성

  • IntelliJ에서 Spring Boot 3.5.5 + JDK 21 기반 core-api 모듈 생성
  • 빌드 도구: Gradle (Groovy/Kotlin DSL 선택)

• 의존성 세팅

  • Spring Web: REST API 구축
  • Validation: 입력값 검증
  • Spring Data JPA: ORM + Repository
  • Flyway: DB 마이그레이션 관리
  • PostgreSQL Driver: DB 연결
  • Actuator: 헬스체크 및 메트릭
  • Lombok

• DB 준비

  • PostgreSQL 16 설치 (Windows Git Bash 환경)
  • DB/유저 생성
  • 권한 부여 (GRANT USAGE, CREATE ON SCHEMA public TO SCHEMA_NAME;)

• 마이그레이션 관리

  • db/migration/V1__init.sql 작성
  • users, accounts, transactions 테이블 정의

• 기본 코드 뼈대 생성

  • FinoraCoreApiApplication (Spring Boot entrypoint)
  • 엔티티/리포지토리: User, Account, Transaction
  • DTO: CreateTxnReq, TxnResp
  • Service: TransactionService (트랜잭션 생성 + dedup hash)
  • Controller: TransactionController (POST/GET API)
  • GlobalExceptionHandler (Validation/DB 예외 처리)

• 실행 및 확인

  • Flyway가 테이블 생성되는지 확인
  • /actuator/health 응답 200
  • /swagger에서 OpenAPI 문서 확인
  • 샘플 POST/GET 호출 정상 동작 확인

• Micrometer 연동

  • 기본 메트릭 + 커스텀 카운터/타이머 추가

ETC

No response