代理服务 · 菜单（商城）模块（menu-Modules）

服务分类：代理服务 —— 对应统一菜单（商城）管理域与 store / nflive 平台

模块定位

统一菜单（商城）管理：以菜单树为商城商品/频道的主数据模型， 对 store 商城平台与 nflive 生活·商城客户端提供统一目录服务。

功能

• 菜单树管理：menu_id 幂等 upsert、父子结构、平台维度（store 等）、 图标/路径/排序/启用开关；删除保护（存在子节点不允许删除）；
• 种子数据：首次启动预置商城频道/商品（seed_mall_menus）；
• 商城消费：nflive 商城页按 ?tree=true 渲染商品卡并下单；
• 平台扩展：菜单平台字段可扩展多商城/多端（Web / 小程序）。

接口要点

GET  /menus?platform=&tree=  菜单列表 / 树（公共读取）
POST /menus                  菜单 upsert（admin）
PUT  /menus/{menu_id}        菜单更新（admin）
DELETE /menus/{menu_id}      删除菜单（admin，有子节点拒绝）

数据表：menus（menu_id/parent_id/name/icon/path/sort_order/enabled/platform）。

状态与关联

• 已实现（nfarmsd v2.3.0 统一菜单管理域）；种子 6 个商城菜单；
• 关联前端：store/、nflive（商城下单）；关联文档：../nfarms/store.md。