시스템 개요

1. 시스템 소개

이메일 마케팅 캠페인 관리 및 네이버 블로그 크롤링 기능을 제공하는 Node.js 기반 웹 애플리케이션

핵심 기능

• 네이버 블로그 검색 결과 크롤링 및 블로거 ID 추출
• 이메일 검증 및 캠페인 발송
• 실시간 진행률 모니터링
• 발신자 그룹 관리

---

2. 기술 스택

영역	기술
Runtime	Node.js (ES Modules)
Framework	Express.js
Database	MySQL (mysql2/promise)
Template	EJS
Real-time	Socket.IO
Email	Nodemailer
Crawling	Axios, Cheerio, Puppeteer
Scheduling	node-schedule
Build	Webpack

---

3. 전체 시스템 아키텍처

graph TB
    subgraph Client["클라이언트"]
        Browser[웹 브라우저]
        WS[Socket.IO 클라이언트]
    end

    subgraph Server["Express 서버 :3001"]
        App[app.js]
        Session[express-session]

        subgraph Routes["라우터 계층"]
            AuthR[인증]
            CrawlR[크롤링]
            MailR[메일 발송]
            DbR[DB 쿼리]
            VendorR[벤더 연동]
        end

        subgraph Services["서비스 계층"]
            AuthS[인증 처리]
            SearchS[블로그 크롤러]
            MailS[메일 발송]
            QueryS[DB 쿼리]
            SocketS[실시간 알림]
            HiworksS[Hiworks 연동]
        end
    end

    subgraph External["외부 시스템"]
        NaverAPI[네이버 검색 API]
        BlogSecretAPI[BlogSecret API<br/>Load Balancer]
        SMTP[SMTP 서버<br/>Gmail/Naver/Hiworks]
    end

    subgraph Data["데이터 레이어"]
        MySQL[(MySQL<br/>Connection Pool)]
    end

    Browser -->|HTTP| App
    WS <-->|WebSocket| SocketS

    App --> AuthR
    App --> CrawlR
    App --> MailR
    App --> DbR
    App --> VendorR

    AuthR --> AuthS
    CrawlR --> SearchS
    MailR --> MailS
    MailR --> HiworksS
    DbR --> QueryS

    SearchS -->|HTTP| NaverAPI
    SearchS -->|병렬 처리| BlogSecretAPI
    MailS -->|SMTP| SMTP

    AuthS --> MySQL
    SearchS --> MySQL
    MailS --> MySQL
    QueryS --> MySQL
    HiworksS --> MySQL

---

4. 라우트 매핑

graph LR
    subgraph Endpoints["API 엔드포인트"]
        direction TB
        A1["/auth/*"]
        A2["/crawling/*"]
        A3["/api/*"]
        A4["/mail/*"]
        A5["/db/*"]
        A6["/vendors/*"]
    end

    subgraph Routers["라우터"]
        R1[인증]
        R2[크롤링]
        R3[메일 발송]
        R4[DB 쿼리]
        R5[벤더 연동]
    end

    A1 --> R1
    A2 --> R2
    A3 --> R2
    A4 --> R3
    A5 --> R4
    A6 --> R5

---

5. 주요 데이터 흐름

sequenceDiagram
    participant U as 사용자
    participant S as 서버
    participant N as 네이버 API
    participant B as BlogSecret API
    participant DB as MySQL
    participant SMTP as 메일 서버

    rect rgb(200, 220, 250)
        Note over U,DB: 1. 블로그 검색 및 크롤링
        U->>S: 키워드 검색 요청
        S->>N: 네이버 블로그 검색
        S->>B: 병렬 상세 수집
        B-->>S: 블로거 정보
        S->>DB: 검색 결과 저장
        S-->>U: 결과 반환
    end

    rect rgb(220, 250, 200)
        Note over U,SMTP: 2. 이메일 캠페인 발송
        U->>S: 발송 예약
        S->>DB: 스케줄 등록
        S->>DB: 수신자 목록 조회
        S->>SMTP: 이메일 발송
        SMTP-->>S: 발송 결과
        S->>DB: 상태 업데이트
    end

---

6. 디렉토리 구조

renamailer/
├── app.js                 # 메인 엔트리포인트
├── config/
│   ├── dbConfig.js        # MySQL 연결 설정
│   ├── logger.js          # Winston 로깅
│   └── config.env         # 환경 변수
├── routes/
│   ├── auth-router.js     # 인증 라우터
│   ├── crawl-router.js    # 크롤링 라우터
│   ├── crawling.js        # 크롤링 보조
│   ├── db-router.js       # DB 쿼리 라우터
│   ├── mail-router.js     # 메일 라우터
│   └── vendors-router.js  # 벤더 라우터
├── models/
│   ├── auth-service.js    # 인증 서비스
│   ├── doSearchService.js # 크롤링 서비스
│   ├── mail-service.js    # 메일 서비스
│   ├── query-service.js   # 쿼리 서비스
│   ├── socketService.js   # 소켓 서비스
│   └── hiworksService.js  # 하이웍스 연동
├── views/                 # EJS 템플릿
├── public/                # 정적 파일
└── dist/                  # Webpack 빌드 결과

---

7. 환경 설정

변수	용도
BLOG_SECRET_API_URL	BlogSecret API 로드밸런서 URL
USE_PARALLEL_API	병렬 처리 활성화 여부
MAX_CONCURRENT_REQUESTS	동시 요청 제한 (기본값: 10)
MAIL_HOSTINFO	SMTP 호스트
MAIL_PORTINFO	SMTP 포트
LOGIN_PASSWORD_LENGTH	로그인 비밀번호 길이

---

8. 관련 문서

• 02-layer-architecture.md - 레이어별 상세 구조
• 03-crawling-flow.md - 웹 크롤링 상세 흐름
• 04-email-campaign-flow.md - 이메일 캠페인 상세
• 05-auth-flow.md - 인증 흐름 상세