商品数据模型#

1
-- 品牌表 product_brands
2
CREATE TABLE `product_brands` (
3
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '品牌ID',
4
    `name` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '品牌名称',
5
    `desc` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '品牌描述',
6
    `logo_url` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '品牌logo图片',
7
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
8
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
9
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
10
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
11
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
12
    PRIMARY KEY (`id`)
13
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='品牌表';
14

15
-- 类别表 product_category
16
CREATE TABLE `product_category` (
17
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '分类ID',
18
    `pid` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '父ID',
19
    `name` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '分类名称',
20
    `desc` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '分类描述',
21
    `pic_url` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '分类图片',
22
    `path` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '分类地址{pid}-{child_id}-...',
23
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
24
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
25
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
26
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
27
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
28
    PRIMARY KEY (`id`)
29
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='类别表';
30

31
-- spu表 product_spu
32
-- spu: standard product unit 标准产品单位
33
CREATE TABLE `product_spu` (
34
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'SPU ID',
35
    `brand_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '品牌ID',
36
    `category_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '分类ID',
37
    `name` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT 'spu名称',
38
    `desc` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT 'spu描述',
39
    `selling_point` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '卖点',
40
    `unit` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT 'spu单位',
41
    `banner_url` text COMMENT 'banner图片 多个图片逗号分隔',
42
    `main_url` text COMMENT '商品介绍主图 多个图片逗号分隔',
43
    `price_fee` int unsigned NOT NULL DEFAULT 0 COMMENT '售价，整数方式保存',
44
    `price_scale` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '售价，金额对应的小数位数',
45
    `market_price_fee` int unsigned NOT NULL DEFAULT 0 COMMENT '市场价，整数方式保存',
46
    `market_price_scale` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '市场价，金额对应的小数位数',
47
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
48
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
49
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
50
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
51
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
52
    PRIMARY KEY (`id`)
53
) ENGINE=InnoDB DEFAULT AUTO_INCREMENT=666666 CHARSET=utf8mb4 COMMENT='spu表';
54

55
-- sku表 product_sku
56
-- sku: stock keeping unit 库存量单位
57
CREATE TABLE `product_sku` (
58
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'SKU ID',
59
    `spu_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT 'SPU ID',
60
    `attrs` text COMMENT '销售属性值{attr_value_id}-{attr_value_id} 多个销售属性值逗号分隔',
61
    `banner_url` text COMMENT 'banner图片 多个图片逗号分隔',
62
    `main_url` text COMMENT '商品介绍主图 多个图片逗号分隔',
63
    `price_fee` int unsigned NOT NULL DEFAULT 0 COMMENT '售价，整数方式保存',
64
    `price_scale` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '售价，金额对应的小数位数',
65
    `market_price_fee` int unsigned NOT NULL DEFAULT 0 COMMENT '市场价，整数方式保存',
66
    `market_price_scale` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '市场价，金额对应的小数位数',
67
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
68
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
69
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
70
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
71
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
72
    PRIMARY KEY (`id`)
73
) ENGINE=InnoDB DEFAULT AUTO_INCREMENT=666666 CHARSET=utf8mb4 COMMENT='sku表';
74

75
-- 销售属性表 product_attr
76
CREATE TABLE `product_attr` (
77
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '销售属性ID',
78
    `name` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '销售属性名称',
79
    `desc` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '销售属性描述',
80
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
81
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
82
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
83
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
84
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
85
    PRIMARY KEY (`id`)
86
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='销售属性表';
87

88
-- 销售属性值 product_attr_value
89
CREATE TABLE `product_attr_value` (
90
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '销售属性值ID',
91
    `attr_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '销售属性ID',
92
    `value` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '销售属性值',
93
    `desc` varchar(255) unsigned NOT NULL DEFAULT '' COMMENT '销售属性值描述',
94
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
95
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
96
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
97
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
98
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
99
    PRIMARY KEY (`id`)
100
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='销售属性值';
101

102
-- 关联关系冗余表 product_spu_sku_attr_map
103
-- 1. spu下 有哪些sku
104
-- 2. spu下 有那些销售属性
105
-- 3. spu下 每个销售属性对应的销售属性值(一对多)
106
-- 4. spu下 每个销售属性值对应的sku(一对多)
107
CREATE TABLE `product_spu_sku_attr_map` (
108
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
109
    `spu_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT 'SPU ID',
110
    `sku_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT 'SKU ID',
111
    `attr_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '销售属性ID',
112
    `attr_name` varchar(255) NOT NULL DEFAULT '0' COMMENT '销售属性名称',
113
    `attr_value_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '销售属性值ID',
114
    `attr_value_name` varchar(255) NOT NULL DEFAULT '0' COMMENT '销售属性值',
115
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
116
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
117
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
118
    PRIMARY KEY (`id`)
119
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='关联关系冗余表';
120

121
-- sku库存表 product_sku_stock
122
CREATE TABLE `product_sku_stock` (
123
    `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
124
    `sku_id` int(11) unsigned NOT NULL DEFAULT '0' COMMENT 'SKU ID',
125
    `quantity` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '库存',
126
    `quantity_lock` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '锁定库存',
127
    `quantity_over` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '超卖库存 0:严格不准超卖',
128
    `create_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建时间',
129
    `create_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '创建人staff_id',
130
    `update_at` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
131
    `update_by` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '修改人staff_id',
132
    `status` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '状态 1:enable, 0:disable, -1:deleted',
133
    PRIMARY KEY (`id`)
134
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='sku库存表';

1
仓储 --(incre sku quantity)push/pull--> update `product_sku_stock` & incr redis
2

3
回写脚本 ----> select `product_sku_stock`.`quantity`  & update

API#

spu详情 GET {version}/product/spu/{spu_id}

请求参数：

字段	类型	是否必传	描述
spu_id	number	yes	spu ID

响应内容：

1
{
2
    "code": "200",
3
    "msg": "OK",
4
    "result": {
5
        "brand_info": {
6
            "id": "number, 品牌ID",
7
            "name": "string, 品牌名称",
8
            "desc": "string, 品牌描述",
9
            "logo_url": "string, 品牌logo图片",
10
        },
11
        "category_info": {
12
            "id": "number, 分类ID",
13
            "name": "string, 品牌名称",
14
            "desc": "string, 品牌描述",
15
            "pic_url": "string, 分类图片",
16
            "path": "string, 分类地址{pid}-{child_id}-...",
17
        },
18
        "spu_info": {
19
            "id": "number, spu id",
20
            "name": "string, spu名称",
21
            "desc": "string, spu描述",
22
            "selling_point": "string, 卖点",
23
            "unit": "string, spu单位",
24
            "banner_url": [
25
                "string, banner 图片url",
26
                "string, banner 图片url",
27
            ],
28
            "main_url": [
29
                "string, 商品介绍主图 图片url",
30
                "string, 商品介绍主图 图片url",
31
            ],
32
            "price": "string, 售价",
33
            "market_price": "string, 市场价",
34
            "attrs": [ // 有那些销售属性
35
                {
36
                    "id": "销售属性ID",
37
                    "name": "string, 销售属性名称",
38
                    "desc": "string, 销售属性描述",
39
                    "values": [ // 每个销售属性对应的销售属性值(一对多)
40
                        {
41
                            "id": "销售属性值ID",
42
                            "name": "string, 销售属性值",
43
                            "desc": "string, 销售属性值描述",
44
                            // 每个销售属性值对应的sku(一对多)
45
                            // 页面初始化时，按钮不可点击逻辑判断： 如果该销售属性值下所有sku没有库存，则该销售属性按钮不可点击
46
                            // 选择销售属性值时，按钮不可点击逻辑判断：销售属性构成双向链表，每个销售属性又是一个单向链表存改销售属性对应的所有销售属性值。每当选择一个销售属性值时先前和后一个销售属性遍历，执销售属性值下所有sku售罄的按钮不可点击，且当前销售属性值map记录key为当前点击的销售属性值ID，值统一标示一下就行，目的记录是由于选择了哪个销售属性值使得当前的销售属性值为售罄状态
47
                            // 取消选择销售属性值时，按钮不可点击逻辑恢复判断：数据结构同上，遍历，记录的map删除key为当前取消选中的销售属性值，并判断是否还有别的key使得该销售属性值为售罄状态，如果没有则恢复未售罄状态
48
                            "skus": [
49
                                "number, sku id",
50
                                "number, sku id",
51
                            ],
52
                        }
53
                    ],
54
                }
55
            ],
56
            "skus": [ // 有哪些sku
57
                "number, sku id",
58
                "number, sku id",
59
            ],
60
            "skus_map": {
61
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
62
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
63
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
64
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
65
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
66
                "{attr_value_id}-{attr_value_id}-...": "number, sku id",
67
            }
68
        }
69
    }
70
}

获取spu下所有skus库存 GET {version}/stock/spu/{spu_id}

请求参数：

字段	类型	是否必传	描述
spu_id	number	yes	spu ID

响应内容：

1
{
2
    "code": "200",
3
    "msg": "OK",
4
    "result": {
5
            "skus_stock": {
6
                "int, sku id": {
7
                    "quantity": "int, 剩余库存数量"
8
                }
9
            }
10
        }
11
    }
12
}

sku详情 GET {version}/product/sku/{sku_id}

请求参数：

字段	类型	是否必传	描述
sku	number	yes	sku ID

响应内容：

1
{
2
    "code": "200",
3
    "msg": "OK",
4
    "result": {
5
        "id": "number, sku id",
6
        "name": "string, sku名称",
7
        "desc": "string, sku描述",
8
        "unit": "string, sku单位",
9
        "banner_url": [
10
            "string, banner 图片url",
11
            "string, banner 图片url",
12
        ],
13
        "main_url": [
14
            "string, 商品介绍主图 图片url",
15
            "string, 商品介绍主图 图片url",
16
        ],
17
        "price": "string, 售价",
18
        "market_price": "string, 市场价",
19
    }
20
}

spu列表 GET {version}/product/spu/list

请求参数：

字段	类型	是否必传	描述

响应内容：

1
{
2
    "code": "200",
3
    "msg": "OK",
4
    "result": {
5
        "list": [
6
            {
7
                "id": "number, spu id",
8
                "name": "string, spu名称",
9
                "desc": "string, spu描述",
10
                "unit": "string, spu单位",
11
                "banner_url": [
12
                    "string, banner 图片url",
13
                    "string, banner 图片url",
14
                ],
15
                "price": "string, 售价",
16
                "market_price": "string, 市场价",
17
            }
18
        ]
19
    }
20
}

商品数据模型#

API#

相关阅读