service

type APITokenService struct {
	// contains filtered or unexported fields
}

type AccessibleQueue struct {
	QueueID   uint   `json:"queue_id"`
	QueueName string `json:"queue_name"`
	GroupID   uint   `json:"group_id"`
	GroupName string `json:"group_name"`
}

type AgentInput struct {
	Login     string `json:"login" form:"login"`
	FirstName string `json:"first_name" form:"first_name"`
	LastName  string `json:"last_name" form:"last_name"`
	Email     string `json:"email,omitempty" form:"email"`
	GroupIDs  []int  `json:"group_ids,omitempty" form:"group_ids"`
}

type AgentInputWithGroupIDs struct {
	Login     string `json:"login"`
	FirstName string `json:"first_name"`
	LastName  string `json:"last_name"`
	Email     string `json:"email"`
	GroupIDs  []int  `json:"group_ids"`
}

type BusinessHoursInput struct {
	Name        string `json:"name" form:"name"`                   // Configuration name
	Timezone    string `json:"timezone,omitempty" form:"timezone"` // e.g., "America/New_York"
	Description string `json:"description,omitempty" form:"description"`
	// GroupID is the permission group (calendar.group_id) whose members may use
	// the calendar. 0 selects the default "users" group. In a WizardRequest it is
	// a team reference resolved like QueueInput.GroupID.
	GroupID int `json:"group_id,omitempty" form:"group_id"`
}

type CreateTicketInput struct {
	Title                         string
	QueueID                       int
	PriorityID                    int
	StateID                       int
	UserID                        int
	Body                          string // optional initial article body
	ArticleSubject                string
	ArticleSenderTypeID           int
	ArticleTypeID                 int
	ArticleIsVisibleForCustomer   *bool
	ArticleMimeType               string
	ArticleCharset                string
	ArticleCommunicationChannelID int
	PendingUntil                  int // unix seconds when pending should elapse; 0 = none
	TypeID                        int // optional ticket type to set on create (0 = none)
	CustomerID                    string
	CustomerUserID                string
}

type CreatedEntity struct {
	Kind string `json:"kind"`
	Name string `json:"name"`
	ID   int    `json:"id,omitempty"`
}

type CustomerCompany struct {
	Name     string `json:"name"`
	Street   string `json:"street"`
	Zip      string `json:"zip"`
	City     string `json:"city"`
	Country  string `json:"country"`
	Url      string `json:"url"`
	Comments string `json:"comments"`
}

type CustomerConfiguration struct {
	Customer        *CustomerCompany         `json:"customer"`
	Groups          []GroupWithID            `json:"groups"`
	Queues          []QueueWithGroup         `json:"queues"`
	Agents          []AgentInputWithGroupIDs `json:"agents"`
	MailAccounts    []MailAccountInput       `json:"mail_accounts"`
	Services        []string                 `json:"services"`
	SLAs            []SLAInput               `json:"slas"`
	PortalUsers     []PortalUserInfo         `json:"portal_users"`
	CannedResponses []string                 `json:"canned_responses"`
	BusinessHours   []BusinessHoursInput     `json:"business_hours"`
	EmailTransport  *EmailTransportInput     `json:"mail_transport"`
}

type CustomerInput struct {
	CustomerID string            `json:"customer_id" form:"customer_id"`
	Name       string            `json:"name" form:"name"`
	Fields     map[string]string `json:"fields,omitempty" form:"fields"`
}

type CustomerPreferencesService struct {
	// contains filtered or unexported fields
}

type CustomerUserInput struct {
	Login     string `json:"login" form:"login"`
	Email     string `json:"email" form:"email"`
	FirstName string `json:"first_name" form:"first_name"`
	LastName  string `json:"last_name" form:"last_name"`
	Title     string `json:"title,omitempty" form:"title"`
	Phone     string `json:"phone,omitempty" form:"phone"`
	Mobile    string `json:"mobile,omitempty" form:"mobile"`
}

type EmailTransportInput struct {
	Host     string `json:"host" form:"host"`                     // SMTP server host (required)
	Port     int    `json:"port" form:"port"`                     // 25, 465, 587 etc.
	User     string `json:"user,omitempty" form:"user"`           // Username for auth
	Password string `json:"password,omitempty" form:"password"`   // Password (stored securely)
	AuthType string `json:"auth_type,omitempty" form:"auth_type"` // plain, login, crammd5
	TLS      bool   `json:"tls,omitempty" form:"tls"`             // Enable TLS
	TLSMode  string `json:"tls_mode,omitempty" form:"tls_mode"`   // none, starttls, smtps
	From     string `json:"from,omitempty" form:"from"`           // Default from address
	FromName string `json:"from_name,omitempty" form:"from_name"` // Display name for sender
}

