后台接口说明

按运营管理模块，说明后台管理系统每个功能对应的接口。

认证与安全

登录

用途：管理员登录后台
接口：POST /api/admin/login
参数：用户名、密码、验证码、验证码 ID
返回：Token + 管理员信息
安全机制：验证码 5 分钟有效、连续 5 次失败锁定 30 分钟

获取当前用户信息

用途：登录后获取当前管理员信息
接口：GET /api/admin/info
返回：用户名、头像、角色列表、菜单列表

商品管理

商品列表

用途：查看所有商品，支持搜索和筛选
接口：GET /api/product/list
参数：关键词、分类、品牌、页码
返回：商品列表（含图片、价格、库存、状态）

创建商品

用途：上架新商品
接口：POST /api/product/create
参数：商品信息（名称、分类、品牌、价格、库存、规格属性、SKU 列表等）

编辑商品

用途：修改已有商品信息
接口：POST /api/product/update/{id}

删除商品

用途：下架并删除商品
接口：POST /api/product/delete/{id}

商品分类

操作	接口	说明
分类树	`GET /api/productCate/list/{parentId}`	获取分类树（最多三级）
新增分类	`POST /api/productCate/create`	创建分类
编辑分类	`POST /api/productCate/update/{id}`	修改分类信息
删除分类	`POST /api/productCate/delete/{id}`	有子分类或关联商品时拒绝删除

品牌管理

操作	接口	说明
品牌列表	`GET /api/brand/list`	分页查询
新增品牌	`POST /api/brand/create`
编辑品牌	`POST /api/brand/update/{id}`
删除品牌	`POST /api/brand/delete/{id}`	有关联商品时拒绝删除

属性管理

操作	接口	说明
属性列表	`GET /api/productAttr/{cateId}/list`	按分类查询属性
新增属性	`POST /api/productAttr/create`
编辑属性	`POST /api/productAttr/update/{id}`
删除属性	`POST /api/productAttr/delete/{id}`

运费模板

操作	接口	说明
模板列表	`GET /api/feightTemplate/list`
新增模板	`POST /api/feightTemplate/create`
编辑模板	`POST /api/feightTemplate/update/{id}`
删除模板	`POST /api/feightTemplate/delete/{id}`

订单管理

订单列表

用途：查看所有订单，支持日期范围搜索
接口：GET /api/order/list
参数：订单号、收货人、日期范围、订单状态、页码
返回：订单列表（含商品信息、收货人、金额、状态）

订单详情

用途：查看某个订单的完整信息
接口：GET /api/order/detail/{id}
返回：商品信息、收货地址、金额明细、操作历史

发货

用途：对已付款订单进行发货
接口：POST /api/order/deliver
参数：订单号、物流公司（8家预置）、运单号
说明：自动记录操作日志（操作人 + 物流信息）

关闭订单

用途：手动关闭订单
接口：POST /api/order/close

退货申请

操作	接口	说明
退货列表	`GET /api/returnApply/list`	按状态筛选
退货详情	`GET /api/returnApply/detail/{id}`
审核通过	`POST /api/returnApply/update`	状态改为"退货中"
审核拒绝	`POST /api/returnApply/update`	状态改为"已拒绝"
确认收货	`POST /api/returnApply/update`	退货完成

促销管理

优惠券

操作	接口	说明
优惠券列表	`GET /api/coupon/list`
新增优惠券	`POST /api/coupon/create`	设置面额、门槛、有效期
编辑优惠券	`POST /api/coupon/update/{id}`
删除优惠券	`POST /api/coupon/delete/{id}`
领取记录	`GET /api/coupon/history`	查看谁领了/用了这张券

秒杀活动

操作	接口	说明
活动列表	`GET /api/flash/list`
新增活动	`POST /api/flash/create`	设置活动时间、场次
活动商品	`GET /api/flash/product`	管理参与秒杀的商品
添加秒杀商品	`POST /api/flash/product/create`	设置秒杀价和限量

推荐管理

模块	列表接口	说明
新品推荐	`GET /api/newProduct/list`	设置首页新品推荐
人气推荐	`GET /api/recommendProduct/list`	设置首页人气推荐
广告位	`GET /api/advertise/list`	管理首页轮播广告
品牌推荐	`GET /api/homeBrand/list`	设置首页品牌展示
专题推荐	`GET /api/subject/list`	设置首页专题入口

内容管理

专题管理

操作	接口	说明
专题列表	`GET /api/subject/list`
新增专题	`POST /api/subject/create`
编辑专题	`POST /api/subject/update/{id}`
删除专题	`POST /api/subject/delete/{id}`

话题管理

操作	接口	说明
话题列表	`GET /api/topic/list`
新增/编辑/删除	同上模式

优选专区

操作	接口	说明
专区列表	`GET /api/preferenceArea/list`
新增/编辑/删除	同上模式

会员管理

会员列表

用途：查看所有注册会员
接口：GET /api/member/list
参数：用户名、手机号、会员等级、状态
返回：会员列表（含积分、成长值、等级）

调整积分/成长值

用途：手动调整会员的积分或成长值
接口：POST /api/member/update
说明：调整成长值时自动触发等级升降级检查

会员等级配置

用途：配置各等级的成长值阈值
接口：会员等级相关接口

权限管理

管理员

操作	接口	说明
管理员列表	`GET /api/admin/list`
新增管理员	`POST /api/admin/create`
编辑管理员	`POST /api/admin/update/{id}`
启用/禁用	`POST /api/admin/updateStatus/{id}`	禁用时清除 Token
分配角色	`POST /api/admin/role/update`

角色

操作	接口	说明
角色列表	`GET /api/role/list`
新增角色	`POST /api/role/create`
编辑角色	`POST /api/role/update/{id}`
删除角色	`POST /api/role/delete/{id}`	有管理员关联时拒绝删除
分配菜单	`POST /api/role/allocMenu`
分配资源	`POST /api/role/allocResource`

菜单 & 资源

操作	接口	说明
菜单树	`GET /api/menu/list`	树形结构
新增菜单	`POST /api/menu/create`
资源列表	`GET /api/resource/list`	支持分类筛选
新增资源	`POST /api/resource/create`