consumer模块完成90%，前端完成supabase对接

mall/README.md

@@ -0,0 +1,56 @@
+# 🛍️ Mall (uni-app / uvue)
+
+本仓库为 uni-app（uvue/uts）商城项目，包含消费者端、配送端、数据分析、管理后台、商家端、客服端等模块。
+
+## 📦 路由与分包
+
+本项目使用 **根目录 `pages.json`** 作为路由入口配置，并对 `pages/mall/*` 模块进行了分包（subPackages）拆分。
+
+- `tabBar`：消费者端（consumer）5 个主入口页
+- `subPackages`：consumer 非 tab 页、delivery、analytics、admin、merchant、service 等模块按业务分包
+
+页面路径清单见：`PAGES_ROUTES.md`
+
+## 📁 目录结构（核心）
+
+```
+pages/
+  user/                  # 登录/注册/用户中心等公共页面
+  mall/
+    consumer/            # 消费者端
+    delivery/            # 配送端
+    analytics/           # 数据分析
+    admin/               # 管理后台
+    merchant/            # 商家端
+    service/             # 客服端
+    nfc/                 # NFC相关
+components/
+utils/
+services/
+types/
+uni_modules/
+docs/                    # 项目规范与数据库策略（含 docs/sql）
+mall_sql/                # 数据库迁移/部署脚本与结构化SQL仓库
+ak/
+```
+
+## 📚 文档与数据库目录
+
+- **`docs/`**
+  - 项目规范与研发约定集合。
+  - **`docs/sql/`**：数据库“权威口径”文档与结构化 SQL 归档（策略、RLS、RPC、授权等）。
+  - Agent 执行规范见：`docs/AGENT_PROJECT_SPEC.md`
+
+- **`mall_sql/`**
+  - 可执行的数据库脚本与迁移仓库（migrations/schemas/scripts 等）。
+  - 用于数据库部署/迁移/结构化管理（与 `docs/sql` 的“权威口径/评审归档”配合使用）。
+
+## 🚀 开发说明
+
+- 使用 HBuilderX 或 uni-app CLI 运行与编译
+- `pages.json` 中分包页面请用 `uni.navigateTo` 进入；`uni.switchTab` 仅用于 `tabBar` 页面
+
+## ⚠️ 注意事项
+
+- 请避免提交本地环境相关配置（如 `ak/config.uts`）到仓库（已通过 `.gitignore` 处理）
+- 分包页面路径变更请同步更新 `pages.json`