전체 프로젝트 개발 계획서

셀러들의 비밀무기 셀러허브 (SellerHub) - 멀티 플랫폼 통합 검색 시스템 개발 단계별 계획

작성일: 2025-12-04

1단계: 기반 인프라 구축 (우선순위: 최우선)

작업	상세 내용	예상 소요	상태
DB 스키마 설계 및 생성	회원 테이블 (members) 검색 이력 테이블 (search_history) 상품 데이터 테이블 (products) 가격 이력 테이블 (product_price_history) 통계 집계 테이블 (product_statistics) 관리자 설정 테이블 (admin_settings) 즐겨찾기 테이블 (favorites) AI 분석 결과 테이블 (ai_analysis) 참고: 플랫폼별_데이터_구조_분석표.html의 실제 데이터 구조를 반영하여 설계	1일	완료
DB 연결 모듈	PDO 기반 DB 연결 모듈 구현 에러 처리 및 로깅 연결 풀 관리 파일: /p7q3w/db/db_connect.php (난수화)	0.5일	완료
인증/권한 모듈	세션 관리 모듈 로그인/로그아웃 함수 회원 승인 체크 함수 유료회원 체크 함수 관리자 권한 체크 함수 파일: /p7q3w/auth/session_manager.php (난수화)	0.5일	완료
CSRF 토큰 모듈	토큰 생성/검증 함수 폼 필드 생성 함수 JSON 응답용 토큰 함수 파일: /p7q3w/util/csrf_token.php (난수화)	0.5일	완료
전역 UI 컴포넌트	모달 팝업 인스턴스 (전역) 토스팅 메시지 인스턴스 (전역) 공통 CSS/JS 파일 파일: /t3n7v/x9k2m/common.css, /j8f2h/x9k2m/common.js (난수화)	1일	완료

2단계: 플랫폼별 검색 모듈 구현 (우선순위: 높음)

플랫폼	작업 내용	난이도	예상 소요	상태
구구스	2단계 API 호출 로직 (GET 쿠키 → POST 검색) JSON 응답 파싱 무한 스크롤 페이지네이션 처리 참고: 플랫폼별_엔드포인트_조사표.html의 구구스 섹션	쉬움	0.5일	완료
머스트잇	세션 쿠키 획득 로직 (메인 페이지 방문) HTML 파싱 로직 개선 (실제 구조 반영) 상품명, 브랜드명, 가격, 이미지 추출 상품 ID 추출 (URL에서 itemNo) 참고: 플랫폼별_데이터_구조_분석표.html의 머스트잇 섹션 파일: /p7q3w/platform/mustit/mustit_platform.php (난수화)	보통	1일	완료
필웨이	JavaScript 코드에서 drawProductList() 함수 파싱 productList 배열에서 g_name, g_price, g_photo 등 추출 EUC-KR 인코딩 처리 (다단계 변환) PHPSESSID 쿠키 관리 참고: 플랫폼별_데이터_구조_분석표.html의 필웨이 섹션 파일: /p7q3w/platform/feelway/feelway_platform.php (난수화)	보통	1일	완료
캉카스	HTML 파싱 (NHN Commerce 구조) goods_view.php?goodsNo= 구조에서 상품 ID 추출 상품명, 가격, 이미지 추출 참고: 플랫폼별_데이터_구조_분석표.html의 캉카스 섹션 파일: /p7q3w/platform/kangkas/kangkas_platform.php (난수화)	보통	0.5일	완료
크림	__NUXT_DATA__ 스크립트 태그 파싱 JSON 데이터에서 상품 정보 추출 일반판매가/보관판매가 분리 추출 참고: 플랫폼별_데이터_구조_분석표.html의 크림 섹션 파일: /p7q3w/platform/kream/kream_platform.php (난수화)	보통	1일	완료
트렌비	내부 API 엔드포인트 분석 (브라우저 개발자 도구) 또는 브라우저 자동화 도구 도입 (Selenium/Puppeteer) React SPA 대응 로직 구현 참고: 플랫폼별_데이터_구조_분석표.html의 트렌비 섹션 주의: React SPA이므로 초기 HTML 파싱 불가, API 또는 자동화 필요	어려움	2~3일	대기
리본즈	내부 API 엔드포인트 분석 (브라우저 개발자 도구) 또는 브라우저 자동화 도구 도입 (Selenium/Puppeteer) React SPA 대응 로직 구현 참고: 플랫폼별_데이터_구조_분석표.html의 리본즈 섹션 주의: React SPA이므로 초기 HTML 파싱 불가, API 또는 자동화 필요	어려움	2~3일	대기
네이버 가격비교	토큰 생성 로직 구현 API 호출 로직 해외직구 제품 필터링 로직 참고: 플랫폼별_엔드포인트_조사표.html - 추후 수집 예정으로 표시됨	미정	미정	대기

