27Workflow primitives

Inspect, recover, continue.

Reusable patterns for operational product states: inspection sheets, compact progress histories, visible action menus, and source-backed evidence blocks. These are deliberately quiet; their job is to preserve context and make the next action unambiguous.

Flow rail mini

numbered setup lifecycle; compact phone summary; routing stays with the app

Step 1 of 5

Vacancy

Step 3 of 5

Resumes

Before creation the rail is static: nothing exists to link to yet. Inside an existing shortlist or assessment, earlier and completed steps link back through the app's LinkComponent; later steps stay plain.

numberedactiveKeycompletedKeyssteps[].keysteps[].labellinkForLinkComponent

Band badge

canonical match-band labels
Suggested matchPossible matchWeak match
band=strongband=reviewband=low

Analysis progress panel

one batch surface for Grade and Shortlist: state stated once, rows below

Analyzing 4 resumes

Results are saved as each finishes. Keep this tab open to complete the run.

1 / 4
  • cv-anna-strong.pdf

    Native PDF text

    Parsed
  • cv-bram-moderate.pdf

    Native PDF text

    Parsing

1 resume could not be analyzed

1 resume could not be analyzed. The credit for that file was refunded. The other 3 candidates are ready to review. Retry the failed file from the list, or continue without it.

3 of 4 ready for review
  • cv-anna-strong.pdf

    Native PDF text

    Ready
  • cv-david-industry.pdf

    AI OCR

    Analysis failed. The AI model could not process this document.

    Failed

Preparing

2 reading file · You can leave this page; preparation continues.

0 / 6
  • ANS-08b8780a

    De Block Veerle

    Parsed
  • ANS-21c47b5d

    Bekkens Xander

    Parsed
  • ANS-49b2235a

    Axelle Verhoest

    Parsed
  • ANS-67352e6e

    Estée Vesschemoet

    Parsed
  • ANS-e1d542c7

    Fien Smet · Reading file

    Parsing
  • ANS-f57bccb0

    Emma Van Gavere · Reading file

    Parsing

stickyHeader pins the header while the rows scroll. Rows state their stage only where it differs from the batch’s, so the header is the referent for every quiet row — a long list must not be able to scroll it out of view. Scroll the dashed box above. Ready rows keep a muted text mark; Failed stays the only loud badge.

tone=workingtone=donetone=attentionreadoutactionstickyHeader

File row

retry, skip, and remove keep a 44px mobile target
  • mira-janssens.pdf

    184 KB · 4 pages

    Parsed
  • thomas-declercq.pdf

    226 KB · scanned PDF

    OCR fallback used. Review evidence quotes before deciding.

    Warning
    Full-width row details hold source review context and actions.
  • sophie-maes.pdf

    198 KB · uploading

    Uploading
  • jonas-mercier.pdf

    143 KB

    Failed
  • lien-claes.pdf

    102 KB

    Queued
  • answer-anna-strong.docx

    Private reference ANS-e3f761a4

    Parsed
  • anna-de-smet.pdf

    Private reference ANS-a1b2c3d4

    Preparing
detailsactionfieldstatus=readystatus=warningstatus=uploadingstatus=errorstatus=queuedstatusLabelremoveAction

Retry, skip, and remove keep a 44px mobile target and compact desktop height. Custom removeAction controls must keep the same accessible name and target.

Note panel

standing fact the user can find but need not act on

Data handling

Extracted resume text is deleted after analysis. Original files stay available for recovery for 14 days, unless you delete them sooner.

Scoring cost

Up to 12 credits. No credits are used before scoring. Analysis shows the exact cost before you confirm.
titleclassName

Selected file panel

one file awaiting a primary intake action

assessment.pdf

184 KB

Primary actions keep a 44px mobile target and return to compact button height on desktop.

namemetaremoveLabelonRemoveprimaryAction={<SelectedFilePanelAction />}

Decision group

three outcomes; keyboard listener belongs upstream

Buttons share the available width and keep a 44px mobile target. Narrow groups use shorter labels; keyboard shortcuts appear only when there is room.

valueonChangedisabledshowShortcuts

Criteria breakdown bar

counts, not false-precision scores
metpartialnotMetunknown?

Suggestions block

mobile-safe amber review surface for generated criteria

Suggested additions

Generated from the role context. Add only the criteria you want to screen against.

  • Doctoral supervision experience

  • Programme-board governance

defaultAction=optionaldefaultAction=requiredonAction

Detail sheet

right-side inspection, not a decision dialog
openonOpenChangefinalFocusRefwidth=widemodal=false

Status timeline

one state column, one action column
  1. Vacancy uploaded

    associate-professor-learning-sciences.pdf

  2. OCR fallback used

    One scanned resume was parsed with lower confidence.

  3. Analysis running

    4 of 6 resumes complete.

  4. Export pending

    Available when analysis completes.

  5. Resume parse failed

    jonas-mercier.pdf

    Parser timed out at 60s. 1 credit refunded.

Weight chip

required, nice to have, excluded
RequiredNice to haveExcluded·editable — click to change

Review status chip

met, partial, not met, unresolved
MetPartialNot metChoose statusNot judgedunknownLabel — for unknowns the reviewer cannot resolve·editable — click to change

