F1 component kit/Actions and confirmation/Prepare → open PDF and cloud print statusPhone

Prepare → open PDF and cloud print status

Missing · new31 · document-print

Printed documents stay server PDFs opened in a new tab through a short-lived signed link (T001 Q26): prepare → ready (expires) → open, and expired → prepare again. Cloud print to the Shanghai agent: queued → sent → printed, or failed + reprint.

Covers: M04. Exports: DocumentLink, PrintJobStatus.

Whole page:CompactComfortableLaravel · navyDTC · midnight green

Anatomy States Density EN · 中文 Edge cases Contract

Anatomy

The component as it sits in the product: English, compact, real data shapes.

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

States

8 states, left to right, top to bottom. A mock poll never finishes, so each state is drawn on purpose.

open PDF

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

preparing link

Order bill · 4521Asking for a signed link…

ready · expires

Order bill · 4521Link ready · expires in 4:52

link expired

Order bill · 4521The signed link expired (5 min). Prepare a new one.

cloud print · queued

Order bill · 4521Cloud print → Shanghai print agent · job 7781

Queued

sent to printer

Order bill · 4521Picked up by the agent 06:41

Sent to printer

printed

Order bill · 4521Printed 06:42 · FRR office printer

Printed

failed · reprint

Order bill · 4521Printer offline in Shanghai · 06:12

Failed

Density

Compact (2b ultra, the default) and comfortable, side by side. Same markup, only the density tokens change.

compact · default · data-density=compact

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

comfortable · data-density=comfortable

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

English · 中文

Staff pick en or cn (T001 Q25). Labels arrive localised; CJK falls back to PingFang SC / Noto Sans SC.

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

中文 · lang=zh-Hans

订单 · 4521服务器 PDF · 通过短时签名链接在新标签页打开

Long string · permission denied

The long-string case (PL-063) and what a role without the permission sees (the server decides; T003).

long string

Container ticket · shipment 2026-10-SHA-DUB-014 · 38 cartons · Atelier North, Kestrel Tailoring, Harrow & ValeServer PDF · opens in a new tab through a short-lived signed link

permission denied

Order bill · 4521Server PDF

Support may open PDFs (view orders) but never sees Cloud print (print orders): the control is absent, not disabled.

Both apps

One @rj/admin-kit component, two themes: the Laravel admin (navy pinned) and the DTC admin (kit v4 Midnight green), by token swap only.

Laravel admin · :root

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

DTC admin · data-theme=dtc

Order bill · 4521Server PDF · opens in a new tab through a short-lived signed link

Contract

The @rj/admin-kit API for this family. Mirrored in CONTRACT.md.

Export: DocumentLink · @rj/admin-kit
Props: prepare (op returning {url, expires_at}) · label
States: idle · preparing · ready (countdown) · expired · error
shadcn / Radix: Button + Badge
Package underneath: useMutation + window.open (no PDF library)
Accessibility: announces “PDF opened in a new tab”
API operations: admin.orders.print-url → admin.signed.orders.print · admin.orders.markup-pdf-url · admin.orders.bulk-print-url · admin.orders.print-jobs.pdf-url · admin.shipping.containers.ticket-url · admin.pricing.export-download-url

Export: PrintJobStatus · @rj/admin-kit
Props: job · onReprint
States: queued · sent · printed · failed + reprint
Package underneath: react-query polling
API operations: admin.orders.cloud-print · admin.orders.print-jobs.index / .reprint · admin.print-studio.jobs.status
Phone variant: same; reprint is a phone job