个人咖啡 & 面包知识库 + 消费记录 + 每日咖啡新闻

_{✨ Vibe coded with OpenClaw}

• ☕ 咖啡豆管理 — 产区、品种、烘焙商、处理法、评分、库存状态追踪
• 📝 冲煮记录 — 参数追踪（粉量/水量/水温/研磨度）+ 品鉴笔记
• 🍞 面包记录 — 购买记录 + 食谱管理（结构化配料表 + 步骤 + 补充知识）
• 💰 消费记录 — 豆子 + 咖啡店 + 器具 + 面包，月度统计图表
• 📚 知识库 — 产区百科（按国家分组）、品种图鉴、烘焙商目录、处理法参考、面包食谱
• 📰 咖啡日报 — 每日自动抓取 4 大咖啡网站新闻，AI 翻译成中文，首页展示

每天北京时间 08:30 自动从 4 个咖啡媒体抓取最新文章并翻译：

• 首页按日期分组显示：今日咖啡 + 昨日咖啡
• 点击标题进入详情页查看全文中文翻译 + 原文链接
• 自动清理 2 天前的历史新闻
• 翻译风格：流畅中文 + 保留英文专有名词

用户 → HTTPS → coffee.kikihuang.net
                    │
              Easy Auth (AAD)
                    │
         Azure Container Apps
          (0.25 vCPU / 0.5Gi)
                    │
              VNet (10.0.0.0/16)
                    │
           Private Endpoint (10.0.1.4)
                    │
         Azure SQL Database (Basic)
          Entra-only, 公网关闭

• VNet + Private Endpoint — SQL 仅内网可达，公网完全关闭
• Entra-only 认证 — 无 SQL 密码，仅 Managed Identity Token
• Easy Auth — 匿名可读，写操作需 AAD 登录或 MI Bearer Token
• 自定义域名 — coffee.kikihuang.net，托管证书

12 个 Prisma 模型：

/                       首页（咖啡日报：今日 + 昨日）
/beans                  咖啡豆列表（统计卡片 + 筛选）
/beans/[id]             咖啡豆详情
/purchases              消费记录（豆子/咖啡店/器具/面包）
/purchases/stats        月度统计图表
/bread/recipes          面包食谱列表
/bread/recipes/[id]     食谱详情（配料表 + 步骤 + 知识卡片）
/news/[id]              新闻详情（全文中文翻译 + 原文链接）
/knowledge/regions      产区百科（按国家分组 + 国旗）
/knowledge/regions/[c]  国家详情页
/knowledge/varieties    品种图鉴
/knowledge/roasters     烘焙商目录
/knowledge/processing   处理法参考

# 克隆
git clone https://github.com/XuzhouHuang/coffee-journal.git
cd coffee-journal

# 安装依赖
npm install

# 注意：本地开发需将 prisma/schema.prisma 的 provider 改为 "sqlite"
# 并移除 @db.NVarChar / @db.NVarChar(Max) 注解

# 配置环境变量
echo 'DATABASE_URL="file:./dev.db"' > .env.local

# 初始化数据库
npx prisma migrate dev
npx prisma db seed

# 启动（端口 3001 避免冲突）
npm run dev -- -p 3001

使用 Azure Container Apps + ACR + Azure SQL：

# ACR 构建
az acr build --registry coffeejournalacr \
  --image coffee-journal:latest \
  --file Dockerfile .

# 更新 Container App
az containerapp update \
  --resource-group coffee-journal-rg \
  --name coffee-journal-v2 \
  --image coffeejournalacr.azurecr.io/coffee-journal:latest \
  --revision-suffix <revision-name>

北欧杂志风 (Nordic Editorial)

• 暖白色调（#FAF8F5 背景，#2C2825 文字，#8B7355 咖啡色强调）
• 全衬线字体：DM Serif Display（英文）+ Noto Serif SC / 思源宋体（中文）
• 极简侧边栏导航，editorial spacing
• 响应式适配：手机端 hamburger 菜单 + 紧凑布局
• 灵感：Kinfolk Magazine 美学

• Phase 1: 项目初始化 + 数据模型
• Phase 2: 咖啡豆 CRUD + 购买记录 + 冲煮记录
• Phase 3: 咖啡店消费 + 月度统计图表
• Phase 4: 知识库（产区/品种/烘焙商/处理法）
• Phase 5: Dashboard 首页
• Phase 6: 面包购买 + 食谱管理
• Phase 7: UI 优化 + 手机端适配
• Phase 8: 咖啡日报（4 源抓取 + AI 翻译 + 每日定时更新）
• Phase 9: 🤖 AI 拍照识别咖啡袋自动录入

Private project.