线上后台

本项目使用 Directus 作为线上内容后台。维护者的内容编辑、审核和发布都在服务器后台中完成。

入口

后台入口由服务器部署后提供，建议使用独立路径或子域名：

https://admin.example.com

或：

https://example.com/admin

可以维护的内容

线上后台支持：

• 新增、编辑、删除和发布 MME 条目。
• 添加多个下载地址。
• 维护作者、别名、备注、标签和状态。
• 上传图片，并绑定到 MME 条目。
• 审核用户投稿。
• 维护贡献者、站长、管理员和审核员公开资料。
• 编辑首页文案、入口按钮、参与贡献说明和页脚。
• 记录审核通过、驳回和修改原因。
• 管理站长、管理员、审核员、组员和注册用户权限。
• 查看评分、收藏和基础统计。

推荐维护流程

1. 维护者登录线上后台。
2. 新增或编辑 MME 条目。
3. 如需图片，在媒体库上传并绑定。
4. 将内容提交到待审核状态。
5. 审核员检查来源、链接、备注和图片。
6. 审核通过后发布到前台。
7. 如果信息不足，驳回并填写原因。

上线后日常操作

新增条目

mme_items 新建条目
  ↓
填写 slug / sort_order / name / aliases / author / note / status
  ↓
在 mme_links 添加至少一个来源明确的链接
  ↓
绑定 tags 和 gallery
  ↓
设为 checking 或 pending_review
  ↓
审核通过后改为 published
  ↓
前台搜索和筛选验证

新增条目不要直接跳过审核发布。即使是管理员补录，也建议先用 checking 或待审核状态完成一次复核。

修改条目

确认旧条目
  ↓
修改备注、链接、标签或图片
  ↓
如果影响公开内容，写明修改原因
  ↓
必要时记录 reviews
  ↓
发布后前台验证

slug 是公开稳定标识，发布后不要因为名称微调而修改。确实需要改 slug 时，先确认前台链接、收藏、评分、统计和外部引用的影响。

处理失效链接

收到反馈或巡检发现失效
  ↓
检查原配布页和备用来源
  ↓
能找到新来源：新增链接并标记旧链接 unavailable
  ↓
找不到新来源：条目改为 checking 或 unavailable
  ↓
备注写清确认时间和处理原因

不要直接删除失效链接。历史来源对后续追踪和复查有价值。

处理投稿

submissions 待审核
  ↓
检查来源、链接、标签、图片和备注
  ↓
通过：合并到正式集合并写 reviews
  ↓
驳回：填写 review_note，说明需要补充什么
  ↓
发布后验证前台表现

投稿合并后，submissions.status 应变为 merged，正式条目状态应变为 published、checking 或 unavailable 之一。

权限边界

• 站长账号拥有系统最高权限。
• 管理员负责内容管理、用户管理和审核流程。
• 审核员负责通过或驳回投稿。
• 组员可以维护内容，但发布需要审核。
• 注册用户可以投稿、评分和收藏。
• 游客只能浏览已发布内容。

数据边界

当前仓库中的条目快照只作为首次迁移数据源。平台化完成后，长期真实数据源迁移到 PostgreSQL，图片迁移到服务器媒体库或对象存储。

首次登录检查

站长首次登录后台后，先完成这些检查：

1. 修改初始站长密码。
2. 确认后台公开地址与 DIRECTUS_PUBLIC_URL 一致。
3. 确认前台域名已加入 CORS 允许来源。
4. 确认 mme_items、mme_links、tags、item_tags、site_settings 集合存在。
5. 确认 Public 角色只能读取公开状态内容。
6. 新建至少一个备用管理员账号，避免站长账号不可用时无法维护。

站点配置维护

站长可以在 site_settings 集合维护首页和基础入口。第一版只保留一条 key = main 的配置。

字段	前台用途
title / description	站点标题和描述。
hero_name	首页小标题。
hero_text	首页主标题。
hero_tagline	首页说明。
primary_action_text / primary_action_link	首页主按钮。
secondary_action_text / secondary_action_link	首页次按钮。
contribute_text / contribute_link	首页参与贡献入口。
footer_message / copyright	页脚文字。

固定顶部导航仍由代码控制，避免误操作导致关键入口消失。

人员资料维护

贡献者、站长、管理员和审核员统一维护在 people_profiles。

新建人员资料
  ↓
填写 slug / display_name / avatar / homepage_url / bio
  ↓
按页面用途勾选 is_contributor 或 is_staff
  ↓
填写 role_label、contribution_count、排序和公开详情
  ↓
