JJ AI+ · HRDer AX 바이브코딩
HRD 실전
Claude Code(데스크톱 앱)에서 실습

고객사 장부,
CSV만 넣으면
이익률까지

계산서마다 손으로 옮겨 적던 매출·원가를 불러오기 한 번으로 정리합니다

고객사 매출·원가 장부로컬판웹앱·서버판
JJ Creative 교육연구소
구성약 23분

이 자료는 이렇게 갑니다

0분5분10분15분20분25분오프닝·요청사항PART 1 설계서(PRD)PART 2 로컬판 만들기PART 3 웹앱·서버판점검·마무리 ← 오늘 실습의 중심: 로컬판
HRDer AX · 고객사 매출·원가 장부
요청사항

미리 보내 주신 요청사항

만들고 싶은 것

고객사 DB 관리 자동화, 고객 매출 및 원가 관리 자동화

지금의 불편

고객관리: 별도 CRM 사용 매출 등 관리: 계산서 발행 후 직접 입력

완성되면

고객사별 연간 매출 및 원가 정보가 자동으로 업데이트.

쓰는 사람 · 본인 또는 팀원. 매월 확인.  |  꼭 있어야 하는 기능 ·

HRDer AX · 고객사 매출·원가 장부
오늘의 문제

계산서를 발행하면,
엑셀에 또 옮겨 적는다

HRDer AX · 고객사 매출·원가 장부
오늘 완성할 결과물예상 화면

완성하면 이런 화면이 됩니다

고객사 매출·원가 장부 예상 결과물 화면
  • 계산서·원가 CSV 불러오기(고객사 자동 매칭)
  • 연간 대시보드(매출·원가·이익·이익률 KPI, 월별 추이, 고객사 TOP, 업종·품목·원가 구성)
  • 고객사 DB 표(검색·등급 필터)와 고객사 상세(이익률 게이지·월별 매출)
  • 엑셀용 CSV 내보내기
  • Claude Code가 월간 리포트(report_MM.md) 작성
HRDer AX · 고객사 매출·원가 장부
두 가지 버전

한 자료, 두 가지 버전

로컬판 · 오늘 실습

내 PC 안에서만

Claude Code가 Test 폴더에 앱을 만들고, 내 PC에서 열어 봅니다. 혼자·팀 공유 폴더로 쓰기엔 이것으로 충분합니다.

웹앱·서버판 · 교육 후

모두가 같은 주소로

여러 사람이 각자 접속해 같은 데이터를 쓰려면 서버가 필요합니다. 사내 서버를 IT에 요청하거나, 설치 프로그램으로 직접 연결합니다.

내 과제는 🟢 로컬로 충분 — 계산서 내보내기 파일을 불러와 집계

HRDer AX · 고객사 매출·원가 장부
PART 1
1
PART 1 · 설계서(PRD)

Claude Code가 읽을
설계서부터

PRD.md 한 장이 Claude Code에게 주는 작업 지시서입니다

설계서 ①무엇을 만드나

한 줄 정의

계산서를 발행할 때마다 엑셀에 손으로 옮겨 적던 매출·원가를, 계산서·원가 CSV를 불러오기만 하면 고객사별 연간 매출·원가·이익률이 자동으로 다시 계산되고, 매월 리포트는 Claude Code가 써 주는 고객 관리 앱.

원래 요청에서 오늘 조정한 부분

계산서 발행 후 매출이 자동으로 업데이트→ 계산서 시스템에서 내보낸 CSV를 «불러오기» 하면 고객사별 매출·원가가 다시 계산됨
별도 CRM의 고객사 DB→ CRM에서 내보냈다고 가정한 clients.csv 를 앱의 고객사 DB로 사용
공유 엑셀 양식으로 팀이 함께 보기→ 앱에서 엑셀용 CSV로 내보내 공유 폴더에 두기
HRDer AX · 고객사 매출·원가 장부
설계서 ②데이터·완료 기준

가상 데이터와 완료 기준

