# 星界一言堂后端路线决策记录

> 更新时间：2026-05-27  
> 范围：`/community/`、`/forum/`、论坛生产后端选型、内容沉淀链路。

## 结论

**Discourse 可以替代 Flarum，并且当前阶段建议把 Discourse 作为论坛生产路线的优先方案。**

原因：

1. 站内论坛 UI 已经按 Discourse 风格推进：话题流、回复、状态、整理到资料库的动作都更接近 Discourse 的讨论模型。
2. `/forum/` 已作为入口别名跳转到 `/community/`，公共文案也是“Discourse 风格框架”。
3. 记忆墙互动已经使用 Discourse-style topic/reply/action 面板，社区心智正在向“话题串”收敛。
4. 论坛核心目标不是轻量评论，而是“讨论 → 复核 → 候选 → 资料库”的内容生产线；Discourse 的成熟管理、通知、审核、反垃圾、权限体系更适合后续运营。

## 当前接入状态

当前已经完成的是 **静态/UI 层 Discourse 接入**，不是完整后端部署：

- `/community/`：Discourse/Flarum 混合信息架构的静态论坛 MVP，已有四大分区、话题流、登录态发帖、本地互动、候选整理。
- `/forum/`：跳转入口，指向 `/community/`。
- `/memories/`：记忆墙已有 Discourse-style 话题与回复面板。
- `/cms/`、`/dashboard/`、`/admin/content/import/`：能读取同浏览器论坛候选池并生成资料库 JSON 草案。

服务器检查结果：

- Nginx 正在运行，站点根目录为 `/var/www/shuaishuaidnd/current`。
- 当前没有真实 Discourse 生产进程。
- 未发现 Ruby/Rails/Puma/Sidekiq/Postgres/Redis 监听。
- 当前也没有 PHP、Composer、MySQL/MariaDB，因此 Flarum 也不是“可直接上线”的状态。

## Discourse 替代 Flarum 的影响

### 保留

- `/community/` 作为用户可见的一言堂入口。
- `/forum/` 作为兼容入口或未来真实论坛入口。
- 现有静态 MVP 的四大分区：团务规则、灌水吐槽、FVTT分享、规则 模组资源区。
- “论坛好帖 → CMS 候选 → 资料库详情页”的沉淀链路。

### 调整

- Roadmap Phase 3 从“Flarum 优先”改为“Discourse 优先，Flarum 作为备选”。
- 后端部署不直接覆盖 `/community/`，先建议使用独立子域或路径灰度：
  - 优先：`bbs.shuaishuaidnd.cn`
  - 备选：`/forum/`
- 静态 `/community/` 在真实后端上线前继续作为预览层、落地页和内容沉淀 UI 原型。

### 风险

- Discourse 是 Rails + Postgres + Redis + background jobs 的完整应用，资源和运维成本高于 Flarum。
- 真实部署涉及 Docker/systemd、邮件、备份、域名、HTTPS、上传附件、反垃圾、管理员账号等生产决策，不应作为静态 UI 修改的副作用直接启动。
- 与现有轻量 Auth 的账号打通需要单独设计；短期可以让 Discourse 使用独立账号，后续再做 SSO。

## 推荐下一步

### A. 安全推进路线

1. 保持 `/community/` 静态 MVP 继续可用。
2. 将 Phase 3 明确为 Discourse 生产验证。
3. 先在文档层确定部署边界：域名、账号、邮件、备份、上传配额、管理员权限。
4. 再单独开一轮“Discourse 生产部署/试运行”任务，避免影响当前静态站。

### B. 生产部署前检查清单

- 域名：确认 `bbs.shuaishuaidnd.cn` 是否用于真实 Discourse。
- 部署方式：Docker 官方安装、独立 VM，或本机旁路部署。
- 资源：CPU、内存、磁盘、备份空间。
- 邮件：注册/找回密码/通知用 SMTP。
- 管理员：初始管理员邮箱、用户名。
- 备份：数据库、上传附件、配置文件、主题。
- 反垃圾：注册限制、审核队列、频率限制。
- 迁移：静态 MVP 内容是否只作为参考，还是批量导入真实话题。

## 当前决策

短期：**继续使用静态 `/community/` MVP + localStorage/CMS 候选链路。**  
中期：**把 Discourse 作为生产论坛后端优先方案，在 `bbs.shuaishuaidnd.cn` 灰度部署。**  
备选：如果运维成本需要降低，再回退评估 Flarum 或轻量自研 API。