NCMN · My5K 2026 · 의사결정 검토용
외국인 자원봉사 시스템 — 기획 개요
봉사자가 봉사시간을 인정받도록, 발급 서류를 안정적으로 제공하는 별도 모듈
버전 v0.1 (초안)
작성일 2026-07-09
규모 연 1회 · ~100명
대상 외국인 학생 봉사자
01
목적 한 줄
외국인 자원봉사자가 봉사시간을 1365에서 인정받을 수 있는 서류를 자동 발급받고,
현장 출결이 정확히 기록되며, 역할별 안내를 쉽게 받는 독립 모듈을 My5K 위에 얹는다.
시스템이 1365에 직접 연동하지 않는다. 봉사자가 다운로드한 서류로 각자 1365에 등록·인정받는다.
시스템의 역할은 그 서류를 흔들림 없이 정확하게 만들어 내려주는 것.
02
전제 · 스코프
기술 스택
Vue3 · Hono · MariaDB · CF
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
신청 (인적사항)
실명(국·영)·생년월일·소속·연락처
3
역할 배정 (활동내용)
배정 역할 · 활동 설명 · 장소
4
기관정보 (직인)
NCMN 기관정보 · 직인 · 발급일
→ 이 네 덩어리가 정확하면 확인서 발급이 자동으로 굴러간다.
즉 개인정보 매칭과 출결 정확도가 이 시스템의 두 축.
07
출결 설계 원칙 — 부정방지 우선
GPS는 보조 신호, 관리자·팀장의 현장 확정이 최종 인정 기준이다.
허위 출결은 곧 허위 실적(준-공문서 성격)이므로 관리자 검증을 최종 게이트로 둔다.
08
② 봉사 인증서 디자인 (시안 · 예정)
영어 기본 · 설정 언어 전환 · PDF 다운로드 + 공유하기 · 이름 폭 자동 최적화
09
개인정보 · 보안
확인서 필수항목 중심으로 최소 수집. 실명(국·영)·생년월일·소속·연락처·주소.
수집·이용 동의(영/한), AES 암호화(기존 방식 재사용), 보관·파기 정책 적용.
외국인 대상이므로 국제 고지 문안도 함께 검토.
10
개발 중 조정할 항목
지금 확정하지 않고 개발하며 튜닝 DEV-TUNE
- 인정 경로 세부 — 학교 NEIS 제출 vs 센터 통한 1365 소급. 확인서 필수항목에 영향, 구현하며 조정.
- GPS 반경 — 코스 커버(넓게) vs 부정방지(좁게)의 균형. 현장 테스트로 수치 확정.
- 국제 이메일 발송수단 — SendGrid / SES / Resend 등 선택 (Solapi·알림톡은 국외 무용).
- 인증서 다국어 문안 — 베트남어 등 원어민 검수 후 확정.
11
개략 로드맵
1단계
설계 · 기반
스키마 · 신청폼 · 역할/가이드 CMS · i18n(영 기본)
2단계
신청 · 관리
신청(개인/팀) · 승인 워크플로우 · 마이페이지
3단계
현장 출결
GPS+QR+관리자 확정 · 시간 산정 · 대시보드
4단계
발급 · 검증
확인서 PDF · 인증서 이미지/공유 · 진위확인