1. Introduction to the Broomstix Management System
Purpose. BMS is the single operating system for a Broomstix cleaning franchise. It carries a client from the first phone call all the way to money in the bank and cleaners paid:
Enquiry → Quote (Home Assessment optional) → Care Plan → Cleans in the diary
→ Job card completed & signed off → Revenue earned
→ Invoice → Payment received
→ Shifts → Wages paid → ProfitWhen to use it. Every working day. It is not a filing system you update afterwards — the diary, the wages and the invoices are all built from what you capture as it happens.
Step-by-step (the shape of the system). The left-hand menu follows the business, top to bottom:
- Dashboard — Weekly Schedule, Schedule Job, Shift Availability, Month Calendar, To-Do Calendar
- Enquiries, Quotes, Clients & Properties, Care Plans, Assessments (optional)
- HCP Staff
- HCP Wages & Shifts, Payroll by Month, Closed Jobs
- Invoices, Payments, Client Accounts & Balances, Client Email List
- Monthly Revenue vs Wages, Finance & Profit per Week
- Operations Report
- Settings
*BMS main menu, full sidebar*
What happens next. Each screen feeds the next one automatically. You never retype a client name, a price or a shift count from one screen into another.
Rules & warnings.
- Broomstix works Monday to Friday only. BMS will not place a clean on a Saturday or Sunday.
- Two properties can run at once in one shift — Property A and Property B — no more.
- All money is in South African Rand.
3. Dashboard (Operations dashboard)
Purpose. Your morning picture: what is happening today, and what is stuck.
When to use it. First thing every morning, and again before you leave.
Step-by-step.
- Open Dashboard.
- Use the arrows beside the date to step backwards or forwards a day.
- Read the counters: Scheduled, In progress, Waiting final QC, Understaffed, Completed.
- Read the enquiry counters: New enquiries, Appointment booked, Assessed, Lost.
- Under Today's operations, search or scroll the day's visits and open any job card.
- Check the standing counters: Active clients, Active care plans, HCPs available, Assessments to do.
- Open Month Calendar for the whole month at a glance — each day lists its cleans, and a red flag marks a client whose payment is late.
*Operations dashboard — top counters and Today's operations*
What happens next. The dashboard is a window, not a form — you act from it by opening the job card, the schedule or the enquiry it points you to.
Rules & warnings. Understaffed means fewer cleaners are allocated than the clean requires. Fix it the same day on the Weekly Schedule; an understaffed clean will run short or fail.
4. Enquiries
Purpose. The first step of the funnel: every phone call, email, WhatsApp or portal quote request is logged here so nothing is lost.
When to use it. The moment somebody makes contact.
Step-by-step.
- Open Enquiries → Enter a new enquiry.
- Capture the client's name, phone number, email, address, Estate / complex (choose from the list, or *None*), property type and the source of the enquiry.
- Add notes about what the client asked for. Save.
- Move the enquiry along as it progresses: New → Appointment booked → Assessed, or mark it Lost with a reason.
- Quote requests from the client portal appear in their own panel at the top — action these first.
*Enquiries — register and Enter a new enquiry*
What happens next. Booking the assessment carries the client's details into the Home Assessment, so you don't retype them.
Rules & warnings. Always record a lost reason — the *Why enquiries were lost* panel is your marketing feedback. An enquiry on its own creates no client, no price and no clean.
5. Clients & Properties
Purpose. The property register: every client and every property Broomstix knows.
5.1 Adding a new client — one way
There is now one way to add a new client: the + New client button on Clients & Properties. It opens the same form as + New quote on the Quotes page, because a new client and their first price are captured together.
Step-by-step.
- Open Clients & Properties and press + New client.
- Fill in name, phone, email and address.
- Choose the kind and size of the property.
- Add the clean(s): type of clean, cleaners, shifts, price per clean, and a note such as *cleaning windows*. Use + Add a clean for a deep clean plus a regular clean.
- Save, then send the quote. The client is on the books immediately, and accepting the quote books the cleans into the diary.
Optional extras (not separate roads).
- Book a home visit (Assessments, section 6) when you want to measure the work before pricing. Saving it carries the details into the same quote form.
- Log an enquiry (Enquiries, section 4) when the client is still shopping around and you only want a record of the call. From the enquiry you send the quote with the same form.
- For an existing client, open their account (click the blue name) and press + New quote — details pre-filled.
Rules & warnings. Every route ends in one client record. If the name, phone or email matches an existing client, BMS warns you and offers *Use this existing client* — always accept it, so the history, invoices and statement stay together.
When to use it. To look someone up, check their history, or see who is still only a prospect.
Step-by-step.
- Open Clients & Properties.
- Click the counters at the top to filter: Active clients, Quoted, Prospects.
- Search the Property register and click the client's blue name to open their account. You can also find all balances under Client Accounts & Balances.
- On the client's account, use the Visits block to open every clean for this client — date, shift, type, address, amount, status and whether it is invoiced. Click any line to open its job card.
- Use Edit contact / address to change the client's name and surname, phone, email or property address. A name change follows through to their quotes, cleans and invoices.
- Scroll to the account statement to see total invoiced, paid, outstanding and overdue, with invoice and payment history. Use Email quote, Email invoice or Email statement at the top when needed.
*Clients & Properties — counters and property register*
*Client account — Visits expanded*
What happens next. A client appears after an assessment or direct quote, becomes Quoted when a quote exists and Active once a care plan is running. Contact and address corrections made here update the linked records.
Rules & warnings. BMS warns you when a new assessment looks like an existing client (matching name, phone digits or email) and offers *Use this existing client*. Always accept it — duplicate clients split the history, the invoices and the statement.
6. Home Assessment
Purpose. An optional aid for pricing the work and deciding the team when a home visit would be useful.
When to use it. After a site visit when you need room-by-room detail before quoting. For a straightforward enquiry, quote directly without an assessment.
Step-by-step.
- Open Assessments → new assessment (*Home Assessment & Workload*).
- Who owns this property? — choose the existing client, or capture a new owner.
- Property & visit — assessment date and time, property type, Estate / complex (dropdown, with *Other* for free text), address, client name, phone, email.
- Capture the preferred start date, cleaning frequency, whether the first clean is a deep clean, and whether Broomstix brings the cleaning products.
- Note pets, children, product notes and general notes.
- Work through the Room & task workload list. This is reference information only — it helps you judge the size of the job.
- In Team & shifts, set HCPs required and Shifts required yourself.
- Save the assessment.
*Home Assessment — Property & visit*
*Home Assessment — Team & shifts*
What happens next. The assessment appears in the Assessment Register (*Awaiting approval → Approved*), the client appears under Clients & Properties, and you can raise a Quote from it. The shift count you set here carries through to the care plan and to every clean generated from it.
Rules & warnings.
- The room list does not decide the team size — you do.
- Get Shifts required right. If a clean later shows fewer shifts than the assessment, BMS asks *"Is this a new, separate job?"* — answer No to restore the assessed shift count unless it genuinely is a different job.
- Sample assessments marked *demo only* are illustrations; they never reach the schedule.
7. Quotes
Purpose. The written price offered to the client. One quote can contain several different cleans.
When to use it. As soon as you know the kind and size of the property. A home assessment is optional.
Step-by-step.
- Open Quotes → + New quote. You can quote a new client directly, open it pre-filled from a client account, or raise it from an assessment.
- Confirm the client's name, email, phone, estate and address, then capture the property kind and size.
- In Cleaning requirements, write what the client needs — for example pets, children, bathrooms, allergies, busy rooms and how quickly dirt returns. Press Recommend frequency with AI.
- Read the suggested frequency and its plain-language reason. Press Use this frequency to apply it, or keep your own choice. This is advice only; franchise staff make the final decision.
- Add every clean included in the offer. Each clean has its own frequency, HCPs required, shifts, price and optional note (for example, *cleaning windows*).
- The register and quotation show a simple clean label — Once, Weekly, Twice weekly, Fortnightly or Monthly — so the type of clean is always clear.
- Set the preferred start date, valid until date and notes for the client, then save the draft.
- Before acceptance, use Edit details to correct the client's name, email, phone or address and to change the cleans on the quote.
- Use Review to check the quote, Quotation to print or save one quote, or Export PDF beside the client to print all their grouped quotes together. You can also email the quote.
- Use the status legend: Draft means not sent, Sent means awaiting an answer, Accepted means agreed and booked, and Declined means lost work. Hover over a status for the same explanation.
- When the client accepts, BMS asks you to choose a day and shift for each clean on the quote, then creates the care plans and diary visits.
7.1 A deep clean first, then a regular clean (different team sizes)
A very common agreement: the first visit is a once-off deep clean, and after that the client continues with a weekly, fortnightly or monthly clean. This is one quote with two cleans — do not create two quotes.
- Open Quotes → + New quote and capture the client as usual.
- Clean 1 is the deep clean: choose Once, set its own cleaners, shifts and price — for example 3 HCPs, 2 shifts, R1 100 — and add a note like *first deep clean*.
- Press + Add a clean for Clean 2: choose the regular frequency (Weekly, Fortnightly or Monthly) with its own team — for example 2 HCPs, 1 shift, R425.
- Choose the offered day and shift for each clean (the calendar shows what is free), then save, review and send.
What happens on acceptance. When the client accepts, BMS asks for a day and shift for each clean separately and creates two care plans: a once-off plan for the deep clean (3 cleaners) and a repeating plan for the regular clean (2 cleaners). Each clean keeps its own team size, shifts and price all the way to the invoice — the deep clean is billed once, the regular clean every month. For a clean that runs two shifts, you pick the day and the starting shift once — the next shift of that same day is booked with it, and the picker only offers days where both shifts have enough cleaners free.
Rules & warnings. Every clean on a quote has its own cleaners, shifts and price — never average them into one line, or the diary and wages will be wrong. Changing a clean's price in the quote editor updates the quote's own price, its totals and everything already booked from it, so they always stay in step. A single clean quoted on its own is labelled Once-off clean.
*Quotes — register and counters*
*Printable quotation document*
What happens next. Each clean on an Accepted quote becomes its own booked plan. Its agreed frequency, team size, shifts, price and notes carry into the work that follows.
Rules & warnings. Set Valid until — an expired price should be re-quoted, not honoured. Once a quote is accepted, this date is no longer relevant and is hidden in the register; the accepted price is locked in.
23. Settings
Purpose. The values the whole system works with. Only the Owner may change them.
When to use it. At setup, and whenever a rate, shift time, car, estate, frequency, holiday or user access changes.
Step-by-step.
- Pay — the standard rate per shift, the minimum paid shifts and HCPs per car, used by the payroll feed, reports and every HCP profile.
- Rate per shift from a date — add a new rate with the date it takes effect. Wages for each clean use the newest rate on or before that clean's date.
- Shift times — the three fixed shifts.
- Cars & teams — the vehicles and their capacity.
- Estates & parks — the estate list used by the assessment, quote and care-plan dropdowns.
- Cleaning frequencies — weekly, fortnightly, monthly, once-off and their repeat rules.
- People & access and Who may do what — user accounts and roles.
- Public holidays — choose the public holidays for this year and next, either manually or from the South African suggestions (including the Monday observed after a Sunday holiday). BMS then lists the affected cleans, and for each one you decide manually: move it to another date, keep it, cancel it, or restore it.
- Clean change history — the full audit trail of every clean that was moved, cancelled, kept, restored or deleted, with the actor and the time.
*Settings — Pay and Rate per shift from a date*
*Settings — Public holidays and affected cleans*
Rules & warnings.
- BMS never moves or cancels a clean on a public holiday by itself — you decide, clean by clean.
- Changing a rate from a date affects future cleans only; past wages stay as they were paid.
- Removing an estate or frequency does not change plans already using it.
24. How information flows through BMS
24.1 The full life of one clean
- Enquiry logged — a name and a need. No money, no diary entry.
- Quote raised — directly from the enquiry, or after an optional Home Assessment; every quoted clean has its own frequency, HCPs, shifts, price and notes.
- Quote accepted — a day and shift is chosen for every clean on the quote.
- Care Plan created with an effective date, weekday(s), shift time, shift count and price. BMS generates the cleans into the diary.
- Weekly Schedule — the clean occupies Property A or B in a fixed shift; you confirm the team and the team leader.
- Job card worked — rooms ticked and the team leader signs the work off.
- Team leader signs off → status Completed. This is the switch. At that moment:
- Closed Jobs counts the amount as revenue earned;
- the clean appears in Invoices → Every finished clean, per client as ready to bill;
- its shifts count towards HCP Wages & Shifts.
- Wages paid — recorded on HCP Wages with the payment day; the cleaner's wage slip, portal and Payroll by Month reflect it.
- Invoice generated — status Draft. Still reversible with Undo invoicing.
- Invoice issued — status Sent. The amount is now Outstanding, and Overdue if it passes the due date.
- Payment recorded — part payments reduce the balance; when payments equal the total the invoice becomes Paid. Statement, portal, Payments, Monthly Revenue vs Wages and Finance all update.
- Profit — Finance & Profit per Week shows income less wages less running costs for that week.
24.2 What each figure really counts
| Figure | Counted when | Where to see it |
|---|---|---|
| Revenue earned | Job card signed off | Closed Jobs, Monthly Revenue vs Wages, Finance |
| Invoiced | Invoice created | Invoices, Operations Report |
| Cash received | Payment recorded | Payments, Monthly Revenue vs Wages, Finance |
| Wage bill | Shift allocated to a signed-off clean | HCP Wages, Finance |
| Wages paid | Marked paid with a payment day | HCP Wages, Monthly Revenue vs Wages |
| Running costs | Cost captured on Finance | Finance & Profit per Week |
24.3 Status dictionary
| Status | Applies to | Meaning |
|---|---|---|
| Draft | Quote, Invoice | Prepared in BMS, not yet sent. Reversible. |
| Sent (issued) | Quote, Invoice | Sent to the client; a reply or payment is expected. |
| Outstanding | Invoice | Money still owing, including part-paid invoices. |
| Overdue | Invoice | Outstanding past the due date. |
| Paid | Invoice | Payments equal the total; nothing owing. |
| Completed | Clean / job card | Signed off by the team leader. Revenue earned; billable. |
| Completed with an exception | Clean / job card | Completed, with the issue written into the team leader's sign-off notes. There is no separate status in BMS V1. |
| Cancelled | Clean / job card | Called off. No revenue, no wages. |
