admin

type APIKeyFormData struct {
	IsEdit           bool
	APIKey           *APIKeyInfo
	PermissionGroups []PermissionGroup
	Errors           map[string]string
	FormValues       map[string]string
	GeneratedKey     string   // Only set after creation to show key once
	GeneratedPerms   []string // Permissions of the generated key
}

type APIKeyInfo struct {
	ID          int64
	Name        string
	KeyPrefix   string
	Permissions string // Raw JSON string for checking contains
	IsActive    bool
	CreatedAt   string
	LastUsedAt  string // Empty if never used
	ExpiresAt   string // Date-only format for input field, empty if no expiration
	HasLastUsed bool
	HasExpires  bool
}

type APIKeyListItem struct {
	ID          int64
	Name        string
	KeyPrefix   string
	Permissions []string // Pre-parsed from JSON
	IsActive    bool
	IsExpired   bool   // Pre-computed: active but past expiration
	LastUsedAt  string // Pre-formatted date string, empty if never used
	ExpiresAt   string // Pre-formatted date string, empty if no expiration
}

type APIKeysListData struct {
	APIKeys    []APIKeyListItem
	TotalKeys  int64
	Pagination PaginationData
}

type ActivityItem struct {
	Category  string
	Level     string
	Message   string
	UserName  string
	TimeAgo   string
	CreatedAt string
}

type Breadcrumb struct {
	Label  string
	URL    string
	Active bool
}

type CacheItemView struct {
	Name     string
	Kind     string // "config", "sitemap", "menu", "language", "translation", "page", "general"
	Items    int
	Hits     int64
	Misses   int64
	HitRate  float64
	CachedAt string // Pre-formatted, empty if not cached (sitemap)
	Size     int    // Size in bytes (sitemap)
}

type CacheStatsView struct {
	Hits    int64
	Misses  int64
	Items   int
	HitRate float64
}

type CacheStatsViewData struct {
	Caches      []CacheItemView
	TotalStats  CacheStatsView
	IsRedis     bool
	IsFallback  bool
	RedisURL    string
	HealthError string
	ResetAt     string // Pre-formatted reset time
}

type CategoriesListData struct {
	Categories []CategoryListItem
	TotalCount int64
}

type CategoryFormData struct {
	IsEdit           bool
	Category         *CategoryItem
	AllCategories    []CategoryListItem
	AllLanguages     []LanguageOption
	Language         *LanguageOption
	Translations     []CategoryTranslation
	MissingLanguages []LanguageOption
	FormValues       map[string]string
	Errors           map[string]string
}

type CategoryItem struct {
	ID           int64
	Name         string
	Slug         string
	Description  string
	LanguageCode string
	ParentID     int64
	HasParent    bool
	Position     int
}

type CategoryListItem struct {
	ID           int64
	Name         string
	Slug         string
	Description  string
	LanguageCode string
	UsageCount   int64
	Depth        int
	Children     bool
}

type CategoryTranslation struct {
	Category CategoryItem
	Language LanguageOption
}

type CommonLanguageOption struct {
	Code       string
	Name       string
	NativeName string
	Direction  string
}

type ConfigItemView struct {
	Key         string
	Value       string
	Type        string
	Description string
	Label       string
}

type ConfigTranslationValueView struct {
	LanguageCode string
	LanguageName string
	Value        string
}

type ConfigViewData struct {
	Items                []ConfigItemView
	TranslatableItems    []TranslatableConfigItemView
	Errors               map[string]string
	HasMultipleLanguages bool
}

type ConflictStrategyView struct {
	Value       string
	Label       string
	Description string
}

type DashboardData struct {
	Stats                  DashboardStats
	RecentSubmissions      []RecentSubmission
	WebhookHealth          []WebhookHealthItem
	RecentFailedDeliveries []RecentFailedDelivery
	TranslationCoverage    []TranslationCoverage
	RecentActivity         []ActivityItem
}

type DashboardStats struct {
	TotalPages          int64
	PublishedPages      int64
	DraftPages          int64
	TotalUsers          int64
	TotalMedia          int64
	TotalForms          int64
	UnreadSubmissions   int64
	ActiveLanguages     int64
	TotalWebhooks       int64
	FailedDeliveries24h int64
	CacheHitRate        float64
	CacheItems          int64
}

