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
co-authored by Claude Opus 4.8
parent 9243a41385
commit 2a2f81dc32
121 changed files with 5899 additions and 31 deletions
@@ -0,0 +1,196 @@
package com.sb.web.account.controller;
import com.sb.web.account.dto.AccountEntryRequest;
import com.sb.web.account.dto.AccountEntryResponse;
import com.sb.web.account.dto.AccountSummary;
import com.sb.web.account.dto.AccountTagRequest;
import com.sb.web.account.dto.AccountTagResponse;
import com.sb.web.account.dto.CategoryStat;
import com.sb.web.account.dto.NetWorthPoint;
import com.sb.web.account.dto.NetWorthResponse;
import com.sb.web.account.dto.PeriodStat;
import com.sb.web.account.dto.RepaymentRequest;
import com.sb.web.account.dto.WalletRequest;
import com.sb.web.account.dto.WalletResponse;
import com.sb.web.account.service.AccountService;
import com.sb.web.auth.dto.SessionUser;
import com.sb.web.auth.web.AuthInterceptor;
import jakarta.validation.Valid;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.List;
/**
* 가계부 API. (/api/account/** — 로그인 필요, 본인 데이터만 접근)
* GET /entries?year=&month= 내역 목록(본인)
* GET /summary?year=&month= 요약(수입/지출/잔액)
* POST /entries 등록
* PUT /entries/{id} 수정(본인)
* DELETE /entries/{id} 삭제(본인)
*/
@RestController
@RequestMapping("/api/account")
@RequiredArgsConstructor
public class AccountController {
private final AccountService accountService;
/* ===== 계좌/카드 (사용자별) ===== */
@GetMapping("/wallets")
public List<WalletResponse> wallets(
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.listWallets(current.getId());
}
@PostMapping("/wallets")
public ResponseEntity<WalletResponse> createWallet(
@Valid @RequestBody WalletRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return ResponseEntity.status(HttpStatus.CREATED).body(accountService.createWallet(req, current.getId()));
}
@PutMapping("/wallets/{id}")
public WalletResponse updateWallet(
@PathVariable Long id,
@Valid @RequestBody WalletRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.updateWallet(id, req, current.getId());
}
@DeleteMapping("/wallets/{id}")
public ResponseEntity<Void> deleteWallet(
@PathVariable Long id,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
accountService.deleteWallet(id, current.getId());
return ResponseEntity.noContent().build();
}
@GetMapping("/networth")
public NetWorthResponse netWorth(
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.netWorth(current.getId());
}
/** 특정 계좌의 연관 내역 */
@GetMapping("/wallets/{id}/entries")
public List<AccountEntryResponse> walletEntries(
@PathVariable Long id,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.listEntriesByWallet(id, current.getId());
}
/** 대출/카드 상환·납부 (원금=이체, 이자=지출 자동 분리) */
@PostMapping("/repayment")
public ResponseEntity<Void> repay(
@Valid @RequestBody RepaymentRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
accountService.repay(req, current.getId());
return ResponseEntity.status(HttpStatus.CREATED).build();
}
/* ===== 가계부 태그 (사용자별) ===== */
@GetMapping("/tags")
public List<AccountTagResponse> tags(
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.listTags(current.getId());
}
@PostMapping("/tags")
public ResponseEntity<AccountTagResponse> createTag(
@Valid @RequestBody AccountTagRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return ResponseEntity.status(HttpStatus.CREATED).body(accountService.createTag(req, current.getId()));
}
@PutMapping("/tags/{id}")
public AccountTagResponse updateTag(
@PathVariable Long id,
@Valid @RequestBody AccountTagRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.updateTag(id, req, current.getId());
}
@DeleteMapping("/tags/{id}")
public ResponseEntity<Void> deleteTag(
@PathVariable Long id,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
accountService.deleteTag(id, current.getId());
return ResponseEntity.noContent().build();
}
@GetMapping("/entries")
public List<AccountEntryResponse> list(
@RequestParam(required = false) Integer year,
@RequestParam(required = false) Integer month,
@RequestParam(required = false) String type,
@RequestParam(required = false) String category,
@RequestParam(required = false) Long walletId,
@RequestParam(required = false) String keyword,
@RequestParam(required = false) Long tagId,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.list(current.getId(), year, month, type, category, walletId, keyword, tagId);
}
/** 분류(카테고리)별 합계 — 파이차트용 */
@GetMapping("/category-stats")
public List<CategoryStat> categoryStats(
@RequestParam(defaultValue = "EXPENSE") String type,
@RequestParam(required = false) Integer year,
@RequestParam(required = false) Integer month,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.categoryStats(current.getId(), type, year, month);
}
/** 월별 순자산 추이 */
@GetMapping("/networth/trend")
public List<NetWorthPoint> netWorthTrend(
@RequestParam(required = false) Integer months,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.netWorthTrend(current.getId(), months);
}
@GetMapping("/stats")
public List<PeriodStat> stats(
@RequestParam(defaultValue = "MONTH") String unit,
@RequestParam(required = false) Integer year,
@RequestParam(required = false) Integer month,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.stats(current.getId(), unit, year, month);
}
@GetMapping("/summary")
public AccountSummary summary(
@RequestParam(required = false) Integer year,
@RequestParam(required = false) Integer month,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.summary(current.getId(), year, month);
}
@PostMapping("/entries")
public ResponseEntity<AccountEntryResponse> create(
@Valid @RequestBody AccountEntryRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return ResponseEntity.status(HttpStatus.CREATED).body(accountService.create(req, current.getId()));
}
@PutMapping("/entries/{id}")
public AccountEntryResponse update(
@PathVariable Long id,
@Valid @RequestBody AccountEntryRequest req,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
return accountService.update(id, req, current.getId());
}
@DeleteMapping("/entries/{id}")
public ResponseEntity<Void> delete(
@PathVariable Long id,
@RequestAttribute(AuthInterceptor.CURRENT_MEMBER) SessionUser current) {
accountService.delete(id, current.getId());
return ResponseEntity.noContent().build();
}
}