온마음

README

온마음 (ONMAUM)

콜센터 등 감정노동자가 웹캠 표정으로 자기 마음 상태를 기록하는, 프라이버시 우선 웹앱입니다.

서버·계정 없이 브라우저에서만 동작하며, 기록은 기기 안(IndexedDB·localStorage)에만 남습니다. 의료 진단이 아니라 자기 인식을 돕는 도구입니다.

방향

자세한 방향은 docs/roadmap.md에 있습니다. 1학기 정리: docs/2026-1학기-정리.md

카메라 기반 인식 고도화 — DeepMedi류 rPPG/심박 참고, 웹캠 신호 안정화
Electron — 브라우저 PWA 대신 PC 앱, 백그라운드(숨김 창)에서도 측정 가능
서버 연동 · 관리자 페이지 — 옵트인 · 로컬 우선. 원본은 기기 유지, 서버에는 동의한 하루 단위 요약만. 기본은 팀 익명 집계, 개인별 열람은 본인이 「케어 담당과 공유」를 켠 경우만
UI 변경 — 세부 톤은 추후 확정
감정 분석 알고리즘 체계화 — 규칙·임계값·단계(로컬 점수 → 필요할 때만 AI)를 문서/코드로 고정
피드백 — 기본 AI 조언 사용하되, 스트레스 지수를 의사처럼 단정하지 말 것. “컨디션 신호 / 참고용” 프레임. 의료·진단 뉘앙스 금지.

왜 만들었나

감정노동자는 업무 중 표정을 관리하기 때문에, 본인도 자신의 부담을 놓치기 쉽습니다. 온마음은 본인만 보는 기록으로 “오늘은 평소보다 얼마나 힘들었는지”를 보여 주는 게 목표입니다. 데이터는 서버로 올리지 않고, 회사 대시보드용 모니터링이 아닙니다. 의료기기가 아닙니다.

하는 일

통화나 업무 중 전면 카메라로 표정을 읽고, 4가지 감정(기쁨·평온·슬픔·화남) 분포를 1분 단위로 모읍니다. 하루 동안의 긍정 지수와 스트레스 지수를 보여 주고, 최근 14일 개인 기준선과 비교한 “평소 대비” 상태를 표시합니다. 푸터에 상담 전화(1577-0199, 1393)를 둡니다.

측정은 전화 시작을 누른 동안에만 돌아갑니다. 탭을 내리거나 백그라운드로 두면 브라우저 제약으로 측정이 느려지거나 멈출 수 있습니다.

화면별 요약

경로	하는 일
`/`	소개 랜딩, 첫 측정 전 4단계 설문
`/measure`	웹캠 측정, 실시간 오브·감정 막대, 전화 시작/종료
`/stats`	오늘 리포트 — 긍정/스트레스 2축, 기준선, 차트
`/demo`, `/orb-preview`	개발·미리보기용 (일반 사용 경로 아님)

주요 기능 (현재)

측정 — 웹캠 표정 분석, 1분 자동 저장
오늘 리포트 — 긍정/스트레스 2축, 14일 개인 기준선
체크인 보정 — 오전·오후 자기보고로 스트레스 표시를 소폭 조정
옵트인 넛지 — 기본 꺼짐. 권한 허용 시 인앱 배너·브라우저 알림
Document PiP 오브 — Chrome/Edge 등 지원 시 작은 오브 창 (분석 루프는 원래 탭에 남음)
PWA — 홈 화면 설치, public/models/에서 얼굴 인식 모델 서빙
상담 전화 안내 — 1577-0199, 1393

실행 방법

npm install
npm run dev          # http://localhost:3000
npm run test:run     # 단발 테스트
npm run build && npm start

환경 변수는 없습니다. 카메라는 HTTPS(또는 localhost)와 권한 허용이 필요합니다. 얼굴 인식 가중치는 public/models/에서 서빙되며 합계는 약 6.5MB입니다.

테스트 (최근 확인 기준): 파일 30개, 139 passed / 4 skipped. 레코더 통합 테스트 일부는 아직 skip입니다.

배포 예: https://onmaum.vercel.app (Vercel). 별도 서버·API 키 없음.

기술 스택

구분	내용
앱	Next.js 16 (App Router), React 19, TypeScript
UI	Tailwind CSS v4, Pretendard
얼굴 인식	face-api.js (SSD MobileNet + Landmark 68 + Expression)
저장	Dexie (IndexedDB), localStorage (프로필·설정)
차트	Recharts
테스트	Vitest, happy-dom, fake-indexeddb

폴더 구조 요약

app/            라우트 — /, /measure, /stats, /demo, /orb-preview
components/     랜딩·카메라·오브·통계·푸터 등 화면
hooks/          감정 루프, 체크인, 넛지, PiP
lib/            감정 분석·집계, Dexie, 기준선·보정·제안
public/         PWA(manifest, sw.js), face-api 모델
tests/          Vitest
docs/           설계 스펙·구현 계획 (참고용)

데이터 흐름: CameraView → useEmotionRecorder(약 0.5초 분석) → 1분 aggregate → Dexie emotions → /stats에서 스트레스·기준선·보정 후 리포트.

설계 세부(알고리즘, Electron 창 구조 등)는 docs/를 보세요. README는 “무엇이 실제로 돌아가는지”만 적습니다.

한계와 주의

의료기기가 아닙니다. 진단·치료 목적이 아니며, 자기 인식 보조에 가깝습니다. 도움이 필요하면 정신건강위기상담전화 1577-0199, 자살예방상담전화 1393(24시간)을 이용해 주세요.
표정만으로 마음 상태를 추정합니다. 조명, 각도, 말하기, 미검출 구간에 따라 값이 흔들릴 수 있습니다. 감정노동자가 업무 중 표정을 관리하면 부담이 과소평가될 수 있습니다.
기록은 암호화·잠금 없이 브라우저 저장소에만 있습니다. 공용 PC에서는 OS 계정 분리가 사실상 경계입니다.
백그라운드·다른 탭에서는 측정이 보장되지 않습니다. PiP는 오브만 띄우고, 분석 루프는 원래 탭에 남습니다.

로드맵 (계획 · 미구현)

아직 코드에 없거나 방향만 정한 항목입니다. 기대한 기능처럼 쓰지 마세요.

다음에 손댈 순서

통화 단위 기록 (확정) — “전화 시작~종료”를 한 세션으로 묶어 통화별 요약·당일 피로 시작 시점 표시
Electron 숨김 측정 실험 (선행) — Windows에서 창을 내려도 카메라 측정이 이어지는지 확인. 실패하면 PC 전환 전제를 다시 검토
UI 선택 — 통화 후 체크인 시트 + 통화 카드 타임라인을 기본으로, 오브/가장자리 빛/트레이는 선택 모드로 검토

그다음 검토

Electron PC 프로그램 · 항상 위 오브 (방향) — 웹 PWA 대신 Windows 우선 데스크톱
바우처 안내 (계획) — 정신건강 심리상담 바우처사업 등 공식 안내·링크
카메라 심박(rPPG) (참고용 추세) — 제품 핵심이 아니라 참고용. 통화 중 HRV는 신뢰도 낮음
음성 (계획) — 개인용은 본인 운율만, 회사 도입 시에만 고객 음성·STT 확장 검토