From 822368ed034fbc3bd0f67c67cf909f6dcc057603 Mon Sep 17 00:00:00 2001
From: eric-kitagawa <kitagawa.e@northeastern.edu>
Date: Fri, 17 Apr 2026 07:04:50 -0400
Subject: [PATCH 1/5] feat: hookup orderby to be

---
 .../src/components/rooms/OrderByDropdown.tsx  | 26 ++++++++++--------
 .../web/src/components/rooms/RoomsList.tsx    | 27 ++++++++++++++-----
 .../web/src/components/rooms/RoomsToolbar.tsx | 14 ++++++----
 .../web/src/routes/_protected/rooms.index.tsx |  9 ++++---
 4 files changed, 49 insertions(+), 27 deletions(-)

diff --git a/clients/web/src/components/rooms/OrderByDropdown.tsx b/clients/web/src/components/rooms/OrderByDropdown.tsx
index fc6480af..618c2fc9 100644
--- a/clients/web/src/components/rooms/OrderByDropdown.tsx
+++ b/clients/web/src/components/rooms/OrderByDropdown.tsx
@@ -2,22 +2,26 @@ import { ChevronDown } from "lucide-react";
 import { useState } from "react";
 import { cn } from "@/lib/utils";
 
+export type RoomSortOption = "ascending" | "descending" | "urgency";
+
 type OrderByDropdownProps = {
-  ascending: boolean;
-  setAscending: (ascending: boolean) => void;
+  sortOption: RoomSortOption;
+  setSortOption: (option: RoomSortOption) => void;
 };
 
