qiyuesuo-client/types.go

package qiyuesuosdk

import "time"

// OrgCertParams 机构法人认证页参数；OpenCompanyID 通常等于平台 tenant_id。
type OrgCertParams struct {
	CompanyName   string
	Charger       string
	Mobile        string
	OpenCompanyID string
}

// CompanyAuthStatus 法人单位认证状态查询结果。
type CompanyAuthStatus struct {
	CompanyName string            `json:"companyName"`
	Mobile      string            `json:"mobile"`
	RegisterNo  string            `json:"registerNo"`
	BizID       flexStringID      `json:"bizId"`
	AuthEndTime string            `json:"authEndTime"`
	Result      CompanyAuthResult `json:"result"`
}

func (s *CompanyAuthStatus) CompanyID() string {
	if s == nil {
		return ""
	}
	return s.BizID.String()
}

// CompanyAuthResult 认证审核结果。
type CompanyAuthResult struct {
	Status string `json:"status"`
	Reason string `json:"reason"`
}

// AuthPassed 是否认证成功。
func (s *CompanyAuthStatus) AuthPassed() bool {
	return s.Result.Status == "AUTH_PASSED"
}

// CreateUserParams 在契约锁创建内部用户（医生等需个人签名的成员）。
type CreateUserParams struct {
	Name       string
	OpenUserID string
	AccountNo  string
	Password   string
	Mobile     string
}

// UserLocateParams 定位契约锁个人用户；查询优先级与开放平台一致：用户 id > 手机号 > 证件号 > 三方用户 id > 登录账号。
type UserLocateParams struct {
	UserID     string
	Mobile     string
	CardNo     string
	OpenUserID string
	AccountNo  string
}

// UserInfo 契约锁用户基本信息。
type UserInfo struct {
	ID     string
	BizID  string
	Name   string
	Mobile string
	Status string
}

func (u *UserInfo) OpenUserID() string {
	if u == nil {
		return ""
	}
	if u.BizID != "" {
		return u.BizID
	}
	return u.ID
}

// CompanySealSpec 企业公章关键字签署位置。
type CompanySealSpec struct {
	CompanyName  string
	Keyword      string
	OffsetX      string
	OffsetY      string
	RotateDegree int64
	Page         string // 空则不限页；双章场景可设 "1"
}

// PersonalSealSpec 个人签名关键字签署位置。
type PersonalSealSpec struct {
	OpenUserID string
	Keyword    string
}

// SignDocumentRequest PDF 静默签章请求（机构章 + 可选个人签）。
type SignDocumentRequest struct {
	PDF           []byte
	Subject       string
	ProcessID     string // 空则使用 Client 初始化时的 SignDefaults
	Launcher      string
	CompanySeal   CompanySealSpec
	PersonalSeals []PersonalSealSpec
}

// SignDualCompanyRequest 双企业公章签署（如账单合同甲乙双方）。
type SignDualCompanyRequest struct {
	PDF          []byte
	Subject      string
	ProcessID    string
	Launcher     string
	CompanySeals []CompanySealSpec
}

// Callback request / event types — 与契约锁开放平台事件名一致。

const (
	EventCompanyAuthSuccess      = "COMPANY_AUTH_SUCCESS"
	EventCompanySealAuthSuccess  = "COMPANY_SIGN_SILENT_AUTH"
	EventUserAuthSuccess         = "USER_AUTH_SUCCESS"
	EventPersonalSealAuthSuccess = "PERSONAL_SIGN_SILENT_AUTH"
	EventCallbackCheck           = "CALLBACK_CHECK"
)

// CallbackRequest 契约锁 HTTP 回调原始载荷。
type CallbackRequest struct {
	Signature string `json:"signature"`
	Timestamp string `json:"timestamp"`
	Nonce     string `json:"nonce"`
	Encrypted string `json:"encrypted"`
}

// CallbackEvent 解密验签后的回调事件。
type CallbackEvent struct {
	Type EventType
	Data any
}

// EventType 回调事件类型。
type EventType string

// CompanyCertificationData 机构认证成功回调。
type CompanyCertificationData struct {
	CompanyID      string `json:"companyId"`
	CompanyName    string `json:"companyName"`
	OpenCompanyID  string `json:"openCompanyId"`
	RegisterNo     string `json:"registerNo"`
	ApplicantName  string `json:"applicantName"`
	ApplicantPhone string `json:"applicantPhone"`
	AuthEndTime    string `json:"authEndTime"`
	CallbackTime   string `json:"callbackTime"`
}

// CompanySealAuthData 机构印章静默授权回调。
type CompanySealAuthData struct {
	UserName        string `json:"userName"`
	UserMobile      string `json:"userMobile"`
	AuthTime        string `json:"authTime"`
	Status          string `json:"status"`
	AuthCompanyID   string `json:"authCompanyId"`
	AuthCompanyName string `json:"authCompanyName"`
	CallbackTime    string `json:"callbackTime"`
}

// PersonalSealAuthData 个人签名静默授权回调。
type PersonalSealAuthData struct {
	UserName     string `json:"userName"`
	UserMobile   string `json:"userMobile"`
	UserEmail    string `json:"userEmail"`
	UserID       string `json:"userId"`
	OpenUserID   string `json:"openUserId"`
	AuthTime     string `json:"authTime"`
	Status       string `json:"status"`
	CallbackTime string `json:"callbackTime"`
}

// ApplyCompanyParams 个人静默签授权目标法人单位（applyCompany）。
// 定位优先级与机构章一致：契约锁公司 id > openCompanyId > 名称/信用代码。
type ApplyCompanyParams struct {
	CompanyID     string // 契约锁法人单位 id（tenant_esigns.qys_company_id）
	OpenCompanyID string // 三方 openCompanyId（新系统多为 tenant_id；旧系统可能为 org_id）
	Name          string
	RegisterNo    string
}

// AuthRecord 静默授权记录摘要。
type AuthRecord struct {
	Status                    string
	StartTime                 string
	EndTime                   string
	AuthScope                 string
	ApplyCompanyID            string
	ApplyCompanyOpenCompanyID string
	ApplyCompanyName          string
	ApplyCompanyRegisterNo    string
}

// DefaultPersonalAuthDuration 个人静默授权默认时长（旧系统 10 个月，避免跨年重叠）。
const DefaultPersonalAuthDuration = 10 * 30 * 24 * time.Hour

// DefaultCompanySealAuthDuration 机构印章静默授权默认时长（旧系统 1 年）。
const DefaultCompanySealAuthDuration = 365 * 24 * time.Hour