企业官网建设流程全解析

从零搭起 Fider 反馈门户：30 分钟让团队的功能请求可投票、可排序

【免费下载链接】fiderOpen platform to collect and prioritize feedback项目地址: https://gitcode.com/GitHub_Trending/fi/fider

用户对你的产品有什么意见，往往散落在邮箱、群聊和应用商店的评论区里，没人能把它们汇总起来排序。Fider 是一个开源的反馈门户，它把功能请求收进同一个页面：用户提交建议、投票、评论，你和团队据此决定先做什么。

判断这事值不值得你花半小时

适合你用 Fider：

• 你想让用户提交功能请求，再靠投票排定优先级
• 你是小团队，没有专人把反馈从各处搬回文档
• 反馈数据要留在自己的服务器上

不适合你的情况：

• 你要的是客服工单系统——Fider 只做反馈收集与排优先级，不做工单流转
• 你完全不想运维——那直接用官方托管的 Fider Cloud，本文讲的是自建

开工前把这几样备齐

环境要求一张清单，对照打勾：

• Docker + Docker Compose：用来起 PostgreSQL 17 和一个 MailHog 假邮件服务
• Go 1.26+：编译后端
• Node.js 22+ 和 npm：编译前端
• 内存 2GB、磁盘 20GB

部署路径只推荐一条：本地docker compose起数据库和假 SMTP，再用make watch跑应用。其余两条各一句话带过——生产环境用make build出二进制、make run启动；或者直接用官方托管 Fider Cloud，省掉运维。

从0到能访问

第一步，拉代码并起数据库和邮件服务：

git clone https://gitcode.com/GitHub_Trending/fi/fider cd fider docker compose up -d

跑完docker compose ps，你应该看到三个容器都是Up状态：PostgreSQL 映射在 5555 端口，MailHog 邮件界面在 8025 端口。

第二步，建配置文件并启动应用：

cp .example.env .env make watch

make watch会先跑数据库迁移，然后热重载地起服务。终端出现监听日志后，打开 http://localhost:3000，你应该看到 Fider 的注册页——应用起来了。

打开页面后的三件事

1. 建管理员账号。注册页填邮箱、姓名、密码，第一个注册的账号就是管理员，后台权限全在你手里。
2. 配好邮件与通知。.example.env已指向内置 MailHog（1025 端口发信、8025 端口看信），本地开发不用改就能用；上线前把.env里的EMAIL_SMTP_*换成真实 SMTP。
3. 定登录方式。默认走 Email；要在 Site Settings → Authentication 里开 GitHub、Google 等 OAuth 登录，就在那里配。

让反馈跑起来

一条反馈走完全程，长这样：

1. 提交：用户在首页输入框提交建议，填标题和详细描述，可选地打标签。
2. 投票：每个用户对每帖限一票，票数实时显示在卡片左侧，方便看出哪条最被期待。
3. 评论：帖子下方开放讨论，用户补充细节、你回应方案。
4. 状态流转：新帖默认open，管理员可把它推到planned、started、completed，或标成declined、duplicate、deleted，定义见 app/models/enum/post_status.go。
5. 落地或拒绝：completed代表已实现，declined代表不做，配合标签分组，团队一眼能看出每条反馈停在哪一步。

按你的需求往上长

• 品牌外观：在 Site Settings 的外观里换 logo（建议 300x300）、主色和欢迎语，租户实体定义在 app/models/entity/tenant.go。
• 角色权限：三档角色visitor/collaborator/administrator，定义在 app/models/enum/user_role.go，在后台成员列表里给指定用户调档。
• 第三方集成：用 Webhook 把反馈事件推到你自己的系统（app/services/webhook/webhook.go）；要按 OAuth 角色限制谁能登录，参考 docs/OAUTH_ROLE_RESTRICTION.md。

卡住了先看这里

现象：打不开 http://localhost:3000 原因：容器没起，或.env的DATABASE_URL没指到 5555 端口 动作：docker compose ps看容器是否Up，核对DATABASE_URL里写的是localhost:5555

现象：收不到验证邮件 原因：SMTP 没配 动作：先用内置 MailHog 打开 http://localhost:8025 看信，或把EMAIL_SMTP_*换成真实 SMTP

现象：页面能开，注册却报 500 原因：数据库没跑迁移 动作：make migrate后再make run

把上面命令敲完，你手上就有一个能收功能请求的门户。要接更多场景，从 app/services/ 和 docs/OAUTH_ROLE_RESTRICTION.md 继续往下读。

【免费下载链接】fiderOpen platform to collect and prioritize feedback项目地址: https://gitcode.com/GitHub_Trending/fi/fider