会员管理开发文档
1. 概述
会员域由 MembersBundle 承载,关联微信粉丝(WechatBundle)、积分(PointBundle)、营销(PromotionsBundle)。
核心表:members、members_info、members_address。
2. 相关 Bundle
| Bundle | 职责 |
|---|---|
| MembersBundle | 会员 CRUD、等级、标签、地址 |
| WechatBundle | 微信粉丝、OAuth |
| PointBundle | 积分余额与流水 |
| PromotionsBundle | 注册送券等活动 |
3. 核心文件结构
src/MembersBundle/
├── Http/Api/V1/Action/Members.php
├── Http/Api/V1/Action/MemberTags.php
├── Http/FrontApi/V1/Action/Members.php
├── Services/MemberService.php
├── Services/UserService.php
├── Entities/Members.php
├── Entities/MembersInfo.php
├── Events/CreateMemberSuccessEvent.php
├── Jobs/BatchActionMembers.php
└── Providers/EventServiceProvider.php4. 路由与代表性 API
商户端(routes/api/member.php)
| 方法 | 路径 | Action |
|---|---|---|
| GET | /api/members | Members@getMemberList |
| POST | /api/member | Members@createMember |
| GET | /api/wechat/fans/list | WechatFans@getWxFansList |
中间件:api.auth + activated + shoplog,JWT guard api。
C 端(routes/frontapi/member.php)
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/h5app/wxapp/member/login | 小程序/H5 登录 |
| GET | /api/h5app/wxapp/member/info | 会员信息 |
Guard:h5api 或 dingoguard:h5app。
5. 事件与队列
| 事件/Job | 说明 |
|---|---|
CreateMemberSuccessEvent | 注册成功 → 促销、积分、通知 Listener |
BatchActionMembers | 批量操作会员 |
GroupSendSms | 群发短信 |
