docs: Update README with development commands and enhance callback controller documentation

Author: idylicaro

README.md

@@ -117,6 +117,13 @@ An API designed to manage events, supporting features like event creation, user
 - **Repositories**: Handle database interactions.
 - **Models**: Define data structures.
 
+
+### Development Commands
+
+- `./scripts/migrate.sh up`
+- `./scripts/migrate.sh down`
+- `./scripts/migrate.sh version`
+
 ## Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request for any suggestions or improvements.

internal/auth/callback/controller.go

@@ -11,6 +11,16 @@ type Controller struct {
 	Service Service
 }
 
+// @Summary Handle the callback from the authentication provider
+// @Description Handle the callback from the authentication provider
+// @Tags Auth
+// @Accept json
+// @Produce json
+// @Param provider path string true "Provider name"
+// @Param code query string true "Code from the provider"
+// @Success 200 {object} string
+// @Failure 400 {object} string
+// @Router /auth/{provider}/callback [get]
 func (c *Controller) HandleCallback(ctx *gin.Context) {
 	provider := ctx.Param("provider")
 	code := ctx.Query("code")