가이드북

테마

검토한 제품 정식 등록 ​

파일 준비를 마쳐 초안 ID가 있다면, 원래 조직 소유자가 제품·공개 범위·정책을 검토하고 웹에서 승인한 뒤 정식 등록을 진행합니다. 이 문서는 프로그램 담당자가 검토 링크를 만들고 실행 결과를 확인하는 순서입니다.

지원 대상은 단일 PartType Information 초안입니다. 기존 제품 변경·BOM·PCF·QN·CCM은 별도 업무로 진행합니다. 연결이 허용된 개발 환경과 준비된 서버 실행 설정이 필요합니다. 설정이 없으면 검토 화면에서 승인할 수 없습니다.

단계필요한 권한확인할 결과
준비 상태·정책 확인, 검토 생성data:updates실제 초안·정책·digest·검토 링크
웹 검토와 승인원래 조직 소유자의 정상 웹 로그인고정 내용에 대한 승인
조회·지정 단계 실행원래 연결의 products:register현재 영수증·nextStepKey·최종 게시 상태

준비와 사람 승인 ​

등록 검토를 만들기 전에 프로그램의 고정된 요청 허용 목록과 이번 연결의 동의에 data:updates, products:register가 모두 있는지 확인합니다. 초안부터 정식 등록까지 따라 할 프로그램은 처음 등록할 때 6개 기능을 선택합니다. 허용 목록이 부족하면 새 프로그램을 등록하고 클라이언트 ID를 교체해 로그인합니다. 기존 client/grant에 묶인 등록 검토·승인은 새 연결에서 재사용하지 말고 새 검토를 준비합니다.

  1. 현재 초안의 요구사항과 정책 후보를 infirium_get_draft_readiness로 확인합니다. 정책을 추측하거나 자동 선택하지 않습니다.
  2. data:updates로 infirium_create_registration_review_plan을 호출합니다. 실제 초안 UUID, 안정적인 idempotencyKey, 사용자가 선택한 정책 ID를 사용합니다.
  3. 반환된 humanReviewPath를 Infirium 웹에서 엽니다. 원래 요청한 조직 소유자로 로그인하고 제품 정보·공개 검색 범위·실제 선택 정책·제공자 주소를 확인합니다.
  4. 제품·정책·제공자 정보를 읽고 웹 화면에서 승인합니다. 승인 요청은 검토한 decision digest와 wire digest를 모두 확인합니다. AI bearer token으로 사람 승인 API를 호출할 수 없습니다.

등록 실행에는 원래 연결의 products:register 동의도 필요합니다. data:updates만 가진 연결은 검토를 저장할 수 있으나 정식 등록을 실행할 수 없습니다. 다른 AI 연결에 검토 ID를 전달해 실행 권한을 옮길 수 없습니다.

실행·이어 진행하기 ​

infirium_get_registration에 {"reviewId":"반환된 검토 UUID"}를 전달하면 현재 작업과 nextStepKey를 확인합니다. 조회는 외부 작업을 실행하지 않습니다.

json
{
    "name": "infirium_execute_registration",
    "arguments": {
        "reviewId": "실제 반환된 검토 UUID",
        "stepKey": "nextStepKey에 반환된 정확한 값"
    }
}

한 호출은 검토한 제공자 단계 하나까지만 실행합니다. continuationAvailable과 nextStepKey를 확인해 다음 단계를 명시적으로 호출합니다. 같은 stepKey의 재호출이 다음 단계를 대신 실행하지 않습니다. 실행 상태가 원격 단계 완료인지, 최종 제품이 공개됐는지 구분하고 반환된 productId·assetId를 확인합니다.

소스·정책·자격 증명·권한이 바뀌면 기존 승인을 그대로 실행하지 않습니다. needs_reconciliation이면 결과를 확인하지 못한 외부 효과가 있을 수 있으므로 새 키·새 검토로 다시 보내지 않습니다. 운영자가 원래 작업을 확인해야 합니다. 웹에서 승인을 회수해도 이미 발생한 외부 효과가 자동으로 되돌아가지는 않습니다.

사람 검토 화면은 자동 재시도하지 않습니다. 통신 오류가 나면 현재 검토와 작업 상태를 다시 조회하고 같은 식별자를 유지합니다.

불확실한 DTR 수락 확인 ​

조직 소유자는 AI 연결 설정 아래 실행 복구 조사 화면(/setting/program-access/recovery)에서 원래 등록 job과 dtr_shell을 선택할 수 있습니다. 먼저 과거 접수 기록과 현재 권한을 구분해 확인합니다. 원래 요청한 소유자의 승인·프로그램 연결·자료·정책·실행 설정이 여전히 유효해야 별도 수락 확인이 가능합니다.

정상 웹 인증을 사용하는 소유자 SDK 명령은 다음과 같습니다. AI bearer로 사람 권한을 대신하지 않습니다.

ts
await registrationApi.reconcile(reviewId, { stepKey: "dtr_shell" });
// POST /api/program-registration/reviews/:id/reconcile

이 명령은 제공자에 원래 고정 ID의 GET 한 번만 보냅니다. 등록 POST를 다시 보내거나 다음 단계·제품 게시를 실행하지 않습니다. URL·remote ID·영수증·승인을 호출자가 주입할 수 없습니다. MCP 조회 도구와 운영 인수 metadata API도 기존 조회 의미를 유지합니다.

서버는 5초·1 MiB·redirect 불허 조건으로 원래 요청의 ID와 본문 전체를 대조합니다. 수락에는 현재 권한과 원래 시도·고정 요청의 재검증도 필요합니다. 결과의 observation: "matched"는 DTR 영수증이 반영됐다는 의미이며, 최종 게시나 계약 완료가 아닙니다. 다음 단계는 execution.nextStepKey를 확인해 별도 명시적으로 실행합니다.

404·timeout·본문 불일치이면 unconfirmed이며 미확정 기록을 보존합니다. 제공자가 추가한 createdAt이나 배열 순서 차이도 임의로 제거하지 않습니다. 중계 경로가 정리한 응답·식별자 일부의 일치·운영자의 조사 메모는 원래 본문 전체 일치 영수증을 대신하지 않습니다. 회수·만료된 원래 연결을 되살리거나 새 검토로 우회하지 않습니다.

내부 전용 제공자 주소에 외부 네트워크에서 접속했을 때의 HTML 404는 네트워크 진입 제한일 수 있습니다. 허용된 인증 API 경로로 조사하며 원격 존재와 정상 영수증 반영을 구분합니다.

등록이 최종 게시됐으면 반환된 productId·assetId를 보관하고 권한 있는 조회로 확인합니다. 여러 제품은 각각 승인한 검토의 배치, 공통 오류와 재시도는 오류·제한을 참고하세요.

등록 뒤 제조 정보 변경 ​

승인 기반으로 게시한 자사 PTI는 게시한 제품 변경으로 새 불변 버전을 발행합니다. 초안 수정 도구를 정식 제품에 사용하지 않습니다.

이 안내서는 현재 저장소에 구현된 화면을 기준으로 작성합니다.