铭安php反馈系统源码

把用户零散的建议、BUG 和创意，变成一条条能跟踪、能公示、还能发积分奖励的工单——这就是铭安PHP反馈系统干的事。它不是那种装完还得配一堆环境的半成品，而是一套直接能用的反馈与工单管理方案。

一、这套系统到底是干什么的

用户掏出手机或打开电脑，随手提交建议、报个 BUG、提个功能创意，工单就开始自己跑了。流程很清晰：已受理 → 评估中 → 处理中（带进度百分比）→ 已发布 → 已关闭。管理员在后台回复、改状态、调进度，每一步变化系统都会自动发邮件通知用户。反馈质量高的，还能按等级发积分，用户自然愿意多发。

同意公开的工单会进「反馈大厅」，其他人能翻到同类问题，重复提交的情况一下就少了。

最省心的地方在于：零依赖。不用任何 PHP 框架，不碰 Composer，也不用 Node 构建，就是纯原生 PHP + MySQL。代码拷到服务器上，访问 install.php 就能跑起来。

二、用户端能做什么

注册登录

双模式：邮箱+密码，或用户名+密码。邮箱验证码、找回密码都配齐了。

提交与管理工单

填类型、标题、关联产品、影响程度、附件、联系邮箱，再选要不要公开。提交后在「我的工单」里按状态筛选，进度百分比和完整处理时间线一目了然。详情页还能追加补充说明，管理员回复后就是一条双向时间线。公开还是私密？随时切换，不用重新提交。

反馈大厅与个人中心

大厅里能浏览别人公开的工单。嫌吵可以整体关掉，也可以设成「需登录」才看。个人中心负责维护资料、查积分余额。

三、管理后台一览

仪表盘给了四类概览：工单、用户、邮件、趋势。近 7 日工单趋势图加上最近操作动态，运营状态心里有数。

工单管理支持按状态、类型、关键词筛选，能改状态、调进度、回复、删除，还能导出 CSV。用户管理里搜索、禁用、恢复一条龙，禁用后即时下线。奖励管理负责质量等级配置、积分发放确认、撤销、手动调整，全程留痕。

邮件通知这块，SMTP 配置、测试发信、6 套模板自定义、发送队列排查与手动重试，都在后台搞定。站点品牌、界面导航、协议声明（用户协议、隐私政策、免责声明、源码使用许可）也都能在线编辑，后台直接改。

四、工单体系与积分奖励

工单编号从 WZ-0001 起自增生成，并发安全。5 状态闭环，3 种类型（建议 / BUG 修复 / 功能创意），3 档影响程度。

附件限制：单个 ≤ 10MB、最多 5 个，只收白名单类型（图片 / PDF / 文本，SVG 禁用）。文件名随机重命名存储，下载走鉴权接口。

积分这块挺有意思。3 档质量等级：精选建议 50 分、有用反馈 20 分、感谢参与 5 分，都能自定义。发放支持「自动」和「需管理员确认」两种模式。所有积分变动都会写进台账（point_ledger），撤销和手动调整都留痕，行锁保证并发安全。

五、技术特性

后端是原生 PHP源码，7.4+ 起步，无框架无 Composer。数据库用 MySQL（utf8mb4），17 张表，全部走 PDO 预处理。架构是自研轻量 MVC：自动加载、路由、视图、校验、Controller / Model / Service 分层。

接口走单入口 REST 风格 API，大约 40 个，带中间件管道（鉴权、同源、限速、CSRF）。前端用原生 ESM + importmap，不打包不构建，CSS 分层有序加载。部署支持一键安装：建库、建表、建管理员、写配置一步到位，宝塔 / Nginx 与 Apache 都能用，子目录部署也兼容。PC 和移动端双端适配，移动端还有快捷入口、幻灯片和底部导航。

六、安全设计不糊弄

所有 SQL 走 PDO 预处理，零字符串拼接。CSRF 令牌加同源校验，写操作统一白名单 action。登录、注册、验证码、后台登录全有限速（滑动窗口）。

密码用 bcrypt（cost 12），登录 Token 只存 SHA-256 哈希，30 天有效。附件做双白名单校验（扩展名 + MIME + getimagesize），SVG 直接禁掉防 XSS，随机重命名加鉴权下载，路径穿越有防护，上传目录禁止执行脚本。全站安全响应头（X-Content-Type-Options / X-Frame-Options / Referrer-Policy）一个不少，验证码和找回密码也设了尝试次数上限。

七、部署要求

环境上，PHP 7.4+ 并启用 pdo_mysql、fileinfo，MySQL 5.7+ 或 MariaDB 即可。把站点根目录指向项目目录，上传后访问 install.php 走完安装。

注意：装完一定要删掉 install.php，然后按部署文档配好伪静态规则：

location /api/ { try_files $uri $uri/ /api/index.php?$query_string;}

这类开源软件的好处就是省事，环境搭好、规则配好，剩下都交给它。要是你没那么多精力折腾前后端，把它挂在一台稳定的服务器配置上，日常运营基本不用操心。