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.

internal/controllers/dashboard/agent_team_schedule_controller.go

@@ -31,6 +31,28 @@ func (c *AgentTeamScheduleController) AnyList() *web.JsonResult {
 	return web.JsonData(&web.PageResult{Results: results, Page: paging})
 }
 
+func (c *AgentTeamScheduleController) AnyCalendar() *web.JsonResult {
+	if _, err := services.AuthService.RequirePermission(c.Ctx, constants.PermissionAgentTeamScheduleView); err != nil {
+		return web.JsonError(err)
+	}
+	startAt, _ := params.Get(c.Ctx, "startAt")
+	endAt, _ := params.Get(c.Ctx, "endAt")
+	teamID, _ := params.GetInt64(c.Ctx, "teamId")
+	list, err := services.AgentTeamScheduleService.FindCalendarSchedules(request.AgentTeamScheduleCalendarRequest{
+		StartAt: startAt,
+		EndAt:   endAt,
+		TeamID:  teamID,
+	})
+	if err != nil {
+		return web.JsonError(err)
+	}
+	results := make([]response.AgentTeamScheduleResponse, 0, len(list))
+	for _, item := range list {
+		results = append(results, buildAgentTeamScheduleResponse(&item))
+	}
+	return web.JsonData(results)
+}
+
 func (c *AgentTeamScheduleController) GetBy(id int64) *web.JsonResult {
 	if _, err := services.AuthService.RequirePermission(c.Ctx, constants.PermissionAgentTeamScheduleView); err != nil {
 		return web.JsonError(err)

internal/pkg/dto/request/agent_request.go

@@ -62,3 +62,9 @@ type UpdateAgentTeamScheduleRequest struct {
 type DeleteAgentTeamScheduleRequest struct {
 	ID int64 `json:"id"`
 }
+
+type AgentTeamScheduleCalendarRequest struct {
+	StartAt string `json:"startAt"`
+	EndAt   string `json:"endAt"`
+	TeamID  int64  `json:"teamId"`
+}

internal/repositories/agent_team_schedule_repository.go

@@ -2,6 +2,7 @@ package repositories
 
 import (
 	"cs-agent/internal/models"
+	"time"
 
 	"github.com/mlogclub/simple/sqls"
 	"github.com/mlogclub/simple/web/params"
@@ -38,6 +39,16 @@ func (r *agentTeamScheduleRepository) Find(db *gorm.DB, cnd *sqls.Cnd) (list []m
 	return
 }
 
+func (r *agentTeamScheduleRepository) FindByTimeRange(db *gorm.DB, startAt, endAt time.Time, teamID int64) (list []models.AgentTeamSchedule) {
+	query := db.Model(&models.AgentTeamSchedule{}).
+		Where("start_at < ? AND end_at > ?", endAt, startAt)
+	if teamID > 0 {
+		query = query.Where("team_id = ?", teamID)
+	}
+	query.Order("team_id ASC").Order("start_at ASC").Order("id ASC").Find(&list)
+	return
+}
+
 func (r *agentTeamScheduleRepository) FindOne(db *gorm.DB, cnd *sqls.Cnd) *models.AgentTeamSchedule {
 	ret := &models.AgentTeamSchedule{}
 	if err := cnd.FindOne(db, &ret); err != nil {
@@ -99,4 +110,3 @@ func (r *agentTeamScheduleRepository) UpdateColumn(db *gorm.DB, id int64, name s
 func (r *agentTeamScheduleRepository) Delete(db *gorm.DB, id int64) {
 	db.Delete(&models.AgentTeamSchedule{}, "id = ?", id)
 }
-

internal/services/agent_team_schedule_service.go

@@ -53,6 +53,21 @@ func (s *agentTeamScheduleService) Count(cnd *sqls.Cnd) int64 {
 	return repositories.AgentTeamScheduleRepository.Count(sqls.DB(), cnd)
 }
 
+func (s *agentTeamScheduleService) FindCalendarSchedules(req request.AgentTeamScheduleCalendarRequest) ([]models.AgentTeamSchedule, error) {
+	startAtValue, err := parseRequiredDateTime(req.StartAt, "开始时间格式错误")
+	if err != nil {
+		return nil, err
+	}
+	endAtValue, err := parseRequiredDateTime(req.EndAt, "结束时间格式错误")
+	if err != nil {
+		return nil, err
+	}
+	if !endAtValue.After(startAtValue) {
+		return nil, errorsx.InvalidParam("结束时间必须晚于开始时间")
+	}
+	return repositories.AgentTeamScheduleRepository.FindByTimeRange(sqls.DB(), startAtValue, endAtValue, req.TeamID), nil
+}
+
 func (s *agentTeamScheduleService) Create(t *models.AgentTeamSchedule) error {
 	return repositories.AgentTeamScheduleRepository.Create(sqls.DB(), t)
 }

internal/services/agent_team_schedule_service_test.go

@@ -0,0 +1,134 @@
+package services_test
+
+import (
+	"strings"
+	"testing"
+	"time"
+
+	"cs-agent/internal/models"
+	"cs-agent/internal/pkg/dto/request"
+	"cs-agent/internal/pkg/enums"
+	"cs-agent/internal/services"
+
+	"github.com/glebarez/sqlite"
+	"github.com/mlogclub/simple/sqls"
+	"gorm.io/gorm"
+	"gorm.io/gorm/schema"
+)
+
+func TestAgentTeamScheduleServiceFindCalendarSchedulesReturnsIntersectingSchedules(t *testing.T) {
+	db := setupAgentTeamScheduleTestDB(t)
+	createAgentTeamScheduleTestData(t, db)
+
+	list, err := services.AgentTeamScheduleService.FindCalendarSchedules(request.AgentTeamScheduleCalendarRequest{
+		StartAt: "2026-04-27 00:00:00",
+		EndAt:   "2026-05-04 00:00:00",
+	})
+	if err != nil {
+		t.Fatalf("FindCalendarSchedules() error = %v", err)
+	}
+
+	if len(list) != 3 {
+		t.Fatalf("expected 3 intersecting schedules, got %d: %+v", len(list), list)
+	}
+	gotIDs := make([]int64, 0, len(list))
+	for _, item := range list {
+		gotIDs = append(gotIDs, item.ID)
+	}
+	wantIDs := []int64{1, 2, 3}
+	for i, want := range wantIDs {
+		if gotIDs[i] != want {
+			t.Fatalf("expected ids %v, got %v", wantIDs, gotIDs)
+		}
+	}
+}
+
+func TestAgentTeamScheduleServiceFindCalendarSchedulesFiltersTeamID(t *testing.T) {
+	db := setupAgentTeamScheduleTestDB(t)
+	createAgentTeamScheduleTestData(t, db)
+
+	list, err := services.AgentTeamScheduleService.FindCalendarSchedules(request.AgentTeamScheduleCalendarRequest{
+		StartAt: "2026-04-27 00:00:00",
+		EndAt:   "2026-05-04 00:00:00",
+		TeamID:  2,
+	})
+	if err != nil {
+		t.Fatalf("FindCalendarSchedules() error = %v", err)
+	}
+
+	if len(list) != 1 {
+		t.Fatalf("expected 1 schedule for team 2, got %d: %+v", len(list), list)
+	}
+	if list[0].ID != 3 || list[0].TeamID != 2 {
+		t.Fatalf("unexpected schedule: %+v", list[0])
+	}
+}
+
+func TestAgentTeamScheduleServiceFindCalendarSchedulesValidatesTimeRange(t *testing.T) {
+	setupAgentTeamScheduleTestDB(t)
+
+	_, err := services.AgentTeamScheduleService.FindCalendarSchedules(request.AgentTeamScheduleCalendarRequest{
+		StartAt: "2026-05-04 00:00:00",
+		EndAt:   "2026-04-27 00:00:00",
+	})
+	if err == nil {
+		t.Fatalf("expected invalid time range to fail")
+	}
+}
+
+func setupAgentTeamScheduleTestDB(t *testing.T) *gorm.DB {
+	t.Helper()
+
+	dbName := strings.NewReplacer("/", "_", " ", "_").Replace(t.Name())
+	db, err := gorm.Open(sqlite.Open("file:"+dbName+"?mode=memory&cache=shared"), &gorm.Config{
+		NamingStrategy: schema.NamingStrategy{
+			TablePrefix:   "t_",
+			SingularTable: true,
+		},
+	})
+	if err != nil {
+		t.Fatalf("open sqlite error = %v", err)
+	}
+	t.Cleanup(func() {
+		sqlDB, err := db.DB()
+		if err == nil {
+			_ = sqlDB.Close()
+		}
+	})
+	if err := db.AutoMigrate(&models.AgentTeam{}, &models.AgentTeamSchedule{}); err != nil {
+		t.Fatalf("auto migrate error = %v", err)
+	}
+	sqls.SetDB(db)
+	return db
+}
+
+func createAgentTeamScheduleTestData(t *testing.T, db *gorm.DB) {
+	t.Helper()
+
+	teams := []models.AgentTeam{
+		{ID: 1, Name: "售前组", Status: enums.StatusOk},
+		{ID: 2, Name: "售后组", Status: enums.StatusOk},
+	}
+	if err := db.Create(&teams).Error; err != nil {
+		t.Fatalf("create teams error = %v", err)
+	}
+
+	parse := func(value string) time.Time {
+		t.Helper()
+		ret, err := time.ParseInLocation(time.DateTime, value, time.Local)
+		if err != nil {
+			t.Fatalf("parse time %q error = %v", value, err)
+		}
+		return ret
+	}
+	schedules := []models.AgentTeamSchedule{
+		{ID: 1, TeamID: 1, StartAt: parse("2026-04-26 20:00:00"), EndAt: parse("2026-04-27 10:00:00"), SourceType: "manual", Status: enums.StatusOk},
+		{ID: 2, TeamID: 1, StartAt: parse("2026-04-28 09:00:00"), EndAt: parse("2026-04-28 18:00:00"), SourceType: "manual", Status: enums.StatusOk},
+		{ID: 3, TeamID: 2, StartAt: parse("2026-05-03 20:00:00"), EndAt: parse("2026-05-04 08:00:00"), SourceType: "manual", Status: enums.StatusOk},
+		{ID: 4, TeamID: 1, StartAt: parse("2026-04-20 09:00:00"), EndAt: parse("2026-04-20 18:00:00"), SourceType: "manual", Status: enums.StatusOk},
+		{ID: 5, TeamID: 2, StartAt: parse("2026-05-04 09:00:00"), EndAt: parse("2026-05-04 18:00:00"), SourceType: "manual", Status: enums.StatusOk},
+	}
+	if err := db.Create(&schedules).Error; err != nil {
+		t.Fatalf("create schedules error = %v", err)
+	}
+}

web/app/dashboard/agent-team-schedules/_components/calendar.tsx

@@ -0,0 +1,374 @@
+"use client"
+
+import { CalendarPlusIcon, GripVerticalIcon } from "lucide-react"
+
+import type {
+  AdminAgentTeam,
+  AdminAgentTeamSchedule,
+  CreateAdminAgentTeamSchedulePayload,
+  UpdateAdminAgentTeamSchedulePayload,
+} from "@/lib/api/admin"
+import { cn, formatDateTime } from "@/lib/utils"
+
+const dayNames = ["一", "二", "三", "四", "五", "六", "日"]
+const dayMs = 24 * 60 * 60 * 1000
+const minuteMs = 60 * 1000
+const minDurationMs = 15 * minuteMs
+
+type ScheduleCalendarProps = {
+  weekStart: Date
+  teams: AdminAgentTeam[]
+  schedules: AdminAgentTeamSchedule[]
+  loading: boolean
+  savingId: number | null
+  onCreate: (defaults: Partial<CreateAdminAgentTeamSchedulePayload>) => void
+  onEdit: (item: AdminAgentTeamSchedule) => void
+  onMove: (payload: UpdateAdminAgentTeamSchedulePayload) => Promise<void>
+  onResize: (payload: UpdateAdminAgentTeamSchedulePayload) => Promise<void>
+}
+
+type DragState =
+  | {
+      type: "move"
+      item: AdminAgentTeamSchedule
+      startX: number
+      startY: number
+      moved: boolean
+    }
+  | {
+      type: "resize"
+      edge: "start" | "end"
+      item: AdminAgentTeamSchedule
+      moved: boolean
+    }
+
+function addDays(date: Date, days: number) {
+  const ret = new Date(date)
+  ret.setDate(ret.getDate() + days)
+  return ret
+}
+
+function startOfDay(date: Date) {
+  const ret = new Date(date)
+  ret.setHours(0, 0, 0, 0)
+  return ret
+}
+
+function parseLocalDateTime(value: string) {
+  const match = value.match(/^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?/)
+  if (!match) {
+    return new Date(value)
+  }
+  return new Date(
+    Number(match[1]),
+    Number(match[2]) - 1,
+    Number(match[3]),
+    Number(match[4]),
+    Number(match[5]),
+    Number(match[6] ?? 0)
+  )
+}
+
+function formatDate(date: Date) {
+  const month = String(date.getMonth() + 1).padStart(2, "0")
+  const day = String(date.getDate()).padStart(2, "0")
+  return `${date.getFullYear()}-${month}-${day}`
+}
+
+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 formatDayTitle(date: Date) {
+  return `${date.getMonth() + 1}/${date.getDate()}`
+}
+
+function clamp(value: number, min: number, max: number) {
+  return Math.min(Math.max(value, min), max)
+}
+
+function roundToQuarterHour(date: Date) {
+  const ret = new Date(date)
+  ret.setSeconds(0, 0)
+  const minutes = ret.getHours() * 60 + ret.getMinutes()
+  const rounded = Math.round(minutes / 15) * 15
+  ret.setHours(Math.floor(rounded / 60), rounded % 60, 0, 0)
+  return ret
+}
+
+function getPointerDateInCell(event: PointerEvent | React.PointerEvent, cell: Element) {
+  const rect = cell.getBoundingClientRect()
+  const day = startOfDay(parseLocalDateTime(`${cell.getAttribute("data-date")} 00:00:00`))
+  const ratio = clamp((event.clientX - rect.left) / rect.width, 0, 1)
+  return roundToQuarterHour(new Date(day.getTime() + ratio * dayMs))
+}
+
+function getDropCell(event: PointerEvent | React.PointerEvent) {
+  const element = document.elementFromPoint(event.clientX, event.clientY)
+  return element?.closest("[data-schedule-cell]")
+}
+
+function getCellTeamAndDate(cell: Element) {
+  const teamID = Number(cell.getAttribute("data-team-id"))
+  const date = cell.getAttribute("data-date") ?? ""
+  return { teamID, date }
+}
+
+function buildMovePayload(item: AdminAgentTeamSchedule, teamId: number, date: string): UpdateAdminAgentTeamSchedulePayload {
+  const originalStart = parseLocalDateTime(item.startAt)
+  const originalEnd = parseLocalDateTime(item.endAt)
+  const duration = originalEnd.getTime() - originalStart.getTime()
+  const nextDay = startOfDay(parseLocalDateTime(`${date} 00:00:00`))
+  const nextStart = new Date(nextDay)
+  nextStart.setHours(originalStart.getHours(), originalStart.getMinutes(), originalStart.getSeconds(), 0)
+  const nextEnd = new Date(nextStart.getTime() + duration)
+
+  return {
+    id: item.id,
+    teamId,
+    startAt: formatDateTimeValue(nextStart),
+    endAt: formatDateTimeValue(nextEnd),
+    sourceType: item.sourceType,
+    remark: item.remark,
+  }
+}
+
+function buildResizePayload(
+  item: AdminAgentTeamSchedule,
+  edge: "start" | "end",
+  nextTime: Date
+): UpdateAdminAgentTeamSchedulePayload | null {
+  const startAt = parseLocalDateTime(item.startAt)
+  const endAt = parseLocalDateTime(item.endAt)
+  if (edge === "start") {
+    if (endAt.getTime() - nextTime.getTime() < minDurationMs) {
+      return null
+    }
+    startAt.setTime(nextTime.getTime())
+  } else {
+    if (nextTime.getTime() - startAt.getTime() < minDurationMs) {
+      return null
+    }
+    endAt.setTime(nextTime.getTime())
+  }
+  return {
+    id: item.id,
+    teamId: item.teamId,
+    startAt: formatDateTimeValue(startAt),
+    endAt: formatDateTimeValue(endAt),
+    sourceType: item.sourceType,
+    remark: item.remark,
+  }
+}
+
+function sliceScheduleForDay(item: AdminAgentTeamSchedule, day: Date) {
+  const dayStart = startOfDay(day)
+  const dayEnd = addDays(dayStart, 1)
+  const scheduleStart = parseLocalDateTime(item.startAt)
+  const scheduleEnd = parseLocalDateTime(item.endAt)
+  const visibleStart = new Date(Math.max(scheduleStart.getTime(), dayStart.getTime()))
+  const visibleEnd = new Date(Math.min(scheduleEnd.getTime(), dayEnd.getTime()))
+  if (!visibleEnd.getTime() || visibleEnd <= visibleStart) {
+    return null
+  }
+  const left = ((visibleStart.getTime() - dayStart.getTime()) / dayMs) * 100
+  const width = ((visibleEnd.getTime() - visibleStart.getTime()) / dayMs) * 100
+  return { left, width, visibleStart, visibleEnd }
+}
+
+export function ScheduleCalendar({
+  weekStart,
+  teams,
+  schedules,
+  loading,
+  savingId,
+  onCreate,
+  onEdit,
+  onMove,
+  onResize,
+}: ScheduleCalendarProps) {
+  const days = Array.from({ length: 7 }, (_, index) => startOfDay(addDays(weekStart, index)))
+
+  function handleBlankCellClick(teamId: number, day: Date) {
+    const startAt = new Date(day)
+    startAt.setHours(9, 0, 0, 0)
+    const endAt = new Date(day)
+    endAt.setHours(18, 0, 0, 0)
+    onCreate({
+      teamId,
+      startAt: formatDateTimeValue(startAt),
+      endAt: formatDateTimeValue(endAt),
+      sourceType: "manual",
+      remark: "",
+    })
+  }
+
+  function handlePointerDown(event: React.PointerEvent, item: AdminAgentTeamSchedule, type: DragState["type"], edge?: "start" | "end") {
+    event.preventDefault()
+    event.stopPropagation()
+    const target = event.currentTarget as HTMLElement
+    target.setPointerCapture(event.pointerId)
+    const state: DragState =
+      type === "resize"
+        ? { type: "resize", edge: edge ?? "end", item, moved: false }
+        : { type: "move", item, startX: event.clientX, startY: event.clientY, moved: false }
+
+    function handlePointerMove(moveEvent: PointerEvent) {
+      if (state.type === "move") {
+        if (Math.abs(moveEvent.clientX - state.startX) > 4 || Math.abs(moveEvent.clientY - state.startY) > 4) {
+          state.moved = true
+        }
+      } else {
+        state.moved = true
+      }
+    }
+
+    async function handlePointerUp(upEvent: PointerEvent) {
+      target.releasePointerCapture(event.pointerId)
+      window.removeEventListener("pointermove", handlePointerMove)
+      window.removeEventListener("pointerup", handlePointerUp)
+      if (!state.moved) {
+        onEdit(item)
+        return
+      }
+      const cell = getDropCell(upEvent)
+      if (!cell) {
+        return
+      }
+      if (state.type === "move") {
+        const next = getCellTeamAndDate(cell)
+        if (!next.teamID || !next.date) {
+          return
+        }
+        await onMove(buildMovePayload(item, next.teamID, next.date))
+        return
+      }
+      const payload = buildResizePayload(item, state.edge, getPointerDateInCell(upEvent, cell))
+      if (payload) {
+        await onResize(payload)
+      }
+    }
+
+    window.addEventListener("pointermove", handlePointerMove)
+    window.addEventListener("pointerup", handlePointerUp)
+  }
+
+  if (teams.length === 0 && !loading) {
+    return (
+      <div className="flex min-h-64 items-center justify-center rounded-lg border bg-background text-sm text-muted-foreground">
+        暂无客服组，无法展示排班日历
+      </div>
+    )
+  }
+
+  return (
+    <div className="overflow-x-auto rounded-lg border bg-background">
+      <div className="min-w-[980px]">
+        <div className="grid grid-cols-[168px_repeat(7,minmax(112px,1fr))] border-b bg-muted/40">
+          <div className="flex h-14 items-center px-4 text-sm font-medium text-muted-foreground">客服组</div>
+          {days.map((day, index) => (
+            <div key={day.toISOString()} className="flex h-14 flex-col justify-center border-l px-3">
+              <div className="text-sm font-medium">周{dayNames[index]}</div>
+              <div className="text-xs text-muted-foreground">{formatDayTitle(day)}</div>
+            </div>
+          ))}
+        </div>
+
+        <div className={cn("relative", loading && "opacity-60")}>
+          {teams.map((team) => (
+            <div key={team.id} className="grid min-h-28 grid-cols-[168px_repeat(7,minmax(112px,1fr))] border-b last:border-b-0">
+              <div className="flex min-h-28 items-center px-4">
+                <div className="min-w-0">
+                  <div className="truncate text-sm font-medium">{team.name}</div>
+                  <div className="text-xs text-muted-foreground">组ID：{team.id}</div>
+                </div>
+              </div>
+              {days.map((day) => {
+                const date = formatDate(day)
+                const daySchedules = schedules.filter((item) => item.teamId === team.id && sliceScheduleForDay(item, day))
+                return (
+                  <button
+                    key={`${team.id}-${date}`}
+                    type="button"
+                    data-schedule-cell
+                    data-team-id={team.id}
+                    data-date={date}
+                    className="relative min-h-28 border-l bg-background p-2 text-left transition-colors hover:bg-muted/20"
+                    onClick={(event) => {
+                      if (event.target === event.currentTarget) {
+                        handleBlankCellClick(team.id, day)
+                      }
+                    }}
+                  >
+                    {daySchedules.length === 0 ? (
+                      <div className="flex h-full min-h-20 items-center justify-center text-xs text-muted-foreground/70">
+                        <CalendarPlusIcon className="mr-1 size-3.5" />
+                        新增
+                      </div>
+                    ) : null}
+                    {daySchedules.map((item, index) => {
+                      const slice = sliceScheduleForDay(item, day)
+                      if (!slice) {
+                        return null
+                      }
+                      const busy = savingId === item.id
+                      return (
+                        <div
+                          key={`${item.id}-${date}`}
+                          role="button"
+                          tabIndex={0}
+                          className={cn(
+                            "absolute top-2 z-10 h-20 cursor-grab overflow-hidden rounded-md border border-primary/20 bg-primary/10 px-2 py-1.5 text-primary shadow-sm outline-none transition active:cursor-grabbing",
+                            busy && "pointer-events-none opacity-60"
+                          )}
+                          style={{
+                            left: `calc(${slice.left}% + 8px)`,
+                            width: `calc(${slice.width}% - 16px)`,
+                            top: `${8 + index * 28}px`,
+                            minWidth: "42px",
+                          }}
+                          onPointerDown={(event) => handlePointerDown(event, item, "move")}
+                          onKeyDown={(event) => {
+                            if (event.key === "Enter" || event.key === " ") {
+                              event.preventDefault()
+                              onEdit(item)
+                            }
+                          }}
+                        >
+                          <div
+                            className="absolute left-0 top-0 flex h-full w-2 cursor-ew-resize items-center justify-center bg-primary/15"
+                            onPointerDown={(event) => handlePointerDown(event, item, "resize", "start")}
+                          >
+                            <GripVerticalIcon className="size-3" />
+                          </div>
+                          <div
+                            className="absolute right-0 top-0 flex h-full w-2 cursor-ew-resize items-center justify-center bg-primary/15"
+                            onPointerDown={(event) => handlePointerDown(event, item, "resize", "end")}
+                          >
+                            <GripVerticalIcon className="size-3" />
+                          </div>
+                          <div className="truncate pl-2 pr-2 text-xs font-medium">{item.sourceType}</div>
+                          <div className="truncate pl-2 pr-2 text-xs">
+                            {formatDateTime(item.startAt).slice(11, 16)} - {formatDateTime(item.endAt).slice(11, 16)}
+                          </div>
+                          {item.remark ? (
+                            <div className="truncate pl-2 pr-2 text-[11px] text-primary/80">{item.remark}</div>
+                          ) : null}
+                        </div>
+                      )
+                    })}
+                  </button>
+                )
+              })}
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  )
+}

web/app/dashboard/agent-team-schedules/_components/edit.tsx

@@ -35,8 +35,10 @@ type ScheduleEditDialogProps = {
   open: boolean
   saving: boolean
   itemId: number | null
+  defaultValues?: Partial<CreateAdminAgentTeamSchedulePayload> | null
   onOpenChange: (open: boolean) => void
   onSubmit: (payload: CreateAdminAgentTeamSchedulePayload) => Promise<void>
+  onDelete?: (id: number) => Promise<void>
 }
 
 const sourceTypeOptions = [
@@ -75,9 +77,15 @@ function toDateTimeLocal(value?: string) {
   return value.replace(" ", "T").slice(0, 16)
 }
 
-function buildForm(item: AdminAgentTeamSchedule | null): EditForm {
+function buildForm(item: AdminAgentTeamSchedule | null, defaultValues?: Partial<CreateAdminAgentTeamSchedulePayload> | null): EditForm {
   if (!item) {
-    return emptyForm
+    return {
+      teamId: defaultValues?.teamId ? String(defaultValues.teamId) : emptyForm.teamId,
+      startAt: toDateTimeLocal(defaultValues?.startAt),
+      endAt: toDateTimeLocal(defaultValues?.endAt),
+      sourceType: (defaultValues?.sourceType as EditForm["sourceType"] | undefined) ?? emptyForm.sourceType,
+      remark: defaultValues?.remark ?? emptyForm.remark,
+    }
   }
   return {
     teamId: String(item.teamId),
@@ -102,8 +110,10 @@ export function EditDialog({
   open,
   saving,
   itemId,
+  defaultValues,
   onOpenChange,
   onSubmit,
+  onDelete,
 }: ScheduleEditDialogProps) {
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
@@ -111,9 +121,11 @@ export function EditDialog({
         <ScheduleEditDialogBody
           key={itemId ? `edit-${itemId}` : "create"}
           itemId={itemId}
+          defaultValues={defaultValues}
           saving={saving}
           onOpenChange={onOpenChange}
           onSubmit={onSubmit}
+          onDelete={onDelete}
         />
       ) : null}
     </Dialog>
@@ -125,8 +137,10 @@ type ScheduleEditDialogBodyProps = Omit<ScheduleEditDialogProps, "open">
 function ScheduleEditDialogBody({
   saving,
   itemId,
+  defaultValues,
   onOpenChange,
   onSubmit,
+  onDelete,
 }: ScheduleEditDialogBodyProps) {
   const [teams, setTeams] = useState<AdminAgentTeam[]>([])
   const [loading, setLoading] = useState(false)
@@ -157,7 +171,7 @@ function ScheduleEditDialogBody({
   useEffect(() => {
     async function loadDetail() {
       if (!itemId) {
-        reset(emptyForm)
+        reset(buildForm(null, defaultValues))
         return
       }
       setLoading(true)
@@ -171,7 +185,7 @@ function ScheduleEditDialogBody({
       }
     }
     void loadDetail()
-  }, [itemId, reset])
+  }, [defaultValues, itemId, reset])
 
   useEffect(() => {
     void loadOptions()
@@ -269,6 +283,11 @@ function ScheduleEditDialogBody({
             </Field>
           </div>
           <DialogFooter className="mx-0 mb-0 px-6 py-4">
+            {itemId && onDelete ? (
+              <Button type="button" variant="destructive" onClick={() => void onDelete(itemId)} disabled={saving}>
+                删除
+              </Button>
+            ) : null}
             <Button type="button" variant="outline" onClick={() => onOpenChange(false)} disabled={saving}>
               取消
             </Button>

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 {
+import { ListPagination } from "@/components/list-pagination"
-  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 { 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 loadCalendarData()
+  }, [loadCalendarData])
+
+  useEffect(() => {
+    if (viewMode === "list") {
       void loadData()
-  }, [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) {
+  async function handleDeleteById(id: number) {
-    setActionLoadingId(item.id)
+    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,12 +251,68 @@ 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">
+        <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 xl:w-48">
+              <SelectTrigger className="w-full sm:w-48">
                 <SelectValue placeholder="筛选客服组" />
               </SelectTrigger>
               <SelectContent>
@@ -178,21 +324,40 @@ export default function DashboardAgentTeamSchedulesPage() {
                 ))}
               </SelectContent>
             </Select>
-          <Button variant="outline" onClick={applyFilters} disabled={loading}>
+            <Button variant="outline" onClick={applyFilters} disabled={loading || calendarLoading}>
               <SearchIcon />
               查询
             </Button>
-          <Button variant="outline" onClick={() => void loadData()} disabled={loading}>
+            <Button
-            <RefreshCwIcon className={loading ? "animate-spin" : ""} />
+              variant="outline"
-            刷新列表
+              onClick={() => void refreshActiveView()}
+              disabled={loading || calendarLoading}
+            >
+              <RefreshCwIcon className={loading || calendarLoading ? "animate-spin" : ""} />
+              刷新
             </Button>
-          <Button onClick={openCreateDialog}>
+            <Button onClick={() => openCreateDialog()}>
               <PlusIcon />
               新建
             </Button>
           </div>
+        </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-2xl border bg-background">
+            <div className="overflow-hidden rounded-lg border bg-background">
               <Table>
                 <TableHeader className="bg-muted/40">
                   <TableRow>
@@ -207,7 +372,7 @@ export default function DashboardAgentTeamSchedulesPage() {
                     <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">
+                          <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">
@@ -271,13 +436,16 @@ export default function DashboardAgentTeamSchedulesPage() {
               }}
             />
           </div>
+        )}
       </div>
       <EditDialog
         open={dialogOpen}
-        saving={saving}
+        saving={saving || actionLoadingId === editingItem?.id}
         itemId={editingItem?.id ?? null}
+        defaultValues={dialogDefaults}
         onOpenChange={handleDialogOpenChange}
         onSubmit={handleSubmit}
+        onDelete={handleDeleteById}
       />
     </>
   )

web/lib/api/admin.ts

@@ -1092,6 +1092,14 @@ export function fetchAgentTeamSchedules(
   )
 }
 
+export function fetchAgentTeamScheduleCalendar(
+  query: Record<string, string | number | undefined>
+) {
+  return request<AdminAgentTeamSchedule[]>(
+    `/api/dashboard/agent-team-schedule/calendar${toQueryString(query)}`
+  )
+}
+
 export function fetchAgentTeamSchedule(id: number) {
   return request<AdminAgentTeamSchedule>(`/api/dashboard/agent-team-schedule/${id}`)
 }