InfoGrab DocsInfoGrab Docs

등록 아키텍처

요약

GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다.

GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 이 문서는 익명 방문자가 가입 페이지에 도착한 시점부터 해당 사용자가 프로젝트나 그룹에 들어가기까지 실행되는 컨트롤러와 서비스를 다룹니다.

아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다. GitLab Self-Managed 구독 구매는 이러한 서비스 일부를 공유하며, 차이점은 해당하는 곳에서 명시적으로 설명합니다.

개요#

이 흐름은 다섯 단계로 이루어집니다. 진입점 선택, 자격 증명 제출, 계정 상태 초기화, 선택적 신원 확인, 그리고 사용자가 등록한 이유에 따라 달라지는 환영 단계입니다.

Mermaid 다이어그램 (12줄)
소스 코드 보기
flowchart TD
    accTitle: GitLab.com registration and onboarding flow
    accDescr: An anonymous user picks an entry point, submits credentials, has their account status initialized, optionally completes identity verification on GitLab.com, then is routed through a welcome controller chosen by registration type, ending at a completion path.
A[Anonymous user] --> B{Entry point}
B --> C[Submit credentials]
C --> D[Onboarding::StatusCreateService]
D --> E{Identity verification required?}
E -->|Yes, GitLab.com only| F[RegistrationsIdentityVerificationController]
E -->|No| G[Welcome controller by registration type]
F -->|success| G
G --&gt; H[Completion path]</code></pre></details></div>

진입점#

익명 사용자는 여러 곳에서 등록을 시작할 수 있습니다.

진입점 경로 컨트롤러
표준 가입 /users/sign_up RegistrationsController#new (CE, EE::RegistrationsController가 prepend)
초대 링크 /users/sign_up?invite=... RegistrationsController#new, AcceptsPendingInvitations concern 사용
체험판 가입 /-/trial_registrations/new TrialRegistrationsController#new (EE)
OmniAuth (Google 또는 GitHub) /users/auth/:provider OmniAuth 요청 단계, 공급자로 리디렉션
OmniAuth 콜백 /users/auth/:provider/callback OmniauthCallbacksController#handle_omniauth
로그인 페이지 /users/sign_in 같은 소셜 가입 버튼 표시
구독 구매 /-/subscriptions/new GitlabSubscriptions::SubscriptionsController#new

소셜 가입 버튼은 POPULAR_PROVIDERS로 나열된 Google(google_oauth2)과 GitHub(github)만 포함합니다. SAML은 그룹별로 Enterprise SSO로 제공되지만 셀프서비스 가입 버튼에는 포함되지 않습니다.

익명 사용자가 /-/subscriptions/new에 도달하면 ensure_registered!가 store_location_for(:user, request.fullpath)를 호출합니다. 사용자가 등록한 뒤에는 기본 완료 경로가 아니라 구독 결제 페이지로 돌아갑니다.

GitLab Self-Managed 구독 구매는 별도의 분기를 따릅니다. 쿼리 매개변수 deployment_type=self_managed와 plan_id가 GitlabSubscriptions::SelfManagedPurchaseRedirect concern을 트리거하며, 이 concern은 EE::RegistrationsController와 GitlabSubscriptions::SubscriptionsController#new에 모두 포함되어 있습니다.

자격 증명 제출#

사용자가 가입 양식을 제출하면 다음 동작 중 하나가 User 레코드를 생성합니다.

  • POST /users → RegistrationsController#create는 Users::RegistrationsBuildService를 통해 사용자를 만듭니다.
  • POST /-/trial_registrations → TrialRegistrationsController#create는 #resource를 재정의하여 대신 Users::AuthorizedBuildService를 통해 사용자를 만듭니다.
  • OmniAuth 가입 → OmniauthCallbacksController#handle_omniauth. OmniAuth 아이덴티티가 2단계 인증이 활성화된 기존 사용자의 것이면 sign_in_user_flow가 로그인을 바로 완료하지 않고 prompt_for_two_factor로 요청을 가로챕니다.

Devise 및 계정 상태 초기화#

