109 lines
3.7 KiB
Markdown
109 lines
3.7 KiB
Markdown
# 🛍️ 商城系统模块 (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_GUIDE.md)
|
||
- **迁移检查清单**: [doc_mall/MIGRATION_CHECKLIST.md](./doc_mall/MIGRATION_CHECKLIST.md)
|
||
- **快速开始**: [doc_mall/QUICK_START_MIGRATION.md](./doc_mall/QUICK_START_MIGRATION.md)
|
||
|
||
### 2. 配置数据库
|
||
|
||
执行数据库脚本创建表结构：
|
||
|
||
```bash
|
||
# 方式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. 更新导入路径
|
||
|
||
检查并更新代码中的导入路径，确保指向正确的位置。
|
||
|
||
## 📚 核心文档
|
||
|
||
### 技术文档
|
||
- [技术实现拆解](./doc_mall/TECHNICAL_IMPLEMENTATION.md) - 详细的技术实现说明
|
||
- [模块深度分析](./doc_mall/MODULE_ANALYSIS.md) - 模块架构和设计理念
|
||
- [前后端联调指南](./doc_mall/FRONTEND_BACKEND_DEBUGGING.md) - 开发调试指南
|
||
|
||
### 数据库文档
|
||
- [完整部署指南](./doc_mall/database/complete_deployment_guide.md) - 数据库部署步骤
|
||
- [快速部署指南](./doc_mall/database/deployment_guide.md) - 快速部署方法
|
||
- [数据库创建报告](./doc_mall/database/database_creation_report.md) - 数据库结构说明
|
||
|
||
## 🔧 迁移到新仓库
|
||
|
||
如果你需要将本模块迁移到一个完全独立的 Git 仓库，可以使用提供的迁移脚本：
|
||
|
||
### Windows (PowerShell)
|
||
```powershell
|
||
cd doc_mall
|
||
.\migrate.ps1 -TargetPath "D:\path\to\new-repo"
|
||
```
|
||
|
||
### Linux/Mac (Bash)
|
||
```bash
|
||
cd doc_mall
|
||
chmod +x migrate.sh
|
||
./migrate.sh /path/to/new-repo
|
||
```
|
||
|
||
详细步骤请参考 [MIGRATION_GUIDE.md](./doc_mall/MIGRATION_GUIDE.md)。
|
||
|
||
## 📝 注意事项
|
||
|
||
1. **用户表依赖**: 商城系统依赖 `ak_users` 用户表，迁移时需要确定处理方案（独立表/复用表/API服务）
|
||
2. **Supabase 配置**: 需要配置 Supabase 项目连接信息
|
||
3. **路径更新**: 迁移后需要更新代码中的导入路径
|
||
4. **数据库脚本**: 需要按顺序执行数据库脚本
|
||
|
||
## 📞 支持
|
||
|
||
- 查看文档: 参考 `doc_mall/` 目录下的相关文档
|
||
- 迁移问题: 参考 [MIGRATION_GUIDE.md](./doc_mall/MIGRATION_GUIDE.md) 中的常见问题部分
|
||
|
||
---
|
||
|
||
**迁移日期**: 2025年1月
|
||
**版本**: v1.0
|
||
**状态**: ✅ 已独立迁移到 mall/ 目录
|