Merge pull request #292 from simar-rekhi/develop

Addresses #249 with some testing already done

Author: mikehquan19

api/controllers/events.go

@@ -13,6 +13,7 @@ import (
 	"github.com/gin-gonic/gin"
 
 	"go.mongodb.org/mongo-driver/bson"
+	"go.mongodb.org/mongo-driver/bson/primitive"
 	"go.mongodb.org/mongo-driver/mongo"
 )
 
@@ -97,3 +98,135 @@ func EventsByBuilding(c *gin.Context) {
 
 	respond(c, http.StatusOK, "success", eventsByBuilding)
 }
+
+// @Id				eventsByRoom
+// @Router			/events/{date}/{building}/{room} [get]
+// @Description	"Returns all sections with meetings on the specified date in the specified building and room"
+// @Produce		json
+// @Param			date		path		string														true	"ISO date of the set of events to get"
+// @Param			building	path		string	                                                    true    "building abbreviation of the event location"
+// @Param           room        path        string                                                      true    "room number"
+// @Success     	200         {object}    schema.APIResponse[[]schema.SectionWithTime] 				"All sections with meetings on the specified date in the specified building and room"
+// @Failure		500			{object}	schema.APIResponse[string]										"A string describing the error"
+// @Failure		404			{object}	schema.APIResponse[string]										"A string describing the error"
+func EventsByRoom(c *gin.Context) {
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	date := c.Param("date")
+	building := c.Param("building")
+	room := c.Param("room")
+
+	var events schema.MultiBuildingEvents[schema.SectionWithTime]
+	var foundSections []schema.SectionWithTime
+
+	// find and parse matching date
+	err := eventsCollection.FindOne(ctx, bson.M{"date": date}).Decode(&events)
+	if err != nil {
+		respondWithInternalError(c, err)
+		return
+	}
+
+	// filter for the specified building and room
+	for _, b := range events.Buildings {
+		if b.Building == building {
+			for _, r := range b.Rooms {
+				if r.Room == room {
+					foundSections = r.Events
+					break
+				}
+			}
+			break
+		}
+	}
+
+	if len(foundSections) == 0 {
+		c.JSON(http.StatusNotFound, schema.APIResponse[string]{
+			Status:  http.StatusNotFound,
+			Message: "error",
+			Data:    "No events found for the specified building and room",
+		})
+		return
+	}
+
+	respond(c, http.StatusOK, "success", foundSections)
+}
+
+// @Id				sectionsByRoomDetailed
+// @Router			/events/{date}/{building}/{room}/sections [get]
+// @Description	"Returns full section objects with meetings on the specified date in the specified building and room"
+// @Produce		json
+// @Param			date		path		string												true	"ISO date of the set of events to get"
+// @Param			building	path		string	                                            true    "building abbreviation of the event location"
+// @Param           room        path        string                                              true    "room number"
+// @Success     	200         {object}    schema.APIResponse[[]schema.Section] 				"Full section objects with meetings on the specified date in the specified building and room"
+// @Failure		500			{object}	schema.APIResponse[string]							"A string describing the error"
+// @Failure		404			{object}	schema.APIResponse[string]							"A string describing the error"
+func SectionsByRoomDetailed(c *gin.Context) {
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	date := c.Param("date")
+	building := c.Param("building")
+	room := c.Param("room")
+
+	var events schema.MultiBuildingEvents[schema.SectionWithTime]
+
+	// Step 1: Find events for the specified date
+	err := eventsCollection.FindOne(ctx, bson.M{"date": date}).Decode(&events)
+	if err != nil {
+		respondWithInternalError(c, err)
+		return
+	}
+
+	// Step 2: Extract section IDs for the specified building and room
+	var sectionIDs []primitive.ObjectID
+	for _, b := range events.Buildings {
+		if b.Building == building {
+			for _, r := range b.Rooms {
+				if r.Room == room {
+					for _, event := range r.Events {
+						sectionIDs = append(sectionIDs, event.Section)
+					}
+					break
+				}
+			}
+			break
+		}
+	}
+
+	if len(sectionIDs) == 0 {
+		c.JSON(http.StatusNotFound, schema.APIResponse[string]{
+			Status:  http.StatusNotFound,
+			Message: "error",
+			Data:    "No sections found for the specified building and room",
+		})
+		return
+	}
+
+	// Step 3: Fetch full section objects from the sections collection
+	sectionsCollection := configs.GetCollection("sections")
+	cursor, err := sectionsCollection.Find(ctx, bson.M{"_id": bson.M{"$in": sectionIDs}})
+	if err != nil {
+		respondWithInternalError(c, err)
+		return
+	}
+	defer cursor.Close(ctx)
+
+	var sections []schema.Section
+	if err = cursor.All(ctx, &sections); err != nil {
+		respondWithInternalError(c, err)
+		return
+	}
+
+	if len(sections) == 0 {
+		c.JSON(http.StatusNotFound, schema.APIResponse[string]{
+			Status:  http.StatusNotFound,
+			Message: "error",
+			Data:    "No section details found",
+		})
+		return
+	}
+
+	respond(c, http.StatusOK, "success", sections)
+}

api/routes/events.go

@@ -13,4 +13,6 @@ func EventsRoute(router *gin.Engine) {
 	eventsGroup.OPTIONS("", controllers.Preflight)
 	eventsGroup.GET(":date", controllers.Events)
 	eventsGroup.GET(":date/:building", controllers.EventsByBuilding)
+	eventsGroup.GET(":date/:building/:room", controllers.EventsByRoom)
+	eventsGroup.GET(":date/:building/:room/sections", controllers.SectionsByRoomDetailed)
 }

api/server.go

@@ -11,6 +11,8 @@ import (
 	"github.com/gin-gonic/gin"
 	swaggerFiles "github.com/swaggo/files"
 	ginSwagger "github.com/swaggo/gin-swagger"
+
+	"github.com/UTDNebula/nebula-api/api/controllers"
 )
 
 // Unauthenticated placeholder endpoint for the built-in ginSwagger swagger documentation endpoint
@@ -109,3 +111,13 @@ func LogRequest(c *gin.Context) {
 	log.Printf("%s %s %s", c.Request.Method, c.Request.URL.Path, c.Request.Host)
 	c.Next()
 }
+
+func EventsRoute(router *gin.Engine) {
+	eventsGroup := router.Group("/events")
+	{
+		eventsGroup.GET("/:date", controllers.Events)
+		eventsGroup.GET("/:date/:building", controllers.EventsByBuilding)
+		eventsGroup.GET("/:date/:building/:room/sections", controllers.EventsByRoom)
+		eventsGroup.GET("/:date/:building/:room/sections", controllers.SectionsByRoomDetailed)
+	}
+}