我的世界创作社区平台需求文档

https://github.com/Nahida-aa/mcc-next

1. 背景

• 项目目标：围绕每个 Minecraft 创作项目建立社群，让不同身份用户互动，并通过身份升级机制激励更多参与和贡献。
• 业务场景：可根据身份参与评论、投资、协作或作品施工，身份可升级获得更多特权。
• 参考产品：Modrinth + Discord + Patreon + Minecraft 社区。

---

2. 需求概述

• 需求标题：Minecraft 项目社群平台 + 多身份升级
• 优先级：高
• 范围：作品上传/浏览、项目社群互动、身份管理与升级机制。

3. 功能需求

3.1 用户身份体系

身份	功能	升级条件	权限示例
鉴赏家	浏览、评论、点赞、收藏作品	活跃度/评论数/点赞数达到一定量	可获得徽章、评论优先显示
创作者	上传作品、管理项目社群、发布动态	注册并上传作品/完成实名认证	管理社群、发布公告
投资者	投资虚拟积分支持作品	投资额累计达到一定值	优先下载、专属动态、奖励积分
施工者	协作开发、修复或建设作品相关内容	完成协作贡献或任务	可参与项目施工权限、获得积分和徽章

所有身份均可通过累积贡献、活跃度、投资或协作升级获得更高等级

---

3.2 用户故事

• 作为鉴赏家，我希望通过评论和点赞获得积分，逐步升级身份，获得更多特权。
• 作为创作者，我希望上传作品并管理对应社群，与玩家互动。
• 作为投资者，我希望支持优质作品，获得平台奖励和身份升级。
• 作为施工者，我希望参与作品协作或建设，获得积分和升级身份。

3.3 功能描述

3.3.1 身份管理

• 系统记录用户行为（评论、点赞、下载、投资、施工贡献）并计算积分/贡献值。
• 用户可查看当前身份等级及升级条件。
• 升级成功自动获得新权限和徽章。

3.3.2 项目社群

• 每个作品自动关联一个 Discord 社群或内置聊天室。
• 创作者管理社群，发布公告、更新日志。
• 社群内不同身份用户拥有不同权限（如普通聊天 / 协作区访问 /公告置顶）。

创建项目

POST http://localhost:3000/api/project
Content-Type: application/json
Cookie: better-auth.session_token=TI7O2LOXQcmh8wrFZaCs40PhuNqmGzJh.q4XY3Ljzz4wz1We47SNX1FFyTmRIiOxD5iYB8JE7Z%2F4%3D

{
  "name": "",
  "slug": "",
  "summary": "",
  "visibility": "public"
}

创建 project , 将会自动创建 community, 多个 channel

版本管理

创建项目版本 & 上传文件流程

步骤概述

1. 创建版本和版本文件记录（POST）
2. 上传文件到 OSS\S3（PUT）
3. 标记上传完成（PATCH）

1. 创建版本记录

接口

POST /api/project/version
Content-Type: application/json

{
  "projectId": "xxx-uuid",
  "versionNumber": "1.0.0",
  "isPrimary": true,      // 至少要有一个 primary version
  "files": [
    {
      "name": "example.zip",
      "type": "application/zip"
    }
  ]
}

响应 返回 预签名 URL 列表，用于直接上传到 OSS/S3：

[
  {
    "name": "example.zip",
    "uploadUrl": "https://oss.example.com/...?"
  }
]

2. 上传文件到 OSS/S3

使用返回的预签名 URL 上传文件：

请求示例

PUT {uploadUrl}
Content-Type: <file.type>

<file>

• 注意：

  • Content-Type 必须与创建版本时指定的 file.type 一致。
  • 预签名 URL 通常有时效限制，请在有效期内完成上传。

3. 标记上传完成

上传成功后，需要调用 PATCH 接口，告知系统文件已上传完成：

接口

PATCH /api/project/version/{versionId}
Content-Type: application/json

...

