概述

概述#

DLP3D Web Backend 是一个基于 FastAPI 和 MongoDB 构建的 Web 后端服务，旨在为 3D 动作数据管理、用户管理、角色配置和动作文件访问提供 RESTful API。该服务包含全面的动作数据处理能力，支持多种数据源，包括文件系统、MinIO 对象存储和 MySQL/SQLite 数据库。

该系统专门为 DLP3D Web 应用程序设计，通过统一的 API 接口提供对动作文件、静止姿态数据、模型文件和元数据的高效访问。

核心特性#

  • 多源数据访问：支持文件系统、MinIO 对象存储、MySQL 和 SQLite 数据源

  • 用户管理：完整的用户生命周期管理，包括创建、认证和删除

  • 角色配置：高级角色管理，支持 TTS、ASR、分类、对话、反应和记忆配置

  • 动作文件 API：高性能动作数据访问，具有缓存和版本控制功能

  • RESTful API：全面的 REST API，包含 OpenAPI/Swagger 文档

  • MongoDB 集成：自动数据库引导和用户配置

  • 缓存系统：智能本地缓存，具有自动维护和版本检查功能

  • 日志管理：实时日志访问和下载功能

  • 健康监控：内置健康检查端点，用于服务监控

系统架构#

DLP3D Web Backend 采用模块化、分层架构。

核心组件：

  • FastAPIServer：主 HTTP 服务器，支持 CORS 和错误处理

  • MotionFileApiV1：动作数据访问 API，具有缓存和版本控制功能

  • LocalCache：智能缓存系统，具有自动维护功能

  • Data Readers：用于不同数据源的模块化读取器

  • MongoDB 集成：自动数据库设置和用户配置

Contents