Разработка Kanban-доски для управления задачами на сайте

Разработка Kanban-доски для управления задачами на сайте

Kanban-доска — набор колонок (To Do, In Progress, Done) с карточками задач, перетаскиваемыми между колонками. Требует drag-and-drop, оптимистичных обновлений состояния и синхронизации с бэкендом.

DnD Kit — рекомендуемый подход

npm install @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilities

import {
  DndContext, DragOverlay, DragStartEvent, DragEndEvent,
  PointerSensor, useSensor, useSensors, closestCorners
} from '@dnd-kit/core';
import {
  SortableContext, verticalListSortingStrategy,
  useSortable, arrayMove
} from '@dnd-kit/sortable';
import { CSS } from '@dnd-kit/utilities';

interface Task { id: string; title: string; columnId: string; order: number; }
interface Column { id: string; title: string; color: string; }

function KanbanBoard({ initialColumns, initialTasks, onTaskMove }) {
  const [tasks, setTasks] = useState<Task[]>(initialTasks);
  const [activeTask, setActiveTask] = useState<Task | null>(null);

  const sensors = useSensors(
    useSensor(PointerSensor, {
      activationConstraint: { distance: 8 }  // 8px перед началом drag
    })
  );

  const handleDragStart = ({ active }: DragStartEvent) => {
    setActiveTask(tasks.find(t => t.id === active.id) ?? null);
  };

  const handleDragEnd = ({ active, over }: DragEndEvent) => {
    setActiveTask(null);
    if (!over) return;

    const activeTask = tasks.find(t => t.id === active.id);
    if (!activeTask) return;

    const overId = over.id as string;
    const overColumn = initialColumns.find(c => c.id === overId);
    const overTask = tasks.find(t => t.id === overId);

    const targetColumnId = overColumn?.id ?? overTask?.columnId ?? activeTask.columnId;
    const isMovingColumn = targetColumnId !== activeTask.columnId;

    setTasks(prev => {
      // Оптимистичное обновление UI
      const updated = prev.map(t =>
        t.id === activeTask.id ? { ...t, columnId: targetColumnId } : t
      );

      // Пересортировать внутри колонки
      if (!isMovingColumn && overTask) {
        const oldIndex = prev.findIndex(t => t.id === activeTask.id);
        const newIndex = prev.findIndex(t => t.id === overId);
        return arrayMove(updated, oldIndex, newIndex);
      }

      return updated;
    });

    // Синхронизация с сервером
    onTaskMove(activeTask.id, targetColumnId).catch(() => {
      // Откат при ошибке
      setTasks(initialTasks);
    });
  };

  return (
    <DndContext sensors={sensors} collisionDetection={closestCorners}
      onDragStart={handleDragStart} onDragEnd={handleDragEnd}>
      <div className="kanban-board flex gap-4 overflow-x-auto p-4">
        {initialColumns.map(column => (
          <KanbanColumn
            key={column.id}
            column={column}
            tasks={tasks.filter(t => t.columnId === column.id)}
          />
        ))}
      </div>

      <DragOverlay>
        {activeTask && <TaskCard task={activeTask} isDragging />}
      </DragOverlay>
    </DndContext>
  );
}

Колонка и карточка

function KanbanColumn({ column, tasks }) {
  const taskIds = tasks.map(t => t.id);

  return (
    <div className="kanban-column w-72 shrink-0 bg-gray-50 rounded-xl p-3">
      <div className="flex items-center justify-between mb-3">
        <div className="flex items-center gap-2">
          <div className="w-3 h-3 rounded-full" style={{ background: column.color }} />
          <h3 className="font-semibold text-gray-700">{column.title}</h3>
          <span className="text-xs bg-gray-200 text-gray-500 rounded-full px-2 py-0.5">
            {tasks.length}
          </span>
        </div>
        <AddTaskButton columnId={column.id} />
      </div>

      <SortableContext items={taskIds} strategy={verticalListSortingStrategy}>
        <div className="space-y-2 min-h-20">
          {tasks.map(task => (
            <SortableTaskCard key={task.id} task={task} />
          ))}
        </div>
      </SortableContext>
    </div>
  );
}

function SortableTaskCard({ task }) {
  const { attributes, listeners, setNodeRef, transform, transition, isDragging } =
    useSortable({ id: task.id });

  const style = {
    transform: CSS.Transform.toString(transform),
    transition,
    opacity: isDragging ? 0.5 : 1
  };

  return (
    <div ref={setNodeRef} style={style} {...attributes} {...listeners}>
      <TaskCard task={task} />
    </div>
  );
}

function TaskCard({ task, isDragging = false }) {
  return (
    <div className={`bg-white rounded-lg border border-gray-200 p-3 shadow-sm
      hover:shadow-md transition-shadow cursor-grab active:cursor-grabbing
      ${isDragging ? 'shadow-xl ring-2 ring-blue-300' : ''}`}>
      <p className="text-sm font-medium text-gray-800 mb-2">{task.title}</p>
      <div className="flex items-center justify-between">
        <PriorityBadge priority={task.priority} />
        {task.assignee && <AssigneeAvatar user={task.assignee} />}
      </div>
      {task.dueDate && (
        <p className={`text-xs mt-1 ${isPast(task.dueDate) ? 'text-red-500' : 'text-gray-400'}`}>
          📅 {format(task.dueDate, 'dd.MM')}
        </p>
      )}
    </div>
  );
}

Фильтры и поиск

function KanbanWithFilters({ board }) {
  const [filters, setFilters] = useState({
    assignee: null, priority: null, search: ''
  });

  const filteredTasks = board.tasks.filter(task => {
    if (filters.search && !task.title.toLowerCase().includes(filters.search.toLowerCase())) {
      return false;
    }
    if (filters.assignee && task.assigneeId !== filters.assignee) return false;
    if (filters.priority && task.priority !== filters.priority) return false;
    return true;
  });

  return (
    <div>
      <KanbanFilters filters={filters} onChange={setFilters} />
      <KanbanBoard tasks={filteredTasks} columns={board.columns} />
    </div>
  );
}

Сроки

Базовая Kanban-доска с DnD и бэкенд-синхронизацией — 1–2 недели. Полная с фильтрами, подзадачами, комментариями и real-time обновлениями — 3–4 недели.