Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/app.$tenant/projects._index.tsx
T

157 lines
7.8 KiB
TypeScript

// R-P8b (P8 configurable Kanban) Interim-UI (AD-28) — board route `/projects`.
// Loader builds the KanbanBoardVM via the shared board helper; the screen is
// composed from ~/ui. Pipeline switch + only-mine are navigation (GET query);
// stage moves / bulk / quick-create POST intents. Final Subframe optics =
// tracked design-nachzug.
import { redirect, useActionData, useLoaderData, useNavigate, useNavigation, useSubmit, type ActionFunctionArgs, type LoaderFunctionArgs } from "react-router";
import { useTranslation } from "react-i18next";
import type { PipelineHandoverVM } from "@hivegrid/view-models";
import { EmptyState } from "~/ui/components/EmptyState";
import { getTranslations } from "~/locale/i18next.server";
import { loadProjectContext, PROJECT_READ_PERMISSIONS, projectActionErrorResponse, requireProjectPermission, requireProjectView } from "~/utils/integrations/projects/projectAccess.server";
import { PROJECTS_MODULE_KEY, projectBoardSettingsPath, projectDetailPath } from "~/utils/integrations/projects/projectRoutePaths";
import {
handleKanbanIntent,
kanbanIntentPermission,
loadKanbanData,
parseBoardFacetParams,
type KanbanLoaderData,
} from "~/utils/integrations/projects/projectBoardRoute.server";
import { ProjectServiceError } from "~/utils/integrations/projects/projectService.server";
import { PipelineKanbanPage } from "~/components/screens/projects/PipelineKanbanPage";
import { useBoardLiveUpdates } from "~/utils/stream/useBoardLiveUpdates";
import { useBoardFacetParams } from "~/hooks/use-board-facet-params";
import { useSaveToast } from "~/hooks/use-save-toast";
const BOARD_SUCCESS_KEYS: Record<string, string> = {
bulkMoveStage: "projects.toast.projectsMoved",
duplicateProject: "projects.toast.projectDuplicated",
archiveProject: "projects.toast.projectArchived",
handoverProject: "projects.toast.handoverCompleted",
moveToPipeline: "projects.toast.projectMovedToPipeline",
};
type ProjectsBoardLoaderData = KanbanLoaderData | { noPipeline: true; title: string; tenantSlug: string };
export async function loader({ request, params }: LoaderFunctionArgs) {
const ctx = await requireProjectView({ request, params }, PROJECT_READ_PERMISSIONS);
const { t, locale } = await getTranslations(request);
const url = new URL(request.url);
try {
const data = await loadKanbanData({
tenantSlug: params.tenant!,
tenantId: ctx.tenantId,
ctx,
pipelineId: url.searchParams.get("pipelineId"),
onlyMine: url.searchParams.get("onlyMine") === "1",
includeDemoData: url.searchParams.get("demo") === "show",
q: url.searchParams.get("q"),
facets: parseBoardFacetParams(url.searchParams),
locale,
});
return Response.json(data satisfies KanbanLoaderData);
} catch (error) {
if (!(error instanceof ProjectServiceError) || error.messageKey !== "projects.error.pipelineRequired") throw error;
return Response.json({
noPipeline: true,
title: t("projects.list.title"),
tenantSlug: params.tenant!,
} satisfies ProjectsBoardLoaderData);
}
}
export async function action({ request, params }: ActionFunctionArgs) {
const ctx = await loadProjectContext({ request, params, requireModule: true });
const form = await request.formData();
const intent = form.get("_action")?.toString() ?? null;
try {
requireProjectPermission(ctx, kanbanIntentPermission(intent));
const { createdProjectId, handover } = await handleKanbanIntent({ intent, form, tenantId: ctx.tenantId, ctx });
if (createdProjectId) return redirect(projectDetailPath(params.tenant!, createdProjectId));
// `handover` is non-null only when the move just put a card into a stage
// that offers M04 — the screen opens the dialog on it.
return Response.json({ ok: true, intent, messageKey: intent ? BOARD_SUCCESS_KEYS[intent] : undefined, handover: handover ?? null });
} catch (error) {
return projectActionErrorResponse(error);
}
}
export default function ProjectsBoardRoute() {
const { t } = useTranslation();
const data = useLoaderData<ProjectsBoardLoaderData>();
const navigate = useNavigate();
const { setParam, toggleFacet, removeChip, setPeriodRange, resetFilters } = useBoardFacetParams();
const submit = useSubmit();
const navigation = useNavigation();
const actionData = useActionData<{ intent?: string; ok?: boolean; error?: string; messageKey?: string; handover?: PipelineHandoverVM | null }>();
const toastResult = actionData?.error || (actionData?.intent && BOARD_SUCCESS_KEYS[actionData.intent]) ? actionData : undefined;
useSaveToast(toastResult);
const vmData = "noPipeline" in data ? null : data.vm.status === "ready" ? data.vm.data : null;
// Live board: subscribe to the pipeline SSE stream and revalidate on real
// change-events (route owns data/revalidation; the screen stays pure).
useBoardLiveUpdates(vmData?.sseHref, { paused: navigation.state !== "idle" });
function post(intent: string, fields: Record<string, string>) {
const fd = new FormData();
fd.set("_action", intent);
for (const [key, value] of Object.entries(fields)) fd.set(key, value);
submit(fd, { method: "post" });
}
if ("noPipeline" in data || !vmData) {
return (
<main className="mx-auto w-full max-w-6xl p-6" data-ui-id="ui.projects.board.empty">
<EmptyState title={t("projects.board.empty")} />
</main>
);
}
return (
// Full width so the screen's page header bar sits flush like every other list screen.
<main className="w-full">
<PipelineKanbanPage
data={vmData}
onlyMine={data.onlyMine}
q={data.q}
facets={data.facets}
periodFrom={data.facetSelection.periodFrom}
periodTo={data.facetSelection.periodTo}
includeDemoData={data.includeDemoData}
showDemoToggle={data.demoDataUiEnabled}
submitting={navigation.state !== "idle"}
errorKey={actionData?.error ?? null}
handover={actionData?.handover ?? null}
actions={{
onOpenProject: (detailHref) => navigate(detailHref),
onHandover: (projectId, fromPipelineId, selection) =>
post("handoverProject", { projectId, fromPipelineId, selection: JSON.stringify(selection) }),
onShowList: () => navigate(data.listHref),
// Board settings of THIS board (S04), not the board table — the page
// already knows which board it shows.
onManageBoard: () => navigate(projectBoardSettingsPath(data.tenantSlug, vmData.pipelineId)),
onSwitchPipeline: (pipelineId) => setParam("pipelineId", pipelineId),
onToggleOnlyMine: (checked) => setParam("onlyMine", checked ? "1" : ""),
onSearch: (q) => setParam("q", q),
onToggleFacet: toggleFacet,
onRemoveChip: removeChip,
onResetFilters: resetFilters,
onPeriodRangeChange: setPeriodRange,
onToggleDemo: (show) => setParam("demo", show ? "show" : ""),
onMove: (projectId, targetStageId, lostReasonId, notiz) =>
post("moveStage", { projectId, targetStageId, ...(lostReasonId ? { lostReasonId } : {}), ...(notiz ? { notiz } : {}) }),
onBulkMove: (projectIds, targetStageId) => post("bulkMoveStage", { projectIds: projectIds.join(","), targetStageId }),
onCreateProject: (fields) => post("createProject", { ...fields, pipelineId: data.pipelineId }),
onDuplicate: (projectId) => post("duplicateProject", { projectId }),
onArchive: (projectId) => post("archiveProject", { projectId }),
onUndoStage: (projectId) => post("undoStage", { projectId }),
onRedoStage: (projectId) => post("redoStage", { projectId }),
onMoveToPipeline: (projectId, targetPipelineId) => post("moveToPipeline", { projectId, targetPipelineId }),
}}
/>
</main>
);
}
export const handle = { moduleKey: PROJECTS_MODULE_KEY };