아키텍처
HeadVer - 기민한 프로덕트 팀을 위한 새로운 버저닝 시스템
두줄요약
HeadVer는 최종 사용자 대상 프로덕트에 맞춘 버저닝 규칙으로, Head-YearWeek-Build 구조를 제안했습니다. 릴리스 시점과 빌드 재현성을 높여 팀 커뮤니케이션과 운영 효율을 개선했습니다.
핵심 내용
- 최종 사용자 대상 프로덕트에 맞춘 버저닝 규칙 HeadVer 소개
- {Head}.{YearWeek}.{Build} 구조로 의미를 분리하고, 첫째 자리는 수동 설정, 둘째·셋째 자리는 자동 생성으로 고정
- 버전 자체로 릴리스 시점, 수정 시점, 빌드 재현성을 빠르게 파악하도록 설계
- 메타데이터로 플랫폼 식별자를 붙여 OS 단위 추적과 커뮤니케이션 효율을 개선
구조와 흐름
- Head: 사용자에게 도달한 횟수를 기준으로 빠르게 증가하는 수동 버전
- YearWeek: ISO8601 주차 기반의 자동 시간 정보
- Build: 빌드 파이프라인에서 자동 부여되는 고유 번호
선택 이유
- SemVer는 API 관리 중심이라 최종 사용자 서비스에는 정보력이 부족
- 주차 단위는 릴리스 시점과 계절감을 함께 전달하기에 적절
- 숫자 하나하나에 의미를 부여해 버전 관련 질문 자체를 줄이려는 목표
적용해볼 점
- 빌드 시점에 버전을 자동 생성하는 파이프라인 구축
- QA와 개발이 같은 버전 표기 기준으로 버그 재현과 신고를 정밀하게 수행
- 릴리스 계획과 디버깅 대화에서 head, build처럼 필요한 정보만 분리해 사용