feature #8: create Vote Constitution route

src/main/kotlin/fr/dcproject/Application.kt

@@ -161,6 +161,7 @@ fun Application.module(env: Env = PROD) {
             commentArticle(get())
             commentConstitution(get())
             voteArticle(get())
+            voteConstitution(get())
         }
     }
 

src/main/kotlin/fr/dcproject/routes/VoteConstitution.kt

@@ -0,0 +1,41 @@
+package fr.dcproject.routes
+
+import fr.dcproject.citizen
+import fr.dcproject.entity.Citizen
+import fr.dcproject.routes.VoteConstitutionPaths.ConstitutionVoteRequest.Content
+import fr.dcproject.security.voter.VoteVoter.Action.CREATE
+import fr.dcproject.security.voter.assertCan
+import io.ktor.application.call
+import io.ktor.http.HttpStatusCode
+import io.ktor.locations.KtorExperimentalLocationsAPI
+import io.ktor.locations.Location
+import io.ktor.locations.put
+import io.ktor.request.receive
+import io.ktor.response.respond
+import io.ktor.routing.Route
+import fr.dcproject.entity.Constitution as ConstitutionEntity
+import fr.dcproject.entity.Vote as VoteEntity
+import fr.dcproject.repository.VoteConstitution as VoteConstitutionRepository
+
+@KtorExperimentalLocationsAPI
+object VoteConstitutionPaths {
+    @Location("/constitutions/{constitution}/vote") class ConstitutionVoteRequest(val constitution: ConstitutionEntity) {
+        data class Content(var note: Int)
+    }
+    @Location("/citizens/{citizen}/votes/constitutions") class CitizenVoteConstitutionRequest(val citizen: Citizen)
+}
+
+@KtorExperimentalLocationsAPI
+fun Route.voteConstitution(repo: VoteConstitutionRepository) {
+    put<VoteConstitutionPaths.ConstitutionVoteRequest> {
+        val content = call.receive<Content>()
+        val vote = VoteEntity(
+            target = it.constitution,
+            note = content.note,
+            createdBy = this.citizen
+        )
+        assertCan(CREATE, vote)
+        repo.vote(vote)
+        call.respond(HttpStatusCode.Created)
+    }
+}

src/main/resources/openApi.yaml

@@ -403,6 +403,30 @@ paths:
       responses:
         201:
           description: Return only http status 201 on success
+  /constitutions/{constitution}/vote:
+    parameters:
+      - name: constitution
+        in: path
+        description: The ID of constitution
+        example: e74be8e4-6823-47c4-bd1b-789725b2fa8e
+        required: true
+        schema:
+          type: string
+          format: uuid
+    put:
+      security:
+        - JWTAuth: []
+      summary: Vote for one constitution
+      tags:
+        - vote
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/VoteRequest'
+      responses:
+        201:
+          description: Return only http status 201 on success
 
 components:
   parameters: