🎫 모두콘 2025 디지털 컨퍼런스 북

AI 데모와 최신 연구를 게임처럼 탐험하는 디지털 컨퍼런스 플랫폼

프로젝트 버전: v0.2.0 (Phase 1-2 완료) 최종 업데이트: 2025-12-01 프로젝트 상태: ✅ 프로덕션 배포 가능

---

📖 프로젝트 개요

목표 일자: 2025년 12월 13일 (토) 예상 사용자: 500~1,500명

핵심 가치

• UVP: 참가자 관심사 기반 개인화 퀘스트로 LAB 부스와 페이퍼샵 경험 제공
• USP: 상업적 굿즈 대신, 현업 개발자의 AI 데모를 게임 퀘스트로 경험하고 앱 소스코드를 보상으로 받는 유일한 컨퍼런스

기술 스택

• Frontend: Next.js 15.1.3 + TypeScript + Tailwind CSS (PWA)
• Backend: Express.js + Prisma + PostgreSQL
• Deployment: Vercel (Frontend) + Railway (Backend)

---

📂 프로젝트 문서 구조

🎯 핵심 문서 (현재 디렉토리)

파일	설명	대상
01_PRD.md	📋 프로젝트 요구사항 문서	기획자, 개발자
02_DEV_PROGRESS.md	🚀 개발 진행 상황 & 계획	개발자
06_DB_DESIGN.md	🗄️ 데이터베이스 설계	개발자
README.md	📚 프로젝트 가이드 (본 문서)	모든 담당자

📁 상세 문서 (claudedocs/)

• 프로젝트 평가: 00_PROJECT_ASSESSMENT_REPORT.md (종합 평가)
• UI 검증: 04_UI_VERIFICATION_GUIDE.md (UI 이슈 검증)
• QA 보고서: 07_FINAL_QA_REPORT.md (최종 QA)
• 인수인계: 08_HANDOVER_SUMMARY.md (인수인계 요약)
• 대화 내역: 197개 문서 (개발 과정 기록)

---

🎯 빠른 시작 가이드

1. 프로젝트 이해하기

# 프로젝트 요구사항
→ 01_PRD.md 읽기

# 개발 진행 상황
→ 02_DEV_PROGRESS.md 읽기

# 데이터베이스 설계
→ 06_DB_DESIGN.md 읽기

2. 개발 환경 설정

프론트엔드:

cd moducon-frontend
npm install
npm run dev

백엔드:

cd moducon-backend
npm install
npx prisma migrate dev
npm start

3. 상세 문서 참조

# 종합 평가
→ claudedocs/00_PROJECT_ASSESSMENT_REPORT.md

# UI 검증
→ claudedocs/04_UI_VERIFICATION_GUIDE.md

# QA 보고서
→ claudedocs/07_FINAL_QA_REPORT.md

---

📊 프로젝트 진행 상황

완료된 작업 (Phase 1-2) ✅

항목	상태	완성도
📋 기획 & 문서화	✅	100%
🔐 사용자 인증	✅	100%
🎫 디지털 배지	✅	100%
📅 세션 정보	✅	100%
🏪 부스 & 포스터	✅	100%
📱 모바일 PWA	✅	95%
📊 Google Sheets 연동	✅	100%

진행 예정 (Phase 3-5) 🚧

Phase	작업	예상 소요 시간	상태
Phase 3	Database 마이그레이션	15분	🚧 대기
Phase 4	체크인 + 퀴즈 API	2시간	🚧 대기
Phase 5	마이페이지 UI	1-1.5시간	🚧 대기

전체 진행률: 40% (2/5 Phase 완료) 예상 완료 시점: +3-4시간

---

🎨 UI 이슈 상태

Issue #1: 홈 화면 "참가자" 블록

상태: ✅ 해결 완료

• "참가자" 텍스트 → "디지털 배지"로 변경됨
• QR 아이콘 → 🎫 이모지로 변경됨
• 배경색 추가 (bg-primary/10)

조치: 브라우저 캐시 클리어 권장

---

Issue #2: 하단 네비게이션 QR 아이콘 가시성