type DocsEndpointGroupView struct {
	Name      string
	Endpoints []DocsEndpointView
}

type DocsEndpointView struct {
	Method      string
	Path        string
	Description string
	Auth        string
}

type DocsGuideView struct {
	Slug  string
	Title string
}

type DocsGuideViewData struct {
	Title   string
	Content string // Trusted HTML content from local markdown files
}

type DocsSystemInfoView struct {
	Version        string
	GitCommit      string
	BuildTime      string
	GoVersion      string
	Environment    string
	ServerPort     int
	DBPath         string
	ActiveTheme    string
	CacheType      string
	EnabledModules int
	TotalModules   int
	Uptime         string
}

type DocsViewData struct {
	System    DocsSystemInfoView
	Endpoints []DocsEndpointGroupView
	Guides    []DocsGuideView
}

type EventItem struct {
	ID            int64
	Level         string // "info", "warning", "error"
	Category      string
	Message       string
	Details       string // Formatted metadata
	DetailsLong   bool   // True if details > 80 chars
	IPAddress     string // Masked in demo mode (for display)
	RawIPAddress  string // Unmasked (for ban button data-ip)
	IsOwnIP       bool
	IsBanned      bool // Pre-computed sentinel state
	IsWhitelisted bool // Pre-computed sentinel state
	RequestURL    string
	CreatedAt     string
	UserName      string
}

type EventsListData struct {
	Events         []EventItem
	TotalEvents    int64
	Level          string // Current level filter
	Category       string // Current category filter
	Levels         []string
	Categories     []string
	SentinelActive bool
	Pagination     PaginationData
}

type ExportViewData struct{}

type FormFieldView struct {
	ID          int64  `json:"id"`
	Type        string `json:"type"`
	Name        string `json:"name"`
	Label       string `json:"label"`
	Placeholder string `json:"placeholder"`
	HelpText    string `json:"help_text"`
	Options     string `json:"options"`
	Validation  string `json:"validation"`
	IsRequired  bool   `json:"is_required"`
}

type FormFormViewData struct {
	IsEdit          bool
	FormID          int64
	FormName        string
	FormSlug        string
	FormTitle       string
	FormDescription string
	SuccessMessage  string
	EmailTo         string
	IsActive        bool
	LanguageCode    string
	Fields          []FormFieldView
	FieldTypes      []string
	Errors          map[string]string
	FormValues      map[string]string
	// Language/Translation
	HasMultipleLanguages bool
	AllLanguages         []LanguageOption
	Language             *LanguageOption
	Translations         []FormTranslationInfoView
	MissingLanguages     []LanguageOption
	HcaptchaEnabled      bool
	FieldsJSON           string
	FieldTypesJSON       string
	IsDemoMode           bool
}

type FormListItemView struct {
	ID              int64
	Name            string
	Title           string
	Slug            string
	LanguageCode    string
	IsActive        bool
	SubmissionCount int64
	UnreadCount     int64
}

type FormTranslationInfoView struct {
	LanguageCode string
	LanguageName string
	FormID       int64
	FormName     string
}

type FormsListViewData struct {
	Forms []FormListItemView
}

type HookHandlerViewItem struct {
	Name     string
	Module   string
	Priority int
}

type HookViewItem struct {
	Name     string
	Handlers []HookHandlerViewItem
}

type ImportErrorView struct {
	Entity  string
	ID      string
	Message string
}

type ImportResultView struct {
	Success      bool
	DryRun       bool
	TotalCreated int
	TotalUpdated int
	TotalSkipped int
	Created      map[string]int
	Updated      map[string]int
	Skipped      map[string]int
	Errors       []ImportErrorView
}

type ImportUploadedDataView struct {
	HasPages      bool
	HasCategories bool
	HasTags       bool
	HasMedia      bool
	HasMenus      bool
	HasForms      bool
	HasUsers      bool
	HasLanguages  bool
	HasConfig     bool
}

type ImportViewData struct {
	ConflictStrategies []ConflictStrategyView
	ValidationResult   *ValidationResultView
	ImportResult       *ImportResultView
	UploadedData       *ImportUploadedDataView
	IsZipFile          bool
	HasMediaFiles      bool
}

