| 1 |
商品上架与编辑 |
客户端「设置」抽屉 →「关于」分组内连击「版本 v1.0.0」5 次解锁 →「👤 商家后台登录」（或地址栏加 #admin 直达）→ 输入商家账号与密码并通过校验后 → 商家后台左侧「商品管理」→「+ 新增商品」或列表行「编辑」。进入前提：已完成商家登录且会话有效；管理员账号须由店主创建后才可登录。 |
可查看全部商品（含已下架）的图片、名称、分类、副标题、标签、价格、库存、已售与在售状态。可编辑项：商品名称、售价、一句话副标题、分类、标签（英文逗号分隔）、原价、库存、排序、图标 emoji、商品图片、Markdown 商品详情、「立即上架」与「设为招牌推荐」开关；其中名称与售价为必填项。只读项：已售数量、创建时间。修改后点击「保存并同步云端」即时生效，顾客端刷新即可见；列表行可一键「上架 / 下架」即时切换，也可二次确认后删除商品。 |
| 2 |
商品图片与附件（云端存储） |
商家后台 →「商品管理」→ 编辑商品弹窗内的「图片（云端存储）」拖放区，或详情编辑区工具栏「🖼 插入图片」「📎 插入附件」；批量图片与附件的存放位置在「店铺设置 → 云端数据库与存储」中查看。进入前提：已登录商家账号；云端模式下需已配置 Supabase 与 Storage 桶名。 |
可查看已上传图片的缩略图列表与正文中已插入的图片、附件链接。可编辑项：点击选择或拖拽上传多张商品图片（自动压缩后写入云端桶 products / articles）、删除已选图片、在正文任意位置插入图片与附件（pdf / docx / xlsx / zip / txt 等，上传至 attachments 并以 Markdown 链接追加）。只读项：上传成功后返回的云端访问地址。图片随商品保存一并写入云端，即时生效；未启用云端时图片仅存于当前浏览器——是否对用户可见提示待确认。 |
| 3 |
标签与分类 |
商家后台 →「商品管理」列表「名称 / 分类」「标签」列查看，分类与标签均在编辑商品弹窗内维护；顾客端对应首页「标签分类」筛选。进入前提：已登录商家账号。 |
可查看每件商品所属分类与已填标签。可编辑项：分类（文本填写，如面包 / 蛋糕 / 饮品，留空时归为「其他」）、标签（英文逗号分隔填写，用于客户端热门标签筛选）。只读项：客户端按商品聚合生成的筛选结果。修改后随商品保存一并生效；暂无独立的分类 / 标签维护页面，是否需要独立标签库待确认。 |
| 4 |
订单管理 |
商家后台 → 左侧「订单管理」；也可在「经营概览」的「最新订单」中点击「全部订单」跳转。进入前提：已登录商家账号，店主与管理员均可进入。 |
可查看订单号、客户姓名与手机号、商品明细及数量、取货方式（到店自提 / 同城配送）、客户备注与配送地址、订单金额、下单时间与当前状态，并可按状态筛选（全部 / 待接单 / 制作中 / 已完成 / 已取消）。可编辑项：订单状态（下拉选择待接单、制作中、已完成、已取消），选定即保存并即时生效。只读项：订单号、客户信息、商品明细、金额、下单时间。是否开放改价与订单内容修改待确认。 |
| 5 |
关于页面 / 文章管理（Markdown） |
商家后台 → 左侧「文章 / 页面内容」→「+ 新建文章」或列表行「编辑」；也可在「经营概览 → 快捷操作」中点击「📝 编写文章 / 公告」。顾客端对应底部「关于」标签页。进入前提：已登录商家账号。 |
可查看全部文章的标题、标识 slug、排序与更新时间。可编辑项：标题（必填）、标识 slug（新建时必填，保存后在编辑态只读）、排序值、Markdown 正文，并可通过工具栏插入加粗、斜体、标题、列表、引用、分割线、图片与附件，右侧实时预览渲染结果。只读项：更新时间。保存后即时生效，「关于」页面按排序渲染为标签页；可二次确认后删除文章。 |
| 6 |
管理员与权限 |
商家后台 → 左侧「管理员」。进入前提：已登录商家账号；「+ 添加管理员」按钮与删除操作仅店主（666666）可见可用，普通管理员仅可查看列表并对本人账号改密码。 |
店主可查看全部账号的登录账号、昵称、角色与创建时间。可编辑项：新增管理员时填写登录账号（≥3 字符）、昵称、登录密码（≥6 位）与确认密码、角色（管理员 / 店主），均为必填项；可重置任一账号密码（新密码 ≥6 位且两次一致）、删除非店主账号。只读项：角色、创建时间。普通管理员仅可修改本人密码，店主账号行不可删除；修改后即时生效，被删账号将无法登录后台。是否支持停用（不删除）账号待确认。 |
| 7 |
店铺基础设置 |
商家后台 → 左侧「店铺设置」→「基础信息」面板保存；顾客端「设置」抽屉「门店信息」区域仅作展示。进入前提：已登录商家账号。 |
可查看并修改店铺名称、联系电话、标语、店内公告、门店地址、营业时间、配送费与免配送门槛，均为可编辑项，无强制必填项；顾客端同一内容为只读展示。点击「保存店铺信息」后生效并同步云端。普通管理员是否具备该修改权限待确认。 |
| 8 |
云端数据库与存储配置 |
商家后台 → 左侧「店铺设置」→「云端数据库与存储」面板；当前连接状态同时在「经营概览」与顾客端「设置 → 数据与服务」中展示。进入前提：已登录商家账号，且已先在 Supabase 执行 schema.sql 建表并创建公开 Storage 桶。 |
可查看当前数据存储模式（已连接 Supabase / 本地模式）与桶名。可编辑项：Supabase Project URL（必填）、anon public key（必填）、service_role key（选填，以密码框录入并保存在本浏览器 localStorage）、Storage 桶名（默认 ximai-assets）。只读项：连接状态标识。可点击「测试连接」校验配置，点击「保存并启用云端」并通过连通性校验后切换生效，也可「切回本地模式」或将「本地数据上传云端」；未点保存前配置不生效。 |