Health-Lite Module MVP

Last updated: 2026-04-12

목적: Membloc의 health-lite 모듈 MVP 범위를 고정한다. 이 문서는 병원 일정, 복약 체크, 검사 일정, 보호자 공유에 집중한 최소 제품 정의다.

---

1. 왜 지금 필요한가

가족 서비스에서 건강 주제는 사용 빈도는 낮아 보여도, 실제로는 다음 이유로 핵심 모듈이 된다.

• 부모님 병원 일정 관리 수요가 분명하다
• 약 복용 체크는 반복성이 높다
• 가족 구성원이 서로 대신 챙겨줘야 하는 정보가 많다
• 병원/검사/약 정보는 메신저에서 금방 묻힌다

즉, health-lite는 “가족이 서로를 챙기는 운영 모듈”이다.

---

2. MVP 범위

이번 MVP는 아래 4가지만 다룬다.

1. 병원 일정
2. 복약 체크
3. 검사 일정
4. 보호자 공유

이번 MVP에서 하지 않는 것:

• 건강검진 결과 PDF/이미지 보관
• 증상 추적 다이어리
• 운동 기록 상세
• 병원/약국 추천 커뮤니티
• 보험 청구 연계
• 처방전 OCR

---

3. 핵심 사용자 스토리

US-1. 부모님 병원 일정 공유

• 엄마가 아빠 병원 예약을 등록한다
• 가족 모두가 날짜와 병원명을 본다
• 진료가 끝났는지 체크할 수 있다

US-2. 약 복용 체크

• 복용 중인 약을 등록한다
• 오늘 먹었는지 체크한다
• 다른 가족이 대신 확인할 수 있다

US-3. 검사 일정 잊지 않기

• 건강검진, 혈액검사, 치과 검진 일정을 넣는다
• 다가오면 홈/피드에서 보인다

US-4. 보호자 지정

• 특정 건강 항목은 담당 보호자를 둔다
• 홈 카드와 상세에서 누가 챙기는지 보인다

---

4. 도메인 구조

MVP에서는 2개 엔티티만 둔다.

4.1 HealthSchedule

병원/검사/접종 같은 일정형 건강 항목

저장 위치:

families/{groupId}/module_instances/{healthScheduleId}

주요 필드:

• templateKey: 'health'
• moduleKey: 'health'
• entityType: 'health_schedule'
• title
• scheduleType: 'hospital' | 'checkup' | 'vaccination' | 'other'
• targetMemberId
• caregiverId
• place
• scheduledAt
• status: 'scheduled' | 'done' | 'cancelled'
• note

4.2 MedicationTrack

복약 관리 항목

저장 위치:

families/{groupId}/module_instances/{medicationId}

주요 필드:

• templateKey: 'health'
• moduleKey: 'health'
• entityType: 'medication'
• title
• targetMemberId
• caregiverId
• dosageLabel
• frequencyLabel
• checkMode: 'daily' | 'twice_daily' | 'custom'
• status: 'active' | 'paused' | 'done'
• startedAt
• endedAt
• note

복약 체크 기록은 서브컬렉션으로 둔다.

families/{groupId}/module_instances/{medicationId}/medication_logs/{logId}

필드:

• checkedAt
• checkedBy
• dayKey: YYYY-MM-DD
• slotKey: 'morning' | 'evening' | 'custom'

---

5. 화면 구조

5.1 HealthScreen

탭 3개로 충분하다.

• 오늘
• 일정
• 복약

5.2 오늘 탭

보여주는 것:

• 오늘 병원/검사 일정
• 오늘 복약 체크 필요한 항목
• 연체/미완료 항목

5.3 일정 탭

보여주는 것:

• 병원 일정
• 검사 일정
• 상태 변경
• 새 일정 등록

5.4 복약 탭

보여주는 것:

• 활성 복약 목록
• 오늘 복용 체크 버튼
• 최근 체크 상태

---

6. 홈/피드 연동

health-lite는 홈과 활동 피드에 반드시 보여야 한다.

홈 카드

최소 요약:

• 오늘 일정 N건
• 오늘 복약 체크 필요 N건
• 미완료/지연 N건

활동 이벤트

이벤트 타입:

• health_schedule_created
• health_schedule_completed
• medication_checked

요약 예시:

• "아빠님의 정기 검진 일정이 등록됐어요"
• "엄마님이 혈압약 복용을 체크했어요"

---

7. 캘린더와의 관계

health-lite는 캘린더와 강하게 연결돼야 한다.

원칙:

• 병원/검사 일정은 calendar_events의 시간 축을 재사용
• health_schedule는 건강 도메인 세부 정보
• 캘린더에서 열었을 때 건강 상세로 이동 가능

MVP에서는 다음만 보장한다.

• health 일정 생성 시 calendar event도 함께 생성
• health 일정 상세에서 calendar context 확인 가능

---

8. 권한/공유 모델

MVP에서는 복잡한 의료 프라이버시 모델까지 가지 않는다.

대신 아래만 둔다.

• 가족 구성원은 읽기 가능
• 생성자와 caregiver는 수정 가능
• targetMember 본인도 상태 체크 가능

실무 원칙:

• 외부 공유 없음
• 링크 공유 없음
• health 데이터는 family 내부 전용

---

9. 성공 기준

MVP 완료 기준:

1. 병원/검사 일정 등록 가능
2. 복약 항목 등록 가능
3. 오늘 복약 체크 가능
4. 홈에서 오늘 건강 상태 요약 확인 가능
5. 활동 피드에 건강 이벤트 노출 가능

---

10. 구현 우선순위

Step 1. Schedule MVP

• health_schedule 모델
• 일정 등록
• 오늘/예정/완료 상태
• 활동 이벤트

Step 2. Medication MVP

• medication 모델
• 오늘 체크 버튼
• 일별 로그
• 홈 요약

Step 3. Calendar Link

• calendar_events 연동
• 상세 이동 연결

---

11. 다음 구현안

지금 바로 구현에 들어간다면 아래 순서가 맞다.

1. health 모듈 descriptor 추가
2. HealthSchedule / MedicationTrack 모델 추가
3. HealthService 추가
4. HealthScreen 3탭 UI 추가
5. module_launcher 연결
6. 홈 카드 + 활동 피드 연동

---

12. 결론

health-lite는 거대한 헬스케어 플랫폼이 아니라, 가족이 서로의 병원 일정과 약 복용을 함께 챙기는 도구로 시작해야 한다.

즉 MVP의 정답은 넓게 가는 것이 아니라, “일정 + 복약 + 보호자 공유”에 집중하는 것이다.