검사·설문을 등록하고 환자에게 전달하기

검사·설문을 만들기 전에 결과를 어떻게 쓸지 정하기

환자에게 증상이나 생활 상태를 물어보고 결과 화면까지 제공하려면 검사 라이브러리를 사용합니다. 질문부터 만들기 전에 누구에게 보낼지, 결과를 누가 확인할지, 답변을 진료에서 어떻게 다시 확인할지 먼저 정하세요.

이 기능은 홈페이지의 기본 문의·접수(/intake)와 다릅니다. 기본 문의·접수는 이름과 연락처를 받아 문의/리드를 만드는 흐름이고, 검사 라이브러리는 환자별 설문이나 점수형 결과를 제공하는 흐름입니다.

어떤 방식을 쓸지 먼저 고르세요

검사를 신규 고객 유입 도구로 공개하는 일과 기존 환자에게 보내는 일은 개인정보와 결과 확인 방식이 다릅니다. 하나의 링크를 두 용도로 섞어 쓰지 마세요.

에이전트에게 이렇게 요청하세요

"수면 상태를 확인하는 환자용 설문을 만들고 싶어.
누가 언제 사용할지부터 질문하고, 문항과 점수 구간의 근거를 확인해줘.
ClinicOS 검사 파일로 등록 가능한지 판단한 뒤 시험 환자로 제출과 결과 화면까지 검수해줘."

"이 설문을 공개용으로 쓸 수 있는지 먼저 검토해줘.
이름과 연락처는 받지 않고, 진단처럼 보이는 결과 문구는 피하고 싶어.
현재 관리자에서 결과를 다시 찾는 경로가 있는지도 확인해서 빈 부분을 보고해줘."

에이전트에게 문항 생성만 맡기지 마세요. 질문의 목적, 답변 형식, 점수 계산, 결과 문구, 공개 범위와 실제 제출 결과까지 한 작업으로 검수하도록 요청하는 편이 안전합니다.

1. 검사 파일을 만들기 전에 정할 것

• 대상: 공개 방문자, 초진 환자, 기존 환자 중 누구인가
• 목적: 사전 확인, 경과 확인, 환자 교육 중 무엇인가
• 답변 활용: 누가 언제 보고 어떤 후속 질문을 할 것인가
• 수집 범위: 이름이나 연락처 없이도 목적을 달성할 수 있는가
• 결과 표현: 진단·위험 확정·치료 권고로 오해할 문구가 없는가
• 갱신 책임: 문항과 점수 기준을 누가 검토하고 언제 다시 볼 것인가

공개 자가진단이라면 검사 자체로 도움이 되어야 합니다. 결과를 보기 위해 연락처를 강제로 받거나, 높은 점수를 곧바로 특정 질환으로 단정하는 방식은 피하세요.

2. JSON 검사 파일 등록하기

JSON은 검사명, 설명, 질문, 선택지와 결과 구간을 정해진 형식으로 적은 파일입니다.

1. 관리자에서 모든 기능 > 검사 라이브러리로 이동합니다.
2. 새 검사 등록을 누릅니다.
3. AI로 검사 만드는 법 보기에서 현재 파일 형식을 확인합니다.
4. 질문과 결과 문구를 검토한 JSON 파일을 선택합니다.
5. 화면의 파일 미리보기에서 검사 ID, 제목과 질문이 맞는지 확인합니다.
6. 검사 등록하기를 누릅니다.
7. 검사 라이브러리에서 검사명, 설명, 연동 프로그램, 태그와 공개 여부를 확인합니다.

현재 파일 등록 화면은 짧은 글, 긴 글, 단일 선택, 복수 선택과 점수 척도 질문을 처리합니다. 점수 계산은 현재 안내 형식상 숫자 답변을 더하는 방식이 기본입니다. 검증되지 않은 임상 척도나 임의로 바꾼 절단값을 그대로 사용하지 마세요.

3. 등록 뒤 수정할 수 있는 범위

데이터베이스에 등록한 검사는 목록의 수정에서 다음 정보를 바꿀 수 있습니다.

• 검사명과 설명
• 연동 프로그램
• URL 경로
• 태그
• 공개 여부

