Specvital 문서
Specvital은 코드 리뷰 프로세스를 개선하기 위해 설계된 오픈소스 테스트 커버리지 인사이트 도구.
문서 구조
PRD (Product Requirements Document)
Specvital 플랫폼의 제품 사양 및 요구사항 문서.
- 제품 개요 - 제품 비전, 타겟 사용자, GTM 전략
- 아키텍처 - 시스템 아키텍처 및 서비스 구성
- 코어 엔진 - 테스트 파서 라이브러리 설계
- 웹 플랫폼 - 웹 대시보드 및 REST API
- 워커 서비스 - 백그라운드 분석 워커
- 데이터베이스 설계 - 데이터베이스 스키마 및 설계
- 기술 스택 - 기술 선택 및 근거
ADR (Architecture Decision Records)
Specvital 개발 중 내린 아키텍처 결정에 대한 문서.
공통
- ADR 개요 - 아키텍처 결정 기록 소개
- 정적 분석 접근법
- 경쟁 차별화
- API 워커 서비스 분리
- 큐 기반 비동기 처리
- 리포지토리 전략
- PaaS 우선 인프라
- 공유 인프라
- External Repo ID 무결성
- GitHub App 통합
- TestStatus 데이터 계약
- Repository Visibility 기반 접근 제어
- Worker 중심 분석 라이프사이클
- 빌링 및 쿼터 아키텍처
- AI 기반 스펙 문서 생성 파이프라인
- 파서 버전 추적
- 멀티큐 우선순위 라우팅
- 테스트 파일 스키마 정규화
- GitHub API 캐시 테이블
- 계층적 스펙 문서 스키마
- GitHub App 설치 스키마
- 동시 요청 처리용 할당량 예약
- Scheduler 제거 및 Railway Cron 전환
- Railway IaC 배포
- 코어 라이브러리 분리
- 동적 테스트 카운팅 정책
- Tree-sitter AST 파싱 엔진
- Early-Return 프레임워크 탐지
- 파서 풀링 비활성화
- 통합 Framework Definition
- Source 추상화 인터페이스
- 공유 파서 모듈
- Config 스코프 해석
- 표준 Go 프로젝트 레이아웃
- 골든 스냅샷 통합 테스트
- Worker Pool 병렬 스캔
- NaCl SecretBox 암호화
- 간접 Import Alias 감지 미지원
- C# 전처리기 블록 내 Attribute 감지 한계
- 도메인 힌트 추출 시스템
- Swift Testing 프레임워크 지원
- JUnit 4 프레임워크 분리
- Vitest 4.0+ test.for/it.for API 지원
- Java 21+ 암시적 클래스 감지
- Rust 매크로 기반 테스트 감지
- 스케줄 기반 재분석
- Clean Architecture 레이어
- Graceful Shutdown
- OAuth 토큰 Degradation
- Analyzer-Scheduler 분리
- Semaphore Clone 동시성
- Repository 패턴
- SpecView Worker 바이너리 분리
- Phase 1 V1 품질 개선 아키텍처
- 사용자별 공정성 미들웨어
- 보존 기간 기반 데이터 정리 서비스
- Phase 2 행동 캐시
- 백엔드 언어로 Go 선택
- Next.js 16 + React 19 선택
- Chi 라우터 선택
- TanStack Query 선택
- shadcn/ui + Tailwind CSS 선택
- SQLc 선택
- Next.js BFF 아키텍처
- Clean Architecture 패턴
- DI Container 패턴
- StrictServerInterface 계약
- Feature 기반 모듈 구조
- APIHandlers 합성 패턴
- 도메인 에러 처리 패턴
- slog 구조화 로깅
- React 19 use() Hook 패턴
- nuqs URL 상태 관리
- next-intl i18n 전략
- next-themes 다크 모드
- CSS 변수 디자인 토큰 시스템
- 스켈레톤 로딩 패턴
- 익명 사용자 Rate Limiting
- React Compiler 도입
- 윈도우 레벨 가상화 패턴
- 구독 기간 일할 계산
- OAuth 리턴 URL 처리
- Zustand 클라이언트 상태 관리
- 커밋 기반 분석 조회
- 동적 비용 예측
기술 레이더
플랫폼 전반의 기술 채택 현황 및 평가 기준.
릴리즈 노트
전체 서비스 릴리즈 히스토리 (Core, Worker, Web, Infra).
용어집
플랫폼 전반에서 사용되는 도메인 용어.
아키텍처 개요
상위 수준의 시스템 아키텍처 문서.
관련 리포지토리
Specvital 플랫폼은 여러 리포지토리로 구성됨:
- specvital/core - 파서 엔진
- specvital/web - 웹 플랫폼
- specvital/worker - 워커 서비스
- specvital/infra - 인프라 및 스키마
기여하기
Specvital의 메인 문서 리포지토리. 기여 가이드라인은 각 리포지토리의 CONTRIBUTING.md 파일 참조.
라이선스
자세한 내용은 LICENSE 참조.