172 lines
8.7 KiB
Markdown
172 lines
8.7 KiB
Markdown
# 핸드오버 · 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/<clinic>-<id>/`)를 공유해 서로 덮어쓴다.
|
|
- **부분 재실행은 `--from <단계>`.** 글은 `--regenerate` 없으면 보존되어 생성 비용이 0이다.
|
|
- **워커는 Productize 워크트리에서 돈다.** Productize-2 가 아니다. launchd 폴러 `com.infinith.supporters-poll`, 로그 `~/supporters-builds/poll.log`.
|
|
- **주간보고는 gitignore 처리했다** (`docs/*주간보고*`). 개인 문서라 저장소에 올리지 않는다.
|