铭安PHP反馈系统是原生PHP 7.4+与MySQL开发的零依赖反馈工单系统，免框架、免Composer、免构建，上传即用。工单五状态带进度流转，邮件自动通知，积分奖励与反馈大厅形成闭环；内置PDO预处理、CSRF、bcrypt等安全设计，PC/移动双端适配、一键安装，让反馈可跟踪、可公示、可激励。
铭安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，并按部署文档配置伪静态规则
- 伪静态规则如下：
text
location /api/ { try_files $uri $uri/ /api/index.php?$query_string;}
