feat: 백엔드 기능 추가 및 개선 #3

rookedsysc · 2025-11-21T17:04:32Z

Summary

Docker 환경 설정 추가 (Dockerfile, docker-compose)
테스트 환경 구성 (pytest, pytest-asyncio, pytest-cov)
스케줄러 작업 함수 모듈 분리
거래 내역 조회에 Cursor 기반 페이지네이션 추가
README 전체 문서화 업데이트
GitHub Actions CI/CD 파이프라인 추가

마이그레이션 스크립트 추가

- Balance: coin_amount 컬럼 추가 - Coin: is_deleted 컬럼 추가 (soft delete) - CoinRepository: soft delete 관련 조회 메서드 추가

- UpbitClient: 업비트 API 호출 클라이언트 - UpbitService: OHLCV 데이터 조회 서비스 - UpbitController: 캔들 데이터 API 엔드포인트 - OHLCV DTO 정의

- CoinService: 코인 등록/조회/삭제 비즈니스 로직 - CoinController: 내 코인 API 엔드포인트 - CoinDTO: 요청/응답 DTO 정의

- v1_router에 /api/v1 prefix 추가 - coin, upbit 라우터 등록 - uvicorn reload 옵션 비활성화

- OpenAI 클라이언트 및 비트코인 트레이딩 분석 기능 구현 - AI 분석 응답 DTO (AiAnalysisResponse) 추가 - 비트코인 분석가 프롬프트 상수 정의

- UpbitService 제거하고 컨트롤러에서 직접 UpbitClient 사용 - DI를 위한 get_upbit_client 함수 추가 - 잔고 조회, 현재가 조회, 매수 기능 추가 - async 함수를 sync 함수로 변경 - 에러 처리 및 입력값 검증 강화

- APScheduler 의존성 추가 (v3.10.0) - AsyncIOScheduler를 앱 라이프사이클에 통합 - 5분 간격 테스트 작업 구현

- RiskLevel에 NONE 타입 추가 (분석 결과 없음 상태) - Alembic 마이그레이션 파일 추가

- get_all_include_deleted 메서드 추가 - 라우터 변수명을 coin_router로 통일 - 트레이드 서비스 기초 구조 추가

- TradeType enum에 HOLD 추가 - Decision.HOLD 케이스에서도 거래 기록 생성 - trade_type 필드에 AI 결정(buy/sell/hold) 저장 - 현재 가격 및 AI 분석 사유 기록

- Trade 모델에 status, execution_reason 필드 추가 - coin_id, trade_type nullable로 변경 - TradeController 및 TransactionResponse DTO 추가 - TradeRepository에 코인 정보 포함 조회 메서드 추가 - v1 라우터에 trade API 등록 - 관련 마이그레이션 파일 추가

- trade_execution_job 추가 (5분마다 AI 분석 및 자동 거래) - TradeService.execute() 호출하여 모든 활성 코인 거래 처리 - 에러 핸들링 및 로깅 추가 - 현재는 주석 처리하여 비활성화 상태

- 코인 삭제 전 잔고가 남아있는지 확인 - 잔고가 있으면 400 에러 반환하여 삭제 방지 - UpbitClient 연동하여 실시간 잔고 조회

- ruff formatter 적용 - Enum 클래스 docstring 개행 추가 - alembic 마이그레이션 파일 포맷팅 - import 순서 정리

- GEMINI.md, CLAUDE.md 제외 - .gemini, .claude 디렉토리 제외

- pyproject.toml 의존성 업데이트 - uv.lock 파일 갱신 - upbit_client.py 개선

GEMINI.md와 .gemini 폴더를 gitignore에 추가

- Dockerfile 및 .dockerignore 추가 - docker-compose.yml 업데이트 - .env.example에 Docker 환경용 기본값 및 설명 추가

- pytest, pytest-asyncio, pytest-mock, pytest-cov 의존성 추가 - pytest 설정 및 테스트 디렉토리 구조 추가

- trade_execution_job을 별도 파일로 분리하여 모듈화 - 스케줄러 활성화 및 실행 주기 설정 (30초)

