"""카페24 모듈 순수 로직 + 토큰/암호화 테스트. DB/네트워크 없이 검증한다(가짜 저장소 + refresh 함수 주입). python -m app.modules.cafe24.tests.test_cafe24 또는 pytest 로 실행 가능. """ from __future__ import annotations import ftplib import logging import os from contextlib import contextmanager from datetime import timedelta from app.integrations.cafe24 import config as cfgmod from app.integrations.cafe24 import crypto, oauth, products, tokens from app.integrations.cafe24.errors import Cafe24ApiError, Cafe24AuthError, Cafe24ConfigError from app.modules.cafe24 import store, worker, writes from app.modules.cafe24.tests import fakes from app.timezone import now_kst SECRET = "unit-test-secret" # wait_for_description 은 실물 카페24 API 의 쓰기 직후 읽기 지연을 흡수하려고 # 실제로 sleep 한다. 가짜 클라이언트는 그 지연을 재현하지 않으므로(항상 같은 # 값을 돌려줌) 재시도 예산을 다 채우게 되는데, 테스트에서까지 그 시간을 그대로 # 기다릴 필요는 없다. products.time 은 공유 time 모듈이라 import 때 바꾸면 다른 테스트의 # time.sleep 까지 바뀐다 — 이 파일 테스트 동안만 바꾼다(pytest fixture / 직접 실행은 _run_all, 검토 F10). _NO_SLEEP = lambda *_a, **_k: None # noqa: E731 try: import pytest except ImportError: # 직접 실행은 pytest 없이도 돈다 pytest = None if pytest is not None: @pytest.fixture(autouse=True, scope="module") def _no_sleep_in_this_file(): prev = products.time.sleep products.time.sleep = _NO_SLEEP try: yield finally: products.time.sleep = prev # 장애 주입 테스트가 남기는 logger.exception 출력은 결과와 무관하다 — 조용히. logging.getLogger("cafe24").setLevel(logging.CRITICAL) _TEST_ENV = { "CAFE24_MALL_ID": "testmall", "CAFE24_CLIENT_ID": "cid", "CAFE24_CLIENT_SECRET": "csecret", "CAFE24_REDIRECT_URI": "http://localhost:8080/cafe24/oauth/callback", "CAFE24_TOKEN_SECRET": SECRET, } def _config(): """환경변수에 의존하지 않도록 테스트용 값을 주입해 설정을 만든다.""" saved = {k: os.environ.get(k) for k in _TEST_ENV} os.environ.update(_TEST_ENV) try: return cfgmod.load_config() finally: for key, value in saved.items(): if value is None: os.environ.pop(key, None) else: os.environ[key] = value class _FakeRepo: """Cafe24Store 의 토큰 3개 메서드만 흉내낸다.""" def __init__(self, row=None): self.row = row self.saves: list[dict] = [] def get_token_row(self, mall_id): return self.row def save_token_row(self, *, mall_id, **fields): self.saves.append(fields) if self.row is None: self.row = {"mall_id": mall_id} self.row.update(fields) @contextmanager def token_lock(self, mall_id): outer = self class Handle: row = outer.row def save(self, **fields): outer.save_token_row(mall_id=mall_id, **fields) yield Handle() def _row(**overrides): row = { "mall_id": "testmall", "access_token": crypto.encrypt("AT", secret=SECRET), "refresh_token": crypto.encrypt("RT", secret=SECRET), "access_token_expires_at": now_kst() + timedelta(hours=1), "refresh_token_expires_at": now_kst() + timedelta(days=13), "scopes": "mall.read_product,mall.write_product", "last_refreshed_at": now_kst(), "last_error": "", "connected_by": "king@dbxcorp.co.kr", } row.update(overrides) return row # ════════════════════════════════════════════════════════════ # 암호화 # ════════════════════════════════════════════════════════════ def test_crypto_roundtrip(): token = "ACCESS-TOKEN-한글-123" encrypted = crypto.encrypt(token, secret=SECRET) assert encrypted != token and token not in encrypted assert crypto.decrypt(encrypted, secret=SECRET) == token def test_crypto_empty_passthrough(): assert crypto.encrypt("", secret=SECRET) == "" assert crypto.decrypt("", secret=SECRET) == "" def test_crypto_wrong_secret_raises(): encrypted = crypto.encrypt("AT", secret=SECRET) try: crypto.decrypt(encrypted, secret="다른키") except Cafe24ConfigError: return raise AssertionError("키가 바뀌면 Cafe24ConfigError 가 나야 한다") def test_crypto_requires_secret(): try: crypto.encrypt("x", secret="") except Cafe24ConfigError: return raise AssertionError("CAFE24_TOKEN_SECRET 없으면 예외여야 한다") # ════════════════════════════════════════════════════════════ # 설정 / 인증 URL # ════════════════════════════════════════════════════════════ def test_config_basics(): config = _config() assert config.configured assert config.missing == [] assert config.api_base == "https://testmall.cafe24api.com/api/v2" # 요청 scope 는 DEFAULT_SCOPES 한 곳에서 나온다(authorize 와 클라이언트가 # 어긋나지 않게). 늘어날 때 이 테스트도 함께 갱신할 것. assert config.scope_param == ",".join(cfgmod.DEFAULT_SCOPES) assert "mall.read_product" in config.scope_param assert "mall.write_product" in config.scope_param def test_product_url_uses_shop_url_env(): """다이렉트 주소는 CAFE24_SHOP_URL 기준. 스킴·끝 슬래시가 없어도 맞춘다.""" saved = os.environ.get("CAFE24_SHOP_URL") try: for value in ("https://miras.co.kr", "miras.co.kr", "https://miras.co.kr/"): os.environ["CAFE24_SHOP_URL"] = value config = _config() assert ( config.product_url(119) == "https://miras.co.kr/product/detail.html?product_no=119" ), value finally: if saved is None: os.environ.pop("CAFE24_SHOP_URL", None) else: os.environ["CAFE24_SHOP_URL"] = saved def test_product_url_falls_back_to_cafe24_domain(): """CAFE24_SHOP_URL 이 없어도 항상 유효한 주소가 나와야 한다.""" saved = os.environ.pop("CAFE24_SHOP_URL", None) try: assert _config().product_url(119) == ( "https://testmall.cafe24.com/product/detail.html?product_no=119" ) finally: if saved is not None: os.environ["CAFE24_SHOP_URL"] = saved def test_authorize_url_has_state_and_no_secret(): url = oauth.build_authorize_url(_config(), state="STATE123") assert url.startswith("https://testmall.cafe24api.com/api/v2/oauth/authorize?") assert "state=STATE123" in url # client_secret 은 authorize 단계에 절대 실리면 안 된다. assert "csecret" not in url # ════════════════════════════════════════════════════════════ # 토큰 상태 / 자동 갱신 # ════════════════════════════════════════════════════════════ def test_status_without_token(): status = tokens.TokenService(_FakeRepo(None), _config()).status() assert status["connected"] is False assert status["needs_reauth"] is True def test_status_never_leaks_token_values(): service = tokens.TokenService(_FakeRepo(_row()), _config()) status = service.status() assert status["connected"] is True assert "AT" not in str(status) and "RT" not in str(status) def test_valid_token_returned_without_refresh(): service = tokens.TokenService(_FakeRepo(_row()), _config()) assert service.get_access_token() == "AT" def test_expired_refresh_token_needs_reauth(): row = _row(refresh_token_expires_at=now_kst() - timedelta(days=1)) assert tokens.TokenService(_FakeRepo(row), _config()).status()["needs_reauth"] is True def test_expired_access_token_triggers_refresh(): """만료된 access token 은 refresh 후 새 값을 돌려주고, 저장은 암호문으로 한다.""" repo = _FakeRepo(_row(access_token_expires_at=now_kst() - timedelta(minutes=5))) service = tokens.TokenService(repo, _config()) seen: list[str] = [] def fake_refresh(config, *, refresh_token): seen.append(refresh_token) return oauth.TokenBundle( access_token="NEW-AT", refresh_token="NEW-RT", access_token_expires_at=now_kst() + timedelta(hours=2), refresh_token_expires_at=now_kst() + timedelta(days=14), scopes="mall.read_product,mall.write_product", ) original = tokens.refresh_tokens tokens.refresh_tokens = fake_refresh try: assert service.get_access_token() == "NEW-AT" finally: tokens.refresh_tokens = original assert seen == ["RT"] # 복호화된 refresh token 이 전달돼야 한다 saved = repo.saves[-1] assert saved["access_token"] != "NEW-AT" # 평문 저장 금지 assert crypto.decrypt(saved["access_token"], secret=SECRET) == "NEW-AT" assert saved["last_error"] == "" def test_dead_refresh_token_raises_auth_error(): row = _row( access_token_expires_at=now_kst() - timedelta(minutes=1), refresh_token_expires_at=now_kst() - timedelta(days=1), ) service = tokens.TokenService(_FakeRepo(row), _config()) try: service.get_access_token() except Cafe24AuthError as exc: assert exc.needs_reauth is True return raise AssertionError("refresh token 만료 시 Cafe24AuthError 여야 한다") # ════════════════════════════════════════════════════════════ # store.py 순수 로직 # ════════════════════════════════════════════════════════════ def test_schedule_editable_only_when_pending(): assert store.is_editable("PENDING") is True for locked in ("PROCESSING", "SUCCESS", "FAILED", "CANCELLED"): assert store.is_editable(locked) is False, locked def test_retry_budget_and_backoff(): assert all(store.can_retry(i) for i in range(store.MAX_RETRY)) assert store.can_retry(store.MAX_RETRY) is False # 무한 재시도 방지 — 간격은 증가하되 상한이 있다. assert store.retry_backoff_seconds(0) < store.retry_backoff_seconds(1) assert store.retry_backoff_seconds(99) == store.retry_backoff_seconds(2) def test_normalize_revision_type(): assert store.normalize_revision_type("backup") == store.REVISION_BACKUP assert store.normalize_revision_type("nope") == store.REVISION_DRAFT def test_parse_product_no(): assert store.parse_product_no(" 123 ") == 123 for bad in ("abc", "0", "-3", None, ""): try: store.parse_product_no(bad) except ValueError: continue raise AssertionError(f"{bad!r} 는 거부해야 한다") # ════════════════════════════════════════════════════════════ # 상품 엔드포인트 래퍼 # 실제 쇼핑몰 확인 결과 /admin/products/{no}/description 은 존재하지 않는다 # (`No API found.`). 상세설명은 상품 리소스의 필드다 — 경로가 되돌아가지 않게 # 여기서 고정한다. # ════════════════════════════════════════════════════════════ class _FakeClient: """Cafe24Client 의 get/put 만 흉내내고 호출을 기록한다.""" def __init__(self, payload=None): self.payload = payload or {} self.calls: list[dict] = [] def get(self, path, *, params=None, json=None, product_no=None): self.calls.append({"method": "GET", "path": path, "params": params}) return self.payload def put(self, path, *, params=None, json=None, product_no=None): self.calls.append({"method": "PUT", "path": path, "json": json}) return self.payload _PRODUCT = { "product_no": 131, "product_code": "P000000B", "product_name": "빠져락 1개(사은품)", "display": "T", "selling": "F", "description": "

