FIT2CLOUD
家庭私厨 的图标

家庭私厨

1,166
263

基于halo提供的家庭点菜插件。

v1.0.3
Avrinbai 发布于

v1.0.3

最新
>=2.23.0

v1.0.3 — 标题写得像自家馆子,备份写得像成年人抽屉

这一版主打三件事,用人话讲就是:

👉 前台终于知道自己在叫什么
👉 后台能打包带走全家档口数据(导出 / 覆盖导入,ZIP 里还带说明书那种)
👉 控制台界面顺手捋了捋


新增 / 强化

前台:标题三件套

后台 插件设置 → 基础设置 里,可以给前台配上:

  • 站点标题(浏览器标签 document.title 那一套)
  • 顶栏主标题
  • 顶栏副标题

👉 全家馆子顶栏不再默认「谜之占位符」,改成你家招牌也行、改成「今晚吃火锅」也行(只要你家掌柜同意)。

配置走 DishesSettings,前台模板与控制台表单对齐;细节实现详见仓库内对应改动。

后台数据备份(导出 / 覆盖导入)

控制台 插件设置 → 数据备份

  • 导出:ZIP,内含 manifest.json;可选是否带上点餐记录。
  • 导入覆盖式——会先清空当前 订单 + 菜品 + 分类,再按备份重建。
    👉 不是「增量合并」,是「整抽屉倒空再摆回去」,点导入前请默念三遍备份。

备份里的菜品图:只备份 image_url(路径或完整地址),不把图片文件塞进 ZIP
迁站或换域名时,记得附件还在、外链还能打开,否则导入成功也可能「看得见菜名、看不见菜脸」。


🛠 调整与修复(挑重点说)

备份这条链路,是真的跟 WebFlux 打过一架

Halo 2 这条线是响应式的,导入上传按 FilePart 等方式处理,避免 multipart 绑定翻车;业务异常也会尽量回到 ok: false 的 JSON,而不是糊你一屏 500。

清空数据时的「玄学索引滞后」

覆盖导入前要清空扩展数据;若列表索引还没反应过来,可能出现「菜删光了、分类还在那儿发呆」这类剧情。
这一版在清空逻辑里加了 等待索引跟上 + 必要时重建扩展索引 等处理,尽量做到 第一次点就靠谱,而不是「第一次失败、第二次换报错、第三次突然成功」的三幕剧。

(若你曾在导入时见过类似连续剧,恭喜你 —— 你现在看到的是导演剪辑修复版。)

控制台插件 UI(Vue)

  • 例如:菜品列表缩略图统一尺寸、裁切更顺眼。

⚠️ 备份提醒(很重要)

👉 覆盖式导入会删除现有订单、菜品、分类,执行前请确认你真的不需要当前数据,或已经另外导出备份。
👉 ZIP 不含图片文件,只有路径;跨环境恢复请自备图片可达性(站内附件或外链)。
👉 若导入仍异常,优先带 响应 JSON / Halo 日志片段 开 issue,比截图玄学好排查得多。


致谢

感谢「为什么导入要三次才成功」「清空一半算清空吗」这类灵魂拷问 —— 它们直接变成了这一版的清空与索引逻辑。

继续欢迎吐槽;若有问题,尽量附上 Network 响应体 + 相关日志,治愈概率会指数上升。


Full Changelog: v1.0.2...v1.0.3

(具体文件级差异以 Git 对比为准,此处为面向人类的 Release 叙事版。)

资源下载

  • plugin-dishes-1.0.3.jar
v1.0.2
Avrinbai 发布于
>=2.23.0

v1.0.2 — 独立部署更省心,白名单防「借站点菜又不吃系列」

两件事说人话:
👉 独立域名部署不再踩坑
👉 别人别再拿你接口当公共食堂

顺便把 README 重写了一遍(这次是真能照着配,不是玄学)。

新增

  • 域名白名单
    后台可限制来源域名,请求不对直接拦。
    👉 不再被别人套壳白嫖接口
    👉 留空 = 保持原来宽松模式

  • 独立部署前台页面

    • 支持:
      • VITE_ASSET_BASE(静态资源)
      • VITE_PUBLIC_BASE(路由)
    • 图片不再 404
      • VITE_MEDIA_ORIGIN 指回主站 /upload
      • 👉 测试域名也能正常出图

⚠️ 部署提醒(很重要)

👉 独立域名一定要:

  • Nginx 反代 API
  • VITE_MEDIA_ORIGIN(图片)

别只代理接口,结果图片全 404(这坑很多人踩过,我就是其一)


其他

  • 修复未知问题,优化细节体验

资源下载

  • plugin-dishes-1.0.2.jar
1.0.1
Ryan Wang 发布于
>=2.23.0

首个版本发布 🎉功能特性

  • 菜品分类管理(新增、编辑、排序、删除)
  • 菜品管理(上下架、推荐等级、餐段配置、批量删除)
  • 点菜记录管理(按日期查看、明细查看)
  • 前台点菜页(早餐/午餐/晚餐、提交备注、预约点餐)
  • 访问控制(公开访问/密码访问)
  • 消息通知(支持企业微信 webhook 推送)

Generate from v1.0.1

资源下载

  • plugin-dishes-1.0.1.jar