v1.0.0 首发版

一、 版本概览

• 发布日期：2026年6月16日
• 访问地址：https://kf.ap100168.com/
• 管理后台：/admin/ （密码：etongxi2026）
• 部署服务器：TM服务器 1.12.250.128 (Ubuntu)

二、 新功能清单

2.1 H5 客服主页面

• 一键拨打电话 — 直接呼叫客服电话，无需复制号码
• 企业微信客服 — 点击跳转企微客服会话窗口
• 微信号复制 — 一键复制微信号，方便添加好友沟通
• 蓝色渐变 UI 设计 — 移动端适配，操作流畅

2.2 FAQ 常见问题（手风琴面板）

• 扫码扣费未启动/不出水
• 扫码失败/设备离线
• 设备故障报修
• 退款申请流程
• 设备不通电处理
• 蓝牙连接异常
• 其它异常情况
• 每条 FAQ 配有标准化客服话术

2.3 用户留言反馈系统

• 文字留言 — 用户可输入详细问题描述
• 图片上传 — 支持拍摄或选择相册照片作为附件
• 视频上传 — 支持录制短视频展示故障现象
• 历史记录 — 用户可查看自己过往的留言及回复记录
• 独立会话 — 每个用户自动创建独立对话线程，消息隔离

2.4 管理后台

• 密码登录保护 — 默认密码 etongxi2026
• 全部留言列表 — 按时间倒序展示所有用户留言
• 一对一回复界面 — 管理员与每个用户的独立对话窗口
• 多媒体回复 — 管理员支持文字+图片回复
• 状态管理 — 标记「待回复 / 已回复 / 已关闭」三种状态

2.5 自动备份系统

• 每日定时备份 — 凌晨 02:00 自动执行（Cron 定时任务）
• 数据库备份 — SQLite 数据库完整导出
• 附件备份 — 用户上传的图片/视频文件归档打包
• 邮件通知 — 备份完成后发送到 QQ 邮箱（616865834@qq.com）
• 保留策略 — 自动清理 30 天前的旧备份，节约磁盘空间

三、 技术配置

3.1 服务器环境

• 操作系统：Ubuntu Linux
• Web 服务器：Nginx + PHP 8.3-FPM
• 数据库：SQLite（轻量级，无需额外安装数据库服务）
• SSL 证书：Let's Encrypt（自动续期）
• 域名解析：kf.ap100168.com → 1.12.250.128

3.2 Nginx 关键配置

• HTTP → HTTPS 自动跳转（301 永久重定向）
• PHP-FPM 处理（fastcgi_pass unix socket）
• /data/ 目录拒绝访问（deny all，保护上传文件）
• 客户端请求体上限 10MB（支持大文件上传）

3.3 定时任务与邮件

• Cron 表达式：0 2 * * *（每天凌晨 2 点）
• SMTP 服务：QQ 邮箱 SMTP (smtp.qq.com:465 SSL)
• 备份存储路径：/var/backups/etongxi/
• 备份格式：.tar.gz（gzip 压缩）

四、 小程序改造（待发布）

4.1 新增页面：pages/contact/

• contact.wxml — 页面结构模板
• contact.wxss — 页面样式表
• contact.js — 页面逻辑（web-view 加载 H5）
• contact.json — 页面配置

4.2 改造页面：pages/lfradius/ 报修页

• 在报修页面底部增加悬浮「联系客服」按钮
• 点击跳转至 pages/contact/ 客服页面
• 涉及修改 3 个文件（wxml/wxss/js）

4.3 技术交接包

• 打包文件：weixin_miniprogram_etongxi.tar.gz
• 存放路径：C:\计费\weixin_miniprogram_etongxi.tar.gz
• 小程序 AppID：wx1da035c74904bf73
• 密钥文件已保存：keys/wx1da035c74904bf73.key

五、 项目统计