CoffeeSense 啡常懂你

1. 项目愿景与商业深度剖析 (Challenge & Insights)

剖析传统咖啡产品的核心痛点，给出 AI4Coffee 的差异化破局策略

挑战 ①：C端咖啡日记记录繁琐、留存低

传统记录工具需要手动打字输入容量、豆种、奶类比例等，用户往往在3~7天后丧失记录动力。

AI 破局点

拍照/小票一键解析 (Vision)：拍咖啡杯拉花或外卖小票，大模型秒级识别品类、咖啡因量与热量，1秒完成极简打卡。

挑战 ②：咖啡馆老板对AI拼配缺乏信任

精品咖啡馆主理人极重风味口感，泛泛的大模型生成会被认为“假大空、不接地气”。

协会背书破局点

SCA标准风味轮 + 真实生豆批次现货：AI输出拼配方案精准到协会在库批次（如70%哥伦比亚水洗+30%日晒耶加），支持一键索样。

挑战 ③：B端与C端割裂，难以商业化

单做C端工具获客贵且变现弱；单做B端拓展重且周期长，两端缺乏联动。

飞轮闭环破局点

C端探店引流 + B端授牌认证：C端咖啡日记推荐昆明合作咖啡馆；B端因真实到店客流更愿意采购豆源与认证培训。

2. 商业飞轮与多边生态闭环设计

打通 “SCA 国际咖啡标准 ➔ 咖啡馆B端 ➔ 咖啡师Pro端 ➔ 消费者C端” 的完整价值链条

flowchart TD subgraph SCA["🏛️ SCA 国际咖啡标准核心资产"] SCA_Bean["非洲/南美直采一手生豆库"] SCA_Cert["专业咖啡师认证体系"] SCA_Exp["Q-Grader 评鉴师专家知识库"] end subgraph B_Side["🏢 B端：咖啡馆主理人/老板"] B_Shop["昆明本地及全国精品咖啡馆"] B_AI_Blend["AI 拼配定制 & 季节特调研发"] B_Supply["现货生豆/熟豆直供采购"] B_Badge["获得协会认证认证牌匾"] end subgraph Pro_Side["👨‍🍳 Pro端：职业/进阶咖啡师"] Pro_Course["协会标准技能培训营"] Pro_Cert["职业技能证书考核"] end subgraph C_Side["☕ C端：终端咖啡爱好者/消费者"] C_Diary["AI 咖啡日记 (拍照打卡/摄入统计)"] C_Health["智能健康建议 (咖啡因时钟/超标预警)"] C_Map["昆明特色咖啡地图 (场景推荐/聚会探店)"] end %% Relationships SCA_Bean -->|优质货源直供| B_Supply SCA_Exp -->|注入RAG风味模型| B_AI_Blend SCA_Cert -->|权威背书| Pro_Course B_Shop --> B_AI_Blend B_AI_Blend --> B_Supply B_Shop --> B_Badge Pro_Course --> Pro_Cert Pro_Cert -->|输出高素质人才| B_Shop C_Diary --> C_Health C_Health -.->|建议喝低因/特调| C_Map C_Map -->|引导探店打卡/到店消费| B_Badge B_Badge -->|提供独家配方/会员优惠| C_Side

1 To Business 咖啡馆赋能业务

向咖啡馆老板提供一手高性价比进口生豆，结合AI风味算法和专家知识，为咖啡馆定制独家“镇店拼配豆”与季度特调新品方案，赋能门店提升毛利与专业度。

2 To Professional 咖啡师培训体系

依托SCA 国际咖啡标准影响力，开展初/中/高级咖啡师、手冲萃取、感官杯测等线上理论+线下实操认证培训，为合作咖啡馆输送专业咖啡师，形成人才网络。

3 To Client 终端咖啡生活流量入口

以“咖啡日记 + 健康预警 + 昆明特色探店”为抓手，为大众提供好玩、有用的健康管理工具。同时把C端流量精准导入协会合作的线下认证咖啡馆。

3. 核心功能板块规划 (MiniProgram & Backend)

覆盖 C端小程序高频互动、B端工作台研发赋能与智能后台管理

C端日常高频

☕ 咖啡日记与 AI 健康管理

多模态拍照打卡：拍咖啡杯/拉花/小票秒级解析品类、容量与咖啡因。
动态咖啡因时钟：记录饮用时间，结合半衰期（约5小时）计算体内残留。
健康预警算法：单日超过400mg（孕妇200mg）或晚间饮用时触发红黄预警。
日月度健康洞察：生成个人专属咖啡因热量月报与风味偏好雷达图。

对应页面：pages/log/index, pages/log_create/index

C端探店导流

📍 昆明特色咖啡探店 (Coffee Finder)

