[사용자 요청]
     ↓
[Spring ChatService: 상태 판단 + 흐름 제어]
     ↓                     ↘️
[상태 전이에 따른 로직 처리]  → (필요 시) [FastAPI (/chat)] 호출
     ↓
[다음 상태 + 메시지 결정]
     ↓
[ChatHistory 저장 + 응답 반환]

📍 START → WAITING_USER_SELECT_FEATURE
         // 기능 선택 대기 (1. 문제 생성 / 2. 페이지 찾기 / 3. 개념 설명)

         ├─ 1. 예상 문제 생성
         │   → WAITING_PROBLEM_CRITERIA_SELECTION
         │     // 문제 기준 선택 요청
         │     → WAITING_PROBLEM_CONTEXT_INPUT
         │       // 챕터/개념 입력 요청
         │       → ⚡ GENERATING_QUESTION_WITH_RAG
         │         // FastAPI 호출로 문제 생성
         │         → ⚡ EVALUATING_ANSWER_AND_LOGGING
         │           // FastAPI 호출로 정오답 판단 및 해설 포함
         │           → WAITING_CONCEPT_RATING
         │             // 해설에 대한 이해도 평가 요청
         │             ├─ 4~5점 → WAITING_NEXT_ACTION_AFTER_LEARNING
         │             │           // 다음 행동 선택 (1. 다음 문제 / 2. 기능 선택)
         │             │           ├─ 1. 다음 문제 → ⚡ GENERATING_ADDITIONAL_QUESTION_WITH_RAG
         │             │           │                        → ⚡ EVALUATING_ANSWER_AND_LOGGING → ...
         │             │           └─ 2. 기능 선택 → WAITING_USER_SELECT_FEATURE
         │             └─ 1~3점 → WAITING_REASON_FOR_LOW_RATING
         │                          // 낮은 점수 이유 요청
         │                          → ⚡ REEXPLAINING_CONCEPT
         │                            // FastAPI 호출로 보충 설명
         │                            → WAITING_CONCEPT_RATING (반복)

         ├─ 2. 페이지 찾기
         │   → WAITING_KEYWORD_FOR_PAGE_SEARCH
         │     // 키워드 입력 대기
         │     → ⚡ PROCESSING_PAGE_SEARCH_RESULT
         │       // FastAPI 호출로 페이지/챕터 추천
         │       → WAITING_USER_SELECT_FEATURE (루프)

         └─ 3. 개념 설명
             → WAITING_CONCEPT_INPUT
             // 개념 입력 대기
               → ⚡ PRESENTING_CONCEPT_EXPLANATION
               // FastAPI 호출로 개념 설명
                 → WAITING_CONCEPT_RATING
                   // 설명에 대한 평가
                   ├─ 4~5점 → WAITING_NEXT_ACTION_AFTER_LEARNING → (선택에 따라 루프)
                   └─ 1~3점 → WAITING_REASON_FOR_LOW_RATING → ⚡ REEXPLAINING_CONCEPT → WAITING_CONCEPT_RATING (반복)

📦KDT_BE12_Toy_Project4/
├─ 📁 application-server/             # Spring Boot 애플리케이션
│  └─ 📁 application/                 # 핵심 서버 애플리케이션 모듈
│     ├─ 📁 src/                      # Java 소스 코드
│     ├─ 📜 build.gradle              # Gradle 빌드 스크립트
│     ├─ 📜 Dockerfile                # Spring Boot Dockerfile
│     └─ ...
│
├─ 📁 langchain-server/              # FastAPI + LangChain 기반 AI 서버
│  ├─ 📁 app/                         # FastAPI 라우터 및 서비스 코드
│  ├─ 📁 tests/                       # 테스트 코드
│  ├─ 📜 Dockerfile                   # FastAPI Dockerfile
│  ├─ 📜 Dockerfile.elasticsearch     # Elasticsearch 포함 빌드용 Dockerfile
│  └─ 📜 pyproject.toml              # Python 프로젝트 설정
│
├─ 📜 docker-compose.yml             # 전체 멀티 컨테이너 구성 파일
├─ 📜 .env.dev                        # 개발용 환경 변수
├─ 📜 .env.prod                       # 운영용 민감 정보 (Git 제외 권장)
├─ 📜 README.md
└─ ...