feat(cafe24): 모바일 스와이프(product-swiper.js) 편집 화면 추가 (FTP)

- product-swiper.js는 상품이 아니라 카페24 "디자인 보관함" 스킨 파일이라
  Admin API(OAuth)로는 접근 불가 — 실물 확인(스크린샷) 결과 디자인 보관함
  FTP 계정(호스트/포트/ID/PW, OAuth와 별개)으로만 읽기/쓰기 가능.
  app/integrations/cafe24/design_ftp.py 를 표준 ftplib 로 새로 추가.
- 상단 탭에 "모바일 스와이프" 버튼 추가. 편집 화면(swiper.html)은 상세페이지
  편집기(_editor.html)와 완전히 같은 문법강조·색상·단축키 JS를 그대로 옮겨
  씀(요청사항) — 상품 전용 UI(목록·진열/판매·예약)는 제외.
- 적용 순서도 상세페이지와 동일한 원칙: FTP에서 현재값 재조회 → BACKUP →
  지문 대조(충돌 거부) → FTP 쓰기 → MANUAL 버전 + 감사로그(apply_swiper).
  textarea의 CRLF는 적용 전 LF로 정규화(안 하면 매번 "변경됨"으로 오판).
- 버전 이력은 cafe24_product_revisions(product_no NOT NULL)에 넣을 수 없어
  새 테이블 cafe24_swiper_revisions 추가(scripts/sql/cafe24_db_003_*.sql,
  서버에서 별도 실행 필요).
- 신규 env: CAFE24_FTP_HOST(미설정 시 {mall_id}.ftp.cafe24.com)/PORT/USER/
  PASSWORD, CAFE24_SWIPER_FTP_PATH. .env.example·문서 갱신.
- 유닛테스트 4건 추가(FTP config 기본값, 가짜 FTP로 읽기/쓰기 왕복·오류 처리).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/modules/cafe24/db.py

@@ -319,6 +319,50 @@ class Cafe24Store:
             ).fetchone()
         return self._serialize(row)
 
+    # ════════════════════════════════════════════════════════════
+    # 모바일 스와이프(product-swiper.js) 버전 (append-only)
+    # 상품이 아니라 디자인 보관함 FTP 파일이라 별도 테이블을 쓴다
+    # (cafe24_product_revisions.product_no 는 NOT NULL).
+    # ════════════════════════════════════════════════════════════
+    SWIPER_FILE_KEY = "product-swiper"
+
+    def add_swiper_revision(
+        self, *, content: str, revision_type: str, memo: str = "", created_by: str = ""
+    ) -> int:
+        with self._pool.connection() as conn:
+            row = conn.execute(
+                """
+                INSERT INTO cafe24_swiper_revisions
+                    (file_key, content, revision_type, memo, created_by)
+                VALUES (%s,%s,%s,%s,%s)
+                RETURNING id
+                """,
+                (
+                    self.SWIPER_FILE_KEY,
+                    content or "",
+                    store.normalize_revision_type(revision_type),
+                    (memo or "")[:500],
+                    created_by or "",
+                ),
+            ).fetchone()
+        return int(row["id"]) if row else 0
+
+    def list_swiper_revisions(self, *, limit: int = 20) -> list[dict[str, Any]]:
+        """버전 목록. content 는 커질 수 있어 길이만 계산해서 준다."""
+        with self._pool.connection() as conn:
+            rows = conn.execute(
+                """
+                SELECT id, revision_type, memo, created_by, created_at,
+                       length(content) AS html_length
+                FROM cafe24_swiper_revisions
+                WHERE file_key = %s
+                ORDER BY created_at DESC, id DESC
+                LIMIT %s
+                """,
+                (self.SWIPER_FILE_KEY, max(1, min(int(limit), 200))),
+            ).fetchall()
+        return [self._serialize(r) for r in rows]
+
     # ════════════════════════════════════════════════════════════
     # 예약 (지정 시각에 상세페이지·진열/판매 적용)
     # 되돌리기는 쓰지 않으므로 end_* 컬럼은 건드리지 않는다.