铭安PHP反馈系统源码

一、系统简介
铭安PHP反馈系统是一套开箱即用的用户反馈与工单管理系统，帮助运营方把「用户零散反馈」变成「可跟踪、可公示、可奖励」的闭环。

用户在 PC 或手机上提交建议、BUG 与功能创意，工单按「已受理 → 评估中 → 处理中（带进度百分比）→ 已发布 → 已关闭」流转；管理员在后台回复、调整状态与进度，系统自动通过邮件把每一步变化通知用户；优质反馈可按质量等级发放积分，形成激励。用户同意公开的工单会汇入「反馈大厅」，其他用户可浏览同类问题、避免重复提交。

系统零依赖：不使用任何 PHP 框架、不需要 Composer、不需要 Node 构建，纯原生 PHP + MySQL，代码拷贝到服务器即可运行。

二、核心功能
用户侧

双模式注册登录（邮箱 + 密码 / 用户名 + 密码），支持邮箱验证码与找回密码
提交工单：类型、标题、关联产品、影响程度、附件、联系邮箱、是否公开
我的工单：按状态筛选，查看进度百分比与完整处理时间线
补充说明与回复：用户在详情页追加内容，管理员回复，形成双向时间线
公开性自由切换：提交后可随时把工单在「公开 / 私密」之间切换
反馈大厅：浏览他人公开的工单，可整体关闭或设为「需登录」
个人中心：资料维护、积分余额查看
管理侧

仪表盘：工单 / 用户 / 邮件 / 趋势四类概览，近 7 日工单趋势图，最近操作动态
工单管理：按状态、类型、关键词筛选，状态与进度调整、回复、删除、CSV 导出
用户管理：搜索、禁用 / 恢复（禁用即时下线）
奖励管理：质量等级配置、积分发放确认、撤销、手动调整，全程留痕
邮件通知：SMTP 配置、测试发信、6 套模板自定义、发送队列排查与手动重试
站点品牌：系统名称、图标、ICP 备案号
界面与导航：PC 顶部菜单、移动端快捷入口、首页幻灯片、页脚链接与文案
协议与声明：用户协议 / 隐私政策 / 免责声明 / 源码使用许可，后台在线编辑
账号安全：自助修改密码
关于系统：作者、QQ 群、官网与运行环境
工单体系

工单编号 WZ-0001 起自增生成，并发安全
5 状态闭环流转，3 种类型（建议 / BUG 修复 / 功能创意），3 档影响程度
附件：单个 ≤ 10MB、最多 5 个，仅白名单类型（图片 / PDF / 文本，禁用 SVG），随机重命名存储，经鉴权接口下载
积分奖励

3 档质量等级：精选建议 50 分 / 有用反馈 20 分 / 感谢参与 5 分（可自定义）
发放支持「自动」与「需管理员确认」两种模式
积分变动全程写入台账（point_ledger），支持撤销与手动调整，行锁保证并发安全
邮件通知

支持 SMTP 配置与测试发信
覆盖注册验证码、找回密码、工单回复、状态变更、进度更新、奖励发放
6 套模板可在后台编辑
内置发送队列：失败自动重试（最多 5 次），后台可查看失败原因并手动重试
三、技术特性
项目 说明
后端 原生 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; } location = /install.php { deny all; }