운영 개시 체크리스트

프로덕션 시설에 파트너 통합을 활성화하기 전에 이 체크리스트를 사용하십시오.

Partner Console 설정

• 파트너 프로필이 완성되어 있습니다.
• 로고 URL, 웹사이트, 범주, 설명이 정확합니다.
• 데이터 연결 방법(Direct Link 또는 Linking Identifier)이 구성되어 있습니다.
• 하나 이상의 실제 시설에서 시설 연결을 테스트했습니다.
• 올바른 키 유형을 사용하고 있습니다.
  • 데이터를 손상시키지 않는 쓰기 테스트에는 Dryrun.
  • 안전한 데이터 사용에는 Read-only.
  • 프로덕션 데이터에 영향을 줄 준비가 된 경우에만 Live.

인증 및 키 관리

• 비밀 키는 서버 측에만 저장됩니다.
• 키가 클라이언트 측 애플리케이션, 모바일 앱, 공개 저장소 또는 지원 티켓에 포함되어 있지 않습니다.
• 키 교체 및 취소를 테스트했습니다.
• 팀에서 각 환경에 어떤 키가 사용되는지 알고 있습니다.

데이터 유효성 검사

• 호출하는 모든 엔드포인트에 필수 필드가 있습니다.
• 시설 식별자가 구성된 연결 방법과 일치합니다.
• 귀사 시스템의 ID가 안정적이며 동기화 간에 변경되지 않습니다.
• 대규모 가져오기는 문서화된 제한 이내의 배치로 분할됩니다.
• 실패한 배치 항목을 식별하고 다시 보낼 수 있습니다.

엔드포인트 테스트

출시 전에 통합이 의존하는 모든 엔드포인트를 테스트하십시오.

• 조직과 시설을 읽을 수 있습니다.
• 회원을 저장하고 업데이트할 수 있습니다.
• 멤버십 플랜, 출입 구역, 출입 시간이 올바르게 동기화됩니다.
• 체크인이 수락되고 귀사 시스템과 다시 연관시킬 수 있습니다.
• 보고서 스냅샷이 예상한 보고 기간과 지표를 사용합니다.
• 해당하는 경우 Door/Gate Controller 흐름을 실제 하드웨어에서 테스트했습니다.

Access Time Window 준비

통합에서 Access Time Windows를 제공하는 경우:

• 절대 및 주간 예시가 생산자 인증 체크리스트를 통과합니다.
• epoch 값은 따옴표 없는 정수 Unix 초이며, 정확한 [from, to) 경계를 테스트했습니다.
• UTC 기본값, 통합의 사용자 지정 IANA 시간대, 관련 일광 절약 시간 전환을 확인했습니다.
• 지속적이고 단조 증가하는 하나의 회원/원본 리비전 스트림이 증분 업데이트, 조정, 재시도를 조율합니다.
• 운영자가 생략, 전체 교체, 멱등, 충돌, 오래된 데이터, 명시적 [] 동작을 이해하고 있습니다.
• default를 포함한 모든 scope_key에 승인된 Performance Hub 매핑이 있으며, 알 수 없는 키가 거부 방향으로 실패하는지 테스트했습니다.
• 통합의 예상 새로 고침 주기, 최대 원본 경과 시간, 오래된 원본 동작, 알림이 구성되어 있습니다.
• 업스트림 조회 실패 시 빈 스냅샷이나 부분 스냅샷을 보내지 않음이 입증되었습니다.
• 단계별 스트림 수렴, 취소/권한 취소, 물리적 출입문 시작/종료 경계가 합의된 목표를 충족합니다.
• 일반 규칙과 영구 권한이 대체 경로로 작동하는지 확인했으며, 시간 창이 사용자 비활성화, blockAllAccess, 유지 관리 또는 지오펜싱을 우회할 수 없습니다.

출입 통제 준비

출입 통제 통합의 경우:

• Performance Hub를 호출하기 전에 귀사의 시스템에서 출입 여부를 결정합니다.
• 통합이 device_offline, maintenance_mode_active, unlock_confirmation_timeout을 처리합니다.
• 운영자가 제한 시간 초과는 잠금 해제가 확인되지 않았음을 의미한다는 것을 이해하고 있습니다.
• 로그에 반환된 event_id와 command_id가 저장됩니다.
• 시설 직원을 위한 수동 대체 프로세스가 있습니다.

오류 처리 및 재시도

• 400, 401, 403, 404, 409, 422 응답은 무작정 재시도하지 않고 운영자나 지원팀에 표시됩니다.
• 429, 500, 502, 503, 504 응답에는 백오프가 적용된 제한된 재시도 로직을 사용합니다.
• 반복되는 실패는 귀사 시스템에서 알림을 생성합니다.
• 통합은 실패한 레코드를 절대 소리 없이 버리지 않습니다.

관찰 가능성

• 로그에 엔드포인트, 타임스탬프, 시설 식별자, 원본 레코드 ID, 요청 결과, 응답 본문이 포함됩니다.
• 지원팀이 회원 ID, 시설 ID, 체크인 ID 또는 잠금 해제 이벤트 ID로 검색할 수 있습니다.
• 실패한 동기화를 재실행하거나 조정할 방법이 있습니다.

프로덕션 출시

• Performance Hub가 프로덕션 액세스를 확인했습니다.
• 하나 이상의 프로덕션 시설에서 통합을 활성화했습니다.
• 프로덕션 키가 활성 상태입니다.
• 운영 및 기술 담당자 정보가 최신 상태입니다.
• 고객을 위한 지원 프로세스가 문서화되어 있습니다.

이러한 점검이 완료되면 구성된 통합이 핵심 Performance Hub 플랫폼 내의 Performance Hub 파트너 디렉터리에 표시됩니다.