3단계: 검색 통합 모듈 구현 (우선순위: 높음)

작업	상세 내용	예상 소요	상태
검색 통합 처리 모듈	키워드 전처리 (공백 제거, 특수문자 처리, 인코딩) 플랫폼별 검색 모듈 병렬 호출 타임아웃 설정 (플랫폼별 최대 5초) 에러 처리 및 재시도 로직 파일: /p7q3w/search/search_integration.php (난수화)	2일	완료
결과 통합 및 정렬	여러 플랫폼 결과 통합 가격순 정렬 플랫폼별 정렬 인기순 정렬 (판매량, 찜 수 기준) 평균가격 계산 (동일 상품이 여러 플랫폼에 있을 경우) 파일: /p7q3w/search/result_integration.php (난수화)	1일	완료
캐싱 시스템	동일 키워드 검색 결과 캐싱 (10분) 캐시 키 생성 로직 캐시 무효화 로직 파일: /p7q3w/util/cache_manager.php (난수화)	0.5일	완료

4단계: 사용자 페이지 구현 (우선순위: 높음)

페이지	파일명	주요 기능	예상 소요	상태
로그인 페이지	login.php	아이디/비밀번호 입력 CSRF 토큰 적용 AJAX 로그인 처리 에러 메시지 표시 (토스팅)	0.5일	완료
회원가입 페이지	register.php	아이디 중복체크 (실시간 또는 버튼 클릭) 비밀번호 입력 (1개 텍스트박스, 눈 모양 버튼으로 마스킹 토글) 전화번호, 이메일(선택), 가입경로 입력 플레이스홀더 방식 CSRF 토큰 적용 신규가입 시 텔레그램 알림 발송	1일	완료
메인 페이지	home.php	검색 입력창 최근 검색어 표시 인기 검색어 표시 AI 추천 브랜드/모델명 표시 사이드바 포함	1일	완료
검색 결과 페이지	search.php	통합 검색 결과 표시 플랫폼별 필터 정렬 옵션 (가격순, 인기순, 최근 뜨는 순 등) 평균가격 표시 판매량 정보 표시 유사 상품 추천 섹션 상품 카드 그리드 레이아웃 (PC: 4열, 모바일: 2~3열)	2일	완료
브랜드 인기상품 페이지	brand.php	브랜드명 입력 플랫폼별 브랜드 인기상품 조회 필터: 잘 판매되는/최근 뜨는/꾸준한 스테디셀러 브랜드별 평균가격, 최저가, 최고가 표시	1.5일	완료
트렌드 분석 페이지	trend.php	AI 기반 최신 뜨는 브랜드 표시 검색량 증가 분석 결과 표시 트렌드 예측 정보 표시 기간별 필터 (2025년 하반기 ~ 오늘 등)	1.5일	완료
마이페이지	mypage.php	회원정보 조회/변경 결제 플랜 정보 표시 이용 기간 표시 (시작일, 종료일, 남은 기간) 최근 분석 내역 (검색 이력, 즐겨찾기)	1일	완료
사이드바	/m4p8q/sidebar.php (난수화)	네비게이션 메뉴 사용자 정보 표시 로그아웃 버튼 PC: 좌측 고정, 모바일: 슬라이드 인	1일	완료

5단계: 관리자 페이지 구현 (우선순위: 중간)

페이지/기능	파일명	주요 기능	예상 소요	상태
관리자 메인	/a5d9k/x9k2m/admin_main.php (난수화)	대시보드 (회원 수, 검색 통계 등) 플랫폼 연동 상태 확인	1일	완료
회원 관리	/a5d9k/x9k2m/member_manage.php (난수화)	회원 목록 조회 승인/거절/정지 상태 변경 유료회원 승인/기간 설정 회원 검색/필터	1.5일	완료
검색 통계	/a5d9k/x9k2m/search_stats.php (난수화)	검색 빈도 통계 인기 키워드 표시 플랫폼별 검색 통계 기간별 통계	1일	완료
AI/텔레그램 설정	/a5d9k/x9k2m/settings.php (난수화)	AI 모델 선택 (GPT/제미나이) API 키 입력/수정/저장 (암호화 저장) 텔레그램 봇 토큰 입력/수정 챗ID 추출 기능 테스트 메시지 발송 기능	1.5일	완료
관리자 사이드바	/a5d9k/m4p8q/admin_sidebar.php (난수화)	관리자 전용 네비게이션 메뉴 일반 사용자 사이드바와 완전 분리	0.5일	완료

