data

Python 3.12+ 프로젝트입니다. 패키지 관리는 uv를 사용합니다.

설치

uv sync

개발용 테스트 실행 시에는 uv sync --group dev 후 uv run pytest를 사용합니다.

CI

워크플로는 .github/workflows/ci.yml·issue-autoclose.yml을 참고합니다.

• push(main, dev, feat/*, fix/*, etc/*): tests/ 기준 pytest.
• PR(main·dev 대상): 브랜치·이슈 참조·milestone·라벨·담당자·Development 연결 등 메타데이터 정책 검사와 동일 테스트.
• issue 이벤트: milestone·라벨·담당자(및 선택적 Project 연결 경고) 검사.
• main/dev에 머지된 PR: 본문의 closes/fixes/resolves 이슈를 보조 종료(issue-autoclose).

실행

uv run python main.py

DB 스키마 적용

1차 적용 대상은 Cloud SQL for PostgreSQL 인스턴스의 빈 DB입니다. 절차·파일은 db/migrations/README.md를 참고합니다. 연결 정보·비밀번호는 저장소에 넣지 말고 Secret Manager·환경 변수 등 조직 표준을 따릅니다.

운영 참고

GCP Cloud SQL 샌드박스 개요·IAM DB 사용자 권한·Studio 표시 차이는 docs/가이드-GCP-Cloud-SQL-샌드박스.md를 참고합니다(자리표시자만 포함).