- TradeRepository에 커서 기반 조회 메서드 추가 - TransactionsResponse에 next_cursor, has_next 필드 추가 - 거래 내역 API에 cursor, limit 쿼리 파라미터 추가 - API 설명 및 사용법 문서화

- 프로젝트 개요, 기술 스택, 구조 설명 추가 - 모듈별 상세 설명 및 API 명세 추가 - 데이터베이스 스키마 및 Enum 정의 추가 - 자동 거래 시스템 흐름 및 에러 처리 문서화 - 설치/실행 가이드 및 환경변수 설명 추가

GitHub Actions 워크플로우 설정 추가

- astral-sh/setup-uv 액션 추가 - pip 캐시를 uv 캐시로 변경 - uv sync로 의존성 설치 - uv run으로 pytest, ruff 실행

CLAUDE.md와 .claude 디렉토리를 무시 목록에 추가

github-actions · 2025-11-21T17:09:03Z

Backend 테스트 커버리지 리포트

File	Stmts	Miss	Cover	Missing
main.py	7	7	0%	7, 9, 12–13, 16–17, 21
ai/client
open_ai_client.py	13	5	61%	12, 15, 27–29
ai/const
constans.py	2	0	100%
ai/dto
ai_analysis_response.py	18	0	100%
ballance/model
balance.py	11	0	100%
ballance/repository
balance_repository.py	11	3	72%	18, 22, 25
coin/model
coin.py	11	0	100%
coin/repository
coin_repository.py	20	9	55%	18, 22–23, 27, 30, 34–35, 39–40
coin/service
coin_service.py	30	19	36%	20–21, 25, 37, 39–41, 46–47, 50–51, 63–64, 66–67, 72–73, 78–79
common/model
base.py	28	13	53%	24, 26–27, 29–33, 39, 50, 60, 70–71
common/repository
base_repository.py	26	14	46%	25–26, 30–33, 37, 41–42, 46–48, 52–53
configs
config.py	18	3	83%	46–48
trade/dto
transaction_response.py	23	0	100%
trade/model
enums.py	16	0	100%
trade.py	26	2	92%	48, 53
trade/repository
trade_repository.py	22	11	50%	19, 23, 28, 36, 41, 53, 56–57, 60, 62–63
trade/service
trade_service.py	155	4	97%	110–111, 114, 213
upbit/client
upbit_client.py	44	27	38%	14–16, 27, 29–30, 34, 47, 58, 60–61, 65, 69–71, 74, 83, 92–93, 101–102, 105–109, 111
upbit/dto
coin_balance.py	4	0	100%
my_ballance_response.py	6	0	100%
ohlcv_dto.py	12	0	100%
TOTAL	503	117	76%

Tests	Skipped	Failures	Errors	Time
29	0 💤	0 ❌	0 🔥	0.930s ⏱️

rookedsysc added 26 commits November 21, 2025 21:57

feat(db): Balance에 coin_amount, Coin에 is_deleted 컬럼 추가

58e2232

마이그레이션 스크립트 추가

feat(model): Balance와 Coin 모델 컬럼 추가

a148d6b

- Balance: coin_amount 컬럼 추가 - Coin: is_deleted 컬럼 추가 (soft delete) - CoinRepository: soft delete 관련 조회 메서드 추가

feat(upbit): 업비트 API 연동 모듈 추가

092f4e6

- UpbitClient: 업비트 API 호출 클라이언트 - UpbitService: OHLCV 데이터 조회 서비스 - UpbitController: 캔들 데이터 API 엔드포인트 - OHLCV DTO 정의

feat(coin): 코인 관리 API 추가

8027685

- CoinService: 코인 등록/조회/삭제 비즈니스 로직 - CoinController: 내 코인 API 엔드포인트 - CoinDTO: 요청/응답 DTO 정의

feat(router): API 라우터 설정 및 엔드포인트 등록

1448191

- v1_router에 /api/v1 prefix 추가 - coin, upbit 라우터 등록 - uvicorn reload 옵션 비활성화

feat(ai): OpenAI 기반 비트코인 분석 모듈 추가

48871b1

