Mina Choi
9b4fe4030b
킹서버(o2oadmin@172.30.1.36)에 처음 올리면서, 서버에 올려야만 드러나는 결함 넷을 잡았다.
전부 "화면은 뜨는데 안 되는" 종류라 로컬에서는 끝까지 보이지 않는다.
- CORS 허용 오리진(client_url)만 env override 가 없었다. 도커가 굽던 config.local.toml 은
플레이스홀더라 허용 목록이 localhost:3000~3005 뿐이고, 배포 주소에서는 모든 API 호출이
프리플라이트에서 죽었다. 서버 로그에는 400 만 남아 원인이 CORS 라는 게 안 보인다
- .env 경로가 세 단계라 solution/.env(없는 파일)를 보고 있었다. 백엔드를 solution/ 아래로
옮길 때 안 고쳐진 자리. toml 이 값을 들고 있어 로컬에서 드러나지 않았다
- admin 의 "빌더 열기" 가 VITE_SOLUTION_URL 미주입으로 localhost:3000 을 가리켰다
- PUBLIC_API_BASE_URL 은 브라우저가 부르는 주소인데 기본값이 localhost 라 서버에서 즉시 틀린다
설정 — toml 층 제거, pydantic-settings 로 전환 (FastAPI 공식 방식)
- config_loader.py · config.{local,test}.toml.example 삭제, 기본값은 config_models 로
- BaseSettings + env_file. `_apply_*_env_override` 4개 제거 — 키를 손으로 나열하는 구조라
하나 빠뜨리면 조용히 틀렸고, 실제로 client_url 이 빠져 있었다
- 환경변수 이름은 validation_alias 로 못 박음. 필드명만 두면 `port` 가 흔한 `PORT` 를 먹는다
- 테스트 DB 분리(web4ai_test_db)는 config.test.toml 이 하던 몫이라 APP_ENV 기본값으로 이관
- lru_cache 로 .env 재읽기 방지. 새 코드는 Depends(get_*) 주입 가능
- 호출부 21개 파일 무변경 — server_configs 가 같은 이름을 계속 내보낸다
배포 — 킹서버는 :80 을 호스트 nginx 가 물고 있고 사내망에 열린 건 30xxx 뿐이다
- 컴포즈 포트를 전부 .env 변수로 추출(기본값은 기존 값 그대로, 로컬 무영향)
- 컨테이너 이름을 폴더 구조에 맞춤 — solution-backend·solution-worker·solution-frontend·
solution-site·admin-backend·admin-frontend. api·web·nginx 는 어느 폴더 코드인지
이름만으로 알 수 없었고, 백엔드 셋이 이미지 한 벌을 나눠 써서 특히 헷갈렸다
- worker 에 container_name 을 붙여 `-1` 접미사 제거(동시성은 WORKER_CONCURRENCY 가 맡는다)
- 어드민 앱·API 는 compose 프로필 뒤로 — 지금 안 쓴다. 켤 때 --profile admin
- deploy.sh: 서비스 하나를 지정해도 백엔드 형제를 함께 교체한다. 이미지 한 벌을 나눠 써서
하나만 바꾸면 옛 코드로 도는 컨테이너가 남는데 `ps` 로는 셋 다 살아 있다
- log.sh: 1=전체, 2번부터 개별. compose v2.20 이 커스텀 --format 을 파싱하지 못해 상태가
전부 "미기동" 으로 보이던 것도 --services --filter 로 교정
- docs/SERVERS.md 신설(접속·경로·포트·DB·sudo 없음), docs/DEVLOG.md 신설
정리
- 개발 전용 자동 로그인 제거 — 편의 하나에 검색 경로의 비동기 대기가 딸려 있었고,
평문 비밀번호를 .env 에 두라고 권하는 모양새였다
- API 이름을 디렉토리에 맞춤: 사장님/내부 → 솔루션 API · 어드민 API (21곳)
- .env.example 을 읽는 폴더 기준 구역으로 재편 (solution/backend · solution/frontend ·
solution/site · compose)
- AGENTS.md 에 negosium 브랜치·커밋 규약 명시
검증(킹서버 실측) — 컨테이너 4개 새 이름으로 기동, 솔루션 API·사장님 앱 200,
발행 사이트 404(발행물 없음, 정상), CORS 허용/차단 각 확인, toml 없이 부팅,
APP_ENV=test 시 web4ai_test_db·실키 미주입 확인.
187 lines
18 KiB
Markdown
187 lines
18 KiB
Markdown
# DECISIONS
|
|
|
|
미결 사항과, 코드가 그 미결을 어떻게 격리해 두고 있는지를 적는다.
|
|
**결론이 나면 여기에 날짜와 함께 결론을 적고, 해당 플래그/어댑터를 제거한다.**
|
|
|
|
---
|
|
|
|
## 1. 미결 — 결론 전까지 코드로 풀지 않는다
|
|
|
|
### 1-1. 야놀자·여기어때·네이버 플레이스 크롤링의 약관·법적 검토
|
|
|
|
**결론 (2026-08-28) — `docs/DATA_SOURCE_RESEARCH.md` 실측 기준.** 아래 원안은 이력으로 남긴다.
|
|
|
|
| 대상 | 판정 | 근거 |
|
|
|---|---|---|
|
|
| 야놀자 · 여기어때 | **불가** | 풀 브라우저 헤더로도 HTTP 403 + Cloudflare 챌린지. 뚫으려면 봇 탐지 우회가 필요한데 그건 영구 금지 영역이다. 법적으로도 야놀자 v 여기어때 = 형사 무죄(대법원 2022-05-12)지만 **민사 10억 배상 + 복제·저장 금지**(서울중앙지법 2021-08). 우리는 재게시까지 하므로 노출이 더 크다 |
|
|
| 네이버 플레이스 | **robots.txt 기준 불허** | `m.place.naver.com/robots.txt` = `User-agent: * / Disallow: /`. 현재 `naver_place` 어댑터는 위반 상태로 동작 중이다. 사장님 본인 업소 1건·사장님 동의·대량 DB 복제 아님이라 야놀자 사건과는 양상이 다르지만, **이 위에 제품을 세우지 않는다** — 대체 소스가 붙는 대로 발행 payload에서 빼고 대조용 참고값으로 내린다 |
|
|
| 카카오맵 | **불가** | 상세는 SPA 셸(3.6KB), 어드민 API 406 차단 |
|
|
| **사장님이 확정한 자체 홈페이지** | **가능** | 사장님 동의 기반. → `StaticHtmlAdapter` 등록(2026-08-28) |
|
|
|
|
**추가 결론 (2026-08-31)** — TourAPI 어댑터를 붙여 같은 표본으로 대조한 결과
|
|
([DATA_SOURCE_RESEARCH.md](DATA_SOURCE_RESEARCH.md) 8-2), 네이버 플레이스는 숙박 fact 2건 ·
|
|
객실명만 주는데 TourAPI 는 fact 8종 · 객실 20개의 인원/요금/면적을 준다. **정보량도 적고
|
|
출처도 못 밝힌다** — `naver_place` 어댑터를 유지할 근거가 사실상 사라졌다.
|
|
아직 `COLLECT_ADAPTERS` 기본값에 남아 있으므로, 내리는 것이 남은 일이다.
|
|
|
|
부수 결론: **네이버·카카오 생태계는 AI 크롤러를 전면 차단**한다(플레이스·지도·블로그·예약·카카오맵 모두 `Disallow: /`). 즉 그 데이터를 긁어와도 AI 검색에는 원래 없던 정보라 GEO 이득이 없고, 출처를 밝힐 수 없어 `llms.txt`·`AnswerBlock`의 "출처와 검증 시각" 신호도 못 채운다. 공공데이터(TourAPI·LOCALDATA)가 그 자리를 대신한다.
|
|
|
|
| 항목 | 내용 (원안) |
|
|
|---|---|
|
|
| 상태 | ~~미결~~ → **결론남 (2026-08-28)** |
|
|
| 필요한 결론 | 각 사이트의 이용약관·robots.txt 기준으로 자동 수집이 허용되는 범위 |
|
|
| 코드 격리 | `collector` 는 어댑터 패턴. ~~Phase 1 은 `MockAdapter` 만 등록~~ → **2026-08-28: `StaticHtmlAdapter` 등록 완료**(사장님 확정 URL 한정, robots.txt 준수, 플랫폼 호스트는 `_DENY_HOSTS` 로 구조적 차단). `HeadlessAdapter`(Playwright)는 **등록하지 않는다** — Cloudflare 를 뚫는 용도가 되므로 금지 항목과 구분되지 않는다 |
|
|
| 결론이 "불가"일 때 | 폴백 3단계로 간다 — ① 공식 API → ② 사장님이 직접 붙여넣기 → ③ 최소 정보로 생성 + 보완 요청. **생성 자체는 실패시키지 않는다** |
|
|
| 확정 사항 | 캡차 우회 · 봇 탐지 우회 · IP 회전은 **결론과 무관하게 금지**. 구현하지 않는다 |
|
|
|
|
### 1-2. 크롤링한 **이미지**의 재게시 권리
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 상태 | **미결** |
|
|
| 필요한 결론 | OTA/플레이스에 올라간 사진을 우리가 만든 홈페이지에 다시 게시할 수 있는가 (저작권자 = 사장님인가 OTA인가) |
|
|
| 파급 | **막히면 사진 입력원이 "크롤링" → "사장님 업로드"로 바뀌고, Gemini Vision 단계의 입력 자체가 달라진다.** 분류·alt 생성 로직은 같아도 수집 경로가 통째로 교체됨 |
|
|
| 코드 격리 | 사진은 `media` 로 들어오되 **출처(`source_type`)를 반드시 남긴다**(`crawl` / `owner`). 발행 시 `source_type` 로 필터링할 수 있어야 한다 |
|
|
| 대기 중 | 파일 업로드 경로(Azure Blob 클라이언트)는 원본 보일러플레이트에 있으나 **아직 복사하지 않았다.** 이 결론이 난 뒤 media 모듈과 함께 이식한다 |
|
|
| 반영됨 (2026-08-26) | `place.media` 에 `source_type`(owner/crawl)과 `origin_url` 을 NOT NULL / 보존 컬럼으로 두었다. 결론이 "불가"로 나면 발행 시 `source_type = CRAWL` 을 통째로 제외하는 것으로 대응 가능하다 |
|
|
|
|
### 1-3. 관리자에서 수정 허용 범위
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 상태 | **미결** |
|
|
| 필요한 결론 | 사장님이 직접 고칠 수 있는 fact 의 범위. 특히 체크인·취사·반려동물·취소 규정처럼 **틀리면 예약 클레임이 나는 항목**을 자유 입력으로 열 것인가 |
|
|
| 확정 사항 | 수정한 값은 **잠긴다**(`status = CORRECTED`). 자동 갱신이 사장님 수정본을 덮어쓰지 않는다 |
|
|
| 코드 격리 | fact 상태 전이에서 `CORRECTED` 는 자동 수집(`api`/`crawl`/`llm`)이 갱신할 수 없는 종착 상태로 둔다 |
|
|
| 반영됨 (2026-08-26) | `LOCKED_FACT_STATUSES = {CORRECTED}` · `FACT_STATUS_TRANSITIONS[CORRECTED] = {CORRECTED, REJECTED}` — 자동 갱신 경로(UNVERIFIED·VERIFIED)로 돌아갈 수 없다. `tests/test_fact_schema.py` 가 이 규칙을 고정한다 |
|
|
| 남은 결정 | **어떤 필드까지 자유 입력을 허용할 것인가.** 업종 스키마의 `critical: true` 필드가 후보 목록이다 — 숙박 14 / 카페 12 / 음식점 15 / 관광체험 17개 |
|
|
|
|
### 1-4. 해지 시 사이트 처리 정책
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 상태 | **미결** |
|
|
| 필요한 결론 | 해지하면 사이트를 즉시 내리는가 / 유예를 두는가 / 도메인은 어떻게 되는가. AI 검색이 이미 색인한 페이지를 갑자기 404 로 만들면 그 자리를 다시 OTA 가 가져간다 |
|
|
| 코드 격리 | `site` 에 발행 상태를 두고, 해지 처리는 **삭제가 아니라 상태 전이**로만 구현한다. 물리 삭제 경로를 만들지 않는다 |
|
|
| 반영됨 (2026-08-26) | `SiteStatus.SUSPENDED`(해지 유예 — 페이지 살아 있음) / `UNPUBLISHED`(내림)를 분리했다. `PublishAction.SUSPEND`·`RESUME` 으로 `publish_logs` 에 남는다. 유예 기간 길이만 정하면 된다 |
|
|
|
|
---
|
|
|
|
## 2. 이식하면서 내린 결정 (2026-08-26)
|
|
|
|
원본: `o2o-negosium/negodata/backend` 보일러플레이트.
|
|
|
|
| 항목 | 결정 | 이유 |
|
|
|---|---|---|
|
|
| 레이어 구조 | 원본 그대로 — `router` → `service` → `crud`, 람다 DB 실행, `Req_*`/`Res_*` 프로토콜, `RemoveNoneResponse` | "기존 컨벤션을 그대로 따른다" |
|
|
| 포트 | **9800** | negosium 9300 / negodata 9400 / agent 9500 / lps 9600 / anchoring 9700 다음 번호 |
|
|
| DB | `web4ai_db` (테스트 `web4ai_test_db`), 기존 로컬 postgres(`negosium-db` 컨테이너, 5432) 안의 **별도 database** | 원본과 같은 인스턴스·다른 DB. 스키마 네임스페이스 컨벤션 유지 |
|
|
| 마이그레이션 | Alembic 안 씀. `postgres-init/init-data/init.sql` **한 벌**(전체 DDL, 재실행 안전) | 2026-08-31: 누적 ALTER 파일(`alters/`)을 없앴다. 아직 git·서버 어디에도 안 올라가 **보정할 기존 DB 가 없다** — init.sql 에 이미 전부 반영돼 있어 두 벌을 유지할 이유가 없었다. 운영 DB 가 생기는 순간 다시 필요해진다 |
|
|
| 남긴 것 | config 로더 · 로거 · 싱글톤 · DB 세션 매니저(R/W 분리) · gmodel · gtime · authz · JWT/bcrypt dependencies · `company.companies`/`company.users` · auth 라우터 · 스케줄러 껍데기 · conftest(테스트 DB 자동 생성/삭제) | 전 모듈이 공통으로 쓰는 인프라. 인증은 places·facts·sites 전부가 `IsValidAccessToken` 에 의존한다 |
|
|
| 뺀 것 | quotation · supplier · item · card · dashboard · statistics · learning · renegotiation · landing · admin · notification · LPS 연동 · anchoring · 초청메일(ACS/SMTP) · Azure Blob 클라이언트 | negodata 고유 도메인. Blob 클라이언트만 1-2 결론 후 media 모듈과 함께 재이식 예정 |
|
|
| `companies` 테이블 유지 | 유지 | 보일러플레이트의 멀티테넌트 스코프 키(`UserInfo.company_id`)가 전 계층에 박혀 있다. 대행사/운영사 단위로 그대로 쓴다 |
|
|
| ErrorType 구간 | 계정 = 1100. 도메인 구간 예약 — places 1200 / facts 1300 / collector 1400 / generator 1500 / local 1600 / sites 1700 / reports 1800 | 원본이 구간을 나눠 쓰는 방식 유지 |
|
|
| 외부 API 키 | `[ExternalApiConfig]` 로 toml + env override. **키가 비면 해당 어댑터만 비활성, 서버는 그대로 뜬다** | 부팅이 외부 계약에 묶이면 안 됨 |
|
|
| 백그라운드 작업 | 원본에 전용 작업 큐 없음(APScheduler 크론만). 수집·비전분석·빌드는 몇 분 걸리므로 **큐를 새로 얹어야 한다** — 방식 미정 | 원본에 없는 것이라 팀 컨벤션 확인 필요. 아래 3번 참고 |
|
|
|
|
---
|
|
|
|
## 3. 다음 단계에서 정해야 할 것 (법무 이슈 아님)
|
|
|
|
- ~~**작업 큐 구현 방식.**~~ → **결론남 (2026-08-27)**: LPS 의 `job` 큐를 그대로 이식했다.
|
|
DB 잡 테이블 + 상태 폴링 API. 근거와 세부는 아래 5-2.
|
|
- ~~**지역 정보 캐시 TTL.**~~ → **날씨는 결론남 (1시간, `local_content_service.get_weather`)**.
|
|
상류가 죽으면 만료된 값을 `stale` 표시로 내보낸다 — 빈 값을 내보내지 않는다(절대규칙 9).
|
|
**축제·관광지는 아직 TTL 이 없다** — 지금은 `sync-festivals` 를 사람이 눌러야 돈다.
|
|
- **TourAPI areaCode ↔ 카카오 행정구역 코드 매핑 테이블.** 두 체계가 다르므로 매핑을 데이터로 관리할지 코드로 박을지.
|
|
(카카오 키가 아직 미발급이라 실제로 부딪히지 않았다)
|
|
|
|
---
|
|
|
|
## 4. Phase 2 에서 내린 결정 (2026-08-26)
|
|
|
|
작업 순서 2번 — 4개 업종 스키마 정의 + 마이그레이션.
|
|
|
|
| 항목 | 결정 | 이유 |
|
|
|---|---|---|
|
|
| 업종 스키마 위치 | `common/category_schema/resources/*.json` + 로더 | 원본의 `common/anchoring/resources/` 패턴 그대로. **업종 추가 = 파일 1개 + enum 1줄** |
|
|
| fact 저장 | key-value (`facts.key` / `value` / `unit`) | 업종마다 필드가 완전히 달라 컬럼으로 못 편다 |
|
|
| 활성 fact 유니크 | `(place_id, unit_id, key)` 당 1건. **`REJECTED`·`EXPIRED` 는 제외** | 같은 항목에 두 값이 동시 노출되는 것을 DB 가 막는다. 틀린 값·만료 값은 이력으로 남겨야 하므로 유니크에서 뺀다 |
|
|
| 유니크 인덱스 2분할 | `unit_id IS NULL` / `IS NOT NULL` 로 나눠 건다 | Postgres 에서 NULL 끼리는 유니크가 안 걸린다. 나누지 않으면 사업장 단위 fact 가 중복된다 |
|
|
| `critical` 플래그 | 업종 스키마 필드 속성으로 도입 | 절대규칙 1(미검증 fact 노출 금지)의 대상 목록이 코드가 아니라 데이터에 있어야 업종 추가 시 자동으로 따라온다 |
|
|
| `allow_llm` 플래그 | 기본 `False`. `True` 는 소개문 계열 2개뿐 | 절대규칙 7(LLM 은 사실을 만들지 않는다)을 스키마 레벨에서 강제. 테스트가 `required` 필드의 `allow_llm=True` 를 금지한다 |
|
|
| 지역 정보 캐시 키 | `local_contents.region_code` (place_id 아님) | 같은 지역에 사이트 50개가 생겨도 외부 조회는 1회. 카카오 키워드 검색이 좌표 변환보다 4배 비싸다 |
|
|
| 스키마 네임스페이스 | `place` / `fact` / `local` / `site` | 원본의 도메인별 schema 컨벤션. `local` 은 Postgres 비예약어라 그대로 쓸 수 있다(확인함) |
|
|
| 테이블명 | 복수형 (`places`, `facts`) | 원본이 복수형(`companies`, `users`, `quotations`). 스펙 문서의 단수 표기는 엔티티 이름으로 읽었다 |
|
|
| `server_default` | 신규 도메인 테이블에만 추가 | ORM `default=` 는 Python 쪽이라 raw INSERT 에 안 먹는다. `create_all`(테스트 DB)과 `init.sql`(실 DB)이 갈라져서 실제로 버그가 났다. **`companies`/`users` 는 원본 그대로 두었다** |
|
|
| ORM ↔ init.sql 정합성 | `tests/test_schema_ddl.py` 가 파일을 파싱해 대조 | 스키마 정의가 두 곳에 있는 구조(원본 컨벤션)라, 드리프트를 테스트로 막는다 |
|
|
| 설정 주입 | 레포 최상위 `.env` + `pydantic-settings` | FastAPI 공식 방식(BaseSettings + env_file). 우선순위 = 실제 환경변수 > `.env` > 코드 기본값. toml 층은 없앴다(2026-09-01) — 키를 손으로 나열하다 `client_url` 이 빠져 배포 주소의 CORS 가 막혔다. **`APP_ENV=test` 면 `.env` 를 읽지 않는다** |
|
|
| 키 출처 | Perplexity·Gemini 는 `o2o-infinith-backend/.env` 값 재사용. **TourAPI 는 2026-08-31 활용신청 승인**, 카카오는 여전히 **미발급** | 카카오 키가 없으면 `kakao` 어댑터만 비활성이고 주변 정보 블록이 비어 뜬다 |
|
|
|
|
### 아직 테이블이 없는 것
|
|
|
|
- **`report` 스키마** — 노출 리포트·유입 통계(GA4 Data API, Search Console API). 작업 순서 6번 이후.
|
|
- ~~**작업 큐**~~ → `job.jobs` 로 생겼다 (2026-08-27, 5-2). 17번째 테이블이다.
|
|
- **TourAPI areaCode ↔ 카카오 행정구역 코드 매핑** — 테이블 대신 `common/category_schema` 와 같은 리소스 JSON 으로 두는 것을 제안. 3번 참고.
|
|
|
|
---
|
|
|
|
## 5. Phase 3 에서 내린 결정 (2026-08-27)
|
|
|
|
작업 순서 3번 — places · facts API(검증 상태 전이) + 작업 큐.
|
|
|
|
### 5-1. fact 를 '노출값 1건 + 후보 N건' 으로 바꿨다
|
|
|
|
처음엔 활성 유니크를 `status IN (1,2,3,4)` 로 걸었다. 재수집(업데이트)을 넣어 보니 세 가지가 깨졌다 —
|
|
실제로 돌려서 확인한 결과다:
|
|
|
|
| 상황 | 깨진 것 |
|
|
|---|---|
|
|
| 값이 그대로인데 재수집 | 검증(VERIFIED)이 초기화돼 사이트에서 사실이 사라졌다 |
|
|
| 값이 바뀐 재수집 | 확인된 노출값이 즉시 밀려나 사이트가 비었다 |
|
|
| 정정본(CORRECTED)에 재수집 | `FACT_LOCKED` 로 크롤링 값을 통째로 버려 OTA 불일치 신호가 사라졌다 |
|
|
|
|
원인은 하나 — **유니크가 "노출값"과 "새로 들어온 값"을 동시에 못 갖게 막고 있었다.**
|
|
|
|
**결정: 유니크를 노출 상태(VERIFIED·CORRECTED)에만 건다.**
|
|
|
|
```
|
|
노출값 VERIFIED / CORRECTED (place, unit, key) 당 1건 ← 사이트에 나감
|
|
후보 UNVERIFIED / PENDING_OWNER 여러 건 공존 ← 재수집이 쌓임
|
|
이력 REJECTED / EXPIRED
|
|
```
|
|
|
|
이걸로 세 프로세스가 분리됐다.
|
|
|
|
| 프로세스 | 동작 | outcome |
|
|
|---|---|---|
|
|
| 생성 | 자동 수집 → 후보 → 사람 승인 → 노출 | `CANDIDATE_CREATED` |
|
|
| 업데이트(값 같음) | 검증 유지, 확인 시각만 갱신 | `REFRESHED` |
|
|
| 업데이트(값 다름) | **노출값 유지** + 후보 적재 | `CANDIDATE_CREATED` |
|
|
| 승인 | 후보 → 노출값, 옛 값 EXPIRED | `PUBLISHED_REPLACED` |
|
|
| 수정(사람 직접) | 즉시 노출값 교체 | `PUBLISHED_REPLACED` |
|
|
|
|
스키마: `postgres-init/init-data/init.sql` (`fact.facts` 활성 유니크 + 후보 상태)
|
|
|
|
### 5-2. 그 밖의 결정
|
|
|
|
| 항목 | 결정 | 이유 |
|
|
|---|---|---|
|
|
| 사람 직접 입력 | 즉시 노출값(VERIFIED)으로 들어간다 | 넣은 사람이 곧 출처이자 책임 주체다. 입력→확인 2단계로 만들면 실무에서 안 쓴다. 검수 게이트의 실제 목적은 **자동 수집**을 거르는 것 |
|
|
| 정정본 잠금의 의미 | "덮어쓰기 금지"이지 "기록 금지"가 아니다 | 크롤링 값을 버리면 OTA 가 아직 다른 값이라는 신호를 잃는다. 후보로 남겨 사람이 본다 |
|
|
| `places.content_updated_at` | 노출값이 **실제로 바뀔 때만** 찍는다 | 개별 재빌드 대상 판별(`site_versions.built_at < content_updated_at`). 후보만 쌓였을 땐 안 찍힌다 — 사이트 내용이 안 바뀌었으니 재빌드가 불필요 |
|
|
| 작업 큐 | LPS(`o2o-negosium/lps`)의 `job` 큐를 그대로 이식 | 사내 선례이고 도커에서 검증된 구조. 원자적 claim(`FOR UPDATE SKIP LOCKED`) + lease 소유권 + dedupe + dead-letter. Redis/Celery 를 안 쓰는 이유는 운영 컴포넌트가 늘면 장애 지점이 늘기 때문 |
|
|
| 큐 세션 진입점 | `DB_SESSION_MNG.execute_lambda_write` 를 새로 추가 | 큐 전이는 `UPDATE ... RETURNING` 이라 조회/변경을 못 나눈다. 기존 `execute_lambda_run`(ErrorType만) / `execute_lambda_claim`(rowcount만) 로는 값을 못 받는다 |
|
|
| `jobs.job_id` server_default | 이 테이블만 PK 에 `gen_random_uuid()` 를 건다 | 큐만 raw SQL 로 INSERT 해서 ORM 의 Python default 가 안 먹는다. `create_all`(테스트 DB)과 `init.sql`(실 DB)이 갈라져 실제로 버그가 났다 |
|
|
| 수집 중복 방지 | `dedupe_key = "collect:{place_id}"` | 사업장당 활성 수집 잡 1건. 버튼을 두 번 눌러도 두 번 돌지 않는다 |
|
|
|
|
### 5-3. 아직 안 한 것
|
|
|
|
- ~~**`검색어 → URL 발견 → 크롤링 → 에셋` 체인**~~ → **돈다 (2026-08-28~31)**.
|
|
Perplexity 채널 발견 + `tour_api`·`naver_place`·`static_html` 어댑터가 붙었다
|
|
([DATA_SOURCE_RESEARCH.md](DATA_SOURCE_RESEARCH.md) 8-1·8-2).
|
|
- 사진(`place.media`)은 **조회는 열렸고**(`/v1/place/{id}/media`, 빌더가 `useListMedia` 로 읽는다)
|
|
**업로드·저장 경로가 없다.** 이미지 재게시 권리(1-2)가 미결이라 Azure Blob 클라이언트를
|
|
일부러 아직 이식하지 않았다.
|
|
- 카카오 REST API 키 / TourAPI 키가 사내 어디에도 없다. 발급해서 `.env` 에 채워야 실제 연동이 돈다.
|