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

이수 현황,
원데이터 넣으면
한눈에 보인다

매달 엑셀로 부서별 이수율을 다시 정리하던 시간을 돌려받습니다

교육 이수 현황 공유로컬판웹앱·서버판
JJ Creative 교육연구소
구성약 23분

이 자료는 이렇게 갑니다

0분5분10분15분20분25분오프닝·요청사항PART 1 설계서(PRD)PART 2 로컬판 만들기PART 3 웹앱·서버판점검·마무리 ← 오늘 실습의 중심: 로컬판
HRDer AX · 교육 이수 현황 공유
요청사항

미리 보내 주신 요청사항

만들고 싶은 것

교육 결과의 원데이터를 주면 매월 부서별로 각 파트에게 리마인드 및 현황을 보낼 수 있게 하고, 본인에게 문자 발송 까지 될 수 있도록 하고 싶습니다. 아니면 그 결과 값들을 실시간으로 확인 할 수 있게 만들면 좋을 것 같습니다.

지금의 불편

지금은 원데이터를 엑셀에서 부서별로 이수율을 정리하여서 파트장들에게 메일을 보내고 있습니다.

완성되면

시각적으로 보았을 때 한눈에 보아도 현황을 바로 알 수 있게 하는것

쓰는 사람 · 교육파트, 매월, 매분기마다 각 교육별로 자주 사용  |  꼭 있어야 하는 기능 · 현황 메일 송부, 문자발송

HRDer AX · 교육 이수 현황 공유
오늘의 문제

매달 초,
이수율 정리가 다시 시작된다

HRDer AX · 교육 이수 현황 공유
오늘 완성할 결과물예상 화면

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

교육 이수 현황 공유 예상 결과물 화면
  • 원데이터 CSV 불러오기
  • 이수율 대시보드(전체·과정별·파트별·부서×과정·월별 추이)
  • 리마인드 대상 목록(파트장 16명·미이수자 85명)
  • 메일·문자 문구 미리보기 + 대상 CSV 내보내기
  • Claude Code 현황 요약·문구(reminders.md) 보기
HRDer AX · 교육 이수 현황 공유
두 가지 버전

한 자료, 두 가지 버전

로컬판 · 오늘 실습

내 PC 안에서만

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

웹앱·서버판 · 교육 후

모두가 같은 주소로

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

내 과제는 🟡 혼합 — 대시보드는 로컬. 메일·문자 자동 발송은 사내 메일·문자 시스템 연동 필요

HRDer AX · 교육 이수 현황 공유
PART 1
1
PART 1 · 설계서(PRD)

Claude Code가 읽을
설계서부터

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

설계서 ①무엇을 만드나

한 줄 정의

교육 결과 원데이터 CSV를 불러오면 부서·파트별 이수율이 한눈에 보이고, 매월 파트장에게 보낼 현황 메일·미이수자 본인에게 보낼 문자의 대상과 문구를 미리 보고 CSV로 내보내는 앱.

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

파트장에게 현황 메일, 본인에게 문자 자동 발송→ 발송 대상 목록 + 문구 미리보기 화면 + 대상 CSV 내보내기
결과를 실시간으로 확인→ 원데이터 CSV를 불러올 때마다 대시보드가 바로 바뀜
HRDer AX · 교육 이수 현황 공유
설계서 ②데이터·완료 기준

가상 데이터와 완료 기준

실습용 가상 데이터

  • courses.csv · 과정 목록 4행
  • completions.csv · 교육 결과 원데이터 130행
  • part_leaders.csv · 파트장 연락처 16행
  • monthly_rate.csv · 월별 이수율 64행

이게 되면 완성

  • 대상 130명, 전체 이수율 74.8%, 4과정 모두 이수 45명
  • 성희롱 80.0·개인정보 70.8·산업안전 69.2·괴롭힘 79.2%
  • 파트별 최저 연회 45.8%, 최고 인사 95.0%
  • 파트장 16명·미이수자 85명, 연회 선택 시 12명
HRDer AX · 교육 이수 현황 공유
PART 2
2
PART 2 · 로컬판 만들기

Claude Code에게
말로 시킵니다

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

Claude Code 준비

Claude Code 준비 3가지

1

실습 자료 풀기

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

→
2

Code 탭 · Test

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

→
3

편집 자동수락

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

Test 안에 training-status 폴더가 생기면 준비 끝

HRDer AX · 교육 이수 현황 공유
로컬판 실습
STEP 1 · 자료 확인

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

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

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
로컬판 실습
STEP 2 · 화면 만들기

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

PRD.md 의 «3. 오늘 만들 기능»과 «7. 기술 원칙»대로 training-status 폴더 안에 앱을 만들어줘. 위쪽에 [이수율 대시보드 / 리마인드 미리보기] 탭을 두고, 외부 인터넷 주소(CDN·글꼴)는 쓰지 마. 다 만들면 training-status 폴더에서 내 PC에서 열어 볼 수 있게 실행하고, 내가 열 주소를 알려줘.

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
로컬판 실습
STEP 3 · 데이터 연결

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

