co_interface

package
v0.11.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 9, 2025 License: MIT Imports: 12 Imported by: 3

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ICompany 

type ICompany[TR co_model.ICompanyRes] interface {
	ICompanyBase
	// GetCompanyById 根据ID获取获取公司信息
	GetCompanyById(ctx context.Context, id int64) (response TR, err error)
	// GetCompanyByName 根据Name获取获取公司信息
	GetCompanyByName(ctx context.Context, name string) (response TR, err error)
	// QueryCompanyList 查询公司列表
	QueryCompanyList(ctx context.Context, filter *base_model.SearchParams, isExport ...bool) (*base_model.CollectRes[TR], error)
	// CreateCompany 创建公司信息
	CreateCompany(ctx context.Context, info *co_model.Company, bindUser *sys_model.SysUser) (response TR, err error)
	// UpdateCompany 更新公司信息
	UpdateCompany(ctx context.Context, info *co_model.Company) (response TR, err error)
	// GetCompanyDetail 获取公司详情，包含完整商务联系人电话
	GetCompanyDetail(ctx context.Context, id int64) (response TR, err error)
	// SetNewUserJoinCompanyHook 设置新用户加入公司行为
	SetNewUserJoinCompanyHook(ctx context.Context, state sys_enum.InviteType, invite *sys_model.InviteRes, info *sys_entity.SysInvitePerson, registerInfo *sys_model.SysUser) (bool, error)
}

type ICompanyBase added in v0.11.0 

type ICompanyBase interface {
	// HasCompanyByName 判断名称是否存在
	HasCompanyByName(ctx context.Context, name string, excludeIds ...int64) bool
	// SetCompanyState 设置主体状态
	SetCompanyState(ctx context.Context, companyId int64, companyState co_enum.CompanyState) (bool, error)
	// SetCompanyAdminUser 设置主体的管理员用户
	SetCompanyAdminUser(ctx context.Context, sysUserId, unionMainId int64) (bool, error)
	// FilterUnionMainId 跨主体查询条件过滤
	FilterUnionMainId(ctx context.Context, search *base_model.SearchParams) *base_model.SearchParams
	// SetCommissionRate 设置公司佣金比例
	SetCommissionRate(ctx context.Context, companyId int64, commissionRate int, actionUserId int64) (bool, error)
}

type IConfig added in v0.3.0 

type IConfig interface {
	GetConfig() *co_model.Config
}

type IEmployee 

type IEmployee[TR co_model.IEmployeeRes] interface {
	IEmployeeBase
	SetXDao(dao co_dao.XDao)
	// GetEmployeeById 根据ID获取员工信息
	GetEmployeeById(ctx context.Context, id int64) (response TR, err error)
	// GetEmployeeByName 根据Name获取员工信息
	GetEmployeeByName(ctx context.Context, name string) (response TR, err error)
	// GetEmployeeBySession 获取当前登录的员工信息
	GetEmployeeBySession(ctx context.Context) (response TR, err error)
	// QueryEmployeeList 获取员工列表
	QueryEmployeeList(ctx context.Context, search *base_model.SearchParams) (*base_model.CollectRes[TR], error)
	// CreateEmployee 创建员工信息
	CreateEmployee(ctx context.Context, info *co_model.Employee, bindUser *sys_model.SysUser) (response TR, err error)
	// UpdateEmployee 更新员工信息
	UpdateEmployee(ctx context.Context, info *co_model.UpdateEmployee) (response TR, err error)
	// GetEmployeeDetailById 根据ID获取员工详细信息
	GetEmployeeDetailById(ctx context.Context, id int64) (response TR, err error)
	// GetEmployeeListByRoleId 根据角色ID获取所有所属员工
	GetEmployeeListByRoleId(ctx context.Context, roleId int64) (*base_model.CollectRes[TR], error)
}

type IEmployeeBase added in v0.11.0 

type IEmployeeBase interface {
	// HasEmployeeByName 员工名称是否存在
	HasEmployeeByName(ctx context.Context, name string, unionMainId int64, excludeIds ...int64) bool
	// HasEmployeeByNo 员工工号是否存在
	HasEmployeeByNo(ctx context.Context, no string, unionMainId int64, excludeIds ...int64) bool
	// UpdateEmployeeAvatar 更新员工头像
	UpdateEmployeeAvatar(ctx context.Context, id int64, avatar string) bool
	// DeleteEmployee 删除员工信息
	DeleteEmployee(ctx context.Context, id int64) (bool, error)
	// SetEmployeeState 设置员工状态
	SetEmployeeState(ctx context.Context, id int64, state int) (bool, error)
	// SetCommissionRate 设置员工提成比例
	SetCommissionRate(ctx context.Context, userId int64, commissionRate int, actionUserId int64) (bool, error)
}

