扫码领券 + 扫码直接进福利群（含甜柿季 / 红叶季 / 红枫谷温泉群）
一句话结论
门店福利群（智游大别山 · 罗田福利群）已上线并实测通过：手机微信扫码 → 底部绿色「加入群聊」→ 直接进群，无需人工审核、也不会走到加好友（群里已设置「不能在群里加人」）。
页面文案已按口令调整：全站不再出现「活码」这个技术词，直接把群名写在二维码上方 （顾客看到的是「智游大别山 · 罗田福利群」，不是「企业微信活码」）。
另外，「甜柿季」「红叶季」两个活动群的群码都已配好并上线（群与群互相独立，扫码各进各的群）； 本轮又新增第三个活动群「红枫谷温泉群♨」（温泉季） —— 页面 / 二维码 / 海报已就绪， 它是在数据台加一条记录就长出来的，零代码改动； 群码也已配好上线（22:56），扫进去就是红枫谷温泉群♨，不会串到别的群。
至此四个群（门店群 + 甜柿 / 红叶 / 红枫谷温泉）全部配齐上线。 另外标一处待你一句话：门店 6 个页面二维码上方写的「智游大别山 · 罗田福利群」是早期自拟名， 实际扫进去是甜柿群 —— 并入甜柿群（改群名）还是另建门店群，你定了我 10 秒改（见第四节）。
一、已上线（点开就能看）
| 入口 | 地址 | 状态 |
|---|---|---|
| 门店扫码落地页 | https://ltdlt.cn/coupon/scan?s=wenquan 门店切换只改 ?s=；也可带 &cid=券id 指定券 | 200 |
| 进福利群页（直接显示群名） | https://ltdlt.cn/coupon/wecom?s=wenquan | 200 |
| 扫码领券数据台 | https://ltdlt.cn/coupon/admin/scan 门店管理 / 全局群二维码配置 / 物料下载 / 分门店数据（券系统管理口令） | 200 |
| 操作手册 | https://ltdlt.cn/coupon/scan/manual | 200 |
| 店员核销台 | https://ltdlt.cn/coupon/redeem（原有） | 200 |
| 甜柿季活动群 罗田甜柿季 · 尝鲜福利群 |
https://ltdlt.cn/coupon/scan?s=tianshi | 200 |
| 红叶季活动群 大别山红叶季 · 赏叶播报群 |
https://ltdlt.cn/coupon/scan?s=hongye | 200 |
| 红枫谷温泉群（新） 红枫谷温泉群♨ · 温泉季 |
https://ltdlt.cn/coupon/scan?s=hongfenggu | 200 |
| 红枫谷温泉群 · 进群页 | https://ltdlt.cn/coupon/wecom?s=hongfenggu | 200（群码已配） |
| 老板门户入口 | https://ltdlt.cn/boss.html →「常用」分组 →「扫码领券 · 门店码/进福利群」（卡片文案同步去掉「活码」） | 已挂 |
二、链路（一张图）
| 段 | 用什么 | 谁做 |
|---|---|---|
| ① 门店码 | 每店一个码 /coupon/scan?s=门店key，参数区分门店（也含 &cid= 指定券） | 已完成，后台可一键下载 |
| ② 领券 | 复用券中心同一张券库（coupons/user_coupons），领一张减一张库存，同机不重复发 | 已完成 |
| ③ 扫码进群 | 企业微信官方客户群「加入群聊」码（群满自动建新群；群里已关「互相加好友」） | 门店群已上线实测通过 甜柿 / 红叶 / 红枫谷温泉均已配码上线 |
| ④ 核销 | 员工核销台输码核销，一次作废 | 已完成 |
| ⑤ 数据 | 分门店：扫码 / 领券 / 进群 / 核销 | 已完成 |
三、实测证据（不是「应该行」）
接口实测：/coupon/scan、/coupon/wecom、/coupon/qr.png、
/coupon/poster.png、/coupon/scan/claim 全部 200；
领券接口真实返回券码（实测样例 LT0000204423），数据台实时读到「6 个门店 / 14 次扫码 / 4 次领券」。
二维码实测解码（用解码器反读，不是肉眼看）：6 个门店的二维码与海报，全部解出
https://ltdlt.cn/coupon/scan?s=<门店>，与门店一一对应，零错位。
真机视口实测（440×956 手机视口，DPR 3）：无横向溢出（scrollWidth = 440 = 视口宽）、
领券前后状态切换正确、控制台零 JS 报错。
两个活动群本轮实测：?s=tianshi / ?s=hongye 页面 200，
不再误挂门店券（页面无「立即领取」按钮，改为「进群能拿到什么」福利清单）；
点「加入福利群」正确跳到 /coupon/wecom?s=tianshi|hongye 且群名各自命中；
海报与二维码解码反读全部命中 https://ltdlt.cn/coupon/scan?s=tianshi|hongye，零错位；
门店链路（温泉页仍有券、仍可领）回归通过，控制台零报错。
本轮文案复核（20:30）：/coupon/wecom、/coupon/scan、操作手册、数据台、
企微指引页、boss 门户卡片 —— 全站 「活码」 出现次数 0；
进群页把 群名 写在最显眼处（标题 + 二维码上方标签，原来那两处写的是「企业微信活码」）。
实测 440×956 手机视口无横向溢出、控制台零 JS 报错；群码与固定底栏实测重叠 0px
（滚到位置后群码 394–614px vs 底栏 900–956px）。
本轮新增「红枫谷温泉群♨」（22:50 建场景 · 22:56 配群码）实测：/coupon/scan?s=hongfenggu、
/coupon/wecom?s=hongfenggu、/coupon/qr.png?s=hongfenggu、
/coupon/poster.png?s=hongfenggu 全部 200；券中心季节芯片实测由 2 个变 3 个
（罗田甜柿季 / 大别山红叶季 / 红枫谷温泉群♨），点进去正确落到该场景；数据台实测出现 hongfenggu 行。
390 宽手机视口三页横向溢出 0px、JS 报错 0；点「加入福利群 · 领群专享福利」跳
/coupon/wecom?s=hongfenggu，页面标题与码上标签都是「红枫谷温泉群♨」，群码已实测挂上。
群码怎么验的（反读，不靠肉眼）：把线上 /uploads/wecom/group_hongfenggu.png 下载回来用解码器反读，
解出 work.weixin.qq.com/gm/a53b34bf… —— 与门店群、甜柿群、红叶群的码值逐一比对，四个码互不相同，零串码
（校验脚本 check_group_qr.py 逐场景列出码值与链接形式）。
该码链接形式为 work.weixin.qq.com/gm/<32位>，落 302 → 企微官方
apph5/external_room/join/group_mng，属永久有效那一类（不是 7 天过期的群二维码）。
另做扫描鲁棒性抽测：把码图缩到 120px、以及 300px 叠 2.0 高斯模糊，仍能正确解出 —— 真机可扫有余量。
线上图与本地图 md5 完全一致（eda2016e…），确认没被 CDN/代理改写。
回归：tianshi/hongye 仍挂各自群码、6 个门店仍挂全局群码，零串码；
场景自报了群名而群码未配时，页面显示「群二维码正在开通」、不会误挂别的群的码（这条硬规矩对以后每个新群都生效）。
四、你要做的（四个群已全部配齐；只剩 1 个二选一的决定）
门店群、甜柿群、红叶群、红枫谷温泉群都已配好群码并上线。剩下一个决定要你拍板：
| 建哪个群 | 群名 | 现状 |
|---|---|---|
| 门店福利群（1 个，全站门店共用） | 智游大别山 · 罗田福利群 | 数据台 →「全局配置」→ 群二维码图 URL ✅ 已填好上线 |
| 甜柿季群 | 罗田甜柿季·尝鲜福利群 | 数据台 → tianshi 那行 → 群二维码图 URL✅ 已配好上线 |
| 红叶季群 | 大别山红叶季·赏叶播报群 | 数据台 → hongye 那行 → 群二维码图 URL✅ 已配好上线（永久码） |
| 红枫谷温泉群（新） | 红枫谷温泉群♨ | 数据台 → hongfenggu 那行 → 群二维码图 URL✅ 已配好上线（永久码，22:56） |
① 门店并入甜柿群 → 我把门店页群名改成「罗田甜柿季·尝鲜福利群」，与真实群名一致；
② 门店单独建一个群 → 你把门店群的码发我，我配上，门店与甜柿季就彻底分开。
work.weixin.qq.com/gm/…）；而甜柿群和门店群挂的是同一张码，
链接形式是 c.weixin.com/g/…，属群聊自带的群二维码、7 天有效，
按该卡片标注约 10 月 19 日前后失效（届时甜柿季页 + 6 个门店页扫码会进不去群）。
建议按 建群指引 把这两处也换成
「加入群聊」永久码，一张码管到底、群满自动裂变；你把码发我，我 10 秒换上。
- 用管理员号登录企业微信管理后台 work.weixin.qq.com（浏览器打开，手机企微扫码登录）
- 左栏「客户与上下游」→「客户联系」，确认已开通（需企业已认证：认证费 300 元/年，或复用已认证的公众号资质免认证费）
- 逐个建群二维码：客户联系 → 客户群 → 加入群聊 → 新建；选群主（客服/店长企微号）； 打开「群聊满员后自动新建群聊」；保存 → 下载二维码图片（每个群 1 张）
- 把图发我（或自己传到服务器），按上表填到对应位置 —— 群与群互相独立， 甜柿页只进甜柿群、红叶页只进红叶群、温泉页只进温泉群、门店页进门店群
- （可选）若想让顾客加客服好友而不是进群：走「客户联系 → 联系我 → 新建」，类型改「客服二维码」
work.weixin.qq.com/ct/… 码已被替换。
甜柿群、红叶群、红枫谷温泉群随后也全部配码上线（各进各的群，零串码）。
四个群现已配齐；只有「门店页群名的归属」需要你二选一。
五、门店物料（已能一键出）
数据台「门店明细」每行有【二维码】【海报】两个按钮：
| 物料 | 规格 | 怎么用 |
|---|---|---|
| 门店海报 | 1080×1560（竖版，A5/A4 台卡） | 含门店名 + 券 + 二维码，打印放收银台 / 前台 |
| 门店二维码 | PNG，任意放大不失真 | 桌贴 / 立牌 / 席卡 / 打包袋 / 房卡套 |
本轮已按现有商户库预生成 6 个门店的物料（工作区 materials/ 目录）：
云栖民宿 / 薄刀峰景区 / 漂流擂台赛 / 板栗特产直营店 / 三里畈温泉 / 罗田吊锅城。
六、季节活动群（甜柿季 / 红叶季 / 红枫谷温泉群）—— 本轮新增
门店群是「到店客人」群；甜柿、红叶、温泉是「活动粉丝」群，人群不同，必须分开建群。 系统里这三条都已建好，页面 / 二维码 / 海报全部就绪：甜柿、红叶、红枫谷温泉三条的群码都已配上并上线 （红枫谷 22:56 配齐）—— 加上门店群，四个群全部配齐。
| 活动 | 群名 / 时点 | 物料 |
|---|---|---|
| 罗田甜柿季 | 罗田甜柿季·尝鲜福利群 10月26日开幕 · 持续到11月中旬；核心产区三里畈镇錾字石村（「中国甜柿第一村」，6000+ 株古柿树） |
页面 · 二维码 · 海报 |
| 大别山红叶季 | 大别山红叶季·赏叶播报群 10月28日启幕 · 最佳观赏期到11月下旬；九资河镇圣人堂村 / 河西畈水上红叶（全县约 450 万株乌桕） |
页面 · 二维码 · 海报 |
| 红枫谷温泉季 本轮新增 |
红枫谷温泉群♨ 冬泡季 · 地心 1800 米 68℃ 偏硅酸「美人汤」，户外 30+ 汤池；黄冈市浠水县团陂镇曹畈村， 与罗田县城一桥之隔、5 分钟进城区（G4221 罗田收费站下 3 公里；武汉向东 1 小时）。 在售冬泡卡 499 元 / 10 次（限量） |
页面 · 二维码 · 海报 |
四个设计要点（为什么这么定）
- 不误挂券：活动群默认不发券。原来按门店模式会自动挑「面额最大的自有券」， 甜柿页会莫名出现「民宿满200减50」—— 已改成只做进群，页面干净。
- 按活动说人话：不再说「门店专享券」，改成「进群能拿到什么」清单 （甜柿：产地直发价优先购 / 古柿林采摘与民宿预约 / 活动当天现场信息； 红叶：每周变色进度播报 / 最佳机位与错峰路线 / 拼车·民宿·门票信息）， 页面、海报、进群页文案全部按活动走。
- 一个活动一个群：群名、群二维码、数据按
skey独立（tianshi/hongye/hongfenggu），互不串； 以后加「板栗季」「冰雪季」照抄这三条即可。 - 群码没配就不许借码（本轮新增的一条硬规矩）：场景自报了群名、群二维码却还没配时， 页面不会回落去用全局群码 —— 否则页面写着某个新群名、码却指向甜柿群，扫码的人会进错群。 现在显示「群二维码正在开通」，码一填进去就自动恢复（红枫谷 22:56 填码后已自动切到自己的码）。 这条对以后每个新群都生效。
- 以后想配券：券中心发券并审核通过 → 把券 id 填到该活动记录的「该场景指定券 id」， 页面自动变成「领券 + 进群」两段式，代码不用再改。
三张海报与三个二维码已用解码器反读验证：
分别指向 ltdlt.cn/coupon/scan?s=tianshi、?s=hongye、?s=hongfenggu。
海报按 A5/A4 打印，贴在柿园门口、九资河观景台、民宿前台、县城餐馆等真实客流点；
二维码可做桌贴 / 立牌 / 展架。
七、费用与边界
| 项 | 说明 |
|---|---|
| 「加入群聊」二维码 / 自动进群 / 自动建群 / 渠道识别 | 全部免费（官方能力），只需企业主体认证 |
| 企业认证 | 300 元/年，或复用已认证的公众号/小程序资质 → 免认证费 |
| 三方 SCRM（可选） | 微盛 / 一维助手等 99~数千元/年，换「自动打标签 / 客户旅程 / 多渠道看板」； 现在这套不依赖它 |
| 我这套代码 / 页面 / 券库 / 二维码 / 海报 / 数据 | 0 元，全部跑在自有服务器自有域名下 |
八、技术落点（给工程看）
| 项 | 内容 |
|---|---|
| 新增模块 | /home/ubuntu/coupon_system/scan_mod.py（Flask Blueprint，10 条路由） |
| 既有系统改动 | app.py 仅 2 行注册蓝图 + templates/admin.html 加 1 个入口链接；既有逻辑零改动 |
| 新增表 | scan_stores（门店 / 活动场景 + 各自的群二维码）、scan_events（扫码埋点）、scan_settings（全局配置） |
| 本轮新增列 | scan_stores 幂等补 5 列：kind（store/season）、tagline、benefits、group_name、cid；老库自动迁移，无需手工 |
| 复用 | 券库存与核销完全复用 coupons / user_coupons / redemptions，不另起一套 |
| 路由挂载 | 沿用 nginx 既有 location ^~ /coupon/ 反代，nginx 配置零改动 |
| 备份 | /home/ubuntu/coupon_system/backup/app.py.bak_scanmod_*、scan_mod.py.bak_season_*、/home/ubuntu/backup/boss.html.bak_scancoupon_* |
| 页面文案口径 | 2026-10-12 所有者口令：全站去掉「活码」技术词，二维码上方直接显示群名。已改：
/coupon/wecom、/coupon/scan、数据台、操作手册、企微指引页、boss 门户卡片、本报告；
群名走配置（scan_settings.group_name），换群名不用改代码 |
| 守卫对齐 | page_feature_guard.py PINNED 已加 coupon/admin/scan；
boss_layout_guard.py --pin 已重落权威副本（自愈不会回滚） |