Files

T

king 269e779129 feat(vacation): 휴가 관리 모듈 — 월간 달력 bar/연차·반차 신청/승인 워크플로/공휴일·연차 설정

- vacation_db 전용 저장소(VacationDBStore), VACATION_DB_URL 미설정 시 '설정 필요' 안내
- 월간 달력: 구글식 휴가 bar(주 단위 lane 배정), 일/공휴일 빨강·토요일 파랑
- 신청 폼: 종류/기간/시작·종료 구분(종일/오전/오후)/사유 + 예상 일수 미리보기
- 일수 계산은 서버(compute_days)에서 주말+공휴일(is_red) 제외 재계산
- 워크플로: 작성중/반려→제출→승인|반려, 취소 soft delete, 본인만 수정(작성중/반려)
- 권한: vacation(접근)/vacation_approver(승인), admin 통과. 설정은 admin 전용
- 공휴일(vacation_holidays) DB 기반 provider + settings CRUD, 연차잔여(vacation_balances)
- 엑셀 내보내기(openpyxl), scripts/sql/vacation_db_init.sql(멱등, 2026 공휴일 seed)
- main.py 등록, 메뉴 ready 전환, docs/.env.example/CLAUDE.md 갱신

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-05-30 08:20:20 +09:00

4.5 KiB

Raw Permalink Blame History

main-app ERP 프로젝트 작업 기준

이 문서는 Claude Code가 이 저장소에서 작업할 때 가장 먼저 확인하는 기준 문서입니다. 작업 시작 전, 아래 "반드시 먼저 읽을 문서"를 모두 확인한 뒤 작업을 시작합니다.

반드시 먼저 읽을 문서

Claude Code는 이 저장소에서 작업을 시작하기 전에 반드시 아래 문서를 순서대로 읽고 맥락을 확보한 뒤 작업한다.

docs/PROJECT_OVERVIEW.md — 프로젝트 정의, 기능 범위, 연동 대상
docs/SERVER_ARCHITECTURE.md — 서버 구성도와 네트워크 흐름
docs/DATABASES.md — PostgreSQL DB 구성과 명명 규칙
docs/DEPLOYMENT.md — 배포 경로, 서비스 실행 방식, 복구 절차

문서 간 내용이 충돌하면 위의 우선순위(1 → 4)를 따른다.

프로젝트 한 줄 정의

main-app은 DBX ERP 시스템의 메인 프로젝트(허브) 이다.

담당 영역:

주문관리
상품코드 매칭
재고관리
CS관리
반품관리
외부 쇼핑몰 API 연동 (카페24, 네이버 스마트스토어, 사방넷 등)
개인경비 (app/modules/expense/, expense_db)
쿠팡 밀크런 (app/modules/cupang/, cupang_db) — 출고 달력/박스 입수량 계산/입고센터 관리, 상품은 itemcode_db 읽기 전용
휴가 관리 (app/modules/vacation/, vacation_db) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 vacation·vacation_approver

상세는 docs/PROJECT_OVERVIEW.md.

개발 원칙

기존 코드를 수정하기 전 관련 파일을 먼저 읽고 구조를 파악한다.
위험 명령은 반드시 사용자 확인 후 실행한다 (아래 "위험 명령" 절 참고).
.env, API 키, DB 비밀번호, OAuth Secret, 토큰은 절대 Git에 올리지 않는다.
신규 DB가 필요하면 승인 요청 후 생성하며, DB명은 반드시 _db로 끝낸다 (예: inventory_db).
예전 문서/코드의 orderlist_app은 현재 기준 orderlist_db이다. 발견 시 수정 대상.

위험 명령 (사용자 확인 없이 실행 금지)

아래 명령은 반드시 사용자에게 의도를 설명하고 명시적 승인을 받은 뒤 실행한다.

분류	명령 예시
파일 삭제	`rm -rf`, `Remove-Item -Recurse -Force`
DB 파괴	`DROP DATABASE`, `DROP TABLE`, `DROP SCHEMA`
데이터 삭제	`TRUNCATE`, 조건 없는 대량 `DELETE`, `UPDATE`
Docker 파괴	`docker volume rm`, `docker volume prune`, `docker system prune -a --volumes`
Git 파괴	`git reset --hard`, `git push --force`, `git clean -fd`, `git branch -D`
운영 초기화	운영 DB 덤프 덮어쓰기, 마이그레이션 롤백

원칙:

실행 전 현재 상태 확인 명령을 먼저 보여준다 (예: docker ps, \l, git status).
백업 존재 여부와 위치를 명시한다.
실행 후 결과 확인 절차를 같이 제시한다.

서버 작업 원칙

배포, DB 복구, Docker 작업 전에는 현재 상태 확인 명령을 먼저 제안한다.
PostgreSQL 작업 전에는 DB명, 컨테이너명, 포트, 백업 위치를 확인한다.
운영 서버 경로와 개발 PC 경로를 혼동하지 않는다.
- 개발 PC: G:\내 드라이브\프로젝트\Main-app
- 운영 서버 (main-app): /opt/www/main ← 본 프로젝트 경로
- 참고용 (같은 호스트 내 다른 서비스 경로): /opt/dbx-corm, /opt/dbx-orderlist
- 명령 예시·문서 작성 시 main-app 경로는 반드시 /opt/www/main 사용. 상세는 docs/DEPLOYMENT.md.

환경 변수 / 비밀값

.env, .env.local, .env.production 은 Git에 절대 커밋하지 않는다.
예시 파일(*.example)만 커밋한다.
비밀값 유출이 의심되면 즉시 회전(rotate)을 권고한다.
신규 환경변수 추가 시 *.example 파일과 본 문서(또는 docs/DEPLOYMENT.md)에 변수 설명을 함께 갱신한다.

디렉터리 구조 (요약)

Main-app/
├─ app/                  FastAPI 앱 소스
├─ docs/                 운영/설계 문서 (작업 전 필독)
├─ scripts/              배포·유지보수 스크립트
├─ skills/               Claude Code 규칙/스킬
├─ docker-compose.yml    운영 컴포즈
├─ docker-compose.local.yml  로컬 컴포즈
├─ Dockerfile
├─ requirements.txt
└─ CLAUDE.md             ← 이 문서

4.5 KiB Raw Permalink Blame History