project

type AWSCredit struct {
	CreditID           string    `json:"credit_id"`
	Name               string    `json:"name"`
	Description        string    `json:"description"`
	InitialAmount      float64   `json:"initial_amount"`
	RemainingAmount    float64   `json:"remaining_amount"`
	StartDate          time.Time `json:"start_date"`
	ExpirationDate     time.Time `json:"expiration_date"`
	ApplicableServices []string  `json:"applicable_services,omitempty"`
	Active             bool      `json:"active"`
	DaysUntilExpiry    int       `json:"days_until_expiry"`
	ExpiresInWarning   bool      `json:"expires_in_warning"` // true if < 30 days
}

type AWSDiscount struct {
	DiscountID string     `json:"discount_id"`
	Type       string     `json:"type"` // "EDP" | "PPA"
	Percentage float64    `json:"percentage,omitempty"`
	Services   []string   `json:"services,omitempty"`
	StartDate  time.Time  `json:"start_date"`
	EndDate    *time.Time `json:"end_date,omitempty"`
	Active     bool       `json:"active"`
}

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 ApprovalManager struct {
	// contains filtered or unexported fields
}

type ApprovalRequest struct {
	// ID is the unique request identifier
	ID string `json:"id"`

	// ProjectID is the project this request is associated with
	ProjectID string `json:"project_id"`

	// RequestedBy is the user who submitted the request
	RequestedBy string `json:"requested_by"`

	// Type is the kind of approval needed
	Type ApprovalType `json:"type"`

	// Status is the current state of the request
	Status ApprovalStatus `json:"status"`

	// Details contains type-specific context (instance_type, amount, etc.)
	Details map[string]interface{} `json:"details"`

	// Reason is the requester's justification
	Reason string `json:"reason"`

	// ReviewedBy is the approver's user ID (empty until reviewed)
	ReviewedBy string `json:"reviewed_by,omitempty"`

	// ReviewNote is an optional note from the approver
	ReviewNote string `json:"review_note,omitempty"`

	// CreatedAt is when the request was submitted
	CreatedAt time.Time `json:"created_at"`

	// ExpiresAt is when the pending request auto-expires (default: 7 days)
	ExpiresAt time.Time `json:"expires_at"`

	// ReviewedAt is when the request was approved or denied
	ReviewedAt *time.Time `json:"reviewed_at,omitempty"`
}

type ApprovalStatus string

type ApprovalType string

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

type BudgetPredictor 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"`

	// BurnRate contains period-aware burn rate analysis (nil when history is insufficient).
	BurnRate *BurnRateInfo `json:"burn_rate,omitempty"`

	// Surplus contains banking and carry-over information (nil for project-lifetime budgets).
	Surplus *SurplusInfo `json:"surplus,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 BurnRateCalculator struct{}

type BurnRateInfo struct {
	// DailyRate is the 7-day trailing average spend in dollars per day.
	DailyRate float64 `json:"daily_rate"`
	// WeeklyRate is projected weekly spend.
	WeeklyRate float64 `json:"weekly_rate"`
	// MonthlyRate is projected monthly spend.
	MonthlyRate float64 `json:"monthly_rate"`
	// PeriodAllocation is the budget amount for the current window.
	PeriodAllocation float64 `json:"period_allocation"`
	// PeriodSpend is how much has been spent within the current window.
	PeriodSpend float64 `json:"period_spend"`
	// PeriodRemaining is how much of the period allocation is left.
	PeriodRemaining float64 `json:"period_remaining"`
	// BurnRateRatio is actual/expected rate; >1.0 means over-paced.
	BurnRateRatio float64 `json:"burn_rate_ratio"`
	// PaceStatus characterises the current spending pace.
	PaceStatus PaceStatus `json:"pace_status"`
	// Window is the current period window.
	Window PeriodWindow `json:"window"`
}

type CostAdjustments struct {
	ProjectID           string        `json:"project_id"`
	Discounts           []AWSDiscount `json:"discounts"`
	Credits             []AWSCredit   `json:"credits"`
	TotalMonthlySavings float64       `json:"total_monthly_savings"`
	TotalCreditBalance  float64       `json:"total_credit_balance"`
	EffectiveCostRate   float64       `json:"effective_cost_rate"` // 0.90 = 10% discount
	UpdatedAt           time.Time     `json:"updated_at"`
}

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 CushionConfig struct {
	// Enabled activates the cushion system.
	Enabled bool `json:"enabled"`
	// HeadroomPercent is the fractional budget headroom (e.g. 0.10 = 10%).
	// Ignored when HeadroomFixed is set.
	HeadroomPercent float64 `json:"headroom_percent"`
	// HeadroomFixed is a fixed-dollar headroom amount (takes precedence over HeadroomPercent).
	HeadroomFixed *float64 `json:"headroom_fixed_usd,omitempty"`
	// Mode controls what action is taken when the cushion threshold is crossed.
	Mode CushionMode `json:"mode"`
	// NotifyBeforeAction sends a warning alert before taking the configured action.
	NotifyBeforeAction bool `json:"notify_before_action"`
	// WarnLeadHours is how many hours before the projected action to send the warning.
	WarnLeadHours int `json:"warn_lead_hours"`
}

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

type CushionMode string

type CushionStatus struct {
	// Triggered is true when the remaining budget is at or below the headroom.
	Triggered bool `json:"triggered"`
	// Headroom is the configured dollar headroom.
	Headroom float64 `json:"headroom"`
	// Remaining is the actual remaining budget.
	Remaining float64 `json:"remaining"`
	// Message is a human-readable status description.
	Message string `json:"message"`
}

type DiscoveryResult struct {
	Discounts []AWSDiscount
	Credits   []AWSCredit
	Error     error
}

type EBSCostDetail struct {
	VolumeName       string  `json:"volume_name"`
	VolumeID         string  `json:"volume_id"`
	VolumeType       string  `json:"volume_type"`
	SizeGB           float64 `json:"size_gb"`
	StorageCost      float64 `json:"storage_cost"`       // base GB × monthly rate
	IOPSCost         float64 `json:"iops_cost"`          // io1/io2 provisioned IOPS
	ThroughputCost   float64 `json:"throughput_cost"`    // gp3 throughput above baseline
	TotalMonthlyCost float64 `json:"total_monthly_cost"` // pro-rated to this month
	AgeHours         float64 `json:"age_hours"`
	Region           string  `json:"region"`
}

type EBSVolumeSpec struct {
	VolumeID   string
	Name       string
	SizeGB     int32
	VolumeType string // gp3, gp2, io1, io2, st1, sc1
	IOPS       int32  // provisioned IOPS (io1/io2 only)
	Throughput int32  // provisioned MB/s above baseline (gp3 only)
	Region     string
	AgeSeconds float64 // seconds since creation, for pro-rating
}

type EFSCostDetail struct {
	FilesystemName        string  `json:"filesystem_name"`
	FilesystemID          string  `json:"filesystem_id"`
	StandardStorageGB     float64 `json:"standard_storage_gb"`
	IAStorageGB           float64 `json:"ia_storage_gb"`
	StandardStorageCost   float64 `json:"standard_storage_cost"`
	IAStorageCost         float64 `json:"ia_storage_cost"`
	ThroughputMode        string  `json:"throughput_mode"`
	ProvisionedThroughput float64 `json:"provisioned_throughput_mbps"`
	ThroughputCost        float64 `json:"throughput_cost"`
	TotalMonthlyCost      float64 `json:"total_monthly_cost"`
	Region                string  `json:"region"`
}

type EFSVolumeSpec struct {
	FilesystemID      string
	Name              string
	SizeBytesStandard int64   // bytes in Standard storage class
	SizeBytesIA       int64   // bytes in Infrequent Access storage class
	ThroughputMode    string  // "bursting" | "provisioned" | "elastic"
	ProvisionedMBps   float64 // only for provisioned mode
	ElasticReadGB     float64 // GB transferred (elastic mode reads this month)
	ElasticWriteGB    float64 // GB transferred (elastic mode writes this month)
	Region            string
	AgeSeconds        float64
}

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 ForecastMonth struct {
	Month           string   `json:"month"` // "2026-04"
	ProjectedSpend  float64  `json:"projected_spend"`
	CumulativeSpend float64  `json:"cumulative_spend"`
	RemainingBudget float64  `json:"remaining_budget"`
	IsProjected     bool     `json:"is_projected"` // false for historical months
	ActualSpend     *float64 `json:"actual_spend,omitempty"`
}

type GDEWStatus struct {
	ProjectID        string    `json:"project_id"`
	MonthStart       time.Time `json:"month_start"`
	MonthEnd         time.Time `json:"month_end"`
	TotalSpendMTD    float64   `json:"total_spend_mtd"`
	EgressChargesMTD float64   `json:"egress_charges_mtd"`
	AvailableCredit  float64   `json:"available_credit"` // 15% of total spend
	UsedCredit       float64   `json:"used_credit"`      // min(egress, available)
	RemainingCredit  float64   `json:"remaining_credit"`
	NetEgressCost    float64   `json:"net_egress_cost"`
	CoveragePercent  float64   `json:"coverage_percent"` // used/egress * 100
	FullyCovered     bool      `json:"fully_covered"`
	NearingLimit     bool      `json:"nearing_limit"` // remaining < $20
	StatusMessage    string    `json:"status_message"`
	LastCalculated   time.Time `json:"last_calculated"`
}

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

type GrantRenewalAlert struct {
	RenewalDate       time.Time `json:"renewal_date"`
	DaysBeforeRenewal int       `json:"days_before_renewal"` // exhaustion N days before renewal
	ShortfallAmount   float64   `json:"shortfall_amount"`
	Message           string    `json:"message"`
}

type InstanceSpendLine struct {
	InstanceName string  `json:"instance_name"`
	InstanceType string  `json:"instance_type"`
	RunningHours float64 `json:"running_hours"`
	ComputeCost  float64 `json:"compute_cost"`
	StorageCost  float64 `json:"storage_cost"`
	TotalCost    float64 `json:"total_cost"`
}

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

type MonthlyReport struct {
	ProjectID   string              `json:"project_id"`
	Month       string              `json:"month"` // "2026-02"
	TotalSpend  float64             `json:"total_spend"`
	ByInstance  []InstanceSpendLine `json:"by_instance"`
	ByStorage   []StorageSpendLine  `json:"by_storage"`
	BudgetLimit float64             `json:"budget_limit"`
	Utilization float64             `json:"utilization"` // 0.0-1.0
	GeneratedAt time.Time           `json:"generated_at"`
}

type PaceStatus string

type PeriodWindow struct {
	Start         time.Time          `json:"start"`
	End           time.Time          `json:"end"`
	TotalDays     float64            `json:"total_days"`
	ElapsedDays   float64            `json:"elapsed_days"`
	RemainingDays float64            `json:"remaining_days"`
	PeriodType    types.BudgetPeriod `json:"period_type"`
}

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 S3CostDetail struct {
	BucketName       string             `json:"bucket_name"`
	Region           string             `json:"region"`
	StorageCost      float64            `json:"storage_cost"`
	RequestCost      float64            `json:"request_cost"`
	EgressCost       float64            `json:"egress_cost"`
	ReplicationCost  float64            `json:"replication_cost"`
	TotalMonthlyCost float64            `json:"total_monthly_cost"`
	StorageBreakdown map[string]float64 `json:"storage_breakdown"` // class -> $
}

type S3CostSpec struct {
	BucketName            string
	Region                string
	StorageClassBreakdown map[string]int64 // storage_class -> bytes
	RequestCounts         map[string]int64 // "GET","PUT","LIST","DELETE" -> count
	DataTransferGB        float64          // data transferred OUT (egress)
	ReplicationGB         float64          // cross-region replication GB
}

type ShortfallPrediction struct {
	ProjectID             string             `json:"project_id"`
	GeneratedAt           time.Time          `json:"generated_at"`
	CurrentDailyRate      float64            `json:"current_daily_rate"`
	TrendSlope            float64            `json:"trend_slope"` // $/day change per day (acceleration)
	PredictedExhaustionAt *time.Time         `json:"predicted_exhaustion_at,omitempty"`
	DaysUntilExhaustion   *int               `json:"days_until_exhaustion,omitempty"`
	WillExceedBudget      bool               `json:"will_exceed_budget"`
	ProbabilityExceed     float64            `json:"probability_exceed"` // 0.0–1.0
	ConfidenceLevel       string             `json:"confidence_level"`   // low / medium / high
	MonthlyForecasts      []ForecastMonth    `json:"monthly_forecasts"`
	GrantRenewalAlert     *GrantRenewalAlert `json:"grant_renewal_alert,omitempty"`
}

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

type StorageSpendLine struct {
	VolumeName string  `json:"volume_name"`
	VolumeType string  `json:"volume_type"`
	SizeGB     float64 `json:"size_gb"`
	Cost       float64 `json:"cost"`
}

type SurplusCalculator struct{}

type SurplusInfo struct {
	// CurrentPeriodSurplus is unspent amount in the current period (negative = over budget).
	CurrentPeriodSurplus float64 `json:"current_period_surplus"`
	// BankedSurplus is accumulated carry-over from prior completed periods.
	BankedSurplus float64 `json:"banked_surplus"`
	// EffectiveBalance is the current period allocation plus banked surplus (capped).
	EffectiveBalance float64 `json:"effective_balance"`
	// SurplusCapPercent is the maximum carry-over as a fraction of the total budget.
	SurplusCapPercent float64 `json:"surplus_cap_percent"`
	// SurplusCapped is true when the cap was applied.
	SurplusCapped bool `json:"surplus_capped"`
}

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"`
}