keg-devpath-ai/progress.txt at main · qwc2869/keg-devpath-ai · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
[Project Progress Notes]

## 2026-04-12 — Phase 6 제출 준비 진행 중
- README.md 초안 작성 완료
- 환경변수/비밀키 노출 점검: 이상 없음
- Vercel 배포 완료: https://keg-devpath-ai.vercel.app
  - Suspense 래퍼 추가: quiz1/result, quiz2, result 3개 페이지 (useSearchParams 빌드 에러 해소)
  - hostname 한글("노트북") 이슈 → os.hostname 몽키패치로 Vercel CLI 우회
- AI 리포트 초안 작성 완료: docs/ai-report.md
- README 스크린샷 추가 완료 (사용자 직접)
- GitHub 공개 설정 완료: https://github.com/qwc2869/keg-devpath-ai
- 제출 전 최종 QA 완료 (사용자 직접)

## 2026-04-12 — Phase 5 다듬기 완료
- 복수 케이스 테스트: 5개 시나리오(메이커+탐색, 설계자+직행, 빌더+브리지, 감시자+urgentFlag, 보조유형) 검증 통과
- 모바일 대응 점검: 전 페이지 max-w-md + px-4, 터치 영역 py-4, flex-wrap 확인

## 2026-04-12 — Phase 5 코드 품질·버그 수정
- quiz1/result/page.tsx: secondaryType을 TypeAxis 키 대신 한국어 유형명으로 표시 수정
  - 기존: "약간의 ARCHITECT 성향도 있어요"
  - 수정: "약간의 판 짜는 설계자형 성향도 있어요"
- quiz1/result/page.tsx: 링크 복사 로직 간소화 (Array→entries→filter→reduce 체인 → window.location.href)
- quiz1/result/page.tsx: 미사용 TypeAxis import 제거
- result/page.tsx: 미사용 quiz1Name 상태 제거, quiz1Type 상태로 대체 (dead code 정리)
- result/page.tsx: 오류 버튼 "/quiz1로 돌아가기" → "처음부터 다시" (사용자 친화적 카피 통일)

## 2026-04-12 — Phase 4 최종 결과 페이지 구현
- app/result/page.tsx: 최종 결과 페이지 신규 생성
  - URL params → quiz1Type + Quiz2Answers 파싱 (type, q1~q10)
  - quiz1Results에서 1차 유형 메타데이터 직접 조회
  - calcQuiz2(answers, type) 호출 → 준비 단계·직무 Top3·경고 계산
  - 섹션: 1차 유형 요약 / 준비 단계+직행 가능 여부 / 직무 Top3 / 추천 경로 / 추천 코스 / 경고 / 상담사 요약 카드 / 상담 CTA

## 2026-04-12 — Phase 3 2차 검사 화면 완료
- app/quiz2/page.tsx: 10문항 카드형 단일 선택 UI 구현
- 진행률 바: (currentIndex+1)/10 비율로 인디고 색상 표시
- 답변 상태: useState<Quiz2Answers>로 questionId→label 맵 관리
- quiz1Type: URL param ?type= 으로 수신 후 state 저장
- 마지막 문항 완료 시 URL params로 answers 인코딩 → /result 이동

# 목적
- 1차는 흥미/공유
- 2차는 실질 진단/추천
- 최종 결과는 “현실적인 추천 경로”처럼 보여야 함

# 현재 고정된 핵심
- 서비스 제목: 내가 개발자라면 어떤 유형일까?
- 1차 부제: 일상 성향으로 알아보는 개발자 유형 테스트
- 2차 제목: 비전공자인 내가 개발자로 취업하려면, 어디부터 시작해야 할까?
- 1차 결과 6종
- 2차 준비 단계 3종

# 구현 메모
- 1차 질문은 개발 용어 없이 일상형 유지
- 2차 결과에서 “정답”처럼 보이는 표현 금지
- 추천은 항상 “현재 단계 기준”으로 표현
- 상담 CTA는 최종 결과 하단에 명확히 배치