계정 생성 직후에 Devise와 관련된 두 가지 로직이 실행됩니다.

  • IdentityVerifiable concern (ee/app/models/concerns/identity_verifiable.rb)은 active_for_authentication?를 재정의하여 GitLab.com에서 확인되지 않은 사용자에 대해 false를 반환하며, 이로 인해 사용자는 정상적으로 로그인하기 전에 신원 확인 경로로 들어가게 됩니다. 이는 Gitlab::Saas.feature_available?(:identity_verification)이 true일 때만 적용됩니다.
  • Onboarding::StatusCreateService는 user_details.onboarding_status JSONB 열에 기록하고 onboarding_in_progress = true를 설정합니다. 이 서비스는 registration_type, initial_registration_type, 그리고 glm_source와 glm_content 마케팅 기여도 매개변수를 기록합니다. 이 단계는 GitLab Self-Managed 구독 등록에서는 건너뜁니다.

온보딩 전체는 Onboarding.enabled?로 제어되며, 이는 Gitlab::Saas.feature_available?(:onboarding)에 위임됩니다.

별개로, 엔터프라이즈 사용자 연결도 이 시점에 실행될 수 있습니다. Groups::EnterpriseUsers::Associable concern이 등록 중에 적격 여부를 확인하며, Groups::EnterpriseUsers::AssociateService는 AssociateWorker를 통해 소급하여 비동기적으로 실행될 수도 있습니다.

등록 유형 전략#

온보딩 동작은 사용자가 등록한 이유에 따라 달라집니다. Onboarding::StatusPresenter는 Onboarding::UserStatus에 위임하며, 이는 ee/app/models/onboarding/user_status.rb에 정의된 REGISTRATION_KLASSES와 REGISTRATION_TYPE 매핑을 사용해 전략 클래스를 선택합니다. 모든 전략 클래스는 ee/app/models/onboarding/ 아래에 있습니다.

등록 유형 전략 클래스 환영 컨트롤러 주요 서비스
무료 FreeRegistration Registrations::WelcomeController Onboarding::FreeNamespaceCreateService
체험판 TrialRegistration Registrations::TrialWelcomeController Onboarding::TrialNamespaceCreateService
자동 체험판 AutomaticTrialRegistration (TrialRegistration의 하위 클래스) Registrations::TrialWelcomeController Onboarding::TrialNamespaceCreateService
초대 InviteRegistration Registrations::InviteWelcomeController Users::InviteSignupService
구독 SubscriptionRegistration Registrations::SubscriptionWelcomeController Onboarding::SubscriptionNamespaceCreateService, 이후 Onboarding::FinishService
구독, GitLab Self-Managed SubscriptionSmRegistration 없음. 이 유형에서는 Onboarding::StatusCreateService를 건너뜁니다. 없음

AutomaticTrialRegistration은 무료에서 체험판으로의 전환을 다룹니다. 사용자는 free로 등록하지만, 현재 registration_type은 trial이 되고 initial_registration_type은 분석을 위해 free로 유지됩니다. 이 전환은 "for my company"를 선택한 무료 사용자가 FreeAutomaticTrialConstraint에 의해 Registrations::TrialWelcomeController로 라우팅될 때 발생합니다. 그러면 Onboarding::TrialNamespaceCreateService가 registration_type을 trial로 설정하며, 이 때문에 Onboarding::UserStatus는 전략을 단순한 TrialRegistration이 아니라 AutomaticTrialRegistration으로 결정합니다.

신원 확인(GitLab.com 전용)#

신원 확인은 GET /users/identity_verification에서 실행되며 RegistrationsIdentityVerificationController#show가 처리합니다.

/-/users/identity_verification 경로는 이미 로그인한 사용자를 다시 확인하는 데 사용되는, 관련 없는 다른 컨트롤러가 처리합니다. 등록 문제를 추적할 때 두 가지를 혼동하지 않도록 주의합니다.

필요한 확인 방법은 위험 점수에 따라 달라집니다.

위험 수준 필요한 방법
낮음 이메일
중간 이메일, 휴대폰
높음 이메일, 휴대폰, 신용카드
높음으로 간주 이메일, 신용카드, 휴대폰

각 방법은 고유한 서비스가 뒷받침합니다.

  • 이메일: verify_email_code 작업이 Users::EmailVerification::ValidateTokenService를 호출합니다.
  • 휴대폰: send_phone_verification_code와 verify_phone_verification_code 작업이 PhoneVerification::Users::SendVerificationCodeService와 PhoneVerification::Users::VerifyCodeService를 호출합니다. 둘 다 PhoneVerification::TelesignClient::*에 위임하며, 이는 Telesign 벤더 API와 통신합니다.
  • 신용카드: verify_credit_card(GET)와 verify_credit_card_captcha(POST) 작업에는 전용 서비스가 하나만 있지 않습니다. 확인은 credit_card_validation과 Users::AutoBanService에 의존합니다. Zuora 호스팅 결제 양식은 프론트엔드에 포함되어 있으며 Gitlab::SubscriptionPortal::Client#payment_form_params와 #validate_payment_method를 사용해 CustomersDot를 통해 중개됩니다. Users::UpsertCreditCardValidationService가 zuora_payment_method_xid와 관련 Stripe 필드를 포함한 결과를 저장합니다.

