버전 v0.4 (초안)작성일 2026-07-09규모 연 1회 · ~100명대상 외국인 학생 봉사자
01
목적 한 줄
외국인 자원봉사자가 봉사시간을 1365에서 인정받을 수 있는 서류를 자동 발급받고,
현장 출결이 정확히 기록되며, 역할별 안내를 쉽게 받는 독립 모듈을 My5K 위에 얹는다.
시스템이 1365에 직접 연동하지 않는다. 봉사자가 다운로드한 서류로 각자 1365에 등록·인정받는다.
시스템의 역할은 그 서류를 흔들림 없이 정확하게 만들어 내려주는 것.
02
전제 · 스코프
규모 · 빈도
연 1회 · ~100명 남짓
대상
외국인 학생 (매년 교체)
신청 단위
개인 위주 + 팀 수용
언어
영어 기본 + 설정 언어
시스템 연결
완전 별도 · 홈피 별도 링크
기술 스택
Vue3 · Hono · MariaDB · CF
보안
PII AES 암호화 (기존 재사용)
참가자 · 간사
인증 공유 없음 · 무관
03
전체 흐름
봉사자 여정 — 신청부터 두 산출물 발급, 봉사자 각자 인정까지
04
기능 범위
공개 (봉사자)
모집·안내 (영/한, 주의사항)
역할별 가이드
신청 (개인 / 팀)
마이페이지 (역할·일정·상태·다운로드)
현장
GPS 셀프 체크인/아웃
현장 QR 병행 (부정방지)
관리자·팀장 현장 확정
종료시간 자동마감·보정
관리자
신청 승인·명단 확정
실시간 현황 대시보드
봉사시간 확정
인증서 양식 이미지 업로드
발급
① 확인서 PDF 자동생성
② 인증서 이미지·공유
인증번호 채번
진위확인 페이지
05
핵심 — 문서는 두 종류로 분리
하나의 문서로 공식 인정과 감성 공유를 겸하면 둘 다 어정쩡해진다. 역할이 다른 두 문서로 나눈다.
공식 · 제출용
① 봉사활동확인서
Volunteer Service Certificate
1365 · 학교 제출용 실무 서류
격식 · 직인 · 시간/기간/활동내용
국·영문 PDF (서버 렌더링)
봉사자가 직접 1365에 등록·인정
감성 · 공유용
② 봉사 인증서
Certificate of Volunteer Service
소장·SNS 공유용 카드
영어 기본 + 설정 언어(예: 베트남어)
이미지(PNG) · 공유하기
영문 이름 가로폭 자동 최적화
인증번호 규칙 2026-MY5K-0028 (연도·이벤트·4자리 일련, 자동 채번).
두 문서에 같은 번호를 박아 상호 대조하고, 공개 진위확인 페이지로 위조를 막는다.
(수료증/이수증은 사전 교육과정이 있을 때만, 감사장은 예우 강조 대안.)
06
확인서 자동 채움 = 4개 데이터 소스
1
신청 (인적사항)
실명(국·영)·생년월일·소속·연락처
2
출결 (시간)
확정된 봉사시간 · 활동일자
3
역할 배정 (활동내용)
배정 역할 · 활동 설명 · 장소
4
기관정보 (직인)
NCMN 기관정보 · 직인 · 발급일
→ 이 네 덩어리가 정확하면 확인서 발급이 자동으로 굴러간다.
즉 개인정보 매칭과 출결 정확도가 이 시스템의 두 축.
07
출결 설계 원칙 — 부정방지 우선
GPS는 보조 신호, 관리자·팀장의 현장 확정이 최종 인정 기준이다.
허위 출결은 곧 허위 실적(준-공문서 성격)이므로 관리자 검증을 최종 게이트로 둔다.
1차
GPS 셀프 체크인/아웃
2차
현장 QR 스캔 (현장성 담보)
최종
관리자 명단 확정
시간
서버시각 · 8시간/일 상한
예외
자동마감 + 보정 큐
무결성
기기시계 불신 · 중복방지
08
① 봉사활동확인서 (초안)
공식 · 제출용 문서. 신청 · 출결 · 역할 · 기관정보 네 소스(→ 06)가 자동으로 채워져
국 · 영문 PDF로 서버에서 렌더링된다. 여기에 봉사자가 올린 활동 사진과 후기가 함께 실려,
마이페이지에서 직접 내려받아 1365 · 학교에 제출한다. (사용자 앱 확인서 화면과 동일 구성.)
VOLUNTEER SERVICE CERTIFICATE
Name
John Doe (존 도)
Date of birth
1999-04-12
1365 Volunteer ID
12345678
Activity
Walk Together My5K 2026 · Course Guide
Service hours
8 hrs
Period
2026.10.24 – 2026.10.25
Issued by
NCMN · My5K Volunteer Team
Cert. no.
2026-MY5K-0028
Photos
Reflection
"Guiding walkers at the turning points, I saw so many smiles. Cheering strangers toward the finish line, I felt what it truly means to serve with joy…"
Organizer sealNCMN
⤓ PDF 다운로드
확인서에 담기는 것 (앱 반영)
사진 · 후기 수록 — 봉사자가 올린 활동 사진과 후기가 확인서에 그대로 실린다. 최종 사진은 관리자가 선정한다.
서버 렌더링 — 확정된 데이터로 서버가 PDF를 생성한다. 브라우저에서 편집 불가하여 위 · 변조를 막는다.
국 · 영문 선택 — 제출처(학교 NEIS · 센터 1365)에 맞춰 언어를 고른 뒤 발급한다.
직인 · 인증번호 — NCMN 직인과 인증번호 2026-MY5K-0028를 함께 새긴다.
재다운로드 — 마이페이지에서 언제든 다시 내려받을 수 있고 발급 이력이 기록된다.
출결 · 명단이 관리자 확정되고 활동 사진 · 후기가 등록된 뒤에 발급 버튼이 활성화된다.
미확정 상태에서는 '확정 대기'로 비활성 처리한다.
09
② 봉사 인증서 디자인 (시안 · 예정)
영어 기본 · 설정 언어 전환 · 이미지 저장 + 공유하기 · 이름 폭 자동 최적화
인증서 · 저장 / 공유
CERTIFICATE John Doe 2026-MY5K-0028
⤓ 이미지 저장
↗ 공유하기
'공유하기' 탭 → 공유 시트
CERTIFICATE
공유
◎Instagram
fFacebook
♪TikTok
✆WhatsApp
KKakaoTalk
이미지 저장 · 공유 기능
이미지 저장 — 인증서를 고해상도 PNG로 기기에 저장한다.
공유하기 — 탭하면 공유 시트가 열려 인스타그램 · 페이스북 · 틱톡 · 왓츠앱 · 카카오톡으로 바로 공유한다.
외국인 친화 — 인스타 · 틱톡 · 왓츠앱 등 글로벌 채널을 앞세우고 카카오톡을 병행한다.
감성 카드 — 제출용이 아닌 소장 · 자랑용이며, 개인정보는 이름과 인증번호로 최소 노출한다.
10
개인정보 · 보안
확인서 필수항목 중심으로 최소 수집. 실명(국·영)·생년월일·소속·연락처·주소.
수집·이용 동의(영/한), AES 암호화(기존 방식 재사용), 보관·파기 정책 적용.
외국인 대상이므로 국제 고지 문안도 함께 검토.
11
개발 중 조정할 항목
지금 확정하지 않고 개발하며 튜닝 DEV-TUNE
인정 경로 세부 — 학교 NEIS 제출 vs 센터 통한 1365 소급. 확인서 필수항목에 영향, 구현하며 조정.
GPS 반경 — 코스 커버(넓게) vs 부정방지(좁게)의 균형. 현장 테스트로 수치 확정.
국제 이메일 발송수단 — SendGrid / SES / Resend 등 선택 (Solapi·알림톡은 국외 무용).
인증서 다국어 문안 — 베트남어 등 원어민 검수 후 확정.
12
개략 로드맵
1단계
설계 · 기반
스키마 · 신청폼 · 역할/가이드 CMS · i18n(영 기본)
2단계
신청 · 관리
신청(개인/팀) · 승인 워크플로우 · 마이페이지
3단계
현장 출결
GPS+QR+관리자 확정 · 시간 산정 · 대시보드
4단계
발급 · 검증
확인서 PDF · 인증서 이미지/공유 · 진위확인
13
관리자 콘솔 (운영)
봉사자는 신청 → 관리자 승인 후 활동한다. 관리자 콘솔에서 신청부터 발급까지 한 곳에서 처리하며,
관리자가 최종 확정(확인서 발급)해야만 사용자 앱에 확인서 · 인증서가 노출된다(허위 실적 방지).
자원봉사 목록 · 상세
신청 승인 / 반려
역할 배정 (확인서 Activity)
출석 인정 · 봉사시간 확정(8h/일)
최종 활동 사진 선정
확인서 발급 · 최종 컨펌
발급 게이팅
발급 전 = 사용자 문서 '확정 대기' 잠금
발급 시 확인서 노출 + 인증서 자동
발급번호 채번 · 발급 이력
공지
공지 등록 · 노출 ON/OFF
사용자 앱 상단 한 줄 배너(노랑)
기기별 '오늘 닫기' 유지
현황 · 향후
대시보드(신청 · 승인 · 출석 · 발급 요약)
향후: 진위확인 페이지 · 인증서 양식 업로드 · 팀(단체) 관리
실제 관리자 앱(apps/admin · Vue · PrimeVue)의 상태모델(접수/확정/반려) · 목록+상세 Drawer · 상태 pill 패턴을 따른다.
자원봉사 · 출결 · 확인서 · 공지는 신규 기능으로 추가된다. 프로토타입: admin.html.