# 리스크 메모
- 1차가 너무 가볍게 보이면 2차 전환이 약해질 수 있음
- 2차가 너무 길면 이탈 가능성 있음
- 결과 카드가 너무 텍스트 위주면 공유력이 떨어질 수 있음
- urgentFlag(Q4-E, Q10-E)는 데이터에만 표시; 실제 경고 문구는 scoring 함수에서 처리해야 함

## 2026-04-12 — Phase 2 1차 결과 페이지 + 공유/CTA 완료
- app/quiz1/result/page.tsx: 본격 구현 완료
  - URL params → Quiz1Answers 파싱 (1~8번 선택지)
  - calcQuiz1(answers) 호출 → 유형 결과 계산
  - 유형명·성향 설명·개발 번역·보조유형 표시
  - 공유 문구 복사: navigator.clipboard API (2초 피드백)
  - 링크 복사: 현재 URL 인코딩 후 복사
  - 2차 진단 CTA: /quiz2로 라우팅
- app/quiz2/page.tsx: 라우팅 404 방지 스텁 생성

## 2026-04-12 — Phase 2 1차 검사 화면 완료
- app/quiz1/page.tsx: 한 문항씩 표시 방식, 카드형 단일 선택 UI
- 진행률 바: (currentIndex+1)/8 비율로 인디고 색상 표시
- 답변 상태: useState<Quiz1Answers>로 questionId→label 맵 관리
- 마지막 문항 완료 시 URL params로 answers 인코딩 → /quiz1/result 이동
- app/quiz1/result/page.tsx: 라우팅 404 방지용 스텁 생성

## 2026-04-12 — Phase 2 랜딩 페이지 완료
- app/page.tsx: 헤드라인·부제·3단계 흐름 안내(유형테스트→취업루트진단→맞춤경로추천)·CTA 구현
- /quiz1 라우트로 CTA 연결 완료
- npm install 실행 및 next@latest(16.2.3) 업그레이드 (CVE-2025-66478 보안 취약점 해소)

# 완료된 작업

## 2026-04-11 — Phase 1 데이터 구조 완료
- data/quiz1.ts: 1차 8문항 + TypeAxis 타입 + Quiz1Question/Option 인터페이스
- data/quiz2.ts: 2차 10문항 + RouteType/RiskType 타입 + Quiz2OptionScores 인터페이스
- data/results.ts: 1차 결과 6종(quiz1Results) + 2차 준비단계 3종(stageResults) + 헬퍼 함수

## 2026-04-11 — Phase 2/3 계산 로직 완료
- lib/scoring.ts 신규 생성
  - calcQuiz1(answers): Quiz1CalcResult
    - 6개 축 점수 합산 → 최고점 축 = 메인 유형
    - 동점 시 Q6~Q8 후반부 점수로 결정 (scoring.md §4)
    - 1점 이내 차이 시 secondaryType 노출 (보조 유형)
  - calcQuiz2(answers, quiz1Type): Quiz2CalcResult
    - ready(Q1+Q5+Q7) · sustain(Q2+Q3+Q6) · logic(Q8) 누적
    - route · risk · careerSupportNeed · urgentFlag 누적
    - 준비 단계 판정: 직행형(ready≥9, sustain≥7, route직행최고, Q5≥2) → 탐색형(ready≤3 또는 route탐색최고) → 브리지형
    - 직무 점수: 1차 초기값 + 2차 보정(logic/ready/sustain 임계값, Q9-D, logic≤1)
    - Top 3 직무 산출: 점수 내림차순, 동점 시 1차 대표 직무 우선
    - 경고 문구: urgentFlag × 준비도/지속성 미달, risk.지속성≥2, risk.방향성≥2

# 블로커 기록
- scoring.md §8 Q9-C("개념은 보는데 직접 만들어보기가 어렵다") → "프론트/백엔드 유지, 경로 브리지 강화" 규칙이 calcQuiz2에 명시적 미구현. question data의 route 가중치(기초+1, 브리지+1)로 간접 반영만 됨. 직무 점수 보정은 누락 상태. 기능 영향 낮으나 scoring.md와 괴리 있음.

# 다음 작업
- Phase 6: README 스크린샷 추가
- Phase 6: GitHub 공개 설정 확인
- Phase 6: 배포 URL 점검
- Phase 6: AI 리포트 초안 작성
- Phase 6: 제출 전 최종 QA