diff --git a/docs/HANDOVER_2026-09-18.md b/docs/HANDOVER_2026-09-18.md new file mode 100644 index 0000000..3df5699 --- /dev/null +++ b/docs/HANDOVER_2026-09-18.md @@ -0,0 +1,171 @@ +# 핸드오버 · 2026-09-18 (금) + +다음 작업은 2026-09-19(토) 또는 다음 주. 이 문서 하나만 읽으면 이어서 할 수 있게 적는다. + +--- + +## 0. 오늘 한 일 한 줄 + +랜딩에서 들어온 JK성형외과 신청을 자동 빌드로 완주시키고, 그 과정에서 드러난 파이프라인 결함 6건을 고쳤다. 그리고 진단 리포트에서 사이트 빌드까지 이어지는 제품 화면을 새로 만들었다. + +--- + +## 1. 지금 상태 + +### 저장소 두 곳, 커밋 완료 + +**Productize-2** (`main`) · 프런트엔드 +``` +f38c0f3 feat(front): 진단 요약과 보완 계획을 보여 준 뒤 빌드하게 한다 +14c4b82 refactor(design): 요청문과 설명문을 텍스트 역할 토큰으로 가른다 +be1ea72 feat(front): 진단 리포트에서 사이트 빌드로 이어지는 화면 +74c70d6 docs(design): 신청 접수 알림과 완료 안내 메일 설계 v0.1 +5cf28d9 feat(front): 병원이 사이트에 실을 사진을 한 장씩 고르는 화면 +``` + +**Productize** (`feature/supporters-autobuild`) · 파이프라인 +``` +1eb166e fix(worker): 병원 입력을 큐 빌드에서도 반영하고, 이미지 확인 결과를 사이트에 적용한다 +fa48d43 fix(supporters): 의료진 목록 페이지를 사람별로 나누고 지번 주소도 좌표로 바꾼다 +``` + +**푸시하지 않았다.** 두 저장소 모두 로컬에만 있다. + +`f38c0f3` 은 haewon 육안 확인 전에 커밋했다. 퇴근 시점에 작업 트리를 비워 두려고 먼저 넣은 것이라, 마음에 안 들면 `git reset --soft HEAD~1` 로 되돌리면 된다. + +### 추적하지 않는 파일 2개 + +`scripts/out/naver_briefing_summary.json`, `scripts/out/sentiment_summary.json` 는 09-15 측정 산출물이고 오늘 세션 것이 아니라 그대로 뒀다. 주간보고가 이 파일을 근거로 인용하므로 보고서를 공유할 계획이면 같이 커밋해야 한다. + +### 배포 + +| 대상 | 주소 | 상태 | +|---|---|---| +| JK성형외과 서포터즈 | https://supporters-jkplastic.vercel.app | 배포됨 · noindex · 의료진 9명·주변 안내 123곳 반영 | +| 프런트엔드 | 배포 안 함 | 오늘 만든 화면은 로컬에만 있다 | + +--- + +## 2. 오늘 고친 파이프라인 결함 6건 + +| # | 결함 | 상태 | +|---|---|---| +| 1 | 의료진 목록 페이지를 사람별로 못 나눔. 9명이 "과전문의"라는 없는 사람 1명으로 합쳐짐 | 고침 | +| 2 | 지번 주소를 좌표로 못 바꿔 주변 안내 전체가 빔 | 고침 | +| 3 | 글이 예전 의료진 id를 들고 있으면 astro build 중단 | 고침 | +| 4 | `--deploy` 없는 부분 재실행이 `preview_url` 을 지움 | 고침 | +| 5 | 큐 워커가 `--from-supabase` 를 안 넘겨 **병원 입력이 하나도 반영되지 않던 것** | 고침 | +| 6 | 이미지 수집 개수 중복 계산 (36장을 51장으로 보고) | 고침 | + +**수정 효과 (JK 재실행 실측)** + +| 항목 | 전 | 후 | +|---|---|---| +| 의료진 | 1명 (가짜 이름) | 9명 (실명·직함·약력 분리) | +| 수집 뉴스 | 958건 | 1,165건 (기고·인터뷰 217 → 387) | +| 주변 안내 | 0곳 | 국문 123곳 · 영문 108곳 | + +--- + +## 3. 오늘 만든 화면 + +``` +/discovery/:id 진단 리포트 → [이대로 빌드하기] +/build/:id 빌드 진행 (5단계, supporter_builds 폴링) +/images/:id 사진 확인 (한 장씩 사용/빼기) +/supporters/:id 확인 항목 입력 (기존) +``` + +**새 파일** +``` +src/pages/SiteBuildPage.tsx 빌드 진행 화면 +src/pages/ImageReviewPage.tsx 사진 확인 화면 +src/components/discovery/ImageReviewPanel.tsx 사진 확인 본체 +src/components/discovery/BuildPlanSection.tsx 진단 요약 → 보완 계획 → 빌드 +src/components/ClinicNav.tsx 4단계 절차 상단 메뉴 + 이전 단계 플로팅 버튼 +src/lib/buildPhases.ts 워커 17단계 → 고객용 5묶음 +src/lib/buildCoverage.ts 빌드가 보완하는 카테고리 선정 +``` + +**설계상 지켜야 할 것 두 가지** + +1. **빌드는 병원 홈페이지를 고치지 않는다.** 진단의 실행 항목은 단 하나도 빌드로 해결되지 않는다. 화면에서 "실행 항목 N건 해결"로 쓰면 지키지 못할 약속이 된다. 오늘 한 번 그렇게 만들었다가 고쳤다. +2. **"결과"라는 말을 쓰지 않는다.** 빌드가 끝나도 사진 확인과 확인 항목이 남아 최종이 아니다. + +**텍스트 역할 토큰** (`src/index.css`) +``` +.ui-ask 요청문 (17px·600·인디고) · .ui-ask-block 은 왼쪽 규칙선 +.ui-body 설명 본문 (16px·slate-600) +.ui-note 보조·출처 (14px·slate-400) +.on-dark / .on-light 다크 섹션과 그 안의 흰 카드 +.btn-on-dark 다크 섹션 위 주 버튼 (기본 CTA 그라디언트는 흰 배경 전용) +``` + +--- + +## 4. 바로 이어서 할 수 있는 것 + +### 4-1. haewon 육안 확인 (최우선) + +`f38c0f3` 의 화면을 아직 안 보셨다. 확인할 것: + +- `/discovery/viewclinic` 하단 **What We Will Fix** 섹션의 문구와 버튼 대비 +- 네 화면 오가며 **이전 단계 플로팅 버튼** (왼쪽 아래) +- `/images/jkplastic` 썸네일 줄 + +```bash +cd ~/orca/workspaces/INFINITH/Productize-2 && npm run dev # 포트 3000 사용 중이면 자동으로 다음 포트 +``` + +### 4-2. 분석 리포트의 남은 요소 흡수 (오늘 하던 것) + +haewon이 고른 방향은 **"분석 리포트의 좋은 부분을 진단으로 흡수"** 였다. 채널 점수 링·로드맵 타임라인·KPI 세 가지 중 아직 하나도 안 옮겼다. 중간에 "OK 버튼" 이야기로 방향이 틀어져 `BuildPlanSection` 을 먼저 만들었다. + +| 요소 | 기존 컴포넌트 | 데이터 | +|---|---|---| +| 채널 건강도 링 | `src/components/report/ChannelOverview.tsx` | `supporter_builds.report.channels` 에 실제 발견 채널이 있다 | +| 로드맵 타임라인 | `src/components/report/RoadmapTimeline.tsx` | `result.actions` 의 P0/P1/P2 + effort 로 시간축을 만들 수 있다 | +| KPI 대시보드 | `src/components/report/KPIDashboard.tsx` | **데이터 없음.** 목표치를 지어내면 안 된다. 재측정 기준으로 바꾸는 편이 맞다 | + +로드맵이 가장 쉽고 값이 크다. 데이터가 이미 있고 진단의 Action Plan에 시간축만 없다. + +### 4-3. 분석 리포트 자체의 결함 (옮기든 안 옮기든 남는 문제) + +`/report/:id` 를 바노바기 리포트로 열어 확인한 것: +- 히어로가 비어 있다. 첫 화면에 그라디언트만 크게 깔리고 제목·병원명이 없다 +- `데이터 없음 (NaN년)`. 개원 연도 계산이 깨져 NaN이 화면에 나온다 +- 섹션 사이 여백이 화면 하나 가까이 된다 + +--- + +## 5. 결정 대기 (haewon) + +### 5-1. 메일 (설계 끝, 결정 필요) + +`docs/DESIGN_신청알림메일_v0.1.md` §8 + +1. **발송 서비스**: Resend 추천. 계정과 발신 도메인(`o2o.kr` 하위 무엇으로) +2. **운영자 알림 수신 주소**: 개인인지 공용인지 +3. **완료 안내를 사람이 보내는 방식으로 확정할지** +4. **"리포트"의 정의**: 가장 큰 건. 랜딩은 AEO/GEO 진단 리포트를 약속하는데 파이프라인은 서포터즈 사이트를 만든다. 메일 문안을 쓰려면 이걸 먼저 정해야 한다 + +### 5-2. 진단 데이터가 3곳뿐 + +`DISCOVERY_RESULTS` 에 viewclinic·taeha·wonjin 만 있다. JK처럼 빌드만 한 병원은 `/discovery/:id` 에서 **No Audit Yet** 화면을 본다(오늘 만들었다). 진단은 36항목 실측이라 자동으로 안 따라온다. 자동화 범위를 어디까지 잡을지 별도 과제. + +### 5-3. 기타 + +- `clinicDoctors` 4명 고정. JK는 9명인데 소개 페이지에 4명만 나온다 +- planner가 주변 안내 좌표를 받고도 범용 기본표를 쓴다 +- 뷰 의료진 id 두 벌 (`dr-cho` 수작업 10개 vs `dr-chojinwoo` 자동 27개). 뷰 재빌드 때 한쪽으로 모아야 한다 +- `check.mjs --update-layout` 으로 레이아웃 기준선 생성 + +--- + +## 6. 알아 두면 시간 아끼는 것 + +- **빌드는 백그라운드로 돌리고 다른 작업을 같이 한다.** `nohup node workers/supporters-build/run.mjs ... &` 로 띄우고 로그를 감시한다. 오늘 내내 그렇게 했다. +- **같은 병원 빌드를 동시에 두 개 돌리면 안 된다.** 작업 폴더(`~/supporters-builds/-/`)를 공유해 서로 덮어쓴다. +- **부분 재실행은 `--from <단계>`.** 글은 `--regenerate` 없으면 보존되어 생성 비용이 0이다. +- **워커는 Productize 워크트리에서 돈다.** Productize-2 가 아니다. launchd 폴러 `com.infinith.supporters-poll`, 로그 `~/supporters-builds/poll.log`. +- **주간보고는 gitignore 처리했다** (`docs/*주간보고*`). 개인 문서라 저장소에 올리지 않는다. diff --git a/docs/NEXT_SESSION_2026-09-19.md b/docs/NEXT_SESSION_2026-09-19.md new file mode 100644 index 0000000..cd8206b --- /dev/null +++ b/docs/NEXT_SESSION_2026-09-19.md @@ -0,0 +1,82 @@ +# 다음 세션 프롬프트 · 2026-09-19 이후 + +아래 §0 을 그대로 복사해 새 세션 첫 메시지로 넣으면 된다. + +--- + +## §0. 복사해서 붙일 프롬프트 + +``` +INFINITH AI Discovery 제품 개발을 이어서 한다. + +작업 폴더: ~/orca/workspaces/INFINITH/Productize-2 (main) +파이프라인: ~/orca/workspaces/INFINITH/Productize (feature/supporters-autobuild) + +시작하기 전에 읽어라: + docs/HANDOVER_2026-09-18.md 어제까지의 상태와 결정 대기 목록 + docs/DESIGN_신청알림메일_v0.1.md 메일 설계 (결정 대기 4건은 §8) + +두 저장소 모두 커밋은 되어 있고 푸시는 안 했다. 시작할 때 git status 와 +다른 세션이 같은 폴더를 열고 있지 않은지 먼저 확인해라. + +오늘 할 일은 아래에서 고른다. 1번을 먼저 하고, 내가 확인해 준 뒤 2번으로 간다. + +1. 어제 만든 화면 육안 확인 + npm run dev 로 띄우고 /discovery/viewclinic, /build/jkplastic, + /images/jkplastic 를 열어 둬라. 내가 본다. + 특히 볼 것: What We Will Fix 섹션 문구·버튼 대비, 왼쪽 아래 이전 단계 버튼, + 사진 확인 썸네일 줄. + +2. 분석 리포트(/report/:id)의 로드맵 타임라인을 진단 리포트로 옮긴다 + 진단의 Action Plan 은 P0/P1/P2 목록만 있고 시간축이 없다. + 기존 RoadmapTimeline 컴포넌트와 result.actions 의 effort 값을 쓴다. + 데이터를 지어내지 마라. 없는 값은 확인 대기로 둔다. + +지켜야 할 것: +- 서포터즈 빌드는 병원 홈페이지를 고치지 않는다. 진단 실행 항목이 + 빌드로 해결된다고 화면에 쓰지 마라. +- 고객 화면에 "결과"라는 말을 쓰지 마라. 빌드가 끝나도 사진 확인과 + 확인 항목이 남아 최종이 아니다. +- 텍스트는 src/index.css 의 .ui-ask / .ui-body / .ui-note 역할 토큰을 쓴다. + 다크 섹션은 .on-dark, 그 안의 흰 카드는 .on-light, 버튼은 .btn-on-dark. +- 프로덕션 배포(vercel --prod, 병원 사이트)는 내 확인을 받고 실행한다. +``` + +--- + +## §1. 선택지 (위 프롬프트에서 2번 대신 고를 수 있는 것) + +우선순위순이 아니라 성격순이다. 무엇을 할지는 haewon이 정한다. + +### A. 분석 리포트 요소 흡수 (어제 정한 방향) + +| 요소 | 난이도 | 비고 | +|---|---|---| +| 로드맵 타임라인 | 낮음 | 데이터가 이미 있다. 가장 값이 크다 | +| 채널 건강도 링 | 중간 | `supporter_builds.report.channels` 를 쓴다 | +| KPI 대시보드 | 보류 | 목표치 데이터가 없다. 지어내지 말고 재측정 기준으로 바꾸는 편이 맞다 | + +### B. 메일 붙이기 + +결정 4건(설계 §8)이 먼저다. 다만 **순서 4번(모달 문구 수정)은 계정 없이 지금 할 수 있다.** 화면이 약속하는 것과 실제 동작의 어긋남부터 없애는 조치다. + +### C. 파이프라인 잔여 + +- `clinicDoctors` 4명 고정을 병원 규모에 맞출지 +- planner가 tourism 좌표를 쓰도록 +- 뷰 의료진 id 두 벌 정리 (뷰 재빌드와 묶어서) +- `check.mjs --update-layout` 레이아웃 기준선 + +### D. 분석 리포트 자체 수정 + +히어로 공백 · `NaN년` · 과한 여백. 옮기든 접든 남는 문제다. + +--- + +## §2. 다음 측정에서 볼 값 + +09-15 실측에서 네이버 AI 브리핑이 120문항 중 119문항에 노출되는데 **논브랜드 83건 중 뷰성형외과 언급은 1건**이었다. 브랜드명을 아는 사람에게만 답변이 나오고, 시술이나 지역으로 찾는 사람에게는 도달하지 못한다. + +서포터즈 사이트가 이 구간을 움직이는지가 제품의 핵심 증명이다. 뷰·원진·오라클이 색인 허용으로 전환된 뒤 같은 120문항을 다시 돌려 비교한다. + +근거: `docs/reports/viewclinic/03_question_bank/Viewclinic_QB_Sentiment.md`, `scripts/out/naver_briefing_summary.json`