펜차트 서식 관리¶
이 페이지에서 찾을 수 있는 것
펜차트 서식 PNG 업로드 / 수정 / 삭제 / 순서변경 / 활성화 토글 — 안드로이드 펜차트 앱과 자동 동기화
펜차트(태블릿) 앱에서 환자가 작성하는 동의서·문진표·초진기록지 등의 배경 양식 PNG를 관리하는 페이지입니다. PC 웹에서 업로드하면 다음 펜차트 앱 시작 시 자동으로 새 양식이 다운로드되어 사용 가능합니다.
주소:
/settings/paper-chart-templates
화면 구성¶
| 영역 | 내용 |
|---|---|
| 카테고리 필터 | 초진기록지 / 동의서 / 문진표 / 기타 |
| 비활성 포함 | 비활성화한 서식도 함께 보기 |
| 서식 카드 | 미리보기 / 카테고리 뱃지 / 버전 / 표시 순서 |
| 서식 추가 버튼 | 신규 PNG 업로드 (Level 1-4) |
권한¶
| 권한 | Level 1 (관리자) | Level 2 | Level 3 | Level 4 (실장/직원) | Level 5+ |
|---|---|---|---|---|---|
| 조회 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 업로드 (신규 추가) | ✅ | ✅ | ✅ | ✅ | ❌ |
| 수정 (이름/카테고리/PNG 교체) | ✅ | ✅ | ✅ | ❌ | ❌ |
| 삭제 (soft delete) | ✅ | ✅ | ✅ | ❌ | ❌ |
| 순서변경 / 활성화 토글 | ✅ | ✅ | ✅ | ❌ | ❌ |
서식 추가하기¶
- 서식 추가 버튼 클릭
- 필수 입력
- 서식명: 펜차트 앱 목록에 표시 (예: "다이어트 프로그램 동의서")
- 카테고리: 초진기록지 / 동의서 / 문진표 / 기타 중 1개
- 선택 입력
- 설명: 카드 미리보기에 표시 (예: "이용동의 + 환불규정 + 서명")
- 표시 순서: 같은 카테고리 안에서 작은 숫자가 먼저 노출 (기본 0)
- 아이콘: 안드로이드 Material Icon 이름 (예:
Description,Face,Assignment)
- 서식 PNG 선택 → 최대 5MB, PNG 만 가능
- 권장 해상도: 1080 × 1920 (태블릿 세로 화면 비율)
- PDF는 외부 도구로 PNG 변환 후 업로드 (예: macOS Preview "내보내기 PDF → 이미지")
- 저장
저장 후 다음 펜차트 앱 시작 시 자동으로 동기화됩니다 (앱 재배포 불필요).
서식 수정하기 (오타·디자인 변경)¶
- 카드 우측의 수정 클릭
- 정보 변경 또는 PNG 새로 선택 (선택 시 자동으로 버전 ++)
- 저장
버전 관리 규칙
- 새 PNG 업로드 → 자동으로
v2,v3등 버전 ++. - 이미 펜차트 앱에서 작성 중인 환자는 진입 시점의 구버전 PNG를 그대로 사용 (작성 흐름 중단 ✕)
- 다음 진입부터 신버전 PNG 다운로드
- 구버전 PNG도 서버에 보존 → 작성 중 환자에게 영향 없음
서식 삭제하기¶
- 카드 우측의 삭제 클릭 → soft delete (DB 보존, 비활성화)
- 이미 작성된 환자 기록(
chart_attachments)은 영향받지 않음 - 안드로이드 앱 목록에서 즉시 사라짐
비활성화 (임시 숨김)¶
서식을 삭제하지 않고 일시적으로 안 보이게 하려면 아이콘 클릭.
- 안드로이드 앱 목록에서 숨김
- 다시 클릭하면 재노출
- 비활성 서식 보기: 헤더의 비활성 포함 체크
순서 변경¶
각 카드의 ↑ ↓ 버튼으로 같은 카테고리 안에서 순서 조정. 즉시 안드로이드 앱에 반영.
펜차트 앱 동기화¶
| 동작 | 안드로이드 반영 시점 |
|---|---|
| 신규 추가 | 다음 앱 시작 시 |
| PNG 교체 (버전 ++) | 다음 서식 작성 시작 시점 (작성 중이면 진입 시점 버전 유지) |
| 활성/비활성 토글 | 다음 앱 시작 시 |
| 순서 변경 | 다음 앱 시작 시 |
| 삭제 | 다음 앱 시작 시 |
오프라인 상태(인터넷 끊김)에서는 마지막으로 다운로드한 캐시를 사용해 진료가 계속됩니다. 캐시되지 않은 신규 서식은 인터넷 연결 후 사용 가능.
PNG 가이드라인¶
- 포맷: PNG만 (PDF는 변환 필요)
- 최대 크기: 5MB
- 권장 해상도: 1080 × 1920 (태블릿 세로). 1080 × 1440 / 1500 × 2000 등도 OK
- 배경색: 흰색 또는 옅은 색 권장 (환자가 그 위에 펜 입력)
- 글씨/표 잘림: 미리보기 영역에서 항상 확인
FAQ¶
Q. 슬랙으로 받은 PDF를 어떻게 업로드하나요? PDF → PNG 변환 후 업로드. macOS Preview, Adobe Acrobat, 또는 무료 온라인 변환기 사용.
Q. 오타 수정한 새 PNG를 올렸는데 환자 태블릿에 안 보입니다. 태블릿 앱을 한 번 종료 → 재시작. 작성 중인 환자는 진입 시점 버전 유지가 정상 동작입니다.
Q. 짱한의원/모아만의원 양식을 분리하고 싶어요.
자동으로 분리됩니다. 현재 로그인한 클리닉(VITE_CLINIC_CODE)에 한정해서만 표시/업로드됩니다.
Q. 펜차트 앱이 "업데이트 필요" 메시지를 표시합니다. 시스템 최소 버전 정책. 안드로이드 APK를 최신 버전으로 업데이트하세요. 다운로드 링크는 안내 화면에 표시됩니다.
자동 검증 (정합성)¶
현재 본 페이지에 대한 정합성 봇 검사는 없습니다. 추후 추가 가능:
- "서식 파일이 디스크에 실제 존재하는지" 점검
- "각 클리닉이 카테고리별 최소 1종 이상 보유"
수정이력¶
| 일자 | 변경 내용 | WI |
|---|---|---|
| 2026-05-18 | WI#95: 안드로이드 enum → DB 동적 관리 전환, 클리닉별 분리, 버전 관리 도입 | #95 |