场景化智能推荐：聚会闲聊、静心办公、拍照打卡、精品手冲等场景筛选。
昆明本地化精选：翠湖、文林街、公园1903等核心咖啡街区特色店推荐。
名片印章打卡：双列复古印章画册，到店打卡点亮专属印章与阶梯福利。
云南官方庄园名录：汇集全省农业厅官方认定精品咖啡庄园地图。

对应页面：pages/map/index, pages/map_detail/index

B端/Pro端商业

🧪 AI 拼配研发与培训中心

AI 智能拼配师：输入目标风味、客群定位、成本预算，输出生豆拼配比例。
特调灵感实验室：基于当季流行风味生成特调配方（风味糖浆、乳品搭配、萃取参数）。
生豆现货采购商城：非洲/南美原产地生豆批次查看、杯测报告与样品申请。
咖啡师认证培训：SCA 国际咖啡标准认证课程排期、在线报名、考核档案。

对应页面：pages/ai_chat/index (拼配实验室), pages/profile/index

4. AI Agent 算法与大模型核心引擎

基于阿里云 DashScope DeepSeek-V4-Flash + 规则引擎 + SCA专业咖啡知识库构建

AI 咖啡健康时钟计算模型 (Health Engine)

系统通过饮用时间、咖啡类型（浓缩、冷萃、拿铁等）、容量计算初始摄入量 C0。人体咖啡因代谢半衰期模型遵循一阶动力学衰减：

C(t) = C0 * (0.5)^(t / 5.0) // 平均半衰期约 5 小时

绿色健康区间：当日累计 < 250mg，且距离入睡时间 > 6小时。

黄色适度提醒：当日累计 250~400mg，建议补水，暂缓高浓度浓缩。

红色超标熔断：当日累计 > 400mg 或晚间 17:00 后摄入过量，AI 建议停止摄入。

AI 拼配与风味定制 RAG 知识图谱

将SCA 国际咖啡标准评鉴师标准（SCA风味轮、杯测84+生豆数据）进行知识库结构化，与用户需求进行语义匹配：

💡 拼配生成示例逻辑：

用户输入：“希望做一款适合做奶咖、带有坚果焦糖甜感、成本在60元/kg左右的门店招牌拼配”

✦ 60% 巴西喜拉多 (日晒) -> 提供坚果、黑巧克力醇厚基底
✦ 30% 哥伦比亚蕙兰 (水洗) -> 提升焦糖甜感与柔和果酸
✦ 10% 埃塞俄比亚西达摩 (日晒) -> 尾段赋予淡淡花果香气提亮

5. 系统技术架构与工程规范

前后端完全分离，支持一键启停脚本 (./start.sh / ./stop.sh)

前端架构

微信小程序原生

后端框架

Python FastAPI

大模型大脑

DeepSeek-V4-Flash

数据存储

SQLite / PostgreSQL

项目代码目录结构规划 (Repository Structure)

ai2coffee/
├── .env                           # 全局环境变量（AppID, 密钥, 大模型 APIKey, 端口）
├── start.sh                       # 【一键启动】初始化依赖、启动 FastAPI 后端与守护进程
├── stop.sh                        # 【一键停止】优雅停止后端后台进程与端口清理
├── docs/                          # 项目方案与接口文档
│   └── index.html                 # 完整的交互式方案与需求管理看板（当前页面）
│
├── backend/                       # Python FastAPI 异步后端
│   ├── app/
│   │   ├── main.py                # FastAPI 应用入口，注册中间件与路由
│   │   ├── core/config.py         # 环境变量与微信 AppID / AppSecret 配置
│   │   ├── api/                   # RESTful 接口层
│   │   │   ├── auth.py            # 微信官方 code2session 换取 openid 登录 & 管理员登录
│   │   │   ├── coffee_log.py      # 咖啡日记增删改查、日历统计、健康建议
│   │   │   ├── cafe_finder.py     # 昆明咖啡馆列表、咖啡名片印章与里程碑
│   │   │   ├── estate.py          # 云南省官方认定精品咖啡庄园名录与寻豆
│   │   │   ├── ai_agent.py        # AI 咖啡顾问 (SSE实时流式输出)
│   │   │   ├── dev_notes.py       # 网页在线开发需求与笔记数据持久化
│   │   │   └── business.py        # B端拼配生成器、生豆库、培训报名
│   │   ├── db/models.py           # User, CoffeeLog, Cafe, Estate, DevNote 表模型
│   │   └── services/              # 业务逻辑、健康算法与大模型客户端
│   └── requirements.txt           # Python 依赖清单
│
└── frontend/miniprogram/          # 微信小程序前端 (原生精美咖啡设计)

6. MVP 敏捷落地路线图 (Phased Implementation)

