SYSTEM BLUEPRINT

AI 헬스케어 챗봇
화면 설계 및 시나리오

카카오톡 이용자, 운영 관리자, 도메인 검수자의 핵심 여정을 MVP 화면 단위로 정의했습니다.

카카오톡 이용자 시나리오

카카오톡 기반 맞춤 건강 안내 흐름

사용자는 별도 앱 설치 없이 문진, 데이터 연결, AI 응답, 알림 수신까지 이어갑니다.

1. 채널 진입

카카오톡 채널 추가
서비스 목적 확인

2. 기본 문진

최소 입력으로 프로필 생성
중간 저장 지원

3. 데이터 연결

공공 및 민간 API 연결
상태와 권한 안내

4. AI 맞춤 응답

OpenAI 기반 안내 제공
안전 문구 자동 적용

5. 알림 수신

예약 알림톡 수신
재방문 유도

카카오톡 이용자 | 화면 01

카카오톡 문진 시작 화면

kakao.channel/health-mvp/start

건강 체크 시작

안녕하세요. 맞춤 건강 안내를 시작합니다.
기본 정보 3가지만 입력해 주세요.
중간에 나가도 이어서 진행할 수 있어요.
다음 단계

[화면 개요 및 목적]

사용자가 서비스 목적을 이해하고 기본 문진을 시작하는 첫 화면입니다.

[핵심 기능 로직]

웹훅으로 사용자 식별값을 받고 문진 세션을 생성합니다.

  • 카카오톡 채널 웹훅
  • 세션 저장 API
카카오톡 이용자 | 화면 02

데이터 연결 상태 확인

kakao.channel/health-mvp/connect

데이터 연결

공공데이터 연결 완료
민간 건강데이터 확인 필요
연결 실패 시 다시 시도 가능
다음 단계

[화면 개요 및 목적]

외부 API 연결 상태를 사용자가 이해하기 쉽게 안내합니다.

[핵심 기능 로직]

API별 권한, 호출 성공 여부, 오류 메시지를 표준 상태값으로 관리합니다.

  • 공공기관 API
  • 민간 API 인증
카카오톡 이용자 | 화면 03

AI 맞춤 응답 및 알림 예약

맞춤 안내

오늘의 요약이 준비되었습니다.
주의가 필요한 항목 2개
내일 오전 9시에 다시 알려드릴게요.
다음 단계

[화면 개요 및 목적]

사용자가 분석 결과와 다음 행동을 바로 이해하도록 짧은 메시지로 제공합니다.

[핵심 기능 로직]

OpenAI 응답 생성 후 금지 문구, 불확실성 안내, 알림 예약 조건을 검증합니다.

  • OpenAI API
  • 알림톡 예약 큐
운영 관리자 시나리오

운영 현황 관리 흐름

관리자는 사용자 현황, 대화 로그, API 상태, 알림 발송 결과를 한 화면에서 추적합니다.

1. 로그인

관리자 권한 확인
접근 로그 기록

2. 현황 확인

사용자 수와 대화 수
API 상태 확인

3. 로그 검토

대화와 오류 기록
위험 응답 추적

4. 알림 설정

발송 조건과 문구 관리
실패 재처리

5. 보고 자료

테스트와 배포 기록
결과 보고 근거 확보

운영 관리자 | 화면 01

관리자 대시보드

admin.health-mvp.io/dashboard

운영 대시보드

활성 사용자
128
오늘 대화
842
API 성공률
98.7%
알림 발송
312
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

서비스 운영자가 오늘의 핵심 지표와 장애 여부를 확인하는 화면입니다.

[핵심 기능 로직]

사용자, 대화, API 호출, 알림 발송 데이터를 집계합니다.

  • Next.js
  • PostgreSQL
운영 관리자 | 화면 02

대화 로그 상세

admin.health-mvp.io/conversations

대화 로그

검토 필요
7
오류 응답
2
평균 응답
1.4초
재시도
5
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

사용자별 대화, OpenAI 응답, 외부 API 호출 결과를 확인합니다.

[핵심 기능 로직]

민감 정보는 마스킹하고 관리자 권한별 접근 범위를 분리합니다.

  • 로그 마스킹
  • 권한 관리
운영 관리자 | 화면 03

알림 설정 및 발송 이력

admin.health-mvp.io/notifications

알림 관리

예약 대기
64
발송 성공
96%
실패 재처리
3
템플릿
12
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

예약 알림 조건과 문구를 관리하고 실패 건을 재처리합니다.

[핵심 기능 로직]

스케줄러와 알림톡 API 결과를 연동해 상태를 저장합니다.

  • Data Aggregation & Visualization
  • EventBridge와 알림톡 API
도메인 검수자 시나리오

AI 응답 품질 검수 흐름

도메인 검수자는 샘플 응답과 위험 문구를 검토하고 개선 기준을 운영에 반영합니다.

1. 샘플 확인

응답 샘플 목록
우선순위 확인

2. 위험 문구 검토

금지 표현 탐지
수정 의견 작성

3. 기준 수정

응답 규칙 업데이트
프롬프트 개선

4. 재검증

수정 후 샘플 비교
품질 기준 확인

5. 리포트

검수 이력 저장
보고 자료 활용

도메인 검수자 | 화면 01

응답 검수 큐

review.health-mvp.io/queue

응답 검수 큐

대기
24
수정 요청
6
승인
118
고위험
1
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

검수자가 위험도와 우선순위별로 AI 응답 샘플을 확인합니다.

[핵심 기능 로직]

금지 문구 탐지 결과와 사용자 맥락을 함께 표시합니다.

  • 응답 분류 모델
  • 검수 워크플로우
도메인 검수자 | 화면 02

금지 문구 및 기준 관리

review.health-mvp.io/rules

응답 기준 관리

활성 규칙
42
최근 변경
5
차단 문구
18
안내 문구
9
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

서비스 운영 기준에 맞춰 금지 표현과 안내 문구를 관리합니다.

[핵심 기능 로직]

룰 변경 이력을 저장하고 이후 응답 생성 단계에 반영합니다.

  • 룰 엔진
  • 변경 이력 관리
도메인 검수자 | 화면 03

검수 리포트

review.health-mvp.io/reports

품질 리포트

검수 완료
118
개선 반영
21
평균 처리
4시간
내보내기
PDF
최근 대화 로그와 API 상태를 실시간으로 확인합니다.

[화면 개요 및 목적]

검수 현황과 개선 이력을 정부지원사업 보고 자료로 활용합니다.

[핵심 기능 로직]

검수자, 변경 내용, 테스트 결과를 추적 가능한 형태로 저장합니다.

  • 리포트 내보내기
  • Issue Tracking & Status Management