奇乐备婚助手 · 管理后台

已登录:
接口地址:

管理员登录

欢迎回来

已登录:… · — · 版本 — ·  · 

快捷入口

最近操作

加载中…

数据概览

使用深度(漏斗)

单位为工作区:一对新人共用一个,未建共享空间的用户各算一个。所以这里数的是「多少对新人」,不是「多少个人」。

加载中…

广告漏斗(近 1 天)

按广告位置(spot)拆开看:曝光 → 看完 → 导出。完播率低说明解锁前置提示不够,导出转化低说明用户中途放弃了。

加载中…

趋势(近 30 天)

加载中…

各模块数据量

运营提醒

💾 备份:—
🩺 体检:—

最近操作

加载中…

用户管理

按昵称 / openid / 城市 / 新人姓名 / 用户ID 搜索,可就当前筛选结果导出 CSV。

每页:

婚礼空间管理

两人共享的婚礼空间。可查看成员、强制解散(解散会解绑所有成员并清空该空间的共享数据,不可恢复)。

分享链接

用户把「婚礼当天流程」分享给总管 / 伴郎伴娘后生成的只读链接。访问量每次打开都会累加,可据此判断分享有没有人真的点开看。

全部链接

攻略内容管理

小程序「备婚攻略」页会读取这里发布且状态为上线的内容(内置 8 篇默认攻略始终可见)。

每页:

模板管理(流程 / 采买)

小程序「流程 / 采买」页的模板从这里读取 —— 改模板即时生效,无需重新提交小程序审核。
kind:timeline=婚礼当天流程;shopping=采买清单。items 为 JSON 数组:
流程项 {time,duration,title,place,person,remark,stage,items:[...]}; 婚品项 {name,category,quantity,unit,priority}(priority: high/mid/low)。

字段格式 —— 流程:时间|事项|地点|负责人|阶段|备注;采买:名称|分类|数量|单位|优先级;待办/清单:用 #分组 起头、每行一个事项(一行内可用 ; 分开);镜头:分类|形式|镜头|细节;预算:分类|名称|金额。

勾选左侧复选框后生效

请柬模板(邀请函样式)

小程序「电子请柬」的样式画廊从这里读取 —— 改模板即时生效,无需重新提交小程序审核。
两种引擎:canvas=内置绘制版式(随小程序包发布,后台可改文案 / 排序 / 上下架 / 解锁); image=图片版式(底图 URL + 文字块 JSON,后台上传即用,新增免提审)。
删除语义:内置模板「删除」= 下架(老用户已做好的请柬不丢版式,可恢复 / 可重置); 后台新增的图片模板「删除」= 真删除(配置一并清除,不可恢复)。

新增图片模板

每项 {x, y, size, color, align, text, gap?, vertical?, lines?, w?, max?}: x/y 为 0~1 比例坐标;size 相对画布宽(0.016≈附注,0.026≈正文,0.10≈大囍字);align 可选 left/center/right; text 支持占位符 {{groom}} {{bride}} {{dateCn}} {{weekCn}} {{lunar}} {{meal}} {{hotel}} {{address}} {{bigTitle}};竖排表单要分栏填年月日的,用 {{dateY}}(2026)/ {{dateM}}(10)/ {{dateD}}(25)/ {{lunarM}}(八)/ {{lunarD}}(廿一)/ {{weekDay}}(日)六个分段占位符(公历年月日用阿拉伯数字、农历用中文,与手写请柬一致);竖排里填时刻别用 {{time}}(12:00 会逐字堆成 1/2/:/0/0),用 {{timeCn}}(十二时), 未知占位符会原样显示(配错一眼可见)。

系统公告

前端首页顶部公告条会读取这里「已上线」且已到发布时间的公告(按置顶排序 / 发布时间倒序)。紧急级在前端用醒目色标出。

勾选左侧复选框后生效

广告配置(流量主)

开关与 ad-unit-id 都在这里填 —— 改配置即时生效,无需重新提交小程序审核。
关闭开关或不填 ID 时,小程序端不展示任何广告,也不影响任何功能(导出长图等流程照常可用)。
ID 从微信公众平台 → 推广 → 流量主 → 广告位管理 里创建后复制过来。

当前状态:读取中…

小程序远程配置(免提审)

这些文案 / 开关存在后台,改值即时生效,无需重新提交审核;但需小程序端已有对应读取逻辑(首次接入需随版本提审一次)。

这几个「默认模板名」要填与模板列表里完全一致的名字,载入模板时会被顶到第一位。 留空则由用户在小程序里选的婚礼形式决定默认(宴会厅 → 中式午宴;户外 → 户外草坪; 小型简约 → 小型家宴;旅行结婚 → 旅行结婚),两者都没有就用模板列表原本的顺序。

订阅消息(婚期倒计时 / 待办临期)

在这里填微信公众平台申请的订阅模板 ID 与定时推送密钥,保存后立即生效,无需改代码、无需重新提审。
模板 ID 从 微信公众平台 → 订阅消息 → 我的模板 复制;关键词顺序需与后端 handlers_notify.php 的 keys 对应。
填好后,前端保存婚礼信息/待办时会自动向用户申请授权,后端 crontab 到点推送(详见项目内《订阅消息接入说明》)。