- OpenAI 클라이언트 및 비트코인 트레이딩 분석 기능 구현 - AI 분석 응답 DTO (AiAnalysisResponse) 추가 - 비트코인 분석가 프롬프트 상수 정의

feat(scheduler): APScheduler 기반 스케줄러 추가

af745d6

- APScheduler 의존성 추가 (v3.10.0) - AsyncIOScheduler를 앱 라이프사이클에 통합 - 5분 간격 테스트 작업 구현

feat(trade): RiskLevel enum에 NONE 값 추가

c10ef86

- RiskLevel에 NONE 타입 추가 (분석 결과 없음 상태) - Alembic 마이그레이션 파일 추가

feat(coin): 코인 리포지토리 및 라우터 개선

8d18d34

- get_all_include_deleted 메서드 추가 - 라우터 변수명을 coin_router로 통일 - 트레이드 서비스 기초 구조 추가

feat(trade): HOLD 결정 시 거래 기록 추가 및 TradeType enum 확장

aaa5b06

- TradeType enum에 HOLD 추가 - Decision.HOLD 케이스에서도 거래 기록 생성 - trade_type 필드에 AI 결정(buy/sell/hold) 저장 - 현재 가격 및 AI 분석 사유 기록

feat(coin): 코인 삭제 시 잔고 확인 로직 추가

f4307b6

- 코인 삭제 전 잔고가 남아있는지 확인 - 잔고가 있으면 400 에러 반환하여 삭제 방지 - UpbitClient 연동하여 실시간 잔고 조회

style: 코드 포맷팅 및 import 정리

977f44e

- ruff formatter 적용 - Enum 클래스 docstring 개행 추가 - alembic 마이그레이션 파일 포맷팅 - import 순서 정리

chore: .gitignore에 AI 도구 관련 파일 추가

48fba29

- GEMINI.md, CLAUDE.md 제외 - .gemini, .claude 디렉토리 제외

build: 의존성 및 설정 파일 업데이트

230ac1e

- pyproject.toml 의존성 업데이트 - uv.lock 파일 갱신 - upbit_client.py 개선

chore: .gitignore에 Gemini 관련 파일 추가

e50b7b8

GEMINI.md와 .gemini 폴더를 gitignore에 추가

build(docker): Docker 환경 설정 추가

1545cd7

- Dockerfile 및 .dockerignore 추가 - docker-compose.yml 업데이트 - .env.example에 Docker 환경용 기본값 및 설명 추가

test: 테스트 환경 구성 추가

9a4faf4

- pytest, pytest-asyncio, pytest-mock, pytest-cov 의존성 추가 - pytest 설정 및 테스트 디렉토리 구조 추가

refactor(scheduler): 스케줄러 작업 함수 분리

be25194

- trade_execution_job을 별도 파일로 분리하여 모듈화 - 스케줄러 활성화 및 실행 주기 설정 (30초)

ci: GitHub Actions CI/CD 파이프라인 추가

111c632

GitHub Actions 워크플로우 설정 추가

ci(backend): pip에서 uv로 패키지 관리자 변경

b6586af

- astral-sh/setup-uv 액션 추가 - pip 캐시를 uv 캐시로 변경 - uv sync로 의존성 설치 - uv run으로 pytest, ruff 실행

chore: .gitignore에 Claude 설정 파일 추가

de737e9

CLAUDE.md와 .claude 디렉토리를 무시 목록에 추가

rookedsysc merged commit 5e0c022 into main Nov 21, 2025
2 checks passed

rookedsysc deleted the feat/backend branch November 21, 2025 17:09

rookedsysc self-assigned this Nov 21, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: 백엔드 기능 추가 및 개선 #3

feat: 백엔드 기능 추가 및 개선 #3

Uh oh!

rookedsysc commented Nov 21, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Nov 21, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

feat: 백엔드 기능 추가 및 개선 #3

feat: 백엔드 기능 추가 및 개선 #3

Uh oh!

Conversation

rookedsysc commented Nov 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

github-actions bot commented Nov 21, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

rookedsysc commented Nov 21, 2025 •

edited

Loading