NCMN · My5K 2026 · 의사결정 검토용

외국인 자원봉사 시스템 — 기획 개요

봉사자가 봉사시간을 인정받도록, 발급 서류를 안정적으로 제공하는 별도 모듈

버전 v0.4 (초안) 작성일 2026-07-09 규모 연 1회 · ~100명 대상 외국인 학생 봉사자
01

목적 한 줄

외국인 자원봉사자가 봉사시간을 1365에서 인정받을 수 있는 서류를 자동 발급받고, 현장 출결이 정확히 기록되며, 역할별 안내를 쉽게 받는 독립 모듈을 My5K 위에 얹는다.

시스템이 1365에 직접 연동하지 않는다. 봉사자가 다운로드한 서류로 각자 1365에 등록·인정받는다. 시스템의 역할은 그 서류를 흔들림 없이 정확하게 만들어 내려주는 것.
02

전제 · 스코프

규모 · 빈도
연 1회 · ~100명 남짓
대상
외국인 학생 (매년 교체)
신청 단위
개인 위주 + 팀 수용
언어
영어 기본 + 설정 언어
시스템 연결
완전 별도 · 홈피 별도 링크
기술 스택
Vue3 · Hono · MariaDB · CF
보안
PII AES 암호화 (기존 재사용)
참가자 · 간사
인증 공유 없음 · 무관
03

전체 흐름

자원봉사 시스템 전체 흐름 홈페이지 별도 링크 참가자·간사와 무관 모집 · 안내 영/한, 역할별 가이드 신청 개인 / 팀, 인적사항 수집 관리자 승인 참여 명단 확정 현장 출결 GPS + QR + 관리자 확정 봉사시간 산정 서버시간 · 8시간/일 상한 ① 봉사활동확인서 국/영문 PDF · 직인 ② 봉사 인증서 이름+인증번호 이미지 봉사자 각자 인정 사용 학교 NEIS / 센터 1365
봉사자 여정 — 신청부터 두 산출물 발급, 봉사자 각자 인정까지
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
NameJohn Doe (존 도)
Date of birth1999-04-12
1365 Volunteer ID12345678
ActivityWalk Together My5K 2026 · Course Guide
Service hours8 hrs
Period2026.10.24 – 2026.10.25
Issued byNCMN · 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 OF VOLUNTEER SERVICE CERT. NO. 2026-MY5K-0028 NCMN VOLUNTEER VOLUNTEER John Doe Walk Together My5K 2026 Hyochang Stadium · Role: Course Guide Certified Service Hours: 8 hrs Period: 2026.10.24 – 2026.10.25 Thank you for walking with us NCMN · My5K Volunteer Team NCMN SEAL
영어 기본 · 설정 언어 전환 · 이미지 저장 + 공유하기 · 이름 폭 자동 최적화
인증서 · 저장 / 공유
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.