说明

• 系统会将文件标记为草稿状态。
• 后续项目成员才能下载该版本文件。

流程总结（图示）

1. POST /project/version → 创建版本记录 + 获取上传 URL
2. PUT 预签名 URL → 上传文件到 OSS/S3
3. PATCH /project/version/{versionId} → 标记文件上传完成

3.3.3 投资与奖励

• 投资者使用平台积分/虚拟货币支持作品或创作者。
• 系统记录投资额并展示在项目主页。
• 升级身份可获得更多奖励（徽章、专属动态曝光、投票权等）。

3.3.4 施工与协作

• 施工者参与项目建设或修复任务。
• 系统记录施工贡献积分。
• 升级施工者等级可获得更多权限（如编辑权限、协作管理权）。

3.3.5 作品浏览与互动

• 支持浏览、评论、点赞、收藏、分享作品。
• 社群入口明确，点击可加入项目社群。
• 系统根据身份提供个性化动态或优先显示。

3.3.6 管理后台

• 审核作品、社群内容及投资/施工行为。
• 管理违规行为（封禁、下架作品）。
• 查看社群活跃度和身份升级统计。

---

3.4 数据需求

• 用户表：ID、昵称、身份等级、积分、投资额、施工贡献、注册时间。
• 作品表：ID、标题、描述、作者 ID、版本信息、社群 ID、下载量、点赞数、投资总额。
• 身份升级表：用户 ID、身份类型、等级、升级条件、升级时间。
• 动态表：ID、项目 ID、作者 ID、内容、时间。
• 社群表：ID、项目 ID、成员列表、权限分级。

---

4. 非功能需求

• 性能：动态流、社群入口加载 ≤ 300ms；身份升级奖励实时生效。
• 安全：防刷积分、防刷投资、防刷施工，敏感词过滤。
• 兼容性：移动端优先，桌面端可选。
• 可用性：支持屏蔽用户、举报违规内容、自动身份提醒。

---

5. 验收标准

• ✅ 所有身份积分和升级机制正常工作。
• ✅ 玩家可从作品页面直接加入项目社群。
• ✅ 投资和施工行为正确记录并影响身份升级。
• ✅ 社群权限根据身份自动分配。

---

6. 依赖与风险

• 依赖：积分系统、Discord API 或内置聊天室、内容审核机制。
• 风险：刷积分、刷投资、刷施工、社群管理不当。
• 解决方案：防刷机制、人工审核、举报与封禁机制。

---

7. 时间 & 版本计划

• MVP：作品上传 + 项目社群 + 鉴赏家身份 + 动态积分系统。
• 迭代一：创作者身份 + 社群管理 + 评论互动。
• 迭代二：投资者身份 + 投资奖励机制 + 身份升级。
• 迭代三：施工者身份 + 协作贡献记录 + 高级权限。

首页

• 公告栏板块
• 项目&团队宣传板块
• 团队&项目动态板块
• 用户(团队)板块

公告栏板块

• logo
• 论坛名, 论坛 文化宣传标语
• 迎新资料(以下 4 个可查看详情和下载)
  • 用户协议
  • 介绍资料
  • 规章制度
  • 平台守则
• 平台寄语

项目&团队宣传板块

列表页

详情页

• 资源

  • 基本介绍
  • 资源视频
  • 资源画廊
  • 资源详情
  • 资源攻略
  • 资源联动
  • 资源下载
  • 资源协议
  • 更新日志与制作信息
  • 公共交流区
  • 制作方公共反馈区
  • 订阅及打赏交流区
  • 打赏总名册
  • 打赏动态

