신규 사이트 온보딩 진행도 한눈에 확인

신규 사이트가 발견되면 그걸 시스템에 제대로 온보딩하는 건 단순한 기술 작업이 아니다. 운영팀과 개발팀 사이에 "지금 어디까지 했는데?"라는 질문이 자주 오가는데, 체크리스트 카드를 추가하면서 그 답변 주기를 좀 더 명확하게 만들 수 있게 됐다.

온보딩, 진행도, 그리고 가시성

사이트 온보딩이라는 게 생각보다 복잡하다. 신규 사이트를 시스템에 추가하는 순간부터 시작하는데, 각 단계마다 체크해야 할 사항들이 많다. 예를 들면:

• 기본 메타데이터 등록 완료 여부
• 필수 설정값 입력 여부
• 초기 데이터 로드 완료 여부
• 권한 설정 완료 여부

이런 단계들이 병렬로 진행될 수도 있고, 특정 순서를 따라야 할 수도 있다. 문제는 지금까지 이 진행 상황을 "누가 알았나"였다. 개발자는 코드로, 운영자는 경험으로... 결국 각자 다른 정보를 갖고 있었다.

체크리스트 카드의 역할

체크리스트 카드를 UI 컴포넌트로 추가한다는 건 "진행도를 데이터 기반으로 시각화"한다는 뜻이다. 누가 봐도 현재 상태가 명확하다.

이게 단순해 보이지만 팀 커뮤니케이션 비용을 확실히 줄여준다.

_lib/site_onboard.py 에서의 변경

온보딩 로직을 담는 이 파일에 체크리스트 카드 생성 로직을 추가했다. 신규 사이트가 발견되는 순간, 자동으로:

• 진행도 추적용 카드 객체 생성
• 각 온보딩 단계를 개별 체크 항목으로 등록
• 단계별 완료 여부를 속성으로 관리

이렇게 하면 온보딩 프로세스의 매 순간마다 카드 상태를 업데이트하기만 하면 된다. 조회는 자동으로.

같은 맥락의 다른 패턴들

이 작업을 하면서 비슷한 사례들이 떠올랐다:

• 배포 파이프라인의 단계 표시: 빌드 → 테스트 → 스테이징 → 프로덕션, 각 단계의 성공/실패 상태를 카드로
• 데이터 마이그레이션 진행률: "100만 건 중 87만 건 완료" 같은 정보의 시각화
• 권한 승인 플로우: 신청 → 팀장 검토 → 보안팀 검토 → 완료 같은 다단계 승인의 상태 추적

공통점은 "상태를 데이터화하고, 그걸 누구나 읽을 수 있게 만든다"는 것이다. 복잡한 백그라운드 로직이 있어도, 사용자(또는 팀원)는 체크리스트 한 줄로 "아, 지금 여기구나"라고 알 수 있다.

코드 리뷰 관점에서의 고민

이런 기능을 추가할 때 항상 묻는 질문들:

1. 카드 상태가 항상 정확한가? → 온보딩 로직의 여러 지점에서 카드를 업데이트해야 하는데, 빠뜨린 케이스가 없나
2. 카드 생성 타이밍이 맞나? → "신규 사이트 발견"의 정의가 정확한가. 중복 생성은 없나
3. 수정/삭제 경로는? → 온보딩을 취소하거나 재시작할 때 카드는 어떻게 되나

이런 엣지 케이스들을 먼저 팀과 짚어두는 게 나중에 "어, 이 사이트 카드가 왜 이래?"라는 버그 리포트를 줄인다.

마무리

작은 기능이지만, UI 투명성이 팀 협력에 미치는 영향은 생각보다 크다. 온보딩 완료도 카드가 추가되면서 단순히 "진행 상황을 알 수 있다"를 넘어, "누가 다음 액션을 해야 하는지 명확해진다"는 부가 효과도 생긴다. 운영자는 미완료 항목을 보고 담당자에게 자연스럽게 연락할 수 있고, 개발자는 모니터링 부담이 줄어든다.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 사무의자 쿠팡에서 보기 →
• 외장SSD 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.