65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# 🛍️ 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` / 后台消费者流程。若需要，我可以生成迁移运行命令或提供后台消费者示例代码。
|