# brew-guide-bean-data

**Repository Path**: chu3/brew-guide-bean-data

## Basic Information

- **Project Name**: brew-guide-bean-data
- **Description**: Brew Guide 公开咖啡豆数据库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-27
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ☕️ Brew Guide 咖啡豆数据库

## 📋 项目说明

这是一个开源的咖啡豆信息数据库，为 [Brew Guide](https://github.com/chu3/brew-guide) 应用提供咖啡豆基础数据。本项目旨在帮助咖啡爱好者更便捷地管理和了解各种咖啡豆信息。

**注意**：本项目为个人维护的数据库，数据来源于网络公开资源整理，目前未开放用户直接贡献功能。如发现数据错误，可通过 Issue 或邮件反馈。

## ⚖️ 重要声明

- **数据来源**：本数据库中的信息均收集自网络公开资源
- **使用目的**：仅供学习、研究和个人使用，无任何商业用途
- **开源性质**：本项目完全开源且非营利
- **免责说明**：所有数据仅供参考，实际信息请以商家官方为准
- **版权尊重**：如有任何版权或其他权益问题，请联系 [chuthree@163.com](mailto:chuthree@163.com) 处理

## 🚀 使用方式

### 在 Brew Guide 应用中使用

1. 打开 Brew Guide 应用
2. 进入"快速添加"功能
3. 点击"搜索咖啡豆"
4. 搜索并选择咖啡豆
5. 一键导入到个人库存

### 数据获取

```
https://gitee.com/chu3/brew-guide-bean-data/raw/master/coffee-beans-database.json
```

## 📊 数据结构

### 咖啡豆信息格式

```json
{
  "品牌名称": [
    {
      "name": "咖啡豆名称",
      "roastLevel": "烘焙程度",
      "beanType": "espresso|filter",
      "capacity": "规格重量",
      "price": "价格",
      "flavor": ["风味标签"],
      "notes": "详细描述",
      "blendComponents": [
        {
          "origin": "产区",
          "process": "处理法", 
          "variety": "品种",
          "percentage": 比例
        }
      ],
      "startDay": 建议养豆开始天数,
      "endDay": 建议养豆结束天数
    }
  ]
}
```

## 🔍 搜索功能

支持以下维度搜索：
- 咖啡豆名称
- 品牌名称
- 产区信息
- 风味标签
- 处理法
- 咖啡品种

## � 项目说明

本项目为个人维护的咖啡豆数据库，数据来源于网络公开资源整理。目前未开放用户直接贡献功能。如果您发现数据错误或有重要信息需要更正，可以通过以下方式反馈：
- 提交 Issue 报告问题
- 发送邮件到 [chuthree@163.com](mailto:chuthree@163.com)

我们会根据反馈定期维护和更新数据库内容。

## 📝 更新日志

### 最新更新
- 持续更新咖啡豆信息
- 优化数据结构和搜索功能
- 完善文档说明

## 📞 联系方式

- **GitHub Issues**: [提交问题](https://gitee.com/chu3/brew-guide-bean-data/issues)
- **邮箱**: [chuthree@163.com](mailto:chuthree@163.com)
- **主项目**: [Brew Guide](https://github.com/chu3/brew-guide)

## 📄 开源协议

本项目采用 MIT 协议，详见 [LICENSE](./LICENSE) 文件。

## 🙏 特别感谢

感谢所有为咖啡数据整理做出贡献的朋友们，让我们一起为咖啡社区贡献力量！

---

**☕️ 让每一杯咖啡都有迹可循**