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

130 lines
5.9 KiB
TypeScript

// P17 HR-Hub workflows (AK-P17b) — announcement detail. Opening marks it read;
// shows the markdown body, grouped reactions (toggle), single-level comments
// (add), an acknowledgement button when required, and a read-receipt table for
// managers (hr.write). Transitional UI.
import { type ActionFunctionArgs, type LoaderFunctionArgs, useFetcher, useLoaderData } from "react-router";
import { buildAnnouncementDetailVM, type HrAnnouncementDetailVM } from "@hivegrid/view-models";
import { getTranslations } from "~/locale/i18next.server";
import { badRequestResponse, hrActionErrorResponse, hrHasPermission, loadHrContext, notFoundResponse, requireHrPermission } from "~/utils/integrations/hrAccess.server";
import { resolveUserLabels } from "~/utils/integrations/hrService.server";
import { acknowledge, addComment, getAnnouncementOrThrow, getReactionGroups, getUserAckState, listComments, listReadReceipts, markRead, toggleReaction } from "~/utils/integrations/hrAnnouncementService.server";
import { requireHrAudienceViewer } from "~/utils/integrations/hrAudience.server";
import ServerError from "~/components/ui/errors/ServerError";
import { HrAnnouncementDetailPage } from "~/components/screens/hr/HrAnnouncementDetailPage";
import { useSaveToast, type SaveActionResult } from "~/hooks/use-save-toast";
type LoaderData = { title: string; vm: HrAnnouncementDetailVM };
type ActionData = Exclude<SaveActionResult, null | undefined>;
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
const { t } = await getTranslations(request);
const ctx = await loadHrContext({ request, params });
const announcementId = params.id ?? "";
if (!ctx.hasModule) throw notFoundResponse();
try {
requireHrPermission(ctx, "hr.read_own");
} catch {
throw notFoundResponse();
}
const announcement = await getAnnouncementOrThrow(ctx.tenantId, announcementId);
const canManage = hrHasPermission(ctx, "hr.write");
try {
await requireHrAudienceViewer({
tenantId: ctx.tenantId,
userId: ctx.userId,
kind: announcement.audienceKind,
ref: announcement.audienceRef,
canManage,
});
} catch {
throw notFoundResponse();
}
await markRead({ tenantId: ctx.tenantId, announcementId, userId: ctx.userId });
const [reactions, comments, isAcknowledged, receiptsRaw] = await Promise.all([
getReactionGroups(ctx.tenantId, announcementId, ctx.userId),
listComments(ctx.tenantId, announcementId),
getUserAckState(ctx.tenantId, announcementId, ctx.userId),
canManage ? listReadReceipts(ctx.tenantId, announcementId) : Promise.resolve([]),
]);
const labelIds = [announcement.authorUserId, ...comments.map((c) => c.userId), ...receiptsRaw.map((r) => r.userId)];
const labels = await resolveUserLabels(labelIds);
const vm = buildAnnouncementDetailVM({
id: announcement.id,
title: announcement.title,
bodyMarkdown: announcement.body,
authorLabel: labels.get(announcement.authorUserId)?.label ?? t("hr.picker.unknownMember"),
publishedIso: (announcement.publishAt ?? announcement.createdAt).toISOString(),
requiresAcknowledgement: announcement.requiresAcknowledgement,
isAcknowledged,
reactions,
comments: comments.map((c) => ({ id: c.id, authorLabel: labels.get(c.userId)?.label ?? t("hr.picker.unknownMember"), body: c.body, createdIso: c.createdAt.toISOString(), canArchive: canManage })),
canManage,
readReceipts: receiptsRaw.map((r) => ({ userLabel: labels.get(r.userId)?.label ?? t("hr.picker.unknownMember"), readIso: r.readAt.toISOString(), acknowledged: r.acknowledgedAt != null })),
});
return Response.json({ title: `${announcement.title} | ${process.env.APP_NAME}`, vm } satisfies LoaderData);
};
export const action = async ({ request, params }: ActionFunctionArgs) => {
const ctx = await loadHrContext({ request, params, requireModule: true });
requireHrPermission(ctx, "hr.read_own");
const announcementId = params.id ?? "";
const form = await request.formData();
const intent = form.get("intent")?.toString();
try {
const announcement = await getAnnouncementOrThrow(ctx.tenantId, announcementId);
await requireHrAudienceViewer({
tenantId: ctx.tenantId,
userId: ctx.userId,
kind: announcement.audienceKind,
ref: announcement.audienceRef,
canManage: hrHasPermission(ctx, "hr.write"),
});
if (intent === "ack") {
await acknowledge({ tenantId: ctx.tenantId, announcementId, userId: ctx.userId });
return Response.json({ intent, ok: true });
}
if (intent === "react") {
await toggleReaction({ tenantId: ctx.tenantId, announcementId, userId: ctx.userId, reaction: form.get("reaction")?.toString() ?? "👍" });
return Response.json({ intent, ok: true });
}
if (intent === "comment") {
await addComment({ tenantId: ctx.tenantId, announcementId, userId: ctx.userId, body: form.get("body")?.toString() ?? "" });
return Response.json({ intent, ok: true });
}
throw badRequestResponse();
} catch (error) {
if (error instanceof Response) throw error;
return hrActionErrorResponse(error);
}
};
export default function HrAnnouncementDetailRoute() {
const { vm } = useLoaderData<LoaderData>();
const fetcher = useFetcher<ActionData>();
// Acknowledgements, reactions and comments update visibly in place. Only a
// failed mutation needs an additional notification here.
useSaveToast(fetcher.data?.error ? fetcher.data : undefined);
const submit = (values: Record<string, string>) => fetcher.submit(values, { method: "post" });
return (
<HrAnnouncementDetailPage
vm={vm}
submitting={fetcher.state !== "idle"}
actions={{
onAck: () => submit({ intent: "ack" }),
onReact: (reaction) => submit({ intent: "react", reaction }),
onComment: (body) => submit({ intent: "comment", body }),
}}
/>
);
}
export function ErrorBoundary() {
return <ServerError />;
}
export const handle = { moduleKey: "hr" };