type LangOption struct {
	Code string
	Name string
}

type LanguageFormData struct {
	IsEdit          bool
	Language        *LanguageInfo
	CommonLanguages []CommonLanguageOption
	Errors          map[string]string
	FormValues      map[string]string
}

type LanguageInfo struct {
	ID         int64
	Code       string
	Name       string
	NativeName string
	Direction  string
	IsDefault  bool
	IsActive   bool
	Position   int64
	CreatedAt  time.Time
	UpdatedAt  time.Time
}

type LanguageListItem struct {
	ID         int64
	Code       string
	Name       string
	NativeName string
	Direction  string
	IsDefault  bool
	IsActive   bool
	Position   int64
}

type LanguageOption struct {
	Code       string
	Name       string
	NativeName string
}

type LanguagesListData struct {
	Languages      []LanguageListItem
	TotalLanguages int64
}

type LoginData struct {
	Title           string
	AdminLang       string
	Flash           string
	FlashType       string
	LangOptions     []LangOption
	HcaptchaEnabled bool
	HcaptchaWidget  string
}

type MediaEditViewData struct {
	Media            MediaItemView
	Variants         []MediaVariantView
	Folders          []MediaFolderView
	CurrentFolderID  int64
	HasCurrentFolder bool
	Languages        []MediaLanguageView
	Translations     map[string]MediaTranslationView
	Errors           map[string]string
	FormValues       map[string]string
}

type MediaFolderView struct {
	ID        int64
	Name      string
	HasParent bool
}

type MediaItemView struct {
	ID            int64
	Filename      string
	Alt           string
	ThumbnailURL  string
	OriginalURL   string
	IsImage       bool
	TypeIcon      string // "video", "file-text", "file"
	Size          string // formatted bytes
	MimeType      string
	Width         int64
	Height        int64
	HasDimensions bool
	CreatedAt     string
	UUID          string
	FolderID      int64
	HasFolderID   bool
}

type MediaLanguageView struct {
	Code       string
	NativeName string
}

type MediaLibraryViewData struct {
	Media      []MediaItemView
	Folders    []MediaFolderView
	TotalCount int64
	Filter     string
	FolderID   *int64
	Search     string
	Pagination PaginationData
}

type MediaTranslationView struct {
	Alt     string
	Caption string
}

type MediaUploadViewData struct {
	Folders          []MediaFolderView
	MaxSize          int64
	MaxSizeFormatted string
	AllowedExt       string
	FormatsHint      string
}

type MediaVariantView struct {
	Type      string
	TypeLabel string
	Width     int64
	Height    int64
	Size      string // formatted bytes
}

type MenuFormData struct {
	IsEdit     bool
	Menu       *MenuInfo
	ItemsJSON  string // Pre-serialized JSON for Alpine.js data-items attribute
	Pages      []MenuPageItem
	Targets    []string
	Languages  []LanguageOption
	Errors     map[string]string
	FormValues map[string]string
}

type MenuInfo struct {
	ID           int64
	Name         string
	Slug         string
	LanguageCode string
}

type MenuListItem struct {
	ID           int64
	Name         string
	Slug         string
	LanguageCode string
	UpdatedAt    time.Time
	IsProtected  bool // true when slug == "main" || slug == "footer"
}

type MenuPageItem struct {
	ID    int64
	Title string
	Slug  string
}

type MenusListData struct {
	Menus []MenuListItem
}

type ModuleViewItem struct {
	Name              string
	Version           string
	Description       string
	AdminURL          string
	Active            bool
	ShowInSidebar     bool
	HasMigrations     bool
	MigrationsApplied int
	MigrationCount    int
	MigrationsPending int
	IsEmbedded        bool
}

type ModulesViewData struct {
	Modules []ModuleViewItem
	Hooks   []HookViewItem
}

type PageCategoryNodeView struct {
	ID          int64
	Name        string
	Description string
	Depth       int
}

type PageCategoryView struct {
	Name string
}

type PageContext struct {
	Title          string
	User           UserInfo
	Flash          string
	FlashType      string
	SiteName       string
	CurrentPath    string
	AdminLang      string
	LangOptions    []LangOption
	Breadcrumbs    []Breadcrumb
	SidebarModules []SidebarModule
}

