TOTLCOM On-Call Scheduler¶
Welcome. This site explains how to use the On-Call Scheduler and how to deploy and run it from scratch. It is written for people who have never used Cloudflare, GitHub, or a command line before — every step is spelled out.
The app builds and maintains TOTLCOM's yearly on-call schedule for the Voice team, the Data team, and the Manager who covers both. It creates a fair weekly rotation (no one is on call two weeks in a row), works around vacations and company holidays, lets you make mid-year changes, and exports an Excel file.
The live app is at oncall.totlcom.com. This documentation lives at docs.oncall.totlcom.com. Both sit behind Microsoft 365 sign-in, so only TOTLCOM staff can open them.
Pick your path¶
-
I just need to use the app
Start with the User Guide. It covers signing in, reading the schedule, generating and fixing it, and managing people, time off, and holidays.
-
I need to set it up or run it
The Deployment Guide walks you through Cloudflare, the database, GitHub, environment settings, the custom domain, and Microsoft 365 sign-in — in order, from nothing.
How to read this site¶
Throughout these pages you will see boxes like the ones below. They mean:
Note
Extra context that's helpful but not required.
Tip
A shortcut or a recommended way to do something.
Warning
Something that can cause problems if you skip or get it wrong.
Danger
Something that can break the app or expose data. Read carefully.
Code you are meant to type looks like this — hover over it and a copy button appears in the top-right corner so you don't have to retype it:
When a step says "in a terminal," that means the black command-line window (Command Prompt or PowerShell on Windows). The Deployment Guide shows you how to open one.