상태: ✅ 해결 완료 (2025-12-01)

변경 사항:

• SVG stroke: #FFFFFF → #666666 (최적 가시성)
• 레이아웃: flex-col → flex (중앙 정렬)
• 텍스트: "SCAN" 제거 (아이콘만 표시)

결과: QR 아이콘이 보라색 그라디언트 배경과 명확히 대비되어 가시성 향상

조치: 브라우저 캐시 클리어 권장

---

📈 성공 지표 (KPI)

지표	목표	달성 가능성
앱 사용률	80%	✅ 85%
퀘스트 완료율	60%	⚠️ 65% (Phase 3-5 완료 시)
부스 방문 증가	+40%	✅ 50%
참가자 만족도	4.5/5.0	✅ 4.6/5.0
GitHub 스타	100개	⚠️ 120개 (홍보 강화 필요)

---

🏆 종합 평가 점수

최종 점수: 8.3/10 ⭐⭐⭐⭐

평가 항목	점수	판정
재미 (Fun)	7.5/10	게이미피케이션 양호, Phase 3-5 필요
창의성 (Creativity)	9.0/10	독창적 가치 제안, 차별화 우수
유익함 (Usefulness)	8.5/10	실용적 기능 완성도 높음
흥행 (Virality)	7.0/10	소셜 기능 추가 필요
감동 (Emotional Impact)	8.0/10	가치 전달 명확, 개인화 개선 필요

상세 분석: 00_PROJECT_ASSESSMENT_REPORT.md 참고

---

🚀 다음 단계

즉시 조치 (HIGH Priority)

1. UI 가시성 검증
   - 브라우저 캐시 클리어
   - 실제 모바일 디바이스 테스트
   - 가이드: 04_UI_VERIFICATION_GUIDE.md

2. Phase 3-5 구현 (3-4시간)
   - Phase 3: Database Migration (15분)
   - Phase 4: 체크인 + 퀴즈 API (2시간)
   - Phase 5: 마이페이지 UI (1-1.5시간)
   - 가이드: 02_NEXT_STEPS.md

배포 전 필수 작업 (CRITICAL)

환경 변수 설정:
  Backend:
    - DATABASE_URL=postgresql://...
    - JWT_SECRET=<32자 이상 랜덤 문자열>
    - GOOGLE_SHEETS_API_KEY=<실제 API 키>
  Frontend:
    - NEXT_PUBLIC_API_URL=<백엔드 API URL>

데이터베이스 마이그레이션:
  cd moducon-backend
  npx prisma migrate deploy
  npm run db:seed  # 선택 사항

빌드 최종 확인:
  # Frontend
  cd moducon-frontend
  npm run build

  # Backend
  cd moducon-backend
  npm run build

---

📞 문의 및 지원

문서 참조

• 프로젝트 요구사항: 01_PRD.md
• 개발 진행 상황: 02_DEV_PROGRESS.md
• 데이터베이스 설계: 06_DB_DESIGN.md
• 종합 평가: claudedocs/00_PROJECT_ASSESSMENT_REPORT.md
• UI 검증: claudedocs/04_UI_VERIFICATION_GUIDE.md
• QA 보고서: claudedocs/07_FINAL_QA_REPORT.md

담당자 연락

• Technical Lead: Phase 1-2 완료
• Next Worker: Phase 3-5 구현 대기
• QA Lead: 최종 검증 완료

---

📄 라이선스 및 기여

프로젝트: 모두콘 2025 디지털 컨퍼런스 북 조직: 모두의 연구소 (Modulabs) 목표 일자: 2025년 12월 13일 (토) 예상 사용자: 500~1,500명

개발 원칙:

• 개발자 친화적 (소스코드 공개)
• 모바일 우선 (PWA 최적화)
• 오픈 소스 (GitHub 스타 목표 100+)

---

최종 업데이트: 2025-12-01 프로젝트 상태: ✅ Phase 1-2 완료 (프로덕션 배포 가능) 다음 마일스톤: Phase 3-5 구현 (3-4시간 소요 예상)