docs: 메시지 처리 전체 흐름 추가

- Slack/Frontend 경로 구분 명시
- router의 역할과 채널별 응답 처리 방식 정리
This commit is contained in:
happybell80 2025-09-14 15:29:50 +09:00
parent 730a725738
commit 22a2bc671b

View File

@ -73,6 +73,12 @@ response_text = response_text.replace("**", "*") # Slack 포맷 변환
2. **고아 코드 점검**: 미사용 모듈 정기적 확인 2. **고아 코드 점검**: 미사용 모듈 정기적 확인
3. **플랫폼별 포맷**: Slack mrkdwn ≠ Markdown 3. **플랫폼별 포맷**: Slack mrkdwn ≠ Markdown
## 메시지 처리 전체 흐름
**Slack**: `/api/slack/events` → slack_handler → router.route_message() → Brain(DecisionEngine) → 스킬/LLM → Slack 응답
**Frontend**: Gateway(JWT) → `/api/message` → router.route_message() → 동일 처리 → HTTP 응답
**채널 구분**: channel 파라미터 (Slack: "C0123ABCD", Frontend: "frontend")
**응답 반환**: router는 데이터만 생성, 실제 전송은 각 handler가 처리
## 영향 범위 ## 영향 범위
- router 레벨 통합 시 Slack뿐 아니라 모든 인터페이스(frontend 등)에 자연어 지원 - router 레벨 통합 시 Slack뿐 아니라 모든 인터페이스(frontend 등)에 자연어 지원
- DecisionEngine(정규식)과 IntentAnalyzer(LLM) 병행 사용으로 성능/정확도 균형 필요 - DecisionEngine(정규식)과 IntentAnalyzer(LLM) 병행 사용으로 성능/정확도 균형 필요