Docs › qa-pipeline
Q&A pipeline overview
How questions flow from the audience to the screen — the full picture in one place.
Q&A pipeline overview
The Q&A system moves a question from a phone in the audience to an approved, on-screen moment — with a moderator in control at every step. No questions appear anywhere without being reviewed first.
Here's the full flow:
Audience member
│
│ scans QR code → opens /q/{token}
│ types question → hits Submit
▼
Incoming queue (moderator panel)
│
├─ Approve → Approved queue
│ │
│ ├─ Set Now → "Now" slot (visible on presentor screen Q&A section)
│ ├─ Set Next → "Next" slot
│ └─ Next question button → auto-advances the queue
│
└─ Reject → Rejected section (not shown anywhere)
The Q&A public output (the projected screen the audience sees) shows a QR code or a branded placeholder — not the live questions. Questions are displayed on the presentor screen (the speaker's confidence monitor), which has a Q&A section the director can toggle on.
The key surfaces
/q/{token} — audience submit form
The page audience members land on when they scan the QR code. They type their question, optionally add their name, and submit. The form is only active when Q&A is open.
Moderator panel — inside director view The Q&A tab in the left sidebar of director view. Moderators review incoming questions, approve or reject them, reorder the approved queue, and push questions to the Now and Next slots.
Presentor output — Q&A section The speaker's confidence monitor can show a Now/Next question display when the Q&A section toggle is on. This is how the speaker knows which question is coming up.
Q&A public output — qa-public
Projected to the audience. Shows a QR code (when the "Show QR" toggle is on) or a branded placeholder. It does not automatically display the text of approved or live questions — that display is handled by the presentor screen on the speaker's side.
Who does what
| Role | Can submit questions | Can moderate (approve/reject) | Can configure (override, QR toggle) |
|---|---|---|---|
| Audience (no account) | Yes, via /q/{token} | No | No |
| Q&A Moderator | — | Yes | No |
| Associate Director | — | Yes | Yes |
| Director | — | Yes | Yes |
| Owner | — | Yes | Yes |
What controls whether Q&A is open
Q&A open/closed status follows a precedence chain — override beats automatic, automatic follows cue and show flags. The full logic is in Open and closed status.
Note
The next pages walk through each surface in detail.