project

type ActionExecutor interface {
	// ExecuteHibernateAll hibernates all instances for a project
	ExecuteHibernateAll(projectID string) error
	// ExecuteStopAll stops all instances for a project
	ExecuteStopAll(projectID string) error
	// ExecutePreventLaunch sets a flag to prevent new launches for a project
	ExecutePreventLaunch(projectID string) error
}

type AddMemberRequest struct {
	// UserID is the user identifier
	UserID string `json:"user_id"`

	// Role is the project role for the member
	Role types.ProjectRole `json:"role"`

	// AddedBy is who is adding the member
	AddedBy string `json:"added_by"`
}

type AlertEvent struct {
	Timestamp   time.Time             `json:"timestamp"`
	AlertType   types.BudgetAlertType `json:"alert_type"`
	Threshold   float64               `json:"threshold"`
	SpentAmount float64               `json:"spent_amount"`
	Message     string                `json:"message"`
	Resolved    bool                  `json:"resolved"`
}

type AllocationSummary struct {
	// AllocationID is the allocation identifier
	AllocationID string `json:"allocation_id"`

	// BudgetID is the parent budget identifier
	BudgetID string `json:"budget_id"`

	// BudgetName is the parent budget name
	BudgetName string `json:"budget_name"`

	// AllocatedAmount is how much was allocated
	AllocatedAmount float64 `json:"allocated_amount"`

	// SpentAmount is how much has been spent
	SpentAmount float64 `json:"spent_amount"`

	// RemainingAmount is the remaining allocation
	RemainingAmount float64 `json:"remaining_amount"`

	// Utilization is the percentage of allocation spent (0.0-1.0)
	Utilization float64 `json:"utilization"`

	// HasBackup indicates if backup funding is configured
	HasBackup bool `json:"has_backup"`
}

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

type BudgetRollupReport struct {
	// ReportID is a unique identifier for this report
	ReportID string `json:"report_id"`

	// GeneratedAt is when this report was generated
	GeneratedAt time.Time `json:"generated_at"`

	// BudgetSummaries provides per-budget rollup information
	BudgetSummaries []BudgetSummaryReport `json:"budget_summaries"`

	// TotalBudgets is the total number of budgets in the report
	TotalBudgets int `json:"total_budgets"`

	// TotalAllocated is the sum of all budget allocations
	TotalAllocated float64 `json:"total_allocated"`

	// TotalSpent is the sum of all spending across all budgets
	TotalSpent float64 `json:"total_spent"`

	// TotalRemaining is the total remaining across all budgets
	TotalRemaining float64 `json:"total_remaining"`

	// OverallUtilization is the percentage of total budget utilized (0.0-1.0)
	OverallUtilization float64 `json:"overall_utilization"`

	// ProjectCount is the total number of projects funded
	ProjectCount int `json:"project_count"`
}

type BudgetStatus struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// BudgetEnabled indicates if budget tracking is enabled
	BudgetEnabled bool `json:"budget_enabled"`

	// TotalBudget is the total project budget
	TotalBudget float64 `json:"total_budget"`

	// SpentAmount is the current amount spent
	SpentAmount float64 `json:"spent_amount"`

	// RemainingBudget is the remaining budget
	RemainingBudget float64 `json:"remaining_budget"`

	// SpentPercentage is the percentage of budget spent (0.0-1.0)
	SpentPercentage float64 `json:"spent_percentage"`

	// ProjectedMonthlySpend is the projected monthly spending based on current usage
	ProjectedMonthlySpend float64 `json:"projected_monthly_spend"`

	// DaysUntilBudgetExhausted estimates when budget will be exhausted at current rate
	DaysUntilBudgetExhausted *int `json:"days_until_exhausted,omitempty"`

	// ActiveAlerts are currently active budget alerts
	ActiveAlerts []string `json:"active_alerts"`

	// TriggeredActions are actions that have been triggered
	TriggeredActions []string `json:"triggered_actions"`

	// LastUpdated is when this status was calculated
	LastUpdated time.Time `json:"last_updated"`
}

type BudgetStatusSummary struct {
	// TotalBudget is the total project budget
	TotalBudget float64 `json:"total_budget"`

	// SpentAmount is the current amount spent
	SpentAmount float64 `json:"spent_amount"`

	// SpentPercentage is the percentage of budget spent (0.0-1.0)
	SpentPercentage float64 `json:"spent_percentage"`

	// AlertCount is the number of active alerts
	AlertCount int `json:"alert_count"`
}