type GroupInput struct {
	Name     string `json:"name" form:"name"`
	Comments string `json:"comments,omitempty" form:"comments"`
}

type GroupPermissions struct {
	Group       *models.Group
	Permissions map[string]bool
}

type GroupUserMatrix struct {
	Group *models.Group
	Users []*UserPermissions
}

type GroupWithID struct {
	Name string `json:"name"`
	ID   int    `json:"id"`
}

type LookupService struct {
	// contains filtered or unexported fields
}

type MailAccountInput struct {
	Login              string `json:"login" form:"login"`                                           // mailbox username / email
	Password           string `json:"password" form:"password"`                                     // mailbox password (stored as-is, matching existing admin UI)
	Host               string `json:"host" form:"host"`                                             // IMAP/POP3 host
	AccountType        string `json:"account_type" form:"account_type"`                             // IMAP, IMAPTLS, IMAPS, POP3, POP3S
	QueueID            int    `json:"queue_id" form:"queue_id"`                                     // existing queue fetched mail lands in
	CreateQueueName    string `json:"create_queue_name,omitempty" form:"create_queue_name"`         // if set + QueueID==0, create a new queue
	CreateQueueGroupID int    `json:"create_queue_group_id,omitempty" form:"create_queue_group_id"` // owning team for a created queue
	// CreateQueueUseNewTeam: own the created queue with the team created earlier
	// in this onboarding wizard (no id yet at request time).
	CreateQueueUseNewTeam bool   `json:"create_queue_use_new_team,omitempty" form:"create_queue_use_new_team"`
	IMAPFolder            string `json:"imap_folder,omitempty" form:"imap_folder"`
	Trusted               bool   `json:"trusted,omitempty" form:"trusted"`
	Comments              string `json:"comments,omitempty" form:"comments"`
}

type OnboardCustomerRequest struct {
	CustomerID string              `json:"customer_id" form:"customer_id"`
	Name       string              `json:"name" form:"name"`
	Street     string              `json:"street,omitempty" form:"street"`
	City       string              `json:"city,omitempty" form:"city"`
	ZIP        string              `json:"zip,omitempty" form:"zip"`
	Country    string              `json:"country,omitempty" form:"country"`
	URL        string              `json:"url,omitempty" form:"url"`
	Comments   string              `json:"comments,omitempty" form:"comments"`
	Users      []CustomerUserInput `json:"users,omitempty" form:"users"`
	// ManagingGroupIDs: agent teams granted read-write access to this company
	// (OTRS group_customer) — i.e. which teams manage this customer.
	ManagingGroupIDs []int `json:"managing_group_ids,omitempty" form:"managing_group_ids"`
	// CreateManagingGroupName: if set, create a new team with this name (e.g.
	// derived from the customer id) and add it to the managing teams.
	CreateManagingGroupName string `json:"create_managing_group_name,omitempty" form:"create_managing_group_name"`
	// Optional Service/SLA mapping (OTRS service → service_sla → service_customer_user).
	ServiceName string `json:"service_name,omitempty" form:"service_name"`
	SLAID       int    `json:"sla_id,omitempty" form:"sla_id"`
	// Optional inbound mailbox (OTRS mail_account) wired to a destination queue.
	MailAccount *MailAccountInput `json:"mail_account,omitempty" form:"mail_account"`
}

type OnboardCustomerResult struct {
	Success          bool            `json:"success"`
	CustomerID       string          `json:"customer_id"`
	CompanyName      string          `json:"company_name"`
	UsersCreated     []OnboardedUser `json:"users_created"`
	ManagingGroupIDs []int           `json:"managing_group_ids,omitempty"`
	ServiceID        int             `json:"service_id,omitempty"`
	ServiceName      string          `json:"service_name,omitempty"`
	SLALinked        bool            `json:"sla_linked,omitempty"`
	CreatedGroupID   int             `json:"created_group_id,omitempty"`
	CreatedGroupName string          `json:"created_group_name,omitempty"`
	MailAccountID    int             `json:"mail_account_id,omitempty"`
	CreatedQueueID   int             `json:"created_queue_id,omitempty"`
	Error            string          `json:"error,omitempty"`
}

type OnboardedUser struct {
	Login    string `json:"login"`
	Email    string `json:"email"`
	Password string `json:"password,omitempty"`
}

type PermissionMatrix struct {
	User   *models.User
	Groups []*GroupPermissions
}

type PermissionService struct {
	// contains filtered or unexported fields
}

