feat: implement extractor of room historical environmental data

Author: AndreaGiulianelli

Diff for: src/main/kotlin/application/controller/RoomController.kt

@@ -44,6 +44,13 @@ class RoomController(
             this.roomDatabaseManager.findBy(roomId, dateTime)
         }
 
+    override fun getRoomEnvironmentalData(
+        roomId: RoomID,
+        start: Instant,
+        end: Instant,
+    ): List<Pair<Instant, RoomEnvironmentalData>>? =
+        this.roomDatabaseManager.getRoomEnvironmentalData(roomId, start, end)
+
     override fun getRooms(): Set<Room> = this.roomDatabaseManager.getAllRooms()
 
     override fun updateRoomEnvironmentalData(

Diff for: src/main/kotlin/application/service/RoomService.kt

@@ -52,6 +52,20 @@ object RoomService {
         override fun execute(): Room? = this.roomRepository.findBy(roomID, dateTime)
     }
 
+    /**
+     * Application Service that has the object to obtain all the environmental data about a room, identified by
+     * its [roomID], within a range of date [startDateTime] - [endDateTime] using the provided [roomRepository].
+     */
+    class ExportRoomEnvironmentalData(
+        private val roomID: RoomID,
+        private val roomRepository: RoomRepository,
+        private val startDateTime: Instant,
+        private val endDateTime: Instant?
+    ) : ApplicationService<List<Pair<Instant, RoomEnvironmentalData>>?> {
+        override fun execute(): List<Pair<Instant, RoomEnvironmentalData>>? =
+            this.roomRepository.getRoomEnvironmentalData(roomID, startDateTime, endDateTime ?: Instant.now())
+    }
+
     /**
      * Application Service that has the objective of getting all the room that are inside the building using
      * the provided [roomRepository].

Diff for: src/main/kotlin/infrastructure/database/DatabaseManager.kt

@@ -25,12 +25,14 @@ import entity.zone.Room
 import entity.zone.RoomEnvironmentalData
 import entity.zone.RoomID
 import org.litote.kmongo.KMongo
+import org.litote.kmongo.ascendingSort
 import org.litote.kmongo.descendingSort
 import org.litote.kmongo.div
 import org.litote.kmongo.eq
 import org.litote.kmongo.find
 import org.litote.kmongo.findOne
 import org.litote.kmongo.getCollection
+import org.litote.kmongo.gt
 import org.litote.kmongo.lte
 import org.litote.kmongo.setValue
 import java.time.Instant
@@ -80,6 +82,30 @@ class DatabaseManager(customConnectionString: String? = null) : RoomDatabaseMana
             }.toRoomEnvironmentalData()
         )
 
+    override fun getRoomEnvironmentalData(
+        roomId: RoomID,
+        start: Instant,
+        end: Instant,
+    ): List<Pair<Instant, RoomEnvironmentalData>>? {
+        var roomCurrentData = this.findBy(roomId, start)?.environmentalData
+        if (roomCurrentData != null) {
+            // The room exist
+            return this.roomTimeSeriesCollection.find(
+                TimeSeriesRoomEnvironmentalData::metadata / TimeSeriesRoomMetadata::roomId eq roomId,
+                TimeSeriesRoomEnvironmentalData::dateTime gt start,
+                TimeSeriesRoomEnvironmentalData::dateTime lte end
+            ).ascendingSort(TimeSeriesRoomEnvironmentalData::dateTime).toList().map {
+                // update current data about the room in order to have an update image of it
+                val updatedRoom = mapOf(it.metadata.type to it).toRoomEnvironmentalData(roomCurrentData)
+                roomCurrentData = updatedRoom
+                // map the update to corresponding date time
+                it.dateTime to updatedRoom
+            }
+        } else {
+            return null // The room does not exist
+        }
+    }
+
     override fun getAllRooms(): Set<Room> = this.roomCollection.find().toSet()
 
     override fun updateRoomEnvironmentalData(