AllergyInsight¶

SGTi-Allergy Screen PLUS 기반 알러지 진단 및 처방 권고 시스템

AllergyInsight는 알러지 검사 결과를 분석하여 의료진에게는 근거 기반 처방 권고를, 환자에게는 맞춤형 생활 가이드를 제공하는 통합 헬스케어 플랫폼입니다. AI 기반 논문 분석, 알러젠 트렌드 대시보드, 뉴스레터 시스템을 포함합니다.

핵심 기능¶

시스템 구조¶

graph TB
    subgraph Client["Client Layer"]
        PRO["Professional<br/>/pro/*"]
        CON["Consumer<br/>/app/*"]
        ADM["Admin<br/>/admin/*"]
        PUB["Analytics / AI Portal<br/>/analytics/* /ai/*"]
    end

    subgraph Nginx["API Gateway (Nginx :4040)"]
        NG["Reverse Proxy + SPA"]
    end

    subgraph Backend["Backend (FastAPI :9040)"]
        API["REST API<br/>/api/pro, /api/consumer<br/>/api/admin, /api/public<br/>/api/ai, /api/subscribe"]
        SCH["Scheduler<br/>(APScheduler)"]
    end

    subgraph Data["Data Layer"]
        PG["PostgreSQL"]
        CH["ChromaDB<br/>(Vector DB)"]
    end

    subgraph External["External"]
        PM["PubMed"]
        SS["Semantic Scholar"]
        GN["Google/Naver News"]
        GM["Gemini API"]
        LM["Local LLM"]
    end

    PRO & CON & ADM & PUB --> NG
    NG --> API
    API --> PG & CH
    SCH --> PG
    API --> PM & SS & GM & LM
    SCH --> GN & GM

기술 스택¶

Backend¶

Frontend¶

Infrastructure¶

빠른 시작¶

# 1. 저장소 클론
git clone https://github.com/bluevlad/AllergyInsight.git
cd AllergyInsight

# 2. 환경 변수 설정
cp .env.example .env

# 3. 서비스 시작
docker compose up -d

# 4. 접속
# Frontend: http://localhost:4040
# Wiki: http://localhost:4040/wiki/
# API Docs: http://localhost:9040/docs

개발 현황¶

알러젠 트렌드 분석¶

Phase	내용	상태
Phase 1	논문 기반 알러젠 언급률 트렌드 분석	완료
Phase 2	치료법 엔티티 추출 및 트렌드 분석	완료
Phase 3	뉴스 기반 알러젠 트렌드 + 종합 통합 API	완료
Phase 4	역학 데이터 추출 (유병률/발병률/환자수)	완료
Phase 5	알러젠 종합 트렌드 대시보드	완료

프로젝트 구조¶

AllergyInsight/
├── backend/
│   └── app/
│       ├── api/              # FastAPI 라우터 + Public API
│       ├── auth/             # 인증 (JWT, Google OAuth, Email)
│       ├── admin/            # 관리자 콘솔 API
│       ├── core/             # 공통 모듈 (Auth, Allergen)
│       ├── professional/     # 의료진 서비스
│       ├── consumer/         # 환자 서비스
│       ├── scheduler/        # 뉴스/뉴스레터 스케줄러
│       ├── database/         # DB 모델, 시드, 마이그레이션
│       └── services/         # 비즈니스 로직 (39+ 서비스)
├── frontend/
│   └── src/
│       ├── apps/
│       │   ├── admin/        # 관리자 콘솔
│       │   ├── analytics/    # 트렌드 분석 (공개)
│       │   ├── professional/ # 의료진 앱
│       │   └── consumer/     # 환자 앱
│       └── pages/            # 공개 페이지
├── wiki/                     # MkDocs 위키 (이 사이트)
├── e2e/                      # E2E 테스트
└── docker-compose.yml