package models import ( "time" "github.com/shopspring/decimal" ) // TaskCategory represents the task_taskcategory table type TaskCategory struct { BaseModel Name string `gorm:"column:name;size:50;not null" json:"name"` Description string `gorm:"column:description;type:text" json:"description"` Icon string `gorm:"column:icon;size:50" json:"icon"` Color string `gorm:"column:color;size:7" json:"color"` // Hex color DisplayOrder int `gorm:"column:display_order;default:0" json:"display_order"` } // TableName returns the table name for GORM func (TaskCategory) TableName() string { return "task_taskcategory" } // TaskPriority represents the task_taskpriority table type TaskPriority struct { BaseModel Name string `gorm:"column:name;size:20;not null" json:"name"` Level int `gorm:"column:level;not null" json:"level"` // 1=low, 2=medium, 3=high, 4=urgent Color string `gorm:"column:color;size:7" json:"color"` DisplayOrder int `gorm:"column:display_order;default:0" json:"display_order"` } // TableName returns the table name for GORM func (TaskPriority) TableName() string { return "task_taskpriority" } // TaskFrequency represents the task_taskfrequency table type TaskFrequency struct { BaseModel Name string `gorm:"column:name;size:20;not null" json:"name"` Days *int `gorm:"column:days" json:"days"` // Number of days between occurrences (nil = one-time) DisplayOrder int `gorm:"column:display_order;default:0" json:"display_order"` } // TableName returns the table name for GORM func (TaskFrequency) TableName() string { return "task_taskfrequency" } // Task represents the task_task table type Task struct { BaseModel ResidenceID uint `gorm:"column:residence_id;index;not null" json:"residence_id"` Residence Residence `gorm:"foreignKey:ResidenceID" json:"residence,omitempty"` CreatedByID uint `gorm:"column:created_by_id;index;not null" json:"created_by_id"` CreatedBy User `gorm:"foreignKey:CreatedByID" json:"created_by,omitempty"` AssignedToID *uint `gorm:"column:assigned_to_id;index" json:"assigned_to_id"` AssignedTo *User `gorm:"foreignKey:AssignedToID" json:"assigned_to,omitempty"` Title string `gorm:"column:title;size:200;not null" json:"title"` Description string `gorm:"column:description;type:text" json:"description"` CategoryID *uint `gorm:"column:category_id;index" json:"category_id"` Category *TaskCategory `gorm:"foreignKey:CategoryID" json:"category,omitempty"` PriorityID *uint `gorm:"column:priority_id;index" json:"priority_id"` Priority *TaskPriority `gorm:"foreignKey:PriorityID" json:"priority,omitempty"` FrequencyID *uint `gorm:"column:frequency_id;index" json:"frequency_id"` Frequency *TaskFrequency `gorm:"foreignKey:FrequencyID" json:"frequency,omitempty"` CustomIntervalDays *int `gorm:"column:custom_interval_days" json:"custom_interval_days"` // For "Custom" frequency, user-specified days // In Progress flag - replaces status lookup InProgress bool `gorm:"column:in_progress;default:false;index" json:"in_progress"` DueDate *time.Time `gorm:"column:due_date;type:date;index" json:"due_date"` NextDueDate *time.Time `gorm:"column:next_due_date;type:date;index" json:"next_due_date"` // For recurring tasks, updated after each completion EstimatedCost *decimal.Decimal `gorm:"column:estimated_cost;type:decimal(10,2)" json:"estimated_cost"` ActualCost *decimal.Decimal `gorm:"column:actual_cost;type:decimal(10,2)" json:"actual_cost"` // Contractor association ContractorID *uint `gorm:"column:contractor_id;index" json:"contractor_id"` // Contractor *Contractor `gorm:"foreignKey:ContractorID" json:"contractor,omitempty"` // State flags IsCancelled bool `gorm:"column:is_cancelled;default:false;index" json:"is_cancelled"` IsArchived bool `gorm:"column:is_archived;default:false;index" json:"is_archived"` // Optimistic locking version Version int `gorm:"column:version;not null;default:1" json:"-"` // Parent task for recurring tasks ParentTaskID *uint `gorm:"column:parent_task_id;index" json:"parent_task_id"` ParentTask *Task `gorm:"foreignKey:ParentTaskID" json:"parent_task,omitempty"` // Template backlink — set when a task is created from a TaskTemplate // (e.g. via onboarding suggestions or the browse-all catalog). Nullable // so custom user tasks remain unaffected. TaskTemplateID *uint `gorm:"column:task_template_id;index" json:"task_template_id,omitempty"` TaskTemplate *TaskTemplate `gorm:"foreignKey:TaskTemplateID" json:"task_template,omitempty"` // Completions Completions []TaskCompletion `gorm:"foreignKey:TaskID" json:"completions,omitempty"` // CompletionCount is a computed field populated via subquery for optimized queries. // When populated (>= 0 and Completions slice is empty), predicates should use this // instead of len(Completions) to avoid N+1 queries. CompletionCount int `gorm:"-:all" json:"-"` } // TableName returns the table name for GORM func (Task) TableName() string { return "task_task" } // IsOverdue returns true if the task is past its due date and not completed. // // IMPORTANT: This method delegates to the predicates package which is the // single source of truth for task logic. It uses EffectiveDate (NextDueDate ?? DueDate) // rather than just DueDate, ensuring consistency with kanban categorization. // // Uses day-based comparison: a task due TODAY is NOT overdue, it only becomes // overdue the NEXT day. // // Deprecated: Prefer using task.IsOverdue(t, time.Now().UTC()) directly for explicit time control. func (t *Task) IsOverdue() bool { return t.IsOverdueAt(time.Now().UTC()) } // IsOverdueAt returns true if the task would be overdue at the given time. // Uses day-based comparison: a task due on the same day as `now` is NOT overdue. func (t *Task) IsOverdueAt(now time.Time) bool { // Logic must match predicates.IsOverdue exactly: // - Check active (not cancelled, not archived) // - Check not completed (NextDueDate != nil || no completions) // - Check effective date < start of today if t.IsCancelled || t.IsArchived { return false } // Completed check: NextDueDate == nil AND has completions // Supports both preloaded Completions and computed CompletionCount hasCompletions := len(t.Completions) > 0 || t.CompletionCount > 0 if t.NextDueDate == nil && hasCompletions { return false } // Effective date: NextDueDate ?? DueDate effectiveDate := t.NextDueDate if effectiveDate == nil { effectiveDate = t.DueDate } if effectiveDate == nil { return false } // Day-based comparison: compare against start of today startOfDay := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location()) return effectiveDate.Before(startOfDay) } // IsDueSoon returns true if the task is due within the specified days. // // IMPORTANT: This method uses EffectiveDate (NextDueDate ?? DueDate) // rather than just DueDate, ensuring consistency with kanban categorization. // // Deprecated: Prefer using task.IsDueSoon(t, time.Now().UTC(), days) directly for explicit time control. func (t *Task) IsDueSoon(days int) bool { // Delegate to predicates package logic - single source of truth // Logic must match predicates.IsDueSoon exactly if t.IsCancelled || t.IsArchived { return false } // Completed check: NextDueDate == nil AND has completions // Supports both preloaded Completions and computed CompletionCount hasCompletions := len(t.Completions) > 0 || t.CompletionCount > 0 if t.NextDueDate == nil && hasCompletions { return false } // Effective date: NextDueDate ?? DueDate effectiveDate := t.NextDueDate if effectiveDate == nil { effectiveDate = t.DueDate } if effectiveDate == nil { return false } now := time.Now().UTC() threshold := now.AddDate(0, 0, days) // Due soon = not overdue AND before threshold return !effectiveDate.Before(now) && effectiveDate.Before(threshold) } // TaskCompletion represents the task_taskcompletion table type TaskCompletion struct { BaseModel TaskID uint `gorm:"column:task_id;index;not null" json:"task_id"` Task Task `gorm:"foreignKey:TaskID" json:"-"` CompletedByID uint `gorm:"column:completed_by_id;index;not null" json:"completed_by_id"` CompletedBy User `gorm:"foreignKey:CompletedByID" json:"completed_by,omitempty"` CompletedAt time.Time `gorm:"column:completed_at;not null" json:"completed_at"` Notes string `gorm:"column:notes;type:text" json:"notes"` ActualCost *decimal.Decimal `gorm:"column:actual_cost;type:decimal(10,2)" json:"actual_cost"` Rating *int `gorm:"column:rating" json:"rating"` // 1-5 star rating CompletedFromColumn string `gorm:"column:completed_from_column;type:varchar(50);default:'completed_tasks'" json:"completed_from_column"` // Multiple images support Images []TaskCompletionImage `gorm:"foreignKey:CompletionID" json:"images,omitempty"` } // TableName returns the table name for GORM func (TaskCompletion) TableName() string { return "task_taskcompletion" } // TaskCompletionImage represents the task_taskcompletionimage table type TaskCompletionImage struct { BaseModel CompletionID uint `gorm:"column:completion_id;index;not null" json:"completion_id"` ImageURL string `gorm:"column:image_url;size:500;not null" json:"image_url"` Caption string `gorm:"column:caption;size:255" json:"caption"` } // TableName returns the table name for GORM func (TaskCompletionImage) TableName() string { return "task_taskcompletionimage" } // KanbanColumn represents a column in the kanban board type KanbanColumn struct { Name string `json:"name"` DisplayName string `json:"display_name"` ButtonTypes []string `json:"button_types"` Icons map[string]string `json:"icons"` Color string `json:"color"` Tasks []Task `json:"tasks"` Count int `json:"count"` } // KanbanBoard represents the full kanban board response type KanbanBoard struct { Columns []KanbanColumn `json:"columns"` DaysThreshold int `json:"days_threshold"` ResidenceID string `json:"residence_id"` }