未填写模板 ID 时,小程序「我的 → 消息提醒」会显示"需在后台配置订阅模板",属正常现象,不是故障。
四步开通(约 5 分钟):
① 登录 mp.weixin.qq.com → 左侧「订阅消息」→「公共模板库」搜索 婚礼 / 待办;
② 选用模板(需能与下列关键词对上,见下方对照表)→「选用」→ 复制得到的模板 ID(形如 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx);
③ 把模板 ID 填进下面两个输入框,并设置推送密钥 NOTIFY_KEY(任意长随机串),点「保存配置」;
④ 在服务器宝塔「计划任务」加一条 crontab 定时访问推送接口(详见《订阅消息接入说明》第 4 节),密钥与上面一致。
用途需选用的关键词(按模板内顺序)类型要求
婚期倒计时 默认假设:提醒时间 → date1;温馨提示 → thing2 日期/时间类 + 文本类(≤20 字)
待办临期 默认假设:事项名称 → thing1;未完成待办数 → number2 文本类 + 数字类

上表只是内置默认值,不代表你模板的真实关键词(同为「婚礼倒计时15天提醒」,不同账号选到的可能是 date1 也可能是 time2)。 关键词名 = 类型名 + 模板内位置序号,序号必须按你模板里关键词的实际顺序数 —— 图例见「我的模板 → 模板详情 → 详细内容」里的 {{time2.DATA}} 这类占位符。 对不上就会返回 47003,以「深度检测」第 ⑧ 项的比对结果为准。

留空即可:系统会拉取你在微信后台的真实模板,按关键词类型自动适配(日期/时间型给婚期,数字型给天数或未完成数,其余给文案),无需手抄 {{time2.DATA}} 这类占位符。 只有当自动适配不合你的心意时,才需要在下面填 JSON 来精确指定某个关键词填哪个字段 —— 手动配置优先级最高。 键 = 微信模板关键词名(类型名+序号,如 thing1), 值 = 系统提供的字段(婚期倒计时可选 date/countdown/days;待办临期可选 title/undone/date)。 JSON 不合法会在保存时当场报错。想确认最终结果?点「深度检测」,第 ⑧ 项会显示当前实际生效的映射。

推送节点可自由调整:例如填 1,3,7,15 表示婚期前 15/7/3/1 天各推一次倒计时; 填 daily 表示「婚期前 N 天内每天推一次」——这就是「倒计时每日服务通知」。 注意:微信「一次性订阅」每次授权只能推 1 条,每天推需要用户多次授权(授权次数耗尽后自动停推,不会骚扰)。同一天同一类消息对同一用户最多推一次(后端按日期去重),不会重复打扰。

当前状态:读取中…

推送概览

「持有额度」= 用户授权后尚未消耗的可推次数(一次性订阅:每次授权只能推 1 条)。 「今日已推」= 今天至少收到过一条订阅消息的用户数。

统计加载中…

链路自检

把「用户授权 → 后端扫描 → 微信下发」整条链拆成 7 环逐个判定,直接告诉你哪一环断了、去哪修。
为什么需要它:上面「▶ 立即试推一次」返回的「无额度」把「模板 ID 没填」(故障,要修)和 「用户还没授权」(正常,等用户点允许)混在同一个数字里,看不出真因。本自检把两者分开。 判定分三级:正常 / 需注意(不是故障) / 异常(必须修)。

「深度检测」会实际向微信换一次 access_token,能抓出 40164 服务器 IP 不在白名单 这类 只有真调用才暴露的错误(快速自检不会联网,查不出这一项)。

尚未检测。点「开始自检」。

全量备份

导出全站数据(用户 / 婚礼 / 宾客 / 采买 / 预算 / 流程 / 公告 / 攻略 / 模板 / 分享 / 红包等 23 张表,含请柬模板覆盖 tpl_meta)为一个 JSON 文件,用于运营兜底与迁移。

建议每周导出一次并妥善保存;数据库层面的定时备份请在宝塔 / 服务器上用 mysqldump 配置。

服务器端快照

在服务器 runtime/backup 下生成一份全量快照并自动轮转保留最近 5 份。即使浏览器关掉、电脑换掉,快照仍在服务器上,可随时下载。

按表导出 CSV

选择单张表导出为 CSV(Excel 可直接打开)。时间范围仅对「有创建时间的表」生效,留空即全部。

数据体检

扫描孤儿数据(婚礼/用户已删除但业务数据还在)、空婚礼(已无成员)、模板历史版本堆积。清理不可恢复,建议先导出备份。

内容导入(从备份恢复)

选择「导出全量数据」得到的 JSON 备份,把其中的 攻略 / 公告 / 模板 / 宾客 / 预算 新增导入(不覆盖、不修改)。导入宾客 / 预算时必须填写目标 scope(婚礼空间,形如 u_<用户ID> 或婚礼空间 ID)。

系统状态自检

部署后自查:PHP 版本与扩展 / .env / 密钥 / 数据库 / 数据表是否齐全 / 目录权限。需管理员登录才能查看。

数据库结构升级

补齐新版本新增的字段(只补列,不建新表)。升级后端代码后点一次即可。 漏点会出现「保存失败」或「部分新功能还不能保存」——例如本次的「婚礼形式」保存不上, 就是因为 users 表缺 wedding_style 列。

运行日志

读取服务器 runtime/log 下的日志尾部(已脱敏:手机号 / openid / 密码字段会打码)。免登服务器即可排查问题。

(加载中…)

错误 / 慢请求概览

跨所有日志文件聚合各等级日志条数与慢请求计数,并抽样几条 ERROR。纯解析、不改表,后台一眼看健康状况。

加载中…

回收站

被删除的攻略 / 公告 / 模板会先进入这里(不再直接物理删除)。可恢复;7 天前的会自动清理,也可手动彻底删除。

管理员账号

在 .env 单口令之外增设运营账号,操作日志会记到具体账号。一旦这里有账号,.env 里的引导账号即停用(避免两套口令并存)。

已有账号

操作日志

记录后台对攻略 / 模板 / 公告 / 用户 / 婚礼 / 广告等的新增、修改、删除、回滚操作,便于回溯。