Users::BaseIdentityVerificationController는 이 경로에서 악용 방지 점검으로 Arkose::TokenVerificationService를 통해 Arkose 챌린지도 적용합니다.

확인에 성공하면 success 작업이 다음을 수행합니다.

  1. 대기 중인 초대를 수락합니다.
  2. 사용자를 로그인시킵니다.
  3. Onboarding::TriggerAccountCreatedIterableService를 호출합니다.
  4. 리디렉션을 결정합니다(완료 경로 참고).

Onboarding::StatusConvertToInviteService는 대기 중인 초대 단계의 일부로만 실행되며, 초대가 실제로 있을 때만 실행됩니다.

환영 컨트롤러와 서비스#

자격 증명이 제출되고, 필요한 경우 신원이 확인되면 환영 컨트롤러가 계정 설정을 마무리합니다. 다음은 현재의 컨트롤러와 서비스이며, 이 흐름의 이전 반복에서는 Users::SignupService와 Users::SubscriptionSignupService를 사용했으나, 둘 다 이를 지원하던 기능 플래그가 정리되면서 제거되었습니다.

  • Registrations::WelcomeController#update는 Onboarding::FreeNamespaceCreateService를 호출합니다.
  • Registrations::TrialWelcomeController#update는 Onboarding::TrialNamespaceCreateService를 호출하며, 이 서비스는 GitlabSubscriptions::CreateLeadService를 통해 영업 리드를 만듭니다. 이 컨트롤러는 TrialUserConstraint와 FreeAutomaticTrialConstraint 모두에서 /users/sign_up/welcome으로 제공됩니다.
  • Registrations::InviteWelcomeController#update는 Users::InviteSignupService를 호출합니다.
  • Registrations::SubscriptionWelcomeController#update는 Onboarding::SubscriptionNamespaceCreateService를 호출한 다음 Onboarding::FinishService를 호출하고, users_sign_up_customers_portal_redirect_path로 리디렉션합니다.
  • Registrations::GroupsController(create와 import)는 Onboarding::FinishService를 호출합니다.
  • Registrations::CustomersPortalRedirectController#show는 구독 및 체험판 사용자를 위한 마지막 단계입니다. auto_submit_sso=true와 함께 CustomersDot로 리디렉션합니다.

완료 경로#

온보딩이 끝난 뒤 사용자가 도착하는 위치는 등록 유형에 따라 달라집니다.

등록 유형 목적지
무료 new_project_path
체험판 new_project_path
구독 stored_location_for(:user), CustomersDot 리디렉션을 통해 구독 결제 페이지로 확인됩니다
초대 초대받은 프로젝트 또는 그룹, polymorphic_path(last_invited_member_source)를 통해 이동
위에 해당하지 않음 /dashboard/projects

외부 시스템#

등록과 온보딩은 GitLab.com 메인 Rails 애플리케이션 외부의 여러 시스템에 의존합니다.

시스템 용도
CustomersDot Gitlab::SubscriptionPortal::Client를 통한 리드와 구독
Arkose 신원 확인 중 악용 방지 챌린지
Telesign 전화번호 확인
CustomersDot를 통한 Zuora 저장된 Stripe 필드를 포함한 신용카드 확인
이메일 또는 SMTP 확인 안내와 인증 코드
Redis 세션 상태와 stored_location_for 리디렉션
PostgreSQL user_details.onboarding_status JSONB 열

추적#

등록과 온보딩은 기여도 및 전환 분석을 위한 데이터를 수집합니다.

  • glm_source와 glm_content 쿼리 매개변수는 계정 상태가 생성될 때 onboarding_status에 저장됩니다.
  • 등록 및 신원 확인 단계는 Snowplow와 내부 제품 분석 이벤트를 내보냅니다.
  • 전환 분석은 initial_registration_type과 현재 registration_type을 구분하며, 등록 유형 전략에서 설명한 무료에서 체험판으로의 전환이 이렇게 측정됩니다.

등록 아키텍처