실습용 가상 데이터

  • clients.csv · 고객사 DB 30행
  • invoices.csv · 세금계산서 발행 내역 120행
  • costs.csv · 원가 내역 149행

이게 되면 완성

  • 매출 12억 4,610만, 원가 5억 7,224만, 이익률 54.1%
  • 계산서 120건 모두 매칭, 거래 고객 29곳이다
  • 1위 한결건설(2억 6,050만 원), 월별 막대 10개
  • 10월 이익률 46.5%가 가장 낮고 리포트 카드가 보인다
HRDer AX · 고객사 매출·원가 장부
PART 2
2
PART 2 · 로컬판 만들기

Claude Code에게
말로 시킵니다

코드는 Claude가 씁니다. 우리는 다섯 문장을 차례로 붙여 넣습니다

Claude Code 준비

Claude Code 준비 3가지

1

실습 자료 풀기

실습자료 전체.zip 을
다운로드 › Test 폴더에

→
2

Code 탭 · Test

입력창 아래
«이 컴퓨터 · Test» 확인

→
3

편집 자동수락

허락 묻는 창이 뜨면
내용 보고 [허용]

Test 안에 client-ledger 폴더가 생기면 준비 끝

HRDer AX · 고객사 매출·원가 장부
로컬판 실습
STEP 1 · 자료 확인

Claude Code 입력창에 붙여 넣기 Claude Code

지금 열어 둔 Test 폴더 안에 client-ledger 폴더가 있고, 그 안에 PRD.md 와 data 폴더(clients.csv, invoices.csv, costs.csv)가 있는지 확인해줘. 없으면 무엇이 없는지 알려주고 멈춰줘. 있으면 PRD.md 를 끝까지 읽고, 무엇을 만들지 5줄로 요약해줘. 아직 코드는 만들지 마.

보내고 나서 확인할 것

5줄 요약이 내 요청과 맞는지 — 아직 앱을 만들지 않았는지

HRDer AX · 고객사 매출·원가 장부
로컬판 실습
STEP 2 · 화면 만들기

Claude Code 입력창에 붙여 넣기 Claude Code

PRD.md 의 «3. 오늘 만들 기능»과 «7. 기술 원칙»대로 client-ledger 폴더 안에 앱을 만들어줘. 위쪽에 «연간 매출·원가 대시보드»와 «고객사 DB · 계산서 불러오기» 탭 두 개를 둬줘. 인터넷에 올리거나 외부 주소(CDN·글꼴)를 불러오지 말고, 다 만들면 client-ledger 폴더에서 내 PC에서 열어 볼 수 있게 실행해서 내가 열 주소를 알려줘.

보내고 나서 확인할 것

알려 준 주소를 크롬에서 열어 첫 화면이 뜨는지

HRDer AX · 고객사 매출·원가 장부
로컬판 실습
STEP 3 · 계산서 불러오기·자동 계산

Claude Code 입력창에 붙여 넣기 Claude Code

«계산서 CSV 불러오기»에서 data/invoices.csv 와 data/costs.csv 를 고르면, 계산서번호로 원가를 붙이고 고객ID로 data/clients.csv 의 고객사와 짝지어 고객사별 연 매출·원가·이익률을 다시 계산해줘. 짝이 안 맞는 계산서는 따로 표시해줘. 대시보드의 KPI 4개, 월별 매출·원가 선 그래프, 고객사 TOP 막대, 업종 도넛이 바로 바뀌게 하고, 고객사 표의 행을 누르면 그 고객사의 이익률 게이지와 월별 매출 막대가 보이게 해줘. 새로고침해도 남도록 브라우저 저장공간에 저장해줘.

보내고 나서 확인할 것

가상 데이터를 불러온 뒤 숫자가 완료 기준과 같은지

HRDer AX · 고객사 매출·원가 장부
로컬판 실습
STEP 4 · 월간 리포트 (Claude Code)

Claude Code 입력창에 붙여 넣기 Claude Code

