king
40766d805d
증상: 상세페이지를 적용해도 편집기에 수정 전 소스가 보이고 한참 뒤에야 반영됨. 원인은 우리 캐시가 아니라(전부 no-store) 카페24 관리자 API 가 PUT 뒤 한동안 GET 에서 예전 값을 돌려주는 읽기 지연. 예전 코드는 2.4초만 기다린 뒤 GET 값을 그대로 믿어 예전 소스 표시·지문 충돌 오판·예전 값 백업이 생겼다. - 상세설명: 쓰기 성공 시 MANUAL/SCHEDULED revision 을 기준으로, 카페24 값이 유예시간 안의 revision 중 하나와 같으면 지연(pending)으로 보고 마지막 쓰기를 표시·지문 기준으로 쓴다. 모르는 값이면 외부 변경(external). store.resolve_description / db.revision_digests(md5) / 배너 2종. - 적용(apply)은 유효 현재값으로 BACKUP·지문 대조·변경없음 판정. 재조회 확인 결과는 감사로그에만 남긴다. - 스칼라(상품명·가격·이미지·진열/판매): PUT 응답을 cafe24_products. last_write_snapshot(JSONB, 마이그레이션 004)에 남기고 GET 의 updated_date 가 그보다 이전이면 스냅샷으로 덮어씀. 옵션/품목도 섹션별 스냅샷. - 3분할 화면: 목록 | 편집기 | 상품 정보 패널(_side.html, /pane 이 두 조각을 한 응답으로). routes_product_info.py JSON API — 상품명/판매가/공급가/ 소비자가, 대표이미지 업로드(POST /admin/products/images → PUT detail_image + image_upload_type=A), 옵션 생성/이름·썸네일·표시방식 수정/삭제, 품목 자체코드·추가금액·진열·판매 일괄 수정. 화면은 PUT 응답으로 그린다. - client.delete/timeout, products.upload_images·options·variants 래퍼. - 유닛테스트 21건 추가(88 통과), 문서(CAFE24_MODULE 3-3/3-4, DATABASES, .env.example CAFE24_READ_LAG_GRACE_MIN) 갱신. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
49 lines
2.1 KiB
Python
49 lines
2.1 KiB
Python
"""카페24 상품 상세페이지 관리 모듈 라우터.
|
|
|
|
- 경로: /cafe24
|
|
- 권한: 로그인 + `cafe24` 모듈 권한 (관리자는 항상 통과). 서버 측 검사.
|
|
카페24 연결(OAuth) 변경은 `is_admin` 만.
|
|
- 데이터: Cafe24Store (cafe24_db / PostgreSQL) 전용.
|
|
CAFE24_DB_URL 미설정 시 store 가 None 이며, 각 페이지는 "설정 필요" 안내.
|
|
- 카페24 API 호출은 app/integrations/cafe24 공통 계층을 통해서만 한다.
|
|
|
|
라우트가 많아 기능별 파일로 나눈다(다른 모듈의 단일 router.py 패턴을 규모 때문에
|
|
확장한 것). 여기서는 루트 라우터를 만들고 서브 라우터를 결합한다.
|
|
routes_products 상품 목록/검색 · 상세설명 조회·편집·적용
|
|
routes_product_info 오른쪽 정보 패널 JSON API — 상품명/가격 · 대표이미지 ·
|
|
옵션(생성/수정/삭제) · 품목(자체코드/추가금액/진열/판매)
|
|
routes_schedules 예약 등록·목록·취소 (실행은 worker.py)
|
|
routes_system 연결(OAuth)·상태·API 로그·작업 로그
|
|
routes_design_files 모바일 스와이프·PC/모바일 상품상세 템플릿 편집 —
|
|
카페24 디자인 보관함 FTP (Admin API 가 아니다.
|
|
app/integrations/cafe24/design_ftp.py 참고)
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
|
|
from fastapi import APIRouter
|
|
|
|
from .routes_design_files import design_files_router
|
|
from .routes_product_info import product_info_router
|
|
from .routes_products import products_router
|
|
from .routes_schedules import schedules_router
|
|
from .routes_system import system_router
|
|
|
|
logger = logging.getLogger("cafe24.router")
|
|
|
|
router = APIRouter(prefix="/cafe24", tags=["cafe24"])
|
|
|
|
router.include_router(products_router)
|
|
router.include_router(product_info_router)
|
|
router.include_router(schedules_router)
|
|
router.include_router(design_files_router)
|
|
router.include_router(system_router)
|
|
|
|
|
|
@router.get("/health")
|
|
def health() -> dict[str, str]:
|
|
"""포털 카드의 상태 점(dot) 용. 인증 불필요 — 상태 문자열만 반환."""
|
|
return {"status": "ok"}
|