type BudgetSummaryReport struct {
	// BudgetID is the budget identifier
	BudgetID string `json:"budget_id"`

	// BudgetName is the budget name
	BudgetName string `json:"budget_name"`

	// Period is the budget period
	Period string `json:"period"`

	// TotalAmount is the total budget amount
	TotalAmount float64 `json:"total_amount"`

	// AllocatedAmount is how much has been allocated to projects
	AllocatedAmount float64 `json:"allocated_amount"`

	// SpentAmount is how much has been spent
	SpentAmount float64 `json:"spent_amount"`

	// RemainingAmount is the remaining unspent budget
	RemainingAmount float64 `json:"remaining_amount"`

	// Utilization is the percentage of budget utilized (0.0-1.0)
	Utilization float64 `json:"utilization"`

	// ProjectCount is the number of projects funded by this budget
	ProjectCount int `json:"project_count"`

	// AllocationCount is the number of allocations from this budget
	AllocationCount int `json:"allocation_count"`

	// Projects provides per-project information
	Projects []ProjectCostSummary `json:"projects"`
}

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

type CostCalculator struct {
}

type CostDataPoint struct {
	Timestamp     time.Time            `json:"timestamp"`
	TotalCost     float64              `json:"total_cost"`
	InstanceCosts []types.InstanceCost `json:"instance_costs"`
	StorageCosts  []types.StorageCost  `json:"storage_costs"`
	DailyCost     float64              `json:"daily_cost"`
}

type CreateAllocationRequest struct {
	// BudgetID is the parent budget pool
	BudgetID string `json:"budget_id"`

	// ProjectID is the project receiving the allocation
	ProjectID string `json:"project_id"`

	// AllocatedAmount is how much of the budget to allocate to this project
	AllocatedAmount float64 `json:"allocated_amount"`

	// AlertThreshold is an optional project-specific alert threshold (overrides budget default)
	AlertThreshold *float64 `json:"alert_threshold,omitempty"`

	// BackupAllocationID is an optional backup funding source for exhaustion (#234)
	BackupAllocationID *string `json:"backup_allocation_id,omitempty"`

	// Notes provide context for this allocation
	Notes string `json:"notes,omitempty"`

	// AllocatedBy is the user who created the allocation
	AllocatedBy string `json:"allocated_by"`
}

type CreateBudgetRequest struct {
	// Name is the budget name (e.g., "NSF Grant CISE-2024-12345")
	Name string `json:"name"`

	// Description provides budget details
	Description string `json:"description"`

	// TotalAmount is the total budget pool in USD
	TotalAmount float64 `json:"total_amount"`

	// Period defines the budget period
	Period types.BudgetPeriod `json:"period"`

	// StartDate is when the budget period began
	StartDate time.Time `json:"start_date"`

	// EndDate is when the budget period ends (optional for ongoing budgets)
	EndDate *time.Time `json:"end_date,omitempty"`

	// AlertThreshold is the global alert percentage (0.0-1.0)
	AlertThreshold float64 `json:"alert_threshold"`

	// CreatedBy is the user who created the budget
	CreatedBy string `json:"created_by"`

	// Tags for budget organization
	Tags map[string]string `json:"tags,omitempty"`
}

type CreateProjectBudgetRequest struct {
	// TotalBudget is the total project budget in USD
	TotalBudget float64 `json:"total_budget"`

	// MonthlyLimit is the optional monthly spending limit in USD
	MonthlyLimit *float64 `json:"monthly_limit,omitempty"`

	// DailyLimit is the optional daily spending limit in USD
	DailyLimit *float64 `json:"daily_limit,omitempty"`

	// AlertThresholds define when to send budget alerts
	AlertThresholds []types.BudgetAlert `json:"alert_thresholds,omitempty"`

	// AutoActions define automatic actions when thresholds are reached
	AutoActions []types.BudgetAutoAction `json:"auto_actions,omitempty"`

	// BudgetPeriod defines the budget period
	BudgetPeriod types.BudgetPeriod `json:"budget_period"`

	// EndDate is when the budget period ends (optional)
	EndDate *time.Time `json:"end_date,omitempty"`
}

