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
@@ -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;
|
||||
@@ -0,0 +1,79 @@
|
||||
-- ============================================================
|
||||
-- 자유게시판 스키마 (MariaDB) — post / tag / post_tag / comment
|
||||
-- 실행: 애플리케이션 기동 시 연결된 DB(sbdb)에 자동 생성됨 (IF NOT EXISTS)
|
||||
-- ============================================================
|
||||
|
||||
-- 게시글
|
||||
CREATE TABLE IF NOT EXISTS post (
|
||||
id BIGINT NOT NULL AUTO_INCREMENT,
|
||||
title VARCHAR(200) NOT NULL,
|
||||
content LONGTEXT NOT NULL,
|
||||
author_id BIGINT NOT NULL COMMENT 'member.id',
|
||||
author_name VARCHAR(100) NOT NULL COMMENT '표시용(비정규화)',
|
||||
view_count INT NOT NULL DEFAULT 0,
|
||||
blocked TINYINT(1) NOT NULL DEFAULT 0 COMMENT '관리자 열람 제한 여부',
|
||||
block_reason VARCHAR(255) 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_post_created (created_at)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
|
||||
-- 기존 post 테이블에 컬럼 추가 (멱등)
|
||||
ALTER TABLE post ADD COLUMN IF NOT EXISTS blocked TINYINT(1) NOT NULL DEFAULT 0;
|
||||
ALTER TABLE post ADD COLUMN IF NOT EXISTS block_reason VARCHAR(255) NULL;
|
||||
-- 큰 이미지(base64 인라인) 수용을 위해 content 를 LONGTEXT 로 확대 (멱등)
|
||||
ALTER TABLE post MODIFY content LONGTEXT NOT NULL;
|
||||
|
||||
-- 태그 카테고리(그룹) — 예: 게시판, 게시판2 ...
|
||||
CREATE TABLE IF NOT EXISTS tag_category (
|
||||
id BIGINT NOT NULL AUTO_INCREMENT,
|
||||
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_tag_category_name (name)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
|
||||
-- 태그 (카테고리에 소속)
|
||||
CREATE TABLE IF NOT EXISTS tag (
|
||||
id BIGINT NOT NULL AUTO_INCREMENT,
|
||||
name VARCHAR(50) NOT NULL,
|
||||
category_id BIGINT NULL,
|
||||
PRIMARY KEY (id),
|
||||
UNIQUE KEY uk_tag_name (name),
|
||||
KEY idx_tag_category (category_id)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
|
||||
-- 기존 tag 테이블에 category_id 가 없으면 추가 (멱등)
|
||||
ALTER TABLE tag ADD COLUMN IF NOT EXISTS category_id BIGINT NULL;
|
||||
|
||||
-- 게시글-태그 (다대다)
|
||||
CREATE TABLE IF NOT EXISTS post_tag (
|
||||
post_id BIGINT NOT NULL,
|
||||
tag_id BIGINT NOT NULL,
|
||||
PRIMARY KEY (post_id, tag_id),
|
||||
KEY idx_post_tag_tag (tag_id)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
|
||||
-- 게시판 설정 (단일 행) — 게시판에서 사용할 태그 카테고리 지정
|
||||
CREATE TABLE IF NOT EXISTS board_setting (
|
||||
id BIGINT NOT NULL,
|
||||
tag_category_id BIGINT NULL COMMENT '이 게시판에서 사용 가능한 태그 카테고리',
|
||||
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (id)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
|
||||
INSERT IGNORE INTO board_setting (id, tag_category_id) VALUES (1, NULL);
|
||||
|
||||
-- 댓글
|
||||
CREATE TABLE IF NOT EXISTS comment (
|
||||
id BIGINT NOT NULL AUTO_INCREMENT,
|
||||
post_id BIGINT NOT NULL,
|
||||
author_id BIGINT NOT NULL,
|
||||
author_name VARCHAR(100) NOT NULL,
|
||||
content VARCHAR(1000) NOT NULL,
|
||||
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (id),
|
||||
KEY idx_comment_post (post_id)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
@@ -0,0 +1,11 @@
|
||||
-- ============================================================
|
||||
-- 개발용 시드 (매 기동 시 실행, 멱등)
|
||||
-- ⚠️ 운영 배포 시에는 제거하세요.
|
||||
-- ============================================================
|
||||
|
||||
-- 테스트 계정 testuser01 을 관리자(ADMIN)로 승격
|
||||
UPDATE member SET role = 'ADMIN' WHERE login_id = 'testuser01';
|
||||
|
||||
-- 레거시(카테고리 미지정) 태그 정리: 새 태그 체계는 모두 카테고리에 소속됨
|
||||
DELETE FROM post_tag WHERE tag_id IN (SELECT id FROM (SELECT id FROM tag WHERE category_id IS NULL) x);
|
||||
DELETE FROM tag WHERE category_id IS NULL;
|
||||
@@ -0,0 +1,21 @@
|
||||
-- ============================================================
|
||||
-- 회원(member) 테이블 (MariaDB)
|
||||
-- 로컬(아이디/비밀번호) + 소셜(네이버 등) 로그인 확장을 고려한 설계
|
||||
-- 실행: 애플리케이션 기동 시 연결된 DB(sbdb)에 자동 생성됨
|
||||
-- ============================================================
|
||||
CREATE TABLE IF NOT EXISTS member (
|
||||
id BIGINT NOT NULL AUTO_INCREMENT,
|
||||
login_id VARCHAR(50) NULL COMMENT '로컬 로그인 아이디 (소셜 전용 계정은 NULL)',
|
||||
password VARCHAR(100) NULL COMMENT 'BCrypt 해시 (소셜 전용 계정은 NULL)',
|
||||
name VARCHAR(100) NOT NULL COMMENT '이름/닉네임',
|
||||
email VARCHAR(255) NULL,
|
||||
provider VARCHAR(20) NOT NULL DEFAULT 'LOCAL' COMMENT 'LOCAL / NAVER',
|
||||
provider_id VARCHAR(100) NULL COMMENT '소셜 제공자 측 고유 사용자 ID',
|
||||
role VARCHAR(20) NOT NULL DEFAULT 'USER' COMMENT 'USER / ADMIN',
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE / SUSPENDED / WITHDRAWN',
|
||||
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_member_login_id (login_id),
|
||||
UNIQUE KEY uk_member_provider (provider, provider_id)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||||
Reference in New Issue
Block a user