落朵机器人论坛 操作指引

本文档为论坛的在线操作指引，涵盖使用、运维、备份、版本与合规。部署固定：端口 8800 / 域名 lt.ap100168.com。

二、访问与部署固定标识

论坛为独立服务形态，部署于 1.12.250.128，与易得售货机、挺盈宝、视音流媒体等其余业务互不干扰。

三、日常使用操作

1. 进入论坛
   1. 打开 https://lt.ap100168.com/，点击右上角「登录 / 进入」。
   2. 输入昵称（如「小兴」）即可签发访问令牌，无需密码；令牌存于本地浏览器。
2. 浏览与互动
   1. 左栏切换版块（技术分享 / 选品运营 / 机子运维 / 门店活动），顶部「最新 / 最热」排序。
   2. 点击话题卡片查看详情，支持楼中楼回复；登录后可发帖、回复、@朵朵。
3. 机器人主持「朵朵」
   1. 发帖或回复中 @朵朵 可触发 AI 主持建议（选品 / 机子 / 运营 三类）。
   2. 详情页自动展示朵朵的初步解答，欢迎真人伙伴补充。
4. 论坛机子（交流核心）
   1. 右栏「论坛机子 · 交流核心」为门店触屏终端面板，显示在线 / 话题 / 回复统计。
   2. 点击「在机子上发帖」即可在门店终端参与社区。

四、运维操作指引

1. 服务启停（服务器 1.12.250.128）
   1. 状态：systemctl status forum
   2. 重启：systemctl restart forum
   3. 日志：journalctl -u forum -f
2. 前端更新流程（铁律一：先备份）
   1. 备份：tar czf /home/ubuntu/backups/forum-pre-$(date +%Y%m%d_%H%M%S).tar.gz -C /home/ubuntu luoduo-forum
   2. 上传新 web/ 与 app.py 到部署目录，重启服务。
   3. 校验：curl -s https://lt.ap100168.com/api/health 返回 ok:true。
3. SSL 证书（Let's Encrypt，ECDSA，webroot 模式）
   1. 证书目录：/etc/letsencrypt/live/lt.ap100168.com/
   2. 续期靠 certbot.timer 每日运行；续期后由 reload-nginx.sh 重载 Nginx。
   3. 手动校验：sudo certbot renew --cert-name lt.ap100168.com --dry-run

五、备份与容灾

1. 每日邮箱备份（固定 2:00）
   1. 每日 02:00 自动执行论坛全量备份：SSH 打包 /home/ubuntu/luoduo-forum + forum.db。
   2. 备份上传至 COS 多 AZ 桶（luoduo-az-storage），并发送 QQ 邮箱完成通知（含文件名 / 大小 / COS 结果）。
   3. 防护体系：本地备份 + COS 多 AZ + 邮箱通知 三重兜底。
2. 恢复
   1. 从 COS 或本地 /home/ubuntu/backups/ 取对应时间戳包，解压回部署目录，重启 forum 服务。
   2. 数据库为单文件 SQLite，直接替换 forum.db 即可（替换前务必先备份当前库）。

六、版本号管理（每次升级叠加）

1. 版本号规则
   1. 采用 主.次.修订（X.Y.Z），修订号 Z 为每次升级叠加位。
   2. 功能大版本升 Y，重大架构升 X。
2. 查看与升级
   1. 当前版本见论坛底部信息栏「版本 vX.Y.Z」，或接口 GET /api/version。
   2. 每次升级后运行叠加：python bump_version.py（1.0.0 → 1.0.1）；可选 --minor / --major。
   3. 版本文件 forum_hub/VERSION 由脚本自动写入，前端实时读取，无需改代码。

七、备案与合规信息

1. 运营主体
   1. 企业名称：兴华科技（深圳市兴华信息技术有限公司）
   2. 服务域名：lt.ap100168.com（同生态统一备案）
2. 备案号
   1. 粤ICP备15043514号（与 ap100168.com 生态统一，已在页脚展示）
   2. 页脚信息栏含：兴华科技 · 粤ICP备15043514号 · 年月日 · 版本 · 在线文档 · 服务端口/域名。