# 茶韵智能茶仓

**Repository Path**: he-needs/chayun-smart-tea-warehouse

## Basic Information

- **Project Name**: 茶韵智能茶仓
- **Description**: 茶叶管理与环境监控微信小程序，通过蓝牙低功耗(BLE)连接智能茶罐，实时监控温湿度数据，并使用NFC技术进行茶叶识别与管理。支持环境监测、智能提醒、离线模式等功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-28
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🍵 茶韵智能茶仓

> 茶叶管理与环境监控微信小程序

[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-微信小程序-07C160.svg)](https://mp.weixin.qq.com/)
[![Version](https://img.shields.io/badge/Version-1.0.0-blue.svg)](https://gitee.com/he-needs/chayun-smart-tea-warehouse)

## 📖 项目简介

**茶韵智能茶仓**是一款专为茶叶爱好者设计的微信小程序，通过蓝牙低功耗(BLE)技术连接智能茶罐设备，实时监控茶叶存储环境的温湿度数据，并支持NFC技术进行茶叶快速识别与信息管理。

![系统架构图](茶韵智能茶仓微信小程序核心模块分布图.png)

---

## ✨ 功能特点

| 功能模块 | 描述 |
|---------|------|
| 🌡️ **环境监测** | 实时监控温湿度数据，提供历史数据图表分析 |
| 🍃 **茶叶管理** | 添加、查看茶叶信息，包括图片、名称、品类、产地等 |
| 📱 **NFC识别** | 通过NFC标签快速识别茶叶信息，一触即达 |
| 🔔 **智能提醒** | 温湿度异常提醒，茶叶保质期预警通知 |
| 📴 **离线模式** | 支持离线查看最后记录的传感器数据 |

---

## 🛠️ 技术架构

### 前端技术栈
- **框架**: 微信小程序原生框架
- **样式**: WXSS + CSS3 动画
- **数据可视化**: WXS 图表渲染
- **状态管理**: 页面级数据绑定

### 硬件通信
- **蓝牙**: BLE 4.0+ 低功耗连接
- **NFC**: 支持 NDEF 格式标签读写

### 传感器协议
| 特征 | UUID |
|-----|------|
| 传感器服务 | `0000181A-0000-1000-8000-00805F9B34FB` |
| 温度特征值 | `00002A6E-0000-1000-8000-00805F9B34FB` |
| 湿度特征值 | `00002A6F-0000-1000-8000-00805F9B34FB` |

---

## 📱 系统要求

### 微信小程序
- 基础库版本: **2.15.0** 或以上
- 权限要求:
  - ✅ 蓝牙权限
  - ✅ NFC权限
  - ✅ 相机权限 (用于拍摄茶叶图片)
  - ✅ 相册权限 (用于选择茶叶图片)

### 硬件兼容性

| 设备类型 | 最低要求 |
|---------|---------|
| **iOS** | 9.0+ 蓝牙4.0+ NFC (iPhone 7+) |
| **Android** | 5.0+ 蓝牙4.0+ NFC支持 |
| **传感器** | 蓝牙4.0+兼容传感器 |

---

## 📂 项目结构

```
茶韵智能茶仓/
├── 📄 app.js                  # 应用程序入口
├── 📄 app.json                # 应用程序配置
├── 📄 app.wxss                # 全局样式
├── 📁 assets/                 # 静态资源
├── 📁 components/             # 自定义组件
│   └── sensor-gauge/          # 传感器仪表盘组件
├── 📁 pages/                  # 页面目录
│   ├── index/                 # 主页面
│   ├── tea-detail/            # 茶叶详情页
│   ├── add-tea/               # 添加茶叶页面
│   └── tea-timer/             # 泡茶计时器
├── 📁 utils/                  # 工具函数
│   ├── ble-connector.js       # 蓝牙连接工具
│   ├── nfc-reader.js          # NFC读取工具
│   ├── tea-time.js            # 茶叶时间计算
│   ├── throttle.js            # 节流函数工具
│   └── chart.wxs              # 图表渲染工具(WXS)
└── 📁 ci/                     # CI/CD配置
```

---

## 🚀 快速开始

### 1. 克隆项目
```bash
git clone https://gitee.com/he-needs/chayun-smart-tea-warehouse.git
cd chayun-smart-tea-warehouse
```

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

### 3. 导入项目
使用 **微信开发者工具** 导入项目目录，填写自己的 AppID 或使用测试号。

### 4. 构建 npm
在微信开发者工具中点击 **工具 → 构建 npm**

---

## 🔧 CI/CD 使用说明

本项目配置了自动化CI/CD流程：

| 功能 | 描述 |
|-----|------|
| 🔨 自动构建 | 每次提交代码自动构建 |
| 📱 体验版二维码 | PR和合并后自动生成预览版本 |
| 🖼️ 图片优化 | 自动压缩图片资源，减少包大小 |

### 本地CI工具使用

```bash
# 进入CI目录
cd ci

# 安装CI依赖
npm install -g miniprogram-ci
npm install imagemin imagemin-mozjpeg imagemin-pngquant

# 生成预览版
node miniprogram-ci.js preview --desc="本地预览版"

# 上传版本
node miniprogram-ci.js upload --version=1.0.0 --desc="正式版发布"

# 优化图片资源
node miniprogram-ci.js optimize-images
```

---

## ⚡ 性能优化

- 🔄 传感器数据节流处理 (500ms更新一次)
- 📊 使用WXS优化图表渲染性能
- 📴 支持离线模式，显示最后记录数据
- 🗜️ 图片资源自动压缩优化

---

## 🤝 参与贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

---

## 📄 开源许可

本项目采用 [MIT 许可证](LICENSE) 开源。

---

## 👨‍💻 作者

- **贺需** - *项目开发者*

---

## 📞 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 📧 Email: [请填写您的邮箱]
- 🔗 Gitee: [he-needs](https://gitee.com/he-needs)

---

<p align="center">
  <sub>Made with ❤️ by 贺需</sub>
</p>