Files
iotlcm/app/server/internal/service/app.go
T

204 lines
11 KiB
Go

// ================================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// You can delete these comments if you wish manually maintain this interface file.
// ================================================================================
package service
import (
"context"
"git.5iot.com/iotlcm-public/iotlcm-app/internal/model"
"git.5iot.com/iotlcm-public/iotlcm-app/internal/model/entity"
)
type (
IAppAuth interface {
Captcha(ctx context.Context) (captchaID string, captchaImage string, err error)
SideCaptcha(ctx context.Context) (res *model.AppSideCaptchaModel, err error)
CheckSideCaptcha(ctx context.Context, param *model.AppCheckSideCaptchaParam) (err error)
SendSms(ctx context.Context, param *model.AppSendSmsParam) (res *model.AppSendSmsModel, err error)
PhoneRegister(ctx context.Context, param *model.AppPhoneRegisterParam) (res *model.AppAuthTokenModel, err error)
PhoneLogin(ctx context.Context, param *model.AppPhoneLoginParam) (res *model.AppAuthTokenModel, err error)
PhoneSmsLogin(ctx context.Context, param *model.AppPhoneSmsLoginParam) (res *model.AppAuthTokenModel, err error)
WechatLogin(ctx context.Context, param *model.AppWechatLoginParam) (res *model.AppWechatLoginModel, err error)
WechatBindPhone(ctx context.Context, param *model.AppWechatBindPhoneParam) (res *model.AppWechatBindPhoneModel, err error)
BindWechatOpenIdByLoginCode(ctx context.Context, user *entity.SysUser, wxCode string) error
ForgotPassword(ctx context.Context, param *model.AppForgotPasswordParam) (err error)
}
IAppCard interface {
// BalanceRechargeSubmit 创建余额充值待支付订单,并返回前端可使用的支付信息。
// 余额入账和余额流水只在支付回调或模拟支付确认成功后写入。
BalanceRechargeSubmit(ctx context.Context, param *model.AppBalanceRechargeSubmitParam) (res *model.AppBalanceRechargeSubmitModel, err error)
BalanceRechargeMockPay(ctx context.Context, param *model.AppBalanceRechargeMockPayParam) (*model.AppBalanceRechargeStatusModel, error)
BalanceRechargeStatus(ctx context.Context, param *model.AppBalanceRechargeStatusParam) (*model.AppBalanceRechargeStatusModel, error)
BalanceRechargeRefund(ctx context.Context, param *model.AppBalanceRechargeRefundParam) (*model.AppOrderModel, error)
// AllocateTargets 查询当前企业用户可划拨的目标客户。
AllocateTargets(ctx context.Context, param *model.AppCardAllocateTargetListParam) (items []*model.AppCardAllocateTargetModel, total int, err error)
// AllocateBatchPrepare 校验待划拨卡片,并写入划拨预处理批次。
AllocateBatchPrepare(ctx context.Context, param *model.AppCardAllocateBatchPrepareParam) (res *model.AppCardAllocateBatchModel, err error)
// AllocateBatchSubmit 确认划拨预处理批次,并更新卡片归属;划拨后原企业的可见和办理权限仍保留。
AllocateBatchSubmit(ctx context.Context, param *model.AppCardAllocateBatchSubmitParam) (res *model.AppCardAllocateBatchModel, err error)
Bind(ctx context.Context, param *model.AppCardBindParam) (res *model.AppCardModel, err error)
// ChangePrepare 校验企业用户套餐变更条件,并写入预处理批次。
ChangePrepare(ctx context.Context, param *model.AppCardChangePrepareParam) (res *model.AppCardChangePrepareModel, err error)
// ChangeSubmit 确认套餐变更预处理批次,并在同一事务内完成余额扣款和本地套餐变更。
ChangeSubmit(ctx context.Context, param *model.AppCardChangeSubmitParam) (res *model.AppCardChangeSubmitModel, err error)
// 查询当前登录用户可见的套餐订购记录。
PackageList(ctx context.Context, param *model.AppPackageListParam) (items []*model.AppPackageModel, total int, err error)
// 查询卡片当前套餐详情。
// 核心规则是“卡主表 current_package_code -> 套餐表 package_code”,订购记录只做详情兜底,
// 避免卡主表与订购表不同步时前端报“套餐信息不存在”。
PublicPackageDetail(ctx context.Context, param *model.AppPackagePublicDetailParam) (res *model.AppPackageModel, err error)
// 处理首页免登录公共查卡,只返回卡基础信息,不开放绑卡、重启等业务能力。
PublicQuery(ctx context.Context, param *model.AppCardQueryParam) (res *model.AppCardModel, err error)
// 查询当前登录用户可见卡片。终端用户走 t_sim_terminal 关联表,
// 企业用户沿用管理平台数据权限查询持卡列表。
List(ctx context.Context, param *model.AppCardListParam) (items []*model.AppCardModel, total int, err error)
// 登录后先查用户可见卡;查不到时回退公共查卡,保证登录后仍能查看公共卡详情。
Detail(ctx context.Context, param *model.AppCardDetailParam) (res *model.AppCardModel, err error)
// RenewPrepare 根据当前套餐 renewable_duration_config 生成可续费年限档位,
// 再按当前用户身份解析套餐单年价,返回每个档位的续费总价。
RenewPrepare(ctx context.Context, param *model.AppCardRenewPrepareParam) (res *model.AppCardRenewPrepareModel, err error)
// RenewSubmit 使用账户余额支付,并把单卡续费也写入正式续费批次。
RenewSubmit(ctx context.Context, param *model.AppCardRenewSubmitParam) (res *model.AppCardRenewSubmitModel, err error)
// 批量续费约束做预校验:
// 同一批次必须同当前套餐、同客户归属、同定价,才能生成统一续费档位。
RenewBatchPrepare(ctx context.Context, param *model.AppCardRenewBatchPrepareParam) (res *model.AppCardRenewPrepareModel, err error)
// RenewBatchSubmit 确认续费预处理批次,并在同一事务内完成余额扣款和批量续费落库。
// 批量续费必须先走预处理校验,避免卡片、套餐或价格在提交时发生变化。
RenewBatchSubmit(ctx context.Context, param *model.AppCardRenewBatchSubmitParam) (res *model.AppCardRenewSubmitModel, err error)
// Restart 兼容原重启接口。启用 worker 后停机、复机和重启都投递批次异步执行。
Restart(ctx context.Context, param *model.AppCardRestartParam) (res *model.AppCardRestartModel, err error)
Stop(ctx context.Context, param *model.AppCardRestartParam) (res *model.AppCardLifecycleModel, err error)
Start(ctx context.Context, param *model.AppCardRestartParam) (res *model.AppCardLifecycleModel, err error)
// LifecycleBatchSubmit 提交卡片停机、复机和重启批次。
// 终端用户仅允许重启;停机和复机仍然只开放给企业用户。
LifecycleBatchSubmit(ctx context.Context, param *model.AppCardLifecycleParam) (res *model.AppCardLifecycleModel, err error)
LifecycleBatchStatus(ctx context.Context, param *model.AppCardLifecycleStatusParam) (res *model.AppCardLifecycleModel, err error)
BalanceRechargeWechatNotify(ctx context.Context) error
BalanceRechargeWechatRefundNotify(ctx context.Context) error
RecognizeCard(ctx context.Context) (res *model.AppCardRecognitionModel, err error)
}
IAppUser interface {
WarningPreference(ctx context.Context) (*model.AppWarningPreferenceModel, error)
SaveWarningPreference(ctx context.Context, param *model.AppWarningPreferenceParam) (*model.AppWarningPreferenceModel, error)
UnbindWechat(ctx context.Context) (*model.AppWechatBindModel, error)
CustomerList(ctx context.Context, param *model.AppCustomerListParam) (items []*model.AppCustomerModel, total int, summary *model.AppCustomerSummary, err error)
CustomerDetail(ctx context.Context, param *model.AppCustomerDetailParam) (*model.AppCustomerDetailModel, error)
Info(ctx context.Context) (res *model.AppUserInfoModel, err error)
UpdateInfo(ctx context.Context, param *model.AppUpdateUserInfoParam) (res *model.AppUserInfoModel, err error)
BindWechat(ctx context.Context, param *model.AppWechatBindParam) (res *model.AppWechatBindModel, err error)
}
IAppMessage interface {
List(ctx context.Context, param *model.AppMessageListParam) (items []*model.AppMessageModel, total int, err error)
Detail(ctx context.Context, param *model.AppMessageDetailParam) (*model.AppMessageModel, error)
Read(ctx context.Context, param *model.AppMessageReadParam) error
}
IAppOrder interface {
List(ctx context.Context, param *model.AppOrderListParam) (items []*model.AppOrderModel, total int, err error)
Detail(ctx context.Context, param *model.AppOrderDetailParam) (*model.AppOrderModel, error)
}
IAppWarning interface {
ConfigList(ctx context.Context, param *model.AppWarningConfigListParam) (res *model.AppWarningConfigListModel, err error)
ConfigMeta(ctx context.Context) (res *model.AppWarningConfigMetaModel, err error)
ConfigSave(ctx context.Context, param *model.AppWarningConfigSaveParam) (res *model.AppWarningConfigSaveModel, err error)
ConfigBatchSave(ctx context.Context, param *model.AppWarningConfigBatchSaveParam) (res *model.AppWarningConfigBatchSaveModel, err error)
ConfigNotify(ctx context.Context, param *model.AppWarningConfigNotifyParam) (res *model.AppWarningConfigNotifyModel, err error)
ConfigBatchNotify(ctx context.Context, param *model.AppWarningConfigBatchNotifyParam) (res *model.AppWarningConfigBatchNotifyModel, err error)
}
IAppWorkOrder interface {
Action(ctx context.Context, param *model.AppWorkOrderActionParam) error
Upload(ctx context.Context) (output *model.SysOssUploadModel, err error)
List(ctx context.Context, param *model.AppWorkOrderListParam) (items []*model.AppWorkOrderModel, total int, err error)
Detail(ctx context.Context, param *model.AppWorkOrderDetailParam) (res *model.AppWorkOrderModel, err error)
Create(ctx context.Context, param *model.AppWorkOrderCreateParam) (res *model.AppWorkOrderModel, err error)
}
)
var (
localAppAuth IAppAuth
localAppCard IAppCard
localAppUser IAppUser
localAppMessage IAppMessage
localAppOrder IAppOrder
localAppWarning IAppWarning
localAppWorkOrder IAppWorkOrder
)
func AppAuth() IAppAuth {
if localAppAuth == nil {
panic("implement not found for interface IAppAuth, forgot register?")
}
return localAppAuth
}
func RegisterAppAuth(i IAppAuth) {
localAppAuth = i
}
func AppCard() IAppCard {
if localAppCard == nil {
panic("implement not found for interface IAppCard, forgot register?")
}
return localAppCard
}
func RegisterAppCard(i IAppCard) {
localAppCard = i
}
func AppUser() IAppUser {
if localAppUser == nil {
panic("implement not found for interface IAppUser, forgot register?")
}
return localAppUser
}
func RegisterAppUser(i IAppUser) {
localAppUser = i
}
func AppMessage() IAppMessage {
if localAppMessage == nil {
panic("implement not found for interface IAppMessage, forgot register?")
}
return localAppMessage
}
func RegisterAppMessage(i IAppMessage) {
localAppMessage = i
}
func AppOrder() IAppOrder {
if localAppOrder == nil {
panic("implement not found for interface IAppOrder, forgot register?")
}
return localAppOrder
}
func RegisterAppOrder(i IAppOrder) {
localAppOrder = i
}
func AppWarning() IAppWarning {
if localAppWarning == nil {
panic("implement not found for interface IAppWarning, forgot register?")
}
return localAppWarning
}
func RegisterAppWarning(i IAppWarning) {
localAppWarning = i
}
func AppWorkOrder() IAppWorkOrder {
if localAppWorkOrder == nil {
panic("implement not found for interface IAppWorkOrder, forgot register?")
}
return localAppWorkOrder
}
func RegisterAppWorkOrder(i IAppWorkOrder) {
localAppWorkOrder = i
}