feat: 가계부·게시판 백엔드 API 구현

- com.sb.web 패키지로 재구성: account / auth / board / user / admin / common
- 가계부(account): 내역(필터), 계좌·순자산, 예산, 분류, 정기 거래, 투자 포트폴리오
  (종목·매매 이력, 이동평균 평단·실현/평가손익)
- MyBatis + MariaDB + Redis 세션, BCrypt
- 스키마 자동 초기화(db/*.sql, 멱등), 사용자별 데이터 격리(member_id)
- 문서: docs/BACKEND.md, .env.example

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ByungCheol
2026-05-31 15:43:09 +09:00
parent 9243a41385
commit 2a2f81dc32
121 changed files with 5899 additions and 31 deletions
+154
View File
@@ -0,0 +1,154 @@
-- ============================================================
-- 가계부 스키마 (MariaDB) — account_entry
-- 본인(member)이 등록한 내역만 조회 가능 (소유자 격리)
-- 실행: 애플리케이션 기동 시 연결된 DB(sbdb)에 자동 생성 (IF NOT EXISTS)
-- ============================================================
-- 계좌/카드/대출 (사용자별) — BANK(은행) / CARD(카드) / LOAN(대출)
-- 잔액 부호: 자산(+) / 부채(카드·대출, ). opening_balance 는 기준일의 부호있는 시작 잔액.
CREATE TABLE IF NOT EXISTS wallet (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
type VARCHAR(10) NOT NULL COMMENT 'BANK / CARD / LOAN / INVEST',
name VARCHAR(50) NOT NULL COMMENT '별칭',
issuer VARCHAR(50) NULL COMMENT '은행명/카드사/대출기관/증권사',
account_number VARCHAR(50) NULL COMMENT '계좌번호(BANK)',
card_type VARCHAR(10) NULL COMMENT 'CREDIT / CHECK (CARD)',
opening_balance BIGINT NOT NULL DEFAULT 0 COMMENT '초기 잔액(부호있음: 자산+, 부채-)',
opening_date DATE NULL COMMENT '초기잔액 기준일',
current_value BIGINT NULL COMMENT '현재 평가금액(INVEST, 수동 갱신)',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_wallet_member (member_id, type)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 기존 wallet 컬럼 추가 (멱등)
ALTER TABLE wallet ADD COLUMN IF NOT EXISTS opening_balance BIGINT NOT NULL DEFAULT 0;
ALTER TABLE wallet ADD COLUMN IF NOT EXISTS opening_date DATE NULL;
ALTER TABLE wallet ADD COLUMN IF NOT EXISTS current_value BIGINT NULL;
CREATE TABLE IF NOT EXISTS account_entry (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
entry_date DATE NOT NULL COMMENT '거래일',
type VARCHAR(10) NOT NULL COMMENT 'INCOME / EXPENSE / TRANSFER',
category VARCHAR(50) NULL COMMENT '분류(식비, 급여 등)',
amount BIGINT NOT NULL COMMENT '금액(원, 양수)',
memo VARCHAR(255) NULL,
wallet_id BIGINT NULL COMMENT '발생/출금 계좌(wallet.id)',
to_wallet_id BIGINT NULL COMMENT '이체 입금 계좌(TRANSFER)',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_account_member_date (member_id, entry_date)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 기존 account_entry 컬럼 추가 (멱등)
ALTER TABLE account_entry ADD COLUMN IF NOT EXISTS wallet_id BIGINT NULL;
ALTER TABLE account_entry ADD COLUMN IF NOT EXISTS to_wallet_id BIGINT NULL;
-- 가계부 태그 (사용자별 관리 — 게시판 태그와 분리)
CREATE TABLE IF NOT EXISTS account_tag (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
name VARCHAR(50) NOT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_account_tag_member_name (member_id, name),
KEY idx_account_tag_member (member_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 정기/반복 거래 규칙 (사용자별)
CREATE TABLE IF NOT EXISTS recurring (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
title VARCHAR(100) NOT NULL COMMENT '이름(월세, 급여 등)',
type VARCHAR(10) NOT NULL COMMENT 'INCOME/EXPENSE/TRANSFER',
amount BIGINT NOT NULL,
category VARCHAR(50) NULL,
memo VARCHAR(255) NULL,
wallet_id BIGINT NULL COMMENT '발생/출금 계좌',
to_wallet_id BIGINT NULL COMMENT '이체 입금 계좌',
frequency VARCHAR(10) NOT NULL COMMENT 'DAILY/WEEKLY/MONTHLY/YEARLY',
day_of_month INT NULL COMMENT 'MONTHLY/YEARLY (1~31)',
day_of_week INT NULL COMMENT 'WEEKLY (1=월~7=일)',
month_of_year INT NULL COMMENT 'YEARLY (1~12)',
start_date DATE NOT NULL,
end_date DATE NULL,
last_run_date DATE NULL COMMENT '마지막 생성된 거래일',
active TINYINT(1) NOT NULL DEFAULT 1,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_recurring_member (member_id, active)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 분류(카테고리) — 사용자별, 수입/지출 타입
CREATE TABLE IF NOT EXISTS account_category (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
type VARCHAR(10) NOT NULL COMMENT 'INCOME / EXPENSE',
name VARCHAR(50) NOT NULL,
sort_order INT NOT NULL DEFAULT 0,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_category_member_type_name (member_id, type, name)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 예산 (사용자별, 카테고리별)
-- fixed=1(고정): base_unit/base_amount 로 일수기준 환산 / fixed=0(비고정): daily/weekly/monthly/yearly 직접
CREATE TABLE IF NOT EXISTS budget (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
category VARCHAR(50) NOT NULL COMMENT '지출 분류',
fixed TINYINT(1) NOT NULL DEFAULT 0,
base_unit VARCHAR(10) NULL COMMENT 'DAY/WEEK/MONTH (고정)',
base_amount BIGINT NULL COMMENT '고정 기준 금액',
daily BIGINT NULL,
weekly BIGINT NULL,
monthly BIGINT NULL,
yearly BIGINT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_budget_member_category (member_id, category)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 가계부 항목 - 태그 (다대다, tag_id 는 account_tag.id 참조)
CREATE TABLE IF NOT EXISTS account_entry_tag (
entry_id BIGINT NOT NULL,
tag_id BIGINT NOT NULL,
PRIMARY KEY (entry_id, tag_id),
KEY idx_aet_tag (tag_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 투자 보유 종목 (INVEST 지갑별 · 사용자별)
CREATE TABLE IF NOT EXISTS invest_holding (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
wallet_id BIGINT NOT NULL COMMENT '투자(INVEST) 지갑 wallet.id',
name VARCHAR(100) NOT NULL COMMENT '종목명',
ticker VARCHAR(20) NULL COMMENT '종목코드(선택)',
current_price BIGINT NULL COMMENT '현재가(원, 수동 갱신)',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_holding_member_wallet (member_id, wallet_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 투자 매매 이력 (종목별 매수/매도)
CREATE TABLE IF NOT EXISTS invest_trade (
id BIGINT NOT NULL AUTO_INCREMENT,
member_id BIGINT NOT NULL COMMENT '소유자 member.id',
holding_id BIGINT NOT NULL COMMENT 'invest_holding.id',
trade_type VARCHAR(10) NOT NULL COMMENT 'BUY / SELL',
trade_date DATE NOT NULL,
quantity BIGINT NOT NULL COMMENT '수량(주)',
price BIGINT NOT NULL COMMENT '단가(원)',
fee BIGINT NOT NULL DEFAULT 0 COMMENT '수수료/세금(원)',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_trade_member_holding (member_id, holding_id),
KEY idx_trade_date (holding_id, trade_date, id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;