머니페니 da9abd3e93 docs: CLAUDE.md에서 AI가 이미 아는 내용 제거

Architecture/Environment 섹션, 파일 목적 설명, snake_case 컨벤션,
docker-compose up 등 코드에서 유추 가능한 내용을 삭제하고
프로젝트 고유 정보만 남김

2026-05-13 22:02:49 +09:00

1.7 KiB

Raw Blame History

CLAUDE.md

Project Overview

Galaxis-Po is a quant portfolio management application for DC pension (퇴직연금) investing. It implements the Kim Jong-bong (김종봉) strategy for backtesting, signal generation, and portfolio management. The strategy logic is defined in quant.md — do not modify it without explicit instruction.

Tech Stack

Backend: FastAPI, Python 3.12, SQLAlchemy, PostgreSQL, uv (package manager)
Frontend: Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS v4, shadcn/ui (Radix primitives)
Infrastructure: Docker Compose, PostgreSQL 18

Common Commands

# Backend dev server (from repo root)
cd backend && uv run uvicorn app.main:app --reload

# Frontend dev server
cd frontend && npm run dev

# Run all backend tests
cd backend && uv run pytest

# Run e2e tests
cd backend && uv run pytest tests/e2e/ -v

# DB migration
cd backend && uv run alembic upgrade head

# Create new migration
cd backend && uv run alembic revision --autogenerate -m "description"

# Frontend lint
cd frontend && npm run lint

# Frontend type check
cd frontend && npx tsc --noEmit

Development Rules

Check docs/plans/ for relevant design documents before implementing features
All API endpoints go under backend/app/api/ as routers
DB schema changes require an alembic migration — autogenerate 후 반드시 리뷰하고 즉시 alembic upgrade head
Do not modify .env or docker-compose.prod.yml (.env 설정 안내는 허용, 자동 수정은 금지)
External APIs: pykrx (한국 거래소 데이터, 백테스트/시그널 주력), KIS (실시간 매매), DART (재무제표)
Frontend 변경 후 cd frontend && npx tsc --noEmit 필수