refactor CalendarRange repository and available range action

src/Bundle/ChillCalendarBundle/chill.api.specs.yaml

@@ -170,12 +170,35 @@ paths:
           description: "OK"
         422:
           description: "object with validation errors"
-  
-  /1.0/calendar/calendar-range-available.json:
+
+  /1.0/calendar/calendar-range-available/{userId}.json:
     get:
       tags:
         - calendar
       summary: Return a list of available calendar range items. Available means calendar-range not being taken by a calendar entity
+      parameters:
+          - name: userId
+            in: path
+            required: true
+            description: The user id
+            schema:
+                type: integer
+                format: integer
+                minimum: 1
+          - name: dateFrom
+            in: query
+            required: true
+            description: The date from, formatted as ISO8601 string
+            schema:
+                type: string
+                format: date-time
+          - name: dateTo
+            in: query
+            required: true
+            description: The date to, formatted as ISO8601 string
+            schema:
+                type: string
+                format: date-time
       responses:
         200:
-          description: "ok"
+          description: "ok"