从最小可用版本 (MVP) 到完整商业闭环的演进路径

当前阶段

阶段一 (Phase 1)

MVP 原型与核心基建

✅ 搭建 FastAPI 后端与微信小程序标准工程目录
✅ 编写 start.sh & stop.sh 一键部署管理脚本
✅ 打通阿里云 DashScope DeepSeek-V4-Flash 大模型交互与健康规则引擎
✅ 实现“咖啡日记打卡”与“每日咖啡因健康预警”闭环
✅ 预置昆明核心特色咖啡馆数据与「咖啡名片」集章打卡
✅ 部署上线 https://coffee.xterai.tech 与权限访问控制

阶段二 (Phase 2)

多模态与B端拼配接入

🚀 接入多模态视觉模型，支持拍照秒识咖啡杯与小票
🚀 建立SCA 国际咖啡标准生豆产区知识库 (非洲/南美)
🚀 上线 B端 AI 智能拼配与季节特调研发工作台
🚀 昆明合作咖啡馆授牌打卡与到店核销功能

阶段三 (Phase 3)

生态飞轮与商业化拓展

🌟 咖啡师认证培训线上报名、考核与档案中心
🌟 进口生豆 B2B 现货在线采购与样品申领通道
🌟 从昆明拓展至成都、上海等核心精品咖啡消费城市
🌟 打造咖啡行业专属私有化垂直大模型 Agent

在线协同 · 实时持久化存储

7. 开发需求与研发备忘录 (Dev Notes & Requirements)

支持随时在线写笔记、记录需求想法、更新状态，数据自动双向保存至服务器数据库与本地缓存

新建开发需求 / 笔记

需求 / 笔记标题 *

需求分类

优先级

当前进度状态

提出人 / 协同组

详细笔记 / 需求说明 *

分类：

正在同步云端开发需求与笔记...

连接生豆源头与味蕾
打造 AI for Coffee 产业智能体生态

核心资源与优势矩阵

SCA 国际咖啡标准背书

非洲 & 南美一手生豆供应链

AI Agent 大模型双向赋能

1. 项目愿景与商业深度剖析 (Challenge & Insights)

挑战 ①：C端咖啡日记记录繁琐、留存低

挑战 ②：咖啡馆老板对AI拼配缺乏信任

挑战 ③：B端与C端割裂，难以商业化

2. 商业飞轮与多边生态闭环设计

1 To Business 咖啡馆赋能业务

2 To Professional 咖啡师培训体系

3 To Client 终端咖啡生活流量入口

3. 核心功能板块规划 (MiniProgram & Backend)

☕ 咖啡日记与 AI 健康管理

📍 昆明特色咖啡探店 (Coffee Finder)

🧪 AI 拼配研发与培训中心

4. AI Agent 算法与大模型核心引擎

AI 咖啡健康时钟计算模型 (Health Engine)

AI 拼配与风味定制 RAG 知识图谱

5. 系统技术架构与工程规范

项目代码目录结构规划 (Repository Structure)

6. MVP 敏捷落地路线图 (Phased Implementation)

MVP 原型与核心基建

多模态与B端拼配接入

生态飞轮与商业化拓展

7. 开发需求与研发备忘录 (Dev Notes & Requirements)

新建开发需求 / 笔记

连接生豆源头与味蕾 打造 AI for Coffee 产业智能体生态

核心资源与优势矩阵

SCA 国际咖啡标准背书

非洲 & 南美一手生豆供应链

AI Agent 大模型双向赋能

1. 项目愿景与商业深度剖析 (Challenge & Insights)

挑战 ①：C端咖啡日记记录繁琐、留存低

挑战 ②：咖啡馆老板对AI拼配缺乏信任

挑战 ③：B端与C端割裂，难以商业化

2. 商业飞轮与多边生态闭环设计

1 To Business 咖啡馆赋能业务

2 To Professional 咖啡师培训体系

3 To Client 终端咖啡生活流量入口

3. 核心功能板块规划 (MiniProgram & Backend)

☕ 咖啡日记与 AI 健康管理

📍 昆明特色咖啡探店 (Coffee Finder)

🧪 AI 拼配研发与培训中心

4. AI Agent 算法与大模型核心引擎

AI 咖啡健康时钟计算模型 (Health Engine)

AI 拼配与风味定制 RAG 知识图谱

5. 系统技术架构与工程规范

项目代码目录结构规划 (Repository Structure)

6. MVP 敏捷落地路线图 (Phased Implementation)

MVP 原型与核心基建

多模态与B端拼配接入

生态飞轮与商业化拓展

7. 开发需求与研发备忘录 (Dev Notes & Requirements)

新建开发需求 / 笔记

连接生豆源头与味蕾
打造 AI for Coffee 产业智能体生态