refactor(server): 移除鉴权并归档遗留路由至 legacy/

- 删除 auth.py 与 deps.py，各路由去除 get_current_user 依赖 - collection.py 更名为 materials.py，冻结链路（ozon/publish/shops/categories）移入 legacy/ - 扩展默认生图服务端口并入 8800 并自动迁移旧配置，水印默认文案改为 Panda Store - 新增 docs/v2.1/backend-structure.md 后端结构盘点文档
2026-08-28 15:09:22 +08:00
parent 2835914fd8
commit dc6d38c128
44 changed files with 1556 additions and 389 deletions
@@ -0,0 +1,181 @@
+"""发布端点：提交 ImportProductsV3 + 后台轮询回填。"""
+# ⚠️ 冻结代码（Ozon API 直传链路）：保留不维护，V2.1 起接口保留但不再投入。
+from __future__ import annotations
+
+import asyncio
+from datetime import datetime, timezone
+from uuid import UUID
+
+from fastapi import APIRouter, BackgroundTasks, Depends, HTTPException
+from pydantic import BaseModel
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from core.security import decrypt_secret
+from db import get_db, get_session_factory
+from models import Product
+from legacy.models import PublishTask, Shop
+from models.enums import PublishStatus, Stage
+from legacy.services.ozon_client import OzonClient, OzonAPIError
+from legacy.services.publish import build_import_item, validate_ready
+
+router = APIRouter(prefix="/api", tags=["publish"])
+
+
+class PublishRequest(BaseModel):
+    shop_id: str
+
+
+def _client(shop: Shop) -> OzonClient:
+    return OzonClient(decrypt_secret(shop.client_id_enc), decrypt_secret(shop.api_key_enc))
+
+
+@router.post("/products/{product_id}/publish")
+async def publish_product(
+    product_id: str,
+    body: PublishRequest,
+    background: BackgroundTasks,
+    db: AsyncSession = Depends(get_db)
+):
+    product = await db.get(Product, UUID(product_id))
+    if product is None:
+        raise HTTPException(status_code=404, detail="商品不存在")
+    shop = await db.get(Shop, UUID(body.shop_id))
+    if shop is None:
+        raise HTTPException(status_code=404, detail="店铺不存在")
+
+    missing = validate_ready(product)
+    if missing:
+        raise HTTPException(status_code=422, detail=f"缺少必填项：{'、'.join(missing)}")
+
+    item = build_import_item(product)
+    client = _client(shop)
+    try:
+        result = await client.post("/v3/product/import", {"items": [item]})
+    except OzonAPIError as exc:
+        raise HTTPException(status_code=502, detail=exc.detail)
+
+    task_id = (result.get("result") or {}).get("task_id")
+    if not task_id:
+        raise HTTPException(status_code=502, detail=f"Ozon 未返回 task_id：{result}")
+
+    task = PublishTask(
+        product_id=product.id,
+        shop_id=shop.id,
+        ozon_task_id=int(task_id),
+        status=PublishStatus.pending,
+        request_payload=item,
+    )
+    db.add(task)
+    product.stage = Stage.publishing
+    await db.commit()
+    await db.refresh(task)
+
+    background.add_task(_poll, str(task.id))
+    return {"task_id": str(task.id), "ozon_task_id": task.ozon_task_id}
+
+
+async def _poll(task_id: str) -> None:
+    """后台轮询 import/info，直到 imported / failed 或超时（约 40s）。"""
+    async with get_session_factory()() as db:
+        task = await db.get(PublishTask, UUID(task_id))
+        if task is None:
+            return
+        shop = await db.get(Shop, task.shop_id)
+        product = await db.get(Product, task.product_id)
+        if shop is None or product is None:
+            return
+        client = _client(shop)
+
+        for attempt in range(8):
+            try:
+                result = await client.post("/v1/product/import/info", {"task_id": task.ozon_task_id})
+            except OzonAPIError as exc:
+                task.status = PublishStatus.failed
+                task.errors = [{"error": exc.detail}]
+                task.completed_at = datetime.now(timezone.utc)
+                product.stage = Stage.failed
+                await db.commit()
+                return
+
+            items = (result.get("result") or {}).get("items") or []
+            item = items[0] if items else {}
+            status = item.get("status", "")
+            product_id = item.get("product_id")
+            errors = item.get("errors") or []
+
+            if status == "imported":
+                task.status = PublishStatus.imported
+                task.response = item
+                task.completed_at = datetime.now(timezone.utc)
+                if product_id:
+                    product.ozon_product_id = int(product_id)
+                product.stage = Stage.published
+                product.published_at = datetime.now(timezone.utc)
+                await db.commit()
+                return
+
+            if status == "failed":
+                task.status = PublishStatus.failed
+                task.errors = errors
+                task.response = item
+                task.completed_at = datetime.now(timezone.utc)
+                product.stage = Stage.failed
+                await db.commit()
+                return
+
+            # pending / moderation → 继续等
+            task.status = PublishStatus.moderation if status in ("moderating", "moderation") else PublishStatus.processing
+            if product_id:
+                product.ozon_product_id = int(product_id)
+            await db.commit()
+            await asyncio.sleep(5 * (attempt + 1))
+
+        # 超时未定：保留 processing，前端可刷新
+        task.status = PublishStatus.moderation
+        task.response = item
+        await db.commit()
+
+
+@router.get("/publish/{task_id}")
+async def get_publish_task(
+    task_id: str,
+    db: AsyncSession = Depends(get_db)
+):
+    task = await db.get(PublishTask, UUID(task_id))
+    if task is None:
+        raise HTTPException(status_code=404, detail="发布任务不存在")
+    return {
+        "id": str(task.id),
+        "product_id": str(task.product_id),
+        "shop_id": str(task.shop_id),
+        "ozon_task_id": task.ozon_task_id,
+        "status": task.status.value,
+        "errors": task.errors,
+        "response": task.response,
+        "created_at": task.created_at,
+        "completed_at": task.completed_at,
+    }
+
+
+@router.get("/products/{product_id}/publish-history")
+async def publish_history(
+    product_id: str,
+    db: AsyncSession = Depends(get_db)
+):
+    rows = (await db.scalars(
+        select(PublishTask)
+        .where(PublishTask.product_id == UUID(product_id))
+        .order_by(PublishTask.created_at.desc())
+    )).all()
+    return [
+        {
+            "id": str(t.id),
+            "ozon_task_id": t.ozon_task_id,
+            "status": t.status.value,
+            "errors": t.errors,
+            "created_at": t.created_at,
+            "completed_at": t.completed_at,
+        }
+        for t in rows
+    ]