가치 스트림 분석 개발 매뉴얼

def timestamp_projection
  # 여기에 타임스탬프 표현을 넣으세요
end

# 이벤트는 기간 계산에 이슈 생성 시간을 사용할 것입니다
def timestamp_projection
  Issue.arel_table[:created_at]
end

def object_type
  Issue
end

def timestamp_projection
  IssueMetrics.arel_table[:first_mentioned_in_commit_at]
end

def apply_query_customization(query)
  # 이 경우 쿼리 어트리뷰트는 Issue 모델에 기반하여 생성될 것입니다: `Issue.where(...)`
  query.joins(:metrics)
end

graph LR; 이슈_생성 --> 이슈_종료; 이슈_생성 --> 이슈_게시판에_최초_추가; 이슈_생성 --> 이슈_마일스톤과_최초_연관_생성; 이슈_생성 --> 커밋에_최초_언급된_이슈_생성; 이슈_생성 --> 이슈_최종_수정; 이슈_생성 --> 이슈_레이블_추가; 이슈_생성 --> 이슈_레이블_제거; 이슈_생성 --> 이슈_최초_할당_시간; Merge_요청_생성 --> Merge_요청_Merge; Merge_요청_생성 --> Merge_요청_종료; Merge_요청_생성 --> Merge_요청_최초_프로덕션_배포; Merge_요청_생성 --> Merge_요청_최종_빌드_시작; Merge_요청_생성 --> Merge_요청_최종_빌드_완료; Merge_요청_생성 --> Merge_요청_최종_수정; Merge_요청_생성 --> Merge_요청_레이블_추가; Merge_요청_생성 --> Merge_요청_레이블_제거; Merge_요청_생성 --> Merge_요청_최초_할당_시간; Merge_요청_최초_할당_시간 --> Merge_요청_종료; Merge_요청_최초_할당_시간 --> Merge_요청_최종_빌드_시작; Merge_요청_최초_할당_시간 --> Merge_요청_최종_수정; Merge_요청_최초_할당_시간 --> Merge_요청_Merge; Merge_요청_최초_할당_시간 --> Merge_요청_레이블_추가; Merge_요청_최초_할당_시간 --> Merge_요청_레이블_제거; Merge_요청_최종_빌드_시작 --> Merge_요청_최종_빌드_완료; Merge_요청_최종_빌드_시작 --> Merge_요청_종료; Merge_요청_최종_빌드_시작 --> Merge_요청_최초_프로덕션_배포; Merge_요청_최종_빌드_시작 --> Merge_요청_최종_수정; Merge_요청_최종_빌드_시작 --> Merge_요청_Merge; Merge_요청_최종_빌드_시작 --> Merge_요청_레이블_추가; Merge_요청_최종_빌드_시작 --> Merge_요청_레이블_제거; Merge_요청_Merge --> Merge_요청_최초_프로덕션_배포; Merge_요청_Merge --> Merge_요청_종료; Merge_요청_Merge --> Merge_요청_최초_프로덕션_배포; Merge_요청_Merge --> Merge_요청_최종_수정; Merge_요청_Merge --> Merge_요청_레이블_추가; Merge_요청_Merge --> Merge_요청_레이블_제거; 이슈_레이블_추가 --> 이슈_레이블_추가; 이슈_레이블_추가 --> 이슈_레이블_제거; 이슈_레이블_추가 --> 이슈_종료; 이슈_레이블_추가 --> 이슈_최초_할당_시간; 이슈_레이블_제거 --> 이슈_종료; 이슈_레이블_제거 --> 이슈_최초_할당_시간; 이슈_게시판에_최초_추가 --> 이슈_종료; 이슈_게시판에_최초_추가 --> 이슈_마일스톤과_최초_연관_생성; 이슈_게시판에_최초_추가 --> 커밋에_최초_언급된_이슈_생성; 이슈_게시판에_최초_추가 --> 이슈_최종_수정; 이슈_게시판에_최초_추가 --> 이슈_레이블_추가 ## 기본 스테이지 가치 스트림 분석의 [초기 구현](https://gitlab.com/gitlab-org/gitlab/-/issues/847)에서는 7개의 스테이지가 정의되었습니다. 이러한 스테이지는 항상 각 부모에 대해 사용할 수 있지만, 이러한 스테이지를 변경하는 것은 불가능합니다. 작업을 효율적으로 만들고 생성된 레코드의 수를 줄이기 위해 기본 스테이지는 메모리 내부 객체(지속되지 않음)로 표현됩니다. 사용자가 처음으로 사용자 정의 스테이지를 생성할 때, 모든 스테이지가 지속됩니다. 이 동작은 가치 스트림 분석 서비스 객체에 구현되어 있습니다. 이러한 이유는 나중에 스테이지를 숨기고 정렬할 수 있는 기능을 추가하고자 했기 때문입니다. ## 데이터 수집기 `DataCollector`는 데이터가 데이터베이스에서 쿼리될 중심 지점입니다. 이 클래스는 항상 단일 스테이지에서 작동하며 다음 컴포넌트로 구성되어 있습니다. - `BaseQueryBuilder`: - 초기 쿼리를 구성하는 데 책임을 집니다. - `Stage`별 구성: 이벤트 및 이들의 쿼리 사용자 정의를 다룸. - UI에서 오는 매개변수: 날짜 범위. - `Median`: `BaseQueryBuilder`에서의 쿼리를 사용하여 스테이지의 중위수 기간을 계산합니다. - `RecordsFetcher`: `BaseQueryBuilder`에서의 쿼리 및 가시성 규칙을 적용하기 위해 특정 `Finder` 클래스를 사용하여 스테이지에 대한 관련 레코드를 로드합니다. - `DataForDurationChart`: 산점도 차트를 위해 완료된 기간과 그 끝 이벤트 타임스탬프로 계산된 기간을 로드합니다. 새로운 계산 또는 쿼리를 지원하려면 `DataCollector` 클래스에서 새로운 메서드 호출로 구현하십시오. 집계된 가치 스트림 분석 백엔드를 지원하기 위해 이러한 클래스들은 [`Aggregated`](https://gitlab.com/gitlab-org/gitlab/-/tree/master/lib/gitlab/analytics/cycle_analytics/aggregated) 네임스페이스 내에서 다시 구현되었습니다. ### 데이터베이스 쿼리 백엔드 VSA는 두 가지 백엔드를 지원합니다: 집계된(`aggregated`) 및 "실시간". 실시간 쿼리 백엔드는 어느 순간에는 점진적으로 단계적으로 중단될 수 있습니다. - "실시간": 표준 `IssuableFinders`를 사용합니다. - 집계된: 사전에 집계된 데이터베이스 테이블에서 데이터를 쿼리합니다. ## 고수준 개요 - Rails Controller (`Analytics::CycleAnalytics` 모듈): 가치 스트림 분석은 `analytics` 작업 영역 내에서 구현된 JSON 엔드포인트를 통해 데이터를 노출시킵니다. 또한 스테이지 설정은 JSON 엔드포인트 (CRUD) 내에서 구현됩니다. - Services (`Analytics::CycleAnalytics` 모듈): 모든 `Stage` 관련 작업은 해당 서비스 객체에 위임됩니다. - Models (`Analytics::CycleAnalytics` 모듈): 모델은 `Stage` 객체를 지속시키는 데 사용됩니다. - Feature 클래스 (`Gitlab::Analytics::CycleAnalytics` 모듈): - 쿼리를 구성하고 기능별 비즈니스 로직을 정의하는 책임을 집니다. - `DataCollector`, `Event`, `StageEvents` 등. ## 프런트엔드 [프로젝트 VSA](../user/group/value_stream_analytics/index.md)는 모든 사용자를 대상으로 하며 다음을 포함합니다: - 티어에 따라 키 및 DORA 지표가 혼합되어 있음. - [기본 스테이지](#default-stages)들을 사용합니다. [그룹 VSA](../user/group/value_stream_analytics/index.md)는 라이선스가 있는 사용자만 사용할 수 있으며 다음을 포함합니다: - [개요 스테이지](https://gitlab.com/gitlab-org/gitlab/-/issues/321438). - 사용자 정의 가치 스트림을 만들 수 있는 기능. 그룹 및 프로젝트 수준 VSA 프런트엔드는 모두 Vue와 Vuex로 작성되었으며 유사한 패턴을 따릅니다: - `index.js` 파일은 모든 URL 쿼리 매개변수를 추출하고 Vue 앱과 Vuex 스토어를 생성하고 `initialize` Vuex 액션을 디스패치합니다. - `base.vue` 파일은 각 페이지, 메트릭, 필터, 차트 및 스테이지 테이블을 렌더링하는 데 사용됩니다. 그룹 VSA Vuex 스토어는 [Vuex 모듈](https://vuex.vuejs.org/guide/modules.html)을 사용하여 일부 차트 렌더링에 사용되는 일부 상태와 로직을 분리합니다. ### 공유 컴포넌트 프로젝트 VSA 및 그룹 VSA 간의 일부 UI가 공유될 수 있으며 스테이지 테이블 및 경로와 같은 공유 컴포넌트는 프로젝트 VSA 디렉터리 `app/assets/javascripts/cycle_analytics/components`에 있으며 필요한 경우 그룹 수준 VSA에 포함됩니다. 그룹 수준 기능의 모든 프런트엔드 코드는 `ee/app/assets/javascripts/analytics/cycle_analytics/components`에 있습니다. ## 테스트 많은 이벤트와 가능한 페어링이 있기 때문에 각 페어링을 테스트하는 것은 불가능합니다. 규칙은 `Event` 클래스를 사용한 적어도 하나의 테스트 케이스를 갖는 것입니다. 새로운 `Event`를 사용하여 스테이지에 대한 테스트 케이스를 작성하는 것은 데이터를 두 가지 이벤트로 생성해야 하기 때문에 어려울 수 있습니다. 이를 약간 단순화하기 위해 각 테스트 케이스는 스테이지가 `DataCollector`를 통해 테스트되는 `data_collector_spec.rb`에 구현되어야 합니다. 각 테스트 케이스는 다음 사례를 다루는 여러 테스트로 전환됩니다: - 다른 부모: `그룹` 또는 `프로젝트` - 다른 계산: `중위수`, `RecordsFetcher` 또는 `DataForDurationChart` VSA 프런트엔드는 두 가지 다른 수준(통합, 단위)에서 철저하게 테스트됩니다: - Capybara 및 RSpec를 통해 실제 백엔드를 사용한 end-to-end 통합 테스트. - pre-generated 데이터 fixtures를 사용한 Jest 프런트엔드 테스트. ## 개발 설정 및 테스트 가치 스트림 분석을 실행하는 방법은 [GDK](https://gitlab.com/gitlab-org/gitlab-development-kit)를 통해 수행할 수 있습니다. 기본적으로 프로젝트 수준(FOSS) 버전의 기능을 볼 수 있습니다. GDK가 실행 중이면 시드 스크립트를 실행하여 데이터를 생성할 수 있습니다: ```shell SEED_CYCLE_ANALYTICS=true SEED_VSA=true FILTER=cycle_analytics rake db:seed_fu

Analytics::CycleAnalytics::ReaggregationWorker.new.perform