feat(go-swagger): Refactoring to use go-swagger templating system for most of the work

templates/go-swagger/custom/api/001-general.yaml.tmpl

@@ -0,0 +1,25 @@
+---
+definitions:
+  #
+  # GENERAL TYPEs
+  #
+  Error:
+    type: object
+    properties:
+      code:
+        type: integer
+        format: int64
+      message:
+        type: string
+  Metadata:
+    type: object
+    required:
+      - this
+      - total
+    properties:
+      total:
+        type: integer
+        format: int64
+      this:
+        type: integer
+        format: int64

templates/go-swagger/custom/api/002-monitoring.yaml.tmpl

@@ -0,0 +1,48 @@
+---
+tags:
+  - name: Monitoring
+    description: Monitoring routes
+definitions:
+  MonPing:
+    type: object
+    properties:
+      status:
+        type: object
+        x-nullable: true
+        properties:
+          database:
+            type: boolean
+            description: State of the database
+          application:
+            type: boolean
+            description: State of the application
+      details:
+        type: object
+        x-nullable: true
+        properties:
+          app_version:
+            type: string
+            description: Application version
+          git_hash:
+            type: string
+            description: Git hash of the last commit
+paths:
+  #
+  # SECTION : MONITORING
+  #
+  /unsecured/mon/ping:
+    get:
+      tags:
+        - Monitoring
+      summary: Health check
+      description: Return Health status of the app with additionnal info such as the version
+      operationId: getMonPing
+      responses:
+        200:
+          description: Health OK
+          schema:
+            $ref: "#/definitions/MonPing"
+        default:
+          description: Default error message
+          schema:
+            $ref: "#/definitions/Error"