PC

", "mobile_description": "

PC

", "separated_mobile_description": "F", } def test_descriptions_from_product(): desc = products.descriptions_from_product(_PRODUCT) assert desc.product_no == 131 assert desc.description == "

PC

" assert desc.separated_mobile is False assert desc.mobile_differs is False def test_descriptions_separated_mobile_and_diff(): desc = products.descriptions_from_product( {**_PRODUCT, "separated_mobile_description": "T", "mobile_description": "

MO

"} ) assert desc.separated_mobile is True assert desc.mobile_differs is True def test_fetch_descriptions_uses_product_resource(): client = _FakeClient({"product": _PRODUCT}) desc = products.fetch_descriptions(client, 131) assert desc.description == "

PC

" paths = [c["path"] for c in client.calls] assert paths == ["/admin/products/131"], paths assert not any(p.endswith("/description") for p in paths) def test_update_descriptions_payload(): client = _FakeClient({"product": _PRODUCT}) products.update_descriptions(client, 131, description="

NEW

") call = client.calls[0] assert call["method"] == "PUT" and call["path"] == "/admin/products/131" # mobile_description 은 절대 보내지 않는다 — 보내면 카페24가 모바일 상세설명 # 설정을 "직접 등록"으로 바꿔버린다(실물 확인). separated_mobile_description="F" # 만 지정해 "PC 상세설명과 동일"을 강제한다. assert call["json"] == {"request": {"description": "

NEW

", "separated_mobile_description": "F"}} def test_update_payload_optional_fields(): both = products.build_update_payload( description="

PC

", mobile_description="

MO

", shop_no=1 ) assert both == {"shop_no": 1, "request": {"description": "

PC

", "mobile_description": "

MO

