Test docstrings

backend/handlers/admin/today_test.go

@@ -30,7 +30,8 @@ import (
 	"crussell/mw"
 )
 
-func TestAdminToday_CurrentNext(t *testing.T) {
+// TestAdminToday_CurrentNext verifies that an admin can retrieve the currently
+// in-progress booking and the next upcoming booking for the dashboard.
 	cleanup := setupTestDB(t)
 	defer cleanup()
 
@@ -104,7 +105,8 @@ func TestAdminToday_CurrentNext(t *testing.T) {
 	}
 }
 
-func TestAdminToday_Appointments(t *testing.T) {
+// TestAdminToday_Appointments tests that an admin can get a list of all
+// bookings scheduled for today with their details.
 	cleanup := setupTestDB(t)
 	defer cleanup()
 
@@ -178,7 +180,8 @@ func TestAdminToday_Appointments(t *testing.T) {
 	}
 }
 
-func TestAdminToday_PendingApprovals(t *testing.T) {
+// TestAdminToday_PendingApprovals verifies that an admin can see all pending
+// bookings that require approval/confirmation.
 	cleanup := setupTestDB(t)
 	defer cleanup()
 
@@ -252,15 +255,18 @@ func TestAdminToday_PendingApprovals(t *testing.T) {
 	}
 }
 
-func TestAdminNotifications_List(t *testing.T) {
+// TestAdminNotifications_List is skipped (WIP) - tests that an admin
+// can list all their notifications.
 	t.Skip("Skipping - WIP handler")
 }
 
-func TestAdminNotifications_Acknowledge(t *testing.T) {
+// TestAdminNotifications_Acknowledge is skipped (WIP) - tests that an
+// admin can acknowledge a notification.
 	t.Skip("Skipping - WIP handler")
 }
 
-func TestAdminToday_NonAdmin(t *testing.T) {
+// TestAdminToday_NonAdmin verifies that non-admin users receive HTTP 403
+// when accessing today's dashboard endpoints.
 	cleanup := setupTestDB(t)
 	defer cleanup()