refactor: optimize backend module

domain/plugins/__init__.py

@@ -0,0 +1 @@
+

domain/plugins/api.py

@@ -0,0 +1,66 @@
+from typing import List
+
+from fastapi import APIRouter, Body, Request
+
+from domain.audit import AuditAction, audit
+from domain.plugins.service import PluginService
+from domain.plugins.types import PluginCreate, PluginManifestUpdate, PluginOut
+
+router = APIRouter(prefix="/api/plugins", tags=["plugins"])
+
+
+@router.post("", response_model=PluginOut)
+@audit(
+    action=AuditAction.CREATE,
+    description="创建插件",
+    body_fields=["url", "enabled"],
+)
+async def create_plugin(request: Request, payload: PluginCreate):
+    return await PluginService.create(payload)
+
+
+@router.get("", response_model=List[PluginOut])
+@audit(action=AuditAction.READ, description="获取插件列表")
+async def list_plugins(request: Request):
+    return await PluginService.list_plugins()
+
+
+@router.delete("/{plugin_id}")
+@audit(action=AuditAction.DELETE, description="删除插件")
+async def delete_plugin(request: Request, plugin_id: int):
+    await PluginService.delete(plugin_id)
+    return {"code": 0, "msg": "ok"}
+
+
+@router.put("/{plugin_id}", response_model=PluginOut)
+@audit(
+    action=AuditAction.UPDATE,
+    description="更新插件",
+    body_fields=["url", "enabled"],
+)
+async def update_plugin(request: Request, plugin_id: int, payload: PluginCreate):
+    return await PluginService.update(plugin_id, payload)
+
+
+@router.post("/{plugin_id}/metadata", response_model=PluginOut)
+@audit(
+    action=AuditAction.UPDATE,
+    description="更新插件 manifest",
+    body_fields=[
+        "key",
+        "name",
+        "version",
+        "supported_exts",
+        "default_bounds",
+        "default_maximized",
+        "icon",
+        "description",
+        "author",
+        "website",
+        "github",
+    ],
+)
+async def update_manifest(
+    request: Request, plugin_id: int, manifest: PluginManifestUpdate = Body(...)
+):
+    return await PluginService.update_manifest(plugin_id, manifest)

domain/plugins/service.py

@@ -0,0 +1,48 @@
+from fastapi import HTTPException
+
+from domain.plugins.types import PluginCreate, PluginManifestUpdate, PluginOut
+from models.database import Plugin
+
+
+class PluginService:
+    @classmethod
+    async def create(cls, payload: PluginCreate) -> PluginOut:
+        rec = await Plugin.create(**payload.model_dump())
+        return PluginOut.model_validate(rec)
+
+    @classmethod
+    async def list_plugins(cls) -> list[PluginOut]:
+        rows = await Plugin.all().order_by("-id")
+        return [PluginOut.model_validate(r) for r in rows]
+
+    @classmethod
+    async def _get_or_404(cls, plugin_id: int) -> Plugin:
+        rec = await Plugin.get_or_none(id=plugin_id)
+        if not rec:
+            raise HTTPException(status_code=404, detail="Plugin not found")
+        return rec
+
+    @classmethod
+    async def delete(cls, plugin_id: int) -> None:
+        rec = await cls._get_or_404(plugin_id)
+        await rec.delete()
+
+    @classmethod
+    async def update(cls, plugin_id: int, payload: PluginCreate) -> PluginOut:
+        rec = await cls._get_or_404(plugin_id)
+        rec.url = payload.url
+        rec.enabled = payload.enabled
+        await rec.save()
+        return PluginOut.model_validate(rec)
+
+    @classmethod
+    async def update_manifest(
+        cls, plugin_id: int, manifest: PluginManifestUpdate
+    ) -> PluginOut:
+        rec = await cls._get_or_404(plugin_id)
+        updates = manifest.model_dump(exclude_none=True)
+        if updates:
+            for key, value in updates.items():
+                setattr(rec, key, value)
+            await rec.save()
+        return PluginOut.model_validate(rec)

domain/plugins/types.py

@@ -0,0 +1,52 @@
+from typing import Any, Dict, List, Optional
+
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field
+
+
+class PluginCreate(BaseModel):
+    url: str = Field(min_length=1)
+    enabled: bool = True
+
+
+class PluginManifestUpdate(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+    key: Optional[str] = None
+    name: Optional[str] = None
+    version: Optional[str] = None
+    supported_exts: Optional[List[str]] = Field(
+        default=None,
+        validation_alias=AliasChoices("supported_exts", "supportedExts"),
+    )
+    default_bounds: Optional[Dict[str, Any]] = Field(
+        default=None,
+        validation_alias=AliasChoices("default_bounds", "defaultBounds"),
+    )
+    default_maximized: Optional[bool] = Field(
+        default=None,
+        validation_alias=AliasChoices("default_maximized", "defaultMaximized"),
+    )
+    icon: Optional[str] = None
+    description: Optional[str] = None
+    author: Optional[str] = None
+    website: Optional[str] = None
+    github: Optional[str] = None
+
+
+class PluginOut(BaseModel):
+    id: int
+    url: str
+    enabled: bool
+    key: Optional[str] = None
+    name: Optional[str] = None
+    version: Optional[str] = None
+    supported_exts: Optional[List[str]] = None
+    default_bounds: Optional[Dict[str, Any]] = None
+    default_maximized: Optional[bool] = None
+    icon: Optional[str] = None
+    description: Optional[str] = None
+    author: Optional[str] = None
+    website: Optional[str] = None
+    github: Optional[str] = None
+
+    model_config = ConfigDict(from_attributes=True)