zjk
7 小时以前 3961d6324ac9b7757c6bfb8ecea6cb1b3caca6ee
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
package com.ruoyi.user.service;
 
import java.util.List;
import com.ruoyi.user.domain.dto.MemberPurchaseDto;
import com.ruoyi.user.domain.vo.MemberSalesStatisticsVo;
import com.ruoyi.user.domain.vo.MemberWarehouseVo;
import com.ruoyi.user.domain.vo.PurchaseOrderVo;
import com.ruoyi.user.domain.vo.WarehouseRecordVo;
 
/**
 * 会员中心 业务层
 *
 * 覆盖「销售统计」与「我的仓库」两个 Tab:统计聚合、仓库列表、进货入库、变动记录、进货订单。
 * 会员身份一律由调用方(Controller)从登录态解析后传入 userId,本层不接受前端直传。
 *
 * @author hugray
 */
public interface IAccountMemberCenterService
{
    /**
     * 查询当前会员的销售统计(当月三栏 + 环比 + 趋势 + 比例 + 排行)
     *
     * @param userId 会员ID
     * @return 销售统计聚合出参
     */
    public MemberSalesStatisticsVo getSalesStatistics(Long userId);
 
    /**
     * 查询当前会员的云仓列表(含低库存标记)
     *
     * @param userId 会员ID
     * @return 云仓列表
     */
    public List<MemberWarehouseVo> getWarehouseList(Long userId);
 
    /**
     * 进货:生成进货单 + 增加库存 + 追加变动流水(同一事务)
     *
     * @param userId 会员ID
     * @param dto    进货入参(warehouseId 须属于当前会员)
     */
    public void purchase(Long userId, MemberPurchaseDto dto);
 
    /**
     * 查询当前会员的云仓变动记录(按变动时间倒序,配合 startPage 分页)
     *
     * @param userId 会员ID
     * @return 变动记录列表
     */
    public List<WarehouseRecordVo> getWarehouseRecordList(Long userId);
 
    /**
     * 查询当前会员的进货订单(按下单时间倒序,配合 startPage 分页)
     *
     * @param userId 会员ID
     * @return 进货订单列表
     */
    public List<PurchaseOrderVo> getPurchaseOrderList(Long userId);
}