data/completions.csv 를 불러오면 진도율 100을 이수로 보고 전체 이수율, 과정별 이수율, 16개 파트별 이수율(낮은 순, 70% 미만은 빨강), 부서×과정 표를 그려줘. data/monthly_rate.csv 로 월별 추이 선 그래프도 넣어줘. 그래프에 마우스를 올리면 수치가 말풍선으로 보이게 해줘.

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
로컬판 실습
STEP 4 · AI 일 (Claude Code)

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

training-status/data 폴더의 completions.csv 와 part_leaders.csv 를 읽고 ① 파트장 16명에게 보낼 파트별 현황 메일 문구 ② 미이수자 본인에게 보낼 짧은 문자 문구(남은 과목 포함)를 만들어줘. 결과를 training-status/reminders.md 와 발송 대상 목록 training-status/send_list.csv 로 저장하고, 앱의 «문구 미리보기» 카드에 보이게 연결해줘. 실제로 보내지는 마.

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
로컬판 실습
STEP 5 · 테스트·마무리

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

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

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
막힐 때

이럴 땐 이렇게

허락 묻는 창

내용 보고 [허용]

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

폴더에 생긴 파일

탐색기로 확인

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

화면이 이상할 때

보이는 대로 말하기

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

HRDer AX · 교육 이수 현황 공유
PART 3
3
PART 3 · 웹앱·서버판

여러 사람이
함께 쓰려면

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

웹앱·서버판바뀌는 점

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

교육 담당자 혼자 대시보드를 보고 문구를 만드는 데는 로컬판으로 충분합니다. 파트장 16명이 각자 «우리 파트» 현황을 직접 들여다보게 하려면 그때 웹앱이 필요하고, 메일·문자 자동 발송은 사내 메일·문자 시스템 연동이라 IT와 함께 정합니다.

로컬판 (오늘)
웹앱판 (교육 후)
입력
담당자가 원데이터 CSV 불러오기
담당자가 올리면 모든 화면에 바로 반영
저장
담당자 PC 브라우저 + CSV 파일
Supabase에 이수 데이터를 한 곳에 저장
보기
담당자 PC에서만
파트장이 같은 주소로 우리 파트 확인
권한
필요 없음(혼자 사용)
파트장은 우리 파트만, 담당자는 전체
HRDer AX · 교육 이수 현황 공유
웹앱·서버판준비

방법 ① 직접 연결 — 준비물

설치 프로그램 하나로

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

Supabase에 만들 표

  • 과정 · 과정명·구분·이수마감·학습시간
  • 이수 현황 · 사번·이름·부서·파트·과정별 진도율
  • 파트장 · 부서·파트·파트장·로그인 이메일
  • 월별 이수율 · 기준월·부서·파트·전체 이수율

파트장: 로그인 → 우리 파트 현황·미이수자만 보기 / 교육 담당: 원데이터 올리기·전체 대시보드·문구 관리

HRDer AX · 교육 이수 현황 공유
웹앱판 실습교육 후
W1 · 설계를 웹앱용으로

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

지금 만든 training-status 앱을 파트장 16명이 각자 로그인해서 우리 파트 현황만 보는 웹앱으로 바꾸고 싶어. PRD.md 의 «11. 웹앱·서버 버전»을 읽고, 무엇이 바뀌는지와 Supabase에 만들 표 4개를 쉬운 말로 먼저 정리해줘. 내가 OK 하기 전에는 아무것도 바꾸지 마.

보내고 나서 확인할 것

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

HRDer AX · 교육 이수 현황 공유
웹앱판 실습교육 후
W2 · Supabase 연결

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

좋아, 진행해줘. Supabase에 새 프로젝트를 만들고 과정·이수 현황·파트장·월별 이수율 표 4개를 만들어 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

지금 만든 training-status 앱을 교육 담당자와 파트장 16명이 함께 보려고 해. 사내 IT 담당자에게 보낼 요청서를 한 장으로 써줘. ① 무엇을 하는 앱인지 ② 누가 몇 명 쓰는지 ③ 저장되는 데이터(직원 이름·사번·부서·진도율, 파트장 연락처 — 개인정보 있음) ④ 필요한 것(사내 서버, 로그인, 백업, 사내 메일·문자 연동 가능 여부) ⑤ 지금은 가상 데이터로만 만들었다는 점. 기술 용어는 괄호로 쉽게 풀어줘.

보내고 나서 확인할 것

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

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

HRDer AX · 교육 이수 현황 공유
최종 점검

최종 점검

HRDer AX · 교육 이수 현황 공유
마무리

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

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