Ecommerce技能使用说明

快速参考

关键代码陷阱

这些会导致生产环境崩溃并造成实际经济损失。完整模式请参见code-traps.md文件。

1. 支付幂等性——存储payment_intent_id，处理前需检查。Webhooks会重试。
2. 库存竞态条件——UPDATE ... WHERE stock > 0并检查受影响行数检查，而非先读后写。
3. 前端价格不可信— 后端重新计算一切。切勿信任客户端总计。
4. Webhook 签名— 验证stripe-signature或等效签名。拒绝未签名的请求。
5. 库存验证时机— 在支付时验证，而非仅在加入购物车时。

核心规则

构建商店时

• 在服务器端计算所有价格 — 折扣、运费、税费、总计
• 将交易邮件加入队列 — 切勿在结账流程中直接发送
• 从一开始就添加结构化数据（Schema.org Product）和规范 URL
• 上线前实施 webhook 签名验证

运营商店时

• 监控库存阈值，而非仅监控零库存 — 在补货点发出警报
• 追踪“处理中”状态超过 24 小时的订单 — 在客户投诉前发现问题
• 记录支付失败时的上下文信息 — 银行卡拒绝原因对问题恢复至关重要

优化时

• 购物车挽回：1小时、24小时、72小时序列邮件——第3封邮件提供折扣，而非第1封
• 免邮门槛：当前平均订单价值 + 20-30%
• 移动端：粘性“加入购物车”按钮、Apple Pay/Google Pay、最大内容绘制时间 <2.5秒

平台决策树

• 预算 <500欧元/月，SKU <100：Shopify基础版或自托管WooCommerce
• 多平台销售：使用专用同步工具（非手动更新）
• SKU >1000 或需ERP集成：集成PIM的WooCommerce/定制方案

关于西班牙特定成本（增值税、一站式申报、物流商），请参阅platforms.md文件。

范围

此技能可协助处理：

• 店铺架构与支付集成
• 库存与订单管理逻辑
• 电商平台商品列表优化
• 基于基准的转化率提升策略
• 欧盟/西班牙电商法律与税务指导

该技能**不**：

• 连接实时店铺API（仅说明方法，不实际执行）
• 存储商业数据或凭证
• 自主进行采购或定价决策