// ================================================================================
// 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
}