核心工作流与功能架构

BrewTinker 是一款**本地优先（Local-first）**的 iOS 咖啡冲煮记录与分析工具。 它不试图成为庞杂的咖啡百科全书，也不做社交打卡平台。它的唯一目标是：帮助你把每次冲泡变成可复盘的数据，让下一次调整有据可依。

---

核心理念：下一杯闭环（The Next Cup Loop）

咖啡冲煮中最常见的问题是：“上周冲出了一杯极佳的咖啡，这周想复现，却记不清研磨度、水温、注水时间和豆子状态；或者明知上一杯偏苦，这一杯却忘了该改什么。”

BrewTinker 围绕闭环改进设计了 4 步工作流：

1. 结构化参数采集：记录豆名、产地、处理法、烘焙日期、研磨刻度、水温、粉水比、注水时间、TDS 与感官评分。
2. 受控变量标记：为单次冲煮标记测试变量（例如“研磨度 +1 格”或“水温 90°C 对照”），与基线记录挂钩。
3. 记录下一杯备忘（Next Adjustment）：冲完品鉴时随手记下“下次降低水温 2°C”，下次选择该豆时自动置顶提醒。
4. 一键 Brew Again 复盘：从历史记录一键带入参数启动新冲煮，并在保存页自动高亮比对“本次改动了什么”。

---

三大 Tab 分工

产品界面严格收敛为底部三个核心 Tab，Settings 隐入 Home 右上角，避免在冲咖啡时打扰操作。

┌──────────────────────────────────────────────────────────┐
│ [ Home ]               [ Brew ]                 [ Log ]  │
│ 趋势与今日状态          同屏专注冲煮             检索与数据导出 │
└──────────────────────────────────────────────────────────┘

1. Home · 看清近况与趋势

• 7 日评分走势：直观柱状图展示近一周冲泡质量与平均分，快速找到高分记录。
• 今日状态：展示今日冲泡杯数、累计耗豆克数与活跃实验提示。
• 咖啡豆新鲜度：追踪咖啡豆的烘焙天数与剩余库存，保存冲煮时支持自动扣减。
• 右上角极简设置：低频入口，承载磨豆机与滤杯配置档、BLE 蓝牙设备配对、Pro 购买状态与隐私协议。

2. Brew · 同屏专注冲煮

• 极简单屏工作台：粉量、水量、水温、粉水比与计时器集中同屏，无需中途翻页。
• 引导式冲泡模板：内置 V60、Hario Switch、AeroPress、法压壶与浓缩咖啡（Espresso）等预设。
• 自适应分段注水：根据输入的粉水比，自动重算闷蒸（Bloom）、一段注水与二段注水的目标克数。
• 触觉振动反馈：阶段切换时提供清脆的 Taptic Engine 触觉提示。
• BLE 蓝牙设备（可选）：连接兼容蓝牙秤后自动读取实时重量；流速曲线由带时间戳的重量序列在设备本地推算。

3. Log · 结构化检索与深度复盘

• 多维组合筛选：按咖啡豆、器具、冲煮方法、评分或实验标签秒级筛选。
• 完整指标保留：完整保留研磨刻度、萃取时间、TDS 浓度、萃取率（EY）、风味标签与详细感官笔记。
• Brew Again 参数继承：一键以历史冲煮为基准开展新冲泡，自动计算参数差值。
• 开放格式范围导出：支持导出全部记录、当前筛选结果或指定日期范围。

---

数据字段字典（Data Dictionary）

导出的 CSV 包含以下标准结构化字段，一行一杯、一列一变量：

字段名称 (CSV Header)	数据类型	描述说明	示例值
timestamp	ISO-8601	冲煮完成时间戳	2026-08-22T08:30:00Z
bean_name	String	咖啡豆名称	耶加雪菲 日晒 G1
origin	String	产地 / 庄园	埃塞俄比亚
roast_level	String	烘焙度	浅度烘焙 (Light)
method	String	冲煮器具 / 方法	Hario V60
grinder	String	磨豆机型号与档位	Comandante C40 #18.5
dose_g	Decimal	咖啡粉重量 (g)	15.0
water_g	Decimal	总注入水量 (g)	250.0
ratio	String / Decimal	粉水比	1:16.7
temp_c	Integer	水温 (°C)	90
time_sec	Integer	萃取总时间 (秒)	134
rating	Decimal	总体评分 (0.0 ~ 5.0)	4.8
tds_pct	Decimal	折射仪浓度 TDS (%)	1.38
ey_pct	Decimal	萃取率 Extraction Yield (%)	19.2
experiment_var	String	受控实验变量标记	研磨度 +1.5 格
next_adjustment	String	下一杯调整备忘	水温保持 90°C，降低后段杂味

---

导出与数据自主

BrewTinker 坚守数据自主原则，支持以下三种开放格式：

1. CSV 文件：纯文本表格，可直接用 Microsoft Excel、Apple Numbers 打开，或导入 R、Python (pandas) 进行多元线性回归与萃取率建模。
2. JSON 文件：包含层级结构与完整时间戳序列的无损全量备份，支持随时重新导入到本 App 中恢复数据。
3. TXT 纯文本：适合快速复制到微信、小红书、备忘录或与朋友交流冲煮心得。

(注：为保证数据可靠性与防丢失，本 App 已正式移除排版脆弱的 PDF 导出。)