Loomix
文档中心开发者技术手册出海内容营销与独立站博客系统

📝 内容运营与数字营销套件

专为内容运营与数字营销团队打造的生产力中枢，兼顾了极高的排版灵活性、系统安全与毫秒级页面性能。

👁️ CMS 内容实时预览模式 (Next.js Draft Mode)

商城前台深度打通了 Strapi 的 Preview 预览通道与 Next.js Draft Mode 机制，让编辑人员无需公开发布，即可在真实的前台界面中实时查看未发布的草稿内容。

草稿预览业务流转时序：

  1. 发起预览：运营人员在 Strapi 后台编辑文章时，点击右上角的 Preview 预览按钮。
  2. 安全验签跳转：Strapi 携带包含加密校验签名的 REVALIDATE_SECRET 将浏览器重定向至 api/preview/route.ts。
  3. 激活 Draft Mode：Next.js 通过 node:crypto 验证 HMAC 签名，并向浏览器写入加密安全会话 Cookie。
  4. 前台实时渲染：浏览器自动跳转至目标商品或文章页面，直接呈现包含最新草稿改动的完整视图。
统一复用 REVALIDATE_SECRET
为了避免环境变量混乱并提升运维效率，实时预览验签与 ISR 缓存重构 Webhook 共用根目录 .env 中的同一组 REVALIDATE_SECRET 密钥，极大简化了维护成本。

📨 邮件订阅与防刷防爆破机制 (Rate Limiting)

前台邮件订阅服务（接口端点 api/newsletter/route.ts）直通主流专业 CRM 平台 SendPulse。

智能频率限制与防刷控制

为防范自动化恶意爬虫撞库及滥用第三方 CRM 的 API 配额，该接口在服务端实施了基于客户端 IP 的内建 Rate Limiter 请求频率控制。

  • 最大允许频次：连续 2 次请求
  • 时间滑动窗口：1 小时（60 * 60 * 1000 毫秒）
  • 来源溯源追踪：从 x-forwarded-for 中精确提取访客真实 IP，并在服务端内存中记录追踪。
  • 若请求超出配额，服务器将直接返回 HTTP 429 Too Many Requests 拦截响应。
.env (SendPulse CRM 接入配置参数)
bash
SENDPULSE_API_ID=your_api_id
SENDPULSE_API_SECRET=your_api_secret
SENDPULSE_BOOK_ID=your_target_mailing_list_id