status 设为 visible 后前台展示

同一个人既可以是团队成员，也可以是贡献者。user 字段可选关联 Directus 用户账号，用于把公开资料和受邀账号连接起来。

邀请成员

第一版采用邀请制账号，不开放公开注册。

Directus 用户管理
  ↓
邀请用户
  ↓
用户通过邮件接受邀请
  ↓
分配 Member / Editor / Reviewer / Admin

邀请前先确认部署环境已配置 SMTP 和 USER_INVITE_URL_ALLOW_LIST，否则邀请邮件可能无法送达或接受邀请地址不被允许。

条目维护

维护 MME 条目时，核心信息放在 mme_items：

字段	维护要求
slug	稳定公开标识，发布后不要随意改。
sort_order	前台排序值，数字越小越靠前。
name	MME 名称，避免和已有条目重复。
aliases	别名数组，用于搜索和识别旧名称。
author	作者或配布者。
note	适用版本、依赖、密码说明、失效说明等。
status	发布状态。公开状态为 published、checking、unavailable。
gallery	图片引用。第一版可以保留旧路径或使用 Directus 文件 id。
last_checked_at	最近确认链接或信息的时间。

条目发布前至少确认：

• 名称和别名没有明显重复。
• 至少有一个可解释来源的下载或配布链接。
• 标签能帮助用户筛选，不堆叠无意义标签。
• 备注里说明必要风险、依赖或密码信息。
• 公开条目不能停留在 draft 或 pending_review。

下载链接维护

下载、配布、镜像、教程等入口统一放在 mme_links。

建议分类：

kind	用途
distribution	作者原配布或主要下载页。
mirror	备用镜像。
author	作者主页。
guide	教程或说明。
license	授权说明。
other	其他辅助链接。

维护规则：

• 每个链接必须挂到一个 MME 条目。
• 失效链接不要直接删除，优先标记为 unavailable 并在备注里说明。
• 镜像链接需要确认是否允许转载或是否仅作为临时补档。
• 密码、提取码、依赖说明放在 password_hint 或 note，不要混到链接标题里。

图片维护

第一版图片有两种来源：

旧静态快照：docs/public/images/*
线上媒体库：Directus Files

推荐新内容走 Directus 媒体库。维护时注意：

• 图片文件名要能识别对应条目。
• 避免上传明显无关、侵权或低质量图片。
• 大图先压缩后上传。
• 如果前台读取 Directus 文件 URL，需要确认 Public 文件读取权限。
• 如果仍使用旧 /images/* 路径，需要确认文件已随前台发布到服务器。

投稿审核

投稿统一进入 submissions，审核动作记录到 reviews。

推荐流程：

用户/组员提交
  ↓
pending_review
  ↓
审核员检查来源、链接、标签、备注、图片
  ↓
通过：合并到 mme_items / mme_links / tags
驳回：填写 review_note，状态改为 rejected

审核通过时必须做到：

• 正式条目状态正确。
• 投稿状态改为 merged。
• 审核记录写入 reviews。
• 如果是修改已有条目，旧信息的关键变化能在审核备注里追溯。

驳回时必须写清：

• 缺少哪些字段。
• 哪些链接不可用或来源不足。
• 哪些内容不符合收录规则。
• 投稿人下一步该补什么。

评分、收藏和统计

互动数据属于运行时状态，由线上后台和数据库承载。

维护边界：

• ratings：用户评分，原则上同一用户同一条目只保留一条。
• favorites：用户收藏关系，管理员只在垃圾数据或滥用时处理。
• daily_stats：日聚合统计，第一版不长期保存每次访问明细。

管理员不要手动改评分和收藏，除非是在处理测试数据、垃圾数据或用户申诉。

发布后验证

后台修改内容后，按这个顺序确认前台表现：

1. 条目在 Directus 中是公开状态。
2. 公开 API 能返回该条目。
3. 前台列表能看到该条目。
4. 搜索可以搜到名称、别名、作者或标签。
5. 状态筛选和标签筛选结果正确。
6. 下载链接能打开。
7. 图片能加载。
8. 投稿、评分、收藏入口没有误导用户。

不建议的操作

• 不要直接在线上数据库里手动改业务数据，除非是在备份后做迁移或恢复。
• 不要让多人共用站长账号。
• 不要把草稿、待审核、归档内容开放给 Public 角色。
• 不要把 deploy/.env、数据库备份或管理员密码放进仓库。
• 不要同时维护两套真实数据源；以线上 Directus 和 PostgreSQL 为准。