feat: add calendar scheduling feature for agent teams

- Implemented FindCalendarSchedules method in agentTeamScheduleService to retrieve schedules within a specified time range.
- Added new API endpoint fetchAgentTeamScheduleCalendar to fetch schedules for the calendar view.
- Created ScheduleCalendar component to display agent team schedules in a calendar format with drag-and-drop functionality for moving and resizing schedules.
- Updated EditDialog component to support deleting schedules and handling default values for new entries.
- Enhanced DashboardAgentTeamSchedulesPage to toggle between calendar and list views, and to load calendar data based on selected week.
- Added tests for FindCalendarSchedules to ensure correct schedule retrieval and validation of time ranges.

web/app/dashboard/agent-team-schedules/page.tsx

@@ -1,8 +1,12 @@
 "use client"
 
-import { useCallback, useEffect, useState } from "react"
+import { useCallback, useEffect, useMemo, useState } from "react"
 import {
   CalendarClockIcon,
+  CalendarDaysIcon,
+  ChevronLeftIcon,
+  ChevronRightIcon,
+  ListIcon,
   MoreHorizontalIcon,
   PlusIcon,
   RefreshCwIcon,
@@ -11,19 +15,7 @@ import {
 } from "lucide-react"
 import { toast } from "sonner"
 
-import {
-  createAgentTeamSchedule,
-  deleteAgentTeamSchedule,
-  fetchAgentTeamSchedules,
-  fetchAgentTeams,
-  updateAgentTeamSchedule,
-  type AdminAgentTeam,
-  type AdminAgentTeamSchedule,
-  type CreateAdminAgentTeamSchedulePayload,
-  type PageResult,
-} from "@/lib/api/admin"
-import { formatDateTime } from "@/lib/utils"
-import { EditDialog } from "./_components/edit"
+import { ListPagination } from "@/components/list-pagination"
 import { Button } from "@/components/ui/button"
 import { ButtonGroup } from "@/components/ui/button-group"
 import {
@@ -32,8 +24,6 @@ import {
   DropdownMenuItem,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu"
-import { Input } from "@/components/ui/input"
-import { ListPagination } from "@/components/list-pagination"
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
 import {
   Table,
@@ -43,23 +33,87 @@ import {
   TableHeader,
   TableRow,
 } from "@/components/ui/table"
+import {
+  createAgentTeamSchedule,
+  deleteAgentTeamSchedule,
+  fetchAgentTeamScheduleCalendar,
+  fetchAgentTeamSchedules,
+  fetchAgentTeamsAll,
+  updateAgentTeamSchedule,
+  type AdminAgentTeam,
+  type AdminAgentTeamSchedule,
+  type CreateAdminAgentTeamSchedulePayload,
+  type PageResult,
+  type UpdateAdminAgentTeamSchedulePayload,
+} from "@/lib/api/admin"
+import { formatDateTime } from "@/lib/utils"
+import { ScheduleCalendar } from "./_components/calendar"
+import { EditDialog } from "./_components/edit"
+
+type ViewMode = "calendar" | "list"
+
+function startOfDay(date: Date) {
+  const ret = new Date(date)
+  ret.setHours(0, 0, 0, 0)
+  return ret
+}
+
+function startOfWeek(date: Date) {
+  const ret = startOfDay(date)
+  const day = ret.getDay()
+  const offset = day === 0 ? -6 : 1 - day
+  ret.setDate(ret.getDate() + offset)
+  return ret
+}
+
+function addDays(date: Date, days: number) {
+  const ret = new Date(date)
+  ret.setDate(ret.getDate() + days)
+  return ret
+}
+
+function formatDateTimeValue(date: Date) {
+  const month = String(date.getMonth() + 1).padStart(2, "0")
+  const day = String(date.getDate()).padStart(2, "0")
+  const hour = String(date.getHours()).padStart(2, "0")
+  const minute = String(date.getMinutes()).padStart(2, "0")
+  const second = String(date.getSeconds()).padStart(2, "0")
+  return `${date.getFullYear()}-${month}-${day} ${hour}:${minute}:${second}`
+}
+
+function formatWeekRange(weekStart: Date) {
+  const weekEnd = addDays(weekStart, 6)
+  return `${weekStart.getFullYear()}-${String(weekStart.getMonth() + 1).padStart(2, "0")}-${String(weekStart.getDate()).padStart(2, "0")} 至 ${String(weekEnd.getMonth() + 1).padStart(2, "0")}-${String(weekEnd.getDate()).padStart(2, "0")}`
+}
 
 export default function DashboardAgentTeamSchedulesPage() {
+  const [viewMode, setViewMode] = useState<ViewMode>("calendar")
   const [teamFilterInput, setTeamFilterInput] = useState("all")
   const [teamFilter, setTeamFilter] = useState("all")
+  const [weekStart, setWeekStart] = useState(() => startOfWeek(new Date()))
   const [page, setPage] = useState(1)
   const [limit, setLimit] = useState(20)
   const [loading, setLoading] = useState(true)
+  const [calendarLoading, setCalendarLoading] = useState(true)
   const [saving, setSaving] = useState(false)
   const [actionLoadingId, setActionLoadingId] = useState<number | null>(null)
   const [dialogOpen, setDialogOpen] = useState(false)
   const [editingItem, setEditingItem] = useState<AdminAgentTeamSchedule | null>(null)
+  const [dialogDefaults, setDialogDefaults] = useState<Partial<CreateAdminAgentTeamSchedulePayload> | null>(null)
   const [teams, setTeams] = useState<AdminAgentTeam[]>([])
+  const [calendarItems, setCalendarItems] = useState<AdminAgentTeamSchedule[]>([])
   const [result, setResult] = useState<PageResult<AdminAgentTeamSchedule>>({
     results: [],
     page: { page: 1, limit: 20, total: 0 },
   })
 
+  const visibleTeams = useMemo(() => {
+    if (teamFilter === "all") {
+      return teams
+    }
+    return teams.filter((team) => String(team.id) === teamFilter)
+  }, [teamFilter, teams])
+
   const loadData = useCallback(async () => {
     setLoading(true)
     try {
@@ -76,18 +130,47 @@ export default function DashboardAgentTeamSchedulesPage() {
     }
   }, [limit, page, teamFilter])
 
+  const loadCalendarData = useCallback(async () => {
+    setCalendarLoading(true)
+    try {
+      const data = await fetchAgentTeamScheduleCalendar({
+        startAt: formatDateTimeValue(weekStart),
+        endAt: formatDateTimeValue(addDays(weekStart, 7)),
+        teamId: teamFilter === "all" ? undefined : teamFilter,
+      })
+      setCalendarItems(data)
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "加载客服组排班日历失败")
+    } finally {
+      setCalendarLoading(false)
+    }
+  }, [teamFilter, weekStart])
+
   const loadTeams = useCallback(async () => {
     try {
-      const data = await fetchAgentTeams()
+      const data = await fetchAgentTeamsAll()
       setTeams(data)
     } catch (error) {
       toast.error(error instanceof Error ? error.message : "加载客服组选项失败")
     }
   }, [])
 
+  const refreshActiveView = useCallback(async () => {
+    await Promise.all([
+      loadCalendarData(),
+      viewMode === "list" ? loadData() : Promise.resolve(),
+    ])
+  }, [loadCalendarData, loadData, viewMode])
+
   useEffect(() => {
-    void loadData()
-  }, [loadData])
+    void loadCalendarData()
+  }, [loadCalendarData])
+
+  useEffect(() => {
+    if (viewMode === "list") {
+      void loadData()
+    }
+  }, [loadData, viewMode])
 
   useEffect(() => {
     void loadTeams()
@@ -105,12 +188,14 @@ export default function DashboardAgentTeamSchedulesPage() {
     setPage(nextPage)
   }
 
-  function openCreateDialog() {
+  function openCreateDialog(defaults?: Partial<CreateAdminAgentTeamSchedulePayload>) {
     setEditingItem(null)
+    setDialogDefaults(defaults ?? null)
     setDialogOpen(true)
   }
 
   function openEditDialog(item: AdminAgentTeamSchedule) {
+    setDialogDefaults(null)
     setEditingItem(item)
     setDialogOpen(true)
   }
@@ -121,6 +206,7 @@ export default function DashboardAgentTeamSchedulesPage() {
     }
     if (!open) {
       setEditingItem(null)
+      setDialogDefaults(null)
     }
     setDialogOpen(open)
   }
@@ -140,7 +226,8 @@ export default function DashboardAgentTeamSchedulesPage() {
       }
       setDialogOpen(false)
       setEditingItem(null)
-      await loadData()
+      setDialogDefaults(null)
+      await refreshActiveView()
     } catch (error) {
       toast.error(error instanceof Error ? error.message : "保存客服组排班失败")
     } finally {
@@ -148,12 +235,15 @@ export default function DashboardAgentTeamSchedulesPage() {
     }
   }
 
-  async function handleDelete(item: AdminAgentTeamSchedule) {
-    setActionLoadingId(item.id)
+  async function handleDeleteById(id: number) {
+    setActionLoadingId(id)
     try {
-      await deleteAgentTeamSchedule(item.id)
+      await deleteAgentTeamSchedule(id)
       toast.success("已删除客服组排班")
-      await loadData()
+      setDialogOpen(false)
+      setEditingItem(null)
+      setDialogDefaults(null)
+      await refreshActiveView()
     } catch (error) {
       toast.error(error instanceof Error ? error.message : "删除客服组排班失败")
     } finally {
@@ -161,123 +251,201 @@ export default function DashboardAgentTeamSchedulesPage() {
     }
   }
 
+  async function handleDelete(item: AdminAgentTeamSchedule) {
+    await handleDeleteById(item.id)
+  }
+
+  async function handleCalendarUpdate(payload: UpdateAdminAgentTeamSchedulePayload) {
+    setActionLoadingId(payload.id)
+    try {
+      await updateAgentTeamSchedule(payload)
+      toast.success("已更新客服组排班")
+      await loadCalendarData()
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "更新客服组排班失败")
+      await loadCalendarData()
+    } finally {
+      setActionLoadingId(null)
+    }
+  }
+
   return (
     <>
       <div className="flex flex-1 flex-col gap-6 p-4 lg:p-6">
-        <div className="flex flex-col gap-2 xl:flex-row xl:items-center xl:justify-end">
-          <Select value={teamFilterInput} onValueChange={(value) => setTeamFilterInput(value ?? "all")}>
-            <SelectTrigger className="w-full xl:w-48">
-              <SelectValue placeholder="筛选客服组" />
-            </SelectTrigger>
-            <SelectContent>
-              <SelectItem value="all">全部客服组</SelectItem>
-              {teams.map((team) => (
-                <SelectItem key={team.id} value={String(team.id)}>
-                  {team.name}
-                </SelectItem>
-              ))}
-            </SelectContent>
-          </Select>
-          <Button variant="outline" onClick={applyFilters} disabled={loading}>
-            <SearchIcon />
-            查询
-          </Button>
-          <Button variant="outline" onClick={() => void loadData()} disabled={loading}>
-            <RefreshCwIcon className={loading ? "animate-spin" : ""} />
-            刷新列表
-          </Button>
-          <Button onClick={openCreateDialog}>
-            <PlusIcon />
-            新建
-          </Button>
-        </div>
-        <div className="space-y-4">
-          <div className="overflow-hidden rounded-2xl border bg-background">
-            <Table>
-              <TableHeader className="bg-muted/40">
-                <TableRow>
-                  <TableHead>客服组</TableHead>
-                  <TableHead>时间范围</TableHead>
-                  <TableHead>来源</TableHead>
-                  <TableHead className="w-[92px] text-right">操作</TableHead>
-                </TableRow>
-              </TableHeader>
-              <TableBody>
-                {result.results.map((item) => (
-                  <TableRow key={item.id}>
-                    <TableCell>
-                      <div className="flex items-start gap-3">
-                        <div className="mt-0.5 flex size-10 items-center justify-center rounded-2xl bg-muted text-muted-foreground">
-                          <CalendarClockIcon className="size-4" />
-                        </div>
-                        <div className="min-w-0">
-                          <div className="font-medium">{item.teamName || `客服组#${item.teamId}`}</div>
-                          <div className="text-xs text-muted-foreground">组ID：{item.teamId}</div>
-                        </div>
-                      </div>
-                    </TableCell>
-                    <TableCell>
-                      <div className="text-sm">{formatDateTime(item.startAt)}</div>
-                      <div className="text-sm text-muted-foreground">{formatDateTime(item.endAt)}</div>
-                    </TableCell>
-                    <TableCell>
-                      <div className="text-sm">{item.sourceType}</div>
-                    </TableCell>
-                    <TableCell className="text-right">
-                      <ButtonGroup className="ml-auto">
-                        <Button variant="outline" size="sm" onClick={() => openEditDialog(item)}>
-                          编辑
-                        </Button>
-                        <DropdownMenu>
-                          <DropdownMenuTrigger
-                            render={<Button variant="outline" size="icon-sm" />}
-                            aria-label={`更多操作 ${item.startAt}`}
-                          >
-                            <MoreHorizontalIcon />
-                          </DropdownMenuTrigger>
-                          <DropdownMenuContent align="end" className="w-40 min-w-40">
-                            <DropdownMenuItem
-                              onClick={() => void handleDelete(item)}
-                              className="text-destructive focus:text-destructive"
-                            >
-                              <Trash2Icon />
-                              {actionLoadingId === item.id ? "删除中..." : "删除"}
-                            </DropdownMenuItem>
-                          </DropdownMenuContent>
-                        </DropdownMenu>
-                      </ButtonGroup>
-                    </TableCell>
-                  </TableRow>
-                ))}
-                {!loading && result.results.length === 0 ? (
-                  <TableRow>
-                    <TableCell colSpan={4} className="py-12 text-center text-muted-foreground">
-                      没有匹配的客服组排班
-                    </TableCell>
-                  </TableRow>
-                ) : null}
-              </TableBody>
-            </Table>
+        <div className="flex flex-col gap-3 xl:flex-row xl:items-center xl:justify-between">
+          <div className="flex flex-wrap items-center gap-2">
+            <ButtonGroup>
+              <Button
+                variant={viewMode === "calendar" ? "default" : "outline"}
+                size="sm"
+                onClick={() => setViewMode("calendar")}
+              >
+                <CalendarDaysIcon />
+                日历
+              </Button>
+              <Button
+                variant={viewMode === "list" ? "default" : "outline"}
+                size="sm"
+                onClick={() => setViewMode("list")}
+              >
+                <ListIcon />
+                列表
+              </Button>
+            </ButtonGroup>
+            {viewMode === "calendar" ? (
+              <ButtonGroup>
+                <Button variant="outline" size="icon-sm" onClick={() => setWeekStart(addDays(weekStart, -7))} aria-label="上一周">
+                  <ChevronLeftIcon />
+                </Button>
+                <Button variant="outline" size="sm" onClick={() => setWeekStart(startOfWeek(new Date()))}>
+                  本周
+                </Button>
+                <Button variant="outline" size="icon-sm" onClick={() => setWeekStart(addDays(weekStart, 7))} aria-label="下一周">
+                  <ChevronRightIcon />
+                </Button>
+              </ButtonGroup>
+            ) : null}
+            {viewMode === "calendar" ? (
+              <div className="text-sm text-muted-foreground">{formatWeekRange(weekStart)}</div>
+            ) : null}
+          </div>
+
+          <div className="flex flex-col gap-2 sm:flex-row sm:items-center xl:justify-end">
+            <Select value={teamFilterInput} onValueChange={(value) => setTeamFilterInput(value ?? "all")}>
+              <SelectTrigger className="w-full sm:w-48">
+                <SelectValue placeholder="筛选客服组" />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value="all">全部客服组</SelectItem>
+                {teams.map((team) => (
+                  <SelectItem key={team.id} value={String(team.id)}>
+                    {team.name}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+            <Button variant="outline" onClick={applyFilters} disabled={loading || calendarLoading}>
+              <SearchIcon />
+              查询
+            </Button>
+            <Button
+              variant="outline"
+              onClick={() => void refreshActiveView()}
+              disabled={loading || calendarLoading}
+            >
+              <RefreshCwIcon className={loading || calendarLoading ? "animate-spin" : ""} />
+              刷新
+            </Button>
+            <Button onClick={() => openCreateDialog()}>
+              <PlusIcon />
+              新建
+            </Button>
           </div>
-          <ListPagination
-            page={result.page.page}
-            total={result.page.total}
-            limit={limit}
-            loading={loading}
-            onPageChange={handlePageChange}
-            onLimitChange={(nextLimit) => {
-              setLimit(nextLimit)
-              setPage(1)
-            }}
-          />
         </div>
+
+        {viewMode === "calendar" ? (
+          <ScheduleCalendar
+            weekStart={weekStart}
+            teams={visibleTeams}
+            schedules={calendarItems}
+            loading={calendarLoading}
+            savingId={actionLoadingId}
+            onCreate={openCreateDialog}
+            onEdit={openEditDialog}
+            onMove={handleCalendarUpdate}
+            onResize={handleCalendarUpdate}
+          />
+        ) : (
+          <div className="space-y-4">
+            <div className="overflow-hidden rounded-lg border bg-background">
+              <Table>
+                <TableHeader className="bg-muted/40">
+                  <TableRow>
+                    <TableHead>客服组</TableHead>
+                    <TableHead>时间范围</TableHead>
+                    <TableHead>来源</TableHead>
+                    <TableHead className="w-[92px] text-right">操作</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {result.results.map((item) => (
+                    <TableRow key={item.id}>
+                      <TableCell>
+                        <div className="flex items-start gap-3">
+                          <div className="mt-0.5 flex size-10 items-center justify-center rounded-md bg-muted text-muted-foreground">
+                            <CalendarClockIcon className="size-4" />
+                          </div>
+                          <div className="min-w-0">
+                            <div className="font-medium">{item.teamName || `客服组#${item.teamId}`}</div>
+                            <div className="text-xs text-muted-foreground">组ID：{item.teamId}</div>
+                          </div>
+                        </div>
+                      </TableCell>
+                      <TableCell>
+                        <div className="text-sm">{formatDateTime(item.startAt)}</div>
+                        <div className="text-sm text-muted-foreground">{formatDateTime(item.endAt)}</div>
+                      </TableCell>
+                      <TableCell>
+                        <div className="text-sm">{item.sourceType}</div>
+                      </TableCell>
+                      <TableCell className="text-right">
+                        <ButtonGroup className="ml-auto">
+                          <Button variant="outline" size="sm" onClick={() => openEditDialog(item)}>
+                            编辑
+                          </Button>
+                          <DropdownMenu>
+                            <DropdownMenuTrigger
+                              render={<Button variant="outline" size="icon-sm" />}
+                              aria-label={`更多操作 ${item.startAt}`}
+                            >
+                              <MoreHorizontalIcon />
+                            </DropdownMenuTrigger>
+                            <DropdownMenuContent align="end" className="w-40 min-w-40">
+                              <DropdownMenuItem
+                                onClick={() => void handleDelete(item)}
+                                className="text-destructive focus:text-destructive"
+                              >
+                                <Trash2Icon />
+                                {actionLoadingId === item.id ? "删除中..." : "删除"}
+                              </DropdownMenuItem>
+                            </DropdownMenuContent>
+                          </DropdownMenu>
+                        </ButtonGroup>
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                  {!loading && result.results.length === 0 ? (
+                    <TableRow>
+                      <TableCell colSpan={4} className="py-12 text-center text-muted-foreground">
+                        没有匹配的客服组排班
+                      </TableCell>
+                    </TableRow>
+                  ) : null}
+                </TableBody>
+              </Table>
+            </div>
+            <ListPagination
+              page={result.page.page}
+              total={result.page.total}
+              limit={limit}
+              loading={loading}
+              onPageChange={handlePageChange}
+              onLimitChange={(nextLimit) => {
+                setLimit(nextLimit)
+                setPage(1)
+              }}
+            />
+          </div>
+        )}
       </div>
       <EditDialog
         open={dialogOpen}
-        saving={saving}
+        saving={saving || actionLoadingId === editingItem?.id}
         itemId={editingItem?.id ?? null}
+        defaultValues={dialogDefaults}
         onOpenChange={handleDialogOpenChange}
         onSubmit={handleSubmit}
+        onDelete={handleDeleteById}
       />
     </>
   )