1. CRMEB送礼收礼模块核心设计解析在电商系统中送礼功能一直是个高频需求场景。CRMEB标准版通过独立的送礼收礼模块实现了先支付后填写地址的创新流程设计。这套方案的核心价值在于解决了传统送礼场景中的三个痛点隐私保护送礼方无需提前获取收礼人地址信息避免社交尴尬灵活性收礼人可自主决定收货时间和地址特别适合异地送礼成本可控通过礼品附加费机制商家可灵活覆盖包装和物流成本从技术架构看该模块主要包含三个关键子系统送礼订单处理系统特殊订单标记支付流程礼物卡生成系统海报/链接的动态生成收礼订单转换系统虚拟订单转实体订单提示礼品附加费建议设置为商品价格的5-15%需综合考虑包装成本和物流成本。例如单价100元的商品附加费设为10元较为合理。2. 送礼功能全流程开发详解2.1 商品层配置实现在CRMEB后台的商品编辑界面营销设置区域新增了送礼功能开关。技术实现上这需要在product表添加is_gift字段tinyint类型并在商品SKU表中添加gift_fee字段decimal类型。关键SQL示例ALTER TABLE crmeb_product ADD is_gift TINYINT(1) NOT NULL DEFAULT 0 COMMENT 是否开启送礼; ALTER TABLE crmeb_product_attr_value ADD gift_fee DECIMAL(10,2) NOT NULL DEFAULT 0.00 COMMENT 礼品附加费;前端配置界面需注意开启送礼功能时强制校验商品库存状态礼品附加费输入框需有最小值校验≥0建议添加推荐附加费计算器自动建议合理费用2.2 送礼订单创建流程当用户选择送礼物时系统会创建特殊状态的订单订单类型标记为gift_order普通订单为normal_order收货地址字段留空自动免除运费shipping_fee0将礼品附加费计入订单总额核心代码逻辑PHP示例// 创建送礼订单 public function createGiftOrder($uid, $productInfo) { $order [ order_type gift_order, gift_fee $productInfo[gift_fee], total_amount $productInfo[price] $productInfo[gift_fee], shipping_fee 0, address_id 0 // 无收货地址 ]; // ...其他订单字段 return Db::name(order)-insertGetId($order); }3. 礼物卡生成与分享技术方案3.1 动态礼物卡生成支付成功后系统需要生成可分享的礼物卡。CRMEB提供了两种形式海报图片使用GD库或Imagick动态生成H5页面链接带加密参数的专属URL海报生成的关键参数包括商品主图缩放至500×500px祝福语文本框用户自定义内容二维码包含领取链接品牌LOGO从系统配置读取建议使用缓存机制避免重复生成$cacheKey gift_card_.md5($orderId); if(!$card Cache::get($cacheKey)){ $card $this-generateGiftCard($orderId); Cache::set($cacheKey, $card, 86400); }3.2 分享链路安全设计礼物卡链接需要包含以下加密参数order_id订单IDgift_tokenHMAC-SHA256加密字符串expire_time有效期默认7天验证逻辑示例public function verifyGiftLink($orderId, $token) { $secretKey config(gift.secret_key); $expectToken hash_hmac(sha256, $orderId, $secretKey); return hash_equals($expectToken, $token); }重要务必使用时间戳校验链接有效期防止过期链接被恶意利用4. 收礼流程开发与订单转换4.1 收礼地址填写设计当收礼人访问礼物链接时系统需要验证链接有效性token有效期展示商品信息和祝福语提供地址表单仅需收货人、电话、详细地址前端需特别注意实现地址自动补全对接地图API手机号格式实时校验提交按钮防重复点击4.2 虚拟订单转换实现收礼人提交地址后系统需要将送礼订单转换为普通订单更新订单类型为normal_order填充收货地址信息触发发货流程可对接物流接口发送订单状态通知关键数据库操作UPDATE crmeb_order SET order_type normal_order, address_id [新地址ID], shipping_status 1 WHERE order_id [订单ID] AND order_type gift_order;5. 消息通知系统设计5.1 关键节点通知整个流程涉及多个消息触发点送礼成功通知给送礼人礼物送达通知给收礼人地址填写提醒3天内未填写时触发订单发货通知建议采用事件驱动架构// 事件定义 Event::listen(gift.order.paid, function($orderId){ // 1. 记录消息到数据库 // 2. 推送微信模板消息 // 3. 可选短信通知 });5.2 模板消息配置微信模板消息示例配置{ template_id: TM12345, data: { first: { value: 您收到一份礼物, color: #173177 }, keyword1: { value: {{product_name}}, color: #173177 }, remark: { value: 点击填写收货地址, color: #FF0000 } } }6. 异常处理与常见问题6.1 典型问题排查礼物卡无法生成检查GD库/Imagick扩展验证图片存储目录权限755查看字体文件路径是否正确订单状态转换失败检查order_type字段是否被误修改验证事务处理是否完整查看数据库触发器是否冲突消息通知未送达检查微信模板消息配额验证用户是否订阅服务通知查看短信接口返回状态6.2 性能优化建议礼物卡图片采用CDN缓存订单查询添加order_type索引高频访问接口添加Redis缓存消息队列处理异步任务索引优化示例ALTER TABLE crmeb_order ADD INDEX idx_order_type (order_type), ADD INDEX idx_gift_status (is_gift,gift_status);7. 扩展功能开发思路7.1 礼物祝福语模板可增加预设祝福语选项生日祝福节日问候商务赠礼自定义输入数据库设计建议CREATE TABLE gift_greetings ( id int(11) NOT NULL AUTO_INCREMENT, title varchar(50) NOT NULL COMMENT 模板标题, content text NOT NULL COMMENT 模板内容, scene varchar(20) NOT NULL COMMENT 使用场景, sort int(11) NOT NULL DEFAULT 0 COMMENT 排序, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;7.2 礼物包装选项扩展商品表结构ALTER TABLE crmeb_product ADD gift_wrap_options TEXT NULL COMMENT 包装选项JSON配置; -- 示例数据 { wrap_style: [ {id:1,name:经典红盒,fee:5.00}, {id:2,name:丝带礼盒,fee:8.00} ] }在CRMEB标准版基础上开发送礼功能时我建议采用分阶段实施方案先确保核心流程跑通再逐步添加祝福语、包装等增值功能。对于高并发场景要特别注意礼物卡生成环节的性能优化必要时可以引入队列处理机制。