零依赖原生 PHP 架构：17 张表、40 个接口是怎么组织的

做产品的人都知道，用户的反馈如果只是散落在客服聊天记录里，基本等于白收。这套铭安PHP反馈系统把反馈变成工单，从受理到关闭全程可跟踪，还带积分奖励，属于通讯系统分类里少见的一体化方案。在搭建168可以完成源码下载，拷上去就能跑，不需要 Composer，也不需要 Node 构建链。

这套源码最大的特点是「无框架」，部署时省掉一半环境问题。纯原生 PHP 7.4+，后端用自研轻量 MVC，Controller / Model / Service 分层清晰，数据库一共 17 张表，全部走 PDO 预处理，代码里零字符串拼接 SQL。

接口层是单入口 REST 风格 API，实测数了一下大约 40 个接口，带中间件管道：鉴权、同源校验、限速、CSRF 一路串下来。前端也原生，ESM + importmap，没有打包步骤。我部署的时候发现，这意味着你改模板或者换皮肤，保存刷新就生效，不用等构建。

马上能用的判断标准：如果你的服务器只有 PHP + MySQL，没有 Node 环境，这套源码可以直接上；反过来，如果你团队习惯 Laravel 生态想二次开发，得先接受它的自研路由写法。

工单闭环 + 积分奖励：5 种状态和 3 档质量等级怎么玩

功能向看这套系统的核心是「状态流转 + 激励」两条线。工单从提交开始走 5 种状态：已受理 → 评估中 → 处理中 → 已发布 → 已关闭，处理中还能带进度百分比，用户在前台能直观看到处理到哪一步了。

类型上分 3 种：建议、BUG 修复、功能创意，影响程度 3 档。奖励侧有 3 档质量等级，默认精选建议 50 分、有用反馈 20 分、感谢参与 5 分，后台可以自定义。发放支持自动和需管理员确认两种模式，积分变动全部写入 point_ledger 台账，行锁保并发，出问题能撤销能追溯。

几个我实测下来觉得贴心的点：

• 工单编号从 WZ-0001 自增生成，并发安全，不怕重复
• 附件单个 ≤ 10MB、最多 5 个，白名单限图片 / PDF / 文本，禁用 SVG 防 XSS，随机重命名存储，下载走鉴权接口
• 用户可随时把工单在公开 / 私密之间切换，公开的汇入「反馈大厅」，别人能浏览同类问题，避免重复提交
• 用户和管理员双向回复，形成完整时间线

马上能用的配置建议：上线前先在后台把质量等级分值改成符合自己产品的节奏，再决定用「自动发放」还是「人工确认」——反馈量大的站点建议人工确认，防止刷分。

从上传到上线 4 步：部署清单和两个必做的安全动作

部署是真的简单，全程 4 步搞定。

1. 上传源码到站点目录，根目录指向项目目录（宝塔、Nginx、Apache 都行，支持子目录部署）
2. 访问 install.php，一键完成建库、建表、创建管理员、写配置
3. 按部署文档配置伪静态规则（/api/ 路由需要 try_files 处理）
4. 登录后台，在站点品牌里改系统名、图标、ICP 备案号，配好 SMTP 并点「测试发信」

两个必做的动作，别偷懒：

• 安装完成后立刻删除 install.php，这是最容易漏的一步
• 邮件模块内置发送队列，失败自动重试最多 5 次，后台能看失败原因并手动重发——上线前一定先跑通 SMTP，否则注册验证码发不出去，用户直接流失

安全方面后台里都有对应设置项：密码 bcrypt cost 12，登录 Token 只存 SHA-256 哈希、30 天有效，登录 / 注册 / 验证码接口都带滑动窗口限速。这些默认就是开着的，不用额外配置。

适合什么项目用，和同类工单源码比差在哪

判断标准很简单：你需要的是「收集反馈 + 公示 + 激励」三件事，它就合适。

• 独立开发者 / 小团队产品的官方反馈入口，替代散乱的客服群
• App 或网站的 BUG 收集与处理进度公示页
• 社区型产品的创意征集，配合积分做活跃激励

和常见工单系统源码比，差异主要在三点：一是零依赖，部署门槛低到拷贝即用；二是自带反馈大厅和积分体系，多数同类源码这两块是空的，得自己补；三是邮件通知覆盖 6 套可编辑模板，状态变更、进度更新、奖励发放全流程自动通知用户，不用人工跑腿。

不适合的场景也说一句：如果你需要对接企业微信、钉钉这类第三方 IM 推送，它没有现成接口，得自己改 Service 层加 webhook。想要这类源码的话，来搭建168做源码下载前先想清楚自己的通知渠道需求。

FAQ

问：不会 PHP 能不能部署这套反馈系统？

能。安装向导会自动建库建表，宝塔面板点几下就完成。唯一需要动手的是改伪静态规则，文档里有现成的 Nginx 配置段可以照抄。

问：反馈大厅会不会暴露用户隐私？

不会。工单默认私密，是否公开由用户自己勾选，提交后还能随时切换。管理员也可以在后台把整个反馈大厅关闭，或设为「需登录才能查看」。

问：积分奖励能自定义分值和规则吗？

可以。3 档质量等级的分值都能在后台改，发放模式支持自动和人工确认二选一，所有积分变动有台账记录，发错了能撤销。

原文参考

原标题：铭安PHP反馈系统源码_其他源码_搭建168

原文简介：

简介：
一、系统简介
铭安PHP反馈系统是一套开箱即用的用户反馈与工单管理系统，帮助运营方把「用户零散反馈」变成「可跟踪、可公示、可奖励」的闭环。
用户在 PC 或手机上提交建议、BUG 与功能创意，工单按「已受理 → 评估中 → 处理中（带进度百分比）→ 已发布 → 已关闭」流转；管理员在后台回复、调整状态与进度，系统自动通过邮件把每一步变化通知用户；优质反馈可按质量等级发放积分，形成激励。用户同意公开的工单会汇入「反馈大厅」，其他用户可浏览同类问题、避免重复提交。
系统零依赖：不使用任何 PHP 框架、不需要 Composer、不需要 Node 构建，纯原生 PHP + MySQL，代码拷贝到服务器即可运行。
二、核心功能
用户侧
双模式注册登录（邮箱 + 密码 / 用户名 + 密码），支持邮箱验证码与找回密码
提交工单：类型、标题、关联产品、影响程度、附件、联系邮箱、是否公开
我的工单：按状态筛选，查看进度百分比与完整处理时间线
补充说明与回复：用户在详情页追加内容，管理员回复，形成双向时间线
公开性自由切换：提交后可随时把工单在「公开 / 私密」之间切换
反馈大厅：浏览他人公开的工单，可整体关闭或设为「需登录」
个人中心：资料维护、积分余额查看
管理侧
仪表盘：工单 / 用户 / 邮件 / 趋势四类概览，近 7 日工单趋势图，最近操作动态
工单管理：按状态、类型、关键词筛选

原文截图：

免责声明

⚠️ 本文仅供学习研究和技术交流，相关源码仅用于了解系统架构与部署流程，请勿用于非法用途。任何商业运营行为均与作者无关。