Cost breakdown

empty helper, covered remaining, shortfall, and line-item basis. The compact shortfall omits the repeated balance detail.

Add resumes to calculate the credit cost.

Credits required

7 credits

Covered by balance

Remaining
43 credits

Cost basis

6 standard resumes6 x 1 credit
6 credits
1 scanned (OCR)1 x 1 credit
1 credit

Refunded if a file fails to parse.

Credits required

20 credits

Need 12 more credits

Cost basis

18 standard resumes18 x 1 credit
18 credits
2 scanned (OCR)2 x 1 credit
2 credits

Top up before continuing.

Evidence card

verdict + criterion + quoted source
Evidence found

Evidence of curriculum governance

Led the annual programme-board review for 12 course units.
Source:Resume, page 2
Partial evidence

Experience with academic quality assurance

Prepared accreditation files and student-outcome summaries.
Source:Resume, page 2 (OCR)

Action menu button

visible at rest; destructive separated

Evidence of curriculum governance

Section 2.1, role description

Evidence quote

Shortlist evidence figure card; left rule on the blockquote only
Led the annual programme-board review for 12 course units.
Resume, page 2

Source excerpt

verbatim passage; optional evidence highlighting; source opens when available
Led the annual programme-board review for 12 course units.
Source:From resume
Operations director at Northgate Foundation since 2014 — 11 years leading the operating team across finance, HR, IT, and facilities.
Downloads the original file as read from the upload.
Liaison for Dutch-speaking student-affairs office. OCR confidence is lower on this page.
Source:Resume, page 2 (OCR)
29Workflow patterns

Bounded work surfaces for document flows.

Shared compositions for document flows: a muted application canvas, white work surfaces, thin borders, restrained shadows, and operational states that preserve the user's work.

Setup frame

numbered FlowRailMini across the shell; work in the reading column

Step 3 of 5

Resumes

Upload resumes

Shortlist and Grade frame every setup stage this way. The rail measures the whole flow, so it spans the shell while the stage content stays in the reading column. Earlier and completed stages link back; later stages stay plain until they have data.

Upload queue

dropzone and file-row actions keep a 44px mobile target

Drop PDFs or DOCX files

Parsing starts when files are added. Analysis starts only after review.

Up to 100 files. 10 MB per file.

Choose files is a labelled control for the hidden file input. It keeps a 44px mobile target and compact desktop height. Keyboard users reach the same picker through the input.

5 files, 3 ready, 1 parsing
Original files are kept for 14 days, then deleted.
  • mira-janssens.pdf

    184 KB, 4 pages

    Parsed
  • thomas-declercq.pdf

    226 KB, scanned PDF

    OCR fallback used. Evidence quotes should be checked.

    Warning
  • sophie-maes.pdf

    198 KB, uploading

    Uploading
  • lara-verheyden.docx

    94 KB

    Queued
  • encrypted.pdf

    rejected

    Failed

Blocked and failed states

work is preserved; next action is explicit

Analysis is blocked

The files are parsed and remain queued. Add credits or remove files before starting analysis.

Files removed

Original files were deleted. Evidence, notes, and summaries remain on the record.

Cost preview

compact side panel for usage and balance
30Evidence review layouts

Keep criteria, evidence, and the human decision together.

These patterns come from the Shortlist sample, but the contracts are product-neutral: a queue of items, a dossier, source-backed criteria, and side-by-side evidence when comparison matters.

Split review workspace

overview, toolbar, queue, dossier — queue fills the column height
Criteria overview

Evidence of curriculum governance(required)

Evidence found
2
Partial
3
Not met
0

Academic quality assurance(required)

Evidence found
2
Partial
2
Not met
1

Stakeholder work(nice to have)

Evidence found
1
Partial
2
Not met
2
Suggested match1 / 5

Mira Janssens

Decision: Shortlisted

Gist

Programme director with evidence of curriculum governance and committee leadership. Stakeholder-language evidence needs human confirmation.

Evidence

MetEvidence of curriculum governance
Led the annual programme-board review for 12 course units.
Source:Resume, page 2

Evidence comparison table

desktop table, mobile accordions

Required

Mira JanssensSuggested match
Met. Led the annual programme-board review for 12 course units.
Lara VerheydenSuggested match
Met. Owned the faculty curriculum committee for three academic years.

Nice to have

Object header before review controls

identity stays visible

Associate professor, learning sciences

5 of 5 analyzed

Faculty of Psychology and Educational Sciences

37Transcription review

Keep the source beside the correction.

Compare the text with the source and save any correction. If it already matches, leave it as it is.

Synthetic example via @evalgist/document-processing. Changes stay in this tab and reset on reload. Not listed in PATTERNS.md.

Numeric transcription example

Page 1 of 3 · Selected region

Original source
Selected source region showing 0.05.

Region transcription

No changes

Machine text · preserved

0.5

Enter the text as it appears in the source, or leave it empty if no text is visible.

Document review

0 of 3 pages confirmed. Saving a correction does not mark any text as reviewed.

Page 2 has an unresolved flag. Saving this correction does not clear it.