Foundation
Outbox + bridge dispatcher
This manual is a draft and may change.
What it does
Outbox makes sure that when something happens on your site, for example a payment or a message, every part that needs to react does so exactly once, even if the server restarts.
Who uses it
Nobody uses it directly day to day. Your platform team keeps an eye on it, and site admins can open the Events & bridges screen.
Setup
- Ask your platform team to install Outbox + bridge dispatcher. There is no install button in the admin yet.
- Nothing to choose. It starts working in the background once installed and checks for new events every minute.
- Ask your platform team to confirm the health check is ok after installation.
Admin tasks
Events & bridges
- Open Events & bridges (admins only). A green message says All bridges are flowing, or a red one counts failed deliveries waiting for a retry.
- Failed deliveries lists each failure with its bridge, event, attempts and last error. Click Retry to try it again.
- Bridges shows each connection, whether it is active, and the last event it has handled.
- Latest events shows the 30 most recent events and whether each has been forwarded yet.
The rest works behind the scenes.
Keeping it healthy
- Your platform team checks the health report. It is ok when nothing is stuck.
- If a delivery failed repeatedly (after 8 tries, with waits that grow from 30 seconds up to an hour), it waits and later events for that connection pause so order is kept.
- After the cause is fixed, the failed delivery is retried and the rest continue.
Member view
Members do not see this app.
Styling it to your brand
Every app takes its colours, fonts and corners from the brand profile you enter once in the Brand intake on 1vsm.com. It applies to every app automatically, so there is nothing to set up for this one.
Troubleshooting
- A receipt or note is late: deliveries are retried with growing waits; check the health report.
- Nothing arrives after one failure: a repeatedly failing delivery pauses later ones to keep order until retried.
- Something happened twice: deliveries are recorded to avoid repeats; report it to your platform team.
- An event was refused: its type name was not valid.
FAQ
Can an event be lost? No. It is saved with the change that caused it.
Can it be delivered twice? It may be tried more than once, but each connection records completion so the effect happens once.
How often does it run? Every minute.
Is there a screen? Yes. Admins can open Events & bridges to see failures and retry them.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.