assetgroup

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

type Criticality string

type Environment string

type Filter struct {
	TenantID      *string
	Search        *string
	Environments  []Environment
	Criticalities []Criticality
	BusinessUnit  *string
	Owner         *string
	Tags          []string
	HasFindings   *bool
	MinRiskScore  *int
	MaxRiskScore  *int
}

type GroupAsset struct {
	ID           shared.ID
	Name         string
	Type         string
	Status       string
	RiskScore    int
	FindingCount int
	LastSeen     string
}

type GroupFinding struct {
	ID           shared.ID
	Title        string
	Severity     string
	Status       string
	AssetID      shared.ID
	AssetName    string
	AssetType    string
	DiscoveredAt string
}

type ListOptions struct {
	Sort *pagination.SortOption
}

type Repository interface {
	// Create persists a new asset group.
	Create(ctx context.Context, group *AssetGroup) error

	// GetByID retrieves an asset group by its ID.
	GetByID(ctx context.Context, id shared.ID) (*AssetGroup, error)

	// Update updates an existing asset group.
	Update(ctx context.Context, group *AssetGroup) error

	// Delete removes an asset group by its ID.
	Delete(ctx context.Context, id shared.ID) error

	// List retrieves asset groups with filtering, sorting, and pagination.
	List(ctx context.Context, filter Filter, opts ListOptions, page pagination.Pagination) (pagination.Result[*AssetGroup], error)

	// Count returns the total number of asset groups matching the filter.
	Count(ctx context.Context, filter Filter) (int64, error)

	// ExistsByName checks if an asset group with the given name exists.
	ExistsByName(ctx context.Context, tenantID shared.ID, name string) (bool, error)

	// GetStats returns aggregated statistics for asset groups.
	GetStats(ctx context.Context, tenantID shared.ID) (*Stats, error)

	// AddAssets adds assets to a group.
	AddAssets(ctx context.Context, groupID shared.ID, assetIDs []shared.ID) error

	// RemoveAssets removes assets from a group.
	RemoveAssets(ctx context.Context, groupID shared.ID, assetIDs []shared.ID) error

	// GetGroupAssets returns assets belonging to a group.
	GetGroupAssets(ctx context.Context, groupID shared.ID, page pagination.Pagination) (pagination.Result[*GroupAsset], error)

	// GetGroupFindings returns findings for assets belonging to a group.
	GetGroupFindings(ctx context.Context, groupID shared.ID, page pagination.Pagination) (pagination.Result[*GroupFinding], error)

	// GetGroupIDsByAssetID returns IDs of groups containing a specific asset.
	GetGroupIDsByAssetID(ctx context.Context, assetID shared.ID) ([]shared.ID, error)

	// RecalculateCounts recalculates asset counts for a group.
	RecalculateCounts(ctx context.Context, groupID shared.ID) error

	// GetDistinctAssetTypes returns all unique asset types in a group.
	// Used for scan compatibility checking.
	GetDistinctAssetTypes(ctx context.Context, groupID shared.ID) ([]string, error)

	// GetDistinctAssetTypesMultiple returns all unique asset types across multiple groups.
	// Used when scan has multiple asset groups (AssetGroupIDs[]).
	GetDistinctAssetTypesMultiple(ctx context.Context, groupIDs []shared.ID) ([]string, error)

	// CountAssetsByType returns count of assets per type in a group.
	// Used for compatibility preview at scan creation.
	CountAssetsByType(ctx context.Context, groupID shared.ID) (map[string]int64, error)
}

type Stats struct {
	Total            int64
	ByEnvironment    map[Environment]int64
	ByCriticality    map[Criticality]int64
	TotalAssets      int64
	TotalFindings    int64
	AverageRiskScore float64
}