📋 用户用例文档

项目名称:出海AGI (AI-Powered Global Expansion Platform)

文档版本:v2.1

最后更新:2025年11月26日

文档说明:本文档描述了出海AGI系统的用户角色、使用场景和详细用例

1. 用例图

出海AGI 系统用例图
出海AGI 系统用户👤 用户功能用户注册和登录上传图片生成视频查看数据统计管理视频列表图例:关联关系用户用例

2. 数据库ER图

出海AGI 系统数据库ER图
👤 User (用户)🔑 id: UUID (PK)username: VARCHAR(50)email: VARCHAR(100)password_hash: VARCHAR(255)phone: VARCHAR(20)status: ENUMcreated_at: TIMESTAMPupdated_at: TIMESTAMPavatar_url: VARCHAR(255)🖼️ Image (图片)🔑 id: UUID (PK)user_id: UUID (FK)filename: VARCHAR(255)file_path: VARCHAR(500)file_size: BIGINTmime_type: VARCHAR(100)width: INTEGERheight: INTEGERcreated_at: TIMESTAMP🎬 Video (视频)🔑 id: UUID (PK)user_id: UUID (FK)title: VARCHAR(255)filename: VARCHAR(255)file_path: VARCHAR(500)file_size: BIGINTduration: INTEGERstatus: ENUMthumbnail_url: VARCHAR(500)created_at: TIMESTAMP⚙️ VideoGeneration🔑 id: UUID (PK)user_id: UUID (FK)image_id: UUID (FK)video_id: UUID (FK)status: ENUMprogress: INTEGERparams: JSONerror_message: TEXTstarted_at: TIMESTAMPcompleted_at: TIMESTAMPcreated_at: TIMESTAMP📊 UserQuota (配额)🔑 id: UUID (PK)user_id: UUID (FK)quota_type: VARCHAR(50)total_limit: BIGINTused_amount: BIGINTreset_cycle: VARCHAR(20)created_at: TIMESTAMP1:N1:N1:N1:NN:11:N图例:一对多 (1:N)多对一 (N:1)实体

📋 数据库设计说明

  • User (用户表):存储用户基本信息,包括登录凭证、联系方式、状态等
  • Image (图片表):存储用户上传的图片信息,包括文件路径、尺寸等
  • Video (视频表):存储生成的视频信息,包括文件路径、时长、状态等
  • VideoGeneration (视频生成表):记录视频生成任务信息,包括状态、进度、参数等
  • UserQuota (用户配额表):管理用户的使用配额,包括视频生成次数、存储空间等

🔗 关系说明

  • 一个用户(User)可以上传多个图片(Image) (1:N)
  • 一个用户(User)可以生成多个视频(Video) (1:N)
  • 一个用户(User)可以有多个配额记录(UserQuota) (1:N)
  • 一个用户(User)可以发起多个视频生成任务(VideoGeneration) (1:N)
  • 一个图片(Image)可以用于生成多个视频(VideoGeneration) (1:N)
  • 一个视频生成任务(VideoGeneration)生成一个视频(Video) (N:1)

文档结束 | 最后更新:2025年11月 | 出海AGI系统