# 奈雪的茶小程序

**Repository Path**: hu-yuanbiao/nayukis-tea

## Basic Information

- **Project Name**: 奈雪的茶小程序
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-22
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🧋 Nayuki's Tea 奶茶点单小程序

![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![WeChat Mini Program](https://img.shields.io/badge/WeChat-Mini%20Program-brightgreen.svg)
![TDesign](https://img.shields.io/badge/TDesign-Component%20Library-blueviolet.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)

> 基于微信小程序的现代化奶茶点单系统，提供流畅的用户体验和丰富的功能特性。

## 📱 项目介绍

Nayuki's Tea 是一个功能完善的奶茶点单微信小程序，采用现代化的开发架构，集成了微信支付、会员系统、优惠券、积分商城等核心功能。项目采用组件化开发模式，代码结构清晰，易于维护和扩展。

## 🚀 技术栈

- **框架**: 微信小程序原生开发
- **组件库**: [TDesign MiniProgram](https://tdesign.tencent.com/miniprogram/overview)
- **样式**: Tailwind CSS + WXSS
- **构建工具**: 微信小程序开发者工具
- **状态管理**: 小程序原生状态管理
- **HTTP客户端**: 小程序原生wx.request
- **工具库**: Day.js, Lodash, Tinycolor2

## ✨ 功能特性

### 🎯 核心功能
- ✅ 商品浏览与搜索
- ✅ 在线点单与支付
- ✅ 购物车和订单管理
- ✅ 会员注册与登录
- ✅ 优惠券领取与使用
- ✅ 积分兑换系统
- ✅ 地址管理
- ✅ 订单追踪

### 🎨 用户体验
- 🌗 深浅色主题适配
- 📱 响应式设计
- 🔄 下拉刷新与上拉加载
- 🎯 智能推荐系统
- 📍 基于位置的门店推荐

### 🔧 技术特色
- 🧩 组件化架构设计
- 🎨 统一的视觉设计规范
- ⚡ 优化的性能体验
- 🔒 完善的安全机制
- 📊 数据分析与统计

## 📁 项目结构

```
nayukis-tea/
├── components/                 # 公共组件
│   ├── Card/                  # 卡片组件
│   ├── product/               # 商品组件
│   ├── search/                # 搜索组件
│   └── ...
├── pages/                     # 页面文件
│   ├── index/                 # 首页
│   ├── cat/                   # 分类页
│   ├── trolley/               # 购物车
│   ├── order/                 # 订单页
│   ├── mine/                  # 个人中心
│   └── secondPages/           # 二级页面
├── utils/                     # 工具函数
│   ├── request.js            # 网络请求
│   ├── user.js               # 用户相关
│   └── config.js             # 配置文件
├── static/                    # 静态资源
├── style/                     # 样式文件
└── miniprogram_npm/          # npm依赖
```

## 🛠️ 快速开始

### 环境要求
- 微信开发者工具 ≥ 1.05.2108130
- Node.js ≥ 14.0.0
- 微信小程序基础库 ≥ 2.19.4

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd nayukis-tea
   ```

2. **安装依赖**
   ```bash
   npm install
   ```

3. **构建npm**
   在微信开发者工具中：
   - 点击 `工具` → `构建 npm`
   - 勾选 `使用 npm 模块`

4. **配置项目**
   - 修改 `utils/config.js` 中的API配置
   - 配置微信支付相关参数
   - 设置小程序AppID

5. **运行项目**
   - 打开微信开发者工具
   - 导入项目根目录
   - 点击 `编译` 按钮

## 📋 页面说明

| 页面 | 路径 | 功能描述 |
|------|------|----------|
| 首页 | pages/index/index | 商品展示、轮播图、推荐商品 |
| 分类 | pages/cat/cat | 商品分类浏览 |
| 购物车 | pages/trolley/trolley | 购物车管理、结算 |
| 订单 | pages/order/order | 订单列表、订单详情 |
| 我的 | pages/mine/mine | 个人中心、会员信息 |
| 商品详情 | secondPages/menu/menu | 商品详情、规格选择 |
| 地址管理 | secondPages/address/address | 收货地址管理 |
| 优惠券 | secondPages/quan/quan | 优惠券领取与使用 |
| 积分商城 | secondPages/shangcheng/shangcheng | 积分兑换商品 |

## 🔧 开发规范

### 代码规范
- 使用 ESLint 进行代码检查
- 遵循微信小程序开发规范
- 组件命名采用 PascalCase
- 页面命名采用 kebab-case

### 提交规范
遵循 [Conventional Commits](https://conventionalcommits.org/) 规范：
- `feat`: 新功能
- `fix`: 修复bug
- `docs`: 文档更新
- `style`: 代码格式
- `refactor`: 代码重构
- `test`: 测试相关
- `chore`: 构建/工具

### 分支管理
- `main`: 生产分支
- `develop`: 开发分支
- `feature/*`: 功能分支
- `hotfix/*`: 紧急修复分支

## 🚀 开发计划

### 已完成 ✅
- [x] 基础项目架构搭建
- [x] 商品展示与搜索功能
- [x] 购物车与订单系统
- [x] 用户登录与注册
- [x] 支付功能集成
- [x] 地址管理系统

### 开发中 🚧
- [ ] 会员等级系统
- [ ] 积分商城完善
- [ ] 营销活动功能
- [ ] 数据统计分析

### 待开发 📋
- [ ] 社交分享功能
- [ ] 用户评价系统
- [ ] 客服聊天功能
- [ ] 多门店支持

## 🤝 贡献指南

我们欢迎社区贡献！请按以下步骤进行：

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📞 支持与联系

- 📧 邮箱: support@nayukis-tea.com
- 💬 微信: NayukiTeaSupport
- 🐛 问题反馈: [GitHub Issues](https://github.com/your-org/nayukis-tea/issues)

## 📄 许可证

本项目基于 [MIT License](LICENSE) 开源协议。

---

<div align="center">
  <p>Made with ❤️ by Nayuki's Tea Team</p>
  <p><a href="https://github.com/your-org/nayukis-tea">⭐ Star us on GitHub</a></p>
</div>