InfoGrab Docs

완료 정의(Definition of Done)

요약

이 완료 정의(DoD)는 여러 MR과 마일스톤에 걸쳐 구현된 기능에 적용됩니다. 이러한 요구 사항은 성숙도 수준이 베타 이상인 기능에 필수입니다.

이 완료 정의(DoD)는 여러 MR과 마일스톤에 걸쳐 구현된 기능에 적용됩니다. MR 수준 DoD를 보완하며 기능이 완성되고 프로덕션 준비 상태인지 판단하는 기준을 제공합니다.

개발 완료#

  • 기능의 수락 기준이 충족되었습니다.
  • 모든 기능 구현 에픽/이슈가 닫혔거나 명확한 근거와 함께 잘 범위가 정해진 후속 작업으로 이동되었습니다.
  • 모든 필요한 MR이 main에 머지되었고, 관련 이슈가 (자동 또는 수동으로) 닫혔습니다.
  • 피처 플래그가 롤아웃되고 제거되었습니다.

테스트 및 검증#

  • 단위, 통합, 기능 및 E2E 테스트가 적절하게 구현되었습니다.
  • E2E 테스트가 실제 사용 사례에 대한 높은 신뢰도를 보장하기 위해 중요한 사용자 여정을 다룹니다.
  • (선택 사항) 탐색적 테스트 세션이 엔지니어 및/또는 다운스트림 대응 팀에 의해 수행되었습니다:
    • 엣지 케이스와 예기치 않은 상호작용을 포함하여 자동화된 테스트 범위를 넘어선 UX 및 워크플로우 검증
    • 접근성 요구 사항 충족 보장
    • 실제 사용 시나리오에서의 성능 검증
    • (선택 사항) 기능이 다운스트림 팀(예: 데이터, 재무, 영업, 지원)에 영향을 미치는 경우, 영향받는 팀의 대표자가 기능이 운영 요구를 충족하는지 확인하기 위해 검증에 참여했습니다
  • 기능이 프로덕션 환경에서 검증되었습니다.
  • 기능이 인접 기능과 일관성 있게 통합되는지 확인하기 위해 전체 사용자 여정의 컨텍스트에서 평가되었습니다.
  • 심각도 1 또는 2의 버그가 해결되지 않은 채로 남아있지 않습니다. 낮은 심각도의 이슈는 추적되고 우선순위가 지정됩니다.
  • 필요한 경우 피드백 이슈가 생성되었습니다.

운영 준비성#

  • 데이터베이스 마이그레이션이 완료되고, (필요한 경우) 되돌릴 수 있으며, 배포에 안전합니다. 해당하는 경우 백그라운드 마이그레이션이 예약되고 모니터링되었습니다.
  • 로그, 메트릭, 오류 추적(예: Sentry)을 통한 관찰 가능성이 갖추어져 있으며, 필요한 경우 관련 알림이 구성되어 있습니다.
  • 기능이 예상 프로덕션 부하에서 적절하게 수행됩니다.
  • 의도적으로 다르게 범위가 정해지지 않은 한, 기능은 GitLab.com 및 자체 관리 환경(Dedicated 및 정부용 Dedicated 포함) 모두에서 프로덕션 준비가 되어 있습니다.

문서화 및 커뮤니케이션#

  • 최종 사용자 문서가 적절한 /doc/ 위치에 업데이트되었습니다.
  • 기술 문서(예: 코드 주석, 아키텍처 결정, 피처 플래그 동작)가 최신 상태입니다.
  • 올바른 버전과 섹션 아래에 체인지로그 항목이 추가되었고, 적절한 체인지로그 레이블이 적용되었습니다.
  • 기능이 관련 PM, UX 및 EM 이해관계자에게 검토 및 승인되었습니다.
  • 기능이 내부적으로 데모되었거나 관련 릴리스 킥오프, 마일스톤 회고 또는 내부 동기화에 포함되었으며, 외부 캠페인 지원을 위해 제품 마케팅과 공유되었습니다.

사용량 계측#

이러한 요구 사항은 성숙도 수준이 베타 이상인 기능에 필수입니다. 실험적 기능에는 선택 사항이지만, 초기 구현을 통해 처음부터 채택을 추적할 수 있으므로 강력히 권장됩니다.

  • 기능 채택을 추적하기 위한 사용량 메트릭이 구현되었습니다.
  • 해당하는 경우 사용자 대면 기능에 대한 월간 활성 사용자(MAU) 메트릭이 추가되었습니다.
  • 메트릭이 올바른 그룹 및 기능 카테고리에 적절히 귀속되었습니다.
  • 계측이 모든 해당 배포 유형(GitLab.com, GitLab 자체 관리, GitLab Dedicated)에서 검증되었습니다.
  • 메트릭 데이터가 관련 대시보드에 표시되고 분석에 접근 가능합니다.

롤아웃 및 릴리스 후#

  • 기능이 다음 중 하나입니다:
    • 기본적으로 활성화, 또는
    • 문서화된 롤아웃 및 활성화 계획이 있는 피처 플래그 뒤에 게이팅됨.
  • 기능이 플래그 뒤에 있는 경우 관련 DRI가 롤아웃 이슈를 생성하고 검토했습니다.
  • 필요한 배포 후 마이그레이션 또는 정리 작업이 추적됩니다.
  • 성공 메트릭 또는 KPI가 정의되고, 모니터링되고, 영향을 평가하는 데 사용됩니다.
  • 사용자 피드백, 사용 트렌드 또는 후속 이슈를 캡처하기 위한 피드백 루프가 갖추어져 있습니다.

