my

type AvailableFlow struct {
	FlowID       string            `json:"flowId"`
	FlowCode     string            `json:"flowCode"`
	FlowName     string            `json:"flowName"`
	FlowIcon     *string           `json:"flowIcon,omitempty"`
	Description  *string           `json:"description,omitempty"`
	Labels       map[string]string `json:"labels,omitempty"`
	CategoryID   string            `json:"categoryId"`
	CategoryName string            `json:"categoryName"`
}

type CCRecord struct {
	CCRecordID    string            `json:"ccRecordId"`
	InstanceID    string            `json:"instanceId"`
	InstanceTitle string            `json:"instanceTitle"`
	InstanceNo    string            `json:"instanceNo"`
	FlowName      string            `json:"flowName"`
	FlowIcon      *string           `json:"flowIcon,omitempty"`
	Applicant     approval.UserInfo `json:"applicant"`
	NodeName      *string           `json:"nodeName,omitempty"`
	IsRead        bool              `json:"isRead"`
	CreatedAt     timex.DateTime    `json:"createdAt"`
}

type CompletedTask struct {
	TaskID        string            `json:"taskId"`
	InstanceID    string            `json:"instanceId"`
	InstanceTitle string            `json:"instanceTitle"`
	InstanceNo    string            `json:"instanceNo"`
	FlowName      string            `json:"flowName"`
	FlowIcon      *string           `json:"flowIcon,omitempty"`
	Applicant     approval.UserInfo `json:"applicant"`
	NodeName      string            `json:"nodeName"`
	Status        string            `json:"status"`
	FinishedAt    *timex.DateTime   `json:"finishedAt,omitempty"`
}

type InitiatedInstance struct {
	InstanceID      string          `json:"instanceId"`
	InstanceNo      string          `json:"instanceNo"`
	Title           string          `json:"title"`
	FlowName        string          `json:"flowName"`
	FlowIcon        *string         `json:"flowIcon,omitempty"`
	Status          string          `json:"status"`
	CurrentNodeName *string         `json:"currentNodeName,omitempty"`
	CreatedAt       timex.DateTime  `json:"createdAt"`
	FinishedAt      *timex.DateTime `json:"finishedAt,omitempty"`
}

type InstanceDetail struct {
	Instance         InstanceInfo               `json:"instance"`
	FormSchema       json.RawMessage            `json:"formSchema,omitempty"`
	Timeline         []approval.TimelineEntry   `json:"timeline"`
	FlowGraph        approval.InstanceFlowGraph `json:"flowGraph"`
	AvailableActions []string                   `json:"availableActions"`
	// FieldPermissions is the viewer-scoped field interactivity projection,
	// materialized for every top-level form field — the client applies it
	// verbatim (no default resolution). Instance.FormData is already stripped
	// of the fields this viewer may not see.
	FieldPermissions map[string]approval.Permission `json:"fieldPermissions,omitempty"`
	// MyTask is the viewer's own actionable context: the pending task
	// process_task should target plus the node-level configuration the client
	// needs to build the action UI without re-deriving engine semantics. Nil
	// when the viewer holds no pending task on this instance.
	MyTask *ViewerTask `json:"myTask,omitempty"`
}

type InstanceInfo struct {
	InstanceID      string            `json:"instanceId"`
	InstanceNo      string            `json:"instanceNo"`
	Title           string            `json:"title"`
	FlowID          string            `json:"flowId"`
	FlowCode        string            `json:"flowCode"`
	FlowName        string            `json:"flowName"`
	FlowIcon        *string           `json:"flowIcon,omitempty"`
	Labels          map[string]string `json:"labels,omitempty"`
	Applicant       approval.UserInfo `json:"applicant"`
	Status          string            `json:"status"`
	CurrentNodeID   *string           `json:"currentNodeId,omitempty"`
	CurrentNodeName *string           `json:"currentNodeName,omitempty"`
	BusinessRef     *string           `json:"businessRef,omitempty"`
	FormData        map[string]any    `json:"formData,omitempty"`
	CreatedAt       timex.DateTime    `json:"createdAt"`
	FinishedAt      *timex.DateTime   `json:"finishedAt,omitempty"`
}

type PendingCounts struct {
	PendingTaskCount int `json:"pendingTaskCount"`
	UnreadCCCount    int `json:"unreadCcCount"`
}

type PendingTask struct {
	TaskID        string            `json:"taskId"`
	InstanceID    string            `json:"instanceId"`
	InstanceTitle string            `json:"instanceTitle"`
	InstanceNo    string            `json:"instanceNo"`
	FlowName      string            `json:"flowName"`
	FlowIcon      *string           `json:"flowIcon,omitempty"`
	Applicant     approval.UserInfo `json:"applicant"`
	NodeName      string            `json:"nodeName"`
	CreatedAt     timex.DateTime    `json:"createdAt"`
	Deadline      *timex.DateTime   `json:"deadline,omitempty"`
	IsTimeout     bool              `json:"isTimeout"`
}

type RemovableAssignee struct {
	TaskID   string            `json:"taskId"`
	Assignee approval.UserInfo `json:"assignee"`
	// Status is the peer task's status verbatim (pending / waiting).
	Status string `json:"status"`
}

type RollbackTarget struct {
	NodeID string `json:"nodeId"`
	Name   string `json:"name"`
}

type StartForm struct {
	FlowID      string          `json:"flowId"`
	FlowCode    string          `json:"flowCode"`
	FlowName    string          `json:"flowName"`
	FlowIcon    *string         `json:"flowIcon,omitempty"`
	Description *string         `json:"description,omitempty"`
	VersionID   string          `json:"versionId"`
	Version     int             `json:"version"`
	FormSchema  json.RawMessage `json:"formSchema,omitempty"`
}

type ViewerTask struct {
	TaskID string `json:"taskId"`
	NodeID string `json:"nodeId"`
	// IsOpinionRequired mirrors the node config: approve/reject must carry a
	// non-empty opinion when set.
	IsOpinionRequired bool `json:"isOpinionRequired"`
	// AddAssigneeTypes lists the positions the node allows for dynamic
	// assignee addition; empty when adding assignees is not allowed.
	AddAssigneeTypes []approval.AddAssigneeType `json:"addAssigneeTypes,omitempty"`
	// RollbackTargets are the valid rollback destinations, resolved from the
	// node's rollback config and the instance's visit trail exactly like the
	// rollback command validates them; empty when rollback is not allowed.
	RollbackTargets []RollbackTarget `json:"rollbackTargets,omitempty"`
	// RemovableAssignees are the peer tasks the viewer may remove, resolved
	// exactly like the remove-assignee command authorizes them: still-actionable
	// peers of the viewer's own visit, excluding the viewer; empty when the
	// node disallows removal.
	RemovableAssignees []RemovableAssignee `json:"removableAssignees,omitempty"`
}