client-ledger/data 폴더의 invoices.csv, costs.csv, clients.csv 를 읽고 10월 월간 리포트를 써줘. ① 1~10월 누적 매출·원가·이익률과 10월 실적 ② 이익률이 가장 낮은 고객사 3곳과 이유 추정 ③ 매출이 한 고객사에 몰린 정도 ④ 다음 달 확인할 일 3가지. 금액은 만 원 단위로, 계산은 직접 다시 확인해줘. 결과를 client-ledger/report_10.md 로 저장하고 앱의 «Claude Code 월간 리포트» 카드에 보이게 연결해줘.

보내고 나서 확인할 것

결과 파일이 폴더에 생기고 앱 카드에 보이는지

HRDer AX · 고객사 매출·원가 장부
로컬판 실습
STEP 5 · 테스트·마무리

Claude Code 입력창에 붙여 넣기 Claude Code

PRD.md 의 «9. 완료 기준»을 하나씩 직접 확인해서 ✅/❌ 표로 알려줘. ❌ 가 있으면 고친 뒤 다시 확인해줘. 모두 ✅ 면 client-ledger 폴더를 Test/zip/client-ledger.zip 으로 묶고 파일 탐색기에서 보여줘.

보내고 나서 확인할 것

✅/❌ 표가 모두 ✅ 인지, zip 파일이 생겼는지

HRDer AX · 고객사 매출·원가 장부
막힐 때

이럴 땐 이렇게

허락 묻는 창

내용 보고 [허용]

Test 폴더 밖을 건드리려 하면 [거부] 후 «Test 폴더 안에서만 해줘»

폴더에 생긴 파일

탐색기로 확인

«지금 폴더에 무슨 파일이 생겼는지 쉽게 설명해줘»

화면이 이상할 때

보이는 대로 말하기

«이 버튼을 눌렀는데 그래프가 그대로야. 원인 찾아 고쳐줘»

HRDer AX · 고객사 매출·원가 장부
PART 3
3
PART 3 · 웹앱·서버판

여러 사람이
함께 쓰려면

교육 후, 사내 기준을 확인한 뒤에 하는 부분입니다

웹앱·서버판바뀌는 점

로컬판 → 웹앱판, 무엇이 바뀌나

혼자 또는 팀 공유 폴더로 매월 확인하기에는 로컬판으로 충분합니다. 팀원들이 각자 자기 담당 고객을 같은 주소에서 보고, 불러온 결과를 바로 함께 확인하려면 그때 웹앱이 필요합니다.

로컬판 (오늘)
웹앱판 (교육 후)
입력
담당자가 계산서·원가 CSV 불러오기
담당자가 올리면 팀 전체에 바로 반영
저장
담당자 PC 브라우저 + CSV 파일
Supabase에 고객사·계산서·원가 저장
보기
CSV로 내보내 공유 폴더에 두기
팀원이 같은 주소로 대시보드 확인
권한
필요 없음(혼자 사용)
팀원은 보기만, 불러오기는 담당자만
HRDer AX · 고객사 매출·원가 장부
웹앱·서버판준비

방법 ① 직접 연결 — 준비물

설치 프로그램 하나로

  • 무료 계정 3개: GitHub · Supabase · Vercel
  • HRD-AX-Setup 실행 → 설치·연결 시작
  • 로그인·승인은 본인이 직접
설치 프로그램HRD-AX-Setup.exe (Windows)

Supabase에 만들 표

  • 고객사 · 고객사명·업종·등급·담당자·지역·첫거래일
  • 계산서 · 발행일·고객사·품목·공급가액·세액
  • 원가 · 계산서·원가 항목·금액

담당자: CSV 불러오기·리포트 올리기 / 팀원: 대시보드·고객사 상세 보기

HRDer AX · 고객사 매출·원가 장부
웹앱판 실습교육 후
W1 · 설계를 웹앱용으로

Claude Code 입력창에 붙여 넣기 Claude Code

