본문으로 건너뛰기

Agent Treatment Flow 도메인

소개​

Agent Treatment Flow는 불면증 치료 서비스의 Business Logic Layer로서, AI 기반 CBT-I(Cognitive Behavioral Therapy for Insomnia) 치료 전략을 수립하고 실행하는 핵심 도메인입니다.

이 도메인은 "무엇을 보여줄 것인가?"에 대한 모든 의사결정을 담당하며, 개인화된 치료 콘텐츠를 생성하고 관리합니다.

핵심 책임​

  1. 치료 지능 (Treatment Intelligence)

    • 환자별 맞춤형 치료 전략 수립
    • A-H-I-R 순환 모델 기반 의사결정
    • 임상 가이드라인 준수

  2. 콘텐츠 생성 (Content Generation)

    • LLM 기반 개인화 메시지 작성
    • 치료적 Task 설계
    • 평가 질문 생성

  3. 우선순위 관리 (Prioritization)

    • 콘텐츠 중요도 평가
    • 노출 시점 최적화
    • 충돌 해결

  4. 임상 분석 (Clinical Analysis)

    • 치료 효과성 측정
    • 패턴 인식 및 예측
    • 전략 조정 제안

아키텍처 위치​

┌─────────────────────────────────────────────────┐
│                Mobile App                        │
└─────────────────────────────────────────────────┘
                        ↑
                        │ (표시/상호작용)
                        ↓
┌─────────────────────────────────────────────────┐
│            Agent Board Domain                    │ ← Presentation Layer
│         (어떻게 보여줄 것인가?)                   │
└─────────────────────────────────────────────────┘
                        ↑
                        │ (콘텐츠 전달)
                        ↓
┌─────────────────────────────────────────────────┐
│       Agent Treatment Flow Domain                │ ← Business Logic Layer
│         (무엇을 보여줄 것인가?)                   │
└─────────────────────────────────────────────────┘
                        ↑
                        │ (데이터 수집)
                        ↓
┌─────────────────────────────────────────────────┐
│    Sleep, Questionnaire, Learning Domains        │ ← Data Layer
└─────────────────────────────────────────────────┘

문서 구조​

개요 문서​

  • overview.md - 도메인 전체 개요 및 핵심 개념

치료 단계별 문서​

np- P1: 초기 평가 - 1주일 데이터 분석

기술 문서​

DDD 문서​

주요 특징​

1. A-H-I-R 순환 모델​

  • Assess: 데이터 수집 및 현황 파악
  • Hypothesize: 문제 원인 가설 수립
  • Intervene: 치료적 개입 실행
  • Re-evaluate: 결과 평가 및 조정

2. 5단계 치료 프로세스​

  • 체계적이고 과학적인 접근
  • 단계별 명확한 목표와 산출물
  • 유연한 전환과 조정 가능

3. 개인화 전략​

  • 핵심 서사(Core Narrative) 기반 접근
  • 환자별 커뮤니케이션 스타일 적용
  • 생활 맥락을 고려한 Task 설계

4. 안전성 보장​

  • Critical Issue 자동 감지
  • 의료진 즉시 알림 시스템
  • 이중 채널 안전망

다른 도메인과의 관계​

데이터 수집 도메인​

  • Sleep: 수면기록 데이터 분석
  • Questionnaire: 표준 설문 결과 활용
  • Learning: 교육 진도와 Task 연계
  • User: 프로필 및 선호도 정보

콘텐츠 전달 도메인​

  • Agent Board: 생성된 콘텐츠 표시
    • 치료 메시지, Task, 질문 전송
    • 우선순위 및 표시 규칙 제공
    • 상호작용 피드백 수신

기술 스택​

  • Backend: NestJS, TypeScript
  • AI/ML: OpenAI GPT-4, LangChain
  • Database: PostgreSQL, Redis
  • Messaging: GCP Pub/Sub
  • Monitoring: Prometheus, Grafana

시작하기​

이 도메인의 문서를 읽는 순서:

  1. overview.md - 전체적인 이해
  2. implementation-guides/ 폴더의 P1~P5 단계별 상세 내용
  3. requirements.md - 기술적 요구사항
  4. implementation-strategy.md - Flowise 기반 구현 방법

기여 가이드​

문서 수정 시 다음 사항을 준수해주세요:

  1. Business Logic Layer의 책임 범위 유지
  2. Agent Board 도메인과의 명확한 경계 구분
  3. 임상적 정확성 검증
  4. 용어 일관성 유지 (예: 수면기록, Task 등)

이벤트 기반 아키텍처​

User Domain          Sleep Domain         Questionnaire
    |                    |                     |
    v                    v                     v
[UserCycleStarted]  [SleepRecorded]  [AssessmentCompleted]
    |                    |                     |
    +--------------------+---------------------+
                         |
                         v
              Agent Treatment Flow
                         |
                         v
            [Decision & Generation]
                         |
                         v
              [CreateMessageCommand]
                         |
                         v
                   Agent Board

📁 문서 구조​

핵심 문서​

  • overview.md - 도메인 개요 및 핵심 개념
  • domain-model.md - 도메인 모델 상세 설명
  • event-storming.md - 이벤트 스토밍 결과
  • business-rules.md - 비즈니스 규칙 정의
  • requirements.md - 기능/비기능 요구사항

구현 가이드​

  • implementation-guides/
    • p1-initial-assessment-guide.md - P1 초기 평가
    • p2-hypothesis-refinement-guide.md - P2 가설 정제
    • p3-treatment-roadmap-guide.md - P3 로드맵 설계
    • p4-daily-coaching-guide.md - P4 일일 코칭
    • p5-weekly-evaluation-guide.md - P5 주간 평가

기타​

  • agent-message-types.md - 10가지 메시지 유형 상세
  • implementation-strategy.md - 구현 전략
  • mcp-tools-development.md - MCP 도구 개발 가이드

🚀 Quick Start​

  1. 도메인 이해하기

    • overview.md로 시작하여 전체 맥락 파악
    • domain-model.md에서 주요 개념 학습

  2. 비즈니스 로직 파악

    • business-rules.md에서 핵심 규칙 확인
    • event-storming.md로 이벤트 흐름 이해

  3. 구현 상세 확인

    • 각 P1-P5 구현 가이드 참조
    • implementation-strategy.md로 기술적 접근 방법 확인

🔗 관련 도메인​

  • User Domain: 사용자 정보 및 치료 프로세스 생명주기
  • Sleep Domain: 수면 데이터 및 분석
  • Questionnaire Domain: 설문 응답 데이터
  • Agent Board Domain: 메시지 전달 채널
  • Content Domain: 메시지 템플릿 관리

📈 현재 상태​

  • ✅ 도메인 모델 정의 완료
  • ✅ 이벤트 핸들러 구조 구현
  • ✅ 메시지 생성 아키텍처 설계
  • 🚧 P1-P5 상세 구현 진행 중
  • 📅 MCP 도구 개발 예정