chore(cafe24): 정리 전 완료된 작업 보존

Cafe24 수정, 테스트 및 DB 마이그레이션 파일을 함께 기록한다.
This commit is contained in:
2026-10-01 02:29:19 +09:00
parent 81b1204693
commit 91bdc12e78
20 changed files with 4632 additions and 845 deletions
+63 -56
View File
@@ -13,8 +13,11 @@
다른 데이터를 다루지만, 여기는 파일마다 경로만 다르고 나머지는 동일하다).
쓰기 순서는 상세페이지 적용과 동일한 원칙을 따른다:
FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부) → FTP 에 쓴다
파일별 DB 잠금(writes.write_lock, 'design:{file_key}')
→ FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부)
→ 임시 파일 업로드·검증 → 교체 직전 원본 재확인 → 이름 바꾸기로 교체
(design_ftp.write_text_file — 원본에 직접 STOR 하지 않는다)
→ MANUAL 버전 + 감사로그
핸들러는 `async def` 가 아니라 `def`(동기)다 — FTP 호출이 블로킹이므로
@@ -24,12 +27,14 @@ FastAPI 스레드풀에서 돌게 둔다(다른 cafe24 라우트와 동일한
from __future__ import annotations
import logging
from urllib.parse import quote
from fastapi import APIRouter, Form, HTTPException, Request
from fastapi.responses import HTMLResponse, RedirectResponse
from app.integrations.cafe24 import (
DESIGN_FILE_SPECS,
Cafe24FtpConflict,
Cafe24FtpError,
design_file_label,
design_file_path,
@@ -38,7 +43,7 @@ from app.integrations.cafe24 import (
load_ftp_config,
)
from . import store
from . import store, writes
from .common import base_ctx, guard
from .routes_products import _no_store
@@ -128,74 +133,76 @@ def design_file_apply(
st, user = checked
actor = str(user.get("email") or "")
back = f"/cafe24/design/{file_key}"
action = f"apply_design:{file_key}"
def go(*, msg: str = "", err: str = "") -> RedirectResponse:
key, text = ("err", err) if err else ("msg", msg)
return RedirectResponse(url=f"{back}?{key}={quote(text, safe='')}", status_code=303)
path = design_file_path(file_key)
ftp_config = _ftp_config()
if not ftp_config.configured:
return RedirectResponse(
url=f"{back}?err=" + "FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing),
status_code=303,
)
return go(err="FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing))
# 브라우저 textarea 는 줄바꿈을 CRLF 로 보낸다 — 그대로 저장하면 실제 수정이
# 없어도 매번 파일 전체의 줄바꿈이 바뀌어(지문 비교·"변경 없음" 판정이 어긋난다).
submitted = content.replace("\r\n", "\n")
if not submitted.strip():
return RedirectResponse(
url=f"{back}?err=" + "내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.",
status_code=303,
)
return go(err="내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.")
# 같은 파일을 두 사람이 동시에 적용하지 못하게 파일별 DB 잠금 안에서 한다.
try:
current = design_ftp.read_text_file(ftp_config, path)
except Cafe24FtpError as exc:
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", result="FAIL",
detail=f"현재값 조회 실패: {exc}",
)
return RedirectResponse(url=f"{back}?err=현재 파일을 읽지 못해 중단했습니다: {exc}", status_code=303)
with writes.write_lock(st, writes.design_lock_key(file_key), actor=actor, purpose=f"{file_key} 적용"):
try:
current = design_ftp.read_text_file(ftp_config, path)
except Cafe24FtpError as exc:
writes.audit_safe(st, actor=actor, action=action, result="FAIL", detail=f"현재값 조회 실패: {exc}")
return go(err=f"현재 파일을 읽지 못해 중단했습니다: {exc}")
backup_id = st.add_design_revision(
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업", created_by=actor,
)
backup_id = st.add_design_revision(
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업", created_by=actor,
)
if base_fingerprint and base_fingerprint != store.fingerprint(current):
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨",
)
return RedirectResponse(
url=f"{back}?err=편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
status_code=303,
)
if base_fingerprint and base_fingerprint != store.fingerprint(current):
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨")
return go(err="편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.")
if submitted == current:
return RedirectResponse(url=f"{back}?msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)
if submitted == current:
return go(msg="변경된 내용이 없어 적용하지 않았습니다.")
try:
design_ftp.write_text_file(ftp_config, path, submitted)
except Cafe24FtpError as exc:
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
result="FAIL", detail=str(exc),
)
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
return RedirectResponse(
url=f"{back}?err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
status_code=303,
)
try:
# 임시 파일 업로드 → 검증 → 교체 직전 원본 재확인(current 와 같아야) → 이름 바꾸기.
design_ftp.write_text_file(ftp_config, path, submitted, expected_current=current)
except Cafe24FtpConflict as exc:
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="FAIL", detail=f"충돌 — 교체 직전 파일이 변경됨: {exc}")
return go(err=f"{exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
except Cafe24FtpError as exc:
maybe = bool(getattr(exc, "maybe_applied", False))
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="UNKNOWN" if maybe else "FAIL", detail=str(exc))
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
return go(err=f"적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
revision_id = st.add_design_revision(
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
memo=memo, created_by=actor,
)
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=revision_id, result="SUCCESS",
detail=f"{len(submitted)}자 적용 (백업 {backup_id})",
# 파일은 이미 바뀌었다 — 여기서의 기록 실패는 "적용 실패"가 아니다.
record_note = ""
try:
revision_id = st.add_design_revision(
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
memo=memo, created_by=actor,
)
except Exception: # noqa: BLE001
logger.exception("디자인 파일(%s) 적용 후 버전 기록 실패", file_key)
revision_id = None
record_note = " ※ 파일은 적용됐지만 버전 기록 저장에 실패했습니다 — 다시 적용하지 마세요."
except (writes.WriteBusy, writes.WriteSetupError) as exc:
return go(err=str(exc))
writes.audit_safe(
st, actor=actor, action=action, revision_id=revision_id, result="SUCCESS",
detail=f"{len(submitted)}자 적용 (백업 {backup_id}, 임시 파일 교체 방식)" + (" / 버전 기록 실패" if record_note else ""),
)
logger.info("디자인 파일 적용(%s) (%s)", file_key, actor)
return RedirectResponse(
url=f"{back}?msg=적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.",
status_code=303,
)
return go(msg=f"적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.{record_note}")