교육 수료증 발급 자동화 웹페이지 제작
소개
소속 연구실에서 진행한 교육에 대해 수료증이 120여개 발급될 예정인데, '수료증 제작->수료자 개별 이메일 발송' 작업에 품이 많이 들 것으로 예상되었다. 이를 '수료증 다운로드 홈페이지'를 제작하여 수료자가 직접 다운로드받을 수 있게 함으로써 품을 줄이고자 '교육 수료증 발급 자동화 웹페이지 제작' 프로젝트를 시작했다.
※참고사항
본래 내 목표는 'LCA 평가대상 분류 및 단위환산 자동화'였다. 하지만 클로드는 고사하고 바이브코딩이 처음인 나에게는 초장부터 너무 큰 목표인 것 같다는 생각이 들어, 중간 목표로 '교육 수료증 발급 자동화 웹페이지 제작'을 수립하게 되었다.
진행 방법
VS Code에서 Claude Code를 실행시켜 바이브코딩을 진행하였고 기획문서 작업, 간헐적 질문 등은 Claude AI를 활용하였다.
■ 사용 프롬프트
나는 2026 탄소중립평가사 교육 수료증 자동 발급 홈페이지를 만들거야. 내 생각에는 이걸 에이전트를 생성해서 개발하면 좋을것같아. 에이전트1 : 사용자로부터 성명, 생년월일 정보를 입력받아 수료 여부 판단하는 역할. 이때, 엑셀 기반의 수료자 리스트에 해당 정보가 존재하는지 확인하여 수료 여부를 판단함. 만약 수료자로 판단될 경우 에이전트2 호출, 수료자가 아닐 경우에는 '죄송합니다. 수료자 목록에 없습니다. 정보를 다시 입력해주세요.' 안내문구 송출 에이전트2 : 수료증 제작하는 역할. 수료증 양식에서 아래 3가지 정보를 각 수료자에 맞게 변경하여 수료증을 제작. 1. 성명 2. 생년월일 3. 수료번호 ------ 또한 아래와 같은 홈페이지 구성이 있으면 좋겠어. 1. 메인페이지 : 사용자의 성명 및 생년월일을 입력할 수 있는 란이 있고, '탄소중립평가사 수료증 발급' 버튼을 눌러 PDF형식의 수료증을 다운로드 받을 수 있어야함. 또한 관리자가 별도로 로그인 할 수 있도록, 관리자 로그인 페이지로 이동할 수 있는 버튼이 있어야함. 2. 관리자 로그인페이지 : 관리자 비밀번호를 입력하고 관리자 대시보드로 진입할 수 있어야함 3. 관리자 대시보드 : 아래와같은 세부구성이 필요함 1) 수료자 리스트 엑셀파일 업로드가 가능한 기능 2) 수료자 리스트 확인탭 : 엑셀파일에서 불러온 수료자 리스트를 에이전트1이 수료 여부를 판별할 수 있도록 홈페이지에 저장하고, 또 이것을 관리자가 접근하여 수정 및 확인할 수 있는 탭이 필요 3) 수료증 양식 업로드 탭 : 관리자가 PDF 또는 PPT파일 기반의 수료증 양식을 업로드할 수 있는 탭 4) 한글 폰트 업로드 탭 : 에이전트2가 수료증을 제작할때 사용할 수 있는 글씨체 업로드할 수 있는 탭 ------- 이 내용들을 바탕으로 기획문서 MD파일 작성해줘. 마크다운형태로 부탁해
위 내용을 Claude AI에게 요청하였다.
2026 탄소중립평가사 교육 수료증 자동 발급 시스템 (MVP 1단계 v2)
📋 프로젝트 개요
프로젝트 목적
관리자가 미리 제작한 수료증 PDF를 시스템에 업로드하고, 수료자가 자신의 정보를 입력하면 해당하는 수료증을 자동으로 찾아 다운로드할 수 있는 시스템 구축
핵심 변경 사항
❌ 수료증 자동 생성 (제거)
✅ 관리자가 직접 제작한 PDF 업로드
✅ 파일명 기반 자동 매칭
✅ 대량 업로드 지원 (120개 이상)
MVP 1단계 범위
✅ 간단한 관리자 대시보드 (PDF 업로드 전용)
✅ 수료자 정보 기반 검증
✅ 파일명 기반 수료증 매칭
✅ PDF 다운로드
❌ 다운로드 이력 관리 (2단계 이후)
❌ 복잡한 관리자 기능 (2단계 이후)
🤖 시스템 구조
에이전트 구조
에이전트 1: 수료자 검증
역할: 사용자 입력 정보를 수료자 리스트와 비교
처리 프로세스:
사용자로부터 성명, 생년월일 입력 수신
서버의
students.json파일에서 해당 정보 검색수료자 여부 판단
수료자 확인: 에이전트 2 호출
수료자 미확인: 에러 메시지 표시
"죄송합니다. 수료자 목록에 없습니다. 정보를 다시 입력해주세요."
에이전트 2: 수료증 매칭 및 다운로드
역할: 검증된 수료자의 수료증 파일을 찾아 다운로드 제공
처리 프로세스:
에이전트 1로부터 수료자 정보 수신 (성명, 생년월일)
파일명 형식으로 변환:
성명_생년월일.pdf예시:
홍길동_1990-01-01.pdf
certificates/폴더에서 해당 파일명 검색파일 존재 여부 확인
파일 존재: PDF 다운로드 제공
파일 없음: 에러 메시지 표시
"수료증 파일을 찾을 수 없습니다. 관리자에게 문의해주세요."
파일명 규칙:
형식:
성명_생년월일.pdf예시:
홍길동_1990-01-01.pdf김철수_1985-05-15.pdf이영희_1992-03-20.pdf
이하 내용 생략
꼼꼼히 기획문서를 읽어보고, 일부 내용들을 수정했다.
에이전트2의 역할 : 수료증 PDF 생성 -> 수료자 정보와 관리자가 업로드한 수료증 PDF 매칭
관리자 페이지 간소화
사용자 수료증 발급 페이지(좌) 및 관리자 로그인 페이지(우)
관리자 페이지
아래는 관리자 및 사용자의 사용 플로우가 어떻게 되는지 정리한 내용이다.
📋 사용 가이드
관리자 워크플로우
수료증 PDF 제작 (외부 프로그램 사용)
파일명 규칙:
성명_생년월일.pdf예시:
홍길동_1990-01-01.pdf
관리자 로그인
비밀번호 입력
수료자 리스트 업데이트 (필요시)
JSON 다운로드 → 수정 → JSON 업로드
수료증 대량 업로드
파일 선택 또는 드래그 앤 드롭
한 번에 최대 150개 업로드 가능
120명이면 한 번에 모두 업로드 가능
업로드된 수료증 확인
목록에서 확인
검색으로 특정 파일 찾기
필요시 개별 삭제
사용자 워크플로우
메인 페이지 접속
성명, 생년월일 입력
수료증 다운로드 버튼 클릭
자동 다운로드
결과와 배운 점
코드 분석력이 필요하다. 나는 코딩을 잘 모르기때문에 기획 아이디어를 제외한 세부기획과 코딩을 포함한 모든 작업을 클로드에게 맡겼다. 결과물은 나왔으나, 내가 원하는 디테일들을 챙겨 실제 사업 또는 공개 배포하기에 적절한 수준까지 만드는 일은 매우 어려울 것이라 생각한다. 클로드가 작업하는 분류들을 분석하며 왜 이런 방식으로 진행되었는지 고찰해볼 필요가 있을 것 같다.
시연의 저주를 믿게 되었다. 남들 자랑 할 때마다 오류가 나며, 클로드를 제외한 다른 서비스(Render 등)들은 무료플랜을 사용하다보니 시간이 지나면 초기화되어 오류가 발생하고, 클로드에게 오류 해결에 대한 반복요청을 하게 된다. 오류 루프를 빠져나오기 위해서는 내가 어떤 것을 준비해하고 공부해야할지 스터디장(원)분들께 조언을 구하고 싶다.
오류를 스트레스로 받아들이지 않을 수 있는 넓은 마음가짐이 필요하다.
향후 계획
반복오류 원인 찾아 '교육 수료증 발급 자동화 웹페이지' 안정화된 시스템 구축
LCA 평가대상 분류 및 단위환산 작업 계획 및 검증 방식 고민
Phase 1 : '물량내역서'에서 글자를 읽어들여 'Dictionary-type'으로 내역 정리
Phase 2 : ['Dictionary-type' 내역]과 블랙/화이트리스트 정보를 담은 [Dictionary]와 매칭하여 [평가대상 건축자재] 문서 정리
Phase 3 : '단위환산 주의목록'(알루미늄, 금속재 등)에 대하여, m단위 표현된 내역은 ㎥단위로 변환
Phase 4 : [평가대상 건축자재] 문서와 [단위환산] 문서를 매칭하여 [내역/ton] 문서 정리
Phase 5 : 검증 에이전트 계획 - 과거 평균 데이터 기반 ㎡당 투입물량 형성 범위의 적절성 판단
상기 계획에 대한 구체적 기획문서 제작 및 Phase1부터로 직접 실행해보기