type CreateProjectRequest struct {
	// Name is the project name (required)
	Name string `json:"name"`

	// Description provides project details
	Description string `json:"description"`

	// Owner is the project owner/principal investigator
	Owner string `json:"owner"`

	// Tags for project organization
	Tags map[string]string `json:"tags,omitempty"`

	// Budget contains optional budget configuration (DEPRECATED in v0.5.10)
	// Use Budget/Allocation system instead
	Budget *CreateProjectBudgetRequest `json:"budget,omitempty"`
}

type ForecastDataPoint struct {
	// Month is the month for this data point (YYYY-MM format)
	Month string `json:"month"`

	// ProjectedCost is the projected spending for this month
	ProjectedCost float64 `json:"projected_cost"`

	// CumulativeCost is the cumulative cost to date
	CumulativeCost float64 `json:"cumulative_cost"`

	// ActualCost is the actual cost (for historical data only)
	ActualCost *float64 `json:"actual_cost,omitempty"`
}

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

type ProjectBudgetData struct {
	ProjectID    string               `json:"project_id"`
	Budget       *types.ProjectBudget `json:"budget"`
	CostHistory  []CostDataPoint      `json:"cost_history"`
	AlertHistory []AlertEvent         `json:"alert_history"`
	LastUpdated  time.Time            `json:"last_updated"`
}

type ProjectCostSummary struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// ProjectName is the project name
	ProjectName string `json:"project_name"`

	// FundingSources lists all funding allocations for this project
	FundingSources []AllocationSummary `json:"funding_sources"`

	// TotalAllocated is the total allocated to this project across all sources
	TotalAllocated float64 `json:"total_allocated"`

	// TotalSpent is the total spent by this project
	TotalSpent float64 `json:"total_spent"`

	// TotalRemaining is the remaining budget for this project
	TotalRemaining float64 `json:"total_remaining"`

	// Utilization is the percentage of allocated budget spent (0.0-1.0)
	Utilization float64 `json:"utilization"`
}

type ProjectFilter struct {
	// Owner filters by project owner
	Owner string `json:"owner,omitempty"`

	// Status filters by project status
	Status *types.ProjectStatus `json:"status,omitempty"`

	// Tags filters by project tags (all specified tags must match)
	Tags map[string]string `json:"tags,omitempty"`

	// CreatedAfter filters projects created after this date
	CreatedAfter *time.Time `json:"created_after,omitempty"`

	// CreatedBefore filters projects created before this date
	CreatedBefore *time.Time `json:"created_before,omitempty"`

	// HasBudget filters projects with/without budgets
	HasBudget *bool `json:"has_budget,omitempty"`
}

type ProjectForecastRequest struct {
	// Months is the number of months to forecast (default: 6)
	Months int `json:"months,omitempty"`

	// IncludeHistorical includes historical spending data in response
	IncludeHistorical bool `json:"include_historical,omitempty"`
}

type ProjectForecastResponse struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// GeneratedAt is when this forecast was generated
	GeneratedAt time.Time `json:"generated_at"`

	// CurrentMonthlyRate is the current monthly spending rate
	CurrentMonthlyRate float64 `json:"current_monthly_rate"`

	// ForecastData contains month-by-month projections
	ForecastData []ForecastDataPoint `json:"forecast_data"`

	// HistoricalData contains past spending (if requested)
	HistoricalData []ForecastDataPoint `json:"historical_data,omitempty"`

	// ProjectedExhaustion estimates when budget will be exhausted (if applicable)
	ProjectedExhaustion *time.Time `json:"projected_exhaustion,omitempty"`

	// Confidence indicates forecast confidence level (0.0-1.0)
	Confidence float64 `json:"confidence"`
}

type ProjectListResponse struct {
	// Projects are the matching projects
	Projects []ProjectSummary `json:"projects"`

	// TotalCount is the total number of projects (before pagination)
	TotalCount int `json:"total_count"`

	// FilteredCount is the number of projects matching the filter
	FilteredCount int `json:"filtered_count"`
}