type IFdAccount added in v0.1.112 

type IFdAccount[TR co_model.IFdAccountRes] interface {
	IFdAccountBase
	// CreateAccount 创建财务账号
	CreateAccount(ctx context.Context, info co_model.FdAccountRegister, userId int64) (response TR, err error)
	// GetAccountById 根据ID获取财务账号
	GetAccountById(ctx context.Context, id int64) (response TR, err error)
	// HasAccountByName 判断财务账号名是否存在
	HasAccountByName(ctx context.Context, name string) (response TR, err error)
	// QueryAccountListByUserId 获取指定用户的所有财务账号
	QueryAccountListByUserId(ctx context.Context, userId int64) (*base_model.CollectRes[TR], error)
	// GetAccountByUnionUserIdAndCurrencyCode 根据用户union_user_id和货币代码currency_code获取财务账号
	GetAccountByUnionUserIdAndCurrencyCode(ctx context.Context, unionUserId int64, currencyCode string) (response TR, err error)
	// GetAccountByUnionUserIdAndScene 根据union_user_id和业务类型找出财务账号，
	GetAccountByUnionUserIdAndScene(ctx context.Context, unionUserId int64, accountType co_enum.AccountType, sceneType ...co_enum.SceneType) (response TR, err error)
}

type IFdAccountBase added in v0.11.0 

type IFdAccountBase interface {
	// UpdateAccount 修改财务账号
	UpdateAccount(ctx context.Context, accountId int64, info *co_model.UpdateAccount) (bool, error)
	// UpdateAccountIsEnable 修改财务账号状态（是否启用：0禁用 1启用）
	UpdateAccountIsEnable(ctx context.Context, id int64, isEnabled int, userId int64) (bool, error)
	// UpdateAccountLimitState 修改财务账号的限制状态 （0不限制，1限制支出、2限制收入）
	UpdateAccountLimitState(ctx context.Context, id int64, limitState int, userId int64) (bool, error)
	// SetAccountCurrencyCode 设置财务账号货币单位
	SetAccountCurrencyCode(ctx context.Context, accountId int64, currencyCode string, userId int64) (bool, error)
	// UpdateAccountBalance 修改财务账户余额(上下文, 财务账号id, 需要修改的钱数目, 版本, 收支类型)
	UpdateAccountBalance(ctx context.Context, accountId int64, amount int64, version int, inOutType co_enum.FinanceInOutType, sysSessionUserId int64) (int64, error)
	// GetAccountDetailById 根据财务账号id查询账单金额明细统计记录，如果主体id找不到财务账号的时候就创建财务账号
	GetAccountDetailById(ctx context.Context, id int64) (res *co_model.FdAccountDetailRes, err error)
	// CreateAccountDetail 创建财务账单金额明细统计记录
	CreateAccountDetail(ctx context.Context, info *co_model.FdAccountDetail) (res *co_model.FdAccountDetailRes, err error)
	// Increment 收入
	Increment(ctx context.Context, id int64, amount int) (bool, error)
	// Decrement 支出
	Decrement(ctx context.Context, id int64, amount int) (bool, error)
	// SetAccountAllowExceed 设置财务账号是否允许存在负余额
	SetAccountAllowExceed(ctx context.Context, accountId int64, allowExceed int) (bool, error)
	// QueryDetailByUnionUserIdAndSceneType  获取用户指定业务场景的财务账号金额明细统计记录|列表
	QueryDetailByUnionUserIdAndSceneType(ctx context.Context, unionUserId int64, sceneType co_enum.SceneType) (*base_model.CollectRes[co_model.FdAccountDetailRes], error)
	// IncrementFrozenAmount 增加冻结金额
	IncrementFrozenAmount(ctx context.Context, id int64, addAmount int64) (bool, error)
	// DecrementFrozenAmount 减冻结金额
	DecrementFrozenAmount(ctx context.Context, id int64, addAmount int64) (bool, error)
	// CreateCommissionIncome 创建佣金收入
	CreateCommissionIncome(ctx context.Context, info co_model.AccountBillsRegister, goodsTradeAmount int64, remainderCommission int64, clientConfig *co_model.ClientConfig) (ret bool, err error)
}

type IFdAccountBills added in v0.10.1 

