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 后端结构盘点文档

server/api/suite.py

@@ -3,26 +3,23 @@
 按 docs/v2.1/api.md §2-6 实现：引擎平移自 image-suite-studio（services/planner|generator|
 tasks|watermark + services/prompts），任务存进程内内存表（重启即失效）。
 生成图回调回写 product_assets(group_key='generated')；product_id 缺省时只落盘不回写。
+业务逻辑（texts_to_raw / 模型校验 / generated 回写）在 services/suite_service.py。
 注：V2.1 阶段本组接口暂不接鉴权（现有鉴权后续可能重做）。
 """
 from __future__ import annotations
 
 import io
-import mimetypes
 import uuid
 import zipfile
+from functools import partial
 
 from fastapi import APIRouter, BackgroundTasks, HTTPException
 from fastapi.responses import StreamingResponse
 
 from config import get_settings
-from db import get_session_factory
-from models import Product, ProductAsset
 from schemas.suite import (
     PLATFORM_SPECS,
-    RIGHTAPI_MODELS,
     SUPPORTED_TYPES,
-    TONGYI_MODELS,
     ImageEditSingleRequest,
     ImageEditSingleResponse,
     PlanItemOut,
@@ -31,88 +28,18 @@ from schemas.suite import (
     SuiteGenerateRequest,
     SuiteOut,
     SuitePlanRequest,
-    TextMaterial,
     resolve_provider,
 )
 from services.generator import _image_size, GENERATORS, run_suite
 from services.planner import generate_plan
 from services.prompts import build_context, build_prompt, type_name
 from services.storage import download_bytes, get_storage, local_path
-from services.tasks import IMG_OK, Task, TaskImage, create_task, get_task
-from api.proxy import guess_referer
+from services.suite_service import append_generated_asset, texts_to_raw, validate_model
+from services.tasks import IMG_OK, create_task, get_task
 
 router = APIRouter(prefix="/api", tags=["suite"])
 
 
-def texts_to_raw(texts: list[TextMaterial]) -> dict:
-    """前端组装的文本素材 → prompt 上下文用的 raw dict（后写的覆盖先写的）。"""
-    raw: dict = {}
-    for t in texts:
-        if t.kind == "title" and t.content:
-            raw["title"] = t.content
-        elif t.kind == "price" and t.content:
-            raw["price"] = t.content
-        elif t.kind == "brand" and t.content:
-            raw["brand"] = t.content
-        elif t.kind == "params" and t.pairs:
-            merged = {p["key"]: p["value"] for p in (raw.get("params") or [])}
-            for p in t.pairs:
-                merged.setdefault(p["key"], p["value"])
-            raw["params"] = [{"key": k, "value": v} for k, v in merged.items()]
-        elif t.kind == "selling_point" and t.content:
-            raw["sellingPoints"] = t.content
-        elif t.kind == "desc" and t.content:
-            raw["desc"] = t.content
-        elif t.kind == "sales" and t.content:
-            raw["sales"] = t.content
-        elif t.kind == "shop" and t.content:
-            raw["shop"] = t.content
-    return raw
-
-
-def _validate_model(provider_name: str, model: str | None) -> None:
-    if provider_name == "tongyi" and model and model not in TONGYI_MODELS:
-        raise HTTPException(status_code=400, detail=f"不支持的模型: {model}（tongyi 支持: {TONGYI_MODELS}）")
-    if provider_name == "rightapi" and model and model not in RIGHTAPI_MODELS:
-        raise HTTPException(status_code=400, detail=f"不支持的模型: {model}（rightapi 支持: {RIGHTAPI_MODELS}）")
-
-
-# ── 生成图回写商品素材 ────────────────────────────────────────────────────
-
-async def _append_generated_asset(product_id: str, image: TaskImage) -> str | None:
-    """把一张生成完成的图追加为 product_assets(generated)，并累加 asset_counts。返回 asset_id。"""
-    from sqlalchemy import func, select
-
-    pid = uuid.UUID(product_id)
-    async with get_session_factory()() as db:
-        count = await db.scalar(
-            select(func.count(ProductAsset.id)).where(
-                ProductAsset.product_id == pid,
-                ProductAsset.group_key == "generated",
-            )
-        )
-        asset = ProductAsset(
-            product_id=pid,
-            group_key="generated",
-            variant_name=None,
-            sort_order=count or 0,
-            type="img",
-            source_url="",
-            stored_url=image.url,
-            status="uploaded",
-        )
-        db.add(asset)
-        await db.flush()
-
-        product = await db.get(Product, pid)
-        if product is not None:
-            counts = dict(product.asset_counts or {})
-            counts["generated"] = int(counts.get("generated") or 0) + 1
-            product.asset_counts = counts
-        await db.commit()
-        return str(asset.id)
-
-
 # ── 出图方案规划 ──────────────────────────────────────────────────────────
 
 @router.post("/suite/plan", response_model=PlanResponse)
@@ -173,7 +100,7 @@ async def generate_suite(req: SuiteGenerateRequest, background: BackgroundTasks)
     settings = get_settings()
     # 前端只传模型名：已知模型直接路由到对应 provider（如 gpt-image-2-vip → rightapi）
     provider_name = resolve_provider(req.model, None, settings.image_provider)
-    _validate_model(provider_name, req.model)
+    validate_model(provider_name, req.model)
 
     product_id = (req.product_id or "").strip() or None
     if product_id:
@@ -207,8 +134,13 @@ async def generate_suite(req: SuiteGenerateRequest, background: BackgroundTasks)
         ],
     )
 
-    # 每张成功即回写 generated 组；未关联商品时仅落存储不回写
-    background.add_task(run_suite, task, _append_generated_asset if product_id else None)
+    # 每张成功即回写 generated 组；未关联商品时仅落存储不回写。
+    # partial 绑定 product_id：run_suite 回调只传 image，签名须为 (image)
+    background.add_task(
+        run_suite,
+        task,
+        partial(append_generated_asset, product_id) if product_id else None,
+    )
     return SuiteCreateResponse(suite_id=task.id)
 
 
@@ -279,7 +211,7 @@ async def suite_image_edit(req: ImageEditSingleRequest) -> ImageEditSingleRespon
     provider_name = resolve_provider(req.model, None, settings.image_provider)
     if provider_name not in GENERATORS:
         raise HTTPException(status_code=400, detail=f"未知 provider: {provider_name}")
-    _validate_model(provider_name, req.model)
+    validate_model(provider_name, req.model)
 
     spec = {"lang": "ru", "ratio": "3:4"}  # 试算页固定 Ozon 规格（俄文图内文案 · 3:4）
     model = req.model
@@ -311,7 +243,7 @@ async def suite_image_edit(req: ImageEditSingleRequest) -> ImageEditSingleRespon
     asset_id: str | None = None
     if req.append and req.product_id:
         try:
-            asset_id = await _append_generated_asset(
+            asset_id = await append_generated_asset(
                 req.product_id,
                 TaskImage(type_id="custom", name="AI生图", url=url, status="ok"),
             )