type PageFeaturedImageView struct {
	Thumbnail string
}

type PageFormAliasView struct {
	ID    int64
	Alias string
}

type PageFormCategoryView struct {
	ID int64 `json:"id"`
}

type PageFormFeaturedImageView struct {
	ID        int64  `json:"id"`
	Filename  string `json:"filename"`
	Filepath  string `json:"filepath"`
	Thumbnail string `json:"thumbnail"`
	Mimetype  string `json:"mimetype"`
}

type PageFormTagView struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	Slug string `json:"slug"`
}

type PageFormViewData struct {
	IsEdit        bool
	PageID        int64
	PageTitle     string
	PageSlug      string
	PageBody      string
	PageStatus    string
	PageType      string
	Statuses      []string
	PageTypes     []string
	AllCategories []PageCategoryNodeView
	Tags          []PageFormTagView
	Categories    []PageFormCategoryView
	FeaturedImage *PageFormFeaturedImageView
	Aliases       []PageFormAliasView
	Errors        map[string]string
	FormValues    map[string]string
	// Language/Translation
	HasMultipleLanguages bool
	AllLanguages         []LanguageOption
	Language             *LanguageOption
	Translations         []PageTranslationView
	MissingLanguages     []LanguageOption
	// SEO
	MetaTitle       string
	MetaDescription string
	MetaKeywords    string
	OgImageID       string
	CanonicalURL    string
	NoIndex         bool
	NoFollow        bool
	// Scheduling
	ScheduledAt    string
	HasScheduledAt bool
	ScheduledAtFmt string
	// Checkboxes
	HideFeaturedImage bool
	ExcludeFromLists  bool
	IsDemoMode        bool
}

type PageLanguageView struct {
	Code string
	Name string
}

type PageListItemView struct {
	ID               int64
	Title            string
	Slug             string
	Status           string
	IsScheduled      bool
	ScheduledAtTitle string
	UpdatedAt        string
	FeaturedImage    *PageFeaturedImageView
	Tags             []PageTagView
	Categories       []PageCategoryView
	Language         *PageLanguageView
	IsDemoPublished  bool // true if demo mode AND status=published
}

type PageTagView struct {
	Name string
}

type PageTranslationView struct {
	Language LanguageOption
	PageID   int64
	Title    string
	Status   string
}

type PageVersionView struct {
	ID            int64
	Title         string
	Body          string
	ChangedByName string
	CreatedAt     string
}

type PageVersionsViewData struct {
	PageID     int64
	PageTitle  string
	TotalCount int64
	Versions   []PageVersionView
	Pagination PaginationData
}

type PagesListViewData struct {
	Pages          []PageListItemView
	TotalCount     int64
	StatusFilter   string
	CategoryFilter int64
	LanguageFilter string
	SearchFilter   string
	AllCategories  []PageCategoryNodeView
	AllLanguages   []LanguageOption
	Statuses       []string
	Pagination     PaginationData
	IsDemoMode     bool
}

type PaginationBulkAction struct {
	Enabled   bool
	Scope     string
	DeleteURL string
}

type PaginationData struct {
	CurrentPage     int
	TotalPages      int
	TotalItems      int64
	BaseURL         string
	QueryString     string
	SortField       string
	SortDir         string
	HasFirst        bool
	HasPrev         bool
	HasNext         bool
	HasLast         bool
	FirstURL        string
	PrevURL         string
	NextURL         string
	LastURL         string
	Pages           []PaginationPage
	BulkAction      *PaginationBulkAction
	PerPageSelector *PaginationPerPageSelector
}

type PaginationPage struct {
	Number     int
	URL        string
	IsCurrent  bool
	IsEllipsis bool
}

type PaginationPerPageSelector struct {
	Enabled bool
	Param   string
	Current int
	Options []int
}

type PermissionGroup struct {
	TitleKey    string // i18n key for the group title
	Permissions []PermissionOption
}

type PermissionOption struct {
	Value   string
	DescKey string // i18n key for the description
	Checked bool
}

type RecentFailedDelivery struct {
	WebhookID   int64
	WebhookName string
	Event       string
	Status      string
	CreatedAt   string
}