type IFdAccountBills[TR co_model.IFdAccountBillsRes] interface {
	IFdAccountBillsBase
	// GetAccountBillsByAccountId  根据财务账号id获取账单
	GetAccountBillsByAccountId(ctx context.Context, accountId int64, pagination *base_model.SearchParams) (*base_model.CollectRes[TR], error)
}

type IFdAccountBillsBase added in v0.11.0 

type IFdAccountBillsBase interface {
	// InstallTradeHook 订阅Hook
	InstallTradeHook(hookKey co_hook.AccountBillHookKey, hookFunc co_hook.AccountBillHookFunc)
	// GetTradeHook 获取Hook
	GetTradeHook() base_hook.BaseHook[co_hook.AccountBillHookKey, co_hook.AccountBillHookFunc]
	// CreateAccountBills 创建财务账单
	CreateAccountBills(ctx context.Context, info co_model.AccountBillsRegister) (bool, error)
	// SetBillsTradeState 设置财务账单交易状态
	SetBillsTradeState(ctx context.Context, id int64, tradeState co_enum.FinanceTradeState) (bool, error)
	//  SetBillsExtJson 设置财务账单扩展信息
	SetBillsExtJson(ctx context.Context, id int64, extJson string) (bool, error)
}

type IFdBankCard added in v0.1.112 

type IFdBankCard[TR co_model.IFdBankCardRes] interface {
	IFdBankCardBase
	// CreateBankCard 添加银行卡账号
	CreateBankCard(ctx context.Context, info co_model.BankCardRegister, createUser *sys_model.SysUser) (response TR, err error)
	// GetBankCardById 根据银行卡id获取银行卡信息
	GetBankCardById(ctx context.Context, id int64) (response TR, err error)
	// GetBankCardByCardNumber 根据银行卡号获取银行卡
	GetBankCardByCardNumber(ctx context.Context, cardNumber string) (response TR, err error)
	// QueryBankCardListByUserId 根据用户id查询银行卡列表
	QueryBankCardListByUserId(ctx context.Context, userId int64) (*base_model.CollectRes[TR], error)
}

type IFdBankCardBase added in v0.11.0 

type IFdBankCardBase interface {
	// UpdateBankCardState 修改银行卡状态 (0禁用 1正常)
	UpdateBankCardState(ctx context.Context, bankCardId int64, state int) (bool, error)
	// DeleteBankCardById 删除银行卡 (标记删除: 标记删除的银行卡号，将记录ID的后6位附加到卡号尾部，用下划线隔开,并修改状态)
	DeleteBankCardById(ctx context.Context, bankCardId int64) (bool, error)
}

type IFdCurrency added in v0.1.112 

type IFdCurrency[TR co_model.IFdCurrencyRes] interface {
	// QueryCurrencyList 获取币种列表
	QueryCurrencyList(ctx context.Context, search *base_model.SearchParams) (*base_model.CollectRes[TR], error)
	// GetCurrencyByCode 根据货币代码查找货币(主键)
	GetCurrencyByCode(ctx context.Context, currencyCode string) (response TR, err error)
	// GetCurrencyByCnName 根据国家查找货币信息
	GetCurrencyByCnName(ctx context.Context, cnName string) (response TR, err error)
}

type IFdInvoice added in v0.1.112 

type IFdInvoice[TR co_model.IFdInvoiceRes] interface {
	IFdInvoiceBase
	// CreateInvoice 添加发票抬头
	CreateInvoice(ctx context.Context, info co_model.FdInvoiceRegister) (response TR, err error)
	// GetFdInvoiceByTaxId 根据纳税识别号获取发票抬头信息
	GetFdInvoiceByTaxId(ctx context.Context, taxId string) (response TR, err error)
	// GetInvoiceById 根据id获取发票
	GetInvoiceById(ctx context.Context, id int64) (response TR, err error)
	// QueryInvoiceList 获取发票抬头列表
	QueryInvoiceList(ctx context.Context, info *base_model.SearchParams, userId int64) (*base_model.CollectRes[TR], error)
}

type IFdInvoiceBase added in v0.11.0 

type IFdInvoiceBase interface {
	// DeletesFdInvoiceById 删除发票抬头
	DeletesFdInvoiceById(ctx context.Context, invoiceId int64) (bool, error)
}

type IFdInvoiceDetail added in v0.1.112 