• 用户

  • 用户主页
    • 个人简介
      • 简介(来自于用户填写)
      • 信息(来自于统计数据)
        • 个人产出的资源总数
        • 个人整体口碑情况
        • 个人整体信用情况
        • 个人总被订阅量: 粉丝数
        • 个人成立的团队:
        • 个人加入的团队:
      • 个人顶置的作品: 即自己认为得意的作品
    • 个人功绩
      • 个人搬资源总数, 个人制作资源的总数, 个人编辑资源的总数, 个人参与制作资源的总数
      • 每项资源显示, 点击合适区域进入详情
        • img
        • 资源名
        • 资源 type
        • 立功 time
        • 功绩 type: 搬运者, 创作方, 施工方, 编辑方, 投资方, 发起方
    • 口碑记录
      • 公事伙伴评价自己的总次数, 自己的资源被评价的总次数, 自己的资源共收集多少意见
    • 打赏记录
      • 次数，总额…

• 团队

  • 筹备书
    • 基本简介: 我建议设计为一个 md, 然后给一个模板, 让团队填写
      • 个人简介: 我是 user1\team1 , 在此我\我们开始筹备一个 type1 类型 的团队。总之就是就是自我介绍
      • 筹备原由: 这里说明为什么要成立这个团队, 说明成立的这个团队的一些远景，比如做最棒的施工团队，做一些最优质的整合项目
      • 基本信息:
        • 团队类型: 施工团队\投资团队\创作团队
        • 团队业务: 主要做说明，如投资团队, 主投什么什么风格、什么什么内容的、什么什么类型的项目
      • 区域右下角显示: 编辑(包括上传宣传推广视频)\申请加入
    • 筹备信息: (我认为可以写到上面的 md 中)
      • 人力筹备: 说明需要几个联合创始人，说明这些联合创始人都需要会什么，如需要三名施工技术创始人，需要具体到多少级的施工技术才能称为联合创始人
      • 当前人力筹备情况: xxx 用户成为了这个团队的联合创始人，查看他的个人主页
  • 团队主页
    • 团队简介
      • 简介(来自于团队填写)
      • 信息(来自于统计数据)
        • 类型,同类型排名
        • 成立时间: 筹备成功的具体时间. 团队评价
        • 产出资源总数
        • 团队整体口碑情况
        • 团队整体信用情况
        • 团队总被订阅量: 粉丝数
        • 团队总被打赏额度
        • 团队成员总数
        • 团队热度: 团队产出的各种资源被多少次点赞、收藏、评论、下载过
        • 团队意见: 团队被提过多少次意见
        • 团队经常合作方: 经常跟哪些别的团队合作过
    • 团队花名册
      • 需要显示职位(我想到一个好点子: 职位标签自定义), 当然头像和 username 肯定要显示的,(点击username 区域跳转至对应用户主页)
    • 团队相册: 可以看到该团队成员们上传的所有图片, 每个图片经团队管理(即有响应权限的人员)审核后才能显示
    • 团队功绩
      • 每项资源显示, 点击合适区域进入详情
        • img
        • 资源名
        • 资源 type
        • 立功 time
        • 资源来源: 团队自创, 团队搬运

