Function / state quick reference
| Function |
User |
Setup |
Locked |
Live |
Settlement |
Archive |
| Submit item (public) |
|
✅ |
❌ |
❌ |
❌ |
❌ |
| Add new item |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Edit item |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Move (within auction) |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Move (to auction) |
A |
🟡 target “setup” or “locked” |
🟡 target “setup” or “locked” |
❌ |
❌ |
❌ |
| Rotate photo |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Crop photo |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Delete item |
A |
✅ |
✅ |
❌ |
❌ |
❌ |
| Record bid |
A |
❌ |
❌ |
✅ |
✅ |
❌ |
| Undo bid |
A |
❌ |
❌ |
✅ |
🟡 If bidder not paid |
❌ |
| View payments |
C |
✅ |
✅ |
✅ |
✅ |
✅ |
| Take payments |
C |
❌ |
❌ |
❌ |
✅ |
❌ |
| Undo payments |
C |
❌ |
❌ |
❌ |
✅ |
❌ |
| Run slideshow |
A |
✅ |
✅ |
✅ |
✅ |
✅ |
| Show live bidding view |
A,C |
✅ |
✅ |
✅ |
✅ |
✅ |
| Add test items |
M |
✅ |
✅ |
❌ |
❌ |
❌ |
| Add test bids |
M |
❌ |
❌ |
✅ |
❌ |
❌ |
| Reset auction |
M |
✅ |
❌ |
❌ |
❌ |
✅ |
| Delete auction |
M |
🟡 When no items |
❌ |
❌ |
❌ |
🟡 When no items |
Admin Panel
Overview
The Admin interface provides tools for managing auction items: submitting, editing, organizing, and exporting data for presentation and reporting.
Functional Areas
Auction Tools
- Auction Selector: Choose which auction you're working in. The state is also shown
- Sorting Options: Sort the item list by item number, description, contributor, creator, bidder, or price, in ascending or descending order.
- Item counts and Value: Shows a live count of bids and the current total.
Item Management
The controls available will depend on the auction state (and for moves, the state of the target auction)
- Create New Item: Opens the item form to enter a new submission with optional photo and notes.
- Edit: Opens the edit form to modify the selected item.
- Photo Tools: Rotate, crop, or replace an image.
- Delete: Remove the item and its photos permanently.
- Move within auction: Move the item within the auction
- Move to auction: Move the item to a different auction. The item will be placed at the end of the target auction
- Finalise: Record the bidder and hammer price for the item. When the bid is recorded, focus will automatically shift to the next un-finalised item in the table/li>
- Undo bid: Undo a recorded bid.
- History: Displays a detailed log of changes for a specific item, including timestamp, user, and action type.
Export Options
- Generate CSV Export: Download all items in spreadsheet format.
- Generate Auction Slides: Create a PowerPoint deck with one slide per item, styled according to the current template configuration.
- Generate Item Cards: Produces A6-sized slides/cards for printing and on-site use.
Navigation
- Public Form: Opens the public-facing item submission page.
- Live Feed: Opens the auction live bid display.
- Maintenance: Opens the maintenance panel (separate login required).
- Cashier: Opens the cashier interface (separate login required).
- Slideshow: Opens the presentation slideshow mode (will end your current admin session).
Session
- Logout: Ends your current admin session and returns you to the login screen.
Cashier Panel
Overview
This interface supports closing out payments after the auction. It shows what each bidder owes and tracks payments
Select an auction from the dropdown and then select to open Live View or Manage Payments
Manage Payments
Bidder List (Left Panel)
- Lists all bidders who have won items.
- Each row shows the paddle number and total amount due.
- Click a row to view details and process payments.
- Green highlight indicates a bidder is fully settled.
- Download CSV: Exports bidder payment status summary.
Bidder Details (Right Panel)
- Lots Won: Displays all winning bids and their prices.
- Payments: Shows recorded payment transactions.
- Totals: Calculates outstanding balance in real time.
Payment Buttons
- Options: Cash, Card (manual), PayPal (manual)
- Clicking a button opens a popup to enter amount and optional note.
- All payments are timestamped and listed immediately.
Live Feed
The Live Feed interface displays a real-time view of auction activity. It shows bidding outcomes as they are finalised
Features
- Lot Data: For each sold item, the paddle number, lot number, item title, and hammer price are shown.
- Connection Status: An indicator displays whether the feed is actively receiving updates (green) or stale (orange).
- Filter by Paddle: Enter a paddle number and press Go to view only that bidder’s wins.
- Show Unsold: Toggle whether items with no recorded bid are shown in the list.
- Live Updates: The page listens for changes without needing manual refreshes.
Slideshow
Overview
This slideshow is designed for unattended display during the live auction. It cycles through item images with optional text overlays and supports remote updates from the admin panel.
Getting Started
- On first load, you'll be prompted to enter the auction short name and admin password.
- Once validated, the system enters full-screen slideshow mode and logs out any existing elevated user sessions for security.
Controls & Shortcuts
- [c] – Toggle configuration panel
- [space] – Pause or resume the slideshow
- [Esc] – Pause slideshow
- Tap-and-hold or click-and-hold – Show configuration panel on touch screens
Configuration Panel
This overlay appears when triggered by keyboard or touch. It auto-hides after 10 seconds of inactivity.
- Transition Time: Duration each slide is shown (in seconds)
- Show Description: Toggle display of item description
- Show Contributor: Toggle display of the item's donor
- Show Creator: Toggle display of the artist/creator
- Refresh Interval: How often to check for new items (in seconds)
- Shuffle Items: Enable randomized item order
- Change Auction / Logout: Reset slideshow and prompt for new auction details
- Pause / Resume / Reload: Playback controls
How It Works
- Items are loaded dynamically from the server, but only if a photo is present for the item.
- Items are shuffled (if enabled) and loop continuously. Once the queue is exhausted, it restarts.
- The slideshow polls the backend regularly to fetch new items and updates in real-time.
Maintenance Panel
Overview
This interface provides access to tools for managing auctions, data management, configuring export templates, and other tasks.
Functional Areas
Auction Management
- Create New Auction: Define a full display name and a short URL tag (e.g.
?auction=fof2026).
- Select Logo: Choose a logo from the uploaded image set for branding & PowerPoint slides.
- Existing Auctions Table: Lists all auctions, showing ID, name, tag, logo, item count, and status.
Actions include: Setting auction status, Delete (if empty), Reset: Remove all items. Deleting the last auction will delete the audit history and reset all counters in the database
Database
- Create Backup on Server: Makes a snapshot of the current database to a folder on the server.
- Restore Database: Upload a previously saved databse file.
Import/Export
- Export CSV: Exports all items in CSV format.
- Import CSV: Bulk import items using a CSV. Required column headers:
description, artist, contributor, notes, and auction_id.
- Download Database and Photos: Exports a zipped copy of the database and all photos.
Diagnostics
- Photo Storage Report: Shows number and total size of stored images.
- Check for Invalid Items: Identifies broken item entries (e.g. missing auctions or photos).
- Delete Invalid Items: Permanently removes broken entries.
- Clean Up Unused Photos: Finds and deletes orphaned photo files.
- Restart Server: Sends a soft restart command to the backend process. Requires that pm2 is used with the process name "auction"
Security
- Change Password: Update password for Admin, Cashier, or Maintenance roles.
Generate Test Data
- Generate Items: Add a number of mock items to a selected auction for testing purposes.
- Generate Test Bids: Simulate activity by generating test bids and bidders.
- Delete Test Bids: Clears all test bidding data.
PowerPoint Template Editor
- Edit Config: Select between
Slide Config or Card Config to modify PowerPoint layout settings in JSON format.
- Reset to Default: Revert selected config to factory settings.
Image Manager
- Upload Images: Upload assets (e.g. logos or backgrounds) for use in PowerPoint and/or auction logos.
- Delete: Remove previously uploaded image resources.
Audit Log Viewer
- Fetch Audit Log: Loads audit history showing time, user, action, item details, and auction.
- Filter by Item ID: Narrow the log view to actions affecting a specific item. Note that this is a unique database internal item ID.
- Download CSV: Export log data for offline review or archiving.
Server Logs
- View Logs: Show recent backend server output.
- Auto-Refresh: Enable live updates every 5 seconds.