feat: Notifiers CRUD (#337)

* introduce scaffold for new models

* wip: shoutrrr wrapper (may remove)

* update schema files

* gen: ent code

* gen: migrations

* go mod tidy

* add group_id to notifier

* db migration

* new mapper helpers

* notifier repo

* introduce experimental adapter pattern for hdlrs

* refactor adapters to fit more common use cases

* new routes for notifiers

* update errors to fix validation panic

* go tidy

* reverse checkbox label display

* wip: notifiers UI

* use badges instead of text

* improve documentation

* add scaffold schema reference

* remove notifier service

* refactor schema folder

* support group edges via scaffold

* delete test file

* include link to API docs

* audit and update documentation + improve format

* refactor schema edges

* refactor

* add custom validator

* set validate + order fields by name

* fix failing tests

backend/internal/data/ent/schema/user.go

@@ -5,6 +5,8 @@ import (
 	"entgo.io/ent/dialect/entsql"
 	"entgo.io/ent/schema/edge"
 	"entgo.io/ent/schema/field"
+	"entgo.io/ent/schema/mixin"
+	"github.com/google/uuid"
 	"github.com/hay-kot/homebox/backend/internal/data/ent/schema/mixins"
 )
 
@@ -16,6 +18,7 @@ type User struct {
 func (User) Mixin() []ent.Mixin {
 	return []ent.Mixin{
 		mixins.BaseMixin{},
+		GroupMixin{ref: "users"},
 	}
 }
 
@@ -35,11 +38,11 @@ func (User) Fields() []ent.Field {
 			Sensitive(),
 		field.Bool("is_superuser").
 			Default(false),
+		field.Bool("superuser").
+			Default(false),
 		field.Enum("role").
 			Default("user").
 			Values("user", "owner"),
-		field.Bool("superuser").
-			Default(false),
 		field.Time("activated_on").
 			Optional(),
 	}
@@ -48,13 +51,45 @@ func (User) Fields() []ent.Field {
 // Edges of the User.
 func (User) Edges() []ent.Edge {
 	return []ent.Edge{
-		edge.From("group", Group.Type).
-			Ref("users").
-			Required().
-			Unique(),
 		edge.To("auth_tokens", AuthTokens.Type).
 			Annotations(entsql.Annotation{
 				OnDelete: entsql.Cascade,
 			}),
+		edge.To("notifiers", Notifier.Type).
+			Annotations(entsql.Annotation{
+				OnDelete: entsql.Cascade,
+			}),
 	}
 }
+
+// UserMixin when embedded in an ent.Schema, adds a reference to
+// the Group entity.
+type UserMixin struct {
+	ref   string
+	field string
+	mixin.Schema
+}
+
+func (g UserMixin) Fields() []ent.Field {
+	if g.field != "" {
+		return []ent.Field{
+			field.UUID(g.field, uuid.UUID{}),
+		}
+	}
+
+	return nil
+
+}
+
+func (g UserMixin) Edges() []ent.Edge {
+	edge := edge.From("user", User.Type).
+		Ref(g.ref).
+		Unique().
+		Required()
+
+	if g.field != "" {
+		edge = edge.Field(g.field)
+	}
+
+	return []ent.Edge{edge}
+}