findingsource

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

type CategoryFilter struct {
	Code     *string // Filter by code
	Name     *string // Filter by name (partial match)
	IsActive *bool   // Filter by active status
	Search   *string // Full-text search
}

type CategoryRepository interface {
	// Create persists a new category.
	Create(ctx context.Context, category *Category) error

	// GetByID retrieves a category by its ID.
	GetByID(ctx context.Context, id shared.ID) (*Category, error)

	// GetByCode retrieves a category by its code.
	GetByCode(ctx context.Context, code string) (*Category, error)

	// Update updates an existing category.
	Update(ctx context.Context, category *Category) error

	// Delete removes a category by its ID.
	Delete(ctx context.Context, id shared.ID) error

	// List retrieves categories with pagination.
	List(ctx context.Context, filter CategoryFilter, page pagination.Pagination) (pagination.Result[*Category], error)

	// ListActive retrieves all active categories.
	ListActive(ctx context.Context) ([]*Category, error)
}

type Filter struct {
	CategoryID   *string  // Filter by category ID
	CategoryCode *string  // Filter by category code
	Code         *string  // Filter by code
	Name         *string  // Filter by name (partial match)
	IsActive     *bool    // Filter by active status
	IsSystem     *bool    // Filter by system type
	Search       *string  // Full-text search
	Codes        []string // Filter by multiple codes
}

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

type FindingSourceWithCategory struct {
	FindingSource *FindingSource
	Category      *Category
}

type ListOptions struct {
	Sort *pagination.SortOption
}

type Repository interface {
	// GetByID retrieves a finding source by its ID.
	GetByID(ctx context.Context, id shared.ID) (*FindingSource, error)

	// GetByCode retrieves a finding source by its code.
	GetByCode(ctx context.Context, code string) (*FindingSource, error)

	// List retrieves finding sources with filtering and pagination.
	List(ctx context.Context, filter Filter, opts ListOptions, page pagination.Pagination) (pagination.Result[*FindingSource], error)

	// ListWithCategory retrieves finding sources with their categories.
	ListWithCategory(ctx context.Context, filter Filter, opts ListOptions, page pagination.Pagination) (pagination.Result[*FindingSourceWithCategory], error)

	// ListActive retrieves all active finding sources.
	ListActive(ctx context.Context) ([]*FindingSource, error)

	// ListActiveWithCategory retrieves all active finding sources with their categories.
	ListActiveWithCategory(ctx context.Context) ([]*FindingSourceWithCategory, error)

	// ListActiveByCategory retrieves active finding sources by category.
	ListActiveByCategory(ctx context.Context, categoryID shared.ID) ([]*FindingSource, error)

	// ExistsByCode checks if a finding source with the given code exists.
	ExistsByCode(ctx context.Context, code string) (bool, error)

	// IsValidCode checks if the code is a valid active finding source.
	IsValidCode(ctx context.Context, code string) (bool, error)
}