营销活动开发文档

1. 概述

营销域由 PromotionsBundle（活动引擎）与 KaquanBundle（卡券/会员等级）共同承载。

---

2. 相关 Bundle

Bundle	职责
PromotionsBundle	拼团、秒杀、助力、签到、转盘、自动化营销
KaquanBundle	优惠券、会员卡、付费会员等级
PointBundle	积分营销
OneCodeBundle	一物一码营销

---

3. 核心文件结构

src/PromotionsBundle/
├── Http/Api/V1/Action/ActivityPromotions.php
├── Http/Api/V1/Action/PromotionGroupsActivity.php
├── Jobs/FirePromotionsActivity.php
└── Providers/EventServiceProvider.php

src/KaquanBundle/
├── Http/Api/V1/Action/DiscountCard.php
├── Http/Api/V1/Action/MemberCard.php
├── Entities/DiscountCards.php
└── Jobs/ReceivesCardPackage.php

表：kaquan_discount_cards、promotions_marketing_activity 等。

---

4. 路由与代表性 API

文件	方法	路径	Action
routes/api/promotions.php	POST	/api/promotions/groups	PromotionGroupsActivity@createPromotionGroupsActivity
	POST	/api/promotions/activity/create	ActivityPromotions@createActivity
routes/api/CardVoucher.php	POST	/api/discountcard	DiscountCard@createDiscountCard
	GET	/api/membercard/grades	MemberCard@getGradeList
routes/frontapi/promotions.php	—	C 端参与活动	PromotionsBundle\Http\FrontApi\V1\Action\*

---

5. 事件与队列

项	说明
CreateMemberSuccessEvent	→ CreateMemberSuccessPromotions 注册送活动
FirePromotionsActivity Job	定时/触发营销活动