Mina Choi
ef0c44c5f2
가게별 첫 화면 문구를 만드는 곳이 없어 모든 숙박이 공통 문구 10개를 돌려 썼다. - COPY 잡에 catchphrase 단계(prepare→generate→save→catchphrase→faq_fill), 숙박이 아니면 건너뜀 - prompts/catchphrase.py·gemini_text.generate_catchphrases: 캐치프레이즈 1 + 일반 20·계절 3×4·월 12·날씨 2×4. 문구마다 길이·상호명·ground_check(근거 없는 시설·수치) 검사 - fact tagline·catchphrases(lodging 스키마, allow_llm). 순환 문구는 사장님이 줄 단위로 고치게 글로 저장 (catchphrase_text: `봄 | ` · `9월 | ` · `비 | ` 머리) - site_payload: narrative.tagline·catchphrases 로 넘기고 이용정보 표(facts)에서는 뺀다 - 빌더 생성 화면 단계 문구, DATA_MODEL·GENERATION_FLOW 테스트 6건 추가. 관련 20개 파일 386 passed · 실패 102건은 main 과 목록이 같다(기존 실패) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
47 lines
3.2 KiB
Markdown
47 lines
3.2 KiB
Markdown
# 콘텐츠 생성 · 진행 복구
|
|
|
|
2026-09-15. `builder?step=generating`은 COPY(소개문·FAQ) 작업이다.
|
|
사진 분석은 VISION, 정적 사이트·노래 생성은 발행 BUILD에 속한다.
|
|
|
|
```text
|
|
템플릿 선택 → POST /v1/place/{placeId}/copy → jobId를 URL에 기록
|
|
↓
|
|
새로고침 ──────────────────────→ GET /v1/job/{jobId}
|
|
↑
|
|
COPY 워커: prepare → generate → save → catchphrase(숙박만) → faq_fill
|
|
각 단계 진입·완료 → jobs.progress(JSONB)
|
|
↓
|
|
화면: 서버 단계 표시 → DONE일 때 데이터 갱신 → editor
|
|
```
|
|
|
|
| 책임 | 파일 |
|
|
|---|---|
|
|
| 실행 순서 | `solution/backend/services/copy_service.py` |
|
|
| 단계 구현 | `solution/backend/services/copy_steps.py` — `prepare_copy`, `generate_copy`, `save_copy`, `fill_faqs` |
|
|
| 프롬프트·응답 스키마 | `solution/backend/services/prompts/copy.py` |
|
|
| 모델 호출·생성물 검증 | `solution/backend/services/external/gemini_text.py` → `llm/gemini.py`, `grounding/copy.py` |
|
|
| 단계 기록 | `solution/backend/services/job_progress.py` → `crud/job_crud.py` |
|
|
| API 계약 | `solution/backend/router/v1/job/protocol.py` → OpenAPI → Orval |
|
|
| 조회·복구·완료 전환 | `solution/frontend/src/features/onboarding/useGenerationJob.ts` |
|
|
| 화면 / 문구 | 같은 폴더의 `Step5Generating.tsx` / `generationLabels.ts` |
|
|
|
|
- `jobs.status`는 작업 전체 상태, `progress.steps[].status`는 단계 상태다.
|
|
단계는 `pending/running/done/skipped/failed`. 시간으로 퍼센트나 단계를 올리지 않는다.
|
|
- `progress.attempt`는 워커 시도 번호다. 재시도는 단계를 처음부터 다시 기록한다.
|
|
기록은 실행 중인 워커·시도 번호·유효한 lease가 일치할 때만 허용한다.
|
|
- 새로고침은 GET만 한다. jobId가 없는 구 URL은 `POST copy {resume: true}`로
|
|
해당 사업장의 최근 COPY를 찾는다. DONE·DEAD도 반환하므로 완료됐다고 새 작업을 만들지 않는다.
|
|
권한 검사는 사업장 조회가 먼저 한다. URL로 조회하는 COPY도 소유자를 검사한다.
|
|
- 템플릿의 생성 버튼을 명시적으로 누르면 기본 POST로 새 작업을 요청한다.
|
|
같은 사업장의 활성 작업이 있으면 기존 중복 방지 규칙으로 그 작업에 연결한다.
|
|
- 통신 오류는 상태 재조회, DEAD는 이전 단계 또는 편집기로 직접 이동할 수 있다.
|
|
오류·대기·미설정 상태를 가짜 진행이나 완료 화면으로 바꾸지 않는다.
|
|
- 노래 단계는 이번 COPY 흐름에 추가하지 않았다. 발행 BUILD 진행 표시 확장은 별도다.
|
|
|
|
적용: 마이그레이션 `0013_job_progress.sql`을 먼저 적용한 뒤 API·워커·빌더를 배포한다.
|
|
기존 잡의 `progress`는 NULL이다. 이 경우 단계 목록을 지어내지 않고 전체 상태만 표시한다.
|
|
|
|
검증: `tests/test_copy_api.py`, `tests/test_job_queue.py`, `tests/test_schema_ddl.py`.
|
|
프론트는 개발 서버를 켜고 `node solution/frontend/tests/generation.mjs <개발 URL>` 실행.
|
|
브라우저 테스트는 모든 API를 가짜 응답으로 대체한다.
|