鲜阮® · 会员商城

// ========== 核心数据表设计 ========== // 用户表 users（主键 id） { id: STRING // UUID, username: STRING UNIQUE, phone: STRING UNIQUE, passwordHash: STRING, // bcrypt 加密存储 points: INT, // 当前可用积分余额 totalEarned: INT, // 累计获得积分（决定等级） tier: ENUM, // 注册/白银/黄金/铂金/钻石 createdAt: DATETIME } // 订单表 orders（主键 orderNo） { orderNo: STRING UNIQUE, userId: STRING FK→users, items: [{ productId, name, price, qty }], subtotal: DECIMAL, // 商品小计 tierDiscount: DECIMAL, // 等级折扣金额 pointsUsed: INT, // 抵扣积分 pointsDeduct: DECIMAL, // 积分抵扣金额 paid: DECIMAL, // 实付金额 pointsEarned: INT, // 本单获得积分 status: ENUM, // 待发货/已发货/已完成 reviewed: BOOLEAN, // 是否已评价 createdAt: DATETIME } // 积分流水表 points_ledger（对账核心，只增不改） { id: STRING, userId: STRING FK, type: ENUM, // EARN_REGISTER/EARN_ORDER/EARN_REVIEW/EARN_SHARE/SPEND_ORDER/EXPIRE points: INT, // 正数获得，负数消耗 refId: STRING, // 关联订单号/评论ID/商品ID, balanceAfter: INT, // 变动后余额（审计）, expireAt: DATETIME, // 获得时间+24个月, createdAt: DATETIME } // 评价表 reviews { id, productId, userId, username, rating: INT 1-5, text, createdAt } // 分享记录表 shares（防刷：userId+productId+日期 唯一索引） { id, userId, productId, shareDate: DATE, createdAt }

// 规则引擎配置 —— 所有规则集中在 RULES 常量，可配置、可扩展 const RULES = { earn: { register: { points: 100, note: '注册赠送' }, consumption: { perYuan: 1, note: '消费1元=1积分' }, review: { points: 20, oncePerOrder: true }, share: { points: 10, oncePerProductPerDay: true } }, spend: { exchangeRate: 100, // 100积分=1元 maxDeductRate: 0.30 // 最高抵扣订单实付30% }, expire: { months: 24 } // 积分有效期24个月 }

// ========== 关键业务逻辑（伪代码） ========== // 1. 结算价格计算链 function calcCheckout(cart, user, pointsToUse) { subtotal = Σ(item.price × item.qty) tier = getTierByTotalEarned(user.totalEarned) discount = subtotal × (1 - tier.rate) // 等级折扣 afterTier = subtotal - discount maxDeduct = afterTier × RULES.spend.maxDeductRate // 抵扣上限30% deduct = min(pointsToUse / 100, maxDeduct, user.points / 100) paid = afterTier - deduct // 实付金额 return { subtotal, discount, deduct, paid } } // 2. 支付成功事务（原子操作） function onPaySuccess(order) { TRANSACTION { order.status = '待发货' user.points -= order.pointsUsed // 扣除抵扣积分 earned = floor(order.paid × 1) // 消费返积分 user.points += earned user.totalEarned += earned // 计入等级 ledger.add(...); checkTierUpgrade(user) // 触发等级重算 } } // 3. 防刷校验 function canShareReward(userId, productId) { return !shares.exists({userId, productId, date: today}) } function canReviewReward(order) { return order.status=='已完成' && !order.reviewed } // 4. 积分过期（定时任务，FIFO先进先出核销） cron daily: 过滤 ledger 中 type=EARN && expireAt < now → 生成 EXPIRE 负向流水，扣减余额，通知用户