Files

T

king 9c58b022e2 feat(expense): 개인경비 모듈 + ERP 좌측메뉴 셸 + expense_db 연결

- ERP 셸: 좌측 사이드바 + 상단 헤더 + 콘텐츠 영역(erp_base.html)
- 분기: 슈퍼관리자 → 업무모듈 카드, 일반사용자 → ERP 메인(erp_home.html)
- 신규 라우트: /modules (슈퍼관리자 모듈 카드 재진입)
- 개인경비 모듈: app/modules/expense/ (라우터/저장소/템플릿)
  - JSON 저장소(ExpenseStore) + PostgreSQL 저장소(ExpenseDBStore)
  - 팩토리: EXPENSE_DB_URL 있으면 DB, 없으면 JSON 폴백
- DB: scripts/sql/expense_db_init.sql (멱등 DDL, postgres-db 컨테이너)
  - expense_db, 역할 expense_app, 테이블 expense_items, 인덱스/트리거
- 마이그레이션: scripts/migrate_expense_json_to_db.py (멱등, --dry-run)
- 의존성: psycopg[binary,pool]>=3.2
- 환경변수: EXPENSE_DB_URL 추가
- 문서: CLAUDE.md 작업 기준 + docs/{PROJECT_OVERVIEW,SERVER_ARCHITECTURE,DATABASES,DEPLOYMENT}.md
  - main-app 배포 경로 /opt/www/main 고정 명시
  - 위험 명령(DROP/TRUNCATE/rm -rf/volume 삭제) 사용자 승인 정책

2026-05-29 02:21:03 +09:00

4.1 KiB

Raw 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, 네이버 스마트스토어, 사방넷 등)

상세는 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.1 KiB Raw Blame History