🛍️ 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/            # 消费者端
    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

📣 配送模块 — 推送与设备（整合说明）

项目中 pages/mall/delivery/doc/需求文档 目录包含多份关于配送、轨迹与推送的需求与建表示例。为了便于 DBA/后端/前端对齐，已将核心要点整合为草稿：

• 推送建表迁移脚本：mall_sql/migrations/20260224_add_push_devices_and_notifications.sql
• 推送完整附录（含平台侧建表示例）：pages/mall/delivery/doc/需求文档/推送与设备需求文档_含建表附录.md

建议下一步：在测试库执行迁移并验证 notify_queue / 后台消费者流程。若需要，我可以生成迁移运行命令或提供后台消费者示例代码。