Merge pull request #219 from rebuy-de/m0007

add migration M0007 for adding dependency injection

migrations.md

@@ -3,6 +3,43 @@
 This file contains a list of tasks that are either required or at least
 strongly recommended to align projects using this SDK.
 
+## M0007 2024-11-08 Switch to Dependency Injection
+
+### Reasoning
+
+Our previous approach to have a single `Server` struct and to put all logic there gets messy pretty fast. Worse than
+that it is hard to refactor this to separate this into multiple structs or packages. Dependency injection will help us
+to separate those things in the very beginning of a project without manual wiring of dependencies.
+
+### Hints
+
+* The primary server.Run function should be replaced with a standalone `RunServer(ctx context.Context, c *dig.Container) error`
+* The `cmdutil.Runner` should setup environment specific dependencies (eg Redis vs Miniredis) while `RunServer` should
+  setup the independent ones (eg services, workers and handlers).
+
+### Examples
+
+The `RunServer` function could look like this:
+
+```go
+func RunServer(ctx context.Context, c *dig.Container) error {
+	return errors.Join(
+		// define services and repos
+		c.Provide(...),
+
+		// define HTTP handlers
+		webutil.ProvideHandler(c, handlers.New...),
+
+		// define workers
+		runutil.ProvideWorker(c, workers.New...),
+
+		// start all workers
+		runutil.RunProvidedWorkers(ctx, c),
+	)
+}
+```
+
+
 ## M0006 2024-09-20 Use webutil.NewServer
 
 ### Reasoning