• 项目

  • 筹备书
    • 基本简介: 建议使用 .md
      • 简介: 我\我们是 xxx , 在此我\我们开始筹备一个 type1 类型 的项目，该项目具体是制作一个什么什么风格的、拥有什么什么具体内容的材质、模组、光影、整合包、服务器、建筑、地形、指令、数据包、行为包、命令块
      • 筹备缘由:
      • 基本信息:
        • 项目类型: 材质、模组、光影、整合包、服务器、建筑、地形、指令、数据包、行为包、命令块…
        • 美术风格: 所有的美术风格，如中世纪、奇幻、魔幻、科幻…
        • 体验基调: 不涉及、硬核求虐、偏向现实、完美现实、高于现实、凌驾现实
        • 分辨率: 不涉及、16x、32x、64x、128x、256x、512x、1024x、…极限
        • 支持平台: 不涉及、java、bedrock、主机版、移动版
        • 支持版本: 对应不同平台的各个版本
        • 运作方式: 不涉及、Forge、Neoforgo、Fabric、Ouilt、Rift、Lite、数据包、行为包、命令方块、文件覆盖…
        • 资源体量: 小、中、大、巨大体量
        • 资源语言: 不涉及、纯国创资源、非中文未汉化、非中文已汉化
        • 筹备时间: 发起时间
    • 筹备信息: 建议使用 .md
      • 人力筹备: 说明需要哪些施工技术，具体到多少级的施工技术来做这个项目，如需要三名不低于三级施工者身份的模组制作师
      • 资金筹备: 说明需要筹备多少的资金, 说明怎么使用筹备的资金，如需要5K的资金，其中3k用于项完成后给施工者酬劳，1K用于项目制作过程的其他事务，1K用于项目完成后在其他媒体平台宣发该项目
      • 当前人力筹备情况: xxxx用户申请成为了这个项目的施工技术，查看他的个人主页。xxxx团队申请成为了这个项目的施工技术方，查看这个团队的主页。
      • 当前资金筹备情况: xxxx用户申请成为了这个项目的个人投资方，他投资了2K，查看他的个人主页。xxxx团队申请成为了这个项目的项目投资方，该团队投资了该项目所需要的全部资金5K，查看这个团队的主页。
    • 施工信息
      • 施工内容：具体做什么。
      • 施工方式：使用什么开发工具、协同办公工具制作这个项目。
      • 施工流程：具体怎样完成这个项目的流程计划。
    • 项目协议
      • 项目完成后是否收费：免费、付费，如付费，收益如何分成。
      • 分成方式：仅酬劳，完成施工后所有成员一次性分成酬劳。酬劳加收益，完成施工后所有成员一次性分成酬劳收益并获取项目未来收益。仅收益，无项目完成酬劳，仅分成项目未来收益。
      • 项目所属：全体成员，仅筹备方，仅投资方，仅施工方。
    • 酬劳分配

动态板块

团队动态

例如:

• 刚刚用户 xxx 发起了团队组建
• 刚刚团队 xxx 经过全体成员的同意解散了
• 刚刚团队 xxx 的团队评级提升了
• 刚刚团队xxx成功完成了初次团建

项目动态

例如:

• 刚刚XXX团队发起了一个新项目
• 刚刚XXX团队的项目宣布完成了
• 刚刚XXX团队的新项目完成了施工招募…
• 刚刚XXX团队对XX项目发起了宣传令…

用户(团队)板块

注册\登录\找回账号\找回密码

注册

• 基础信息(必填)
  • 账户名: 6-8个中文字符, 不支持英文、数字、符号。 检查是否重复(被占用)
  • 密码, 确认密码
  • 手机号, 验证码
  • 身份证, 选择填写的是否是本人身份证
  • 头像
• 平台基础信息(选填, 但是如果没有填写完整就无法获得鉴赏者身份, 只会成为有账号的游客)
  • 玩 mc 多久了: 0-1年, 1-3年, 3-5年, 5-8年, 8-12年, 12年以上
  • 为什么会玩 mc: 可以不填
  • 服务器玩家 | 公益服 | 盈利服 | 多人竞技服 | 多人合作服, 感觉可多选
  • 喜欢哪些内容
    • 建筑内容:
    • 生存内容:
    • 冒险内容:
    • 科技内容:
  • 平台内想结识怎样的伙伴: 拒绝社交|服务器伙伴|同好建筑内容的伙伴|同好生存内容的伙伴|同好冒险内容的伙伴|同好科技内容的伙伴

注册成功会进入平台大厅:

• 恭喜你注册成功, 在平台中你获得了自己的家
• 属于你的家的门牌号为: 123456
• 自2025年3月2号, 本平台正式运营之初, 截至此时此刻, 你是第 123456 位注册用户
• 点击 我的家 进入到我的家 场景

客厅

• 通讯录

  • 头像, 在线状态, 用户名, 是否发来新消息

• 来访信息

  • 头像, 在线状态, 用户名, 来访时间

