RJ Laravel Admin · round-1 hand-off

RJ Laravel Admin · design hand-off (round 1) Reference

The design for the new standalone admin at admin.rjmtm.com (staging stg-admin.rjmtm.com), built on the documented admin REST API. Design only: a separate frontend team builds it. This page is the one front door: every live board, the pack files and the status of each decision.

Build order (recommended)

1. @rj/admin-kit package (tokens, primitives, F1 composites)
2. Shell (permission-shaped from /admin/me/menu, rail, header, job tray, ⌘K)
3. Orders flagship (index + order page)
4. Tickets
5. Designs
6. Pricing
7. Archetype waves 1 → 4 (page map)

Rule: invent nothing. Real statuses, fields and buttons only; the truth docs are the source. Anything beyond today's admin is in Proposals, tagged UI-only · needs-backend · needs-a-decision.

Direction · 4b·R HQ Lockup + labelled rail Decided

White header with the white RJ HQ · Master admin corner; the exact DTC navy #0E1729 sidebar; a 76px collapsed rail with a label under every icon; 2b ultra density (12.5px body, 30px rows) with comfortable as a token mode; a light tape-measure motif. Picked by Frank in chat, 2026-10-18 (round 2, baseline 2b).

Foundations · tokens, themes, density Decided

One token file, two themes, two densities. Laravel (:root): navy #0E1729 pinned on sidebar + primary, steel #2C4B86 for selection and focus only, grey ground #EDF0F4, white containers. DTC ([data-theme="dtc"]): Midnight green #08120E, shipped to production 2026-10-18. Density: compact is the Laravel default; [data-density="comfortable"] per person, always on phone. Type: Archivo (titles, buttons, never wide) · IBM Plex Sans (reading) · IBM Plex Mono (ids, codes) · PingFang SC / Noto Sans SC for 中文.

Kit · F1 component kit v1 (@rj/admin-kit) Decided

36 F1 families on top of the 86 components inherited by name from the DTC kit v4. Every specimen: desktop + phone, both densities, EN + 中文, long strings, permission denied. CONTRACT.md is the component spec (name, props, states, shadcn/Radix mapping, package underneath). Open: the kit's repo location (deferred, default RJmtm/admin-kit).

Archetypes · 11 page patterns Decided

Decision B approved for every non-flagship page (Frank, 2026-10-18). Locked layouts: A01·a full-width table · A02·a tabs · A03·a section nav left · A06·a table of runs · A11·a 3-pane. A07 gantt folds into A05 as its timeline variant.

Flagship · Orders index Round 2 in progress

Round 1 accepted with defaults; needs more work. Round 2 (quiet pass: removes in-UI helper text) is running at the same URL. When round 2 lands, this sheet shows round 2 at / and round 1 moves to /r1/.

12 open questions for Frank, each with a recommended default (see the R1 notes).

Flagship · Order page (order detail) Round 2 in progress

A02·a tabs + front matter + side panel; the action model, 11 modals, settlement with an Idempotency-Key. Same sheet as Orders (canvas page 2). Round 2 in progress. When round 2 lands, this sheet shows round 2 at / and round 1 moves to /r1/.

Flagship · Support tickets Round 2 in progress

A11·a 3-pane inbox: list · thread · context. Round 1 delivered; round 2 (quiet pass) in progress at the same URL. When round 2 lands, this sheet shows round 2 at / and round 1 moves to /r1/.

12 open questions for Frank, each with a recommended default (see the R1 notes).

Flagship · Designs (every designs-module page) Round 2 in progress

All 25 designs-module pages are flagship. Round 1 drew index, setup journey, create, edit, swatch rows and Bulk Hub; the other 21 pages are queued for designs round 2. Round 2 (quiet pass) in progress. When round 2 lands, this sheet shows round 2 at / and round 1 moves to /r1/.

12 open questions for Frank, each with a recommended default (see the R1 notes).

Flagship · Pricing Round 2 in progress

Round 2 in progress: restructured into two equal prongs, fabric combination pricing and design pricing. Same URL. When round 2 lands, this sheet shows round 2 at / and round 1 moves to /r1/.

13 open questions for Frank, each with a recommended default (see the R1 notes).

Flagship · Gantt Deferred

Three directions (G1 Ledger ★ · G2 Floor · G3 Countdown). Recommended G1 with G2 as its Factories view and G3 as the dashboard widget. The pick is deferred to the end of the run.

Power-ups · all 24 adopted Decided

Frank loved all 24 round-1 patterns: ⌘K, Find order, shortcuts + ? sheet, recent/pinned, saved views, URL filter chips, job tray, bulk bar with batch progress, prepare → open PDF, peek sheet, hover cards, copy ID, activity panel, empty states, density switch, inline edit + undo, conflict banner, confirmation ladder, unsaved bar, live/stale/offline banner, my-timezone times, EN/中文, motion set, skeletons. Advanced round: awaiting picks. Backend helpers H01–H28 in build order.

Menu · mechanics T-d + T-f Decided

Content is the server's (GET /admin/me/menu, already permission-filtered). Mechanics only: collapsed rail → T-d mega flyout; header → T-f breadcrumb dropdowns; expanded → accordion with level-2 headings; max depth 3, deeper = in-page tabs. Menu regroup is a separate exercise with backend (out of design scope).

Page map · the integration checklist (325/325) Decided

One row per live page → wave → archetype·layout → hero → components → API operations (catalogue operationIds) → needs-backend → permission → phone mode. 325/325 complete (checker phase-3/waves/check_page_map.py OK); 1,077 of 1,083 actions mapped to an operation; 34 flagship rows point at phase-3/flagships/<area>/. Phone: 15 dedicated · 156 read-mostly · 154 desktop-only notice.

Proposals · 82 tagged items Reference

UI-only 0 · needs-a-decision 0 · needs-backend 0. Every item has a recommended default and a source. The needs-backend items are written out as ready-to-file api-request issues for RJmtm/newadmin-api-kit (not filed yet).

Hand-off · status and open decisions Reference