type RecentSubmission struct {
	ID        int64
	FormID    int64
	FormName  string
	IsRead    bool
	CreatedAt string
}

type RedirectFormData struct {
	IsEdit      bool
	Redirect    *RedirectInfo
	StatusCodes []RedirectStatusCodeOption
	TargetTypes []string
	Errors      map[string]string
	FormValues  map[string]string
}

type RedirectInfo struct {
	ID         int64
	SourcePath string
	TargetURL  string
	StatusCode int64
	IsWildcard bool
	TargetType string
	Enabled    bool
	CreatedAt  time.Time
	UpdatedAt  time.Time
}

type RedirectListItem struct {
	ID         int64
	SourcePath string
	TargetURL  string
	StatusCode int64
	IsWildcard bool
	TargetType string
	Enabled    bool
}

type RedirectStatusCodeOption struct {
	Code  int
	Label string
}

type RedirectsListData struct {
	Redirects  []RedirectListItem
	TotalCount int64
}

type SchedulerJobViewItem struct {
	Source          string
	Name            string
	Description     string
	DefaultSchedule string
	Schedule        string
	IsOverridden    bool
	LastRun         string
	NextRun         string
	CanTrigger      bool
}

type SchedulerListViewData struct {
	Jobs       []SchedulerJobViewItem
	Tasks      []SchedulerTaskViewItem
	IsDemoMode bool
}

type SchedulerTaskFormViewData struct {
	TaskID         int64
	Name           string
	URL            string
	Schedule       string
	TimeoutSeconds int64
	IsEdit         bool
	IsDemoMode     bool
}

type SchedulerTaskRunView struct {
	Status          string
	StatusCode      int64
	HasStatusCode   bool
	DurationMs      int64
	HasDuration     bool
	StartedAt       string
	ErrorMessage    string
	HasErrorMessage bool
}

type SchedulerTaskRunsViewData struct {
	TaskID       int64
	TaskName     string
	TaskURL      string
	TaskSchedule string
	TaskTimeout  int64
	TaskIsActive bool
	TotalCount   int64
	Runs         []SchedulerTaskRunView
	Pagination   PaginationData
	IsDemoMode   bool
}

type SchedulerTaskViewItem struct {
	ID       int64
	Name     string
	URL      string
	Schedule string
	IsActive bool
	LastRun  string
}

type SidebarModule struct {
	Name     string
	Label    string
	AdminURL string
}

type StatCardProps struct {
	Href      string // optional link wrapper
	Label     string
	Value     string
	IconClass string // icon container bg/text color classes
	Highlight bool   // warning border variant
}

type StatusBannerProps struct {
	Title      string // e.g. "In-Memory Cache", "Redis Cache"
	Healthy    bool   // green or red status dot
	StatusText string // e.g. "Healthy" or error message
	Detail     string // optional detail line (e.g. Redis URL)
	Class      string // optional wrapper class
}

type SubmissionFieldView struct {
	Label string
	Name  string
	Type  string
	Value string
}

type SubmissionItemView struct {
	ID        int64
	Preview   string
	CreatedAt string
	IPAddress string
	IsRead    bool
}

type SubmissionViewViewData struct {
	FormID       int64
	FormName     string
	SubmissionID int64
	CreatedAt    string
	IPAddress    string
	UserAgent    string
	Fields       []SubmissionFieldView
	RawJSON      string
}

type SubmissionsListViewData struct {
	FormID      int64
	FormName    string
	FormSlug    string
	TotalCount  int64
	UnreadCount int64
	Submissions []SubmissionItemView
	Pagination  PaginationData
	IsDemoMode  bool
}

type TagFormData struct {
	IsEdit           bool
	Tag              *TagItem
	AllLanguages     []LanguageOption
	Language         *LanguageOption
	Translations     []TagTranslation
	MissingLanguages []LanguageOption
	FormValues       map[string]string
	Errors           map[string]string
}

type TagItem struct {
	ID           int64
	Name         string
	Slug         string
	LanguageCode string
}

type TagListItem struct {
	ID           int64
	Name         string
	Slug         string
	LanguageCode string
	UsageCount   int64
	CreatedAt    time.Time
}

