Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

feat: add a workspace-scoped task board

krxi2eb2f2de96a7
diff --git a/README.md b/README.md
index 5693726e4..275d8487b 100644
--- a/README.md
+++ b/README.md
@@ -232,6 +232,7 @@
DeepTutor is an agent-native learning workspace that connects tutoring, problem solving, quiz generation, research, visualization, and mastery practice in one extensible system.
- **One runtime for every mode** — Chat, Ask Questions, Quiz, Research, Visualize, Solve, Course Study, Mastery Path, Immersive Reading, and Immersive Watching share one capability runtime and session context while keeping purpose-built loops and pipelines.
+- **Task Board** — Track study tasks in To do, In progress, and Done, with notes, drag-and-drop or keyboard-accessible move buttons, and an archive you can restore from. Cards stay in the current workspace and follow the existing appearance and language settings; no model configuration is required.
- **Connected learning context** — Knowledge bases, books, Co-Writer drafts, notebooks, question banks, personas, and Memory can be reused across the workflows that support them, subject to account grants and learning policies.
- **Immersive video learning** — paste a YouTube link for privacy-enhanced native playback, synchronized captions, timestamp-grounded tutoring, and resumable progress; administrators can switch playback to a self-hosted Invidious instance without rebuilding materials.
- **Subagents and Partners** — from Chat, consult a live agent harness (Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo, Hermes, OpenClaw, or DeepSeek) or a Partner, import past conversations, and run persistent IM companions on the same brain.
diff --git a/deeptutor/api/main.py b/deeptutor/api/main.py
index ddfdd2975..ffdb27ffa 100644
--- a/deeptutor/api/main.py
+++ b/deeptutor/api/main.py
@@ -558,6 +558,7 @@ from deeptutor.api.routers import (
space_mcp,
subagents,
system,
+ task_board,
unified_ws,
video_learning,
visualizers,
@@ -635,6 +636,9 @@ app.include_router(
)
app.include_router(co_writer.router, prefix="/api", tags=["documents"], dependencies=_auth)
app.include_router(notebook.router, prefix="/api", tags=["notebooks"], dependencies=_auth)
+app.include_router(
+ task_board.router, prefix="/api/task-board", tags=["task-board"], dependencies=_auth
+)
app.include_router(book.router, prefix="/api", tags=["books"], dependencies=_auth)
app.include_router(book.ws_router, prefix="/ws", tags=["books"])
app.include_router(reading.router, prefix="/api/reading", tags=["reading"], dependencies=_auth)
diff --git a/deeptutor/api/routers/task_board.py b/deeptutor/api/routers/task_board.py
new file mode 100644
index 000000000..9703748f9
--- /dev/null
+++ b/deeptutor/api/routers/task_board.py
@@ -0,0 +1,28 @@
+"""Authenticated task board endpoints using the current content workspace."""
+
+from fastapi import APIRouter, HTTPException
+
+from deeptutor.services.task_board import CreateCard, TaskBoard, UpdateCard, get_task_board_store
+
+router = APIRouter()
+
+
[email protected]("", response_model=TaskBoard)
+def get_board() -> TaskBoard:
+ """Return active and archived cards in the current workspace."""
+ return get_task_board_store().read()
+
+
[email protected]("/cards", response_model=TaskBoard, status_code=201)
+def create_card(payload: CreateCard) -> TaskBoard:
+ """Create a task in the To do column."""
+ return get_task_board_store().create(payload)
+
+
[email protected]("/cards/{card_id}", response_model=TaskBoard)
+def update_card(card_id: str, payload: UpdateCard) -> TaskBoard:
+ """Edit, move, archive or restore an existing task."""
+ try:
+ return get_task_board_store().update(card_id, payload)
+ except KeyError as exc:
+ raise HTTPException(status_code=404, detail="Task card not found.") from exc
diff --git a/deeptutor/services/task_board.py b/deeptutor/services/task_board.py
new file mode 100644
index 000000000..c140ca16c
--- /dev/null
+++ b/deeptutor/services/task_board.py
@@ -0,0 +1,139 @@
+"""Workspace-local task cards with transactional, multi-worker-safe persistence."""
+
+from __future__ import annotations
+
+from contextlib import closing
+from datetime import datetime, timezone
+from pathlib import Path
+import sqlite3
+from typing import Annotated, Literal
+from uuid import uuid4
+
+from pydantic import BaseModel, ConfigDict, StringConstraints, field_validator
+
+from deeptutor.services.path_service import get_path_service
+from deeptutor.utils.secret_files import ensure_private_directory
+
+TaskStatus = Literal["todo", "doing", "done"]
+TaskTitle = Annotated[str, StringConstraints(strip_whitespace=True, min_length=1, max_length=160)]
+TaskNote = Annotated[str, StringConstraints(max_length=2000)]
+
+
+class CreateCard(BaseModel):
+ """A learner-authored task; identifiers and timestamps are server-owned."""
+
+ model_config = ConfigDict(extra="forbid")
+ title: TaskTitle
+ note: TaskNote = ""
+
+
+class UpdateCard(BaseModel):
+ """Only supplied fields change, preserving concurrent edits to other fields."""
+
+ model_config = ConfigDict(extra="forbid")
+ title: TaskTitle | None = None
+ note: TaskNote | None = None
+ status: TaskStatus | None = None
+ archived: bool | None = None
+
+ @field_validator("title", "note", "status", "archived", mode="before")
+ @classmethod
+ def reject_null(cls, value: object) -> object:
+ """Omission is allowed; explicitly clearing a required field is not."""
+ if value is None:
+ raise ValueError("Card fields cannot be null.")
+ return value
+
+
+class TaskCard(CreateCard):
+ """Persisted card returned to the board, including archived cards."""
+
+ id: str
+ status: TaskStatus
+ archived: bool
+ created_at: str
+ updated_at: str
+
+
+class TaskBoard(BaseModel):
+ """A consistent snapshot of the current workspace's board."""
+
+ cards: list[TaskCard]
+
+
+class TaskBoardStore:
+ """Open short-lived SQLite connections; never cache a user's active scope."""
+
+ def __init__(self, path: Path):
+ self.path = path
+
+ def _connect(self) -> sqlite3.Connection:
+ ensure_private_directory(self.path.parent)
+ connection = sqlite3.connect(self.path, timeout=10)
+ connection.row_factory = sqlite3.Row
+ connection.execute(
+ """CREATE TABLE IF NOT EXISTS cards (
+ id TEXT PRIMARY KEY,
+ title TEXT NOT NULL,
+ note TEXT NOT NULL DEFAULT '',
+ status TEXT NOT NULL CHECK(status IN ('todo', 'doing', 'done')),
+ archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL
+ )"""
+ )
+ return connection
+
+ @staticmethod
+ def _snapshot(connection: sqlite3.Connection) -> TaskBoard:
+ rows = connection.execute("SELECT * FROM cards ORDER BY created_at, id")
+ return TaskBoard(cards=[TaskCard.model_validate(dict(row)) for row in rows])
+
+ def read(self) -> TaskBoard:
+ """Read cards without creating storage for an unused board."""
+ if not self.path.exists():
+ return TaskBoard(cards=[])
+ with closing(self._connect()) as connection:
+ return self._snapshot(connection)
+
+ def create(self, payload: CreateCard) -> TaskBoard:
+ """Add a task and return the snapshot committed by this transaction."""
+ now = datetime.now(timezone.utc).isoformat()
+ with closing(self._connect()) as connection, connection:
+ connection.execute(
+ "INSERT INTO cards VALUES (?, ?, ?, 'todo', 0, ?, ?)",
+ (uuid4().hex, payload.title, payload.note, now, now),
+ )
+ return self._snapshot(connection)
+
+ def update(self, card_id: str, payload: UpdateCard) -> TaskBoard:
+ """Edit, move, archive or restore a card atomically; fail if absent."""
+ if not self.path.exists():
+ raise KeyError(card_id)
+ changes = payload.model_dump(exclude_unset=True)
+ with closing(self._connect()) as connection, connection:
+ # Serialize the read/modify/write across processes as well as threads.
+ connection.execute("BEGIN IMMEDIATE")
+ row = connection.execute("SELECT * FROM cards WHERE id = ?", (card_id,)).fetchone()
+ if row is None:
+ raise KeyError(card_id)
+ card = TaskCard.model_validate(dict(row))
+ updated = TaskCard.model_validate({**card.model_dump(), **changes})
+ connection.execute(
+ """UPDATE cards SET title = ?, note = ?, status = ?, archived = ?,
+ updated_at = ? WHERE id = ?""",
+ (
+ updated.title,
+ updated.note,
+ updated.status,
+ updated.archived,
+ datetime.now(timezone.utc).isoformat(),
+ card_id,
+ ),
+ )
+ return self._snapshot(connection)
+
+
+def get_task_board_store() -> TaskBoardStore:
+ """Resolve storage after DeepTutor has installed the request's user/workspace."""
+ return TaskBoardStore(get_path_service().get_workspace_dir() / "task-board" / "cards.sqlite")
diff --git a/deeptutor/services/workspace/data_migration.py b/deeptutor/services/workspace/data_migration.py
index 9ee10ab8e..baa11adc6 100644
--- a/deeptutor/services/workspace/data_migration.py
+++ b/deeptutor/services/workspace/data_migration.py
@@ -32,6 +32,7 @@ FEATURES = {
"reading": "Immersive Reading",
"timed_media": "Immersive Watching",
"notebook": "Notebooks",
+ "task-board": "Task Board",
"co-writer": "Writing",
"courses": "Courses",
"files": "File library",
diff --git a/tests/multi_user/test_task_board.py b/tests/multi_user/test_task_board.py
new file mode 100644
index 000000000..be827e779
--- /dev/null
+++ b/tests/multi_user/test_task_board.py
@@ -0,0 +1,191 @@
+"""Task board persistence, validation and authenticated workspace isolation."""
+
+from concurrent.futures import ThreadPoolExecutor
+
+from fastapi import Depends, FastAPI
+from fastapi.testclient import TestClient
+import pytest
+
+from deeptutor.api.routers import auth, task_board
+from deeptutor.services.auth import TokenPayload
+from deeptutor.services.task_board import (
+ CreateCard,
+ TaskBoardStore,
+ UpdateCard,
+ get_task_board_store,
+)
+from deeptutor.services.workspace import get_content_workspace_service
+from deeptutor.services.workspace.activity import WorkspaceActivityMiddleware
+from deeptutor.services.workspace.context import workspace_context
+
+
+def client(mu_isolated_root, monkeypatch):
+ """Use real auth/scope dependencies, with fixture identities and isolated disk."""
+ monkeypatch.setattr(auth, "AUTH_ENABLED", True)
+ monkeypatch.setattr(
+ auth,
+ "decode_token",
+ lambda token: (
+ TokenPayload(username=token, role="user", user_id=token)
+ if token in {"alice", "bob"}
+ else None
+ ),
+ )
+ app = FastAPI()
+ app.add_middleware(WorkspaceActivityMiddleware)
+ app.include_router(
+ task_board.router,
+ prefix="/api/task-board",
+ dependencies=[Depends(auth.require_learning_surface)],
+ )
+ with TestClient(app) as result:
+ yield result
+
+
+def headers(user="alice"):
+ return {"Authorization": f"Bearer {user}"}
+
+
+def test_authentication_is_required_for_reads_and_writes(client):
+ for authorization in ({}, headers("invalid")):
+ assert client.get("/api/task-board", headers=authorization).status_code == 401
+ assert (
+ client.post("/api/task-board/cards", json={"title": "Review"}, headers=authorization)
+ ).status_code == 401
+ assert (
+ client.patch("/api/task-board/cards/unknown", json={}, headers=authorization)
+ ).status_code == 401
+
+
+def test_create_edit_move_archive_restore_and_reload(client):
+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}
+ response = client.post(
+ "/api/task-board/cards", json={"title": " Review derivatives "}, headers=headers()
+ )
+ assert response.status_code == 201
+ card = response.json()["cards"][0]
+ assert card["title"] == "Review derivatives"
+ assert card["status"] == "todo"
+ url = f"/api/task-board/cards/{card['id']}"
+ for changes in (
+ {"note": "Try three examples", "title": "Practice derivatives"},
+ {"status": "doing"},
+ {"status": "done"},
+ {"archived": True},
+ {"archived": False},
+ ):
+ response = client.patch(url, json=changes, headers=headers())
+ assert response.status_code == 200
+ assert all(response.json()["cards"][0][key] == value for key, value in changes.items())
+ saved = client.get("/api/task-board", headers=headers()).json()["cards"][0]
+ assert saved["title"] == "Practice derivatives"
+ assert saved["note"] == "Try three examples"
+ assert saved["status"] == "done"
+ assert not saved["archived"]
+ assert saved["created_at"] == card["created_at"]
+ assert saved["updated_at"] >= card["updated_at"]
+
+
+ "payload",
+ [{"title": " "}, {"title": "x" * 161}, {"title": "Valid", "note": "x" * 2001}, {"id": "x"}],
+)
+def test_rejects_invalid_new_cards(client, payload):
+ assert client.post("/api/task-board/cards", json=payload, headers=headers()).status_code == 422
+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}
+
+
+ "payload",
+ [{"status": "invalid"}, {"title": None}, {"note": None}, {"archived": None}, {"id": "x"}],
+)
+def test_invalid_changes_do_not_modify_existing_cards(client, payload):
+ board = client.post("/api/task-board/cards", json={"title": "Review"}, headers=headers()).json()
+ card_id = board["cards"][0]["id"]
+ response = client.patch(f"/api/task-board/cards/{card_id}", json=payload, headers=headers())
+ assert response.status_code == 422
+ assert client.get("/api/task-board", headers=headers()).json() == board
+
+
+def test_other_accounts_cannot_read_or_modify_cards(client):
+ card = client.post(
+ "/api/task-board/cards", json={"title": "Private task"}, headers=headers()
+ ).json()["cards"][0]
+ assert client.get("/api/task-board", headers=headers("bob")).json() == {"cards": []}
+ response = client.patch(
+ f"/api/task-board/cards/{card['id']}", json={"archived": True}, headers=headers("bob")
+ )
+ assert response.status_code == 404
+ assert client.get("/api/task-board", headers=headers()).json()["cards"] == [card]
+
+
+def test_workspace_selection_and_archived_workspace_guard(client, as_user):
+ with as_user("alice"):
+ service = get_content_workspace_service()
+ first = service.create_workspace("First")
+ second = service.create_workspace("Second")
+ first_query = {"dt_workspace": first["workspace_id"]}
+ second_query = {"dt_workspace": second["workspace_id"]}
+ card = client.post(
+ "/api/task-board/cards",
+ json={"title": "Scoped task"},
+ headers=headers(),
+ params=first_query,
+ ).json()["cards"][0]
+ assert client.get("/api/task-board", headers=headers(), params=second_query).json() == {
+ "cards": []
+ }
+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}
+ assert (
+ client.patch(
+ f"/api/task-board/cards/{card['id']}",
+ json={"status": "done"},
+ headers=headers(),
+ params=second_query,
+ ).status_code
+ == 404
+ )
+ assert client.get(
+ "/api/task-board", headers=headers("bob"), params=first_query
+ ).status_code in {403, 404, 409}
+ with as_user("alice"):
+ with workspace_context(first["workspace_id"]):
+ assert get_task_board_store().read().cards[0].id == card["id"]
+ service.update_workspace(first["workspace_id"], archived=True)
+ assert (
+ client.patch(
+ f"/api/task-board/cards/{card['id']}",
+ json={"status": "done"},
+ headers=headers(),
+ params=first_query,
+ ).status_code
+ == 404
+ )
+
+
+def test_concurrent_connections_preserve_cards_and_independent_fields(tmp_path):
+ path = tmp_path / "task-board" / "cards.sqlite"
+ assert TaskBoardStore(path).read().cards == []
+ assert not path.exists()
+ with ThreadPoolExecutor(max_workers=6) as pool:
+ list(
+ pool.map(
+ lambda i: TaskBoardStore(path).create(CreateCard(title=f"Task {i}")), range(24)
+ )
+ )
+ cards = TaskBoardStore(path).read().cards
+ assert len(cards) == 24
+ assert len({card.id for card in cards}) == 24
+ with ThreadPoolExecutor(max_workers=2) as pool:
+ futures = [
+ pool.submit(
+ TaskBoardStore(path).update, cards[0].id, UpdateCard(note="Keep this note")
+ ),
+ pool.submit(TaskBoardStore(path).update, cards[0].id, UpdateCard(status="done")),
+ ]
+ for future in futures:
+ future.result()
+ updated = TaskBoardStore(path).read().cards[0]
+ assert updated.note == "Keep this note"
+ assert updated.status == "done"
diff --git a/tests/services/workspace/test_data_migration.py b/tests/services/workspace/test_data_migration.py
index 59323aa00..7dd519ae1 100644
--- a/tests/services/workspace/test_data_migration.py
+++ b/tests/services/workspace/test_data_migration.py
@@ -15,6 +15,27 @@ from deeptutor.services.workspace.models import WorkspaceError
from tests.services.workspace.test_data_scope import account as account
+def test_task_board_export_and_migration_preserve_archived_cards(account):
+ from deeptutor.services.task_board import CreateCard, UpdateCard, get_task_board_store
+ from deeptutor.services.workspace.data_migration import export_path
+
+ target = account.create_workspace("Destination")["workspace_id"]
+ with workspace_context():
+ store = get_task_board_store()
+ card = store.create(CreateCard(title="Review examples")).cards[0]
+ expected = store.update(card.id, UpdateCard(status="done", archived=True))
+ feature = next(row for row in discover()["features"] if row["feature"] == "task-board")
+ assert not feature["error"]
+ exported = export_data("", ["task-board"])
+ with zipfile.ZipFile(export_path(exported["id"])) as archive:
+ assert any(name.endswith("cards.sqlite") for name in archive.namelist())
+ assert migrate_data("", target, ["task-board"])["status"] == "completed"
+ with workspace_context(target):
+ assert get_task_board_store().read() == expected
+ with workspace_context():
+ assert get_task_board_store().read().cards == []
+
+
@pytest.mark.asyncio
async def test_migration_keeps_messages_branches_questions_and_source_backup(account):
target = account.create_workspace("Destination")["workspace_id"]
diff --git a/web/app/(workspace)/kanban/page.tsx b/web/app/(workspace)/kanban/page.tsx
new file mode 100644
index 000000000..14fc0718c
--- /dev/null
+++ b/web/app/(workspace)/kanban/page.tsx
@@ -0,0 +1,338 @@
+'use client'
+
+import { useEffect, useRef, useState } from 'react'
+import {
+ Archive,
+ ArrowLeft,
+ ArrowRight,
+ Check,
+ ClipboardList,
+ Plus,
+ RotateCcw,
+ X,
+} from 'lucide-react'
+import { useTranslation } from 'react-i18next'
+import SpaceSectionHeader from '@/components/space/SpaceSectionHeader'
+
+import {
+ createTaskCard,
+ getTaskBoard,
+ updateTaskCard,
+ type TaskBoard,
+ type TaskCard,
+ type TaskStatus,
+} from '@/lib/task-board-api'
+
+const columns: { id: TaskStatus; title: string; hint: string; tone: string }[] = [
+ { id: 'todo', title: 'kanban.todo', hint: 'kanban.todoHint', tone: 'var(--info)' },
+ { id: 'doing', title: 'kanban.doing', hint: 'kanban.doingHint', tone: 'var(--warning)' },
+ { id: 'done', title: 'kanban.done', hint: 'kanban.doneHint', tone: 'var(--success)' },
+]
+
+export default function KanbanPage() {
+ const { t } = useTranslation()
+ const [board, setBoard] = useState<TaskBoard | null>(null)
+ const [title, setTitle] = useState('')
+ const [editing, setEditing] = useState<string | null>(null)
+ const [draftTitle, setDraftTitle] = useState('')
+ const [draftNote, setDraftNote] = useState('')
+ const [busy, setBusy] = useState(false)
+ const [error, setError] = useState('')
+ const [dragged, setDragged] = useState<string | null>(null)
+
+ const pending = useRef(false)
+ const [showArchived, setShowArchived] = useState(false)
+ const [reload, setReload] = useState(0)
+
+ useEffect(() => {
+ const controller = new AbortController()
+ getTaskBoard(controller.signal)
+ .then(result => {
+ if (!controller.signal.aborted) setBoard(result)
+ })
+ .catch(() => {
+ if (!controller.signal.aborted) setError('kanban.loadError')
+ })
+ return () => controller.abort()
+ }, [reload])
+
+ async function act(operation: () => Promise<TaskBoard>, onSuccess?: () => void) {
+ if (pending.current || !board) return
+ pending.current = true
+ setBusy(true)
+ setError('')
+ try {
+ setBoard(await operation())
+ onSuccess?.()
+ } catch {
+ setError('kanban.saveError')
+ } finally {
+ pending.current = false
+ setBusy(false)
+ }
+ }
+
+ function startEdit(card: TaskCard) {
+ setEditing(card.id)
+ setDraftTitle(card.title)
+ setDraftNote(card.note)
+ }
+
+ const active = board?.cards.filter(card => !card.archived) ?? []
+ const visible = board?.cards.filter(card => card.archived === showArchived) ?? []
+ const count = (status: TaskStatus) => visible.filter(card => card.status === status).length
+
+ return (
+ <div className="h-full overflow-y-auto bg-[var(--background)] [scrollbar-gutter:stable]">
+ <main className="mx-auto max-w-5xl px-4 py-8 sm:px-8 pb-12 font-sans text-[var(--foreground)]">
+ <SpaceSectionHeader
+ icon={ClipboardList}
+ title={t('Task Board')}
+ description={t('kanban.intro')}
+ action={
+ <button
+ type="button"
+ aria-pressed={showArchived}
+ disabled={busy}
+ onClick={() => {
+ setShowArchived(value => !value)
+ setEditing(null)
+ }}
+ className="rounded-lg border border-[var(--border)] px-3 py-2 text-sm text-[var(--foreground)] hover:bg-[var(--accent)] disabled:opacity-40"
+ >
+ {t(showArchived ? 'kanban.showActive' : 'kanban.showArchived')}
+ </button>
+ }
+ meta={
+ <span className="rounded-full bg-[var(--muted)] px-2.5 py-1 font-sans text-xs font-medium text-[var(--muted-foreground)]">
+ {active.filter(card => card.status === 'doing').length} {t('kanban.working')}
+ </span>
+ }
+ />
+
+ <form
+ className="mb-7 flex gap-2 rounded-2xl bg-[var(--card)] p-2 shadow-sm ring-1 ring-[var(--border)]"
+ onSubmit={event => {
+ event.preventDefault()
+ if (title.trim())
+ void act(
+ () => createTaskCard(title),
+ () => {
+ setTitle('')
+ setShowArchived(false)
+ }
+ )
+ }}
+ >
+ <input
+ disabled={!board || busy}
+ aria-label={t('kanban.newTask')}
+ className="min-w-0 flex-1 bg-transparent px-3 py-2 outline-none placeholder:text-[var(--muted-foreground)]"
+ placeholder={t('kanban.placeholder')}
+ maxLength={160}
+ value={title}
+ onChange={event => setTitle(event.target.value)}
+ />
+ <button
+ disabled={busy || !board || !title.trim()}
+ className="flex items-center gap-2 rounded-xl bg-[var(--primary)] px-4 py-2 font-semibold text-[var(--primary-foreground)] transition hover:opacity-90 disabled:opacity-40"
+ type="submit"
+ >
+ <Plus size={18} /> {t('kanban.add')}
+ </button>
+ </form>
+ {!board && !error && (
+ <p role="status" className="mb-5 text-sm text-[var(--muted-foreground)]">
+ {t('kanban.loading')}
+ </p>
+ )}
+ {error && (
+ <p
+ role="alert"
+ className="mb-5 rounded-xl bg-[var(--secondary)] p-3 text-sm text-[var(--destructive)]"
+ >
+ {t(error)}
+ {!board && (
+ <button
+ type="button"
+ className="ml-3 underline"
+ onClick={() => {
+ setError('')
+ setReload(value => value + 1)
+ }}
+ >
+ {t('kanban.retry')}
+ </button>
+ )}
+ </p>
+ )}
+
+ <div aria-busy={busy || !board} className="grid gap-5 lg:grid-cols-3">
+ {columns.map((column, index) => (
+ <section
+ key={column.id}
+ aria-label={t(column.title)}
+ onDragOver={event => event.preventDefault()}
+ onDrop={event => {
+ event.preventDefault()
+ if (dragged && !showArchived)
+ void act(() => updateTaskCard(dragged, { status: column.id }))
+ setDragged(null)
+ }}
+ className="min-h-[22rem] rounded-2xl border border-[var(--border)] bg-[var(--secondary)] p-4"
+ >
+ <div className="mb-4 flex items-center justify-between">
+ <div className="flex items-center gap-3">
+ <span
+ className="h-2.5 w-2.5 rounded-full"
+ style={{ backgroundColor: column.tone }}
+ />
+ <div>
+ <h2 className="font-semibold">{t(column.title)}</h2>
+ <p className="text-xs text-[var(--muted-foreground)]">{t(column.hint)}</p>
+ </div>
+ </div>
+ <span className="rounded-full bg-[var(--card)] px-2.5 py-1 text-xs font-bold text-[var(--muted-foreground)]">
+ {count(column.id)}
+ </span>
+ </div>
+ <div className="space-y-3">
+ {visible
+ .filter(card => card.status === column.id)
+ .map(card => (
+ <article
+ key={card.id}
+ draggable={!busy && !showArchived && editing !== card.id}
+ onDragStart={event => {
+ event.dataTransfer.setData('text/plain', card.id)
+ event.dataTransfer.effectAllowed = 'move'
+ setDragged(card.id)
+ }}
+ onDragEnd={() => setDragged(null)}
+ className="rounded-xl bg-[var(--card)] p-4 shadow-sm ring-1 ring-[var(--border)]"
+ >
+ {editing === card.id ? (
+ <form
+ onSubmit={event => {
+ event.preventDefault()
+ if (draftTitle.trim())
+ void act(
+ () =>
+ updateTaskCard(card.id, { title: draftTitle, note: draftNote }),
+ () => setEditing(null)
+ )
+ }}
+ >
+ <input
+ aria-label={t('kanban.taskTitle')}
+ className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 font-semibold text-[var(--foreground)]"
+ maxLength={160}
+ value={draftTitle}
+ onChange={event => setDraftTitle(event.target.value)}
+ />
+ <textarea
+ aria-label={t('kanban.taskNote')}
+ className="mt-2 w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 text-sm text-[var(--foreground)]"
+ placeholder={t('kanban.notePlaceholder')}
+ rows={3}
+ maxLength={2000}
+ value={draftNote}
+ onChange={event => setDraftNote(event.target.value)}
+ />
+ <div className="mt-2 flex gap-2">
+ <button
+ disabled={busy || !draftTitle.trim()}
+ className="flex items-center gap-1 rounded-lg bg-[var(--primary)] px-3 py-1.5 text-xs font-semibold text-[var(--primary-foreground)] disabled:opacity-40"
+ type="submit"
+ >
+ <Check size={14} /> {t('kanban.save')}
+ </button>
+ <button
+ className="flex items-center gap-1 rounded-lg px-2 py-1.5 text-xs text-[var(--muted-foreground)]"
+ type="button"
+ onClick={() => setEditing(null)}
+ >
+ <X size={14} /> {t('kanban.cancel')}
+ </button>
+ </div>
+ </form>
+ ) : (
+ <>
+ <button
+ type="button"
+ disabled={busy}
+ className="w-full text-left"
+ onClick={() => startEdit(card)}
+ >
+ <strong className="break-words text-sm leading-6">{card.title}</strong>
+ {card.note && (
+ <p className="mt-1 whitespace-pre-wrap break-words text-xs leading-5 text-[var(--muted-foreground)]">
+ {card.note}
+ </p>
+ )}
+ </button>
+ <div className="mt-4 flex items-center justify-between border-t border-[var(--border)] pt-3">
+ <div className="flex gap-1">
+ {!showArchived && index > 0 && (
+ <button
+ disabled={busy}
+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index - 1].title)}`}
+ title={t('kanban.back')}
+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"
+ onClick={() =>
+ void act(() =>
+ updateTaskCard(card.id, { status: columns[index - 1].id })
+ )
+ }
+ >
+ <ArrowLeft size={16} />
+ </button>
+ )}
+ {!showArchived && index < 2 && (
+ <button
+ disabled={busy}
+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index + 1].title)}`}
+ title={t('kanban.forward')}
+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"
+ onClick={() =>
+ void act(() =>
+ updateTaskCard(card.id, { status: columns[index + 1].id })
+ )
+ }
+ >
+ <ArrowRight size={16} />
+ </button>
+ )}
+ </div>
+ <button
+ disabled={busy}
+ aria-label={`${card.title}: ${t(card.archived ? 'kanban.restore' : 'kanban.archive')}`}
+ title={t(card.archived ? 'kanban.restore' : 'kanban.archive')}
+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"
+ onClick={() =>
+ void act(() =>
+ updateTaskCard(card.id, { archived: !card.archived })
+ )
+ }
+ >
+ {card.archived ? <RotateCcw size={15} /> : <Archive size={15} />}
+ </button>
+ </div>
+ </>
+ )}
+ </article>
+ ))}
+ {board && count(column.id) === 0 && (
+ <p className="rounded-xl border border-dashed border-[var(--border)] px-4 py-10 text-center text-sm text-[var(--muted-foreground)]">
+ {t(showArchived ? 'kanban.emptyArchive' : 'kanban.empty')}
+ </p>
+ )}
+ </div>
+ </section>
+ ))}
+ </div>
+ <p className="mt-6 text-xs text-[var(--muted-foreground)]">{t('kanban.footer')}</p>
+ </main>
+ </div>
+ )
+}
diff --git a/web/components/sidebar/nav-entries.ts b/web/components/sidebar/nav-entries.ts
index f35927edf..8e7863939 100644
--- a/web/components/sidebar/nav-entries.ts
+++ b/web/components/sidebar/nav-entries.ts
@@ -5,6 +5,7 @@ import {
HeartHandshake,
House,
LayoutGrid,
+ ListTodo,
PenLine,
Settings,
type LucideIcon,
@@ -47,6 +48,7 @@ export const PRIMARY_NAV: NavEntry[] = [
tooltipKey: 'One tutor, your own way to learn.',
},
{ href: '/space', label: 'Learning Space', icon: LayoutGrid, tooltipKey: 'Space tooltip' },
+ { href: '/kanban', label: 'Task Board', icon: ListTodo, tooltipKey: 'kanban.intro' },
{
href: '/co-writer',
label: 'Co-Writer',
diff --git a/web/contracts/generated/api.ts b/web/contracts/generated/api.ts
index 9562048d5..f35feaef1 100644
--- a/web/contracts/generated/api.ts
+++ b/web/contracts/generated/api.ts
@@ -9518,6 +9518,66 @@ export interface paths {
readonly patch?: never;
readonly trace?: never;
};
+ readonly "/api/task-board": {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: never;
+ readonly path?: never;
+ readonly cookie?: never;
+ };
+ /**
+ * Get Board
+ * @description Return active and archived cards in the current workspace.
+ */
+ readonly get: operations["get_board_api_task_board_get"];
+ readonly put?: never;
+ readonly post?: never;
+ readonly delete?: never;
+ readonly options?: never;
+ readonly head?: never;
+ readonly patch?: never;
+ readonly trace?: never;
+ };
+ readonly "/api/task-board/cards": {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: never;
+ readonly path?: never;
+ readonly cookie?: never;
+ };
+ readonly get?: never;
+ readonly put?: never;
+ /**
+ * Create Card
+ * @description Create a task in the To do column.
+ */
+ readonly post: operations["create_card_api_task_board_cards_post"];
+ readonly delete?: never;
+ readonly options?: never;
+ readonly head?: never;
+ readonly patch?: never;
+ readonly trace?: never;
+ };
+ readonly "/api/task-board/cards/{card_id}": {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: never;
+ readonly path?: never;
+ readonly cookie?: never;
+ };
+ readonly get?: never;
+ readonly put?: never;
+ readonly post?: never;
+ readonly delete?: never;
+ readonly options?: never;
+ readonly head?: never;
+ /**
+ * Update Card
+ * @description Edit, move, archive or restore an existing task.
+ */
+ readonly patch: operations["update_card_api_task_board_cards__card_id__patch"];
+ readonly trace?: never;
+ };
readonly "/api/tools": {
readonly parameters: {
readonly query?: never;
@@ -11272,6 +11332,19 @@ export interface components {
*/
readonly user_intent: string;
};
+ /**
+ * CreateCard
+ * @description A learner-authored task; identifiers and timestamps are server-owned.
+ */
+ readonly CreateCard: {
+ /**
+ * Note
+ * @default
+ */
+ readonly note: string;
+ /** Title */
+ readonly title: string;
+ };
/** CreateCourseRequest */
readonly CreateCourseRequest: {
/**
@@ -14649,6 +14722,40 @@ export interface components {
/** Updated */
readonly updated: number;
};
+ /**
+ * TaskBoard
+ * @description A consistent snapshot of the current workspace's board.
+ */
+ readonly TaskBoard: {
+ /** Cards */
+ readonly cards: readonly components["schemas"]["TaskCard"][];
+ };
+ /**
+ * TaskCard
+ * @description Persisted card returned to the board, including archived cards.
+ */
+ readonly TaskCard: {
+ /** Archived */
+ readonly archived: boolean;
+ /** Created At */
+ readonly created_at: string;
+ /** Id */
+ readonly id: string;
+ /**
+ * Note
+ * @default
+ */
+ readonly note: string;
+ /**
+ * Status
+ * @enum {string}
+ */
+ readonly status: "todo" | "doing" | "done";
+ /** Title */
+ readonly title: string;
+ /** Updated At */
+ readonly updated_at: string;
+ };
/** TestResponse */
readonly TestResponse: {
/** Error */
@@ -15241,6 +15348,20 @@ export interface components {
/** Title */
readonly title?: string | null;
};
+ /**
+ * UpdateCard
+ * @description Only supplied fields change, preserving concurrent edits to other fields.
+ */
+ readonly UpdateCard: {
+ /** Archived */
+ readonly archived?: boolean | null;
+ /** Note */
+ readonly note?: string | null;
+ /** Status */
+ readonly status?: ("todo" | "doing" | "done") | null;
+ /** Title */
+ readonly title?: string | null;
+ };
/** UpdateCourseRequest */
readonly UpdateCourseRequest: {
/** Color */
@@ -16023,6 +16144,7 @@ export type SchemaConnectWeKnoraRequest =
components["schemas"]["ConnectWeKnoraRequest"];
export type SchemaCreateBookRequest =
components["schemas"]["CreateBookRequest"];
+export type SchemaCreateCard = components["schemas"]["CreateCard"];
export type SchemaCreateCourseRequest =
components["schemas"]["CreateCourseRequest"];
export type SchemaCreateDocumentRequest =
@@ -16359,6 +16481,8 @@ export type SchemaSyncFolderResponse =
export type SchemaSyncObjectIn = components["schemas"]["SyncObjectIn"];
export type SchemaSyncRequest = components["schemas"]["SyncRequest"];
export type SchemaSyncResponse = components["schemas"]["SyncResponse"];
+export type SchemaTaskBoard = components["schemas"]["TaskBoard"];
+export type SchemaTaskCard = components["schemas"]["TaskCard"];
export type SchemaTestResponse = components["schemas"]["TestResponse"];
export type SchemaTextPositionSelectorPayload =
components["schemas"]["TextPositionSelectorPayload"];
@@ -16389,6 +16513,7 @@ export type SchemaUiSettingsUpdate = components["schemas"]["UISettingsUpdate"];
export type SchemaUnitText = components["schemas"]["UnitText"];
export type SchemaUpdateBlockRequest =
components["schemas"]["UpdateBlockRequest"];
+export type SchemaUpdateCard = components["schemas"]["UpdateCard"];
export type SchemaUpdateCourseRequest =
components["schemas"]["UpdateCourseRequest"];
export type SchemaUpdateDocumentRequest =
@@ -37640,6 +37765,115 @@ export interface operations {
};
};
};
+ readonly get_board_api_task_board_get: {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: {
+ readonly Authorization?: string | null;
+ };
+ readonly path?: never;
+ readonly cookie?: {
+ readonly dt_token?: string | null;
+ };
+ };
+ readonly requestBody?: never;
+ readonly responses: {
+ /** @description Successful Response */
+ readonly 200: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["TaskBoard"];
+ };
+ };
+ /** @description Validation Error */
+ readonly 422: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["HTTPValidationError"];
+ };
+ };
+ };
+ };
+ readonly create_card_api_task_board_cards_post: {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: {
+ readonly Authorization?: string | null;
+ };
+ readonly path?: never;
+ readonly cookie?: {
+ readonly dt_token?: string | null;
+ };
+ };
+ readonly requestBody: {
+ readonly content: {
+ readonly "application/json": components["schemas"]["CreateCard"];
+ };
+ };
+ readonly responses: {
+ /** @description Successful Response */
+ readonly 201: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["TaskBoard"];
+ };
+ };
+ /** @description Validation Error */
+ readonly 422: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["HTTPValidationError"];
+ };
+ };
+ };
+ };
+ readonly update_card_api_task_board_cards__card_id__patch: {
+ readonly parameters: {
+ readonly query?: never;
+ readonly header?: {
+ readonly Authorization?: string | null;
+ };
+ readonly path: {
+ readonly card_id: string;
+ };
+ readonly cookie?: {
+ readonly dt_token?: string | null;
+ };
+ };
+ readonly requestBody: {
+ readonly content: {
+ readonly "application/json": components["schemas"]["UpdateCard"];
+ };
+ };
+ readonly responses: {
+ /** @description Successful Response */
+ readonly 200: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["TaskBoard"];
+ };
+ };
+ /** @description Validation Error */
+ readonly 422: {
+ headers: {
+ readonly [name: string]: unknown;
+ };
+ content: {
+ readonly "application/json": components["schemas"]["HTTPValidationError"];
+ };
+ };
+ };
+ };
readonly list_builtin_tools_api_tools_get: {
readonly parameters: {
readonly query?: never;
diff --git a/web/contracts/schema/openapi.json b/web/contracts/schema/openapi.json
index 4b7e844a0..6fd146877 100644
--- a/web/contracts/schema/openapi.json
+++ b/web/contracts/schema/openapi.json
@@ -2219,6 +2219,29 @@
"title": "CreateBookRequest",
"type": "object"
},
+ "CreateCard": {
+ "additionalProperties": false,
+ "description": "A learner-authored task; identifiers and timestamps are server-owned.",
+ "properties": {
+ "note": {
+ "default": "",
+ "maxLength": 2000,
+ "title": "Note",
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 160,
+ "minLength": 1,
+ "title": "Title",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title"
+ ],
+ "title": "CreateCard",
+ "type": "object"
+ },
"CreateCourseRequest": {
"properties": {
"color": {
@@ -9562,6 +9585,76 @@
"title": "TTSRequest",
"type": "object"
},
+ "TaskBoard": {
+ "description": "A consistent snapshot of the current workspace's board.",
+ "properties": {
+ "cards": {
+ "items": {
+ "$ref": "#/components/schemas/TaskCard"
+ },
+ "title": "Cards",
+ "type": "array"
+ }
+ },
+ "required": [
+ "cards"
+ ],
+ "title": "TaskBoard",
+ "type": "object"
+ },
+ "TaskCard": {
+ "additionalProperties": false,
+ "description": "Persisted card returned to the board, including archived cards.",
+ "properties": {
+ "archived": {
+ "title": "Archived",
+ "type": "boolean"
+ },
+ "created_at": {
+ "title": "Created At",
+ "type": "string"
+ },
+ "id": {
+ "title": "Id",
+ "type": "string"
+ },
+ "note": {
+ "default": "",
+ "maxLength": 2000,
+ "title": "Note",
+ "type": "string"
+ },
+ "status": {
+ "enum": [
+ "todo",
+ "doing",
+ "done"
+ ],
+ "title": "Status",
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 160,
+ "minLength": 1,
+ "title": "Title",
+ "type": "string"
+ },
+ "updated_at": {
+ "title": "Updated At",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "id",
+ "status",
+ "archived",
+ "created_at",
+ "updated_at"
+ ],
+ "title": "TaskCard",
+ "type": "object"
+ },
"TestResponse": {
"properties": {
"error": {
@@ -10776,6 +10869,66 @@
"title": "UpdateBlockRequest",
"type": "object"
},
+ "UpdateCard": {
+ "additionalProperties": false,
+ "description": "Only supplied fields change, preserving concurrent edits to other fields.",
+ "properties": {
+ "archived": {
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Archived"
+ },
+ "note": {
+ "anyOf": [
+ {
+ "maxLength": 2000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Note"
+ },
+ "status": {
+ "anyOf": [
+ {
+ "enum": [
+ "todo",
+ "doing",
+ "done"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Status"
+ },
+ "title": {
+ "anyOf": [
+ {
+ "maxLength": 160,
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Title"
+ }
+ },
+ "title": "UpdateCard",
+ "type": "object"
+ },
"UpdateCourseRequest": {
"properties": {
"color": {
@@ -56608,6 +56761,233 @@
]
}
},
+ "/api/task-board": {
+ "get": {
+ "description": "Return active and archived cards in the current workspace.",
+ "operationId": "get_board_api_task_board_get",
+ "parameters": [
+ {
+ "in": "header",
+ "name": "Authorization",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Authorization"
+ }
+ },
+ {
+ "in": "cookie",
+ "name": "dt_token",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Dt Token"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TaskBoard"
+ }
+ }
+ },
+ "description": "Successful Response"
+ },
+ "422": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ "description": "Validation Error"
+ }
+ },
+ "summary": "Get Board",
+ "tags": [
+ "task-board"
+ ]
+ }
+ },
+ "/api/task-board/cards": {
+ "post": {
+ "description": "Create a task in the To do column.",
+ "operationId": "create_card_api_task_board_cards_post",
+ "parameters": [
+ {
+ "in": "header",
+ "name": "Authorization",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Authorization"
+ }
+ },
+ {
+ "in": "cookie",
+ "name": "dt_token",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Dt Token"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/CreateCard"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "201": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TaskBoard"
+ }
+ }
+ },
+ "description": "Successful Response"
+ },
+ "422": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ "description": "Validation Error"
+ }
+ },
+ "summary": "Create Card",
+ "tags": [
+ "task-board"
+ ]
+ }
+ },
+ "/api/task-board/cards/{card_id}": {
+ "patch": {
+ "description": "Edit, move, archive or restore an existing task.",
+ "operationId": "update_card_api_task_board_cards__card_id__patch",
+ "parameters": [
+ {
+ "in": "path",
+ "name": "card_id",
+ "required": true,
+ "schema": {
+ "title": "Card Id",
+ "type": "string"
+ }
+ },
+ {
+ "in": "header",
+ "name": "Authorization",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Authorization"
+ }
+ },
+ {
+ "in": "cookie",
+ "name": "dt_token",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Dt Token"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/UpdateCard"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TaskBoard"
+ }
+ }
+ },
+ "description": "Successful Response"
+ },
+ "422": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ "description": "Validation Error"
+ }
+ },
+ "summary": "Update Card",
+ "tags": [
+ "task-board"
+ ]
+ }
+ },
"/api/tools": {
"get": {
"description": "Return all built-in tools the chat agent can invoke, plus any\ncoming-soon placeholders for the settings page.",
diff --git a/web/lib/task-board-api.ts b/web/lib/task-board-api.ts
new file mode 100644
index 000000000..4a1defa63
--- /dev/null
+++ b/web/lib/task-board-api.ts
@@ -0,0 +1,48 @@
+import { apiFetch, apiUrl } from '@/shared/api/client'
+
+export type TaskStatus = 'todo' | 'doing' | 'done'
+
+export interface TaskCard {
+ id: string
+ title: string
+ note: string
+ status: TaskStatus
+ archived: boolean
+ created_at: string
+ updated_at: string
+}
+
+export interface TaskBoard {
+ cards: TaskCard[]
+}
+
+const endpoint = '/api/task-board'
+
+async function request(path: string, init?: RequestInit): Promise<TaskBoard> {
+ const response = await apiFetch(apiUrl(path), init)
+ if (!response.ok) throw new Error('Task board request failed')
+ return response.json() as Promise<TaskBoard>
+}
+
+export function getTaskBoard(signal?: AbortSignal): Promise<TaskBoard> {
+ return request(endpoint, { signal, cache: 'no-store' })
+}
+
+export function createTaskCard(title: string): Promise<TaskBoard> {
+ return request(`${endpoint}/cards`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ title }),
+ })
+}
+
+export function updateTaskCard(
+ id: string,
+ changes: Partial<Pick<TaskCard, 'title' | 'note' | 'status' | 'archived'>>
+): Promise<TaskBoard> {
+ return request(`${endpoint}/cards/${encodeURIComponent(id)}`, {
+ method: 'PATCH',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify(changes),
+ })
+}
diff --git a/web/locales/en/app.json b/web/locales/en/app.json
index 1b3332c44..6a94b818c 100644
--- a/web/locales/en/app.json
+++ b/web/locales/en/app.json
@@ -5197,5 +5197,36 @@
"Workspace {{name}}": "Workspace {{name}}",
"The collection's files and reading conversations are kept in this workspace.": "The collection's files and reading conversations are kept in this workspace.",
"{{count}} files_one": "{{count}} file",
- "{{count}} files_other": "{{count}} files"
+ "{{count}} files_other": "{{count}} files",
+ "Task Board": "Task Board",
+ "kanban.intro": "Keep work moving from idea to done.",
+ "kanban.working": "in progress",
+ "kanban.todo": "To do",
+ "kanban.todoHint": "Next steps and ideas",
+ "kanban.doing": "In progress",
+ "kanban.doingHint": "What I am working on",
+ "kanban.done": "Done",
+ "kanban.doneHint": "Finished work",
+ "kanban.newTask": "New task",
+ "kanban.placeholder": "Add a task…",
+ "kanban.add": "Add",
+ "kanban.empty": "Drop a card here",
+ "kanban.taskTitle": "Task title",
+ "kanban.taskNote": "Task note",
+ "kanban.notePlaceholder": "Short note (optional)",
+ "kanban.save": "Save",
+ "kanban.cancel": "Cancel",
+ "kanban.back": "Move back",
+ "kanban.forward": "Move forward",
+ "kanban.moveTo": "Move to",
+ "kanban.archive": "Archive",
+ "kanban.footer": "Cards are saved in this workspace. Drag a card or use the arrow buttons to move it.",
+ "kanban.loadError": "Could not open the board. Refresh the page.",
+ "kanban.saveError": "Could not save the card.",
+ "kanban.loading": "Loading task board…",
+ "kanban.retry": "Retry",
+ "kanban.showArchived": "Show archived",
+ "kanban.showActive": "Show active",
+ "kanban.restore": "Restore",
+ "kanban.emptyArchive": "No archived tasks"
}
diff --git a/web/locales/fr/app.json b/web/locales/fr/app.json
index d07fd97f1..5856a367f 100644
--- a/web/locales/fr/app.json
+++ b/web/locales/fr/app.json
@@ -4442,5 +4442,36 @@
"The collection's files and reading conversations are kept in this workspace.": "Les fichiers de la collection et ses conversations de lecture sont conservés dans cet espace de travail.",
"{{count}} files_one": "{{count}} fichier",
"{{count}} files_other": "{{count}} fichiers",
- "Save new content to": "Enregistrer le nouveau contenu dans"
+ "Save new content to": "Enregistrer le nouveau contenu dans",
+ "Task Board": "Tableau des tâches",
+ "kanban.intro": "Faites avancer vos tâches de l'idée à la réalisation.",
+ "kanban.working": "en cours",
+ "kanban.todo": "À faire",
+ "kanban.todoHint": "Prochaines étapes et idées",
+ "kanban.doing": "En cours",
+ "kanban.doingHint": "Ce sur quoi je travaille",
+ "kanban.done": "Terminé",
+ "kanban.doneHint": "Travail terminé",
+ "kanban.newTask": "Nouvelle tâche",
+ "kanban.placeholder": "Ajouter une tâche…",
+ "kanban.add": "Ajouter",
+ "kanban.empty": "Déposez une carte ici",
+ "kanban.taskTitle": "Titre de la tâche",
+ "kanban.taskNote": "Note de la tâche",
+ "kanban.notePlaceholder": "Note courte (facultatif)",
+ "kanban.save": "Enregistrer",
+ "kanban.cancel": "Annuler",
+ "kanban.back": "Reculer",
+ "kanban.forward": "Avancer",
+ "kanban.moveTo": "Déplacer vers",
+ "kanban.archive": "Archiver",
+ "kanban.footer": "Les cartes sont enregistrées dans cet espace de travail. Déplacez-les par glisser-déposer ou avec les boutons fléchés.",
+ "kanban.loadError": "Impossible d'ouvrir le tableau. Actualisez la page.",
+ "kanban.saveError": "Impossible d'enregistrer la carte.",
+ "kanban.loading": "Chargement du tableau…",
+ "kanban.retry": "Réessayer",
+ "kanban.showArchived": "Afficher les archives",
+ "kanban.showActive": "Afficher les tâches actives",
+ "kanban.restore": "Restaurer",
+ "kanban.emptyArchive": "Aucune tâche archivée"
}
diff --git a/web/locales/uk/app.json b/web/locales/uk/app.json
index d9991009c..ed2cb9e21 100644
--- a/web/locales/uk/app.json
+++ b/web/locales/uk/app.json
@@ -5213,5 +5213,36 @@
"{{count}} files_one": "{{count}} файл",
"{{count}} files_few": "{{count}} файли",
"{{count}} files_many": "{{count}} файлів",
- "{{count}} files_other": "{{count}} файлу"
+ "{{count}} files_other": "{{count}} файлу",
+ "Task Board": "Дошка завдань",
+ "kanban.intro": "Переміщуйте завдання від ідеї до завершення.",
+ "kanban.working": "у роботі",
+ "kanban.todo": "Зробити",
+ "kanban.todoHint": "Наступні кроки та ідеї",
+ "kanban.doing": "У роботі",
+ "kanban.doingHint": "Над чим я працюю",
+ "kanban.done": "Готово",
+ "kanban.doneHint": "Завершена робота",
+ "kanban.newTask": "Нове завдання",
+ "kanban.placeholder": "Додати завдання…",
+ "kanban.add": "Додати",
+ "kanban.empty": "Перетягніть картку сюди",
+ "kanban.taskTitle": "Назва завдання",
+ "kanban.taskNote": "Нотатка до завдання",
+ "kanban.notePlaceholder": "Коротка нотатка (необов'язково)",
+ "kanban.save": "Зберегти",
+ "kanban.cancel": "Скасувати",
+ "kanban.back": "Назад",
+ "kanban.forward": "Уперед",
+ "kanban.moveTo": "Перемістити до",
+ "kanban.archive": "Архівувати",
+ "kanban.footer": "Картки зберігаються в цьому робочому просторі. Перетягніть картку або скористайтеся кнопками зі стрілками.",
+ "kanban.loadError": "Не вдалося відкрити дошку. Оновіть сторінку.",
+ "kanban.saveError": "Не вдалося зберегти картку.",
+ "kanban.loading": "Завантаження дошки завдань…",
+ "kanban.retry": "Повторити",
+ "kanban.showArchived": "Показати архівні",
+ "kanban.showActive": "Показати активні",
+ "kanban.restore": "Відновити",
+ "kanban.emptyArchive": "Немає архівних завдань"
}
diff --git a/web/locales/zh/app.json b/web/locales/zh/app.json
index 0f38bb2e4..985eb7bfe 100644
--- a/web/locales/zh/app.json
+++ b/web/locales/zh/app.json
@@ -5197,5 +5197,36 @@
"Workspace {{name}}": "工作区 {{name}}",
"The collection's files and reading conversations are kept in this workspace.": "资料组的原始文件和阅读对话都保存在这个工作区下。",
"{{count}} files_one": "{{count}} 个文件",
- "{{count}} files_other": "{{count}} 个文件"
+ "{{count}} files_other": "{{count}} 个文件",
+ "Task Board": "任务看板",
+ "kanban.intro": "让任务从想法逐步走向完成。",
+ "kanban.working": "项进行中",
+ "kanban.todo": "待办",
+ "kanban.todoHint": "下一步与想法",
+ "kanban.doing": "进行中",
+ "kanban.doingHint": "正在处理的事",
+ "kanban.done": "已完成",
+ "kanban.doneHint": "完成的工作",
+ "kanban.newTask": "新任务",
+ "kanban.placeholder": "添加任务…",
+ "kanban.add": "添加",
+ "kanban.empty": "将卡片拖到这里",
+ "kanban.taskTitle": "任务标题",
+ "kanban.taskNote": "任务备注",
+ "kanban.notePlaceholder": "简短备注(可选)",
+ "kanban.save": "保存",
+ "kanban.cancel": "取消",
+ "kanban.back": "移回",
+ "kanban.forward": "向前移动",
+ "kanban.moveTo": "移至",
+ "kanban.archive": "归档",
+ "kanban.footer": "卡片保存在当前工作区中。拖动卡片或使用箭头按钮移动。",
+ "kanban.loadError": "无法打开看板。请刷新页面。",
+ "kanban.saveError": "无法保存卡片。",
+ "kanban.loading": "正在加载任务看板…",
+ "kanban.retry": "重试",
+ "kanban.showArchived": "显示已归档",
+ "kanban.showActive": "显示未归档",
+ "kanban.restore": "恢复",
+ "kanban.emptyArchive": "没有已归档任务"
}
diff --git a/web/tests/sidebar-defaults.spec.tsx b/web/tests/sidebar-defaults.spec.tsx
index d4911ac92..39f938a64 100644
--- a/web/tests/sidebar-defaults.spec.tsx
+++ b/web/tests/sidebar-defaults.spec.tsx
@@ -12,7 +12,7 @@ import {
beforeEach(() => localStorage.clear());
-it("new profiles see four primary entries and two folded features", () => {
+it("new profiles see five primary entries and two folded features", () => {
expect(readNavLayout()).toBeNull();
const resolved = resolveNavLayout(
PRIMARY_NAV_HREFS,
@@ -24,6 +24,7 @@ it("new profiles see four primary entries and two folded features", () => {
"/partners",
"/learning",
"/space",
+ "/kanban",
]);
expect(resolved.collapsed).toEqual(["/co-writer", "/agents"]);
expect(resolved.customized).toBe(false);
diff --git a/web/tests/task-board.spec.tsx b/web/tests/task-board.spec.tsx
new file mode 100644
index 000000000..074f8d55e
--- /dev/null
+++ b/web/tests/task-board.spec.tsx
@@ -0,0 +1,139 @@
+import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import KanbanPage from '@/app/(workspace)/kanban/page'
+import type { TaskBoard } from '@/lib/task-board-api'
+import translations from '@/locales/en/app.json'
+
+vi.mock('react-i18next', () => ({
+ useTranslation: () => ({
+ t: (key: string) => (translations as Record<string, string>)[key] ?? key,
+ }),
+}))
+
+let board: TaskBoard
+let failSave: boolean
+
+beforeEach(() => {
+ board = { cards: [] }
+ failSave = false
+ window.history.replaceState({}, '', '/kanban?dt_workspace=study')
+ vi.stubGlobal(
+ 'fetch',
+ vi.fn(async (input: string, init?: RequestInit) => {
+ const url = new URL(input, window.location.origin)
+ expect(url.searchParams.get('dt_workspace')).toBe('study')
+ expect(init?.credentials).toBe('include')
+ if (init?.method === 'POST') {
+ if (failSave) return Response.json({}, { status: 500 })
+ const payload = JSON.parse(String(init.body))
+ board.cards.push({
+ id: 'task-1',
+ title: payload.title,
+ note: '',
+ status: 'todo',
+ archived: false,
+ created_at: '2026-01-01',
+ updated_at: '2026-01-01',
+ })
+ } else if (init?.method === 'PATCH') {
+ if (failSave) return Response.json({}, { status: 500 })
+ board.cards[0] = { ...board.cards[0], ...JSON.parse(String(init.body)) }
+ }
+ return Response.json(board)
+ })
+ )
+})
+
+afterEach(() => {
+ vi.unstubAllGlobals()
+ window.history.replaceState({}, '', '/')
+})
+
+async function addTask() {
+ await waitFor(() => expect(screen.getByRole('textbox', { name: 'New task' })).toBeEnabled())
+ fireEvent.change(screen.getByRole('textbox', { name: 'New task' }), {
+ target: { value: 'Review derivatives' },
+ })
+ fireEvent.click(screen.getByRole('button', { name: 'Add' }))
+ await screen.findByRole('button', { name: 'Review derivatives' })
+}
+
+describe('Task Board', () => {
+ it('creates, edits, moves, archives and restores cards through the scoped API', async () => {
+ render(<KanbanPage />)
+ await addTask()
+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))
+ fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {
+ target: { value: 'Three examples' },
+ })
+ fireEvent.click(screen.getByRole('button', { name: 'Save' }))
+ await screen.findByText('Three examples')
+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives: Move to In progress' }))
+ await waitFor(() =>
+ expect(
+ within(screen.getByRole('region', { name: 'In progress' })).getByText('Review derivatives')
+ ).toBeInTheDocument()
+ )
+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives: Archive' }))
+ await waitFor(() => expect(screen.queryByText('Review derivatives')).not.toBeInTheDocument())
+ fireEvent.click(screen.getByRole('button', { name: 'Show archived' }))
+ fireEvent.click(await screen.findByRole('button', { name: 'Review derivatives: Restore' }))
+ await waitFor(() => expect(screen.queryByText('Review derivatives')).not.toBeInTheDocument())
+ fireEvent.click(screen.getByRole('button', { name: 'Show active' }))
+ expect(
+ within(screen.getByRole('region', { name: 'In progress' })).getByText('Review derivatives')
+ ).toBeInTheDocument()
+ expect(screen.getByText('Three examples')).toBeInTheDocument()
+ })
+
+ it('moves a dragged card and reads it again after remounting', async () => {
+ const view = render(<KanbanPage />)
+ await addTask()
+ const dataTransfer = { setData: vi.fn(), effectAllowed: '' }
+ fireEvent.dragStart(screen.getByRole('article'), { dataTransfer })
+ fireEvent.drop(screen.getByRole('region', { name: 'Done' }), { dataTransfer })
+ await waitFor(() =>
+ expect(
+ within(screen.getByRole('region', { name: 'Done' })).getByText('Review derivatives')
+ ).toBeInTheDocument()
+ )
+ view.unmount()
+ render(<KanbanPage />)
+ await waitFor(() =>
+ expect(
+ within(screen.getByRole('region', { name: 'Done' })).getByText('Review derivatives')
+ ).toBeInTheDocument()
+ )
+ })
+
+ it('keeps the draft and existing card when saving fails', async () => {
+ render(<KanbanPage />)
+ await addTask()
+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))
+ fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {
+ target: { value: 'Unsaved note' },
+ })
+ failSave = true
+ fireEvent.click(screen.getByRole('button', { name: 'Save' }))
+ expect(await screen.findByRole('alert')).toHaveTextContent('Could not save the card.')
+ expect(screen.getByRole('textbox', { name: 'Task note' })).toHaveValue('Unsaved note')
+ expect(board.cards[0].note).toBe('')
+ })
+
+ it('disables creation during loading and lets a failed load retry', async () => {
+ let rejectLoad!: (error: Error) => void
+ vi.mocked(fetch).mockImplementationOnce(
+ () =>
+ new Promise((_resolve, reject) => {
+ rejectLoad = reject
+ })
+ )
+ render(<KanbanPage />)
+ expect(screen.getByRole('status')).toHaveTextContent('Loading task board')
+ expect(screen.getByRole('button', { name: 'Add' })).toBeDisabled()
+ await act(async () => rejectLoad(new Error('Offline')))
+ fireEvent.click(await screen.findByRole('button', { name: 'Retry' }))
+ await waitFor(() => expect(screen.getByRole('textbox', { name: 'New task' })).toBeEnabled())
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument()
+ })
+})