System Architecture - 시스템 구조

시스템 파이프라인 흐름도

naver_analytics (Django) server (Node.js) C# 에이전트 ┌─────────────────────┐ ┌──────────────────────┐ ┌─────────────────────┐ │ 에이전트 엑셀 │ .xlsx │ admin/agent-config │ API │ 카페 글 자동발행 │ │ 발급 (Modal) │─────→│ /upload (MongoDB) │─────→│ (Form1.cs) │ │ │ │ │ │ │ │ - 카페/계정 관리 │ │ - 큐 관리 (posts[]) │ │ - GET 설정 fetch │ │ - 제목 자동생성 │ │ - 상태 모니터링 │ 에러 │ - ChatGPT 글생성 │ │ - 이미지셋 관리 │ │ - 카페 정지 처리 │←─────│ - 네이버 발행 │ │ - 사용이력 추적 │ │ - 벌크 수정 │report │ - 에러 보고 │ └─────────────────────┘ └──────────────────────┘ └─────────────────────┘

시스템별 역할

naver_analytics

Django / Python

• 카페/네이버 계정 DB 관리
• 글제목 자동 생성 (조합 로직)
• 이미지셋 관리 (S3 업로드)
• 에이전트 배포용 엑셀(.xlsx) 발급
• 사용 이력 추적 및 통계
• 카페 정지 시 자동 교체 처리

server

Node.js / MongoDB

• 엑셀 업로드 → MongoDB 저장
• 에이전트 설정 API (큐 방식 pop)
• 환경 목록 관리 (CRUD)
• 에러 보고 수신 및 상태 관리
• 카페 정지 감지 → Django 포워딩
• 벌크 수정 기능

C# 에이전트

C# / Selenium / WinForms

• 서버에서 설정 fetch (GET)
• ChatGPT API로 글 본문 생성
• Selenium으로 네이버 카페 발행
• 발행 간격 제어 (min~max초)
• 에러 발생 시 서버에 보고
• 라이선스 검증

파이프라인 요약

Step 1 Django에서 카페/계정/제목/이미지를 조합하여 에이전트 배포용 .xlsx 엑셀 파일 생성

Step 2 관리자가 엑셀을 서버 admin 페이지에서 업로드 → MongoDB에 환경별로 파싱/저장 (posts[] 큐)

Step 3 C# 에이전트가 GET /api/cafe/config로 설정 요청 → 서버가 큐에서 pop하여 응답

Step 4 에이전트가 ChatGPT로 글 생성 → Selenium으로 네이버 카페에 자동 발행

Error 에러 발생 시 에이전트 → 서버로 에러 보고 → 카페 정지 패턴이면 Django에 포워딩하여 자동 교체

데이터 흐름

엑셀 컬럼 구조

#	컬럼명	설명	예시

MongoDB 스키마 (ENV_CAFE.env_inf)

{
  env_num:    "5-1",              // 환경번호 (카페번호-아이디순번)
  id:         "naver_id",         // 네이버 로그인 ID
  pw:         "naver_pw",         // 네이버 로그인 PW
  cafe_link:  "boiledlife",       // 카페 URL (ID)
  menu_id:    "123",              // 카페 메뉴 ID
  min_time:   300,                // 최소 발행 간격 (초)
  max_time:   600,                // 최대 발행 간격 (초)
  common_prompt: "...",           // GPT 공통 요청사항
  chatgpt_api_key: "sk-...",      // OpenAI API 키
  image_urls: ["url1", "url2"],   // S3 이미지 URL 목록
  banner_image_url: "url",        // 배너 이미지 URL
  posts: [                        // 발행 큐 (pop 방식)
    { title: "글제목1", image_keyword: "키워드1" },
    { title: "글제목2", image_keyword: "키워드2" }
  ],
  posts_count: 10,                // 총 글제목 수
  status:     "normal",           // 상태 (normal | error)
  last_error: {                   // 마지막 에러 정보
    message:     "에러 메시지",
    naver_id:    "에러 발생 ID",
    cafe_url:    "에러 발생 카페",
    reported_at: "2026-03-11T..."
  },
  created_at:  "2026-03-11T...",
  updated_at:  "2026-03-11T..."
}

API 엔드포인트

Method	엔드포인트	설명	호출자

에러 처리 흐름

카페 정지 감지 → 자동 교체 흐름

C# 에이전트가 카페 발행 중 에러 감지

POST /api/agent-config/report-status 로 에러 메시지 전송

서버가 에러 메시지를 정지 패턴과 매칭 확인

정지 패턴 매칭 시 → POST /api/agent-config/sync-cafe 로 Django에 포워딩

Django가 해당 카페를 자동 교체 (새 카페/계정 할당) → 서버 DB 동기화

카페 정지 감지 패턴

에이전트가 보고한 에러 메시지에 아래 패턴이 포함되면 카페 정지로 판단합니다.

에이전트 치명적 에러 패턴

아래 에러는 에이전트 실행 자체를 중단시키는 치명적 에러입니다.

에러 보고 데이터 구조

// POST /api/agent-config/report-status
{
  env_num:   "5-1",                        // 환경번호
  status:    "error",                      // 상태
  message:   "접근하실 수 없습니다",          // 에러 메시지
  naver_id:  "user123",                    // 에러 발생 네이버 ID
  cafe_url:  "boiledlife"                  // 에러 발생 카페
}

// 서버 처리 후 DB 업데이트
{
  status: "error",
  last_error: {
    message:     "접근하실 수 없습니다",
    naver_id:    "user123",
    cafe_url:    "boiledlife",
    reported_at: "2026-03-11T12:00:00.000Z"
  }
}