네이버 검색광고 데이터 수집 시스템 마이그레이션 프로젝트

📋 프로젝트 개요

마케터 6년차 → 개발자 전환 과정에서 AI(Gemini CLI + Claude Code)를 활용해 기존 Apps Script 시스템을 GCP 클라우드로 무료 이전하는 실전 학습 프로젝트

🎯 핵심 목표

• 비용 ZERO: 무료 티어만으로 광고대행사 팀 단위 사용 가능한 시스템
• AI 활용 실증: 비전공자도 Gemini CLI + Claude Code로 클라우드 개발 가능함을 입증
• 실무 문제 해결: 광고업계 실제 니즈(실시간 키워드 분석) 반영
• 커리어 전환 포트폴리오: 마케터의 도메인 지식 + 개발 능력 조합 어필

📁 문서 구조

01-프로젝트-배경

프로젝트 시작 동기와 기존 시스템의 한계점 분석

• 01-01-프로젝트-동기-및-목표.md
• 01-02-기존-대시보드-문제점-분석.md
• 01-03-학습-목표-및-성과-지표.md
• 01-04-AI-활용-개발-전략.md ⭐ 핵심 차별화 포인트

02-현재상태-분석

기존 Apps Script 시스템 상세 분석

• 02-01-현재-시스템-아키텍처.md
• 02-02-Apps-Script-코드-분석.md
• 02-03-데이터-흐름-및-API-분석.md

03-마이그레이션-계획

단계별 마이그레이션 전략 및 아키텍처 설계

• 03-01-마이그레이션-전략-개요.md
• 03-02-Phase1-Strangler-Fig-패턴.md
• 03-03-목표-마이크로서비스-아키텍처.md

04-구현-가이드

실제 구현을 위한 상세 기술 가이드

• 04-01-GCP-프로젝트-설정.md
• 04-02-Cloud-Functions-구현.md
• 04-03-Firestore-데이터-모델링.md
• 04-04-React-프론트엔드-구현.md

05-운영-최적화

비용 최적화 및 운영 관리 전략

• 05-01-GCP-무료티어-비용-관리.md
• 05-02-모니터링-및-알림-설정.md
• 05-03-성능-최적화-전략.md

🛠 기술 스택 & AI 도구

As-Is (현재 - 마케터도 할 수 있는 수준)

• Backend: Google Apps Script (코드 100줄 정도)
• Database: Google Sheets (엑셀 느낌)
• Frontend: 정적 웹사이트 (GitHub Pages)
• 비용: 완전 무료

To-Be (목표 - AI 도움으로 달성 가능한 수준)

• AI 개발 도구: Gemini CLI + Claude Code (핵심!)
• Backend: Cloud Functions (서버리스, 관리 부담 ↓)
• Database: Cloud Firestore (NoSQL, 확장성 ↑)
• Frontend: React (모던하지만 AI가 대부분 코딩)
• 비용: GCP 무료 티어 (월 $0 목표)

📊 마이그레이션 진행도

Phase 0: 프로젝트 기획 ████████████ 100% ✅
Phase 1: 분석 및 설계   ████████████ 100% ✅  
Phase 2: Strangler Fig  ░░░░░░░░░░░░   0% 🔄
Phase 3: 마이크로서비스 ░░░░░░░░░░░░   0% ⏳
Phase 4: 최적화        ░░░░░░░░░░░░   0% ⏳

🔗 관련 링크

• 기존 스프레드시트 대시보드
• 네이버 검색광고 API 문서
• 네이버 DataLab API 문서

📈 예상 성과 (광고업계 관점)

• 업무 효율성: 키워드 분석 시간 50% 단축 (10초 → 2초)
• 비즈니스 기회: 실시간 트렌드로 광고 타이밍 최적화
• 팀 협업: 광고대행사 팀원들이 무료로 동시 사용 가능
• 비용 절약: 기존 유료 툴 대비 월 $0 (완전 무료 운영)

📝 업데이트 로그

• 2025-11-08: 프로젝트 초기 기획 및 문서 구조 수립
• 2025-11-08: 현재 시스템 분석 및 마이그레이션 계획 수립

프로젝트 관리자: @epicodix
시작일: 2025-11-08
예상 완료: 2025-12-08

작성일: 2025-11-08