"}} # 빈 문자열은 "모바일을 비운다"는 뜻이므로 None 과 구분해 전달돼야 한다. assert products.build_update_payload(description="x", mobile_description="")["request"] == { "description": "x", "mobile_description": "", } def test_normalize_product_flags(): row = products.normalize_product(_PRODUCT) assert row == { "product_no": 131, "product_code": "P000000B", "product_name": "빠져락 1개(사은품)", "display": True, "selling": False, } # 값이 없으면 기본 True(카페24 응답에 필드가 빠진 경우 진열 중으로 본다). assert products.normalize_product({"product_no": "9"})["display"] is True class _PagingClient: """페이지를 넘겨가며 응답하는 가짜 클라이언트.""" def __init__(self, count: int): self.count = count self.calls: list[dict] = [] def get(self, path, *, params=None, json=None, product_no=None): self.calls.append(dict(params or {})) offset = int((params or {}).get("offset", 0)) limit = int((params or {}).get("limit", 100)) page = [{"product_no": n} for n in range(offset, min(offset + limit, self.count))] return {"products": page} def test_list_all_products_walks_pages(): client = _PagingClient(230) rows, truncated = products.list_all_products(client) assert len(rows) == 230 and truncated is False # 100 + 100 + 30 → 3회 호출로 끝나야 한다. assert len(client.calls) == 3 assert [c["offset"] for c in client.calls] == [0, 100, 200] def test_list_all_products_stops_at_cap(): """상한을 넘으면 잘렸다고 알린다 — 무한 호출로 API 제한에 걸리지 않게.""" client = _PagingClient(10_000) rows, truncated = products.list_all_products(client, max_items=150) assert len(rows) == 150 and truncated is True def test_list_all_products_single_page(): """현재 쇼핑몰(87개)은 1회 호출로 끝난다.""" client = _PagingClient(87) rows, truncated = products.list_all_products(client) assert len(rows) == 87 and truncated is False assert len(client.calls) == 1 def test_list_products_clamps_paging(): client = _FakeClient({"products": []}) products.list_products(client, limit=999, offset=-5, product_name="락") params = client.calls[0]["params"] assert params["limit"] == products.PAGE_LIMIT assert params["offset"] == 0 assert params["product_name"] == "락" # ════════════════════════════════════════════════════════════ # 이미지 URL 한글 파일명 표시 ↔ 저장 (왕복 보존이 핵심) # ════════════════════════════════════════════════════════════ _REAL_IMG = "%EC%9A%A9%EA%B8%B0%EB%83%84%EC%83%88%EC%B0%A8%EB%8B%A8(%ED%99%A9%ED%86%A0)_12.gif" _REAL_HTML = f'용기 냄새차단' def test_decode_shows_korean_filename(): decoded = store.decode_html_urls(_REAL_HTML) assert "용기냄새차단(황토)_12.gif" in decoded assert "%EC%9A%A9" not in decoded # 괄호는 원본에서 인코딩돼 있지 않으므로 그대로 남아야 한다. assert "(황토)" in decoded def test_url_roundtrip_is_byte_identical(): """편집하지 않고 적용해도 카페24 저장값이 달라지면 안 된다.""" assert store.encode_html_urls(store.decode_html_urls(_REAL_HTML)) == _REAL_HTML def test_ascii_escapes_are_not_decoded(): """%20·%3C 를 풀면 URL·HTML 구조가 깨진다 — 건드리지 않는다.""" html = '' assert store.decode_html_urls(html) == html assert store.encode_html_urls(html) == html def test_encode_leaves_body_text_alone(): """본문 한글은 인코딩 대상이 아니다(URL 속성값만 바꾼다).""" html = '

여름 특가 안내

보기' encoded = store.encode_html_urls(html) assert "

여름 특가 안내

" in encoded assert 'href="/web/%EC%97%AC%EB%A6%84.html"' in encoded def test_css_url_is_handled(): html = "" assert "황토.png" in store.decode_html_urls(html) assert store.encode_html_urls(store.decode_html_urls(html)) == html def test_invalid_utf8_sequence_left_alone(): """EUC-KR 등 UTF-8 이 아닌 이스케이프는 깨뜨리지 않고 그대로 둔다.""" html = '' assert store.decode_html_urls(html) == html # ════════════════════════════════════════════════════════════ # 소스 정리(포맷) — 렌더링을 바꾸지 않는 것이 최우선 # ════════════════════════════════════════════════════════════ _MESSY = ( '' '

안녕하세요 여름 특가

' '' "
12
" ) def test_format_breaks_block_tags(): out = store.format_html(_MESSY) lines = out.split("\n") assert '
' in lines assert "
" in lines # 블록 안쪽은 들여쓴다. assert any(line.startswith(" ") for line in lines) assert any(line.startswith(" ") == "" # 길면 나눈다. long_text = "가" * 200 assert "\n" in store.format_html("" % long_text) def test_format_survives_broken_html(): """닫는 태그 누락·꺾쇠 조각이 있어도 예외 없이 뭔가를 돌려준다.""" for bad in ("

열고 안 닫음", "a < b 그리고 c > d", "<<>>", "x

") assert payload["request"] == {"description": "

x

"} def test_update_product_skips_empty_request(): """바꿀 것이 없으면 API 를 호출하지 않는다.""" client = _FakeClient({"product": _PRODUCT}) assert products.update_product(client, 131) == {} assert client.calls == [] def test_update_product_sends_flags_and_html(): client = _FakeClient({"product": _PRODUCT}) products.update_product(client, 131, description="

새

", display=False) call = client.calls[0] assert call["method"] == "PUT" and call["path"] == "/admin/products/131" assert call["json"] == {"request": {"description": "

새

", "display": "F"}} # ════════════════════════════════════════════════════════════ # 디자인 보관함 FTP — 모바일 스와이프 / PC·모바일 상품상세 템플릿 # ════════════════════════════════════════════════════════════ def test_ftp_config_host_falls_back_to_mall_id(): """CAFE24_FTP_HOST 미설정 시 카페24 규칙({mall_id}.ftp.cafe24.com)을 쓴다.""" saved = os.environ.pop("CAFE24_FTP_HOST", None) try: cfg = cfgmod.load_ftp_config(mall_id="testmall") assert cfg.host == "testmall.ftp.cafe24.com" assert cfg.port == cfgmod.DEFAULT_FTP_PORT finally: if saved is not None: os.environ["CAFE24_FTP_HOST"] = saved def test_ftp_config_missing_lists_absent_vars(): cfg = cfgmod.Cafe24FtpConfig(host="", port=21, user="", password="") assert cfg.configured is False assert cfg.missing == ["CAFE24_FTP_HOST", "CAFE24_FTP_USER", "CAFE24_FTP_PASSWORD"] full = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p") assert full.configured is True assert full.missing == [] def test_design_file_specs_cover_all_three_files(): """상단 탭 3개(모바일 스와이프/모바일 상품상세/PC 상품상세)가 모두 등록돼 있는가.""" assert set(cfgmod.DESIGN_FILE_SPECS) == {"swiper", "mobile_detail", "pc_detail"} assert cfgmod.design_file_label("swiper") == "모바일 스와이프" assert cfgmod.design_file_label("mobile_detail") == "모바일 상품상세" assert cfgmod.design_file_label("pc_detail") == "PC 상품상세" # 기본 경로(env 미설정 시) — 실물 확인된 값 assert cfgmod.design_file_path("mobile_detail") == "/sde_design/mobile11/product/detail.html" assert cfgmod.design_file_path("pc_detail") == "/sde_design/skin11/product/detail.html" def test_design_file_path_env_override(): saved = os.environ.get("CAFE24_PC_DETAIL_FTP_PATH") os.environ["CAFE24_PC_DETAIL_FTP_PATH"] = "/sde_design/skin99/product/detail.html" try: assert cfgmod.design_file_path("pc_detail") == "/sde_design/skin99/product/detail.html" finally: if saved is None: os.environ.pop("CAFE24_PC_DETAIL_FTP_PATH", None) else: os.environ["CAFE24_PC_DETAIL_FTP_PATH"] = saved _FTP_CFG = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p") _SWIPER = "/sde_design/mobile11/product-swiper/product-swiper.js" def test_design_ftp_read_and_write_roundtrip(): from app.integrations.cafe24 import design_ftp with fakes.patched_ftp() as ftp: ftp.reset({_SWIPER: "old".encode("utf-8")}) assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "old" design_ftp.write_text_file(_FTP_CFG, _SWIPER, "new content", expected_current="old") assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "new content" # 원본에 직접 STOR 하지 않는다 — 임시 파일에 올린 뒤 이름 바꾸기로 교체 stors = [e for e in ftp.log if e[0] == "STOR"] assert stors and all(".cf24tmp-" in e[1] for e in stors), ftp.log assert any(e[0] == "RENAME" and e[2] == _SWIPER for e in ftp.log) # 임시 파일이 남지 않는다 assert set(ftp.files) == {_SWIPER} def test_design_ftp_missing_file_raises_cafe24_error(): from app.integrations.cafe24 import design_ftp from app.integrations.cafe24.errors import Cafe24FtpError with fakes.patched_ftp() as ftp: ftp.reset({}) try: design_ftp.read_text_file(_FTP_CFG, "/missing.js") raise AssertionError("Cafe24FtpError 가 났어야 한다") except Cafe24FtpError: pass def test_design_ftp_truncated_upload_keeps_original(): """[04] 전송이 잘려도 원본은 그대로 — 임시 파일 검증에서 멈춘다.""" from app.integrations.cafe24 import design_ftp from app.integrations.cafe24.errors import Cafe24FtpError with fakes.patched_ftp() as ftp: ftp.reset({_SWIPER: b"ORIGINAL"}) ftp.truncate_store = True try: design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW CONTENT 1234", expected_current="ORIGINAL") raise AssertionError("잘린 업로드를 성공으로 처리했다") except Cafe24FtpError as exc: assert exc.maybe_applied is False assert ftp.files == {_SWIPER: b"ORIGINAL"} # 원본 그대로 + 임시 파일 정리 def test_design_ftp_rename_unsupported_aborts_without_direct_stor(): """[04] 이름 바꾸기를 지원하지 않으면 중단 — 원본에 직접 쓰지 않는다.""" from app.integrations.cafe24 import design_ftp from app.integrations.cafe24.errors import Cafe24FtpError with fakes.patched_ftp() as ftp: ftp.reset({_SWIPER: b"ORIGINAL"}) ftp.rename_mode = "unsupported" try: design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL") raise AssertionError("rename 미지원인데 진행했다") except Cafe24FtpError as exc: assert "rename" in str(exc) assert ftp.files == {_SWIPER: b"ORIGINAL"} assert not any(e == ("STOR", _SWIPER) for e in ftp.log) def test_design_ftp_no_overwrite_rename_swaps_safely(): """덮어쓰기 rename 을 거부하는 서버 — 원본을 비킨 뒤 교체하고 비킨 파일은 지운다.""" from app.integrations.cafe24 import design_ftp with fakes.patched_ftp() as ftp: ftp.reset({_SWIPER: b"ORIGINAL"}) ftp.rename_mode = "no_overwrite" design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL") assert ftp.files == {_SWIPER: b"NEW"} def test_design_ftp_conflict_right_before_replace(): """[04] 교체 직전 원본이 바뀌어 있으면(남이 수정) 덮지 않고 멈춘다.""" from app.integrations.cafe24 import design_ftp from app.integrations.cafe24.errors import Cafe24FtpConflict with fakes.patched_ftp() as ftp: ftp.reset({_SWIPER: b"SOMEONE ELSE"}) try: design_ftp.write_text_file(_FTP_CFG, _SWIPER, "MINE", expected_current="ORIGINAL") raise AssertionError("충돌을 못 잡았다") except Cafe24FtpConflict: pass assert ftp.files == {_SWIPER: b"SOMEONE ELSE"} # ════════════════════════════════════════════════════════════ # 예약 worker — 성공/재시도/최종실패/확인 필요/중단 복구 (메모리 저장소 대역) # 실제 DB 의 lease·SKIP LOCKED 는 test_cafe24_db.py 에서 검증한다. # ════════════════════════════════════════════════════════════ def _worker_env(description="

A

", **schedule): st = fakes.MemoryStore() cafe = fakes.FakeCafe24(description) api = fakes.FakeApi(cafe) rid = st.add_revision(product_no=131, html_content="

예약 내용

", revision_type="DRAFT") fields = {"revision_id": rid, "set_display": True} fields.update(schedule) sid = st.add_schedule(**fields) return st, cafe, api, sid, rid def test_worker_applies_html_and_flags(): st, cafe, api, sid, _rid = _worker_env() assert worker.process_once(st, api) == 1 # 쓰기 직전 현재값을 읽어 BACKUP 을 남겼는가 backups = st.of_type(store.REVISION_BACKUP) assert backups and backups[0]["html_content"] == "

A

" assert backups[0]["source"] == store.SOURCE_OBSERVED # HTML 과 진열 상태를 한 번의 PUT 으로 보냈는가 put = cafe.puts()[0] assert put[2]["request"]["description"] == "

예약 내용

" # mobile_description 은 보내지 않는다 — separated_mobile_description="F" 로 # "PC 상세설명과 동일"을 강제한다(직접 보내면 "직접 등록"으로 바뀌어버린다). assert "mobile_description" not in put[2]["request"] assert put[2]["request"]["separated_mobile_description"] == "F" assert put[2]["request"]["display"] == "T" assert "selling" not in put[2]["request"] # 변경 없음이면 보내지 않는다 row = st.schedules[sid] assert row["status"] == store.STATUS_SUCCESS and row["last_error"] == "" assert row["lease_token"] == "" # 끝나면 lease 를 비운다 assert len(st.of_type(store.REVISION_SCHEDULED)) == 1 assert list(st.attempts.values())[0]["status"] == store.ATTEMPT_RECORDED assert st.locks == {} # 상품 잠금 해제 def test_worker_flags_only_skips_backup(): """HTML 없이 진열/판매만 바꾸는 예약은 상세설명을 읽거나 백업하지 않는다.""" st, cafe, api, sid, _ = _worker_env(revision_id=None, set_selling=False) before = len(st.revisions) assert worker.process_once(st, api) == 1 assert len(st.revisions) == before # 백업·SCHEDULED 버전 없음 put = cafe.puts()[0] assert put[2]["request"] == {"display": "T", "selling": "F"} assert st.schedules[sid]["status"] == store.STATUS_SUCCESS def test_worker_retries_then_fails(): """거절(반영 안 됨이 확실)은 재시도 예산 안에서 다시 시도하고, 소진되면 FAILED.""" st, cafe, api, sid, _ = _worker_env() cafe.put_error = Cafe24ApiError("잘못된 요청", status=422) worker.process_once(st, api) first = st.schedules[sid] assert first["status"] == store.STATUS_PENDING # 다시 대기로 assert first["retry_count"] == 1 assert first["next_retry_at"] is not None assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED st2, cafe2, api2, sid2, _ = _worker_env(retry_count=store.MAX_RETRY) cafe2.put_error = Cafe24ApiError("서버 오류", status=400) worker.process_once(st2, api2) assert st2.schedules[sid2]["status"] == store.STATUS_FAILED assert any(a["result"] == "FAIL" for a in st2.audits) def test_worker_missing_revision_is_failure_not_crash(): st, _cafe, api, sid, _ = _worker_env(revision_id=999, retry_count=store.MAX_RETRY) worker.process_once(st, api) assert st.schedules[sid]["status"] == store.STATUS_FAILED assert "999" in st.schedules[sid]["last_error"] def test_worker_stops_when_nothing_due(): st = fakes.MemoryStore() assert worker.process_once(st, fakes.FakeApi(fakes.FakeCafe24())) == 0 def test_worker_unknown_result_needs_review_not_retry(): """[05][07] 응답 유실(반영 여부 모름) — 재시도로 한 번 더 쓰지 않고 확인 필요로 둔다.""" st, cafe, api, sid, _ = _worker_env() cafe.put_error = fakes.network_error(maybe_applied=True) cafe.put_error_after_apply = True worker.process_once(st, api) assert st.schedules[sid]["status"] == store.STATUS_NEEDS_REVIEW assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_UNKNOWN worker.process_once(st, api) assert len(cafe.puts()) == 1 # 다시 쓰지 않았다 def test_worker_remote_ok_but_record_failure_is_success_not_failed(): """[07] PUT 성공 뒤 로컬 버전 기록 실패 → FAILED 가 아니라 SUCCESS + 기록 복구 메모, 재적용 없음.""" st, cafe, api, sid, _ = _worker_env() st.fail_on.add("record_attempt_revision") worker.process_once(st, api) row = st.schedules[sid] assert row["status"] == store.STATUS_SUCCESS, row assert "기록" in row["last_error"] attempt = list(st.attempts.values())[-1] assert attempt["status"] == store.ATTEMPT_REMOTE_OK # 반영됨, 기록 복구 대기 # 다음 주기: 기록 복구만 하고 다시 PUT 하지 않는다 st.fail_on.clear() worker.process_once(st, api) assert len(cafe.puts()) == 1 assert attempt["status"] == store.ATTEMPT_RECORDED assert len(st.of_type(store.REVISION_SCHEDULED)) == 1 def test_worker_busy_product_defers_without_burning_retry(): """[02] 같은 상품을 다른 작업이 쓰는 중이면 쓰지 않고 잠시 뒤로 미룬다(재시도 횟수 그대로).""" st, cafe, api, sid, _ = _worker_env() st.acquire_lock("product:131", owner="king|web:1", purpose="상세설명 적용", ttl_seconds=60) worker.process_once(st, api) row = st.schedules[sid] assert row["status"] == store.STATUS_PENDING and row["retry_count"] == 0 assert row["next_retry_at"] is not None assert cafe.puts() == [] def test_worker_backup_uses_confirmed_last_write_during_lag(): """[06] 예약 직전 카페24가 읽기 지연으로 옛 HTML 을 돌려줘도, 백업은 마지막 확인된 적용값.""" st, cafe, api, sid, _ = _worker_env(description="

OLD

") # 방금 웹에서 NEW 를 적용(확인된 쓰기) — 카페24 GET 은 아직 OLD with writes.write_lock(st, "product:131", actor="king", purpose="t") as lock: writes.write_product(st, api, 131, lock=lock, origin=store.ORIGIN_MANUAL, actor="king", html="

NEW

", wait_confirm=False) cafe.stale = {**cafe.state, "description": "

OLD

", "mobile_description": "

OLD

", "updated_date": "2026-09-30T09:00:00+09:00"} worker.process_once(st, api) backups = [r for r in st.of_type(store.REVISION_BACKUP) if "예약" in r["memo"]] assert backups and backups[-1]["html_content"] == "

NEW

", backups assert backups[-1]["source"] == store.SOURCE_LAST_WRITE def test_worker_recovers_expired_processing_by_attempt_state(): """[05] lease 만료 PROCESSING — 시도 기록으로 판정(무조건 PENDING 금지).""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) rid = st.add_revision(product_no=131, html_content="

예약

", revision_type="DRAFT") def processing(**fields): sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="dead", started_at=now_kst(), **fields) st.expire_schedule_lease(sid) return sid # (1) 원격 쓰기 전에 죽음 → 재시도 대기 s1 = processing() # (2) 반영·기록까지 끝난 뒤 죽음 → 완료 s2 = processing() st.start_attempt(product_no=131, schedule_id=s2, origin="SCHEDULED", target_digest="x", target_revision_id=rid) st.attempts[max(st.attempts)]["status"] = store.ATTEMPT_RECORDED # (3) 반영됐고 기록 전에 죽음 → 기록 채우고 완료(재적용 없음) s3 = processing() a3 = st.start_attempt(product_no=131, schedule_id=s3, origin="SCHEDULED", target_digest=store.content_digest("

예약

"), target_revision_id=rid) st.attempts[a3]["status"] = store.ATTEMPT_REMOTE_OK # (4) PUT 도중 죽음, 카페24 값은 예약 결과와 다름 → 확인 필요 s4 = processing() st.start_attempt(product_no=131, schedule_id=s4, origin="SCHEDULED", target_digest=store.content_digest("

예약

"), target_revision_id=rid) # (5) 레거시(lease 없음) PROCESSING, 40분 전 → 만료로 보고 재시도 대기 s5 = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="", started_at=now_kst() - timedelta(minutes=40)) worker.recover(st, api) assert st.schedules[s1]["status"] == store.STATUS_PENDING and st.schedules[s1]["retry_count"] == 1 assert st.schedules[s2]["status"] == store.STATUS_SUCCESS assert st.schedules[s3]["status"] == store.STATUS_SUCCESS assert st.attempts[a3]["status"] == store.ATTEMPT_RECORDED assert st.schedules[s4]["status"] == store.STATUS_NEEDS_REVIEW assert st.schedules[s5]["status"] == store.STATUS_PENDING assert cafe.puts() == [] # 복구는 쓰지 않는다 def test_worker_recover_verifies_remote_value(): """[05] 결과 모름 시도라도 카페24 현재값이 예약 결과와 같으면 반영됨으로 확정.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

예약

") # 이미 반영돼 있다 api = fakes.FakeApi(cafe) rid = st.add_revision(product_no=131, html_content="

예약

", revision_type="DRAFT") sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="dead", started_at=now_kst()) st.expire_schedule_lease(sid) aid = st.start_attempt(product_no=131, schedule_id=sid, origin="SCHEDULED", target_digest=store.content_digest("

예약

"), target_revision_id=rid) worker.recover(st, api) assert st.schedules[sid]["status"] == store.STATUS_SUCCESS assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED def test_worker_late_finish_after_lease_loss_does_not_overwrite(): """[05] lease 를 잃은 worker 의 늦은 결과는 반영되지 않는다(token 불일치).""" st, _cafe, _api, sid, _ = _worker_env() row = st.claim_due_schedule(now=now_kst(), owner="w1", ttl_seconds=60) st.expire_schedule_lease(sid) st.claim_expired_schedules(owner="w2", ttl_seconds=60, legacy_minutes=30) assert st.finish_schedule(sid, token=row["lease_token"], status=store.STATUS_FAILED) is False assert st.schedules[sid]["status"] == store.STATUS_PROCESSING # ════════════════════════════════════════════════════════════ # 카페24 읽기 지연 보정 — 마지막 쓰기가 권위 # ════════════════════════════════════════════════════════════ def test_resolve_description_no_recent_write_uses_cafe24(): html, state = store.resolve_description("cafe", last_write=None, known_digests=set(), grace_minutes=60) assert (html, state) == ("cafe", store.SYNC_NONE) def _write(html, minutes_ago=1): return {"html_content": html, "created_at": now_kst() - timedelta(minutes=minutes_ago)} def test_resolve_description_synced_when_cafe24_caught_up(): html, state = store.resolve_description( "NEW", last_write=_write("NEW"), known_digests={store.content_digest("OLD")}, grace_minutes=60 ) assert (html, state) == ("NEW", store.SYNC_SYNCED) def test_resolve_description_pending_when_cafe24_returns_known_old_value(): # 카페24가 아직 적용 직전 값(BACKUP 으로 남긴 값)을 돌려준다 → 마지막 쓰기를 보여준다 digests = {store.content_digest("OLD"), store.content_digest("NEW")} html, state = store.resolve_description("OLD", last_write=_write("NEW"), known_digests=digests, grace_minutes=60) assert (html, state) == ("NEW", store.SYNC_PENDING) def test_resolve_description_pending_for_older_known_value_too(): # 연속 두 번 적용(A→B→C) 뒤 카페24가 A 를 돌려줘도 '아는 값'이므로 지연으로 본다 digests = {store.content_digest(v) for v in ("A", "B", "C")} html, state = store.resolve_description("A", last_write=_write("C"), known_digests=digests, grace_minutes=60) assert (html, state) == ("C", store.SYNC_PENDING) def test_resolve_description_external_when_unknown_value(): # 관리자에서 직접 고친 값 — 카페24를 믿는다 digests = {store.content_digest("OLD"), store.content_digest("NEW")} html, state = store.resolve_description("HAND", last_write=_write("NEW"), known_digests=digests, grace_minutes=60) assert (html, state) == ("HAND", store.SYNC_EXTERNAL) def test_resolve_description_grace_expired_trusts_cafe24(): digests = {store.content_digest("OLD"), store.content_digest("NEW")} html, state = store.resolve_description( "OLD", last_write=_write("NEW", minutes_ago=500), known_digests=digests, grace_minutes=60 ) assert (html, state) == ("OLD", store.SYNC_NONE) def test_resolve_description_accepts_iso_created_at(): lw = {"html_content": "NEW", "created_at": (now_kst() - timedelta(minutes=2)).isoformat()} html, state = store.resolve_description("OLD", last_write=lw, known_digests={store.content_digest("OLD")}, grace_minutes=60) assert (html, state) == ("NEW", store.SYNC_PENDING) def test_parse_grace_minutes(): assert store.parse_grace_minutes("30") == 30 assert store.parse_grace_minutes("") == store.DEFAULT_READ_LAG_GRACE_MIN assert store.parse_grace_minutes("-5") == store.DEFAULT_READ_LAG_GRACE_MIN assert store.parse_grace_minutes("abc") == store.DEFAULT_READ_LAG_GRACE_MIN def test_overlay_recent_write_uses_snapshot_when_get_is_older(): fetched = {"product_name": "OLD", "price": "1000.00", "updated_date": "2026-09-18T10:00:00+09:00", "description": "keep"} snap = {"product_name": "NEW", "price": "2000.00", "updated_date": "2026-09-18T10:05:00+09:00"} merged, stale = store.overlay_recent_write(fetched, snapshot=snap, written_at=now_kst(), grace_minutes=60) assert stale is True assert merged["product_name"] == "NEW" and merged["price"] == "2000.00" assert merged["description"] == "keep" # 스냅샷에 없는 필드는 그대로 assert merged["updated_date"] == snap["updated_date"] def test_overlay_recent_write_keeps_cafe24_when_caught_up(): fetched = {"product_name": "NEWER", "updated_date": "2026-09-18T10:06:00+09:00"} snap = {"product_name": "NEW", "updated_date": "2026-09-18T10:05:00+09:00"} merged, stale = store.overlay_recent_write(fetched, snapshot=snap, written_at=now_kst(), grace_minutes=60) assert stale is False and merged is fetched def test_overlay_recent_write_skips_without_dates_or_snapshot(): fetched = {"product_name": "X"} assert store.overlay_recent_write(fetched, snapshot=None, written_at=now_kst(), grace_minutes=60) == (fetched, False) snap = {"product_name": "NEW"} assert store.overlay_recent_write(fetched, snapshot=snap, written_at=now_kst(), grace_minutes=60) == (fetched, False) def test_overlay_recent_write_respects_grace(): fetched = {"product_name": "OLD", "updated_date": "2026-09-18T10:00:00+09:00"} snap = {"product_name": "NEW", "updated_date": "2026-09-18T10:05:00+09:00"} old = (now_kst() - timedelta(hours=10)).isoformat() assert store.overlay_recent_write(fetched, snapshot=snap, written_at=old, grace_minutes=60) == (fetched, False) def test_product_snapshot_keeps_only_scalar_fields(): snap = store.product_snapshot({"product_name": "A", "price": "1.00", "description": "", "updated_date": None, "display": "T"}) assert snap == {"product_name": "A", "price": "1.00", "display": "T"} # ════════════════════════════════════════════════════════════ # 기본 정보 · 옵션 · 품목 입력 검증 # ════════════════════════════════════════════════════════════ def test_parse_price(): assert store.parse_price("6,900") == "6900.00" assert store.parse_price("6900.00") == "6900.00" assert store.parse_price(6900) == "6900.00" assert store.parse_price("") is None assert store.parse_price(None) is None for bad in ("abc", "-1"): try: store.parse_price(bad) except ValueError: pass else: raise AssertionError(bad) assert store.price_equal("6900.00", "6900") and not store.price_equal("6900.00", "7000") def test_update_payload_price_and_image(): payload = products.build_update_payload(price="1000.00", supply_price="500.00", detail_image="/web/x.jpg") assert payload["request"] == { "price": "1000.00", "supply_price": "500.00", "detail_image": "/web/x.jpg", "image_upload_type": "A", } def test_parse_option_values(): assert store.parse_option_values("빨강, 파랑\n노랑,, 빨강 ") == ["빨강", "파랑", "노랑"] def test_build_create_options_request(): body = store.build_create_options_request("색상", ["빨강", "파랑"], display_type="p") assert body["has_option"] == "T" and body["option_type"] == "T" assert body["options"][0]["option_display_type"] == "P" assert [v["option_text"] for v in body["options"][0]["option_value"]] == ["빨강", "파랑"] for name, values in (("", ["a"]), ("x", [])): try: store.build_create_options_request(name, values) except ValueError: pass else: raise AssertionError((name, values)) def test_build_update_options_request_pairs_original_and_new(): original = [{"option_code": "O1", "option_name": "Color", "option_display_type": "S", "option_value": [{"option_text": "Black", "value_no": 1}, {"option_text": "Red", "value_no": 2}]}] edited = [{"option_name": "Colors", "option_display_type": "P", "option_value": [{"option_text": "Jet Black", "option_image_file": "https://d/x.png"}, {"option_text": "Deep Red"}]}] body = store.build_update_options_request(original, edited, option_list_type="S") assert body["option_list_type"] == "S" assert body["original_options"] == [{"option_code": "O1", "option_name": "Color", "option_value": [{"option_text": "Black", "value_no": 1}, {"option_text": "Red", "value_no": 2}]}] assert body["options"][0]["option_name"] == "Colors" assert body["options"][0]["option_display_type"] == "P" assert body["options"][0]["option_value"][0] == {"option_text": "Jet Black", "value_no": 1, "option_image_file": "https://d/x.png"} assert body["options"][0]["option_value"][1] == {"option_text": "Deep Red", "value_no": 2} def test_build_update_options_request_rejects_count_mismatch(): original = [{"option_name": "A", "option_value": [{"option_text": "1"}]}] for edited in ([], [{"option_name": "A", "option_value": []}], [{"option_name": "", "option_value": [{"option_text": "1"}]}]): try: store.build_update_options_request(original, edited) except ValueError: pass else: raise AssertionError(edited) # 덧붙이기는 allow_append 일 때만 more = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]}] try: store.build_update_options_request(original, more) except ValueError: pass else: raise AssertionError("append without flag accepted") body = store.build_update_options_request(original, more, allow_append=True) assert body["original_options"][0]["option_value"] == [{"option_text": "1"}] assert body["options"][0]["option_value"] == [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}] # 줄이기는 allow_append 여도 거부 (위치 짝맞춤으로 이름이 밀린다) two = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2"}]}] try: store.build_update_options_request(two, original, allow_append=True) except ValueError: pass else: raise AssertionError("shrink accepted") def test_delete_variant_wrapper(): client = _RouteClient({"DELETE /admin/products/7/variants/P000000R000A": {"variant": {"variant_code": "P000000R000A"}}}) products.delete_variant(client, 7, "p000000r000a") assert client.calls[-1][:2] == ("DELETE", "/admin/products/7/variants/P000000R000A") def test_build_variant_updates(): rows = [ {"variant_code": "p000000r000a", "custom_variant_code": " ABC ", "additional_amount": "1,000", "display": "on"}, {"variant_code": "P000000R000B"}, # 바뀐 것 없음 → 제외 {"variant_code": "P000000R000C", "selling": "off", "additional_amount": ""}, ] out = store.build_variant_updates(rows) assert out == [ {"variant_code": "P000000R000A", "custom_variant_code": "ABC", "additional_amount": "1000.00", "display": "T"}, {"variant_code": "P000000R000C", "selling": "F"}, ] try: store.build_variant_updates([{"variant_code": "bad"}]) except ValueError: pass else: raise AssertionError("bad code accepted") # 드래그 정렬 → display_order (1~300) assert store.build_variant_updates([{"variant_code": "P000000R000A", "display_order": "3"}]) == [ {"variant_code": "P000000R000A", "display_order": 3} ] for bad in ("0", "301", "x"): try: store.build_variant_updates([{"variant_code": "P000000R000A", "display_order": bad}]) except ValueError: pass else: raise AssertionError(bad) def test_parse_option_values_accepts_list(): assert store.parse_option_values(["빨강, 큰 것", " 파랑 ", "", "빨강, 큰 것"]) == ["빨강, 큰 것", "파랑"] def test_wait_for_variants_retries_until_expected(): calls = {"n": 0} class _Client: def get(self, path, **kw): calls["n"] += 1 return {"variants": [{"variant_code": "A"}] * (2 if calls["n"] >= 3 else 1)} out = products.wait_for_variants(_Client(), 7, 2, attempts=5) assert len(out) == 2 and calls["n"] == 3 class _RouteClient: """경로별 응답을 돌려주는 가짜 클라이언트 (get/put/post/delete).""" def __init__(self, routes): self.routes = routes self.calls: list[tuple] = [] def _call(self, method, path, json=None, **_kw): self.calls.append((method, path, json)) return self.routes.get(f"{method} {path}", {}) def get(self, path, **kw): return self._call("GET", path, **kw) def put(self, path, **kw): return self._call("PUT", path, **kw) def post(self, path, **kw): return self._call("POST", path, **kw) def delete(self, path, **kw): return self._call("DELETE", path, **kw) def test_upload_images_and_variants_wrappers(): client = _RouteClient({ "POST /admin/products/images": {"images": [{"path": "https://d/a.png"}, {"path": "https://d/b.png"}]}, "PUT /admin/products/7/variants": {"variants": [{"variant_code": "P000000R000A", "display": "F"}]}, "GET /admin/products/7/variants": {"variants": [{"variant_code": "P000000R000A"}]}, "GET /admin/products/7/options": {"option": {"has_option": "T", "options": []}}, "DELETE /admin/products/7/options": {"option": {"product_no": 7}}, }) assert products.upload_images(client, ["AAA", "BBB"]) == ["https://d/a.png", "https://d/b.png"] assert products.upload_image_bytes(client, b"\x89PNG") == "https://d/a.png" assert products.list_variants(client, 7) == [{"variant_code": "P000000R000A"}] assert products.get_options(client, 7)["has_option"] == "T" assert products.update_variants(client, 7, [{"variant_code": "P000000R000A", "display": "F"}]) == [ {"variant_code": "P000000R000A", "status": "ok", "error": "", "variant": {"variant_code": "P000000R000A", "display": "F"}} ] sent = [c for c in client.calls if c[0] == "PUT"][-1] assert sent[2]["requests"][0]["variant_code"] == "P000000R000A" products.delete_options(client, 7) assert client.calls[-1][0] == "DELETE" def test_set_main_image_uses_product_images_endpoint(): """대표이미지는 POST /products/{no}/images 에 data URI 로 A 타입 등록 — 새 경로 4개를 돌려준다.""" client = _RouteClient({ "POST /admin/products/13/images": {"image": { "shop_no": 1, "product_no": 13, "detail_image": "https://d/web/product/big/x.png", "list_image": "https://d/web/product/medium/x.png", "tiny_image": "https://d/web/product/tiny/x.png", "small_image": "https://d/web/product/small/x.png", }}, }) out = products.set_main_image(client, 13, b"\x89PNG", content_type="image/png") assert out == { "detail_image": "https://d/web/product/big/x.png", "list_image": "https://d/web/product/medium/x.png", "tiny_image": "https://d/web/product/tiny/x.png", "small_image": "https://d/web/product/small/x.png", } method, path, body = client.calls[-1] assert (method, path) == ("POST", "/admin/products/13/images") assert body["shop_no"] == 1 assert body["request"]["image_upload_type"] == "A" assert body["request"]["detail_image"].startswith("data:image/png;base64,") # 상품 PUT(detail_image 경로 넣기)은 더 이상 쓰지 않는다 assert not [c for c in client.calls if c[0] == "PUT"] assert products.set_main_image(client, 13, b"") == {} # ════════════════════════════════════════════════════════════ # 쓰기 공통 처리(writes.write_product) — [01][02][06][07] 회귀 # ════════════════════════════════════════════════════════════ def _apply(st, api, html, *, fp=None, origin=store.ORIGIN_MANUAL, actor="king", **kw): with writes.write_lock(st, "product:131", actor=actor, purpose="t", wait_seconds=0) as lock: return writes.write_product(st, api, 131, lock=lock, origin=origin, actor=actor, html=html, base_fingerprint=fp, wait_confirm=False, **kw) def _editor_view(st, cafe): """편집기가 보여줄 유효 현재값과 지문(routes_products._editor_ctx 와 같은 판정).""" product = cafe.get(f"/admin/products/{cafe.product_no}")["product"] effective, state, _ = writes.resolve_effective(st, 131, product["description"], fetched_updated=product.get("updated_date")) return effective, state, store.fingerprint(effective) def test_01_rejected_conflict_backup_does_not_mask_external_edit(): """[01] 충돌로 거절된 적용의 BACKUP(=외부 값 X)이 읽기 지연 근거가 되면 X 를 덮어쓴다.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) _apply(st, api, "

W1

") # 우리 쓰기(확인됨) _eff, _state, stale_fp = _editor_view(st, cafe) # 사용자 1: W1 을 보고 편집 시작 cafe.external_edit("

X

") # 관리자에서 직접 X 로 고침 try: _apply(st, api, "

Y

", fp=stale_fp) # 사용자 1 적용 → 충돌로 거절(BACKUP X 가 남는다) raise AssertionError("충돌을 못 잡았다") except writes.WriteConflict: pass assert any(r["html_content"] == "

X

" for r in st.of_type(store.REVISION_BACKUP)) effective, state, fp = _editor_view(st, cafe) assert (effective, state) == ("

X

", store.SYNC_EXTERNAL), (effective, state) try: _apply(st, api, "

Y

", fp=stale_fp) # 같은 옛 지문으로 다시 → 여전히 충돌 raise AssertionError("외부 수정 X 를 덮어썼다") except writes.WriteConflict: pass assert cafe.state["description"] == "

X

" _apply(st, api, "

Y

", fp=fp) # 새로 본 X 기준이면 적용된다 assert cafe.state["description"] == "

Y

" def test_01_draft_value_is_not_treated_as_known(): """[01] 예약 초안(DRAFT)은 카페24에 올라간 적이 없다 — 관리자가 그 값으로 고쳐도 외부 변경.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) _apply(st, api, "

W1

") st.add_revision(product_no=131, html_content="

D

", revision_type="DRAFT") cafe.external_edit("

D

") assert _editor_view(st, cafe)[:2] == ("

D

", store.SYNC_EXTERNAL) def test_01_read_lag_still_shows_last_confirmed_write(): """읽기 지연 보정은 유지 — GET 이 쓰기 직전 값(A)을 돌려주면 마지막 확인된 쓰기를 보여준다.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) _apply(st, api, "

B

") cafe.stale = {**cafe.state, "description": "

A

", "updated_date": "2026-09-30T09:00:00+09:00"} assert _editor_view(st, cafe)[:2] == ("

B

", store.SYNC_PENDING) _apply(st, api, "

C

") # A→B→C 직후 GET 이 A 여도 지연 assert _editor_view(st, cafe)[:2] == ("

C

", store.SYNC_PENDING) def test_01_revert_after_our_write_detected_by_updated_date(): """[01] 관리자가 우리 적용 뒤 예전 값(A)으로 되돌림 — updated_date 가 더 뒤라 외부 변경.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) _apply(st, api, "

B

") cafe.external_edit("

A

") assert _editor_view(st, cafe)[:2] == ("

A

", store.SYNC_EXTERNAL) def test_01_failed_write_is_not_lineage(): """[01] 카페24가 거절한 쓰기는 "마지막 쓰기"가 아니다.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) cafe.put_error = Cafe24ApiError("거절", status=422) try: _apply(st, api, "

B

") raise AssertionError("실패를 삼켰다") except writes.RemoteWriteFailed: pass assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED assert _editor_view(st, cafe)[:2] == ("

A

", store.SYNC_NONE) assert st.of_type(store.REVISION_MANUAL) == [] def test_02_second_writer_is_serialized_and_detects_conflict(): """[02] 같은 편집 기준(A)으로 두 사람이 동시에 적용 — 잠금으로 순서가 생기고 뒤 사람은 충돌.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) fp_a = store.fingerprint("

A

") with writes.write_lock(st, "product:131", actor="alice", purpose="t", wait_seconds=0): try: # 앞 사람이 쓰는 동안 뒤 사람은 잠금을 못 잡는다 with writes.write_lock(st, "product:131", actor="bob", purpose="t", wait_seconds=0): raise AssertionError("잠금이 겹쳤다") except writes.WriteBusy as exc: assert "alice" in str(exc) _apply(st, api, "

ALICE

", fp=fp_a, actor="alice") cafe.stale = {**cafe.state, "description": "

A

", "updated_date": "2026-09-30T09:00:00+09:00"} try: # GET 이 지연으로 A 를 돌려줘도, 마지막 확인된 쓰기(ALICE)가 기준이라 충돌 _apply(st, api, "

BOB

", fp=fp_a, actor="bob") raise AssertionError("둘 다 성공했다") except writes.WriteConflict: pass assert cafe.state["description"] == "

ALICE

" def test_02_expired_lock_cannot_write_fencing(): """[02] 잠금이 만료돼 남에게 넘어간 뒤에는 PUT 하지 않는다(펜싱).""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) with writes.write_lock(st, "product:131", actor="slow", purpose="t", wait_seconds=0) as lock: st.expire_lock("product:131") with writes.write_lock(st, "product:131", actor="other", purpose="t", wait_seconds=0): pass # 만료 뒤 다른 요청이 가져갔다가 풀었다 try: writes.write_product(st, api, 131, lock=lock, origin="MANUAL", actor="slow", html="

