多租户反馈平台 · MultiFeedbackSystem

项目简介

多租户反馈平台(MultiFeedbackSystem) 是一套为公司内所有软件系统提供统一问题反馈接入、汇聚、处理、统计与审计能力的服务端应用。任何系统只需在平台注册一个应用,即可获得独立身份(app_key + 专属分享令牌),反馈按应用归档、按用户隔离、进入统一后台处理,实现"一套平台,接所有系统"。

平台为纯服务端渲染的单体应用,采用 PHP ≥ 7.4 + MySQL ≥ 5.7 技术栈,零框架依赖、零 Composer 依赖,单台 LNMP 服务器即可承载,部署成本以分钟计。配套功能覆盖多用户权限、截图上传、离线日志导入、看板运营、邮件 / 短信通知、审计留痕,做到"开箱即用、可视化运维"。

核心特性

• 多租户统一接入:应用注册制管理,反馈按 app_id 归档、筛选、统计;每个应用拥有独立的 app_key(API 鉴权)与 share_token(专属提交链接,可在泄露时独立吊销)。
• 双通道提交:API 接入(POST /api/submit.php,JSON,app_key 鉴权) + 专属提交页(feedback.php?t=<分享令牌>,零代码接入终端用户)。
• 离线日志导入:无法联网的桌面工具 / 内网系统可将运行日志打包 zip(≤ 50 MB)后台导入,自动流式解压 12 类文本日志并转结构化反馈,防压缩炸弹 + 总量限幅。
• 运营看板:今日新增 / 待处理 / 处理中 / 累计 / 已解决率 / 平均处理时长 6 项 KPI,近 14 天趋势、状态环形图、应用 TOP、健康巡检一屏可看。
• 多用户与权限分级:用户 / 管理员两级角色,数据强隔离,普通用户仅见名下应用,管理员全局可见;支持用户全生命周期管理(创建 / 启停 / 重置 / 删除 + 应用归属转移)。
• 多通道通知:手写 SMTP 邮件(SSL / TLS / 明文) + 阿里云 / 腾讯云 / 华为云短信直调(无云 SDK),系统设置页可视化配置,支持测试邮件 / 试发短信。
• 安全合规:PDO 预处理、CSRF hash_equals 校验、上传 MIME / 扩展名 / 图片内容三重白名单、登录连续失败 5 次锁定 10 分钟 + 图形验证码、IP 限流 30 次 / 分、全量操作审计留痕、安全响应头。
• 低成本可运维:schema.sql 一文件建库;无第三方运行时依赖;前端构建产物(已哈希命名)由 nginx 直服务,天然支持 CDN 化。

适用场景

界面预览

门户首页(对外)

访客入口,展示平台已接入系统与动态统计;出于安全设计,不公开展示任何 app_key。

反馈提交页(专属链接)

通过 反馈系统应用下发的专用链接 打开,自动校验应用身份;支持问题分类、详细描述、最多 9 张截图上传(单张 ≤ 5 MB)、联系方式选填。

管理后台(运营工作台)

登录后进入工作台:状态统计卡、应用 Tab 筛选、关键词搜索、详情处理、应用管理、用户管理、系统设置、审计日志一应俱全。

关键选型理由:PHP 团队既有栈,零 Composer 依赖,部署面最小;MySQL 事务 + 二级索引足够,无需 ORM;Vue 3 仅作"岛屿"局部接管交互,主体保持 SSR,无 SPA 路由 / 状态管理负担;Vite 5 + Less 4 仅在开发机使用,服务器不装 Node。

技术指标

快速部署(5 分钟)

# 1. 建库
mysql -u root -p < schema.sql

# 2. 配置数据库连接(api/config.php)
define('DB_NAME', 'multifeedback');
define('DB_USER', 'multifeedback');
define('DB_PASS', 'CHANGE_ME_DB_PASSWORD');

# 3. 上传整站代码,chmod 755 uploads/ logs/

# 4. 登录 admin/(默认 Admin@123,首登强制修改)→ 「应用管理」发放 app_key

版本与路线

后续规划(非阻塞):密码哈希升级 password_hash + nginx 登录限速 + 审计日志定期归档 + 严格 CSP + 移动端独立优化。