type PluginSetupTask struct {
	Plugin      string `json:"plugin"`
	ID          string `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Icon        string `json:"icon,omitempty"`
	Category    string `json:"category"`
	Handler     string `json:"handler"`
}

type PortalUserInfo struct {
	Login     string `json:"login"`
	Email     string `json:"email"`
	FirstName string `json:"first_name"`
	LastName  string `json:"last_name"`
	Phone     string `json:"phone,omitempty"`
	Title     string `json:"title,omitempty"`
}

type QueueAccessService struct {
	// contains filtered or unexported fields
}

type QueueInput struct {
	Name     string `json:"name" form:"name"`
	GroupID  int    `json:"group_id,omitempty" form:"group_id"`
	Comments string `json:"comments,omitempty" form:"comments"`
}

type QueueWithGroup struct {
	Name    string `json:"name"`
	GroupID int    `json:"group_id"`
}

type ResponseTemplateInput struct {
	Name        string   `json:"name" form:"name"`                           // Display name (required)
	Shortcut    string   `json:"shortcut,omitempty" form:"shortcut"`         // Quick access code
	Category    string   `json:"category,omitempty" form:"category"`         // For organization
	Content     string   `json:"content" form:"content"`                     // Response body (required)
	ContentType string   `json:"content_type,omitempty" form:"content_type"` // text/plain or text/html
	Tags        []string `json:"tags,omitempty" form:"tags"`                 // Search tags
}

type SLAInput struct {
	Name              string `json:"name" form:"name"`
	FirstResponseTime int    `json:"first_response_time" form:"first_response_time"`
	SolutionTime      int    `json:"solution_time" form:"solution_time"`
}

type SessionService struct {
	// contains filtered or unexported fields
}

type SetupAssistantService struct {
	// contains filtered or unexported fields
}

type SimpleAttachment struct {
	ID          uint      `json:"id"`
	MessageID   uint      `json:"message_id"`
	Filename    string    `json:"filename"`
	ContentType string    `json:"content_type"`
	Size        int64     `json:"size"`
	URL         string    `json:"url"` // Download URL for the attachment
	CreatedAt   time.Time `json:"created_at"`
}

type SimpleTicketMessage struct {
	ID           uint                `json:"id"`
	TicketID     uint                `json:"ticket_id"`
	Body         string              `json:"body"`
	Subject      string              `json:"subject"`
	ContentType  string              `json:"content_type"`
	CreatedBy    uint                `json:"created_by"`
	AuthorName   string              `json:"author_name"`
	AuthorEmail  string              `json:"author_email"`
	AuthorType   string              `json:"author_type"` // "Customer", "Agent", "System"
	SenderTypeID int                 `json:"sender_type_id"`
	SenderColor  string              `json:"sender_color,omitempty"` // Hex color from article_color
	IsPublic     bool                `json:"is_public"`
	IsInternal   bool                `json:"is_internal"`
	CreatedAt    time.Time           `json:"created_at"`
	Attachments  []*SimpleAttachment `json:"attachments,omitempty"`
}

type SimpleTicketService struct {
	// contains filtered or unexported fields
}

type SystemSnapshot struct {
	Groups         int  `json:"groups"`
	Queues         int  `json:"queues"`
	Agents         int  `json:"agents"`
	Customers      int  `json:"customers"`
	SLAs           int  `json:"slas"`
	Roles          int  `json:"roles"`
	SetupCompleted bool `json:"setup_completed"`
}

type ThumbnailOptions struct {
	Width   int
	Height  int
	Quality int    // JPEG quality 1-100
	Format  string // "jpeg" or "png"
}

type ThumbnailService struct {
	// contains filtered or unexported fields
}

type TicketService interface {
	Create(ctx context.Context, req CreateTicketInput) (*models.Ticket, error)
}

type TicketServiceOption func(*ticketService)

type TicketTemplateService struct {
	// contains filtered or unexported fields
}

type UserPermissions struct {
	User        *models.User
	Permissions map[string]bool
}

type WizardRequest struct {
	OrgType            string                  `json:"org_type" form:"org_type"`
	Groups             []GroupInput            `json:"groups" form:"groups"`
	Queues             []QueueInput            `json:"queues" form:"queues"`
	Agents             []AgentInput            `json:"agents" form:"agents"`
	CustomerCompanies  []CustomerInput         `json:"customer_companies" form:"customer_companies"`
	SLAs               []SLAInput              `json:"slas" form:"slas"`
	ResponseTemplates  []ResponseTemplateInput `json:"response_templates,omitempty" form:"response_templates"`
	BusinessHours      []BusinessHoursInput    `json:"business_hours,omitempty" form:"business_hours"`
	MailTransport      *EmailTransportInput    `json:"mail_transport,omitempty" form:"mail_transport"`
	ExistingCustomerID string                  `json:"existing_customer_id,omitempty" form:"existing_customer_id"`
	CreateBy           int                     `json:"-" form:"-"`
}

type WizardResult struct {
	Success bool            `json:"success"`
	Created []CreatedEntity `json:"created,omitempty"`
	Error   string          `json:"error,omitempty"`
}