• 个人档案

  • 基础信息
    • 头像
    • 用户名
    • 是否实名
    • 性别
    • 年龄
    • 门牌号
    • 联系方式
  • 平台信息
    • 玩 mc 多久了: 0-1年, 1-3年, 3-5年, 5-8年, 8-12年, 12年以上
    • 为什么会玩 mc: 可以不填
    • 服务器玩家 | 公益服 | 盈利服 | 多人竞技服 | 多人合作服
    • 喜欢哪些内容
      • 建筑内容:
      • 生存内容:
      • 冒险内容:
      • 科技内容:
    • 平台内想结识怎样的伙伴: 拒绝社交|服务器伙伴|同好建筑内容的伙伴|同好生存内容的伙伴|同好冒险内容的伙伴|同好科技内容的伙伴
  • 认证信息(身份信息)
    • 身为 鉴赏家 的信息
      • 鉴赏家等级: int
      • 互动总数: 总数和互动记录
      • 打赏总数: 额度和打赏记录
      • 口碑情况: 得分和评价记录
      • 信用情况: 得分和信用记录
    • 身为 创作者 的信息
      • 创作初心
      • 创作者等级
      • 作品总数: int 和 作品列表
      • 总被订阅量: int 和 订阅列表
      • 作品被打赏总额: 额度 和 打赏记录
      • 项目总数
      • 作品口碑
      • 团队信息
        • 未入团队时显示:
          • 是否独立主义者
          • 是否愿意加入团队
        • 入团队后显示:
          • 团队logo
          • 团队名
          • 团队评级
          • 团队身份
          • 在团队中口碑(来自公事伙伴的评价)
    • 身为 投资者 的信息
      • 投资 初心
      • 投资 者等级
      • 投资 总数
      • 总 投资 额度
      • 投资 口碑
      • 投资 方向
      • 团队信息
        • 未入团队时显示:
          • 是否独立主义者
          • 是否愿意加入团队
        • 入团队后显示:
          • 团队logo
          • 团队名
          • 团队评级
          • 团队身份
          • 在团队中口碑(来自公事伙伴的评价)
    • 身为 施工者 的信息
      • 施工 初心
      • 施工 者等级
      • 主能力 方向
      • 主能力
      • 次能力 方向
      • 其他能力
      • 施工 总数
      • 总 施工 额度
      • 能力 口碑
      • 开发 方向
      • 团队信息
        • 未入团队时显示:
          • 是否独立主义者
          • 是否愿意加入团队
        • 入团队后显示:
          • 团队logo
          • 团队名
          • 团队评级
          • 团队身份
          • 在团队中口碑(来自公事伙伴的评价)

个人工作室

• 管理项目
  • 我参与的项目
    • 项目 img
    • 项目名
    • 项目类型
    • 参与人数
    • 我的身份: 施工者, 投资者, 创作者, 发起者 …
    • 发起者\团队: 发起者\团队名
    • 项目投资
    • 项目状态: 筹备中, 施工中, (已完成)维护中, 删除 …
    • 项目群聊
  • 我发起的项目
    • … 同上
  • 我收藏的项目
    • … 同上
• 管理资源
  • 我上传的资源
    • 资源 img
    • 资源名
    • 资源类型
    • 资源来源: 国创, 外网 …
    • 我的身份: 制作者, 搬运者 …
    • 制作人\团队: 制作人\团队名
    • 用户总量: int
    • 反馈意见: int
    • 资源群聊
  • 我收藏的资源
    • 资源 img
    • 资源名
    • 资源类型
    • 资源投资
    • 制作人\团队: 制作人\团队名
    • 资源群聊
    • 总收藏量: int
  • 我编辑的资源
    • 资源 img
    • 资源名
    • 资源类型
    • 制作人\团队: 制作人\团队名
    • 资源群聊
    • 编辑时间
    • 通过情况: 通过, 未通过, 审核中 …
