change: introduce ordering to query filter enums (#251)

## What

Introduce order (base on declaration of individual enum values) to query
filter enums.

## Why

To allow slices of those enum values to be orderable, so in all places
in the system they look and behave the same.

## References

- [AT-2744](https://jira.greenbone.net/browse/AT-2744)
- [AT-2806](https://jira.greenbone.net/browse/AT-2806)

## Checklist

- [x] Tests _(newly added code have 100% tests coverage)_

Author: Marek Dalewski

go.mod

@@ -31,7 +31,11 @@ require (
 	dario.cat/mergo v1.0.2 // indirect
 	github.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c // indirect
 	github.com/KyleBanks/depth v1.2.1 // indirect
+	github.com/Masterminds/goutils v1.1.1 // indirect
+	github.com/Masterminds/semver/v3 v3.3.0 // indirect
+	github.com/Masterminds/sprig/v3 v3.3.0 // indirect
 	github.com/Microsoft/go-winio v0.6.2 // indirect
+	github.com/abice/go-enum v0.9.2 // indirect
 	github.com/bytedance/gopkg v0.1.3 // indirect
 	github.com/bytedance/sonic v1.14.1 // indirect
 	github.com/bytedance/sonic/loader v0.3.0 // indirect
@@ -42,6 +46,7 @@ require (
 	github.com/containerd/log v0.1.0 // indirect
 	github.com/containerd/platforms v0.2.1 // indirect
 	github.com/cpuguy83/dockercfg v0.3.2 // indirect
+	github.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect
 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
 	github.com/distribution/reference v0.6.0 // indirect
 	github.com/docker/docker v28.5.1+incompatible // indirect
@@ -72,7 +77,9 @@ require (
 	github.com/go-viper/mapstructure/v2 v2.4.0 // indirect
 	github.com/goccy/go-json v0.10.5 // indirect
 	github.com/goccy/go-yaml v1.18.0 // indirect
+	github.com/golang/mock v1.6.0 // indirect
 	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
+	github.com/huandu/xstrings v1.5.0 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
 	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
 	github.com/jackc/pgx/v5 v5.7.6 // indirect
@@ -81,12 +88,16 @@ require (
 	github.com/jinzhu/now v1.1.5 // indirect
 	github.com/klauspost/compress v1.18.1 // indirect
 	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
+	github.com/labstack/gommon v0.4.2 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/lufia/plan9stats v0.0.0-20240909124753-873cd0166683 // indirect
 	github.com/magiconair/properties v1.8.10 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-sqlite3 v1.14.32 // indirect
+	github.com/mattn/goveralls v0.0.12 // indirect
+	github.com/mitchellh/copystructure v1.2.0 // indirect
+	github.com/mitchellh/reflectwalk v1.0.2 // indirect
 	github.com/moby/docker-image-spec v1.3.1 // indirect
 	github.com/moby/go-archive v0.1.0 // indirect
 	github.com/moby/patternmatcher v0.6.0 // indirect
@@ -105,8 +116,10 @@ require (
 	github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 // indirect
 	github.com/quic-go/qpack v0.5.1 // indirect
 	github.com/quic-go/quic-go v0.55.0 // indirect
+	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/sagikazarmark/locafero v0.12.0 // indirect
 	github.com/shirou/gopsutil/v4 v4.25.9 // indirect
+	github.com/shopspring/decimal v1.4.0 // indirect
 	github.com/sirupsen/logrus v1.9.3 // indirect
 	github.com/spf13/afero v1.15.0 // indirect
 	github.com/spf13/cast v1.10.0 // indirect
@@ -117,6 +130,8 @@ require (
 	github.com/tklauser/numcpus v0.10.0 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/ugorji/go/codec v1.3.0 // indirect
+	github.com/urfave/cli/v2 v2.27.7 // indirect
+	github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 // indirect
 	github.com/yusufpapurcu/wmi v1.2.4 // indirect
 	go.opentelemetry.io/auto/sdk v1.2.1 // indirect
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.63.0 // indirect
@@ -133,9 +148,11 @@ require (
 	golang.org/x/net v0.46.0 // indirect
 	golang.org/x/sync v0.17.0 // indirect
 	golang.org/x/sys v0.37.0 // indirect
+	golang.org/x/telemetry v0.0.0-20251008203120-078029d740a8 // indirect
 	golang.org/x/text v0.30.0 // indirect
 	golang.org/x/time v0.14.0 // indirect
 	golang.org/x/tools v0.38.0 // indirect
+	golang.org/x/tools/cmd/cover v0.1.0-deprecated // indirect
 	google.golang.org/protobuf v1.36.10 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

go.sum

@@ -67,7 +67,7 @@ import "github.com/greenbone/opensight-golang-libraries/pkg/configReader"
 
 
 <a name="ReadEnvVarsIntoStruct"></a>
-## func [ReadEnvVarsIntoStruct](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/configReader/configReader.go#L21>)
+## func ReadEnvVarsIntoStruct
 
 ```go
 func ReadEnvVarsIntoStruct(s any) (any, error)

pkg/configReader/README.md

@@ -81,7 +81,7 @@ import "github.com/greenbone/opensight-golang-libraries/pkg/dbcrypt"
 
 
 <a name="Decrypt"></a>
-## func [Decrypt](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/dbcrypt/dbcrypt.go#L107>)
+## func Decrypt
 
 ```go
 func Decrypt(encrypted string, key []byte) (string, error)
@@ -90,7 +90,7 @@ func Decrypt(encrypted string, key []byte) (string, error)
 
 
 <a name="Encrypt"></a>
-## func [Encrypt](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/dbcrypt/dbcrypt.go#L85>)
+## func Encrypt
 
 ```go
 func Encrypt(plaintext string, key []byte) (string, error)
@@ -99,7 +99,7 @@ func Encrypt(plaintext string, key []byte) (string, error)
 
 
 <a name="DBCrypt"></a>
-## type [DBCrypt](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/dbcrypt/dbcrypt.go#L26-L28>)
+## type DBCrypt
 
 
 
@@ -110,7 +110,7 @@ type DBCrypt[T any] struct {
 ```
 
 <a name="DBCrypt[T].DecryptStruct"></a>
-### func \(\*DBCrypt\[T\]\) [DecryptStruct](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/dbcrypt/dbcrypt.go#L67>)
+### func \(\*DBCrypt\[T\]\) DecryptStruct
 
 ```go
 func (d *DBCrypt[T]) DecryptStruct(data *T) error
@@ -119,7 +119,7 @@ func (d *DBCrypt[T]) DecryptStruct(data *T) error
 DecryptStruct decrypts all fields of a struct that are tagged with \`encrypt:"true"\`
 
 <a name="DBCrypt[T].EncryptStruct"></a>
-### func \(\*DBCrypt\[T\]\) [EncryptStruct](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/dbcrypt/dbcrypt.go#L43>)
+### func \(\*DBCrypt\[T\]\) EncryptStruct
 
 ```go
 func (d *DBCrypt[T]) EncryptStruct(data *T) error

pkg/dbcrypt/README.md

@@ -45,7 +45,7 @@ var ErrorInternalResponse = ErrorResponse{
 ```
 
 <a name="ErrorResponse"></a>
-## type [ErrorResponse](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/errorResponses/errorResponses.go#L10-L15>)
+## type ErrorResponse
 
 
 
@@ -59,7 +59,7 @@ type ErrorResponse struct {
 ```
 
 <a name="NewErrorGenericResponse"></a>
-### func [NewErrorGenericResponse](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/errorResponses/errorResponses.go#L33>)
+### func NewErrorGenericResponse
 
 ```go
 func NewErrorGenericResponse(message ...any) ErrorResponse
@@ -68,7 +68,7 @@ func NewErrorGenericResponse(message ...any) ErrorResponse
 NewErrorGenericResponse returns a [ErrorResponse](<#ErrorResponse>) of type Generic with the given error message. The message is handled the same as [fmt.Println](<https://pkg.go.dev/fmt/#Println>).
 
 <a name="NewErrorValidationResponse"></a>
-### func [NewErrorValidationResponse](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/errorResponses/errorResponses.go#L41>)
+### func NewErrorValidationResponse
 
 ```go
 func NewErrorValidationResponse(title, details string, errors map[string]string) ErrorResponse

pkg/errorResponses/README.md

@@ -83,7 +83,7 @@ Package jobQueue provides a thread\-safe queue of requests to execute a predefin
 
 
 <a name="JobQueue"></a>
-## type [JobQueue](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/jobQueue/jobQueue.go#L20-L25>)
+## type JobQueue
 
 JobQueue is a thread\-safe queue of requests to execute a predefined function.
 
@@ -94,7 +94,7 @@ type JobQueue struct {
 ```
 
 <a name="NewJobQueue"></a>
-### func [NewJobQueue](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/jobQueue/jobQueue.go#L30>)
+### func NewJobQueue
 
 ```go
 func NewJobQueue(execFunc func() error, context context.Context) *JobQueue
@@ -103,7 +103,7 @@ func NewJobQueue(execFunc func() error, context context.Context) *JobQueue
 NewJobQueue creates a new job queue execFunc is the function to be executed for each request that is processed context is the context of the caller
 
 <a name="JobQueue.AddQueueRequest"></a>
-### func \(\*JobQueue\) [AddQueueRequest](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/jobQueue/jobQueue.go#L49>)
+### func \(\*JobQueue\) AddQueueRequest
 
 ```go
 func (q *JobQueue) AddQueueRequest(req Request)
@@ -116,7 +116,7 @@ The job queue is designed to be used in situations where multiple requests of th
 If a request is added to the queue while another request is being processed, the new request will be added to the queue and processed after the current request has finished. If there is already a request in the queue, the old request will be considered obsolete and replaced by the new request. \[jobQueue\_test.go\]\(jobQueue\_test.go\) illustrates this behaviour.
 
 <a name="Request"></a>
-## type [Request](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/jobQueue/jobQueue.go#L15-L17>)
+## type Request
 
 Request is a request to be processed by the queue and allows to provide an ID for identification
 

pkg/jobQueue/README.md

@@ -40,7 +40,7 @@ const (
 ```
 
 <a name="Ctx"></a>
-## func [Ctx](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L61>)
+## func Ctx
 
 ```go
 func Ctx(ctx context.Context) *zerolog.Logger
@@ -49,7 +49,7 @@ func Ctx(ctx context.Context) *zerolog.Logger
 Ctx retrieves the zerolog logger from the given context. If the context does not have a logger attached, the global logger is returned instead.
 
 <a name="SetupLogger"></a>
-## func [SetupLogger](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L49>)
+## func SetupLogger
 
 ```go
 func SetupLogger(logLevel string) error
@@ -77,7 +77,7 @@ if err != nil {
 ```
 
 <a name="WithCorrelationID"></a>
-## func [WithCorrelationID](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L105>)
+## func WithCorrelationID
 
 ```go
 func WithCorrelationID(ctx context.Context, correlationID string) context.Context
@@ -86,7 +86,7 @@ func WithCorrelationID(ctx context.Context, correlationID string) context.Contex
 WithCorrelationID adds a correlation ID to the logger in the context and returns the updated context.
 
 <a name="WithCtxField"></a>
-## func [WithCtxField](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L87>)
+## func WithCtxField
 
 ```go
 func WithCtxField(ctx context.Context, key, value string) context.Context
@@ -113,7 +113,7 @@ ctx = WithCtxField(ctx, "request_id", "abc123")
 ```
 
 <a name="WithJob"></a>
-## func [WithJob](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L100>)
+## func WithJob
 
 ```go
 func WithJob(ctx context.Context, jobName string) context.Context
@@ -122,7 +122,7 @@ func WithJob(ctx context.Context, jobName string) context.Context
 WithJob adds a job name field to the logger in the context and returns the updated context.
 
 <a name="WithNewCorrelationID"></a>
-## func [WithNewCorrelationID](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/logs.go#L111>)
+## func WithNewCorrelationID
 
 ```go
 func WithNewCorrelationID(ctx context.Context) context.Context

pkg/logs/README.md

@@ -14,7 +14,7 @@ import "github.com/greenbone/opensight-golang-libraries/pkg/logs/ginMiddleware"
 
 
 <a name="Logging"></a>
-## func [Logging](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/logs/ginMiddleware/ginMiddleware.go#L27>)
+## func Logging
 
 ```go
 func Logging() gin.HandlerFunc

pkg/logs/ginMiddleware/README.md

@@ -23,7 +23,7 @@ Package Notifications provides a client to communicate with the OpenSight Notifi
 
 
 <a name="Client"></a>
-## type [Client](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L27-L34>)
+## type Client
 
 Client can be used to send notifications
 
@@ -34,7 +34,7 @@ type Client struct {
 ```
 
 <a name="NewClient"></a>
-### func [NewClient](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L56>)
+### func NewClient
 
 ```go
 func NewClient(httpClient *http.Client, config Config, authentication KeycloakAuthentication) *Client
@@ -43,7 +43,7 @@ func NewClient(httpClient *http.Client, config Config, authentication KeycloakAu
 NewClient returns a new [Client](<#Client>) with the notification service address \(host:port\) set. As httpClient you can use e.g. \[http.DefaultClient\].
 
 <a name="Client.CreateNotification"></a>
-### func \(\*Client\) [CreateNotification](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L70>)
+### func \(\*Client\) CreateNotification
 
 ```go
 func (c *Client) CreateNotification(ctx context.Context, notification Notification) error
@@ -52,7 +52,7 @@ func (c *Client) CreateNotification(ctx context.Context, notification Notificati
 CreateNotification sends a notification to the notification service. It is retried up to the configured number of retries with an exponential backoff, So it can take some time until the functions returns.
 
 <a name="Client.GetAuthenticationToken"></a>
-### func \(\*Client\) [GetAuthenticationToken](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L108>)
+### func \(\*Client\) GetAuthenticationToken
 
 ```go
 func (c *Client) GetAuthenticationToken(ctx context.Context) (string, error)
@@ -61,7 +61,7 @@ func (c *Client) GetAuthenticationToken(ctx context.Context) (string, error)
 GetAuthenticationToken retrieves an authentication token using client credentials. It constructs a form\-encoded request, sends it with retry logic, and parses the response.
 
 <a name="Config"></a>
-## type [Config](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L37-L42>)
+## type Config
 
 Config configures the notification service client
 
@@ -75,7 +75,7 @@ type Config struct {
 ```
 
 <a name="KeycloakAuthentication"></a>
-## type [KeycloakAuthentication](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/notification.go#L46-L52>)
+## type KeycloakAuthentication
 
 KeycloakAuthentication holds the credentials and configuration details required for Keycloak authentication in the notification service.
 
@@ -90,7 +90,7 @@ type KeycloakAuthentication struct {
 ```
 
 <a name="Level"></a>
-## type [Level](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/model.go#L34>)
+## type Level
 
 Level describes the severity of the notification
 
@@ -109,7 +109,7 @@ const (
 ```
 
 <a name="Notification"></a>
-## type [Notification](<https://github.com/greenbone/opensight-golang-libraries/blob/main/pkg/notifications/model.go#L9-L18>)
+## type Notification