# wxshop

**Repository Path**: hhna/wxshop

## Basic Information

- **Project Name**: wxshop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📱 小程序商城

一个功能完整、设计精美的微信小程序商城系统，采用 `uni-app` + `Vue.js` 开发。

## ✨ 项目特色

### 🎯 完整的功能闭环
- 用户认证（手机号 + 微信登录）
- 产品浏览与购物
- 订单管理与支付
- 代理系统与佣金管理
- 用户中心与个人设置

### 🎨 优雅的设计系统
- 统一的色彩体系（主色#27c1a3）
- 完整的排版规范
- 480+ 行 SCSS 全局样式
- 使用 first-ui 组件库

### 🚀 高质量的代码
- 8,400+ 行高质量代码
- 16 个功能页面
- 59 个 API 接口
- 完整的表单验证
- 优秀的错误处理

## 📊 项目统计

| 指标 | 数值 |
|------|------|
| **总页面数** | 16 |
| **总代码行数** | 8,400+ |
| **API 接口数** | 59 |
| **功能模块数** | 10+ |
| **UI 样式行数** | 480+ |

## 🏗️ 项目结构

```
uniapp/
├── pages/              # 16 个功能页面
│   ├── auth/          # 认证（登录/注册）
│   ├── home/          # 首页
│   ├── product/       # 产品（列表/详情）
│   ├── order/         # 订单（创建/支付/列表）
│   ├── user/          # 用户中心（含6个子页面）
│   └── agent/         # 代理中心（含4个子页面）
├── common/
│   ├── api/           # API 接口定义（59 个）
│   ├── config/        # 环境配置
│   └── style/         # 全局样式
├── components/        # first-ui 组件库
├── store/             # Vuex 状态管理
├── utils/             # 工具函数
└── static/            # 静态资源
```

## 🎯 核心功能

### 第一阶段（✅ 已完成）
- [x] 认证系统 - 手机号登录、微信登录、注册
- [x] 首页 - 分类导航、产品推荐、下拉刷新
- [x] 产品展示 - 分类浏览、列表显示、详情查看
- [x] 订单管理 - 下单、支付、订单列表
- [x] 用户中心 - 基础信息、订单查询
- [x] 代理中心 - 基础数据展示

### 第二阶段（✅ 已完成）
- [x] 个人信息编辑 - 头像上传、信息修改
- [x] 支付方式管理 - 支付宝、微信、银行卡
- [x] 提现申请 - 提现流程、手续费计算
- [x] 邀请下级 - 邀请码、二维码、分享
- [x] 佣金记录 - 收益统计、筛选查询
- [x] 团队管理 - 成员管理、搜索排序

## 🛠️ 技术栈

- **框架**: uni-app + Vue.js 2.x
- **样式**: SCSS + 全局样式系统
- **HTTP**: luch-request
- **状态管理**: Vuex
- **UI 组件**: first-ui（80+ 组件）
- **存储**: uni.setStorageSync

## 🚀 快速开始

### 前置要求
- HBuilderX 最新版本
- Node.js >= 14.x
- WeChat DevTools 最新版
- 微信小程序 AppID

### 安装步骤

```bash
# 1. 用 HBuilderX 打开项目
File → Open → /Users/wyh/Desktop/小程序商城/uniapp

# 2. 安装依赖
npm install

# 3. 修改 API 地址
# 编辑 uniapp/common/config/dev/index.js
# 改为您的测试服务器地址

# 4. 配置小程序 AppID
# 编辑 uniapp/manifest.json
# 改为您的小程序 AppID

# 5. 运行
# HBuilderX 顶部菜单 → Tools → Run → Run to WeChat DevTools
# 或快捷键：Mac(Cmd+R) Win(Ctrl+R)
```

## 📖 文档导航

- **[快速启动指南](./快速启动指南.md)** - 详细的启动步骤和调试技巧
- **[项目进展报告](./项目进展报告.md)** - 完整的项目总结和数据统计
- **[开发进度](./开发进度.md)** - 详细的开发进度记录
- **[第二阶段完成总结](./第二阶段完成总结.md)** - 第二阶段功能详解
- **[项目需求分析](./项目需求分析.md)** - 需求文档
- **[接口文档](./接口文档.md)** - API 接口完整文档

## 🎨 设计系统

### 色彩体系
- **主色**: #27c1a3（青绿）
- **背景**: #f5f5f5（浅灰）
- **边框**: #e0e0e0（深灰）
- **文本**: #000000（黑色）
- **辅助**: #999999（中灰）

### 排版规范
- **标题**: 26-36rpx, Bold
- **正文**: 20-24rpx, Regular
- **标签**: 14-18rpx, Regular

## 🔐 API 接口

共 59 个接口，包括：
- 认证接口（4个）
- 用户接口（3个）
- 产品接口（5个）
- 订单接口（8个）
- 支付接口（3个）
- 提现接口（5个）
- 代理接口（12个）
- 支付方式接口（6个）
- 购物车接口（4个）
- 消息接口（2个）
- 礼品接口（5个）

详见 [接口文档](./接口文档.md)

## 📋 功能测试清单

- [ ] 认证系统
- [ ] 首页与分类
- [ ] 产品浏览与详情
- [ ] 购物流程
- [ ] 支付功能
- [ ] 订单管理
- [ ] 个人信息
- [ ] 支付方式
- [ ] 提现申请
- [ ] 邀请管理
- [ ] 佣金查询
- [ ] 团队管理

## 🐛 常见问题

### Q: API 请求失败？
A: 检查 `common/config/dev/index.js` 中的 baseUrl 配置

### Q: 微信登录不工作？
A: 检查小程序 AppID 配置和微信平台设置

### Q: 页面样式错乱？
A: 清除浏览器缓存，重新编译项目

### Q: 图片不显示？
A: 检查图片 URL 是否正确，或配置域名白名单

更多问题见 [快速启动指南](./快速启动指南.md)

## 📈 项目进度

- ✅ 第一阶段（10 个页面）- 已完成
- ✅ 第二阶段（6 个页面）- 已完成
- ⏳ 第三阶段（消息、礼品等）- 计划中

## 🎓 学习资源

- [uni-app 官方文档](https://uniapp.dcloud.net.cn/)
- [Vue.js 官方文档](https://v2.vuejs.org/)
- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/framework/)
- [first-ui 组件库](https://www.firstui.cn/)

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

## 📞 联系方式

- 📧 Email: support@example.com
- 💬 WeChat: official_account
- 🌐 Website: https://example.com

---

**🚀 现在就开始使用吧！**

查看 [快速启动指南](./快速启动指南.md) 了解详细的安装和运行步骤。

**最后更新**: 2024-12-20  
**版本**: 2.0 (第二阶段完成)  
**状态**: ✅ 可用于测试