PROCEDURE HUB · INTERNAL GUIDE
지식을 연결하는 공간,
Procedure Hub¶
시술·제품·안전·근거 정보를 연결해 탐색하고, 다른 서비스에서도 활용하도록 제공하는 내부 지식 서비스입니다.
기획자와 개발자가 같은 맥락에서 서비스 기능, 데이터 관리 방식, 시스템과 운영 구조를 이해하도록 구성한 매뉴얼입니다. 앞에서부터 읽거나 왼쪽 목차와 검색으로 필요한 내용을 찾을 수 있습니다.
2026-09-07 · v1.2.0 개발 기준. 환경별 배포 상태는 배포·복원에서 확인합니다.
누구를 위한 서비스인가요?¶
| 담당자 | 활용 방식 |
|---|---|
| 기획자·운영 담당자 | 보유 정보와 연결 관계를 확인해 상담·비교·검색 기능을 기획하고 번역 자료를 관리 |
| 의료 전문가·콘텐츠 검토자 | 시술·제품·안전·문헌 자료와 출처·검토 상태 확인 |
| 개발자 | 화면·API·업무 규칙을 개발하고 CHARTY·Linky 등 소비 서비스에 지식 제공 |
현재 중심 기능은 지식 조회와 참고 자료 제공입니다. 환자별 진료기록·예약·결제·동의서 서명 업무는 제공 범위에 포함되지 않습니다.
무엇을 할 수 있나요?¶
| 영역 | 화면 | 주요 용도 |
|---|---|---|
| 탐색 | 분류 체계 · 추천 · 시술 비교 | 고민과 목적에 맞는 시술 후보를 찾고 비교 |
| 안전 | 해부학 위험지대 · 합병증 · 병행·간격 · PIH 리스크 | 부위·시술·조합별 등록된 주의 사항 확인 |
| 상담·동의 | 필수 고지 · 사전 체크 · 환자 가이드 | 시술 전 확인 사항과 환자 설명 자료 조회 |
| 조합·경과 | 시너지 · 조합 플래너 · 시술 순서 · 치료 계획 참고 · 경과 타임라인 | 조합·순서와 예상 경과·관리 자료 확인 |
| 자료 | 제품 · 가격 · 문헌 근거 · 통합 지식 검색 · 통역 사전 | 제품 비교, 가격·출처 조회, 게시 지식 검색과 번역 관리 |
처음에는 후보 탐색 → 비교·조합 → 안전·상담 자료 → 근거 확인 순서로 둘러보세요. 화면을 함께 활용하는 탐색 예시이며 전체가 하나의 자동화된 업무 흐름은 아닙니다. 구체적인 이용 순서는 화면 사용법에 담았습니다.
데이터 관리의 핵심¶
시술·고민·제품을 기준으로 추천·조합, 안전·상담·회복, 문헌 근거와 번역을 연결합니다. 현재는 다음 세 가지 관리 경로를 구분해야 합니다.
| 구분 | 제공·관리 방식 |
|---|---|
| 일반 조회 | 기존 관계형 데이터와 스냅샷을 화면·분야별 API로 제공 |
| 게시 지식 검색 | 검토·게시된 공통 지식 모델(Canonical)에서 관련 항목·출처·안전 정보·버전을 반환 |
| 통역 사전 | 화면에서 파일 업로드·미리보기·적용·버전 확인·복원 |
일반 화면에 보이는 정보와 검수·게시된 검색 데이터는 같지 않을 수 있습니다. 조회에 성공했다는 사실만으로 임상 검토 완료를 판단하지 않습니다.
지식 게시 흐름은 변경 버전 준비 → 검토·승인 → 릴리스 구성·게시 → 검색에 제공입니다. 개별 변경 버전은 revision, 함께 게시하는 묶음은 release라고 부릅니다. Canonical 검토·게시·복원은 현재 Backend 운영 명령(CLI)으로 수행합니다. 모든 지식을 화면에서 편집·승인하는 통합 관리 UI는 아직 없습니다.
어떻게 연결되나요?¶
브라우저 요청은 Frontend의 화면 전용 서버 API(BFF)를 거쳐 Backend로 전달됩니다. 외부 서비스의 Backend는 Gateway를 통해 API를 호출합니다. 자세한 책임과 데이터 흐름은 시스템 구성에서 이어집니다.
필요한 장으로 이동하기¶
- 화면을 사용하려면: 화면 사용법 → FAQ
- 기획·데이터를 이해하려면: 데이터 모델 → 화면 디자인 기준
- 서비스에 연동하려면: API 계약 → 검색 API 사용법
- 개발·운영하려면: Frontend 실행 · Backend 실행 → 배포·복원
- 설계 배경과 미완료 조건을 확인하려면: 목차의 ‘검토와 설계 기록’
구조 문서의 목표 설계와 실제 구현을 구분해서 읽습니다. 검토 기록은 작성 시점의 근거이며, 과거 상태를 현재 승인 완료로 해석하지 않습니다.