Claude Code로 프리랜서 정산 관리 대시보드 만들기

프리랜서 강사로 여러 기관에서 강의를 하다 보면, 정산 관리가 점점 복잡해집니다.

- 어떤 기관은 입금이 됐고, 어떤 기관은 아직인지

- 교통비/숙박비 영수증은 제출했는지

- 이번 달 미정산 금액이 총 얼마인지

엑셀에 정리하는건 너무 귀찮고, 정리할 타이밍 놓치면 잊어버리고 있다가 입금 들어오면 들어왔구나.. 하게 되더라구요.

그래서 Claude Code에게 기존 폴더 구조와 엑셀 데이터를 분석시키고, 정산 현황 대시보드를 자동 생성하는 시스템을 만들었습니다.

---

1. 진행 방법

1) 사용 도구

- Claude Code (CLI) — claude-opus-4-6 모델

- Python (openpyxl) — xlsx 읽기 + HTML 생성

- 외부 라이브러리 없음 (csv, pathlib, datetime만 사용)

2) 폴더 구조 분석 요청

먼저 Claude Code에게 기존 강의 폴더 구조를 스캔하도록 했습니다.

```

Treat 02_Lectures as the scanning root, and 90_Settlement_System as the implementation root.

Before writing code, inspect the CSV structure and propose:

- column mapping

- folder matching logic

- receipt validation rules

- excluded folders

- dashboard sections

```

"코드 짜기 전에 먼저 분석하고 제안해"라고 먼저 요청하였습니다.

Claude Code가 자동으로:

- 전체 폴더 트리 탐색 (01_~ 99_기타)

- CSV 파일 3개 발견 및 구조 분석

- 기존 settlement 규칙 파일 읽기

- 14개 컬럼 매핑표, 6개 검증 규칙, 5개 대시보드 섹션을 제안

Claude Code가 만든 파일 구조:

```

90_Settlement_system/

├── data/

│ └── 정산관리.csv ← 마스터 데이터

├── scripts/

│ └── settlement_dashboard.py ← 핵심 스크립트

└── dashboard/

└── index.html ← 생성된 대시보드

```

3) xlsx 지원 추가

CSV로 먼저 만들었는데, 실제로는 엑셀에서 관리하고 싶어서 정산관리.xlsx로 저장했습니다.

1. xlsx 파일 위치 자동 탐색

2. openpyxl 설치 여부 확인

3. xlsx 데이터 읽어서 변경사항 파악

4. 스크립트를 xlsx 우선, csv fallback 구조로 자동 수정

5. 대시보드 재생성

4) 결과

대시보드에는 4가지 섹션이 있습니다:

1. 요약 카드 — 미정산/부분정산/진행중/완료 금액 한눈에

2. 정산 현황 테이블 — 상태별 색상 코딩, 경비 내역, 경고 아이콘

3. 영수증 검증 경고 — 누락된 영수증 목록

4. 월별 정산 현황 — 월별 금액 breakdown

결과와 배운 점

1. "먼저 분석하고 제안해" 라고 하니 초안을 잘 만들어주었습니다.

- 기존 폴더 구조, CSV 구조, 규칙 파일을 먼저 읽게 하니 한번에 맞는 코드가 나왔습니다.

2. CLAUDE.md에 규칙을 미리 정리해두었습니다.

- 정산 상태값, 영수증 네이밍 규칙 등을 미리 정해놓았습니다.

- CLAUDE.md 파일에 비즈니스 규칙을 미리 적어두었습니다.

### 앞으로의 계획

- 강의 폴더에 영수증/ 서브폴더를 만들고 실제 영수증 파일을 넣으면, 대시보드에서 자동 검증

- 새 강의 추가 시 오픈클로한테 "ㅇㅇ건 입금받았어~" "새로운 건 추가 등록해줘" 라고 하면 python코드가 자동으로 실행되도록 해야겠습니다.