astrbot_plugin_imagestudio/backend/routes/material_routes.py
2026-07-06 03:37:17 +08:00

275 行
8.8 KiB
Python

"""Material library route handlers."""
from __future__ import annotations
from typing import Any
from backend.dto.common import ApiError
from backend.dto.material_dto import Material, MaterialListResult
from backend.routes.common import handle_request
from backend.services.material_service import MaterialService
from backend.services.media_service import MediaService
from backend.services.model_provider_runtime import ModelProviderRuntime
from backend.services.model_provider_service import ModelProviderService
from core.audit_service import AuditService
from core.identity import RequestContext
from core.security import require_authenticated, require_permission
from database.db_helper import Database, load_database_settings
from database.repositories.material_repository import MaterialRepository
from database.repositories.model_provider_repository import ModelProviderRepository
def list_material_categories(
ctx: RequestContext,
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> list[dict[str, Any]]:
require_authenticated(ctx)
return [category.to_dict() for category in material_service.list_categories()]
return handle_request(ctx, action)
def create_material_category(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.create_category(payload, ctx).to_dict()
return handle_request(ctx, action)
def update_material_category(
ctx: RequestContext,
category_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.update_category(category_id, payload, ctx).to_dict()
return handle_request(ctx, action)
def delete_material_category(
ctx: RequestContext,
category_id: str,
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.delete_category(category_id, ctx).to_dict()
return handle_request(ctx, action)
def list_materials(
ctx: RequestContext,
query: dict[str, Any] | None = None,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
params = query or {}
def action() -> dict[str, Any]:
require_authenticated(ctx)
result = material_service.list_materials(
category_id=_optional_str(params.get("category_id")),
keyword=_optional_str(params.get("keyword")),
page=_int_or_default(params.get("page"), 1),
page_size=_int_or_default(params.get("page_size"), 30),
)
return _serialize_material_list(result, signer)
return handle_request(ctx, action)
def create_material(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.create_material(payload, ctx), signer)
return handle_request(ctx, action)
def get_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_authenticated(ctx)
return _serialize_material(material_service.get_material(material_id), signer)
return handle_request(ctx, action)
def update_material(
ctx: RequestContext,
material_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.update_material(material_id, payload, ctx), signer)
return handle_request(ctx, action)
def delete_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.delete_material(material_id, ctx), signer)
return handle_request(ctx, action)
def upload_material(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.upload_material(payload, ctx), signer)
return handle_request(ctx, action)
def recognize_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.recognize_material(material_id, ctx), signer)
return handle_request(ctx, action)
def re_recognize_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.re_recognize_material(material_id, ctx), signer)
return handle_request(ctx, action)
def confirm_material(
ctx: RequestContext,
material_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.confirm_material(material_id, payload, ctx), signer)
return handle_request(ctx, action)
def _create_material_service() -> MaterialService:
database = Database(load_database_settings())
model_provider_service = ModelProviderService(ModelProviderRepository(database))
model_provider_runtime = ModelProviderRuntime(model_provider_service)
return MaterialService(
repository=MaterialRepository(database),
audit_service=AuditService(database),
vision_provider_factory=model_provider_runtime.vision_provider_for_route,
)
def _serialize_material_list(result: MaterialListResult, media_service: MediaService) -> dict[str, Any]:
payload = result.to_dict()
payload["items"] = [_serialize_material(item, media_service) for item in result.items]
return payload
def _serialize_material(material: Material, media_service: MediaService) -> dict[str, Any]:
payload = material.to_dict()
payload["image_url"] = _signed_url(media_service, material.image_uri)
payload["thumbnail_url"] = _signed_url(media_service, material.thumbnail_uri)
return payload
def _signed_url(media_service: MediaService, uri: str | None) -> str | None:
if not uri:
return None
try:
return media_service.sign_media(uri)["url"]
except ApiError:
return None
def _optional_str(value: Any) -> str | None:
if value is None:
return None
text = str(value).strip()
return text or None
def _int_or_default(value: Any, default: int) -> int:
try:
return int(value)
except (TypeError, ValueError):
return default