이름과 생년월일만으로 기록을 합치지 않습니다
기관마다 환자 번호를 부여하는 방식이 다르고 같은 사람도 여러 번호를 가질 수 있습니다. 반대로 비슷한 인적 사항을 가진 서로 다른 사람이 존재할 수 있습니다. 앱 계정과 기관 기록을 연결할 때는 기관이 제공하는 식별·확인 절차를 사용하고 확인되지 않은 후보를 자동으로 합치지 않는 기준을 정해야 합니다.
기관별 식별자와 앱 내부 키를 구분합니다
기관 코드와 원천 환자 번호를 함께 관리하고 앱 내부의 사용자 키와 연결합니다. 연결의 생성 근거·시각·상태를 기록하면 이후 기관 번호 변경이나 계정 병합을 추적할 수 있습니다. API 리소스 ID와 업무 식별자가 같은 의미인지 확인하고, 조회 결과가 없거나 여러 후보가 나오는 경우의 안내와 담당자 검토 절차를 설계합니다.
잘못 연결된 기록의 복구를 검수합니다
테스트 환경에서 잘못된 연결을 해제한 뒤 이미 가져온 기록과 생성한 리포트가 어떻게 처리되는지 확인합니다. 단순히 매핑 행만 지우면 캐시나 공유 자료가 남을 수 있습니다. 영향받은 데이터를 찾아 접근을 제한하고 재처리할 범위를 정하세요. 실제 개인 기록을 사용하기 전에는 가상의 식별자와 표본 데이터로 실패 조건을 먼저 시험합니다.
검수 후 남겨둘 자료
연결 상태표에는 미연결, 확인 대기, 연결 완료와 해제 상태를 두고 각 단계에서 조회 가능한 데이터를 적습니다. 시험 표본에는 같은 이름의 다른 사용자와 한 사용자의 복수 기관 번호를 포함하세요. 기관에서 식별자가 바뀌었을 때 누가 승인하고 기존 기록을 어떻게 추적할지 정하면 계정 관리와 임상 기록 관리가 섞이는 것을 줄일 수 있습니다.
프로젝트에서 확인할 항목
- 기관 코드·원천 식별자·앱 키가 구분되는가
- 후보가 여러 명일 때 자동 병합을 막는가
- 오연결 해제 후 파생 기록까지 처리하는가
참고 자료
자료 확인일: 2026.10.11 · 본문의 적용 예시와 체크리스트는 참고 자료를 바탕으로 정리한 실무 제안입니다.
기술 동작은 아래 공식 문서를 참고했습니다. 적용 조건과 지원 버전은 프로젝트 환경에 맞게 확인하세요.
작성팀 소개
TOPPING 편집팀 · IoT·헬스케어 개발 콘텐츠
공식 기술 문서를 바탕으로 개발 범위, 데이터 연동과 검수 기준을 정리합니다. 글에 제시된 적용 예시는 프로젝트 검토를 위한 제안이며, 특정 고객사의 구축 실적이나 의료적 판단을 의미하지 않습니다.