6단계: AI 연동 및 고급 기능 (우선순위: 중간)

기능	상세 내용	예상 소요	상태
AI 분석 모듈	GPT/제미나이 API 연동 최신 뜨는 브랜드 분석 검색량 증가 분석 (2025년 하반기 ~ 오늘) 트렌드 예측 분석 결과 DB 저장 파일: /p7q3w/ai/trend_analysis.php (난수화)	2일	대기
유사 상품 추천	카테고리 기반 유사 상품 추천 모델명 기반 유사 상품 추천 가격대별 유사 상품 추천 파일: /p7q3w/search/product_recommendation.php (난수화)	1.5일	대기
텔레그램 알림 모듈	회원 신규가입 알림 발송 알림 메시지 포맷팅 에러 처리 및 재시도 파일: /p7q3w/telegram/notification.php (난수화)	1일	대기

7단계: UI/UX 구현 (우선순위: 높음)

작업	상세 내용	예상 소요	상태
공통 CSS	고급 화이트 부티크 미래지향 테마 적용 Bootstrap 활용 반응형 브레이크포인트 (1200px 이상 PC, 992px~1199px 태블릿, 768px~991px 큰폰, 576px~767px 중간폰, 575px 이하 작은폰) 모바일: 1열 2~3그리드 가로 배치 파일: /t3n7v/x9k2m/common.css (난수화)	2일	완료
페이지별 CSS	각 페이지별 PC용 CSS (의미있는 파일명: home.css, search.css 등) 각 페이지별 모바일 CSS (의미있는 파일명: home_mobile.css 등) 고유 클래스명 사용 (페이지 간 충돌 방지) 폴더: /t3n7v/p7w1s/ (PC), /t3n7v/k5m9r/ (모바일) - 난수화	3일	완료
페이지별 JS	각 페이지별 JS (의미있는 파일명: home.js, search.js 등) 난독화 스타일 (의미 없는 변수명/함수명) 주석 절대 금지 AJAX 통신 처리 폴더: /j8f2h/p7w1s/ (난수화)	2일	완료

8단계: 테스트 및 최적화 (우선순위: 중간)

작업	상세 내용	예상 소요	상태
통합 테스트	전체 플로우 테스트 (회원가입 → 승인 → 로그인 → 검색) 플랫폼별 검색 테스트 에러 케이스 테스트	2일	대기
성능 최적화	병렬 처리 최적화 캐싱 전략 개선 DB 쿼리 최적화 이미지 로딩 최적화	1.5일	대기
보안 검증	CSRF 토큰 검증 테스트 SQL Injection 방어 테스트 XSS 방어 테스트 권한 체크 테스트	1일	대기

개발 일정 요약

단계	예상 소요일	누적 일수	우선순위
1단계: 기반 인프라 구축	3일	3일	최우선
2단계: 플랫폼별 검색 모듈 구현	8~10일	11~13일	높음
3단계: 검색 통합 모듈 구현	3.5일	14.5~16.5일	높음
4단계: 사용자 페이지 구현	9일	23.5~25.5일	높음
5단계: 관리자 페이지 구현	5.5일	29~31일	중간
6단계: AI 연동 및 고급 기능	4.5일	33.5~35.5일	중간
7단계: UI/UX 구현	7일	40.5~42.5일	높음
8단계: 테스트 및 최적화	4.5일	45~47일	중간

우선 개발 순서 (MVP 기준)

1. 1단계: 기반 인프라 구축 (필수)
2. 2단계: 플랫폼별 검색 모듈 (구구스, 머스트잇, 필웨이, 캉카스, 크림 우선) - 트렌비/리본즈는 후순위
3. 3단계: 검색 통합 모듈 (필수)
4. 4단계: 사용자 페이지 (로그인, 회원가입, 메인, 검색 결과 우선)
5. 7단계: UI/UX 구현 (공통 CSS, 기본 레이아웃 우선)
6. 5단계: 관리자 페이지 (회원 관리, AI/텔레그램 설정 우선)
7. 6단계: AI 연동 (기본 분석 기능 우선)
8. 8단계: 테스트 및 최적화

주의사항 및 리스크

다음 즉시 시작 가능한 작업

1. 6단계: AI 연동 및 고급 기능 - AI 분석 모듈, 유사 상품 추천, 텔레그램 알림 모듈
2. 8단계: 테스트 및 최적화 - 통합 테스트, 성능 최적화, 보안 검증
3. 트렌비/리본즈 플랫폼 모듈 - React SPA 대응 (브라우저 자동화 또는 내부 API 분석 필요)