질문, 선택지, 점수 구간과 결과 문구를 화면에서 직접 고치는 기능은 현재 없습니다. 이 항목을 바꿔야 한다면 기존 검사에 즉시 덮어쓰지 말고, 새 버전의 검사 파일을 만들어 시험한 뒤 교체하세요. 이미 배포한 URL 경로를 바꾸면 기존 링크가 열리지 않을 수 있습니다.

시스템 기본 검사와 플러그인 검사도구는 같은 목록에 보여도 이 화면에서 수정할 수 없습니다.

4. 특정 환자에게 보내기

1. 관리자 환자 관리에서 대상 환자를 엽니다.
2. 설문/검사 관리 > 새 설문 시작하기를 선택합니다.
3. 개별 검사에서 등록한 검사를 찾습니다.
4. 문자 발송, 링크 복사, QR 보기, 바로 열기 중 상황에 맞는 방법을 고릅니다.
5. 환자 이름과 검사 종류가 맞는지 다시 확인합니다.

환자별 링크는 다른 환자에게 재사용하지 마세요. 링크에는 유효 시간이 있으므로 오래된 문자를 다시 보내기보다 새 링크를 생성하는 편이 낫습니다.

5. 공개용 QR을 쓰기 전에 확인하기

검사를 공개로 설정하면 검사 라이브러리에서 익명용 QR을 만들 수 있습니다. 게시 전에는 실제 휴대전화로 QR을 읽고 다음을 확인하세요.

• 로그인하지 않아도 첫 화면이 열리는가
• 검사 목적과 한계가 첫 화면에 보이는가
• 문항을 끝까지 제출할 수 있는가
• 결과가 진단이나 치료 보장처럼 읽히지 않는가
• 문의 버튼이 있더라도 연락처 제출을 강제하지 않는가
• 결과를 운영자가 어디서 다시 확인할지 정해져 있는가

현재 동적 JSON 검사의 결과는 제출 직후 결과 페이지에 표시되지만, 관리자에 모든 결과를 모아 보는 전용 목록은 확인되지 않습니다. 환자 상세의 기존 설문 목록도 동적 검사 결과 저장소와 완전히 같지 않습니다. 일상 진료에 쓰기 전에는 해당 검사 결과를 직원이 다시 찾을 수 있는지 반드시 시험하고, 확인 경로가 없다면 운영용으로 확정하지 마세요.

현재 지원하는 것과 빈 부분

통합 결과 목록, 검토 상태, 담당자 배정과 임계점 알림이 필요한 경우에는 먼저 기능 보강 범위를 정해야 합니다. 가이드 문구로 이미 되는 기능처럼 약속하지 마세요.

발행 전 완료 확인

• 검사 목적과 대상이 한 문장으로 설명된다.
• 모든 질문이 실제 후속 판단에 쓰인다.
• 점수 계산과 결과 구간의 근거를 확인했다.
• 개인정보를 필요한 만큼만 받는다.
• 시험 환자 링크와 공개 익명 링크를 구분했다.
• 모바일에서 제출과 결과 화면을 확인했다.
• 운영자가 결과를 다시 찾는 경로를 확인했다.
• 이전 버전 링크를 어떻게 처리할지 정했다.

이 페이지의 요약

• 기본 문의·접수와 검사·설문은 목적과 저장 흐름이 다릅니다.
• JSON 검사는 질문뿐 아니라 대상, 점수 근거, 결과 문구와 확인 담당자를 먼저 정합니다.
• 등록 뒤 화면에서 고칠 수 있는 것은 기본 정보이며, 문항과 채점 수정은 새 버전 검수가 필요합니다.
• 환자별 링크는 재사용하지 않고, 공개 QR은 개인정보와 결과 문구를 별도로 점검합니다.
• 결과를 관리자에서 다시 찾는 경로가 확인되지 않으면 운영용 검사로 확정하지 않습니다.

관련 가이드

• 온라인 문의·접수를 열고 실제 접수까지 확인하기
• 환자 정보를 찾고 활동 이력을 확인하기
• 문자 알림 설정하기
• 확장형 검사도구 만들기