// P4 Tasks (AK-P4b) ยง6 โ€” Tasks browser route. Loader builds the TaskListVM once // (server-side); the component only renders (DoD A). Module off -> locked empty // state. Missing tasks.read_own -> 404. Presets (mine/created/all) + server-side // filters. The list shape is the reusable component (DoD 8); this route is its // standalone host. // // Baseline functional UI (data-ui-id markers for e2e); the Subframe visual polish // follows Davids D-P4 delta (Dev-Nachzug). import { type LoaderFunctionArgs, useLoaderData } from "react-router"; import { useTranslation } from "react-i18next"; import { buildTaskListVM, taskEntityLabelKey, taskPriorityKey, taskSourceKey, taskStatusKey, type TaskListPreset, type TaskListRow, type TaskListVM, } from "@toolctrl/view-models"; import { getTranslations } from "~/locale/i18next.server"; import { loadTasksContext, notFoundResponse, requireTasksPermission } from "~/utils/integrations/taskAccess.server"; import { listTasksForBrowser, resolveGroupLabels, resolveUserLabels, type TaskPriority, type TaskRow, type TaskStatus, } from "~/utils/integrations/taskService.server"; import { tasksDetailPath, tasksNewPath } from "~/utils/integrations/taskRoutePaths"; import ServerError from "~/components/ui/errors/ServerError"; type LoaderData = { title: string; vm: TaskListVM }; const PRESETS: readonly TaskListPreset[] = ["mine", "created", "all"]; const TERMINAL: ReadonlySet = new Set(["done", "cancelled"]); function parsePreset(value: string | null): TaskListPreset { return PRESETS.includes(value as TaskListPreset) ? (value as TaskListPreset) : "all"; } export const loader = async ({ request, params }: LoaderFunctionArgs) => { const { t } = await getTranslations(request); const ctx = await loadTasksContext({ request, params }); const tenantSlug = params.tenant ?? ""; const emptyFilter = { preset: "all" as TaskListPreset, status: null, priority: null, assignedToUserId: null, includeArchived: false }; if (!ctx.hasModule) { const vm = buildTaskListVM({ rows: [], filter: emptyFilter, canWrite: false, canDelete: false, createHref: tasksNewPath(tenantSlug) }); return Response.json({ title: `${t("tasks.list.title")} | ${process.env.APP_NAME}`, vm } satisfies LoaderData); } try { requireTasksPermission(ctx, "tasks.read_own"); } catch { throw notFoundResponse(); } const url = new URL(request.url); const preset = parsePreset(url.searchParams.get("preset")); const status = (url.searchParams.get("status") as TaskStatus | null) || null; const priority = (url.searchParams.get("priority") as TaskPriority | null) || null; const includeArchived = url.searchParams.get("archived") === "1"; const cursor = url.searchParams.get("cursor"); const { rows, nextCursor } = await listTasksForBrowser({ tenantId: ctx.tenantId, ctx, filter: { preset, status, priority, includeArchived }, cursor, }); // Batch-resolve assignee display names for the page. const [userLabels, groupLabels] = await Promise.all([ resolveUserLabels(rows.map((row) => row.assignedToUserId).filter((id): id is string => Boolean(id))), resolveGroupLabels( ctx.tenantId, rows.map((row) => row.assignedToGroupId).filter((id): id is string => Boolean(id)) ), ]); const now = Date.now(); const listRows: TaskListRow[] = rows.map((task) => toTaskListRow(task, { tenantSlug, userLabels, groupLabels, now })); const canWrite = ctx.permissions.includes("tasks.write"); const canDelete = ctx.permissions.includes("tasks.delete"); const vm = buildTaskListVM({ rows: listRows, filter: { preset, status, priority, assignedToUserId: null, includeArchived }, canWrite, canDelete, createHref: tasksNewPath(tenantSlug), nextCursor, }); return Response.json({ title: `${t("tasks.list.title")} | ${process.env.APP_NAME}`, vm } satisfies LoaderData); }; /** Map a domain TaskRow to the routing-resolved TaskListRow (shared by embeds). */ export function toTaskListRow( task: TaskRow, deps: { tenantSlug: string; userLabels: Map; groupLabels: Map; now: number } ): TaskListRow { const assignee = task.assignedToUserId ? { kind: "user" as const, label: deps.userLabels.get(task.assignedToUserId) ?? task.assignedToUserId } : task.assignedToGroupId ? { kind: "group" as const, label: deps.groupLabels.get(task.assignedToGroupId) ?? task.assignedToGroupId } : null; return { id: task.id, title: task.title, status: task.status, statusKey: taskStatusKey(task.status), priority: task.priority, priorityKey: taskPriorityKey(task.priority), deadlineIso: task.deadline ? task.deadline.toISOString() : null, isOverdue: Boolean(task.deadline && task.deadline.getTime() < deps.now && !TERMINAL.has(task.status)), assignee, linkedEntity: task.linkedEntityType && task.linkedEntityId ? { entityType: task.linkedEntityType, entityId: task.linkedEntityId, labelKey: taskEntityLabelKey(task.linkedEntityType) } : null, source: task.source, sourceKey: taskSourceKey(task.source), sourceHref: null, detailHref: tasksDetailPath(deps.tenantSlug, task.id), }; } export default function TasksBrowserRoute() { const { t, i18n } = useTranslation(); const { vm } = useLoaderData(); if (vm.status !== "ready" || !vm.data) { return
; } const { rows, canWrite, createHref, emptyHeadlineKey, emptyBodyKey } = vm.data; const dateFormatter = new Intl.DateTimeFormat(i18n.language, { dateStyle: "medium" }); return (

{t("tasks.list.title")}

{t("tasks.list.subtitle")}

{canWrite ? ( {t("tasks.list.actions.new")} ) : null}
{rows.length === 0 ? (

{t(emptyHeadlineKey)}

{t(emptyBodyKey)}

) : ( {rows.map((row) => ( ))}
{t("tasks.list.column.title")} {t("tasks.list.column.status")} {t("tasks.list.column.priority")} {t("tasks.list.column.assignee")} {t("tasks.list.column.deadline")}
{row.title} {t(row.statusKey)} {t(row.priorityKey)} {row.assignee ? row.assignee.label : "โ€”"} {row.deadlineIso ? dateFormatter.format(new Date(row.deadlineIso)) : "โ€”"}
)}
); } export function ErrorBoundary() { return ; }