প্রকল্প সম্পর্কে

本项目是一个专为 TimeCigar 美纽杜雪茄设计的库存监控与补货提醒系统，适合个人及小范围朋友使用。系统核心功能是监控特定商品（如雪茄管、单支雪茄等）的库存状态，并在商品由无货转为有货时，通过 QQ 邮箱向订阅者发送通知。 架构上采用前后端分离与无服务器设计：前端为 GitHub Pages 托管的公开状态页，展示实时库存数据并提供邀请码订阅表单；后端使用 Cloudflare Worker 结合 D1 数据库，用于私有化存储订阅者的邮箱及退订令牌，确保隐私安全；监控与通知逻辑由 GitHub Actions 定时任务驱动，每 5 分钟检查一次库存状态，并通过 QQ SMTP 发送邮件。密钥敏感信息（如 SMTP 授权码、邀请码）均存储在 GitHub Secrets 或 Cloudflare Worker Secrets 中，不会泄露在代码仓库或前端页面。 部署流程包括：申请 QQ 邮箱 SMTP 授权码、创建 Cloudflare D1 数据库并部署 Worker、配置 GitHub Actions Secrets 以及运行部署工作流。系统支持邀请码订阅机制，避免公开注册带来的滥用风险，同时确保订阅者邮箱互不可见。需要注意的是，受限于 GitHub Actions 免费计划，监控频率最低为 5 分钟，无法保证秒级实时抢购响应，且补货邮件仅作为提示，实际库存以官网为准。