S

", wait_confirm=False) raise AssertionError("만료된 잠금으로 썼다") except writes.WriteBusy: pass assert cafe.puts() == [] def test_02_schema_missing_refuses_to_write(): st = fakes.MemoryStore() st.schema_ok = False try: with writes.write_lock(st, "product:131", actor="k", purpose="t"): raise AssertionError("스키마 없이 잠금을 줬다") except writes.WriteSetupError as exc: assert "005" in str(exc) def test_06_manual_backup_marks_source(): """[06] BACKUP 메타데이터 — 관측값(OBSERVED) / 지연 중 마지막 확인된 쓰기(LAST_WRITE).""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) first = _apply(st, api, "

B

") b1 = st.revisions[first.backup_id] assert (b1["html_content"], b1["source"]) == ("

A

", store.SOURCE_OBSERVED) cafe.stale = {**cafe.state, "description": "

A

", "updated_date": "2026-09-30T09:00:00+09:00"} second = _apply(st, api, "

C

") b2 = st.revisions[second.backup_id] assert (b2["html_content"], b2["source"]) == ("

B

", store.SOURCE_LAST_WRITE) assert b2["source_revision_id"] == first.revision_id def test_07_manual_record_failure_is_not_apply_failure(): """[07] PUT 성공 뒤 버전 기록 실패 — 예외 없이 record_error, 시도는 REMOTE_OK(기록 복구 대기).""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) st.fail_on.add("record_attempt_revision") out = _apply(st, api, "

B

") assert out.record_error and not out.revision_id attempt = st.attempts[out.attempt_id] assert attempt["status"] == store.ATTEMPT_REMOTE_OK and attempt["target_html"] == "

B

" # 기록이 없어도 확인된 쓰기로 본다 — 지연 중에도 B 를 보여준다 cafe.stale = {**cafe.state, "description": "

A

", "updated_date": "2026-09-30T09:00:00+09:00"} assert _editor_view(st, cafe)[:2] == ("

B

", store.SYNC_PENDING) # 다음 쓰기 때 기록을 채운다(다시 PUT 하지 않음) st.fail_on.clear() puts = len(cafe.puts()) cafe.stale = None _apply(st, api, "

C

") assert attempt["status"] == store.ATTEMPT_RECORDED and attempt["target_html"] == "" assert len(cafe.puts()) == puts + 1 # C 쓰기 한 번뿐 def test_07_unknown_result_blocks_rewrite_until_verified(): """[07] 응답 유실 — UNKNOWN. 확정 전에는 같은 상품 상세설명을 다시 쓰지 않는다. 카페24 값이 그 시도의 결과와 같아지면(=반영됨) 자동으로 확정한다.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) cafe.put_error = fakes.network_error(maybe_applied=True) try: _apply(st, api, "

B

") raise AssertionError("결과 모름을 성공/실패로 판정했다") except writes.RemoteWriteUnknown as exc: aid = exc.attempt_id assert st.attempts[aid]["status"] == store.ATTEMPT_UNKNOWN cafe.put_error = None try: _apply(st, api, "

C

") raise AssertionError("결과 모름 시도가 있는데 또 썼다") except writes.WriteBlocked: pass cafe.state.update(description="

B

") # 확인해 보니 반영돼 있었다 _apply(st, api, "

C

") assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED assert [r["html_content"] for r in st.of_type(store.REVISION_MANUAL)] == ["

B

", "

C

"] def test_07_connect_error_is_definite_failure(): """연결조차 안 된 오류는 반영 안 됨이 확실 — UNKNOWN 이 아니라 REMOTE_FAILED.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") cafe.put_error = fakes.network_error(maybe_applied=False) try: _apply(st, fakes.FakeApi(cafe), "

B

") except writes.RemoteWriteFailed: pass assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED def test_rollback_records_rollback_revision(): """[13] 선택 복원은 정상 경로로 한 번 적용하고 ROLLBACK(원본 버전 표시)을 남긴다.""" st = fakes.MemoryStore() cafe = fakes.FakeCafe24("

A

") api = fakes.FakeApi(cafe) first = _apply(st, api, "

B

") backup = first.backup_id # A out = _apply(st, api, st.revisions[backup]["html_content"], fp=store.fingerprint("

B

"), origin=store.ORIGIN_ROLLBACK, target_revision_id=backup, memo=f"버전 {backup} 복원") assert cafe.state["description"] == "

A

" rb = st.revisions[out.revision_id] assert rb["revision_type"] == "ROLLBACK" and rb["source_revision_id"] == backup assert rb["html_content"] == "

A

" # ════════════════════════════════════════════════════════════ # 스냅샷 병합 · 품목 표기 · 옵션 모양 — [10][11] # ════════════════════════════════════════════════════════════ def test_11_variant_snapshot_field_merge(): at = now_kst().isoformat() a = store.merge_variant_snapshot({}, {"V1": {"custom_variant_code": "C1"}}, at=at) b = store.merge_variant_snapshot(a, {"V1": {"display": "F"}}, at=at) assert b["V1"]["custom_variant_code"] == "C1" and b["V1"]["display"] == "F" def test_11_empty_patch_is_not_reset_but_replace_is(): at = now_kst().isoformat() a = store.merge_variant_snapshot({}, {"V1": {"display": "F"}}, at=at) assert store.merge_variant_snapshot(a, {}, at=at) == a assert store.merge_variant_snapshot(a, {}, at=at, replace=True) == {} def test_11_deleted_variant_is_not_resurrected(): at = now_kst().isoformat() a = store.merge_variant_snapshot({}, {"V1": {"_deleted": True}}, at=at) b = store.merge_variant_snapshot(a, {"V1": {"display": "T", "custom_variant_code": "X"}}, at=at) assert b["V1"].get("_deleted") is True and "custom_variant_code" not in b["V1"] v = store.apply_variant_patch({"variant_code": "V1"}, b["V1"], section_written_at=at, grace_minutes=60) assert v is None def test_11_per_code_grace(): old = (now_kst() - timedelta(hours=10)).isoformat() patch = {"display": "F", "_at": old} v = store.apply_variant_patch({"variant_code": "V1", "display": "T"}, patch, section_written_at=now_kst().isoformat(), grace_minutes=60) assert v["display"] == "T" # 그 품목 기록은 유예시간이 지났다 def test_10_lagging_variant_labels_matched_by_code(): """[10] 옵션값 이름 변경 직후 GET 품목이 옛 이름 — 품목코드 기록으로 새 이름을 보여준다.""" at = now_kst().isoformat() patch = {"options": [{"name": "색상", "value": "Jet"}], "_options_before": [[{"name": "색상", "value": "Black"}]], "_at": at} lag = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Black"}]}, patch, section_written_at=at, grace_minutes=60) assert lag["options"] == [{"name": "색상", "value": "Jet"}] ext = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Onyx"}]}, patch, section_written_at=at, grace_minutes=60) assert ext["options"] == [{"name": "색상", "value": "Onyx"}] # 관리자에서 다시 고친 이름은 믿는다 def test_10_options_overlay_respects_external_change(): at = now_kst().isoformat() before = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Black"}]}]} ours = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Jet"}]}]} other = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Onyx"}]}]} snap = {**ours, "_before_signatures": [store.options_signature(before)]} assert store.overlay_options(before, snapshot=snap, written_at=at, grace_minutes=60) == (snap, True) assert store.overlay_options(other, snapshot=snap, written_at=at, grace_minutes=60) == (other, False) assert store.overlay_options(ours, snapshot=snap, written_at=at, grace_minutes=60) == (ours, False) def test_05_recovery_decision_table(): rd = store.recovery_decision assert rd(None, 0)[0] == store.RECOVER_RETRY assert rd(None, store.MAX_RETRY)[0] == store.RECOVER_FAIL assert rd({"status": "RECORDED"}, 0)[0] == store.RECOVER_SUCCESS assert rd({"status": "REMOTE_OK"}, 0)[0] == store.RECOVER_RECORD assert rd({"status": "REMOTE_FAILED"}, 0)[0] == store.RECOVER_RETRY assert rd({"status": "STARTED"}, 0)[0] == store.RECOVER_REVIEW assert rd({"status": "UNKNOWN"}, 99)[0] == store.RECOVER_REVIEW # 예산과 무관하게 사람 확인 def test_resolve_description_updated_date_rule(): lw = {"html_content": "B", "created_at": now_kst(), "remote_updated_at": "2026-09-30T10:05:00+09:00"} digests = {store.content_digest("A")} newer = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60, fetched_updated="2026-09-30T10:06:00+09:00") same = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60, fetched_updated="2026-09-30T10:05:00+09:00") older = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60, fetched_updated="2026-09-30T10:00:00+09:00") assert newer == ("A", store.SYNC_EXTERNAL) assert same == ("B", store.SYNC_PENDING) and older == ("B", store.SYNC_PENDING) # ════════════════════════════════════════════════════════════ # 품목 일괄 수정 행별 결과 — [09] # ════════════════════════════════════════════════════════════ class _ChunkClient: def __init__(self, fail_chunk: int, error): self.fail_chunk = fail_chunk self.error = error self.n = 0 def put(self, path, *, json=None, **kw): self.n += 1 if self.n == self.fail_chunk: raise self.error return {"variants": [{"variant_code": r["variant_code"], "display": r.get("display")} for r in json["requests"]]} def _codes(n): return [{"variant_code": f"P0000000{i:04d}", "display": "F"} for i in range(n)] def test_09_partial_chunk_failure_reports_per_row(): rows = products.update_variants(_ChunkClient(2, Cafe24ApiError("거절", status=422)), 7, _codes(150)) assert [r["status"] for r in rows[:100]] == ["ok"] * 100 assert [r["status"] for r in rows[100:]] == ["failed"] * 50 assert rows[0]["variant"]["display"] == "F" and rows[120]["error"] == "거절" def test_09_first_chunk_failure_still_sends_second(): client = _ChunkClient(1, fakes.network_error(maybe_applied=True)) rows = products.update_variants(client, 7, _codes(150)) assert client.n == 2 assert {r["status"] for r in rows[:100]} == {"unknown"} assert {r["status"] for r in rows[100:]} == {"ok"} # ════════════════════════════════════════════════════════════ # 전송 계층 — 쓰기 요청이 카페24에 닿았을 수 있는가(maybe_applied) # ════════════════════════════════════════════════════════════ def _client_with(handler): import httpx from app.integrations.cafe24 import client as client_mod class _Tokens: def get_access_token(self): return "AT" def force_expire(self): pass real = httpx.Client transport = httpx.MockTransport(handler) client_mod.httpx.Client = lambda **kw: real(transport=transport, **kw) client_mod.time.sleep = lambda *_a, **_k: None return client_mod.Cafe24Client(_config(), _Tokens(), min_interval=0), (client_mod, real) def _restore(saved): client_mod, real = saved client_mod.httpx.Client = real def test_client_maybe_applied_classification(): import httpx cases = [ ("PUT", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), True), ("PUT", lambda req: (_ for _ in ()).throw(httpx.ConnectError("c", request=req)), False), ("PUT", lambda req: httpx.Response(500, json={"error": {"message": "서버"}}), True), ("PUT", lambda req: httpx.Response(422, json={"error": {"message": "검증"}}), False), ("GET", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), False), ] for method, handler, expected in cases: client, saved = _client_with(handler) try: client.request(method, "/admin/products/1", json={"request": {}} if method == "PUT" else None) raise AssertionError("오류가 나야 한다") except Cafe24ApiError as exc: assert exc.maybe_applied is expected, (method, expected, str(exc)) finally: _restore(saved) def _run_all(): products.time.sleep = _NO_SLEEP # 직접 실행 = 이 프로세스는 이 파일 테스트만 fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)] for fn in fns: fn() print("PASS", fn.__name__) print(f"\n{len(fns)} tests passed.") if __name__ == "__main__": _run_all()
") for line in lines) def test_format_keeps_inline_elements_together(): """이미지 사이에 줄바꿈이 들어가면 화면에 공백이 생긴다 — 붙여둬야 한다.""" out = store.format_html(_MESSY) assert '' in out assert "

안녕하세요 여름 특가

" in out def test_format_preserves_style_content_verbatim(): out = store.format_html(_MESSY) assert "\t/* 주석 */" in out assert "\t.v{max-width:100%}" in out def test_format_is_idempotent(): """편집하지 않고 다시 적용해도 저장값이 계속 바뀌면 안 된다.""" once = store.format_html(_MESSY) assert store.format_html(once) == once assert store.format_html(store.format_html(once)) == once _REAL_DETAIL = """
""" def test_format_indents_every_line_of_a_run(): """원문 줄바꿈을 살리고 **모든 줄**을 들여쓴다. 예전에는 첫 줄만 들여쓰고 나머지가 1열에 붙어 나왔다. """ lines = store.format_html(_REAL_DETAIL).split("\n") img_lines = [line for line in lines if "` 는 붙여둔다 — 나누면 라벨과 대상이 떨어진다.""" out = store.format_html(_REAL_DETAIL) assert "\n\n\n\n\n\n\n") assert "\n\n" in out assert "\n\n\n" not in out def test_format_real_detail_is_idempotent(): once = store.format_html(_REAL_DETAIL) assert store.format_html(once) == once def test_format_collapses_short_blocks(): assert store.format_html("
11%s