완료 정의(Definition of Done)

원문 보기
요약

이 완료 정의(DoD)는 여러 MR과 마일스톤에 걸쳐 구현된 기능에 적용됩니다. 이러한 요구 사항은 성숙도 수준이 베타 이상인 기능에 필수입니다.

이 완료 정의(DoD)는 여러 MR과 마일스톤에 걸쳐 구현된 기능에 적용됩니다. MR 수준 DoD를 보완하며 기능이 완성되고 프로덕션 준비 상태인지 판단하는 기준을 제공합니다.

개발 완료#

  • 기능의 수락 기준이 충족되었습니다.
  • 모든 기능 구현 에픽/이슈가 닫혔거나 명확한 근거와 함께 잘 범위가 정해진 후속 작업으로 이동되었습니다.
  • 모든 필요한 MR이 main에 머지되었고, 관련 이슈가 (자동 또는 수동으로) 닫혔습니다.
  • 피처 플래그가 롤아웃되고 제거되었습니다.

테스트 및 검증#

  • 단위, 통합, 기능 및 E2E 테스트가 적절하게 구현되었습니다.
  • E2E 테스트가 실제 사용 사례에 대한 높은 신뢰도를 보장하기 위해 중요한 사용자 여정을 다룹니다.
  • (선택 사항) 탐색적 테스트 세션이 엔지니어 및/또는 다운스트림 대응 팀에 의해 수행되었습니다:
    • 엣지 케이스와 예기치 않은 상호작용을 포함하여 자동화된 테스트 범위를 넘어선 UX 및 워크플로우 검증
    • 접근성 요구 사항 충족 보장
    • 실제 사용 시나리오에서의 성능 검증
    • (선택 사항) 기능이 다운스트림 팀(예: 데이터, 재무, 영업, 지원)에 영향을 미치는 경우, 영향받는 팀의 대표자가 기능이 운영 요구를 충족하는지 확인하기 위해 검증에 참여했습니다
  • 기능이 프로덕션 환경에서 검증되었습니다.
  • 기능이 인접 기능과 일관성 있게 통합되는지 확인하기 위해 전체 사용자 여정의 컨텍스트에서 평가되었습니다.
  • 심각도 1 또는 2의 버그가 해결되지 않은 채로 남아있지 않습니다. 낮은 심각도의 이슈는 추적되고 우선순위가 지정됩니다.
  • 필요한 경우 피드백 이슈가 생성되었습니다.

운영 준비성#

  • 데이터베이스 마이그레이션이 완료되고, (필요한 경우) 되돌릴 수 있으며, 배포에 안전합니다. 해당하는 경우 백그라운드 마이그레이션이 예약되고 모니터링되었습니다.
  • 로그, 메트릭, 오류 추적(예: Sentry)을 통한 관찰 가능성이 갖추어져 있으며, 필요한 경우 관련 알림이 구성되어 있습니다.
  • 기능이 예상 프로덕션 부하에서 적절하게 수행됩니다.
  • 의도적으로 다르게 범위가 정해지지 않은 한, 기능은 GitLab.com 및 자체 관리 환경(Dedicated 및 정부용 Dedicated 포함) 모두에서 프로덕션 준비가 되어 있습니다.

문서화 및 커뮤니케이션#

  • 최종 사용자 문서가 적절한 /doc/ 위치에 업데이트되었습니다.
  • 기술 문서(예: 코드 주석, 아키텍처 결정, 피처 플래그 동작)가 최신 상태입니다.
  • 올바른 버전과 섹션 아래에 체인지로그 항목이 추가되었고, 적절한 체인지로그 레이블이 적용되었습니다.
  • 기능이 관련 PM, UX 및 EM 이해관계자에게 검토 및 승인되었습니다.
  • 기능이 내부적으로 데모되었거나 관련 릴리스 킥오프, 마일스톤 회고 또는 내부 동기화에 포함되었으며, 외부 캠페인 지원을 위해 제품 마케팅과 공유되었습니다.

사용량 계측#

이러한 요구 사항은 성숙도 수준이 베타 이상인 기능에 필수입니다. 실험적 기능에는 선택 사항이지만, 초기 구현을 통해 처음부터 채택을 추적할 수 있으므로 강력히 권장됩니다.

  • 기능 채택을 추적하기 위한 사용량 메트릭이 구현되었습니다.
  • 해당하는 경우 사용자 대면 기능에 대한 월간 활성 사용자(MAU) 메트릭이 추가되었습니다.
  • 메트릭이 올바른 그룹 및 기능 카테고리에 적절히 귀속되었습니다.
  • 계측이 모든 해당 배포 유형(GitLab.com, GitLab 자체 관리, GitLab Dedicated)에서 검증되었습니다.
  • 메트릭 데이터가 관련 대시보드에 표시되고 분석에 접근 가능합니다.

롤아웃 및 릴리스 후#

  • 기능이 다음 중 하나입니다:
    • 기본적으로 활성화, 또는
    • 문서화된 롤아웃 및 활성화 계획이 있는 피처 플래그 뒤에 게이팅됨.
  • 기능이 플래그 뒤에 있는 경우 관련 DRI가 롤아웃 이슈를 생성하고 검토했습니다.
  • 필요한 배포 후 마이그레이션 또는 정리 작업이 추적됩니다.
  • 성공 메트릭 또는 KPI가 정의되고, 모니터링되고, 영향을 평가하는 데 사용됩니다.
  • 사용자 피드백, 사용 트렌드 또는 후속 이슈를 캡처하기 위한 피드백 루프가 갖추어져 있습니다.