GitLab v19.6
원문 보기

요약

GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다.

GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 이 문서는 익명 방문자가 가입 페이지에 도착한 시점부터 해당 사용자가 프로젝트나 그룹에 들어가기까지 실행되는 컨트롤러와 서비스를 다룹니다.

아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다. GitLab Self-Managed 구독 구매는 이러한 서비스 일부를 공유하며, 차이점은 해당하는 곳에서 명시적으로 설명합니다.

개요#

이 흐름은 다섯 단계로 이루어집니다. 진입점 선택, 자격 증명 제출, 계정 상태 초기화, 선택적 신원 확인, 그리고 사용자가 등록한 이유에 따라 달라지는 환영 단계입니다.

Mermaid 다이어그램 (12줄)
소스 코드 보기
flowchart TD
    accTitle: GitLab.com registration and onboarding flow
    accDescr: An anonymous user picks an entry point, submits credentials, has their account status initialized, optionally completes identity verification on GitLab.com, then is routed through a welcome controller chosen by registration type, ending at a completion path.
A[Anonymous user] --&gt; B{Entry point}
B --&gt; C[Submit credentials]
C --&gt; D[Onboarding::StatusCreateService]
D --&gt; E{Identity verification required?}
E --&gt;|Yes, GitLab.com only| F[RegistrationsIdentityVerificationController]
E --&gt;|No| G[Welcome controller by registration type]
F --&gt;|success| G
G --&gt; H[Completion path]</code></pre></details></div>

진입점#

익명 사용자는 여러 곳에서 등록을 시작할 수 있습니다.

진입점 경로 컨트롤러
표준 가입 /users/sign_up RegistrationsController#new (CE, EE::RegistrationsController가 prepend)
초대 링크 /users/sign_up?invite=... RegistrationsController#new, AcceptsPendingInvitations concern 사용
체험판 가입 /-/trial_registrations/new TrialRegistrationsController#new (EE)
OmniAuth (Google 또는 GitHub) /users/auth/:provider OmniAuth 요청 단계, 공급자로 리디렉션
OmniAuth 콜백 /users/auth/:provider/callback OmniauthCallbacksController#handle_omniauth
로그인 페이지 /users/sign_in 같은 소셜 가입 버튼 표시
구독 구매 /-/subscriptions/new GitlabSubscriptions::SubscriptionsController#new

소셜 가입 버튼은 POPULAR_PROVIDERS로 나열된 Google(google_oauth2)과 GitHub(github)만 포함합니다. SAML은 그룹별로 Enterprise SSO로 제공되지만 셀프서비스 가입 버튼에는 포함되지 않습니다.

익명 사용자가 /-/subscriptions/new에 도달하면 ensure_registered!가 store_location_for(:user, request.fullpath)를 호출합니다. 사용자가 등록한 뒤에는 기본 완료 경로가 아니라 구독 결제 페이지로 돌아갑니다.

GitLab Self-Managed 구독 구매는 별도의 분기를 따릅니다. 쿼리 매개변수 deployment_type=self_managed와 plan_id가 GitlabSubscriptions::SelfManagedPurchaseRedirect concern을 트리거하며, 이 concern은 EE::RegistrationsController와 GitlabSubscriptions::SubscriptionsController#new에 모두 포함되어 있습니다.

자격 증명 제출#

사용자가 가입 양식을 제출하면 다음 동작 중 하나가 User 레코드를 생성합니다.

  • POST /users → RegistrationsController#create는 Users::RegistrationsBuildService를 통해 사용자를 만듭니다.
  • POST /-/trial_registrations → TrialRegistrationsController#create는 #resource를 재정의하여 대신 Users::AuthorizedBuildService를 통해 사용자를 만듭니다.
  • OmniAuth 가입 → OmniauthCallbacksController#handle_omniauth. OmniAuth 아이덴티티가 2단계 인증이 활성화된 기존 사용자의 것이면 sign_in_user_flow가 로그인을 바로 완료하지 않고 prompt_for_two_factor로 요청을 가로챕니다.

Devise 및 계정 상태 초기화#

