铭安 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、fileinfoMySQL 5.7+ / MariaDB 站点根目录指向项目目录，上传后访问 install.php 完成安装安装完成后务必删除 install.php，并按部署文档配置伪静态规则伪静态：location /api/ {try_files $uri $uri/ /api/index.php?$query_string;}
暂无评论内容