{"openapi":"3.0.0","components":{"schemas":{"gs-service.api.goods.v1.GetGoodsReq":{"properties":{"page":{"description":"页码","format":"int","type":"integer"},"pageSize":{"description":"每页数量","format":"int","type":"integer"},"useStatus":{"description":"物品使用状态","format":"int","type":"integer"},"name":{"description":"物品名称","format":"string","type":"string"}},"required":["page","pageSize","useStatus"],"type":"object"},"gs-service.api.goods.v1.GetGoodsRes":{"properties":{"goods":{"description":"物品列表","format":"[]*vo.Goods","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Goods","description":""},"type":"array"},"total":{"description":"总数量","format":"int","type":"integer"}},"type":"object"},"gs-service.internal.model.vo.Goods":{"properties":{"id":{"format":"int64","type":"integer"},"userId":{"format":"int64","type":"integer"},"labelId":{"format":"int64","type":"integer"},"storageLocationId":{"format":"int64","type":"integer"},"imgUrl":{"description":"商品图片URL","format":"string","type":"string"},"handleImgUrl":{"description":"处理后的图片URL","format":"string","type":"string"},"name":{"description":"商品名称","format":"string","type":"string"},"barcode":{"description":"条形码","format":"string","type":"string"},"money":{"description":"金额","format":"float64","type":"number"},"buyDate":{"description":"购买日期","format":"*gtime.Time","type":"string"},"useStatus":{"description":"使用状态","format":"int","type":"integer"},"bgColor":{"description":"背景颜色","format":"string","type":"string"},"goodsNum":{"description":"商品数量","format":"int","type":"integer"},"isConsume":{"description":"是否已消费 0-否 1-是","format":"int","type":"integer"},"sellByDate":{"description":"保质期/到期日期","format":"*gtime.Time","type":"string"},"createdAt":{"description":"创建时间","format":"*gtime.Time","type":"string"},"updatedAt":{"description":"更新时间","format":"*gtime.Time","type":"string"},"deletedAt":{"description":"删除时间","format":"*gtime.Time","type":"string"},"label":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Label","description":""},"storageLocation":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.StorageLocation","description":""}},"type":"object"},"gs-service.internal.model.vo.Label":{"properties":{"id":{"format":"int64","type":"integer"},"name":{"format":"string","type":"string"},"icon":{"format":"string","type":"string"},"color":{"format":"string","type":"string"},"description":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.storage_location.v1.StorageLocation":{"properties":{"id":{"format":"int64","type":"integer"},"title":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.goods.v1.NewGoodsReq":{"properties":{"labelId":{"description":"物品标签ID","format":"int64","type":"integer"},"storageLocationId":{"description":"物品储存位置ID","format":"int64","type":"integer"},"name":{"description":"物品名称","format":"string","type":"string"},"barcode":{"description":"条形码","format":"string","type":"string"},"money":{"description":"物品金额","format":"int","type":"integer"},"imgUrl":{"description":"物品图片url","format":"string","type":"string"},"imgSuffix":{"description":"图片后缀","format":"string","type":"string"},"buyDate":{"description":"物品购买日期","format":"*gtime.Time","type":"string"},"useStatus":{"description":"物品使用状态","format":"int","type":"integer"},"bgColor":{"description":"物品背景颜色","format":"string","type":"string"},"goodsNum":{"description":"物品数量","format":"int","type":"integer"},"isConsume":{"description":"物品是否消耗","format":"bool","type":"boolean"},"sellByDate":{"description":"物品保质期","format":"*gtime.Time","type":"string"}},"required":["name","money","imgUrl","imgSuffix","buyDate","useStatus","bgColor","goodsNum","isConsume","sellByDate"],"type":"object"},"gs-service.api.goods.v1.NewGoodsRes":{"properties":{"id":{"description":"物品ID","format":"int64","type":"integer"}},"type":"object"},"gs-service.api.goods.v1.UpdateReq":{"properties":{"id":{"description":"物品ID","format":"int64","type":"integer"},"labelId":{"description":"物品标签ID","format":"int64","type":"integer"},"storageLocationId":{"description":"物品储存位置ID","format":"int64","type":"integer"},"name":{"description":"物品名称","format":"string","type":"string"},"barcode":{"description":"条形码","format":"string","type":"string"},"money":{"description":"物品金额","format":"int","type":"integer"},"imgUrl":{"description":"物品图片url","format":"string","type":"string"},"imgSuffix":{"description":"图片后缀","format":"string","type":"string"},"buyDate":{"description":"物品购买日期","format":"*gtime.Time","type":"string"},"useStatus":{"description":"物品使用状态","format":"int","type":"integer"},"bgColor":{"description":"物品背景颜色","format":"string","type":"string"},"goodsNum":{"description":"物品数量","format":"int","type":"integer"},"isConsume":{"description":"物品是否消耗","format":"bool","type":"boolean"},"sellByDate":{"description":"物品保质期","format":"*gtime.Time","type":"string"}},"required":["id","name","money","imgUrl","imgSuffix","buyDate","useStatus","bgColor","goodsNum","isConsume","sellByDate"],"type":"object"},"gs-service.api.goods.v1.UpdateRes":{"properties":{},"type":"object"},"gs-service.api.goods.v1.ConsumeGoodsReq":{"properties":{"id":{"description":"物品ID","format":"int64","type":"integer"},"num":{"description":"数量","format":"int","type":"integer"}},"required":["id","num"],"type":"object"},"gs-service.api.goods.v1.ConsumeGoodsRes":{"properties":{},"type":"object"},"gs-service.api.goods.v1.CutImgReq":{"properties":{"file":{"description":"物品图片","format":"*ghttp.UploadFile","type":"file"}},"required":["file"],"type":"object"},"gs-service.api.goods.v1.CutImgRes":{"properties":{"url":{"description":"处理后图片url","format":"string","type":"string"}},"type":"object"},"gs-service.api.goods.v1.HandleImgReq":{"properties":{"url":{"description":"物品图片url","format":"string","type":"string"}},"required":["url"],"type":"object"},"gs-service.api.goods.v1.HandleImgRes":{"properties":{"url":{"description":"处理后图片url","format":"string","type":"string"}},"type":"object"},"gs-service.api.goods.v1.ImgIdReq":{"properties":{},"type":"object"},"gs-service.api.goods.v1.ImgIdRes":{"properties":{"id":{"description":"物品图片id","format":"string","type":"string"}},"type":"object"},"gs-service.api.goods.v1.IndexDataReq":{"properties":{},"type":"object"},"gs-service.api.goods.v1.IndexDataRes":{"properties":{"allMoney":{"description":"所有物品金额","format":"float64","type":"number"},"allNum":{"description":"所有物品数量","format":"int","type":"integer"},"useNum":{"description":"已使用物品数量","format":"int","type":"integer"},"unusedNum":{"description":"未使用物品数量","format":"int","type":"integer"},"damageNum":{"description":"物品总损失","format":"int","type":"integer"},"expiringSoonNum":{"description":"物品即将过期数量","format":"int","type":"integer"}},"type":"object"},"gs-service.api.goods.v1.MonthDataReq":{"properties":{},"type":"object"},"gs-service.api.goods.v1.MonthDataRes":{"properties":{"monthData":{"format":"[]*vo.MonthData","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.MonthData","description":""},"type":"array"}},"type":"object"},"gs-service.internal.model.vo.MonthData":{"properties":{"month":{"format":"string","type":"string"},"count":{"format":"int","type":"integer"},"totalMoney":{"format":"float64","type":"number"}},"type":"object"},"gs-service.api.goods.v1.RankReq":{"properties":{"limit":{"default":20,"description":"返回条数，默认20，最多50","format":"int","maximum":50,"type":"integer"}},"type":"object"},"gs-service.api.goods.v1.RankRes":{"properties":{"list":{"description":"排行榜列表","format":"[]*vo.GoodsRank","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.GoodsRank","description":""},"type":"array"}},"type":"object"},"gs-service.internal.model.vo.GoodsRank":{"properties":{"id":{"format":"int64","type":"integer"},"userId":{"format":"int64","type":"integer"},"labelId":{"format":"int64","type":"integer"},"storageLocationId":{"format":"int64","type":"integer"},"imgUrl":{"description":"商品图片URL","format":"string","type":"string"},"handleImgUrl":{"description":"处理后的图片URL","format":"string","type":"string"},"name":{"description":"商品名称","format":"string","type":"string"},"barcode":{"description":"条形码","format":"string","type":"string"},"money":{"description":"金额","format":"float64","type":"number"},"buyDate":{"description":"购买日期","format":"*gtime.Time","type":"string"},"useStatus":{"description":"使用状态","format":"int","type":"integer"},"bgColor":{"description":"背景颜色","format":"string","type":"string"},"goodsNum":{"description":"商品数量","format":"int","type":"integer"},"isConsume":{"description":"是否已消费 0-否 1-是","format":"int","type":"integer"},"sellByDate":{"description":"保质期/到期日期","format":"*gtime.Time","type":"string"},"createdAt":{"description":"创建时间","format":"*gtime.Time","type":"string"},"updatedAt":{"description":"更新时间","format":"*gtime.Time","type":"string"},"deletedAt":{"description":"删除时间","format":"*gtime.Time","type":"string"},"label":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Label","description":""},"storageLocation":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.StorageLocation","description":""},"dailyCost":{"description":"每日使用成本（元/天）","format":"float64","type":"number"}},"type":"object"},"gs-service.api.goods.v1.UploadImgReq":{"properties":{"file":{"description":"物品图片","format":"*ghttp.UploadFile","type":"file"}},"required":["file"],"type":"object"},"gs-service.api.goods.v1.UploadImgRes":{"properties":{"file":{"description":"物品图片","format":"string","type":"string"}},"type":"object"},"gs-service.api.goods.v1.DeleteReq":{"properties":{"id":{"description":"物品ID","format":"int64","type":"integer"}},"required":["id"],"type":"object"},"gs-service.api.goods.v1.DeleteRes":{"properties":{},"type":"object"},"gs-service.api.goods.v1.GetOneReq":{"properties":{"id":{"description":"物品ID","format":"int64","type":"integer"}},"required":["id"],"type":"object"},"gs-service.api.goods.v1.GetOneRes":{"properties":{"id":{"format":"int64","type":"integer"},"userId":{"format":"int64","type":"integer"},"labelId":{"format":"int64","type":"integer"},"storageLocationId":{"format":"int64","type":"integer"},"imgUrl":{"description":"商品图片URL","format":"string","type":"string"},"handleImgUrl":{"description":"处理后的图片URL","format":"string","type":"string"},"name":{"description":"商品名称","format":"string","type":"string"},"barcode":{"description":"条形码","format":"string","type":"string"},"money":{"description":"金额","format":"float64","type":"number"},"buyDate":{"description":"购买日期","format":"*gtime.Time","type":"string"},"useStatus":{"description":"使用状态","format":"int","type":"integer"},"bgColor":{"description":"背景颜色","format":"string","type":"string"},"goodsNum":{"description":"商品数量","format":"int","type":"integer"},"isConsume":{"description":"是否已消费 0-否 1-是","format":"int","type":"integer"},"sellByDate":{"description":"保质期/到期日期","format":"*gtime.Time","type":"string"},"createdAt":{"description":"创建时间","format":"*gtime.Time","type":"string"},"updatedAt":{"description":"更新时间","format":"*gtime.Time","type":"string"},"deletedAt":{"description":"删除时间","format":"*gtime.Time","type":"string"},"label":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Label","description":""},"storageLocation":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.StorageLocation","description":""}},"type":"object"},"gs-service.api.invite_code.v1.GetOneReq":{"properties":{},"type":"object"},"gs-service.api.invite_code.v1.GetOneRes":{"properties":{"code":{"description":"邀请码","format":"string","type":"string"}},"type":"object"},"gs-service.api.invite_code.v1.CountReq":{"properties":{},"type":"object"},"gs-service.api.invite_code.v1.CountRes":{"properties":{"count":{"description":"数量","format":"int","type":"integer"}},"type":"object"},"gs-service.api.invite_code.v1.UseReq":{"properties":{"code":{"description":"邀请码","format":"string","type":"string"}},"type":"object"},"gs-service.api.invite_code.v1.UseRes":{"properties":{},"type":"object"},"gs-service.api.invite_code.v1.UserDataReq":{"properties":{},"type":"object"},"gs-service.api.invite_code.v1.UserDataRes":{"properties":{"inviteCodeCount":{"description":"邀请码数量","format":"int","type":"integer"},"inviteCodeDayCount":{"description":"邀请码日数量","format":"int","type":"integer"}},"type":"object"},"gs-service.api.label.v1.GetListReq":{"properties":{},"type":"object"},"gs-service.api.label.v1.GetListRes":{"properties":{"list":{"description":"标签列表","format":"*[]vo.Label","items":{"format":"[]vo.Label","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Label","description":""},"type":"array"},"type":"array"},"total":{"description":"标签总数","format":"*int","type":"integer"}},"type":"object"},"gs-service.api.label.v1.NewReq":{"properties":{"name":{"description":"标签名称","format":"string","type":"string"},"icon":{"description":"标签图标","format":"string","type":"string"},"color":{"description":"标签颜色","format":"string","type":"string"},"description":{"description":"标签说明","format":"string","type":"string"}},"required":["name"],"type":"object"},"gs-service.api.label.v1.NewRes":{"properties":{},"type":"object"},"gs-service.api.label.v1.UpdateReq":{"properties":{"id":{"description":"标签ID","format":"int64","type":"integer"},"name":{"description":"标签名称","format":"string","type":"string"},"icon":{"description":"标签图标","format":"string","type":"string"},"color":{"description":"标签颜色","format":"string","type":"string"},"description":{"description":"标签说明","format":"string","type":"string"}},"required":["id","name"],"type":"object"},"gs-service.api.label.v1.UpdateRes":{"properties":{},"type":"object"},"gs-service.api.label.v1.DeleteReq":{"properties":{"id":{"description":"标签ID","format":"int64","type":"integer"}},"required":["id"],"type":"object"},"gs-service.api.label.v1.DeleteRes":{"properties":{},"type":"object"},"gs-service.api.storage_location.v1.GetListReq":{"properties":{},"type":"object"},"gs-service.api.storage_location.v1.GetListRes":{"properties":{"list":{"format":"[]v1.ListItem","items":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.ListItem","description":""},"type":"array"},"total":{"format":"int","type":"integer"}},"type":"object"},"gs-service.api.storage_location.v1.ListItem":{"properties":{"id":{"format":"int64","type":"integer"},"title":{"format":"string","type":"string"},"createdAt":{"format":"gtime.Time","type":"string"}},"type":"object"},"gs-service.api.storage_location.v1.CreateReq":{"properties":{"title":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.storage_location.v1.CreateRes":{"properties":{},"type":"object"},"gs-service.api.storage_location.v1.UpdateReq":{"properties":{"id":{"format":"int64","type":"integer"},"title":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.storage_location.v1.UpdateRes":{"properties":{},"type":"object"},"gs-service.api.storage_location.v1.DeleteReq":{"properties":{"id":{"format":"int64","type":"integer"}},"type":"object"},"gs-service.api.storage_location.v1.DeleteRes":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.GetListReq":{"properties":{"keyword":{"description":"搜索关键词，模糊匹配订阅名称和备注","format":"string","type":"string"}},"type":"object"},"gs-service.api.subscription.v1.GetListRes":{"properties":{"list":{"description":"订阅列表","format":"*[]vo.Subscription","items":{"format":"[]vo.Subscription","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Subscription","description":""},"type":"array"},"type":"array"},"total":{"description":"订阅总数","format":"*int","type":"integer"}},"type":"object"},"gs-service.internal.model.vo.Subscription":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"},"userId":{"description":"用户ID","format":"int64","type":"integer"},"name":{"description":"订阅名称","format":"string","type":"string"},"price":{"description":"订阅价格","format":"float64","type":"number"},"currency":{"description":"货币单位","format":"string","type":"string"},"cycle":{"description":"周期：1-每年，2-每月，3-每周","format":"int","type":"integer"},"category":{"description":"分类：1-工具，2-娱乐，3-学习，4-开发","format":"int","type":"integer"},"startDate":{"description":"订阅开始日期","format":"*gtime.Time","type":"string"},"nextDate":{"description":"下次续费日期","format":"*gtime.Time","type":"string"},"remark":{"description":"备注","format":"string","type":"string"},"createdAt":{"description":"创建时间","format":"*gtime.Time","type":"string"},"updatedAt":{"description":"更新时间","format":"*gtime.Time","type":"string"}},"type":"object"},"gs-service.api.subscription.v1.NewReq":{"properties":{"name":{"description":"订阅名称","format":"string","type":"string"},"price":{"description":"订阅价格","format":"float64","type":"number"},"currency":{"description":"货币单位，如 CNY、USD","format":"string","type":"string"},"cycle":{"description":"周期：1-每年，2-每月，3-每周","format":"int","type":"integer"},"category":{"description":"分类：0-娱乐，1-工具，2-学习，3-工作，4-开发，5-生活，100-其他","format":"int","type":"integer"},"startDate":{"description":"订阅开始日期","format":"*gtime.Time","type":"string"},"nextDate":{"description":"下次续费日期","format":"*gtime.Time","type":"string"},"remark":{"description":"备注","format":"string","type":"string"}},"required":["name","price","nextDate"],"type":"object"},"gs-service.api.subscription.v1.NewRes":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.UpdateReq":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"},"name":{"description":"订阅名称","format":"string","type":"string"},"price":{"description":"订阅价格","format":"float64","type":"number"},"currency":{"description":"货币单位，如 CNY、USD","format":"string","type":"string"},"cycle":{"description":"周期：1-每年，2-每月，3-每周","format":"int","type":"integer"},"category":{"description":"分类：0-娱乐，1-工具，2-学习，3-工作，4-开发，5-生活，100-其他","format":"int","type":"integer"},"startDate":{"description":"订阅开始日期","format":"*gtime.Time","type":"string"},"nextDate":{"description":"下次续费日期","format":"*gtime.Time","type":"string"},"remark":{"description":"备注","format":"string","type":"string"}},"required":["id","name","price","nextDate"],"type":"object"},"gs-service.api.subscription.v1.UpdateRes":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.GetCategoryMonthlyReq":{"properties":{"year":{"description":"年份，如 2024，不传默认当前年","format":"int","type":"integer"},"month":{"description":"月份，如 1-12，不传默认当前月","format":"int","type":"integer"}},"type":"object"},"gs-service.api.subscription.v1.GetCategoryMonthlyRes":{"properties":{"month":{"description":"月份，格式：2024-01","format":"string","type":"string"},"categories":{"description":"各分类支出列表","format":"[]v1.CategoryAmountItem","items":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.CategoryAmountItem","description":""},"type":"array"},"total":{"description":"该月总支出","format":"float64","type":"number"}},"type":"object"},"gs-service.api.subscription.v1.CategoryAmountItem":{"properties":{"category":{"description":"分类：0-娱乐，1-工具，2-学习，3-工作，4-开发，5-生活，100-其他","format":"int","type":"integer"},"categoryName":{"description":"分类名称","format":"string","type":"string"},"amount":{"description":"该分类月支出","format":"float64","type":"number"}},"type":"object"},"gs-service.api.subscription.v1.GetMonthlyForecastReq":{"properties":{"months":{"default":12,"description":"预测月数，默认12个月","format":"int","type":"integer"}},"type":"object"},"gs-service.api.subscription.v1.GetMonthlyForecastRes":{"properties":{"list":{"description":"月度预测列表","format":"[]v1.MonthlyForecastItem","items":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.MonthlyForecastItem","description":""},"type":"array"}},"type":"object"},"gs-service.api.subscription.v1.MonthlyForecastItem":{"properties":{"month":{"description":"月份，格式：2024-01","format":"string","type":"string"},"totalAmount":{"description":"该月预计总支出","format":"float64","type":"number"},"count":{"description":"参与计算的订阅数","format":"int","type":"integer"}},"type":"object"},"gs-service.api.subscription.v1.GetRecentMonthsReq":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.GetRecentMonthsRes":{"properties":{"list":{"description":"月度数据列表","format":"*[]vo.SubscriptionMonthData","items":{"format":"[]vo.SubscriptionMonthData","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.SubscriptionMonthData","description":""},"type":"array"},"type":"array"},"totalAmount":{"description":"总金额","format":"float64","type":"number"},"totalCount":{"description":"总订阅数","format":"int","type":"integer"}},"type":"object"},"gs-service.internal.model.vo.SubscriptionMonthData":{"properties":{"month":{"description":"月份，格式：2024-01","format":"string","type":"string"},"count":{"description":"该月订阅数量","format":"int","type":"integer"},"amount":{"description":"该月订阅总金额","format":"float64","type":"number"},"subscriptions":{"description":"该月订阅列表","format":"[]vo.Subscription","items":{"$ref":"#/components/schemas/gs-service.internal.model.vo.Subscription","description":""},"type":"array"}},"type":"object"},"gs-service.api.subscription.v1.GetMonthRenewalReq":{"properties":{"month":{"description":"查询月份，格式：2024-01，不传默认本月","format":"string","type":"string"}},"type":"object"},"gs-service.api.subscription.v1.GetMonthRenewalRes":{"properties":{"month":{"description":"查询月份","format":"string","type":"string"},"list":{"description":"到期续费订阅列表","format":"[]v1.RenewalItem","items":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.RenewalItem","description":""},"type":"array"},"totalAmount":{"description":"该月续费总金额","format":"float64","type":"number"},"count":{"description":"到期续费订阅数量","format":"int","type":"integer"}},"type":"object"},"gs-service.api.subscription.v1.RenewalItem":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"},"name":{"description":"订阅名称","format":"string","type":"string"},"price":{"description":"订阅价格","format":"float64","type":"number"},"currency":{"description":"货币单位","format":"string","type":"string"},"cycle":{"description":"周期：1-每年，2-每月，3-每周","format":"int","type":"integer"},"category":{"description":"分类","format":"int","type":"integer"},"startDate":{"description":"订阅开始日期","format":"*gtime.Time","type":"string"},"nextDate":{"description":"下次续费日期","format":"*gtime.Time","type":"string"},"remark":{"description":"备注","format":"string","type":"string"}},"type":"object"},"gs-service.api.subscription.v1.GetTotalDataReq":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.GetTotalDataRes":{"properties":{"monthAmount":{"description":"本月总支出","format":"float64","type":"number"},"yearAmount":{"description":"本年总支出","format":"float64","type":"number"},"totalCount":{"description":"订阅总数量","format":"int","type":"integer"}},"type":"object"},"gs-service.api.subscription.v1.DeleteReq":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"}},"required":["id"],"type":"object"},"gs-service.api.subscription.v1.DeleteRes":{"properties":{},"type":"object"},"gs-service.api.subscription.v1.GetOneReq":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"}},"required":["id"],"type":"object"},"gs-service.api.subscription.v1.GetOneRes":{"properties":{"id":{"description":"订阅ID","format":"int64","type":"integer"},"userId":{"description":"用户ID","format":"int64","type":"integer"},"name":{"description":"订阅名称","format":"string","type":"string"},"price":{"description":"订阅价格","format":"float64","type":"number"},"currency":{"description":"货币单位","format":"string","type":"string"},"cycle":{"description":"周期：1-每年，2-每月，3-每周","format":"int","type":"integer"},"category":{"description":"分类：1-工具，2-娱乐，3-学习，4-开发","format":"int","type":"integer"},"startDate":{"description":"订阅开始日期","format":"*gtime.Time","type":"string"},"nextDate":{"description":"下次续费日期","format":"*gtime.Time","type":"string"},"remark":{"description":"备注","format":"string","type":"string"},"createdAt":{"description":"创建时间","format":"*gtime.Time","type":"string"},"updatedAt":{"description":"更新时间","format":"*gtime.Time","type":"string"}},"type":"object"},"gs-service.api.tos.v1.DeleteReq":{"properties":{"key":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.tos.v1.DeleteRes":{"properties":{},"type":"object"},"gs-service.api.tos.v1.FormDataReq":{"properties":{"fileName":{"format":"string","type":"string"},"uploadType":{"format":"string","type":"string"}},"required":["fileName","uploadType"],"type":"object"},"gs-service.api.tos.v1.FormDataRes":{"properties":{"key":{"format":"string","type":"string"},"policy":{"format":"string","type":"string"},"signature":{"format":"string","type":"string"},"algorithm":{"format":"string","type":"string"},"date":{"format":"string","type":"string"},"credential":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.tos.v1.GetPresignedURLReq":{"properties":{"fileName":{"format":"string","type":"string"},"uploadType":{"format":"string","type":"string"}},"required":["fileName","uploadType"],"type":"object"},"gs-service.api.tos.v1.GetPresignedURLRes":{"properties":{"url":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.upload.v1.GetDownloadURLReq":{"properties":{"fileKey":{"format":"string","type":"string"}},"required":["fileKey"],"type":"object"},"gs-service.api.upload.v1.GetDownloadURLRes":{"properties":{"url":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.upload.v1.DeleteFileReq":{"properties":{"fileKey":{"format":"string","type":"string"}},"required":["fileKey"],"type":"object"},"gs-service.api.upload.v1.DeleteFileRes":{"properties":{},"type":"object"},"gs-service.api.upload.v1.GetPostPolicyReq":{"properties":{"fileName":{"format":"string","type":"string"},"uploadType":{"format":"string","type":"string"},"fileType":{"default":"image","format":"string","type":"string"}},"required":["fileName","uploadType","fileType"],"type":"object"},"gs-service.api.upload.v1.GetPostPolicyRes":{"properties":{"url":{"format":"string","type":"string"},"fileKey":{"format":"string","type":"string"},"formData":{"additionalProperties":{"format":"string","type":"string"},"format":"map[string]string","type":"object"}},"type":"object"},"gs-service.api.upload.v1.GetPresignedURLReq":{"properties":{"fileName":{"format":"string","type":"string"},"uploadType":{"format":"string","type":"string"}},"required":["fileName","uploadType"],"type":"object"},"gs-service.api.upload.v1.GetPresignedURLRes":{"properties":{"url":{"format":"string","type":"string"},"fileKey":{"format":"string","type":"string"}},"type":"object"},"gs-service.api.user.v1.GetUserReq":{"properties":{},"type":"object"},"gs-service.api.user.v1.GetUserRes":{"properties":{"nickName":{"description":"昵称","format":"string","type":"string"}},"type":"object"},"gs-service.api.user.v1.NewUserReq":{"properties":{"nickName":{"description":"昵称","format":"string","type":"string"},"openID":{"description":"openID","format":"string","type":"string"}},"required":["nickName","openID"],"type":"object"},"gs-service.api.user.v1.NewUserRes":{"properties":{},"type":"object"},"gs-service.api.user.v1.UpdateUserReq":{"properties":{"nickName":{"description":"昵称","format":"string","type":"string"}},"required":["nickName"],"type":"object"},"gs-service.api.user.v1.UpdateUserRes":{"properties":{},"type":"object"},"gs-service.api.user.v1.LoginReq":{"properties":{"code":{"description":"code","format":"string","type":"string"}},"required":["code"],"type":"object"},"gs-service.api.user.v1.LoginRes":{"properties":{"accessToken":{"description":"token","format":"string","type":"string"},"expiresIn":{"description":"过期时间","format":"int64","type":"integer"},"refreshToken":{"description":"刷新token","format":"string","type":"string"},"refreshExpiresIn":{"description":"刷新过期时间","format":"int64","type":"integer"}},"type":"object"},"gs-service.api.user.v1.RefreshTokenReq":{"properties":{"refreshToken":{"description":"刷新token","format":"string","type":"string"}},"required":["refreshToken"],"type":"object"},"gs-service.api.user.v1.RefreshTokenRes":{"properties":{"accessToken":{"description":"新的访问token","format":"string","type":"string"},"expiresIn":{"description":"过期时间","format":"int64","type":"integer"},"refreshToken":{"description":"新的刷新token","format":"string","type":"string"},"refreshExpiresIn":{"description":"刷新过期时间","format":"int64","type":"integer"}},"type":"object"},"gs-service.api.vip.v1.GetOneReq":{"properties":{},"type":"object"},"gs-service.api.vip.v1.GetOneRes":{"properties":{"expirationAt":{"description":"过期时间","format":"gtime.Time","type":"string"}},"type":"object"}}},"info":{"title":"","version":""},"paths":{"/goods":{"get":{"parameters":[{"description":"页码","in":"query","name":"page","required":true,"schema":{"description":"页码","format":"int","type":"integer"}},{"description":"每页数量","in":"query","name":"pageSize","required":true,"schema":{"description":"每页数量","format":"int","type":"integer"}},{"description":"物品使用状态","in":"query","name":"useStatus","required":true,"schema":{"description":"物品使用状态","format":"int","type":"integer"}},{"description":"物品名称","in":"query","name":"name","schema":{"description":"物品名称","format":"string","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.GetGoodsRes","description":""}}},"description":""}},"summary":"获取物品","tags":["Goods"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.NewGoodsReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.NewGoodsRes","description":""}}},"description":""}},"summary":"创建物品","tags":["Goods"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.UpdateReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.UpdateRes","description":""}}},"description":""}},"summary":"更新物品","tags":["Goods"]}},"/goods/consume-goods":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.ConsumeGoodsReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.ConsumeGoodsRes","description":""}}},"description":""}},"summary":"消耗物品","tags":["Goods"]}},"/goods/cut-img":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.CutImgReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.CutImgRes","description":""}}},"description":""}},"summary":"裁剪物品图片","tags":["Goods"]}},"/goods/handle-img":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.HandleImgReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.HandleImgRes","description":""}}},"description":""}},"summary":"处理物品图片","tags":["Goods"]}},"/goods/img-id":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.ImgIdRes","description":""}}},"description":""}},"summary":"获取物品图片id","tags":["Goods"]}},"/goods/index-data":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.IndexDataRes","description":""}}},"description":""}},"summary":"首页数据","tags":["Goods"]}},"/goods/month-data":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.MonthDataRes","description":""}}},"description":""}},"summary":"获取物品月数据","tags":["Goods"]}},"/goods/rank":{"get":{"parameters":[{"description":"返回条数，默认20，最多50","in":"query","name":"limit","schema":{"default":20,"description":"返回条数，默认20，最多50","format":"int","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.RankRes","description":""}}},"description":""}},"summary":"物品每日使用成本排行榜","tags":["Goods"]}},"/goods/upload":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.UploadImgReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.UploadImgRes","description":""}}},"description":""}},"summary":"上传物品图片","tags":["Goods"]}},"/goods/{id}":{"delete":{"parameters":[{"description":"物品ID","in":"path","name":"id","required":true,"schema":{"description":"物品ID","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.DeleteRes","description":""}}},"description":""}},"summary":"删除物品","tags":["Goods"]},"get":{"parameters":[{"description":"物品ID","in":"path","name":"id","required":true,"schema":{"description":"物品ID","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.goods.v1.GetOneRes","description":""}}},"description":""}},"summary":"获取物品详情","tags":["Goods"]}},"/invite-code":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.invite_code.v1.GetOneRes","description":""}}},"description":""}},"summary":"获取邀请码","tags":["InviteCode"]}},"/invite-code/count":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.invite_code.v1.CountRes","description":""}}},"description":""}},"summary":"获取数量","tags":["InviteCode"]}},"/invite-code/use":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.invite_code.v1.UseReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.invite_code.v1.UseRes","description":""}}},"description":""}},"summary":"使用邀请码","tags":["InviteCode"]}},"/invite-code/user-data":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.invite_code.v1.UserDataRes","description":""}}},"description":""}},"summary":"获取用户数据","tags":["InviteCode"]}},"/label":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.GetListRes","description":""}}},"description":""}},"summary":"获取标签列表","tags":["Label"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.NewReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.NewRes","description":""}}},"description":""}},"summary":"创建标签","tags":["Label"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.UpdateReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.UpdateRes","description":""}}},"description":""}},"summary":"更新标签","tags":["Label"]}},"/label/{id}":{"delete":{"parameters":[{"description":"标签ID","in":"path","name":"id","required":true,"schema":{"description":"标签ID","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.label.v1.DeleteRes","description":""}}},"description":""}},"summary":"删除标签","tags":["Label"]}},"/storage-location":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.GetListRes","description":""}}},"description":""}},"summary":"获取储存位置列表","tags":["储存位置"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.CreateReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.CreateRes","description":""}}},"description":""}},"summary":"新增储存位置","tags":["储存位置"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.UpdateReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.UpdateRes","description":""}}},"description":""}},"summary":"更新储存位置","tags":["储存位置"]}},"/storage-location/:id":{"delete":{"parameters":[{"in":"query","name":"id","schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.storage_location.v1.DeleteRes","description":""}}},"description":""}},"summary":"删除储存位置","tags":["储存位置"]}},"/subscription":{"get":{"parameters":[{"description":"搜索关键词，模糊匹配订阅名称和备注","in":"query","name":"keyword","schema":{"description":"搜索关键词，模糊匹配订阅名称和备注","format":"string","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetListRes","description":""}}},"description":""}},"summary":"获取订阅列表","tags":["Subscription"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.NewReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.NewRes","description":""}}},"description":""}},"summary":"创建订阅","tags":["Subscription"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.UpdateReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.UpdateRes","description":""}}},"description":""}},"summary":"更新订阅","tags":["Subscription"]}},"/subscription/data/category-monthly":{"get":{"parameters":[{"description":"年份，如 2024，不传默认当前年","in":"query","name":"year","schema":{"description":"年份，如 2024，不传默认当前年","format":"int","type":"integer"}},{"description":"月份，如 1-12，不传默认当前月","in":"query","name":"month","schema":{"description":"月份，如 1-12，不传默认当前月","format":"int","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetCategoryMonthlyRes","description":""}}},"description":""}},"summary":"获取指定月份按分类拆分支出","tags":["Subscription"]}},"/subscription/data/monthly-forecast":{"get":{"parameters":[{"description":"预测月数，默认12个月","in":"query","name":"months","schema":{"default":12,"description":"预测月数，默认12个月","format":"int","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetMonthlyForecastRes","description":""}}},"description":""}},"summary":"获取每月实际支出预测","tags":["Subscription"]}},"/subscription/data/months":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetRecentMonthsRes","description":""}}},"description":""}},"summary":"获取近6个月订阅数据","tags":["Subscription"]}},"/subscription/data/renewal":{"get":{"parameters":[{"description":"查询月份，格式：2024-01，不传默认本月","in":"query","name":"month","schema":{"description":"查询月份，格式：2024-01，不传默认本月","format":"string","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetMonthRenewalRes","description":""}}},"description":""}},"summary":"获取某月到期续费订阅","tags":["Subscription"]}},"/subscription/data/total":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetTotalDataRes","description":""}}},"description":""}},"summary":"获取订阅总数据","tags":["Subscription"]}},"/subscription/{id}":{"delete":{"parameters":[{"description":"订阅ID","in":"path","name":"id","required":true,"schema":{"description":"订阅ID","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.DeleteRes","description":""}}},"description":""}},"summary":"删除订阅","tags":["Subscription"]},"get":{"parameters":[{"description":"订阅ID","in":"path","name":"id","required":true,"schema":{"description":"订阅ID","format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.subscription.v1.GetOneRes","description":""}}},"description":""}},"summary":"获取单个订阅","tags":["Subscription"]}},"/tos/:key":{"delete":{"parameters":[{"in":"query","name":"key","schema":{"format":"string","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.tos.v1.DeleteRes","description":""}}},"description":""}},"summary":"删除对象","tags":["TOS"]}},"/tos/form-data":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.tos.v1.FormDataReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.tos.v1.FormDataRes","description":""}}},"description":""}},"summary":"获取表单数据","tags":["TOS"]}},"/tos/get-presigned-url":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.tos.v1.GetPresignedURLReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.tos.v1.GetPresignedURLRes","description":""}}},"description":""}},"summary":"获取预签名 URL","tags":["TOS"]}},"/upload/download-url":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetDownloadURLReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetDownloadURLRes","description":""}}},"description":""}},"summary":"获取下载预签名URL","tags":["Upload"]}},"/upload/file":{"delete":{"parameters":[{"in":"query","name":"fileKey","required":true,"schema":{"format":"string","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.DeleteFileRes","description":""}}},"description":""}},"summary":"删除文件","tags":["Upload"]}},"/upload/post-policy":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetPostPolicyReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetPostPolicyRes","description":""}}},"description":""}},"summary":"获取POST表单策略(小程序专用)","tags":["Upload"]}},"/upload/presigned-url":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetPresignedURLReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.upload.v1.GetPresignedURLRes","description":""}}},"description":""}},"summary":"获取预签名上传URL","tags":["Upload"]}},"/user":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.GetUserRes","description":""}}},"description":""}},"summary":"获取用户","tags":["User"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.NewUserReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.NewUserRes","description":""}}},"description":""}},"summary":"创建用户","tags":["User"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.UpdateUserReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.UpdateUserRes","description":""}}},"description":""}},"summary":"更新用户","tags":["User"]}},"/user/login":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.LoginReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.LoginRes","description":""}}},"description":""}},"summary":"登录","tags":["User"]}},"/user/refresh-token":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.RefreshTokenReq","description":""}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.user.v1.RefreshTokenRes","description":""}}},"description":""}},"summary":"刷新token","tags":["User"]}},"/vip/one":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/gs-service.api.vip.v1.GetOneRes","description":""}}},"description":""}},"summary":"获取会员信息","tags":["Vip"]}}}}