계정 생성 직후에 Devise와 관련된 두 가지 로직이 실행됩니다.

  • IdentityVerifiable concern (ee/app/models/concerns/identity_verifiable.rb)은 active_for_authentication?를 재정의하여 GitLab.com에서 확인되지 않은 사용자에 대해 false를 반환하며, 이로 인해 사용자는 정상적으로 로그인하기 전에 신원 확인 경로로 들어가게 됩니다. 이는 Gitlab::Saas.feature_available?(:identity_verification)이 true일 때만 적용됩니다.
  • Onboarding::StatusCreateService는 user_details.onboarding_status JSONB 열에 기록하고 onboarding_in_progress = true를 설정합니다. 이 서비스는 registration_type, initial_registration_type, 그리고 glm_source와 glm_content 마케팅 기여도 매개변수를 기록합니다. 이 단계는 GitLab Self-Managed 구독 등록에서는 건너뜁니다.

온보딩 전체는 Onboarding.enabled?로 제어되며, 이는 Gitlab::Saas.feature_available?(:onboarding)에 위임됩니다.

별개로, 엔터프라이즈 사용자 연결도 이 시점에 실행될 수 있습니다. Groups::EnterpriseUsers::Associable concern이 등록 중에 적격 여부를 확인하며, Groups::EnterpriseUsers::AssociateService는 AssociateWorker를 통해 소급하여 비동기적으로 실행될 수도 있습니다.

등록 유형 전략#

온보딩 동작은 사용자가 등록한 이유에 따라 달라집니다. Onboarding::StatusPresenter는 Onboarding::UserStatus에 위임하며, 이는 ee/app/models/onboarding/user_status.rb에 정의된 REGISTRATION_KLASSES와 REGISTRATION_TYPE 매핑을 사용해 전략 클래스를 선택합니다. 모든 전략 클래스는 ee/app/models/onboarding/ 아래에 있습니다.

등록 유형 전략 클래스 환영 컨트롤러 주요 서비스
무료 FreeRegistration Registrations::WelcomeController Onboarding::FreeNamespaceCreateService
체험판 TrialRegistration Registrations::TrialWelcomeController Onboarding::TrialNamespaceCreateService
자동 체험판 AutomaticTrialRegistration (TrialRegistration의 하위 클래스) Registrations::TrialWelcomeController Onboarding::TrialNamespaceCreateService
초대 InviteRegistration Registrations::InviteWelcomeController Users::InviteSignupService
구독 SubscriptionRegistration Registrations::SubscriptionWelcomeController Onboarding::SubscriptionNamespaceCreateService, 이후 Onboarding::FinishService
구독, GitLab Self-Managed SubscriptionSmRegistration 없음. 이 유형에서는 Onboarding::StatusCreateService를 건너뜁니다. 없음

AutomaticTrialRegistration은 무료에서 체험판으로의 전환을 다룹니다. 사용자는 free로 등록하지만, 현재 registration_type은 trial이 되고 initial_registration_type은 분석을 위해 free로 유지됩니다. 이 전환은 "for my company"를 선택한 무료 사용자가 FreeAutomaticTrialConstraint에 의해 Registrations::TrialWelcomeController로 라우팅될 때 발생합니다. 그러면 Onboarding::TrialNamespaceCreateService가 registration_type을 trial로 설정하며, 이 때문에 Onboarding::UserStatus는 전략을 단순한 TrialRegistration이 아니라 AutomaticTrialRegistration으로 결정합니다.

신원 확인(GitLab.com 전용)#

신원 확인은 GET /users/identity_verification에서 실행되며 RegistrationsIdentityVerificationController#show가 처리합니다.

/-/users/identity_verification 경로는 이미 로그인한 사용자를 다시 확인하는 데 사용되는, 관련 없는 다른 컨트롤러가 처리합니다. 등록 문제를 추적할 때 두 가지를 혼동하지 않도록 주의합니다.

필요한 확인 방법은 위험 점수에 따라 달라집니다.

위험 수준 필요한 방법
낮음 이메일
중간 이메일, 휴대폰
높음 이메일, 휴대폰, 신용카드
높음으로 간주 이메일, 신용카드, 휴대폰

각 방법은 고유한 서비스가 뒷받침합니다.

  • 이메일: verify_email_code 작업이 Users::EmailVerification::ValidateTokenService를 호출합니다.
  • 휴대폰: send_phone_verification_code와 verify_phone_verification_code 작업이 PhoneVerification::Users::SendVerificationCodeService와 PhoneVerification::Users::VerifyCodeService를 호출합니다. 둘 다 PhoneVerification::TelesignClient::*에 위임하며, 이는 Telesign 벤더 API와 통신합니다.
  • 신용카드: verify_credit_card(GET)와 verify_credit_card_captcha(POST) 작업에는 전용 서비스가 하나만 있지 않습니다. 확인은 credit_card_validation과 Users::AutoBanService에 의존합니다. Zuora 호스팅 결제 양식은 프론트엔드에 포함되어 있으며 Gitlab::SubscriptionPortal::Client#payment_form_params와 #validate_payment_method를 사용해 CustomersDot를 통해 중개됩니다. Users::UpsertCreditCardValidationService가 zuora_payment_method_xid와 관련 Stripe 필드를 포함한 결과를 저장합니다.