type IFdInvoiceDetail[TR co_model.IFdInvoiceDetailRes] interface {
	IFdInvoiceDetailBase
	// CreateInvoiceDetail 创建发票详情，相当于创建审核列表，审核是人工审核
	CreateInvoiceDetail(ctx context.Context, info co_model.FdInvoiceDetailRegister) (response TR, err error)
	// GetInvoiceDetailById 根据id获取发票详情
	GetInvoiceDetailById(ctx context.Context, id int64) (response TR, err error)
	// QueryInvoiceDetailListByInvoiceId 根据发票抬头，获取已开票的发票详情列表
	QueryInvoiceDetailListByInvoiceId(ctx context.Context, invoiceId int64) (*base_model.CollectRes[TR], error)
	// QueryInvoiceDetail 根据限定的条件查询发票列表
	QueryInvoiceDetail(ctx context.Context, info *base_model.SearchParams, userId int64, unionMainId int64) (*base_model.CollectRes[TR], error)
}

type IFdInvoiceDetailBase added in v0.11.0 

type IFdInvoiceDetailBase interface {
	// MakeInvoiceDetail 开票
	MakeInvoiceDetail(ctx context.Context, invoiceDetailId int64, makeInvoiceDetail co_model.FdMakeInvoiceDetail) (res bool, err error)
	// AuditInvoiceDetail 审核发票
	AuditInvoiceDetail(ctx context.Context, invoiceDetailId int64, auditInfo co_model.FdInvoiceAuditInfo) (bool, error)
	// DeleteInvoiceDetail 标记删除发票详情
	DeleteInvoiceDetail(ctx context.Context, id int64) (bool, error)
}

type IFdRecharge added in v0.10.1 

type IFdRecharge[TR co_model.IFdRechargeRes] interface {
	IFdRechargeBase
	// GetAccountRechargeById 根据充值记录id获取充值记录
	GetAccountRechargeById(ctx context.Context, id int64) (TR, error)
	// AccountRecharge 充值
	AccountRecharge(ctx context.Context, info *co_model.FdRecharge, createUser *sys_model.SysUser) (TR, error)
	// QueryAccountRecharge 获取财务账号充值记录|列表
	QueryAccountRecharge(ctx context.Context, search *base_model.SearchParams) (*base_model.CollectRes[TR], error)
}

type IFdRechargeBase added in v0.11.0 

type IFdRechargeBase interface {
	// SetAccountRechargeAudit 设置充值记录审核
	SetAccountRechargeAudit(ctx context.Context, id int64, state sys_enum.AuditAction, reply string) (bool, error)
}

type IModuleBase added in v0.11.0 

type IModuleBase interface {
	IConfig
	My() IMy
	SetI18n(i18n *gi18n.Manager) error
	T(ctx context.Context, content string) string
	Tf(ctx context.Context, format string, values ...interface{}) string
	Dao() *co_dao.XDao
	GetICompany() ICompanyBase
	GetITeam() ITeamBase
	GetIEmployee() IEmployeeBase
	GetIFdAccount() IFdAccountBase
	GetIFdAccountBills() IFdAccountBillsBase
	GetIFdBankCard() IFdBankCardBase
	GetIFdInvoice() IFdInvoiceBase
	GetIFdInvoiceDetail() IFdInvoiceDetailBase
	GetIFdRecharge() IFdRechargeBase
}

type IModules 

type IModules[
	ITCompanyRes co_model.ICompanyRes,
	ITEmployeeRes co_model.IEmployeeRes,
	ITTeamRes co_model.ITeamRes,
	ITFdAccountRes co_model.IFdAccountRes,
	ITFdAccountBillRes co_model.IFdAccountBillsRes,
	ITFdBankCardRes co_model.IFdBankCardRes,
	ITFdInvoiceRes co_model.IFdInvoiceRes,
	ITFdInvoiceDetailRes co_model.IFdInvoiceDetailRes,
	ITFdRechargeRes co_model.IFdRechargeRes,
] interface {
	IModuleBase
	IConfig
	Company() ICompany[ITCompanyRes]
	Team() ITeam[ITTeamRes]
	Employee() IEmployee[ITEmployeeRes]
	Account() IFdAccount[ITFdAccountRes]
	AccountBills() IFdAccountBills[ITFdAccountBillRes]
	BankCard() IFdBankCard[ITFdBankCardRes]
	Invoice() IFdInvoice[ITFdInvoiceRes]
	InvoiceDetail() IFdInvoiceDetail[ITFdInvoiceDetailRes]
	Recharge() IFdRecharge[ITFdRechargeRes]
}

type IMy 

