o2o-infinith-demo/docs/reports
Haewon Kam 8776a15183 feat(ga4): AI 유입 트래픽 연동 뼈대 + 리포트 "측정 가능 범위" 절
2026-09-08 작업분. GA4 에서 AI 답변엔진 유입을 채널로 갈라 보는 뼈대를 세웠다.

- data/ai_channels.json: AI 답변엔진 리퍼러 목록(채널 그룹 정의의 근거)
- scripts/ga4_ai_traffic.py: GA4 Data API 로 AI 유입을 뽑는 러너. --mock 으로 합성
  데이터 검증까지 마쳤다. 실제 속성 연결은 GCP 계정이 정해진 뒤다
- supporters/src/layouts/Base.astro + 템플릿 site.json 2곳: ga4MeasurementId 태그.
  쿠키 고지 배너 결정 전까지 미리보기에는 ID 를 넣지 않는다
- scripts/build_discovery_report.ts: Integrity 절에 "측정 가능 범위" 를 넣어
  무엇을 재고 무엇을 못 재는지 리포트가 스스로 밝히게 했다
- 원진 진단 리포트 v2.1(HTML·PDF) 재생성분

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 10:53:54 +09:00
..
ibk chore(reports): docs/reports를 고객·단계별 폴더로 분류 2026-09-07 13:03:53 +09:00
landing chore(reports): docs/reports를 고객·단계별 폴더로 분류 2026-09-07 13:03:53 +09:00
taeha chore(reports): docs/reports를 고객·단계별 폴더로 분류 2026-09-07 13:03:53 +09:00
viewclinic docs: v2 §11-9 — haewon 결정 4건 반영, 원진성형외과 E2E 완주(6/6편, 게이트 0오류, supporters-wonjin.vercel.app) 2026-09-07 19:25:34 +09:00
wonjin/01_readiness_report feat(ga4): AI 유입 트래픽 연동 뼈대 + 리포트 "측정 가능 범위" 절 2026-09-09 10:53:54 +09:00
README.md chore(reports): docs/reports를 고객·단계별 폴더로 분류 2026-09-07 13:03:53 +09:00

docs/reports 폴더 안내

2026-09-07 분류. 산출물은 고객(병원)별 폴더 아래 산출 단계 순서로 둔다. 빌드 스크립트는 산출물과 같은 폴더에 둔다.

docs/reports/
├── viewclinic/                      뷰성형외과
│   ├── 01_readiness_report/         AI Answer Readiness 진단 덱 (v1.0 정본 · v2_표준캔버스 · v1.1 정정판) + 빌더
│   ├── 02_poc_proposal/             POC 제안서 덱 (정본 · v3 · v3_표준캔버스) + 빌더
│   ├── 03_question_bank/            질문 뱅크 120문항 · ChatGPT/Perplexity 실측 결과 · TOP50 엑셀
│   └── 04_supporters/               서포터즈 GEO 개선 계획 · 2단계 콘텐츠 기획 · 서포터즈 vs 공식 AEO 감사 엑셀
├── taeha/                           태하 AI Answer Readiness 리포트 (html · pdf · pptx) + 빌더
├── ibk/                             기업은행 블로그 AEO/GEO 감사
└── landing/                         AI Discovery 랜딩 시안 (픽셀 정답 HTML) · 스크린샷 · 리포트 페이지 HTML 내보내기 스크립트

정본과 파생본

  • Viewclinic_AI_Answer_Readiness_Report.pptx: v1.0 정본. haewon이 폰트를 직접 손본 파일이라 재생성하지 않는다.
  • Viewclinic_AI_Answer_Readiness_Report_v1.1.pptx: 2026-09-07 재검증 정정판. 블로그·FAQ·수치 판정 3건 정정, 병원 요청 슬라이드 추가. 빌더 build_viewclinic_deck_v1_1.py.
  • Viewclinic_POC_Proposal.pptx: POC 제안서 정본(haewon 수정본). v3 계열은 폰트 기준 적용 파생본.
  • *_표준캔버스.pptx: 20in 캔버스를 2/3로 균등 축소한 13.33in 편집용. scripts/rescale_deck.py로 만든다.

빌드

# 진단 덱 v1.1
python3 docs/reports/viewclinic/01_readiness_report/build_viewclinic_deck_v1_1.py docs/reports/viewclinic/01_readiness_report/Viewclinic_AI_Answer_Readiness_Report_v1.1.pptx
# 표준캔버스 축소본
python3 scripts/rescale_deck.py <in.pptx> <out_표준캔버스.pptx>
# PDF
soffice --headless --convert-to pdf <file.pptx>
# 질문 뱅크 실측 → 통합 → 엑셀 (출력 경로는 스크립트 안에 03_question_bank로 고정)
python3 scripts/run_question_bank_openai.py && python3 scripts/merge_qb_results.py && python3 scripts/export_qb_excel.py

다른 문서에서의 참조

docs/AI_DISCOVERY_FRONTEND_HANDOVER.md, docs/AI_DISCOVERY_BUILD2_HANDOVER.md, docs/AEO_GEO_RUBRIC.md, docs/NEXT_SESSION_SUPPORTERS_AUTOBUILD.md와 src/pages/DiscoveryLandingPage.tsx 주석이 이 폴더를 가리킨다. 파일을 옮기면 그 참조도 같이 고친다.