Users::BaseIdentityVerificationController는 이 경로에서 악용 방지 점검으로 Arkose::TokenVerificationService를 통해 Arkose 챌린지도 적용합니다.

확인에 성공하면 success 작업이 다음을 수행합니다.

  1. 대기 중인 초대를 수락합니다.
  2. 사용자를 로그인시킵니다.
  3. Onboarding::TriggerAccountCreatedIterableService를 호출합니다.
  4. 리디렉션을 결정합니다(완료 경로 참고).

Onboarding::StatusConvertToInviteService는 대기 중인 초대 단계의 일부로만 실행되며, 초대가 실제로 있을 때만 실행됩니다.

환영 컨트롤러와 서비스#

자격 증명이 제출되고, 필요한 경우 신원이 확인되면 환영 컨트롤러가 계정 설정을 마무리합니다. 다음은 현재의 컨트롤러와 서비스이며, 이 흐름의 이전 반복에서는 Users::SignupService와 Users::SubscriptionSignupService를 사용했으나, 둘 다 이를 지원하던 기능 플래그가 정리되면서 제거되었습니다.

  • Registrations::WelcomeController#update는 Onboarding::FreeNamespaceCreateService를 호출합니다.
  • Registrations::TrialWelcomeController#update는 Onboarding::TrialNamespaceCreateService를 호출하며, 이 서비스는 GitlabSubscriptions::CreateLeadService를 통해 영업 리드를 만듭니다. 이 컨트롤러는 TrialUserConstraint와 FreeAutomaticTrialConstraint 모두에서 /users/sign_up/welcome으로 제공됩니다.
  • Registrations::InviteWelcomeController#update는 Users::InviteSignupService를 호출합니다.
  • Registrations::SubscriptionWelcomeController#update는 Onboarding::SubscriptionNamespaceCreateService를 호출한 다음 Onboarding::FinishService를 호출하고, users_sign_up_customers_portal_redirect_path로 리디렉션합니다.
  • Registrations::GroupsController(create와 import)는 Onboarding::FinishService를 호출합니다.
  • Registrations::CustomersPortalRedirectController#show는 구독 및 체험판 사용자를 위한 마지막 단계입니다. auto_submit_sso=true와 함께 CustomersDot로 리디렉션합니다.

완료 경로#

온보딩이 끝난 뒤 사용자가 도착하는 위치는 등록 유형에 따라 달라집니다.

등록 유형 목적지
무료 new_project_path
체험판 new_project_path
구독 stored_location_for(:user), CustomersDot 리디렉션을 통해 구독 결제 페이지로 확인됩니다
초대 초대받은 프로젝트 또는 그룹, polymorphic_path(last_invited_member_source)를 통해 이동
위에 해당하지 않음 /dashboard/projects

외부 시스템#

등록과 온보딩은 GitLab.com 메인 Rails 애플리케이션 외부의 여러 시스템에 의존합니다.

시스템 용도
CustomersDot Gitlab::SubscriptionPortal::Client를 통한 리드와 구독
Arkose 신원 확인 중 악용 방지 챌린지
Telesign 전화번호 확인
CustomersDot를 통한 Zuora 저장된 Stripe 필드를 포함한 신용카드 확인
이메일 또는 SMTP 확인 안내와 인증 코드
Redis 세션 상태와 stored_location_for 리디렉션
PostgreSQL user_details.onboarding_status JSONB 열

추적#

등록과 온보딩은 기여도 및 전환 분석을 위한 데이터를 수집합니다.

  • glm_source와 glm_content 쿼리 매개변수는 계정 상태가 생성될 때 onboarding_status에 저장됩니다.
  • 등록 및 신원 확인 단계는 Snowplow와 내부 제품 분석 이벤트를 내보냅니다.
  • 전환 분석은 initial_registration_type과 현재 registration_type을 구분하며, 등록 유형 전략에서 설명한 무료에서 체험판으로의 전환이 이렇게 측정됩니다.