type IMy interface {
	// GetProfile 获取当前员工及用户信息
	GetProfile(ctx context.Context) (*co_model.MyProfileRes, error)
	// GetCompany 获取当前公司信息
	GetCompany(ctx context.Context) (*co_model.MyCompanyRes, error)
	// GetTeams 获取当前员工团队信息
	GetTeams(ctx context.Context) (res co_model.MyTeamListRes, err error)
	// SetMyMobile 设置我的手机号
	SetMyMobile(ctx context.Context, newMobile string, captcha string, password string) (bool, error)
	// SetMyMail 设置我的邮箱
	SetMyMail(ctx context.Context, oldMail string, newMail string, captcha string, password string) (bool, error)
	// SetMyAvatar 设置我的头像
	SetMyAvatar(ctx context.Context, imageId int64) (bool, error)
	// GetAccountBills 我的账单|列表
	GetAccountBills(ctx context.Context, pagination *base_model.SearchParams) (*co_model.MyAccountBillRes, error)
	// GetAccounts 获取我的财务账号|列表
	GetAccounts(ctx context.Context) (*co_model.FdAccountListRes, error)
	// GetBankCards 获取我的银行卡｜列表
	GetBankCards(ctx context.Context) (*co_model.FdBankCardListRes, error)
	// GetInvoices 获取我的发票抬头|列表
	GetInvoices(ctx context.Context) (*co_model.FdInvoiceListRes, error)
	// UpdateAccount  修改我的财务账号
	UpdateAccount(ctx context.Context, accountId int64, info *co_model.UpdateAccount) (api_v1.BoolRes, error)
	// GetMyCompanyPermissionList 获取我的公司权限列表
	GetMyCompanyPermissionList(ctx context.Context, permissionType *int) (*sys_model.MyPermissionListRes, error)
}

type ITeam 

type ITeam[TR co_model.ITeamRes] interface {
	ITeamBase
	SetXDao(dao co_dao.XDao)
	// GetTeamById 根据ID获取公司团队信息
	GetTeamById(ctx context.Context, id int64) (TR, error)
	// GetTeamByName 根据Name获取团队信息
	GetTeamByName(ctx context.Context, name string) (TR, error)
	// QueryTeamList 查询团队
	QueryTeamList(ctx context.Context, search *base_model.SearchParams) (*base_model.CollectRes[TR], error)
	// CreateTeam 创建团队或小组|信息
	CreateTeam(ctx context.Context, info *co_model.Team) (TR, error)
	// UpdateTeam 更新团队或小组|信息
	UpdateTeam(ctx context.Context, info *co_model.Team) (TR, error)
	// QueryTeamListByEmployee 根据员工查询团队
	QueryTeamListByEmployee(ctx context.Context, employeeId int64, unionMainId int64) (*base_model.CollectRes[TR], error)
}

type ITeamBase added in v0.11.0 

type ITeamBase interface {
	// HasTeamByName 团队名称是否存在
	HasTeamByName(ctx context.Context, name string, unionMainId int64, parentId int64, excludeIds ...int64) bool
	// QueryTeamMemberList 查询所有团队成员记录
	QueryTeamMemberList(ctx context.Context, search *base_model.SearchParams, isExport ...bool) (*base_model.CollectRes[*co_model.TeamMemberRes], error)
	// SetTeamMember 设置团队队员或小组组员
	SetTeamMember(ctx context.Context, teamId int64, employeeIds []int64) (api_v1.BoolRes, error)
	// RemoveTeamMember  移除团队队员或小组组员
	RemoveTeamMember(ctx context.Context, teamId int64, employeeIds []int64) (api_v1.BoolRes, error)
	// SetTeamOwner 设置团队或小组的负责人
	SetTeamOwner(ctx context.Context, teamId int64, employeeId int64) (api_v1.BoolRes, error)
	// SetTeamCaptain 设置团队队长或小组组长
	SetTeamCaptain(ctx context.Context, teamId int64, employeeId int64) (api_v1.BoolRes, error)
	// DeleteTeam 删除团队
	DeleteTeam(ctx context.Context, teamId int64) (api_v1.BoolRes, error)
	// DeleteTeamMemberByEmployee 删除某个员工的所有团队成员记录
	DeleteTeamMemberByEmployee(ctx context.Context, employeeId int64) (bool, error)
	// GetEmployeeListByTeamId 获取团队成员|列表
	GetEmployeeListByTeamId(ctx context.Context, teamId int64) (*base_model.CollectRes[co_model.IEmployeeRes], error)
	// GetTeamInviteCode 获取团队邀约码
	GetTeamInviteCode(ctx context.Context, teamId, userId int64) (*co_model.TeamInviteCodeRes, error)
	// JoinTeamByInviteCode 扫码邀约码进入团队
	JoinTeamByInviteCode(ctx context.Context, inviteCode string, userId int64) (bool, error)
}

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.