一、源码介绍

铭安PHP反馈系统是一套面向运营场景打造的用户反馈与工单管理源码，其核心价值在于把用户零散提交的意见、BUG 报告和功能创意，转化为一套可跟踪、可公示、可激励的完整闭环。用户在 PC 或手机端提交反馈后，工单会沿着「已受理 → 评估中 → 处理中 → 已发布 → 已关闭」的状态逐步流转，管理员在后台回复、调整状态与进度，系统自动通过邮件将每一步变化告知提交者。

这套源码最突出的特点是零依赖、开箱即用：不基于任何 PHP 框架，无需 Composer，也不需要 Node 构建流程，采用纯原生 PHP + MySQL 编写。将代码拷贝到服务器后，访问安装文件即可完成部署，非常适合中小团队或独立开发者快速搭建属于自己的反馈收集平台。

二、核心功能

系统在用户侧和管理侧分别提供了完整的功能模块，覆盖从提交、处理到奖励的整个流程。

用户端支持邮箱+密码或用户名+密码两种注册登录方式，并提供找回密码功能。用户可提交建议、BUG 修复、功能创意三种类型的工单，填写标题、关联产品、影响程度、附件、联系邮箱等信息，并自行决定工单是否公开。提交后，用户可以在“我的工单”中按状态筛选，查看处理进度百分比与完整时间线，还能在详情页追加说明，与管理员形成双向回复。

反馈大厅是这套系统的一大亮点——用户同意公开的工单会汇聚于此，其他用户可以浏览同类问题，有效减少重复提交。大厅支持整体关闭，也可以设置为“需登录”后才能查看。

管理端提供仪表盘概览（工单、用户、邮件、趋势四类数据与近 7 日工单趋势图）、工单筛选与状态调整、用户禁用与恢复、奖励发放确认与撤销、SMTP 邮件配置、站点品牌设置以及协议文案在线编辑等功能，日常运营所需基本都能在后台完成。

三、工单与积分体系

工单编号从 WZ-0001 起自增生成，并做了并发安全处理。状态体系为 5 状态闭环流转，类型分为建议、BUG 修复、功能创意三种，影响程度分为 3 档。附件方面，单个文件不超过 10MB、最多 5 个，且仅允许白名单类型（图片、PDF、文本，禁用 SVG），存储时随机重命名，下载需经过鉴权接口。

为了激励用户持续贡献优质反馈，系统内置了积分奖励机制。质量等级分为 3 档：精选建议 50 分、有用反馈 20 分、感谢参与 5 分，具体分值可自定义。发放支持“自动”与“需管理员确认”两种模式，所有积分变动都会写入台账，支持撤销和手动调整，并通过行锁保证并发安全。

四、邮件通知机制

系统支持 SMTP 配置与测试发信，邮件通知覆盖注册、找回密码、工单回复、状态变更、进度更新、奖励发放共 6 个场景，每套模板都可以在后台自定义编辑。内置的发送队列在失败时最多自动重试 5 次，后台可以查看失败原因并手动重试，方便排查投递问题。

五、技术特性与安全设计

技术上，这套系统采用自研轻量 MVC 架构，包含自动加载、路由、视图、校验、Controller、Model、Service 等分层。后端基于原生 PHP 7.4+，数据库使用 MySQL（utf8mb4），共 17 张表，所有 SQL 均走 PDO 预处理。接口层为单入口 REST 风格 API，约 40 个接口，带鉴权、同源、限速、CSRF 等中间件管道。前端使用原生 ESM + importmap，无框架、无打包。

安全方面也做了较为全面的考虑：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 即可完成一键安装（建库、建表、创建管理员、写入配置），支持宝塔、Nginx 与 Apache，兼容子目录部署。安装完成后务必删除 install.php，并按部署文档配置伪静态规则。

Nginx 伪静态参考：

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

七、界面展示