-const OPTIONS: Array<{ label: string; ascending: boolean }> = [
-  { label: "Ascending", ascending: true },
-  { label: "Descending", ascending: false },
+const OPTIONS: Array<{ label: string; value: RoomSortOption }> = [
+  { label: "Ascending", value: "ascending" },
+  { label: "Descending", value: "descending" },
+  { label: "Urgency", value: "urgency" },
 ];
 
 export function OrderByDropdown({
-  ascending,
-  setAscending,
+  sortOption,
+  setSortOption,
 }: OrderByDropdownProps) {
   const [open, setOpen] = useState(false);
-  const currentLabel = ascending ? "Ascending" : "Descending";
+  const currentLabel =
+    OPTIONS.find((o) => o.value === sortOption)?.label ?? "Ascending";
 
   return (
     <div
@@ -49,17 +53,17 @@ export function OrderByDropdown({
       {open && (
         <div className="absolute left-0 top-full z-10 flex w-full flex-col gap-1 rounded-b border border-t-0 border-stroke-subtle bg-bg-primary p-1 shadow-sm">
           {OPTIONS.map((option) => {
-            const isSelected = option.ascending === ascending;
+            const isSelected = option.value === sortOption;
             return (
               <button
-                key={option.label}
+                key={option.value}
                 type="button"
                 className={cn(
                   "flex items-center rounded px-3 py-1 text-left text-base text-text-default",
                   isSelected ? "bg-bg-selected" : "hover:bg-bg-container",
                 )}
                 onClick={() => {
-                  setAscending(option.ascending);
+                  setSortOption(option.value);
                   setOpen(false);
                 }}
               >
diff --git a/clients/web/src/components/rooms/RoomsList.tsx b/clients/web/src/components/rooms/RoomsList.tsx
index 2155b122..4d97af58 100644
--- a/clients/web/src/components/rooms/RoomsList.tsx
+++ b/clients/web/src/components/rooms/RoomsList.tsx
@@ -1,34 +1,47 @@
 import { useMemo } from "react";
 import type { RoomWithOptionalGuestBooking } from "@shared";
+import type { RoomSortOption } from "@/components/rooms/OrderByDropdown";
 import { RoomCard } from "@/components/rooms/RoomCard";
 
 type RoomsListProps = {
   rooms: Array<RoomWithOptionalGuestBooking>;
   onRoomSelect: (room: RoomWithOptionalGuestBooking) => void;
-  ascending: boolean;
+  sortOption: RoomSortOption;
   selectedRoomNumber?: number | null;
 };
 
-function sortRoomsByRoomNumber(
+const PRIORITY_RANK: Record<string, number> = {
+  high: 3,
+  medium: 2,
+  low: 1,
+};
+
+function sortRooms(
   rooms: Array<RoomWithOptionalGuestBooking>,
-  ascending: boolean,
+  sortOption: RoomSortOption,
 ): Array<RoomWithOptionalGuestBooking> {
   return [...rooms].sort((a, b) => {
+    if (sortOption === "urgency") {
+      const ar = PRIORITY_RANK[a.priority ?? ""] ?? 0;
+      const br = PRIORITY_RANK[b.priority ?? ""] ?? 0;
+      if (br !== ar) return br - ar;
+      return (a.room_number ?? 0) - (b.room_number ?? 0);
+    }
     const an = a.room_number ?? 0;
     const bn = b.room_number ?? 0;
-    return ascending ? an - bn : bn - an;
+    return sortOption === "ascending" ? an - bn : bn - an;
   });
 }
 
 export function RoomsList({
   rooms,
   onRoomSelect,
-  ascending,
+  sortOption,
   selectedRoomNumber = null,
 }: RoomsListProps) {
   const sortedRooms = useMemo(
-    () => sortRoomsByRoomNumber(rooms, ascending),
-    [rooms, ascending],
+    () => sortRooms(rooms, sortOption),
+    [rooms, sortOption],
   );
 
   return (
diff --git a/clients/web/src/components/rooms/RoomsToolbar.tsx b/clients/web/src/components/rooms/RoomsToolbar.tsx
index 05be7520..14f8b79e 100644
--- a/clients/web/src/components/rooms/RoomsToolbar.tsx
+++ b/clients/web/src/components/rooms/RoomsToolbar.tsx
@@ -1,6 +1,7 @@
 import { SearchBar } from "../ui/SearchBar";
 import { FloorDropdown } from "./FloorDropdown";
 import { OrderByDropdown } from "./OrderByDropdown";
+import type { RoomSortOption } from "./OrderByDropdown";
 import type { RoomsPageFilters } from "@/hooks/use-rooms-filters";
 import { FilterTag } from "@/components/rooms/FilterTag";
 import { RoomsFilterPopover } from "@/components/rooms/RoomsFilterPopover";
@@ -14,8 +15,8 @@ type RoomsToolbarProps = {
   onChangeFloors: (floors: Array<number>) => void;
   onRemoveFilterChip: (chip: string) => void;
   onApplyFilterChips: (chips: Array<string>) => void;
-  ascending: boolean;
-  setAscending: (ascending: boolean) => void;
+  sortOption: RoomSortOption;
+  setSortOption: (option: RoomSortOption) => void;
 };
 
 export function RoomsToolbar({
@@ -25,8 +26,8 @@ export function RoomsToolbar({
   onChangeFloors,
   onApplyFilterChips,
   onRemoveFilterChip,
-  ascending,
-  setAscending,
+  sortOption,
+  setSortOption,
 }: RoomsToolbarProps) {
   const hasActiveFilterTags =
     filters.floors.length > 0 || filters.filterChips.length > 0;
@@ -52,7 +53,10 @@ export function RoomsToolbar({
           <span className="whitespace-nowrap text-sm text-text-subtle">
             Sort by:
           </span>
-          <OrderByDropdown ascending={ascending} setAscending={setAscending} />
+          <OrderByDropdown
+            sortOption={sortOption}
+            setSortOption={setSortOption}
+          />
         </div>
       </div>
       {hasActiveFilterTags ? (
diff --git a/clients/web/src/routes/_protected/rooms.index.tsx b/clients/web/src/routes/_protected/rooms.index.tsx
index 0bc4e57c..4edaf6ff 100644
--- a/clients/web/src/routes/_protected/rooms.index.tsx
+++ b/clients/web/src/routes/_protected/rooms.index.tsx
@@ -3,6 +3,7 @@ import { useState } from "react";
 import { useQuery } from "@tanstack/react-query";
 import { MakeRequestPriority, usePostRoomsHook } from "@shared";
 import type { Request, RoomWithOptionalGuestBooking } from "@shared";
+import type { RoomSortOption } from "@/components/rooms/OrderByDropdown";
 import { GlobalTaskInput } from "@/components/ui/GlobalTaskInput";
 import { PageShell } from "@/components/ui/PageShell";
 import { RoomsToolbar } from "@/components/rooms/RoomsToolbar";
@@ -27,7 +28,7 @@ function RoomsPage() {
     });
   const [selectedRoom, setSelectedRoom] =
     useState<RoomWithOptionalGuestBooking | null>(null);
-  const [ascending, setAscending] = useState(true);
+  const [sortOption, setSortOption] = useState<RoomSortOption>("ascending");
   const [generatedData, setGeneratedData] = useState<{
     name?: string;
     description?: string;
@@ -103,12 +104,12 @@ function RoomsPage() {
             onChangeFloors={setFloors}
             onApplyFilterChips={setFilterChips}
             onRemoveFilterChip={removeFilterChip}
-            ascending={ascending}
-            setAscending={setAscending}
+            sortOption={sortOption}
+            setSortOption={setSortOption}
           />
           <RoomsList
             rooms={rooms?.items ?? []}
-            ascending={ascending}
+            sortOption={sortOption}
             onRoomSelect={(room) => {
               setGeneratedData(null);
               setSelectedRoom(room);

From 4c7246e4e4080a1905adc1e013601730c3025f8a Mon Sep 17 00:00:00 2001
From: eric-kitagawa <kitagawa.e@northeastern.edu>
Date: Fri, 17 Apr 2026 07:15:51 -0400
Subject: [PATCH 2/5] feat: remove all client-side sorting

---
 .../web/src/components/rooms/RoomsList.tsx    | 34 +------------------
 .../web/src/routes/_protected/rooms.index.tsx |  4 +--
 2 files changed, 3 insertions(+), 35 deletions(-)

diff --git a/clients/web/src/components/rooms/RoomsList.tsx b/clients/web/src/components/rooms/RoomsList.tsx
index 4d97af58..a195b706 100644
--- a/clients/web/src/components/rooms/RoomsList.tsx
+++ b/clients/web/src/components/rooms/RoomsList.tsx
@@ -1,54 +1,22 @@
-import { useMemo } from "react";
 import type { RoomWithOptionalGuestBooking } from "@shared";
-import type { RoomSortOption } from "@/components/rooms/OrderByDropdown";
 import { RoomCard } from "@/components/rooms/RoomCard";
 
 type RoomsListProps = {
   rooms: Array<RoomWithOptionalGuestBooking>;
   onRoomSelect: (room: RoomWithOptionalGuestBooking) => void;
-  sortOption: RoomSortOption;
   selectedRoomNumber?: number | null;
 };
 
-const PRIORITY_RANK: Record<string, number> = {
-  high: 3,
-  medium: 2,
-  low: 1,
-};
-
-function sortRooms(
-  rooms: Array<RoomWithOptionalGuestBooking>,
-  sortOption: RoomSortOption,
-): Array<RoomWithOptionalGuestBooking> {
-  return [...rooms].sort((a, b) => {
-    if (sortOption === "urgency") {
-      const ar = PRIORITY_RANK[a.priority ?? ""] ?? 0;
-      const br = PRIORITY_RANK[b.priority ?? ""] ?? 0;
-      if (br !== ar) return br - ar;
-      return (a.room_number ?? 0) - (b.room_number ?? 0);
-    }
-    const an = a.room_number ?? 0;
-    const bn = b.room_number ?? 0;
-    return sortOption === "ascending" ? an - bn : bn - an;
-  });
-}
-
 export function RoomsList({
   rooms,
   onRoomSelect,
-  sortOption,
   selectedRoomNumber = null,
 }: RoomsListProps) {
-  const sortedRooms = useMemo(
-    () => sortRooms(rooms, sortOption),
-    [rooms, sortOption],
-  );
-
   return (
     <section className="flex-1 min-h-0 flex flex-col overflow-hidden">
       <nav className="flex-1 min-h-0">
         <ul className="flex flex-col gap-4 h-full overflow-y-auto min-h-0 pb-24 [&::-webkit-scrollbar]:hidden">
-          {sortedRooms.map((room) => (
+          {rooms.map((room) => (
             <li key={room.room_number} className="min-w-0">
               <RoomCard
                 room={room}
diff --git a/clients/web/src/routes/_protected/rooms.index.tsx b/clients/web/src/routes/_protected/rooms.index.tsx
index 4edaf6ff..a27d236b 100644
--- a/clients/web/src/routes/_protected/rooms.index.tsx
+++ b/clients/web/src/routes/_protected/rooms.index.tsx
@@ -41,11 +41,12 @@ function RoomsPage() {
   const postRooms = usePostRoomsHook();
 
   const { data: rooms } = useQuery({
-    queryKey: ["rooms", filters.floors],
+    queryKey: ["rooms", filters.floors, sortOption],
     queryFn: () =>
       postRooms({
         floors: filters.floors.length > 0 ? filters.floors : undefined,
         limit: 10,
+        sort: sortOption,
       }),
   });
 
@@ -109,7 +110,6 @@ function RoomsPage() {
           />
           <RoomsList
             rooms={rooms?.items ?? []}
-            sortOption={sortOption}
             onRoomSelect={(room) => {
               setGeneratedData(null);
               setSelectedRoom(room);

From 7b28d788d0dcbe09fa28cb7441cd671e10251cb2 Mon Sep 17 00:00:00 2001
From: eric-kitagawa <kitagawa.e@northeastern.edu>
Date: Fri, 17 Apr 2026 08:08:24 -0400
Subject: [PATCH 3/5] lint

---
 clients/web/src/components/rooms/SortByContainer.tsx | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/clients/web/src/components/rooms/SortByContainer.tsx b/clients/web/src/components/rooms/SortByContainer.tsx
index ca2aa559..e5502eda 100644
--- a/clients/web/src/components/rooms/SortByContainer.tsx
+++ b/clients/web/src/components/rooms/SortByContainer.tsx
@@ -1,18 +1,19 @@
 import { OrderByDropdown } from "./OrderByDropdown";
+import type { RoomSortOption } from "./OrderByDropdown";
 
 type SortByContainerProps = {
-  ascending: boolean;
-  setAscending: (ascending: boolean) => void;
+  sortOption: RoomSortOption;
+  setSortOption: (option: RoomSortOption) => void;
 };
 
 export function SortByContainer({
-  ascending,
-  setAscending,
+  sortOption,
+  setSortOption,
 }: SortByContainerProps) {
   return (
     <span className="text-sm text-text-subtle flex items-center gap-1 pt-6">
       Sort by:{" "}
-      <OrderByDropdown ascending={ascending} setAscending={setAscending} />
+      <OrderByDropdown sortOption={sortOption} setSortOption={setSortOption} />
     </span>
   );
 }

From 1441b5f121c3fd26db69feca5145cea4a2addb67 Mon Sep 17 00:00:00 2001
From: eric-kitagawa <kitagawa.e@northeastern.edu>
Date: Fri, 17 Apr 2026 08:44:39 -0400
Subject: [PATCH 4/5] feat: handler + repo + model + tests for overview tasks
 endpoint

---
 backend/docs/swagger.yaml                     |  47 +++++
 backend/internal/handler/requests.go          |  33 ++++
 backend/internal/handler/requests_test.go     | 178 ++++++++++++++++++
 backend/internal/models/requests.go           |   6 +
 backend/internal/repository/requests.go       |  96 ++++++++++
 backend/internal/service/server.go            |   1 +
 .../service/storage/postgres/repo_types.go    |   1 +
 7 files changed, 362 insertions(+)

diff --git a/backend/docs/swagger.yaml b/backend/docs/swagger.yaml
index 85c52f44..eaa863a0 100644
--- a/backend/docs/swagger.yaml
+++ b/backend/docs/swagger.yaml
@@ -641,6 +641,15 @@ definitions:
       user_id:
         type: string
     type: object
+  RequestsOverview:
+    properties:
+      pending:
+        type: integer
+      unassigned:
+        type: integer
+      urgent:
+        type: integer
+    type: object
   RoomRequestsResponse:
     properties:
       assigned:
@@ -1938,6 +1947,44 @@ paths:
       summary: Get requests feed
       tags:
       - requests
+  /requests/overview:
+    post:
+      consumes:
+      - application/json
+      description: Returns counts of urgent (high priority), unassigned, and pending
+        tasks scoped to the rooms matching the given filters. Accepts the same filter
+        body as POST /rooms. Does not mutate any data.
+      parameters:
+      - description: Hotel ID
+        in: header
+        name: X-Hotel-ID
+        required: true
+        type: string
+      - description: Room filters
+        in: body
+        name: body
+        schema:
+          $ref: '#/definitions/FilterRoomsRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/RequestsOverview'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/github_com_generate_selfserve_internal_errs.HTTPError'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/github_com_generate_selfserve_internal_errs.HTTPError'
+      security:
+      - BearerAuth: []
+      summary: Get requests overview counts
+      tags:
+      - requests
   /rooms:
     post:
       consumes:
diff --git a/backend/internal/handler/requests.go b/backend/internal/handler/requests.go
index 781d850c..efaa6d00 100644
--- a/backend/internal/handler/requests.go
+++ b/backend/internal/handler/requests.go
@@ -521,6 +521,39 @@ func (r *RequestsHandler) GetRequestsFeed(c *fiber.Ctx) error {
 	return c.JSON(page)
 }
 
+// GetRequestsOverview godoc
+// @Summary      Get requests overview counts
+// @Description  Returns counts of urgent (high priority), unassigned, and pending tasks scoped to the rooms matching the given filters. Accepts the same filter body as POST /rooms. Does not mutate any data.
+// @Tags         requests
+// @Accept       json
+// @Produce      json
+// @Param        X-Hotel-ID  header  string                    true  "Hotel ID"
+// @Param        body        body    models.FilterRoomsRequest false "Room filters"
+// @Success      200  {object}  models.RequestsOverview
+// @Failure      400  {object}  errs.HTTPError
+// @Failure      500  {object}  errs.HTTPError
+// @Security     BearerAuth
+// @Router       /requests/overview [post]
+func (r *RequestsHandler) GetRequestsOverview(c *fiber.Ctx) error {
+	hotelID, err := hotelIDFromHeader(c)
+	if err != nil {
+		return err
+	}
+
+	var body models.FilterRoomsRequest
+	if err := httpx.BindAndValidate(c, &body); err != nil {
+		return err
+	}
+
+	overview, err := r.RequestRepository.GetRequestsOverview(c.Context(), hotelID, &body)
+	if err != nil {
+		slog.Error("failed to get requests overview", "err", err, "hotelID", hotelID)
+		return errs.InternalServerError()
+	}
+
+	return c.JSON(overview)
+}
+
 // parseFeedCursor decodes a universal cursor: "priority_rank|created_at_nano|id".
 // Returns zero values and nil error for an empty cursor (first page).
 func parseFeedCursor(cursor string) (id string, createdAt time.Time, priorityRank int, err error) {
diff --git a/backend/internal/handler/requests_test.go b/backend/internal/handler/requests_test.go
index 7f4ef741..cd8e1310 100644
--- a/backend/internal/handler/requests_test.go
+++ b/backend/internal/handler/requests_test.go
@@ -27,6 +27,7 @@ type mockRequestRepository struct {
 	findRequestsByRoomIDAndUserIDFunc  func(ctx context.Context, roomID, hotelID, userID, cursorID string, cursorVersion time.Time, limit int) ([]*models.GuestRequest, error)
 	findUnassignedRequestsByRoomIDFunc func(ctx context.Context, roomID, hotelID, cursorID string, cursorVersion time.Time, limit int) ([]*models.GuestRequest, error)
 	findRequestsPaginatedFunc          func(ctx context.Context, input *models.RequestsFeedInput, cursorID string, cursorCreatedAt time.Time, cursorPriorityRank int, limit int) ([]*models.GuestRequest, error)
+	getRequestsOverviewFunc            func(ctx context.Context, hotelID string, filters *models.FilterRoomsRequest) (*models.RequestsOverview, error)
 }
 
 func (m *mockRequestRepository) InsertRequest(ctx context.Context, req *models.Request) (*models.Request, error) {
@@ -61,6 +62,10 @@ func (m *mockRequestRepository) FindRequestsPaginated(ctx context.Context, input
 	return m.findRequestsPaginatedFunc(ctx, input, cursorID, cursorCreatedAt, cursorPriorityRank, limit)
 }
 
+func (m *mockRequestRepository) GetRequestsOverview(ctx context.Context, hotelID string, filters *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+	return m.getRequestsOverviewFunc(ctx, hotelID, filters)
+}
+
 type mockLLMService struct {
 	runGenerateRequestFunc func(ctx context.Context, input aiflows.GenerateRequestInput) (aiflows.EnrichedGenerateRequestOutput, error)
 }
@@ -1967,3 +1972,176 @@ func TestRequestHandler_GetGenerateRequestStatus(t *testing.T) {
 		assert.Contains(t, string(body), "Extra Towels Request")
 	})
 }
+
+func TestRequestHandler_GetRequestsOverview(t *testing.T) {
+	t.Parallel()
+
+	const validHotelID = "org_521e8400-e458-41d4-a716-446655440000"
+
+	t.Run("returns 200 with counts on success", func(t *testing.T) {
+		t.Parallel()
+
+		mock := &mockRequestRepository{
+			getRequestsOverviewFunc: func(_ context.Context, _ string, _ *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+				return &models.RequestsOverview{Urgent: 3, Unassigned: 5, Pending: 7}, nil
+			},
+		}
+
+		app := fiber.New()
+		h := NewRequestsHandler(mock, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{}`))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 200, resp.StatusCode)
+
+		body, _ := io.ReadAll(resp.Body)
+		assert.Contains(t, string(body), `"urgent":3`)
+		assert.Contains(t, string(body), `"unassigned":5`)
+		assert.Contains(t, string(body), `"pending":7`)
+	})
+
+	t.Run("returns zeros when no active tasks exist", func(t *testing.T) {
+		t.Parallel()
+
+		mock := &mockRequestRepository{
+			getRequestsOverviewFunc: func(_ context.Context, _ string, _ *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+				return &models.RequestsOverview{}, nil
+			},
+		}
+
+		app := fiber.New()
+		h := NewRequestsHandler(mock, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{}`))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 200, resp.StatusCode)
+
+		body, _ := io.ReadAll(resp.Body)
+		assert.Contains(t, string(body), `"urgent":0`)
+		assert.Contains(t, string(body), `"unassigned":0`)
+		assert.Contains(t, string(body), `"pending":0`)
+	})
+
+	t.Run("passes hotel_id from header to repository", func(t *testing.T) {
+		t.Parallel()
+
+		var capturedHotelID string
+		mock := &mockRequestRepository{
+			getRequestsOverviewFunc: func(_ context.Context, hotelID string, _ *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+				capturedHotelID = hotelID
+				return &models.RequestsOverview{}, nil
+			},
+		}
+
+		app := fiber.New()
+		h := NewRequestsHandler(mock, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{}`))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 200, resp.StatusCode)
+		assert.Equal(t, validHotelID, capturedHotelID)
+	})
+
+	t.Run("passes filters to repository", func(t *testing.T) {
+		t.Parallel()
+
+		var capturedFilters *models.FilterRoomsRequest
+		mock := &mockRequestRepository{
+			getRequestsOverviewFunc: func(_ context.Context, _ string, filters *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+				capturedFilters = filters
+				return &models.RequestsOverview{}, nil
+			},
+		}
+
+		app := fiber.New()
+		h := NewRequestsHandler(mock, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		body := `{"floors":[1,2],"status":["occupied"],"attributes":["deluxe"],"advanced":["arrivals-today"]}`
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(body))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 200, resp.StatusCode)
+
+		require.NotNil(t, capturedFilters)
+		require.NotNil(t, capturedFilters.Floors)
+		assert.Equal(t, []int{1, 2}, *capturedFilters.Floors)
+		assert.Equal(t, []string{"occupied"}, capturedFilters.Status)
+		assert.Equal(t, []string{"deluxe"}, capturedFilters.Attributes)
+		assert.Equal(t, []string{"arrivals-today"}, capturedFilters.Advanced)
+	})
+
+	t.Run("returns 400 when X-Hotel-ID header is missing", func(t *testing.T) {
+		t.Parallel()
+
+		app := fiber.New(fiber.Config{ErrorHandler: errs.ErrorHandler})
+		h := NewRequestsHandler(&mockRequestRepository{}, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{}`))
+		req.Header.Set("Content-Type", "application/json")
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 400, resp.StatusCode)
+
+		body, _ := io.ReadAll(resp.Body)
+		assert.Contains(t, string(body), "hotel_id")
+	})
+
+	t.Run("returns 400 on invalid JSON body", func(t *testing.T) {
+		t.Parallel()
+
+		app := fiber.New(fiber.Config{ErrorHandler: errs.ErrorHandler})
+		h := NewRequestsHandler(&mockRequestRepository{}, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{invalid`))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 400, resp.StatusCode)
+	})
+
+	t.Run("returns 500 on repository error", func(t *testing.T) {
+		t.Parallel()
+
+		mock := &mockRequestRepository{
+			getRequestsOverviewFunc: func(_ context.Context, _ string, _ *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+				return nil, errors.New("db connection failed")
+			},
+		}
+
+		app := fiber.New(fiber.Config{ErrorHandler: errs.ErrorHandler})
+		h := NewRequestsHandler(mock, nil, nil)
+		app.Post("/requests/overview", h.GetRequestsOverview)
+
+		req := httptest.NewRequest("POST", "/requests/overview", bytes.NewBufferString(`{}`))
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("X-Hotel-ID", validHotelID)
+
+		resp, err := app.Test(req)
+		require.NoError(t, err)
+		assert.Equal(t, 500, resp.StatusCode)
+	})
+}
diff --git a/backend/internal/models/requests.go b/backend/internal/models/requests.go
index b70f150b..9f38b3bf 100644
--- a/backend/internal/models/requests.go
+++ b/backend/internal/models/requests.go
@@ -168,6 +168,12 @@ type RoomRequestsResponse struct {
 	Unassigned []*GuestRequest `json:"unassigned"`
 } //@name RoomRequestsResponse
 
+type RequestsOverview struct {
+	Urgent     int `json:"urgent"`
+	Unassigned int `json:"unassigned"`
+	Pending    int `json:"pending"`
+} //@name RequestsOverview
+
 type GuestRequest struct {
 	ID              string    `json:"id"`
 	Name            string    `json:"name"`
diff --git a/backend/internal/repository/requests.go b/backend/internal/repository/requests.go
index 2c890c5b..ed53263d 100644
--- a/backend/internal/repository/requests.go
+++ b/backend/internal/repository/requests.go
@@ -352,6 +352,102 @@ func (r *RequestsRepository) FindRequestsPaginated(
 	return scanGuestRequests(rows)
 }
 
+func (r *RequestsRepository) GetRequestsOverview(ctx context.Context, hotelID string, filters *models.FilterRoomsRequest) (*models.RequestsOverview, error) {
+	statusFilters := filters.Status
+	if statusFilters == nil {
+		statusFilters = []string{}
+	}
+	attrFilters := filters.Attributes
+	if attrFilters == nil {
+		attrFilters = []string{}
+	}
+	advFilters := filters.Advanced
+	if advFilters == nil {
+		advFilters = []string{}
+	}
+
+	// $1 = hotelID, $2 = floors, $3 = status filters, $4 = attribute filters, $5 = advanced filters
+	var overview models.RequestsOverview
+	err := r.db.QueryRow(ctx, `
+		WITH room_task_info AS (
+			SELECT
+				room_id::uuid AS room_id,
+				BOOL_OR(user_id IS NULL) AS has_unassigned_tasks
+			FROM (
+				SELECT DISTINCT ON (id) id, room_id, status, user_id
+				FROM requests
+				WHERE hotel_id = $1 AND room_id IS NOT NULL
+				ORDER BY id, request_version DESC
+			) latest
+			WHERE status NOT IN ('completed', 'archived')
+			GROUP BY room_id
+		),
+		room_enriched AS (
+			SELECT
+				r.id, r.suite_type, r.room_status, r.is_accessible,
+				CASE WHEN COUNT(gb_active.id) > 0 THEN 'active' ELSE 'inactive' END AS booking_status,
+				BOOL_OR(gb_arrive.id IS NOT NULL) AS has_arrivals_today,
+				BOOL_OR(gb_depart.id IS NOT NULL) AS has_departures_today,
+				COALESCE(BOOL_OR(rti.has_unassigned_tasks), FALSE) AS has_unassigned_tasks
+			FROM rooms r
+			LEFT JOIN guest_bookings gb_active ON r.id = gb_active.room_id
+				AND gb_active.status = 'active'
+				AND gb_active.hotel_id = $1
+			LEFT JOIN guest_bookings gb_arrive ON r.id = gb_arrive.room_id
+				AND gb_arrive.hotel_id = $1
+				AND gb_arrive.arrival_date = CURRENT_DATE
+			LEFT JOIN guest_bookings gb_depart ON r.id = gb_depart.room_id
+				AND gb_depart.hotel_id = $1
+				AND gb_depart.departure_date = CURRENT_DATE
+			LEFT JOIN room_task_info rti ON r.id = rti.room_id
+			WHERE r.hotel_id = $1
+				AND ($2::int[] IS NULL OR r.floor = ANY($2))
+			GROUP BY r.id, r.suite_type, r.room_status, r.is_accessible
+		),
+		filtered_rooms AS (
+			SELECT id FROM room_enriched
+			WHERE (cardinality($3::text[]) = 0 OR (
+					('occupied'   = ANY($3) AND booking_status = 'active')
+				 OR ('vacant'     = ANY($3) AND booking_status = 'inactive')
+				 OR ('open-tasks' = ANY($3) AND has_unassigned_tasks)
+			))
+			  AND (cardinality($4::text[]) = 0 OR (
+					('standard'   = ANY($4) AND LOWER(suite_type) = 'standard')
+				 OR ('deluxe'     = ANY($4) AND LOWER(suite_type) = 'deluxe')
+				 OR ('suite'      = ANY($4) AND LOWER(suite_type) LIKE '%suite%')
+				 OR ('accessible' = ANY($4) AND is_accessible)
+			))
+			  AND (cardinality($5::text[]) = 0 OR (
+					('arrivals-today'   = ANY($5) AND has_arrivals_today)
+				 OR ('departures-today' = ANY($5) AND has_departures_today)
+			))
+		),
+		latest_requests AS (
+			SELECT DISTINCT ON (id) id, room_id, status, priority, user_id
+			FROM requests
+			WHERE hotel_id = $1 AND room_id IS NOT NULL
+			ORDER BY id, request_version DESC
+		),
+		active_requests AS (
+			SELECT lr.priority, lr.status, lr.user_id
+			FROM latest_requests lr
+			INNER JOIN filtered_rooms fr ON fr.id = lr.room_id::uuid
+			WHERE lr.status NOT IN ('completed', 'archived')
+		)
+		SELECT
+			COUNT(*) FILTER (WHERE priority = 'high')  AS urgent,
+			COUNT(*) FILTER (WHERE user_id IS NULL)     AS unassigned,
+			COUNT(*) FILTER (WHERE status = 'pending')  AS pending
+		FROM active_requests
+	`, hotelID, filters.Floors, statusFilters, attrFilters, advFilters).
+		Scan(&overview.Urgent, &overview.Unassigned, &overview.Pending)
+	if err != nil {
+		return nil, err
+	}
+
+	return &overview, nil
+}
+
 func scanGuestRequests(rows pgx.Rows) ([]*models.GuestRequest, error) {
 	requests := make([]*models.GuestRequest, 0)
 	for rows.Next() {
diff --git a/backend/internal/service/server.go b/backend/internal/service/server.go
index 4aca9bc6..0c09f9d8 100644
--- a/backend/internal/service/server.go
+++ b/backend/internal/service/server.go
@@ -236,6 +236,7 @@ func setupRoutes(app *fiber.App, repo *storage.Repository, genkitInstance *aiflo
 
 	// Request routes
 	api.Post("/requests/feed", reqsHandler.GetRequestsFeed)
+	api.Post("/requests/overview", reqsHandler.GetRequestsOverview)
 	api.Route("/request", func(r fiber.Router) {
 		r.Post("/", reqsHandler.CreateRequest)
 		r.Post("/generate", reqsHandler.GenerateRequest)
diff --git a/backend/internal/service/storage/postgres/repo_types.go b/backend/internal/service/storage/postgres/repo_types.go
index 4c099a5d..df41fb9f 100644
--- a/backend/internal/service/storage/postgres/repo_types.go
+++ b/backend/internal/service/storage/postgres/repo_types.go
@@ -56,6 +56,7 @@ type RequestsRepository interface {
 	FindRequestsByRoomIDAndUserID(ctx context.Context, roomID, hotelID, userID, cursorID string, cursorVersion time.Time, limit int) ([]*models.GuestRequest, error)
 	FindUnassignedRequestsByRoomIDAndUserID(ctx context.Context, roomID, hotelID, cursorID string, cursorVersion time.Time, limit int) ([]*models.GuestRequest, error)
 	FindRequestsPaginated(ctx context.Context, input *models.RequestsFeedInput, cursorID string, cursorCreatedAt time.Time, cursorPriorityRank int, limit int) ([]*models.GuestRequest, error)
+	GetRequestsOverview(ctx context.Context, hotelID string, filters *models.FilterRoomsRequest) (*models.RequestsOverview, error)
 }
 
 type HotelsRepository interface {

From 32308c802d3c3f0ee3a4fee4ca9aced42d718750 Mon Sep 17 00:00:00 2001
From: eric-kitagawa <kitagawa.e@northeastern.edu>
Date: Fri, 17 Apr 2026 09:54:30 -0400
Subject: [PATCH 5/5] lint

---
 backend/internal/handler/requests.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/backend/internal/handler/requests.go b/backend/internal/handler/requests.go
index e3fabebc..392ae299 100644
--- a/backend/internal/handler/requests.go
+++ b/backend/internal/handler/requests.go
@@ -564,6 +564,7 @@ func (r *RequestsHandler) GetRequestsOverview(c *fiber.Ctx) error {
 
 	return c.JSON(overview)
 }
+
 // GetRequestActivity godoc
 // @Summary      Get request activity history
 // @Description  Returns an ordered list of activity events derived from the request's version history