type TagTranslation struct {
	Tag      TagItem
	Language LanguageOption
}

type TagsListData struct {
	Tags           []TagListItem
	TotalCount     int64
	Pagination     PaginationData
	LanguageFilter string
	SearchFilter   string
	AllLanguages   []LanguageOption
}

type ThemeSettingView struct {
	Key     string
	Label   string
	Type    string
	Default string
	Options []string
	Value   string
	Error   string
}

type ThemeSettingsViewData struct {
	ThemeName       string
	ThemeConfigName string
	IsActive        bool
	Settings        []ThemeSettingView
	IsDemoMode      bool
}

type ThemeViewItem struct {
	Name              string
	ConfigName        string
	ConfigVersion     string
	ConfigAuthor      string
	ConfigDescription string
	ConfigScreenshot  string
	IsActive          bool
	IsEmbedded        bool
	HasSettings       bool
	SettingsURL       string
}

type ThemesListData struct {
	Themes []ThemeViewItem
}

type TranslatableConfigItemView struct {
	Key          string
	Label        string
	Description  string
	Type         string
	Translations []ConfigTranslationValueView
}

type TranslationCoverage struct {
	LanguageCode string
	TotalPages   int64
	IsDefault    bool
}

type UserFormData struct {
	IsEdit     bool
	User       *UserItem
	Roles      []string
	FormValues map[string]string
	Errors     map[string]string
}

type UserInfo struct {
	ID    int64
	Name  string
	Email string
	Role  string
}

type UserItem struct {
	ID    int64
	Name  string
	Email string
	Role  string
}

type UserListItem struct {
	ID            int64
	Name          string
	Email         string
	Role          string
	CreatedAt     time.Time
	LastLoginAt   *time.Time
	IsCurrentUser bool
}

type UsersListData struct {
	Users      []UserListItem
	TotalCount int64
	Pagination PaginationData
}

type ValidationErrorView struct {
	Entity  string
	Message string
}

type ValidationResultView struct {
	Valid     bool
	Entities  map[string]int
	Conflicts map[string][]string
	Errors    []ValidationErrorView
}

type WebhookDeliveriesViewData struct {
	WebhookID   int64
	WebhookName string
	Deliveries  []WebhookDeliveryView
	TotalCount  int64
	Pagination  PaginationData
}

type WebhookDeliveryView struct {
	ID              int64
	Event           string
	Status          string
	Attempts        int64
	ResponseCode    int64
	HasResponseCode bool
	ErrorMessage    string
	HasErrorMessage bool
	Payload         string
	ResponseBody    string
	HasResponseBody bool
	CreatedAt       string
	DeliveredAt     string
	HasDeliveredAt  bool
	NextRetryAt     string
	HasNextRetryAt  bool
	UpdatedAt       string
	CanRetry        bool
}

type WebhookEventInfoView struct {
	Type        string
	Description string
}

type WebhookFormViewData struct {
	WebhookID   int64
	IsEdit      bool
	Events      []WebhookEventInfoView
	Errors      map[string]string
	FormValues  map[string]string
	FormEvents  []string
	FormHeaders map[string]string
	CreatedAt   string
	UpdatedAt   string
}

type WebhookHealthItem struct {
	Name         string
	IsActive     bool
	HealthStatus string
	SuccessRate  float64
}

type WebhookListItemView struct {
	ID                  int64
	Name                string
	URL                 string
	Events              []string
	IsActive            bool
	TotalDelivered      int64
	TotalPending        int64
	TotalDead           int64
	SuccessRate         float64
	HealthStatus        string
	LastSuccessfulAt    string
	HasLastSuccessfulAt bool
}

type WebhooksListViewData struct {
	Webhooks      []WebhookListItemView
	TotalWebhooks int64
}

type WidgetAreaView struct {
	AreaID          string
	AreaName        string
	AreaDescription string
	Widgets         []WidgetItemView
}

type WidgetItemView struct {
	ID         int64
	WidgetType string
	Title      string
	HasTitle   bool
}

type WidgetTypeView struct {
	ID          string
	Name        string
	Description string
}

type WidgetsViewData struct {
	ThemeName   string
	WidgetAreas []WidgetAreaView
	WidgetTypes []WidgetTypeView
}