Excel 업로드 AI Chat 구현 아키텍처

flowchart TD
  %% Structure-analysis branch is the main decision point.

  A["1. 업로드
사용자가 Excel 첨부"] --> B{"2. 양식 판별
고정 양식인가?"}

  B -->|예: 효성 표준/샘플 양식| C1["템플릿 파서
정해진 시트 / 헤더 / 컬럼 매핑"]
  B -->|아니오: 사람마다 다른 양식| C2["가변 구조 추론
테이블 영역 / 헤더 / 병합셀 추정"]
  C2 --> C3{"확신도 충분?"}
  C3 -->|낮음| C4["사용자 확인
헤더행 / 분석 범위 / 주요 컬럼 선택"]
  C3 -->|높음| D["Workbook Profile
시트 / 컬럼 / 타입 / 통계 / 경고"]
  C4 --> D
  C1 --> D

  D --> E["3. 질문 이해
LLM이 SQL/분석계획 생성"]
  E --> F["4. 검증 + 계산
SQL Guard 후 DuckDB 실행"]
  F --> G["5. 답변
표 / 요약 / 근거 / 이상치"]

  D --> H["저장
Workbook / Sheet / Column Profile"]
  F --> I["로그
질문 / SQL / 결과 / 오류"]
  H --> J["Admin
템플릿 / 용어사전 / 실행 로그"]
  I --> J

  K["기존 첨부 RAG
문서 검색용"] -. "Excel 분석과 분리" .-> A
  L["LiteLLM Gateway
LLM 호출 경로"] -. "계획 생성만 담당" .-> E

  classDef user fill:#eef3ff,stroke:#6b8cff,color:#2f3440,stroke-width:1.8px;
  classDef excel fill:#e7fff4,stroke:#2fa66f,color:#173b2a,stroke-width:2.6px;
  classDef llm fill:#f1e9ff,stroke:#8c63da,color:#332057,stroke-width:2px;
  classDef guard fill:#fff1d6,stroke:#d2881e,color:#4a2d08,stroke-width:2.4px;
  classDef data fill:#eef8ff,stroke:#3b95d1,color:#17384e,stroke-width:1.7px;
  classDef admin fill:#fff0f3,stroke:#d94b64,color:#4f1823,stroke-width:1.9px;
  classDef decision fill:#fff9db,stroke:#c99a16,color:#3d2c03,stroke-width:2.4px;
  classDef muted fill:#f4f6fb,stroke:#8792a8,color:#2f3440,stroke-width:1.4px;

  class A user;
  class B,C3 decision;
  class C1,C2,C4,D,G excel;
  class E,L llm;
  class F guard;
  class H,I data;
  class J admin;
  class K muted;