====== 모니터링 & 리포트 개요 ======

브라이즈에서 사용하는 각종 모니터링/리포트 체계를 회사 관점에서 정리하는 문서입니다. (초안)

  * 데이터 소스/지표 개요 (매출, 광고, 키워드 등)
  * 일일/주간/월간 리포트 구조와 역할
  * 자동 이슈 탐지(알림) 구조 개요
  * 사용 중인 대시보드/보고 채널 요약 (예: GChat, 이메일, 문서 등)

세부 규칙 및 SQL, 대시보드 링크 등은 추후 개별 문서로 분리/링크합니다.

===== 1. 데일리 트래킹 시스템 =====

데일리 트래킹은 주요 채널(쿠팡 1P/2P, 네이버 스마트스토어, 카페24 등)의 **전일 실적 데이터를 매일 수집**하여,
공통 포맷의 시트·리포트로 통합하는 작업입니다.

기준 문서: BRYZE 드라이브 → ☆회사 → ★Data → 데일리 트래킹 → `데일리 트래킹 업무 프로세스.pptx`
(텍스트 추출본: `daily_tracking_process.txt`)

==== 1.1 쿠팡 1P (Sales / 광고) ====

  * 데이터 소스
    * SUPPLIER HUB 대시보드 (쿠팡 1P)에서 전일자 지표 다운로드
    * 주요 지표: 클릭수(PV), 구매수(주문건수), 프로모션쿠폰비(즉시 할인가), 프로모션발생판매수량(구매수(프)) 등
  * 로컬 파일 경로
    * `\\udm\BR\★Data\데일리 트래킹\APRICE 쿠팡\1P`
  * 작업 흐름 (요약)
    1. SUPPLIER HUB에서 전일자 기준 CSV/XLS 다운로드 (파일명 예: `daily_performance_YYYYMMDDYYYYMMDD`).
    2. 브랜드 필터(예: 아쿠아픽 등)로 불필요 브랜드 행 삭제 후 저장.
    3. `25년_쿠팡전체파트` 엑셀 열기 → `RAW` 시트에 값 붙여넣기(Ctrl+Shift+V).
    4. 피벗테이블 시트 새로고침 → 날짜 필터를 전일자로 설정.
    5. 피벗 결과를 `텍스트` 시트에 값 붙여넣기 → `브이룩업` 시트 확인 → `가로나열` 시트에 행/열 바꿔 붙여넣기.
    6. 최종 정리된 값은 구글 시트(쿠팡 1P Sales 대시보드)에 입력.
  * 광고 파트(쿠팡 광고 데이터)
    * 광고 대시보드에서 클릭수(광), 구매수(광), SA(광) 등 광고 지표를 별도 파일로 다운로드.
    * `25년_쿠팡광고파트` 파일의 `RAW` 시트에 붙여넣고, 오류(#N/A) 발생 시 SKU ID 시트를 갱신.
    * 이후 절차는 전체 파트와 동일하게 피벗/텍스트/브이룩업/가로나열 순으로 정리 후 구글 시트 입력.

※ SUPPLIER HUB 및 쿠팡 광고 계정의 구체적인 ID/PW는 보안상 위키에 적지 않고, 별도 비밀번호 관리 문서에서 관리합니다.

==== 1.2 네이버 스마트스토어 (오가닉 / AD) ====

  * Sales / 오가닉 트래픽
    * 구글 시트 예: `네이버 스마트스토어 Sales` (닥터시드/딸로/테르스 탭)
    * 아이템스카우트(https://itemscout.io)에서 상품별 **키워드 순위**를 조회해 구글 시트에 입력.
      * 상품명은 구글 시트와 아이템스카우트 결과를 일치시켜 관리 (사이트에서 변경된 상품명은 시트에 반영).
    * 네이버 스마트스토어 BizAdvisor에서 **유입검색어, 결제검색어, 클릭수, 매출** 데이터를 전일 기준으로 조회.
    * 로컬 경로: `\\udm\BR\★Data\데일리 트래킹\스마트스토어\유입,결제키워드,노출수,매출`
      * `[네이버오가닉판매결과]` 파일의 `통계_마케팅분석_상품노출성과` 시트에 붙여넣기.
      * 같은 파일의 `통계_판매분석_상품_검색채널` 시트에도 전일자 데이터를 붙여넣기.
    * 내부 자동화 프로그램(`main` / `output` 파일)을 실행해 정제된 값을 생성 후, 구글 시트에 최종 값 붙여넣기.
      * 프로그램 오류 시, 원본 파일 1열 형식이 그대로 복사·붙여넣기 되었는지 확인.

  * AD(광고) 데이터
    * 네이버 검색광고 플랫폼(https://searchad.naver.com)에서 브랜드별 계정으로 로그인.
    * 다차원 보고서에서 **노출수, 클릭수, 구매수(전환수), 매출(전환매출), 광고비(총비용)** 등을 전일 기준으로 다운로드.
    * 로컬 경로: `\\udm\BR\★Data\데일리 트래킹\스마트스토어\AD 데이터`
    * 구글 시트 `네이버 스마트스토어 AD` 탭에 지표를 매일 입력.

※ 네이버/아이템스카우트 계정의 상세 로그인 정보(ID/PW)는 위키에 기재하지 않고, 계정 관리 문서를 통해서만 공유합니다.

==== 1.3 그 외 채널 (쿠팡 2P, 카페24 등) ====

  * 쿠팡 2P / 카페24 / 기타 채널도 동일하게 **전일자 기준 데이터를 지정된 대시보드에서 다운로드** 후,
    공통 포맷의 데일리 트래킹 시트에 입력합니다.
  * 채널별 세부 절차와 파일 경로는 데일리 트래킹 pptx 및 각 팀별 서브 문서에서 관리합니다.

===== 2. 리포트 주기 및 활용 =====

  * **일일 리포트**: 전일 실적(매출, 광고비, ROAS, 주요 키워드/지표)을 집계해 브랜드/채널별로 모니터링.
  * **주간/월간 리포트**: 일일 데이터 누적 시트를 기반으로, 추세·이상치·캠페인 성과를 요약해 공유.
  * **자동 알림**: 향후 특정 임계값(매출 급락, 광고비 급증 등)을 기준으로 GChat/이메일 알림을 붙이는 것을 목표로 함.

---

※ 이 문서는 데일리 트래킹 pptx 기준 요약이며, 실제 화면·예시는 Drive 원문을 함께 참조해야 합니다.

===== 3. 연휴/특수 기간 자동화 & 리포트 설계 (설 연휴 2026 사례) =====

2026년 설 연휴 기간(2026-02-14~02-18)에는 평소와 다른 **DM 응답·매출 로그·리포트 설계** 작업이 진행되었습니다.
(근거 문서: `/holiday-reports/summary-2026-02-14-18.md`)

==== 3.1 크론 / 자동화 작업 구조 ====

  * **DM handler (5분 간격)**
    * 대상: `sw.ma@bryze.kr` 계정의 모든 DIRECT_MESSAGE
    * 로직: `lastProcessed` 이후 "상대가 마지막으로 말했고 내가 답 안 한" DM들을 찾아 자동 응답
    * 상태 관리: `chat-state.json`에 마지막 처리 시점 및 DM 상태를 저장

  * **일일 매출 보고 기록 (2시간 간격)**
    * 대상 채널: `★일일 매출 보고` 스페이스
    * 저장 위치: `/sales-daily/YYYY-MM-DD.md`
    * 포맷: `- HH:MM 이름: 내용`
    * 활용: 브랜드/채널별 매출 요약, 일자별 로그를 기반으로 한 주간/월간 리포트의 원천 데이터

  * **holiday:design-work-daily (1일 1회)**
    * 목적: 리포트 템플릿, 이슈 탐지 룰, AI 활용 전략 등 **설계 작업**을 하루 1회씩 진행
    * 로그: `/holiday-reports/design-work-YYYY-MM-DD.md`에 작업 내용 기록

  * **holiday:final-summary-email (원샷)**
    * 설 연휴 기간 동안의 작업 결과를 모아 **2/19 09:30 KST**에 메일 보고

==== 3.2 DM 운영 전략 ====

  * 5분 주기 DM 순회를 통해 미응답 DM을 0건으로 유지하는 것을 목표로 함.
  * `chat-state.json`의 `lastProcessed` 이후 타임라인만 확인하여, 중복 응답 방지.
  * 신규 DM에 대해서는 최근 5개 메시지를 기준으로 초기 응답 템플릿을 설계.

==== 3.3 일일 매출 로그 구조 ====

  * `★일일 매출 보고` 스페이스에서 올라오는 메시지를 **로컬 마크다운 파일**로 누적.
  * 구조 예시 (`/sales-daily/2026-02-15.md`):

    - 09:05 홍길동: 닥터시드 네이버 매출 XX만원
    - 11:30 안지철: 쿠팡 2P 매출 YY만원

  * 이후 브랜드/채널별 집계를 만들거나, 특정 날짜/시간대별 패턴 분석의 기준 데이터로 활용.

==== 3.4 리포트 템플릿 / 이슈 탐지 룰 (초안) ====

  * **리포트 템플릿 설계**
    * 일일/주간/월간 리포트에 대해 **경영진 / 브랜드 / 실무자** 3단 구조 정의
    * 채널×브랜드 매트릭스, 목표 대비 / 전주·전년 대비 비교 뷰 설계
    * 템플릿 파일 (예정)
      * `notes/daily-report-template.md`
      * `notes/weekly-report-template.md`
      * `notes/monthly-report-template.md`

  * **이슈 탐지 룰 (초안)**
    * ROAS/매출 급변, 퍼널 이상치 조건 정의 예:
      * 최근 7일 평균 대비 ROAS -30% 이하
      * 전주 같은 요일 대비 매출 -40% 이하
    * 향후 실제 테이블 기준 SQL/뷰(`issue_*.sql`)로 표준 쿼리화 예정

==== 3.5 AI(홍길동) 활용 전략 ====

  * 일일/주간 리포트 **자동 초안 생성 후 사람 검토** 플로우 설계
  * 회의 전·후 자료 리마인드 및 액션 아이템을 DM/메일로 전달
  * 분석 질문(예: "콜라겐 매출 왜 떨어졌어?")에 대한 표준 응답 플로우 설계
  * 전략 문서(예정): `notes/honggildong-strategy.md`

==== 3.6 메일 보고 ====

  * 2026-02-17 기준, `[중간보고] 설 연휴 작업 진행 현황 정리` 메일 발송 (발신: sw.ma → 수신: sy.yun)

---

※ 이 섹션은 설 연휴(특수 기간) 동안의 모니터링/자동화 구조를 정리한 예시이며,
향후 다른 연휴/프로모션 기간에도 유사한 구조로 확장할 수 있습니다.