Developer Technical Documentation

1. 시스템 개요 (System Overview)

본 포털은 AWS Lightsail (Debian Linux, Apache2, PHP 8.5, MySQL, Python 3) 환경 위에서 동작하며, 자율 AI 뉴스 수집 & 요약 파이프라인, 이메일 모닝 브리핑, SOLAPI SMS 전송 게이트웨이, 웹 기반 MySQL 관리 뷰어, 서버 리소스 실시간 진단 도구를 하나로 통합한 웹 인텔리전스 허브입니다.

2. 6대 서비스 모듈 및 엔드포인트 맵

3. AI 뉴스 수집기 & DB 스케줄러 아키텍처

Google News RSS로부터 키워드별 뉴스를 크롤링하고, Trafilatura로 본문 전문을 정제한 뒤, Google Gemini 3.6 Flash AI 모델을 통해 3줄 핵심 요약, 중요도 점수(1~5★), 비즈니스/기술 시사점(Insight)을 도출하여 MySQL `articles` 테이블에 저장합니다.

3.1. 백엔드 구성 파일

• /var/www/html/NEWS/index.php : 대시보드 4대 섹션 UI 및 AJAX API 핸들러
• /var/www/html/NEWS/agent_runner.py : Python RSS 크롤러 & Gemini AI 요약 파이프라인
• /var/www/html/NEWS/schedule_worker.py : MySQL `schedules` 테이블을 1분마다 폴링하는 마스터 스케줄러 워커
• /var/www/html/NEWS/send_morning_report.py : Gmail SMTP 이메일 모닝 브리핑 발송 엔진

3.2. 주요 API 엔드포인트

4. 이메일 모닝 브리핑 (Gmail SMTP)

매일 새벽 지정된 시각(기본 KST 06:00)에 등록된 구독자에게 애플 매거진 스타일의 반응형 HTML 이메일 리포트를 발송합니다.

# SMTP 연동 설정 (AWS.txt 및 send_morning_report.py)
SMTP_SERVER = 'smtp.gmail.com'
SMTP_PORT   = 587 (STARTTLS)
SMTP_USER   = 'euphoriagny050602@gmail.com'
SMTP_PASS   = 'drbxhhtfmvkyvpjl' # Google 16자리 앱 비밀번호
            

5. SMS / LMS 메시징 게이트웨이 (SOLAPI v4)

SOLAPI (CoolSMS v4) REST API를 기반으로 구현된 초고속 단문/장문 메시징 발송 도구입니다. 90바이트를 초과하면 자동으로 LMS(장문)로 전환되며, 모든 발송 내역은 MySQL `sms_logs`에 저장됩니다.

5.1. SOLAPI HMAC-SHA256 인증 프로토콜 (PHP 구현)

function getSolapiAuthHeader() {
    $apiKey    = 'NCSO4LSWYGVIDLHE';
    $apiSecret = 'QFBHIELDDYNQMMFO8OFUQE4MVEFFSXYI';
    $date      = gmdate('Y-m-d\TH:i:s\Z');
    $salt      = bin2hex(random_bytes(16));
    $signature = hash_hmac('sha256', $date . $salt, $apiSecret);
    return "HMAC-SHA256 apiKey={$apiKey}, date={$date}, salt={$salt}, signature={$signature}";
}
            

5.2. SMS API 엔드포인트

6. MySQL 데이터베이스 뷰어 (`/DB/`)

웹 브라우저에서 서버 내의 모든 MySQL 데이터베이스(`news_agent`, `lampdb` 등)를 탐색할 수 있는 관리 뷰어입니다.

• 데이터 브라우저: 페이징, 컬럼별 ASC/DESC 정렬, 전문 검색 필터, 레코드 JSON/상세 모달 뷰어, CSV Export
• 스키마 & 구조: 컬럼 타입, Nullability, Primary/Unique 키, Collation, 인덱스 목록, SHOW CREATE TABLE 원문 복사
• 인터랙티브 SQL 콘솔: Ctrl/Cmd + Enter 즉시 쿼리 실행, 실행 소요 시간(ms), 템플릿 칩 지원
• 서버 상태 & 메트릭: MySQL 버전, Uptime, Threads, 처리 쿼리 수, 데이터베이스별 용량(MB) Chart.js 차트

7. MySQL 데이터베이스 스키마 명세 (`news_agent` DB)

7.1. 핵심 테이블 목록

8. DB 스케줄러 워커 아키텍처

리눅스 crontab에는 단 하나의 마스터 워커만 등록되어 있으며, 모든 세부 작업 시각은 MySQL `schedules` 테이블을 통해 동적으로 제어됩니다.

# Linux Root Crontab (서버에 등록된 단일 마스터 워커)
* * * * * /var/www/html/AGENT/venv/bin/python3 /var/www/html/NEWS/schedule_worker.py >> /var/log/schedule_worker.log 2>&1
            

• 워커는 매 분 1회 실행되어 현재 한국 표준시(KST)를 계산합니다.
• MySQL `schedules` 테이블의 `run_time`과 `is_active = 1` 조건을 조회하여 대상 작업을 자동 실행합니다.
• 당일 중복 실행 방지 알고리즘 및 실행 결과 `schedule_logs` 적재를 완벽하게 처리합니다.

9. 배포 및 서버 동기화 명령어

로컬 워크스페이스(`/Users/nayeon/Desktop/AWS`)에서 서버로 파일 배포 시 사용하는 기본 명령어입니다:

# 1. 파일 동기화 (SCP)
scp -i /Users/nayeon/Desktop/SSHkey.pem -o StrictHostKeyChecking=no \
    /Users/nayeon/Desktop/AWS/news_dashboard.php \
    /Users/nayeon/Desktop/AWS/db_viewer.php \
    /Users/nayeon/Desktop/AWS/sms_sender.php \
    /Users/nayeon/Desktop/AWS/schedule_worker.py \
    /Users/nayeon/Desktop/AWS/send_morning_report.py \
    /Users/nayeon/Desktop/AWS/README.html \
    admin@43.203.81.151:/tmp/

# 2. 웹 디렉터리 반영 및 권한 설정 (SSH)
ssh -i /Users/nayeon/Desktop/SSHkey.pem -o StrictHostKeyChecking=no admin@43.203.81.151 "
    sudo cp /tmp/news_dashboard.php /var/www/html/NEWS/index.php &&
    sudo cp /tmp/news_dashboard.php /var/www/html/NEWS/news_dashboard.php &&
    sudo cp /tmp/db_viewer.php /var/www/html/DB/index.php &&
    sudo cp /tmp/sms_sender.php /var/www/html/SMS/index.php &&
    sudo cp /tmp/schedule_worker.py /var/www/html/NEWS/schedule_worker.py &&
    sudo cp /tmp/send_morning_report.py /var/www/html/NEWS/send_morning_report.py &&
    sudo cp /tmp/README.html /var/www/html/README.html &&
    sudo chmod +x /var/www/html/NEWS/*.py &&
    sudo chown -R www-data:www-data /var/www/html
"