실전 프로젝트: SDD 검증 대시보드 (중급)

프로젝트 목표

터미널에서 /sdd.review로 하던 검증을 웹 대시보드에서 시각적으로 수행한다. GitHub 저장소에 연결하면 SDD 준수 여부를 자동 검증하는 대시보드를 만든다.

아키텍처

MVP 기능 3가지

기능	설명
Repository Browser	GitHub 로그인 후 레포 목록에서 선택
문서 파서	업로드된 PRD/Spec 파일을 분석
준수 검증 엔진	SDD 규격 대비 준수 여부 판정

SDD Auto로 풀체인 실행

/sdd.auto GitHub에 로그인하면 레포의 SDD 준수 여부를 검증해주는 대시보드 만들어줘

Build 단계가 Phase 1~4로 나뉘어 순차 실행되었다. 전체 소요 시간은 약 30분.

GitHub OAuth 설정 과정

이 프로젝트에서 가장 중요한 실습 포인트는 GitHub OAuth 연동이다.

.env.local 설정

GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

발생한 문제와 해결

문제 1: GitHub 로그인 서버 에러

문제 2: SDD 준수율이 너무 낮음

검증 엔진이 PRD의 수용 기준 체크리스트를 검증 규칙으로 오인하는 파서 버그가 있었다.

핵심 교훈

교훈	상세
OAuth 설정은 사전에	토큰/키 없이는 서비스 동작 불가
에러 로그를 AI에게 전달	에러 메시지를 복사해서 붙여넣으면 해결
검증 규격은 팀에 맞게	기본 검증 규칙을 프로젝트에 맞게 커스터마이징
풀체인으로 ~30분	PRD부터 검증까지 자동화 가능