type ProjectSummary struct {
	// ID is the project identifier
	ID string `json:"id"`

	// Name is the project name
	Name string `json:"name"`

	// Owner is the project owner
	Owner string `json:"owner"`

	// Status is the project status
	Status types.ProjectStatus `json:"status"`

	// MemberCount is the number of project members
	MemberCount int `json:"member_count"`

	// ActiveInstances is the number of currently active instances
	ActiveInstances int `json:"active_instances"`

	// TotalCost is the total project cost to date
	TotalCost float64 `json:"total_cost"`

	// BudgetStatus provides budget information if budget is enabled
	BudgetStatus *BudgetStatusSummary `json:"budget_status,omitempty"`

	// CreatedAt is when the project was created
	CreatedAt time.Time `json:"created_at"`

	// LastActivity is when the project had its last activity
	LastActivity time.Time `json:"last_activity"`
}

type ReallocateFundsRequest struct {
	// SourceAllocationID is where funds are moved from
	SourceAllocationID string `json:"source_allocation_id"`

	// DestinationAllocationID is where funds are moved to
	DestinationAllocationID string `json:"destination_allocation_id"`

	// Amount is how much to reallocate (USD)
	Amount float64 `json:"amount"`

	// Reason explains why the reallocation is being made (required for audit)
	Reason string `json:"reason"`

	// PerformedBy is the user making the reallocation
	PerformedBy string `json:"performed_by"`
}

type ReallocationRecord struct {
	// ID is the unique reallocation identifier
	ID string `json:"id"`

	// SourceAllocationID is where funds were moved from
	SourceAllocationID string `json:"source_allocation_id"`

	// DestinationAllocationID is where funds were moved to
	DestinationAllocationID string `json:"destination_allocation_id"`

	// SourceBudgetID is the source budget (for cross-budget tracking)
	SourceBudgetID string `json:"source_budget_id"`

	// DestinationBudgetID is the destination budget (for cross-budget tracking)
	DestinationBudgetID string `json:"destination_budget_id"`

	// Amount is how much was reallocated (USD)
	Amount float64 `json:"amount"`

	// Reason explains why the reallocation was made
	Reason string `json:"reason"`

	// PerformedBy is the user who made the reallocation
	PerformedBy string `json:"performed_by"`

	// Timestamp is when the reallocation occurred
	Timestamp time.Time `json:"timestamp"`
}

type SpendingResult struct {
	AllocationID        string
	AllocationExhausted bool
	BackupActivated     bool
	BackupAllocationID  string
	WarningMessage      string
}

type TransferProjectRequest struct {
	// NewOwnerID is the user ID of the new project owner
	NewOwnerID string `json:"new_owner_id"`

	// TransferredBy is the user making the transfer (must be current owner)
	TransferredBy string `json:"transferred_by"`

	// Reason provides context for the transfer (optional)
	Reason string `json:"reason,omitempty"`
}

type UpdateAllocationRequest struct {
	// AllocatedAmount is the new allocated amount (optional)
	AllocatedAmount *float64 `json:"allocated_amount,omitempty"`

	// AlertThreshold is the new alert threshold (optional)
	AlertThreshold *float64 `json:"alert_threshold,omitempty"`

	// BackupAllocationID is the new backup allocation (optional)
	BackupAllocationID *string `json:"backup_allocation_id,omitempty"`

	// Notes are the new notes (optional)
	Notes *string `json:"notes,omitempty"`
}

type UpdateBudgetRequest struct {
	// Name is the new budget name (optional)
	Name *string `json:"name,omitempty"`

	// Description is the new budget description (optional)
	Description *string `json:"description,omitempty"`

	// TotalAmount is the new total amount (optional)
	TotalAmount *float64 `json:"total_amount,omitempty"`

	// AlertThreshold is the new alert threshold (optional)
	AlertThreshold *float64 `json:"alert_threshold,omitempty"`

	// EndDate is the new end date (optional)
	EndDate *time.Time `json:"end_date,omitempty"`

	// Tags are the new budget tags (optional)
	Tags map[string]string `json:"tags,omitempty"`
}

type UpdateMemberRequest struct {
	// Role is the new role for the member
	Role types.ProjectRole `json:"role"`
}

type UpdateProjectRequest struct {
	// Name is the new project name (optional)
	Name *string `json:"name,omitempty"`

	// Description is the new project description (optional)
	Description *string `json:"description,omitempty"`

	// Tags are the new project tags (optional)
	Tags map[string]string `json:"tags,omitempty"`

	// Status is the new project status (optional)
	Status *types.ProjectStatus `json:"status,omitempty"`
}