CP25 Cloud Project

Related Notes

• 학습: CP25_IaC_Terraform
• 리서치: Nanobanana(Gemini-2.5-flash-image) | Nanobanana-를-사용해서-어떤-것까지-가능할까?
• 회고: 2025-02-Semester-Recap

프로젝트 개요

Brandana - AI 기반 브랜드 에셋 이미지 자동 생성 솔루션

항목	내용
완료일	2025-12-22
GitHub	Cloud-Brandana/Brandana
기술 스택	React+Vite, Express, FastAPI, Gemini, LangChain, AWS

핵심 가치

브랜드 스타일 가이드 입력 시 일관된 아이콘/이미지 에셋을 빠르게 생성

• 스타일 템플릿 + 프롬프트 오케스트레이션
• 시드 고정 + 자동 후처리
• Consistency Score 기반 품질 검증

시스템 아키텍처

flowchart LR
    subgraph Client
        React[React SPA]
    end

    subgraph Backend
        Express[Express<br/>API Gateway]
        FastAPI[FastAPI<br/>Orchestrator]
    end

    subgraph Storage
        RDS[(RDS/Redis)]
        S3[(S3/CloudFront)]
    end

    subgraph AI
        Gemini[Gemini API]
        LC[LangChain]
    end

    React --> Express
    Express --> FastAPI
    Express --> RDS
    Express --> S3
    FastAPI --> Gemini
    FastAPI --> LC

역할 분담:

• Express (Core): 인증, 쿼터, DB, S3 메타데이터, Job 상태 관리
• FastAPI (Orchestrator): LangChain 체인, Gemini 호출, ConsistencyScore, 이미지 처리

LangChain Pipeline

flowchart TD
    A[LangChainInput] --> B[StylePreprocessRunnable<br/>입력 정규화]
    B --> C[PromptBuilderRunnable<br/>스타일→자연어 프롬프트]
    C --> D[GeminiImageRunnable<br/>with_retry]
    D --> E[LangChainOutput]

    D -.->|품질 미달| F{ValidationAgent}
    F -->|재시도| C
    F -->|통과| E

주요 체인:

• StyleDNAChain: Vision API + LLM 텍스트 파싱 → 스타일 파라미터 추출
• PromptBuilderChain: FewShot + 스타일 → 최종 프롬프트
• ValidationAgent (ReAct): 품질 미달 시 자동 재시도 (최대 3 회)

주요 학습

• LangChain Runnable/Chain 설계 및 .with_retry() 전략
• AWS 멀티 AZ 아키텍처 (RDS, S3, CloudFront, Redis)
• Express ↔ FastAPI 인터페이스 설계 (trace_id, sync/async mode)
• ConsistencyScore + OpenCV Spec Checker 품질 검증
• LangSmith 트레이싱 및 비용 모니터링

문서

상세 설계 및 구현 문서는 GitHub 저장소 참조:

• System Architecture & Data Flow
• API Specification (Express, FastAPI)
• LangChain Components & State Machine
• Style Parameter Schema (LogoStyleConfig)
• Retry Strategy & Error Handling