YESJOB 멘토링 플랫폼
지역 정주형 부울경 연합 현직자 온라인 멘토링 플랫폼.
현직자 직무 멘토링과 실시간 질의응답(Q&A)을 동시에 제공합니다. (제안서 기준 구현)
- ① 실시간 Q&A — 산업·직무·기업·유형·전공 5개 테마로 멘토를 추천받고, 개별 또는 여러 멘토에게 한 번에 질문. 질문은 멘토에게 카카오톡(알림톡)으로 전달되고, 멘토가 답변하면 사이트 저장 + 학생에게 카톡 회신.
- ② 온라인 토크콘서트 — 8/24~9/3, 45회(매일 5명×9일) 릴레이 Zoom 토크콘서트. (일정/구조 UI 우선, Zoom·섭외는 확정 후 세팅)
- 학교별 관리자 대시보드 — 학교 접속코드 기반 회원가입, 참여/접속/질문 현황과 채택·정산 원장.
빠른 시작
npm install
cp .env.example .env.local # 필요시 값 수정 (없어도 기본값으로 구동됨)
npm run dev # http://localhost:3000
외부 서비스(Supabase/카카오) 키가 없어도 바로 실행됩니다.
데이터는 로컬 JSON 스토어(.data/db.json)에 저장되며, 제안서 별첨 멘토풀 566명이 시드됩니다.
카카오 알림톡은 기본 stub 모드로 콘솔에 출력됩니다(발송 로그에 멘토 답변 링크가 찍힘).
데모 계정
| 구분 | 계정 | 비밀번호 |
|---|
| 학생 로그인 | [email protected] | test1234 |
| 학교 관리자 | pnu-admin | admin1234 |
| 회원가입 접속코드 | PNU2025 (그 외 PKNU2025, DAU2025, KSU2025, DEU2025, UOU2025, GNU2025) | — |
유용한 스크립트
npm run build # 프로덕션 빌드
npm run start # 프로덕션 실행
npm run reset-db # 로컬 데이터 초기화(다음 실행 시 시드 재생성)
주요 화면
| 경로 | 설명 |
|---|
/ | 랜딩(프로그램 소개·질문 프로세스·대표 멘토) |
/qna | 실시간 Q&A — 테마 선택 → 멘토 추천 → 개별/다중 질문 |
/questions, /questions/[id] | 항목별 질문 게시판 · 상세(답변·좋아요·채택) |
/mentors/[id] | 멘토 프로필(학력·경력·멘토링 영역·참여도) |
/answer/[token] | 멘토 답변 작성(로그인 불필요, 알림톡 링크로 진입) |
/talk-concert | 온라인 토크콘서트 일정(9일×5회) + Zoom 자리표시 |
/signup, /login, /admin/login | 접속코드 회원가입 / 로그인 / 관리자 로그인 |
/admin | 학교별 대시보드(접속·질문 현황, 정산 원장) |
/my | 학생 내 질문 |
아키텍처
src/
app/ # Next.js App Router (페이지 + 서버 액션)
components/ # 공통 UI (헤더/푸터/배지/버튼)
lib/
types.ts # 도메인 타입
taxonomy.ts # 산업/직무/기업/유형/전공 분류 (제안서 기준)
mentor-generator.ts # 멘토풀 원본 → 태그 자동추론 + 가상 프로필 생성
seed.ts # 학교·토크콘서트 일정·데모 데이터 시드
store.ts # 개발/데모용 JSON 파일 스토어 (교체 지점)
repo.ts # 쿼리/뮤테이션 (추천·질문·답변·정산·대시보드 집계)
session.ts # 쿠키 세션(jose JWT)
messaging.ts # 카카오 알림톡 어댑터 (stub / 알리고)
crypto.ts, format.ts, grades.ts, view.ts
data/mentor-pool.raw.json # 제안서 별첨 멘토풀(566명) 원본
멘토 추천 로직
recommendMentors(themeRefs) 가 선택된 각 테마(산업/직무/기업/유형/전공)와 멘토 태그를
가중치(기업>직무>산업>유형>전공)로 매칭·점수화하여 정렬합니다. 멘토 태그는
mentor-generator.ts 가 원본 소속/직무 텍스트의 키워드로 자동 추론합니다.
Q&A → 카톡 → 답변 흐름
- 학생이 멘토 선택 후 질문 등록 (
askAction)
- 각 멘토에게 알림톡 발송(답변용 토큰 링크 포함) —
notifyMentorNewQuestion
- 멘토가 링크(
/answer/[token])로 진입해 답변 작성 (로그인 불필요)
- 답변 저장 + 학생에게 답변 도착 알림톡 —
notifyStudentNewAnswer
- 관리자가 우수 답변 채택 → 등급별 차등 지급액이 내부 정산 원장에 기록
프로덕션 전환 가이드
1) 카카오 알림톡 (알리고)
.env.local 에서 provider 를 aligo 로 바꾸고 키를 채웁니다.
KAKAO_PROVIDER=aligo
ALIGO_API_KEY=...
ALIGO_USER_ID=...
KAKAO_SENDER_KEY=... # 알림톡 발신 프로필(채널) 발신키
ALIGO_SENDER=010######## # 사전 등록된 발신번호
KAKAO_TPL_NEW_QUESTION=... # 승인된 템플릿 코드(멘토용)
KAKAO_TPL_NEW_ANSWER=... # 승인된 템플릿 코드(학생용)
- 알림톡은 사전 승인된 템플릿만 발송 가능합니다.
src/lib/messaging.ts 의 메시지
본문/버튼을 승인 템플릿과 일치시키세요. (연동 코드: sendViaAligo)
- 멘토 수신 번호는 현재 마스킹된 가상값입니다. 실제 운영 시 멘토 연락처를 안전하게 저장하세요.
2) 데이터 백엔드 (Supabase) — 구현 완료, 환경변수만 설정하면 전환
데이터 접근은 src/lib/data.ts 한 곳에서 백엔드를 자동 선택합니다.
SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY 가 있으면 → Supabase(PostgreSQL, 영구 저장)- 없으면 → 로컬 JSON 스토어(데모)
전환 절차
- supabase.com 에서 프로젝트 생성(무료)
- SQL Editor 에
supabase/schema.sql 붙여넣고 실행 (테이블 생성)
- Vercel 환경변수 추가 후 재배포:
SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ... # Project Settings → API → service_role
SEED_SECRET=아무_긴_임의문자열 # 시드 엔드포인트 보호용
- 시드 채우기(1회):
https://mentoring-usg.kr/api/seed?secret=<SEED_SECRET> 접속
→ 학교 12개, 멘토 566명, 토크콘서트 45회 등 자동 삽입 (이미 있으면 skip, &force=1 로 강제)
⚠️ Vercel 서버리스는 파일시스템이 휘발성이라 JSON 스토어로는 데이터가 유지되지 않습니다.
실제 운영은 위 Supabase 전환이 필수입니다.
참고: service_role 키는 서버에서만 사용되며(클라이언트 노출 없음), 스키마는 RLS 활성화 +
정책 없음이라 anon 키로는 접근이 차단됩니다.
3) Zoom (토크콘서트)
TalkSession.zoomUrl 에 회차별 링크를 채우고, 섭외 확정 시 mentorName/company/status 를
업데이트합니다. Zoom API 자동 생성 연동은 ZOOM_* 환경변수 자리를 참고하세요.
배포 (Vercel · 데모용)
코드가 GitHub에 있으므로 Vercel에서 바로 배포할 수 있습니다.
- https://vercel.com 에서 GitHub로 로그인
- Add New → Project →
yesjob2025-cyber/mentoring-usg Import
- Branch를
claude/mentoring-homepage-setup-udana7 로 선택 (또는 이 브랜치를 main으로 머지)
- Environment Variables 에 최소
SESSION_SECRET(임의 32자 이상) 입력
(카톡 실발송하려면 KAKAO_PROVIDER=aligo + 알리고 키들도 함께)
- Deploy → 몇 분 뒤
https://<프로젝트>.vercel.app 주소 생성
⚠️ 데이터 영속성 주의: 서버리스에서는 임시 저장소(/tmp)를 쓰므로 배포·재시작 시
가입/질문 데이터가 초기화됩니다(시드 데이터로 리셋). 화면·플로우 확인용 데모로는 충분하지만,
실제 운영(데이터 유지, 다중 사용자)은 위 Supabase 전환이 필요합니다.
기술 스택
Next.js 15 (App Router) · React 19 · TypeScript · Tailwind CSS · jose(세션) ·
데이터: 로컬 JSON 스토어(데모) → Supabase(프로덕션)
