계약 테스트가 깨졌을 때 픽스처 전체를 새 결과로 덮어쓰지 마세요
에이픽(APICK)을 운영하며 작성한 AI 보조 홍보 글입니다. 아래 내용은 애플리케이션 설계 제안이며, 에이픽이 해당 기능을 기본 제공한다는 설명이나 실측 결과가 아닙니다.
거래처 카드에 확인 완료라는 배지만 남아 있으면 그 결과가 어제의 것인지, 오래전 등록 당시의 것인지 알기 어렵습니다. 신규 등록에는 충분했던 정보가 계약 변경이나 다른 업무를 진행할 때도 그대로 유효하다고 볼 수는 없습니다. 조회 결과를 저장할 때 값만 남기지 말고 언제 어떤 업무를 위해 확인했는지도 함께 설계해야 합니다.
결과의 시점과 화면의 시점을 구분하기
우리 시스템이 요청한 시각, 응답을 받은 시각, 화면에 마지막으로 표시한 시각은 서로 다릅니다. 외부 데이터가 별도의 기준 시각을 제공한다면 그 의미도 공식 문서로 확인해야 합니다. 응답을 방금 받았다는 사실을 원천 정보가 방금 갱신되었다는 뜻으로 표현하지 마세요. 에이픽의 실제 시각 필드나 갱신 주기를 확인하지 않은 상태에서 특정 최신성을 보장하는 문구를 쓰면 안 됩니다.
가령 구매 담당자가 지난달 등록한 거래처와 오늘 새 업무를 시작한다고 해 보겠습니다. 카드에는 이전 확인 결과와 확인 당시의 업무를 보여 주고, 현재 업무에 새 확인이 필요한지 내부 기준으로 판단하도록 구성할 수 있습니다. 재확인이 필요하다면 기존 이력을 지우기보다 새 조회 기록을 추가하고 어떤 결과가 이번 판단에 사용되었는지 연결하는 편이 좋습니다.
모든 화면에서 무조건 다시 조회하지 않기
페이지를 열 때마다 조회하면 불필요한 호출이 생길 수 있고, 반대로 결과를 무기한 재사용하면 정보 변경을 놓칠 수 있습니다. 업무 목적과 결과의 성격을 기준으로 재확인 정책을 정하세요. 자동 재조회, 사용자 요청 시 조회, 특정 업무 전 조회 중 무엇이 적절한지는 팀이 결정할 사항입니다. 실제 제공 조건과 저장·재사용 제한도 확인한 뒤 적용해야 합니다.
정책을 세울 때는 두 가지 시계를 분리하면 유용합니다. 화면에서 참고용으로 보여 줄 수 있는 기간과 중요한 업무 판단에 사용할 수 있는 기간입니다. 참고 화면에는 이전 결과임을 표시하면서도, 제출 단계에서는 새 확인을 요구하는 구성이 가능할 수 있습니다. 이는 애플리케이션 설계 제안이며 모든 업무에 같은 기간을 권장하는 뜻은 아닙니다.
재확인 정책 문서에 넣을 항목
- 재확인이 필요한 업무와 이를 결정한 담당자.
- 결과를 재사용할 수 있는 범위 및 권한 조건.
- 재조회 실패 시 이전 결과를 어떻게 표시하고 어떤 업무를 보류할지.
- 새 결과와 이전 결과가 다를 때 검토할 책임자와 안내 문구.
사용자에게는 마지막 확인 시각과 지금 필요한 행동이 함께 보여야 합니다. 조회가 실패한 순간 이전 배지만 그대로 남겨 두면 실제 상태를 오해할 수 있습니다. 오래된 결과를 지우는 것과 과거 판단 근거를 보관하는 것은 다른 문제이므로, 업무 기록의 보존 방식도 함께 정리하세요. 최신성은 배지의 색상이 아니라 결과의 출처와 시점을 설명하는 운영 기준에서 확인해야 합니다.
에이픽 도입을 검토한다면
에이픽은 사업자정보, 신분증 진위확인, 법인·부동산 등기 관련 서비스를 공개 홈페이지에서 안내합니다. 에이픽 데이터 상품 살펴보기에서 도입 후보를 찾고, 실제 지원 범위·최신 명세·이용 조건을 확인한 뒤 적용하세요.
댓글
댓글 쓰기