Add swagger docs to document the API

Signed-off-by: Jo Vandeginste <[email protected]>

.prettierignore

@@ -2,3 +2,4 @@
 /assets/output.css
 /vendor/
 /pkg/
+/docs/swagger.*

.swaggo

@@ -0,0 +1,5 @@
+replace null.String string
+replace null.Int64 integer
+replace null.Bool boolean
+replace sql.NullTime time
+replace time.Duration integer

Makefile

@@ -22,7 +22,7 @@ clean:
 dev:
 	air
 
-build: build-dist build-tw build-server build-docker
+build: build-swagger build-dist build-tw build-server build-docker
 
 build-server:
 	go build \
@@ -38,6 +38,12 @@ build-docker:
 		--build-arg GIT_REF_TYPE="$(GIT_REF_TYPE)" \
 		.
 
+build-swagger:
+	swag init \
+		--parseDependency \
+		--dir ./pkg/app/,./,./vendor/gorm.io/gorm/,./vendor/github.com/codingsince1985/geo-golang/ \
+		--generalInfo api_handlers.go
+
 build-tw:
 	npx tailwindcss -i ./main.css -o ./assets/output.css