Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/components/screens/signature/ProjectSignaturePanel.tsx
T

226 lines
11 KiB
TypeScript

// AK-P16d Interim-UI (AD-28) — project signature panel (D-P16 "Signatur-Wizard"
// surface inside the project detail): per-document status tracking with signer
// rows, remind/revoke/send actions, artifact downloads and the preparation
// wizard dialog. Pure presentational: VM + actions come in as props, submits go
// through the project route's existing signature intents. Final Subframe optics
// land as a tracked design-nachzug once David's D-P16 ships.
//
// Remind honesty note: the backend records the reminder timestamp/event only —
// no reminder email is queued yet, so the UI copy says "vermerkt".
import { useState } from "react";
import { useTranslation } from "react-i18next";
import type { ProjectSignatureDocumentRow, ProjectSignaturePanelVM } from "@hivegrid/view-models";
import { Alert } from "~/ui/components/Alert";
import { BadgeFeedback } from "~/ui/components/BadgeFeedback";
import { Button } from "~/ui/components/Button";
import { Card } from "~/ui/components/Card";
import { Dialog } from "~/ui/components/Dialog";
import { EmptyState } from "~/ui/components/EmptyState";
import { Table } from "~/ui/components/Table";
import { APP_TIME_ZONE } from "~/locale/format";
import { SignatureWizardDialog, type SignatureWizardSubmitFields } from "./SignatureWizardDialog";
export type SignaturePanelSubmit = (intent: string, fields?: Record<string, string>) => void;
export type ProjectSignaturePanelProps = {
vm: ProjectSignaturePanelVM;
submitting: boolean;
errorKey?: string | null;
actions: {
onSubmit: SignaturePanelSubmit;
uploadPdf?: (file: File) => Promise<{ id: string; displayName: string }>;
};
};
const mutedText = "text-body-default-regular-0 font-body-default-regular-0 text-text-neutral-secondary";
const headingText = "text-body-large-0 font-body-large-0 text-text-neutral-primary";
const linkText = "text-body-default-medium-0 font-body-default-medium-0 text-brand-brand-text-default hover:underline";
type ConfirmState = { kind: "send" | "revoke"; documentId: string; documentTitle: string } | null;
function formatDateTime(value: string | null, language: string): string {
if (!value) return "—";
return new Intl.DateTimeFormat(language, { timeZone: APP_TIME_ZONE, dateStyle: "medium", timeStyle: "short" }).format(new Date(value));
}
function documentBadgeColor(status: ProjectSignatureDocumentRow["status"]): "subtle-positive" | "subtle-negative" | "subtle-warning" | "subtle-neutral" {
if (status === "signed") return "subtle-positive";
if (status === "declined" || status === "revoked" || status === "expired") return "subtle-negative";
if (status === "sent" || status === "viewed") return "subtle-warning";
return "subtle-neutral";
}
export function ProjectSignaturePanel(props: ProjectSignaturePanelProps) {
const { t, i18n } = useTranslation();
const [wizardOpen, setWizardOpen] = useState(false);
const [confirm, setConfirm] = useState<ConfirmState>(null);
if (props.vm.status !== "ready" || !props.vm.data.canRead) return null;
const data = props.vm.data;
const submit = props.actions.onSubmit;
function submitWizard(intent: "create" | "createAndSend", fields: SignatureWizardSubmitFields) {
submit(intent === "create" ? data.createActionIntent : data.createAndSendActionIntent, fields);
setWizardOpen(false);
}
function confirmAction() {
if (!confirm) return;
submit(confirm.kind === "send" ? data.sendActionIntent : data.revokeActionIntent, { documentId: confirm.documentId });
setConfirm(null);
}
return (
<Card data-ui-id="ui.projects.operations.signature">
<div className="flex flex-wrap items-start justify-between gap-3">
<div className="flex flex-col gap-1">
<span className={headingText}>{t("signature.project.title")}</span>
<span className={mutedText}>{t(data.designBlockedByKey)}</span>
</div>
{data.canSend ? (
<Button loading={props.submitting} onClick={() => setWizardOpen(true)} data-ui-id="ui.projects.operations.signature.prepare">
{t("signature.actions.createDraft")}
</Button>
) : null}
</div>
{props.errorKey ? <Alert variant="error" title={t(props.errorKey)} /> : null}
{data.rows.length === 0 ? (
<EmptyState outlined title={t(data.emptyHeadlineKey)} body={t(data.emptyBodyKey)} />
) : (
<div className="flex w-full flex-col gap-4">
{data.rows.map((document) => (
<div key={document.id} className="flex w-full flex-col gap-4 rounded-md border border-solid border-border-default p-4" data-ui-id="ui.projects.operations.signature.document">
<div className="flex flex-wrap items-start justify-between gap-3">
<div className="flex flex-col gap-1">
<div className="flex flex-wrap items-center gap-2">
<span className={headingText}>{document.title}</span>
<BadgeFeedback farbe={documentBadgeColor(document.status)}>{t(document.statusKey)}</BadgeFeedback>
<BadgeFeedback farbe="subtle-neutral">{t(document.providerKey)}</BadgeFeedback>
</div>
<span className={mutedText}>
{t("signature.panel.sentAt")}: {formatDateTime(document.sentAtIso, i18n.language)} · {t("signature.panel.expiresAt")}: {formatDateTime(document.expiresAtIso, i18n.language)}
</span>
</div>
<div className="flex flex-wrap items-center gap-2">
{data.canSend && document.status === "draft" ? (
<Button size="small" loading={props.submitting} onClick={() => setConfirm({ kind: "send", documentId: document.id, documentTitle: document.title })}>
{t("signature.actions.send")}
</Button>
) : null}
{data.canRevoke && document.status !== "signed" && document.status !== "revoked" ? (
<Button
variant="tertiary"
size="small"
loading={props.submitting}
onClick={() => setConfirm({ kind: "revoke", documentId: document.id, documentTitle: document.title })}
>
{t("signature.actions.revoke")}
</Button>
) : null}
</div>
</div>
<div className="flex flex-wrap items-center gap-4">
{document.sourcePdfUrl ? (
<a className={linkText} href={document.sourcePdfUrl} target="_blank" rel="noreferrer">
{t("signature.actions.downloadSource")}
</a>
) : null}
{document.signedPdfUrl ? (
<a className={linkText} href={document.signedPdfUrl} target="_blank" rel="noreferrer">
{t("signature.actions.downloadSigned")}
</a>
) : null}
{document.completionCertUrl ? (
<a className={linkText} href={document.completionCertUrl} target="_blank" rel="noreferrer">
{t("signature.actions.downloadCertificate")}
</a>
) : null}
</div>
<Table>
<Table.HeaderRow>
<Table.HeaderCell>{t("signature.fields.signerName")}</Table.HeaderCell>
<Table.HeaderCell>{t("signature.fields.signerEmail")}</Table.HeaderCell>
<Table.HeaderCell>{t("signature.fields.signerRole")}</Table.HeaderCell>
<Table.HeaderCell>{t("signature.panel.signerStatus")}</Table.HeaderCell>
<Table.HeaderCell>{t("signature.panel.signedAt")}</Table.HeaderCell>
<Table.HeaderCell>{t("signature.panel.lastReminder")}</Table.HeaderCell>
<Table.HeaderCell />
</Table.HeaderRow>
{document.signers.map((signer) => (
<Table.Row key={signer.id}>
<Table.Cell>{signer.signerName}</Table.Cell>
<Table.Cell>{signer.signerEmail}</Table.Cell>
<Table.Cell>{t(`signature.roles.${signer.signerRole}`)}</Table.Cell>
<Table.Cell>
<BadgeFeedback farbe={signer.status === "signed" ? "subtle-positive" : "subtle-neutral"}>{t(signer.statusKey)}</BadgeFeedback>
</Table.Cell>
<Table.Cell>{formatDateTime(signer.signedAtIso, i18n.language)}</Table.Cell>
<Table.Cell>{formatDateTime(signer.lastReminderAtIso, i18n.language)}</Table.Cell>
<Table.Cell>
{data.canSend && (signer.status === "sent" || signer.status === "viewed") ? (
<Button
variant="tertiary"
size="small"
loading={props.submitting}
onClick={() => submit(data.remindActionIntent, { signerId: signer.id })}
data-ui-id="ui.projects.operations.signature.remind"
>
{t("signature.actions.remind")}
</Button>
) : null}
</Table.Cell>
</Table.Row>
))}
</Table>
{data.canSend ? <span className={mutedText}>{t("signature.panel.remindHint")}</span> : null}
</div>
))}
</div>
)}
<SignatureWizardDialog
open={wizardOpen}
pdfFileOptions={data.pdfFileOptions}
kontaktSuggestions={data.kontaktSuggestions}
submitting={props.submitting}
errorKey={props.errorKey}
onSubmit={submitWizard}
onClose={() => setWizardOpen(false)}
uploadPdf={props.actions.uploadPdf}
/>
<Dialog open={confirm !== null} onOpenChange={(nextOpen: boolean) => (nextOpen ? undefined : setConfirm(null))}>
<Dialog.Content className="w-[420px] max-w-[90vw] p-6">
{confirm ? (
<div className="flex w-full flex-col gap-6" data-ui-id="ui.projects.operations.signature.confirm">
<div className="flex flex-col gap-2">
<span className="text-heading-3 font-heading-3 text-text-neutral-primary">{t(`signature.confirm.${confirm.kind}.title`)}</span>
<span className="text-body-default-regular-150 font-body-default-regular-150 text-text-neutral-secondary">
{t(`signature.confirm.${confirm.kind}.body`, { title: confirm.documentTitle })}
</span>
</div>
<div className="flex w-full items-center justify-end gap-2">
<Button variant="tertiary" onClick={() => setConfirm(null)}>
{t("shared.cancel")}
</Button>
<Button
variant={confirm.kind === "revoke" ? "destructive" : "primary"}
loading={props.submitting}
onClick={confirmAction}
data-ui-id="ui.projects.operations.signature.confirm.action"
>
{t(`signature.confirm.${confirm.kind}.confirm`)}
</Button>
</div>
</div>
) : null}
</Dialog.Content>
</Dialog>
</Card>
);
}