🛍️ 商城系统模块 (Mall System Module)

本目录包含完整的商城系统模块，已从主项目中独立出来，可作为独立仓库使用。

📁 目录结构

mall/
├── doc_mall/              # 文档和数据库脚本
│   ├── database/          # 数据库脚本目录
│   ├── analysis/          # 分析文档目录
│   ├── reports/           # 生成报告目录
│   └── *.md              # 各类文档和迁移指南
├── pages/                 # 前端页面代码
│   └── mall/             # 商城页面
│       ├── admin/        # 管理端页面
│       ├── analytics/    # 数据分析端页面
│       ├── consumer/     # 消费者端页面
│       ├── delivery/     # 配送端页面
│       ├── merchant/     # 商家端页面
│       ├── service/      # 客服端页面
│       └── nfc/          # NFC支付页面
└── types/                # 类型定义
    └── mall-types.uts    # 商城系统类型定义

📊 迁移统计

• 文档和数据库脚本: 48+ 个文件 (doc_mall/)
• 前端页面代码: 45+ 个文件 (pages/mall/)
• 类型定义: 1 个文件 (types/mall-types.uts)

🚀 快速开始

1. 查看迁移指南

• 完整迁移指南: doc_mall/MIGRATION_GUIDE.md
• 迁移检查清单: doc_mall/MIGRATION_CHECKLIST.md
• 快速开始: doc_mall/QUICK_START_MIGRATION.md

2. 配置数据库

执行数据库脚本创建表结构：

# 方式1: 通过 Supabase Dashboard SQL Editor
# 打开 doc_mall/database/complete_mall_database.sql 并执行

# 方式2: 通过 psql 命令行
psql -h localhost -U postgres -d your_database -f doc_mall/database/complete_mall_database.sql

3. 配置 Supabase 连接

创建配置文件，设置 Supabase 项目 URL 和 API Key。

4. 更新导入路径

检查并更新代码中的导入路径，确保指向正确的位置。

📚 核心文档

技术文档

• 技术实现拆解 - 详细的技术实现说明
• 模块深度分析 - 模块架构和设计理念
• 前后端联调指南 - 开发调试指南

数据库文档

• 完整部署指南 - 数据库部署步骤
• 快速部署指南 - 快速部署方法
• 数据库创建报告 - 数据库结构说明

🔧 迁移到新仓库

如果你需要将本模块迁移到一个完全独立的 Git 仓库，可以使用提供的迁移脚本：

Windows (PowerShell)

cd doc_mall
.\migrate.ps1 -TargetPath "D:\path\to\new-repo"

Linux/Mac (Bash)

cd doc_mall
chmod +x migrate.sh
./migrate.sh /path/to/new-repo

详细步骤请参考 MIGRATION_GUIDE.md。

📝 注意事项

1. 用户表依赖: 商城系统依赖 ak_users 用户表，迁移时需要确定处理方案（独立表/复用表/API服务）
2. Supabase 配置: 需要配置 Supabase 项目连接信息
3. 路径更新: 迁移后需要更新代码中的导入路径
4. 数据库脚本: 需要按顺序执行数据库脚本

📞 支持

• 查看文档: 参考 doc_mall/ 目录下的相关文档
• 迁移问题: 参考 MIGRATION_GUIDE.md 中的常见问题部分

---

迁移日期: 2025年1月
版本: v1.0
状态: ✅ 已独立迁移到 mall/ 目录