지금 만든 client-ledger 앱을 팀원들도 같은 주소로 들어와 보는 웹앱으로 바꾸고 싶어. PRD.md 의 «11. 웹앱·서버 버전»을 읽고, 무엇이 바뀌는지와 Supabase에 만들 표 3개를 쉬운 말로 먼저 정리해줘. 내가 OK 하기 전에는 아무것도 바꾸지 마.

보내고 나서 확인할 것

바뀌는 점과 표 3~4개 설명이 내 생각과 맞는지 — OK 전에는 아무것도 바뀌지 않았는지

HRDer AX · 고객사 매출·원가 장부
웹앱판 실습교육 후
W2 · Supabase 연결

Claude Code 입력창에 붙여 넣기 Claude Code

좋아, 진행해줘. Supabase에 새 프로젝트를 만들고 고객사·계산서·원가 표 3개를 만들어줘. data 폴더의 가상 데이터를 채우고, 로그인한 사람만 보고 불러오기·고치기는 담당자만 되게 잠금 설정해줘. 비밀번호나 열쇠 같은 비밀값은 화면에 보여 주지 말고, 내가 넣을 게 있으면 어디에 넣는지만 알려줘.

보내고 나서 확인할 것

로그인 화면이 뜨고, 가상 데이터가 들어갔는지 — 비밀값이 화면에 안 보였는지

HRDer AX · 고객사 매출·원가 장부
웹앱판 실습교육 후
W3 · GitHub에 올리고 Vercel로 배포

Claude Code 입력창에 붙여 넣기 Claude Code

이제 GitHub에 비공개 저장소로 올리고 Vercel로 배포해줘. 비밀값이 저장소에 올라가지 않았는지 먼저 확인하고, 배포가 끝나면 접속 주소를 알려줘.

보내고 나서 확인할 것

접속 주소를 휴대폰으로도 열어 보기

HRDer AX · 고객사 매출·원가 장부
웹앱판 실습교육 후
W4 · 다른 사람 화면으로 확인

Claude Code 입력창에 붙여 넣기 Claude Code

배포된 주소에서 PRD.md 의 «웹앱판 완료 기준»을 하나씩 확인해서 ✅/❌ 표로 알려줘. 담당자 계정과 팀원 계정을 하나씩 가상으로 만들어서, 팀원 화면에는 불러오기 버튼이 없는지도 확인해줘.

보내고 나서 확인할 것

역할별로 보이는 화면이 다른지, 로그인 안 하면 안 보이는지

HRDer AX · 고객사 매출·원가 장부
웹앱·서버판사내 서버
방법 ② · 사내 서버를 IT에 요청

Claude Code 입력창에 붙여 넣기 Claude Code

지금 만든 client-ledger 앱을 우리 팀 몇 명이 매월 함께 보려고 해. 사내 IT 담당자에게 보낼 요청서를 한 장으로 써줘. ① 무엇을 하는 앱인지 ② 누가 몇 명, 얼마나 자주 쓰는지 ③ 저장되는 데이터(고객사 담당자 이름·연락처, 매출·원가 같은 민감한 회사 정보) ④ 필요한 것(사내 서버, 로그인, 백업, 계산서·CRM 연동 가능 여부) ⑤ 지금은 가상 데이터로만 만들었다는 점. 기술 용어는 괄호로 쉽게 풀어줘.

보내고 나서 확인할 것

요청서에 가상 데이터로 만들었다는 점과 필요한 것(사내 서버·로그인·백업)이 들어갔는지

회사 업무용은 이 방법이 기본입니다. 오늘 만든 앱 화면이 가장 좋은 기획서가 됩니다.

HRDer AX · 고객사 매출·원가 장부
최종 점검

최종 점검

HRDer AX · 고객사 매출·원가 장부
마무리

오늘은 로컬판,
함께 쓰려면 웹앱·서버판

JJ Creative 교육연구소 · jjh@jjcreative.co.kr
← → 넘기기 / T 목차 / G 전체 미리보기 / S 발표자 모드 / F 전체 화면