Skip to main content

Scanner Assignments

Quick Links

Interface Preview · Quick Start · Who this is for · Prerequisites · Workflow · Assignments Table · Create Form · Edit Form · Unassigning · Permissions · Best Practices · Troubleshooting · Replace Placeholders · Summary

Screenshots & Videos

Place real assets under /images and /videos using root paths.

📌 Why Scanner Assignments?

Right people, right gate, right time. Avoid overlaps, ensure coverage, and coordinate shift changes with clear start/end windows.

Manage which scanners (users) are scheduled to operate gates or workshops and when. This page covers listing, filtering, creating, editing, and unassigning assignments, plus validation and permissions.

Interface Preview​

Assignments List Create Assignment

Quick Start​

  1. Go to Event > Scanner Assignments
  2. Create an assignment and select scanner, gate/workshop, and time
  3. Save and review the list

Who this is for​

  • Event Admins / Managers: schedule scanners
  • Scanners: view their own upcoming assignments (My Scanner Assignments page)

Prerequisites​

  • User must have gate.assign to create/edit assignments and gate.unassign to remove them
  • Scanners must have scanner.scan permission to perform actual scans
  • Gates and Workshops must already exist for the event

Workflow at a Glance (Admin)​

  1. Open Event > Scanners > Assignments
  2. Filter existing assignments (scanner, gate)
  3. Click Assign Scanner
  4. Choose assignment type (Gate or Workshop)
  5. Select one or more scanners
  6. Provide Gate + Start/End Time OR Workshop (workshop times auto-derived)
  7. Submit and review the row in the table
  8. Use Edit / Unassign actions as needed

Assignments Table​

Columns:

  • Assignment: Gate name or Workshop title
  • Scanner: User name(s) assigned
  • Start Time / End Time: Scheduled window (workshop rows may show derived times)
  • Actions: Edit (pencil), Unassign (trash) if you have permissions

Filtering:

  • By Scanner (dropdown)
  • By Gate (dropdown – shows only gate assignments)

Assignments List

Create Assignment Form (Modal)​

Fields:

  • Assignment Type: required, options: gate | workshop
  • Scanners: required, multi-select, one or more user IDs
  • Gate: required if type = gate
  • Workshop: required if type = workshop
  • Start Time: required if gate; hidden for workshop
  • End Time: required if gate; hidden for workshop

Workshop Behavior:

  • Selecting a workshop auto-captures its start/end times
  • Manual time fields remain hidden to avoid overriding

Validation Rules:

  • assignment_type: required; must be gate or workshop
  • scanner_ids: required; array; min length 1
  • gate_id: required if type = gate; must exist for event
  • workshop_id: required if type = workshop; must exist for event
  • start_time: required if gate; valid datetime (Y-m-d H:i)
  • end_time: required if gate; must be >= start_time

Error Handling:

  • Modal reopens with inline field error messages

Create Assignment Form

Edit Assignment Form​

  • Similar layout to creation
  • Allowed changes: scanners, gate/workshop reference, times (for gate only)
  • Workshop assignments: time fields hidden; workshop selection available
  • Submission updates the underlying schedule row

Unassigning​

  • Clicking trash opens a confirmation dialog
  • Gate: "Unassign from Gate"; Workshop: "Unassign from Workshop"
  • After confirmation, the row is removed from the table

Permissions Summary​

  • gate.assign: create/edit both gate and workshop assignments
  • gate.unassign: remove existing assignments
  • scanner.scan: needed by scanner users to perform scans

Best Practices​

  • Keep assignment windows tight for accurate active status tracking
  • Assign multiple scanners only when necessary for high throughput
  • Avoid overlapping assignments for the same scanner unless intentional (backup coverage)

Troubleshooting​

IssueCauseAction
Missing Assign Scanner buttonNo gate.assign permissionAdjust role / permissions
Workshop not appearingNot linked to this event or missing venueVerify workshop setup
Times rejectedIncorrect format or end before startUse provided picker and ensure order
Scanners list emptyNo users with scanning role/permissionGrant scanner.scan or add scanners
Modal closes after errorAuto-reopen logic failedReopen manually; re-enter data

Replace Placeholders​

  • Add real screenshots (assignments-list, create-assignment, edit-assignment) to images folder and update links
  • Add a video (e.g., scanner-assignments-user-story.mp4) to videos folder and adjust reference

Summary​

Scanner Assignments orchestrate who scans where and when. Correct assignment setup ensures only authorized scanners operate gates or workshops with consistent scheduling.