gRPC 服务参考
以下为 6 个 gRPC 服务自身定义的 RPC（不含跨服务引用用的 client proto）。服务间通过 Consul 服务发现调用， HTTP 入口（shop / admin）见 API 文档。
user 用户服务
:50051 · shop.user.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| GetUserList | PageInfo → UserListResponse | 用户列表 |
| GetUserByMobile | MobileRequest → UserInfoResponse | 通过 mobile 查询用户 |
| GetUserById | IdRequest → UserInfoResponse | 通过 Id 查询用户 |
| CreateUser | CreateUserInfo → UserInfoResponse | 创建用户 |
| UpdateUser | UpdateUserInfo → Empty | 更新用户 |
| CheckPassword | PasswordCheckInfo → CheckResponse | 检查用户密码 |
| ListAddress | ListAddressReq → ListAddressReply | 所有收货地址列表 |
| CreateAddress | CreateAddressReq → AddressInfo | 新增收货地址 |
| UpdateAddress | UpdateAddressReq → CheckResponse | 修改收货地址 |
| DefaultAddress | AddressReq → CheckResponse | 设置默认地址 |
| DeleteAddress | AddressReq → CheckResponse | 删除收货地址 |
| GetAddress | AddressReq → AddressInfo | 查询收货地址 |
goods 商品服务
:50052 · shop.goods.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| GetAllCategoryList | Empty → CategoryListResponse | 获取所有分类 |
| GetSubCategory | CategoryListRequest → SubCategoryListResponse | 获取子分类 |
| CreateCategory | CategoryInfoRequest → CategoryInfoResponse | 新建分类 |
| DeleteCategory | DeleteCategoryRequest → Empty | 删除分类 |
| UpdateCategory | CategoryInfoRequest → Empty | 修改分类 |
| BrandList | BrandListRequest → BrandListResponse | 品牌列表 |
| CreateBrand | BrandRequest → BrandInfoResponse | 新建品牌 |
| DeleteBrand | BrandRequest → Empty | 删除品牌 |
| UpdateBrand | BrandRequest → Empty | 修改品牌 |
| CreateGoodsType | GoodsTypeRequest → GoodsTypeResponse | 商品类型创建 |
| CreateGoodsSpecification | SpecificationRequest → SpecificationResponse | 商品规格或属性 |
| CreateAttrGroup | AttrGroupRequest → AttrGroupResponse | 商品参数属性组 |
| CreateAttrValue | AttrRequest → AttrResponse | 商品参数属性值 |
| CreateGoods | CreateGoodsRequest → CreateGoodsResponse | 创建商品 |
| UpdateGoods | CreateGoodsRequest → Empty | 修改商品 |
| UpdateGoodsInfo | UpdateGoodsInfoRequest → CheckResponse | 更新商品基础信息 |
| DeleteGoods | DeleteGoodsRequest → CheckResponse | 删除商品 |
| UpdateGoodsStatus | UpdateGoodsStatusRequest → CheckResponse | 上下架 |
| GoodsList | GoodsFilterRequest → GoodsListResponse | 商品列表 |
| AdminGoodsList | GoodsFilterRequest → GoodsListResponse | 管理端商品列表 |
| GoodsDetail | GoodsDetailRequest → GoodsDetailResponse | 商品详情（含 SKU/图片） |
| SkuList | SkuListRequest → SkuListResponse | SKU 列表 |
cart 购物车服务
:50053 · shop.cart.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| CreateCart | CreateCartRequest → CartInfoReply | 添加商品进购物车 |
| UpdateCart | UpdateCartRequest → CheckResponse | 修改购物车商品数量 |
| DeleteCart | DeleteCartRequest → CheckResponse | 删除购物车商品 |
| GetCart | GetCartRequest → GetCartReply | 查询购物车单条记录 |
| ListCart | ListCartRequest → CartListReply | 购物车商品列表 |
order 订单服务
:50054 · shop.order.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| CreateOrder | OrderRequest → OrderInfoResponse | 创建订单 |
| CancelOrder | CancelOrderRequest → CheckResponse | 取消订单 |
| GetOrder | GetOrderRequest → OrderInfoResponse | 查询订单详情 |
| ListOrders | ListOrderRequest → ListOrderReply | 查询订单列表 |
inventory 库存服务
:50055 · shop.inventory.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| QueryStock | StockQueryRequest → StockQueryReply | 查询库存 |
| TryLock | TryLockRequest → TryLockReply | 预占库存 |
| ConfirmDeduct | ConfirmDeductRequest → CheckReply | 确认扣减 |
| Release | ReleaseRequest → CheckReply | 释放库存 |
payment 支付服务
:50056 · shop.payment.service| 方法 | 请求 → 响应 | 说明 |
|---|---|---|
| CreatePayment | CreatePaymentRequest → PaymentInfoReply | 创建支付单 |
| PaymentCallback | PaymentCallbackRequest → CheckReply | 支付回调（本地模拟） |