• 管理主页
  • 全部互动
    • 互动者: obj
      • img
      • name
    • 互动类型: 点赞, 收藏, 评论, 下载, 打赏, 订阅
    • 互动对象: obj, eg:项目, 资源, 团队, 用户, …
      • img
      • name
    • 互动时间
    • 互动内容
  • 全部打赏
    • 打赏者
      • img
      • name
    • 打赏对象: obj, eg:项目, 资源, 团队, 用户, …
      • img
      • name
    • 打赏时间
    • 打赏金额
  • 全部意见
    • 意见者
      • img
      • name
    • 意见对象: obj, eg:项目, 资源, 团队, 用户, …
      • img
      • name
    • 意见时间
    • 意见内容
• 团队事宜
  • 我创建的团队
    • img
    • name
    • 团队类型
    • 团队评级
    • 团队身份
    • 团队人数: int
    • 项目总数: int
  • 我管理的团队
    • 同上
  • 我加入的团队
    • 同上

团队会议室

• 未加入团队时
  • 你还并未加入或成立团队, 该场景暂时无法进入
  • 成立团队的方法: 1. 可以通过发起团队筹备书来成立团队 2. 可通过成为正在筹备的团队的联合创始人来成立团队。
  • 加入团队的方法: 1. 可通过搜索现有团队的方式寻找到意向加入的团队并向其提出入团申请 2. 经平台内已入团的用户邀请加入对应的团队
• 已加入团队时
  • 管理项目
    • 团队参与的项目
      • 项目 img
      • 项目名
      • 项目类型
      • 参与人数
      • 项目投资
      • 项目状态: 筹备中, 施工中, (已完成)维护中, 删除 …
      • 项目群聊
      • 我的身份
    • 团队发起的项目
      • … 同上
  • 管理资源
    • 团队上传的资源
      • 资源 img
      • 资源名
      • 资源类型
      • 资源来源: 国创, 外网 …
      • 制作人\团队: 制作人\团队名
      • 用户总量: int
      • 反馈意见: int
      • 资源群聊
      • 团队身份
      • 资源状态: 未审核, 审核中, 正常, 未通过
    • 团队编辑的资源
      • … 同上
  • 管理主页
    • 全部互动
    • 全部打赏
    • 全部意见 -人员事宜
    • 团队花名册(团队成员)
      • 头像
      • 用户名
      • 身份
      • 入团时间
    • 入团申请
      • 申请者
        • img
        • name
      • 申请时间
      • 申请书
      • 申请状态: 未处理, 已同意, 已拒绝
    • 推荐
      • 推荐者
        • img
        • name
      • 推荐时间
      • 推荐信
      • 推荐状态: 未处理, 已同意, 已拒绝
  • 财务事宜
    • 资金动态
      • user\team
        • img
        • name
      • 时间
      • 目标对象
      • 行为类型: 收入, 支出
      • 金额
      • 详情
    • 资金申请
      • 申请者
        • img
        • name
      • 申请时间
      • 申请金额
      • 申请简介
      • 申请详情(不直接显示)
      • 申请状态: 未处理, 已同意, 已拒绝

平台大厅

• 修改信息
• 提出建议
• 开头钱包
• 退出登录

平台人力

• 身份认证
  • 认证施工者
    • 第一能力方向
    • 方向下的具体能力
    • 第二能力方向
    • 方向下的具体能力
    • 施工初心
    • 证明个人能力的材料
    • 是否独立主义者
    • 是否愿意加入团队
  • 认证投资者
    • 投资初心
    • 投资方向
    • 投资计划
    • 投资能力证明材料
    • 是否独立主义者
    • 是否愿意加入团队
  • 认证创作者
    • 创作初心
    • 创作方向
    • 创作计划
    • 创作能力证明材料
  • …
• 我的档案
  • 基础信息
  • 平台信息
  • 认证信息

更衣室(先不开发)

• 平台形象
• 游戏形象