WorkSafeBC 지향 워크플로우, overclaims 없이: 구조화된 요약, 신중한 언어
Source: Dev.to
목표: 구조화된 컨텍스트, 증명 아님
업무 관련 부상 워크플로에서는 사람들은 다음 두 가지를 모두 만족하는 것이 필요합니다:
- 임상의나 케이스 매니저가 스캔하기에 일관성이 있는 것
- 경험을 재작성한 느낌이 들지 않을 정도로 근거가 있는 것
특히 스타트업에서는 다음과 같이 과장하기 쉬운데:
- “임상 검증됨”
- “규정 준수”
- “공식 양식 채움”
코드가 이를 수행하지 못한다면, 그렇게 말하지 마세요.
Pain Tracker의 접근 방식은 보다 방어 가능합니다:
- 구조화된 요약을 자체 보고 데이터에서 생성
- 명시적 면책 조항 포함
- 워크플로를 로컬‑우선 및 사용자 제어 방식으로 유지
WorkSafeBC 내보내기 (로컬 PDF 생성기)
구현은 레포지토리 아래에 있습니다:
src/utils/pain-tracker/wcb-export.ts- 테스트 스위트:
src/utils/pain-tracker/wcb-export.test.ts
동적 import를 통해 jsPDF를 사용해 PDF를 data: URI 문자열로 만든 뒤 다운로드를 트리거합니다. 이는 Part 6에서 제시한 “내보내기 = 로컬 파일 생성” 원칙과 일관된 경계 설정을 유지합니다.
보고서의 신중한 문구
Pain Tracker는 청구와 무관한 내용을 PDF 출력에 직접 삽입합니다. 보고서에는 다음과 같은 명시적 면책 조항이 포함됩니다 (생성기에서 그대로 가져옴):
Disclaimer: This report is a structured summary of self‑reported pain data for WorkSafe BC reference only. It does not constitute medical advice, diagnosis, or treatment. This document should be reviewed with a qualified healthcare provider. Pain Tracker Pro is not affiliated with WorkSafe BC.
이 면책 조항은 마케팅이 아니라 경계를 정의합니다:
- 보고서가 무엇인지 – 구조화된 요약
- 보고서가 아닌 것 – 의료 조언, 진단, 법적 판단이 아님
- 누가 해석해야 하는지 – 자격을 갖춘 의료 제공자
실제 코드가 구현하는 보고서 내용
생성기는 다음을 입력받습니다:
PainEntry레코드 리스트- 날짜 범위 (
startDate,endDate) - 선택적 식별 필드 (환자 이름, 청구 번호, 제공자)
그리고 다음을 출력합니다:
- 요약 메트릭 (최소 / 최대 / 평균, 변동성)
- 흔한 부위 / 증상 목록
- 업무 영향 및 치료 요약
- 선택적 “상세 항목” (노트가 있을 경우 포함)
자체 보고된 메모를 “전문가용” 문서 형태로 내보내는 만큼, 신중한 언어 사용이 중요합니다. 출력은 다음과 같은 위치에 머물러야 합니다:
- 구조화된 요약
- 진단이 아님
- 법적 판단이 아님
사람을 존중하는 워크플로 프레이밍
가장 건강한 프레이밍은 다음 단계로 구성됩니다:
- 캡처 – 작고 반복 가능한 항목 기록
- 요약 – 인간이 읽기 쉬운 형태로 집계
- 내보내기 – 사용자가 제어하는 경계
이 세 단계 외에 (자동 제출, 백그라운드 공유, “보험사에 전송”)와 같은 작업을 추가하면 새로운 신뢰 경계와 위험이 발생합니다:
- 네트워크 노출
- 계정/신원 관리
- 동의 UX
- 감사 로그
Pain Tracker의 로컬‑우선 입장은 의도적으로 위 세 단계에 범위를 제한합니다.
다음 내용
Part 8에서는 감시 없는 분석을 다룹니다: 환경 플래그와 명시적 동의를 통해 외부 분석을 차단하고, GA4 이벤트 파라미터에서 Class A 필드를 피하는 방법.
이 작업 지원하기
- 프로젝트 후원:
- 레포지토리 스타: