콘텐츠로 이동

펜차트 서식 관리

이 페이지에서 찾을 수 있는 것

펜차트 서식 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. 서식 추가 버튼 클릭
  2. 필수 입력
    • 서식명: 펜차트 앱 목록에 표시 (예: "다이어트 프로그램 동의서")
    • 카테고리: 초진기록지 / 동의서 / 문진표 / 기타 중 1개
  3. 선택 입력
    • 설명: 카드 미리보기에 표시 (예: "이용동의 + 환불규정 + 서명")
    • 표시 순서: 같은 카테고리 안에서 작은 숫자가 먼저 노출 (기본 0)
    • 아이콘: 안드로이드 Material Icon 이름 (예: Description, Face, Assignment)
  4. 서식 PNG 선택 → 최대 5MB, PNG 만 가능
    • 권장 해상도: 1080 × 1920 (태블릿 세로 화면 비율)
    • PDF는 외부 도구로 PNG 변환 후 업로드 (예: macOS Preview "내보내기 PDF → 이미지")
  5. 저장

저장 후 다음 펜차트 앱 시작 시 자동으로 동기화됩니다 (앱 재배포 불필요).


서식 수정하기 (오타·디자인 변경)

  1. 카드 우측의 수정 클릭
  2. 정보 변경 또는 PNG 새로 선택 (선택 시 자동으로 버전 ++)
  3. 저장

버전 관리 규칙

  • 새 PNG 업로드 → 자동으로 v2, v3 등 버전 ++.
  • 이미 펜차트 앱에서 작성 중인 환자는 진입 시점의 구버전 PNG를 그대로 사용 (작성 흐름 중단 ✕)
  • 다음 진입부터 신버전 PNG 다운로드
  • 구버전 PNG도 서버에 보존 → 작성 중 환자에게 영향 없음

서식 삭제하기

  1. 카드 우측의 삭제 클릭 → soft delete (DB 보존, 비활성화)
  2. 이미 작성된 환자 기록(chart_attachments)은 영향받지 않음
  3. 안드로이드 앱 목록에서 즉시 사라짐

비활성화 (임시 숨김)

서식을 삭제하지 않고 일시적으로 안 보이게 하려면 아이콘 클릭.

  • 안드로이드 앱 목록에서 숨김
  • 다시 클릭하면 재노출
  • 비활성 서식 보기: 헤더의 비활성 포함 체크

순서 변경

각 카드의 버튼으로 같은 카테고리 안에서 순서 조정. 즉시 안드로이드 앱에 반영.


펜차트 앱 동기화

동작 안드로이드 반영 시점
신규 추가 다음 앱 시작 시
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