System Manual

The complete BroomStix Management System user and operations manual — BMS V1.

Chapters

How to read this manual

Every section follows the same five headings:

  • Purpose — what this part of BMS is for.
  • When to use it — the moment in the working week you open it.
  • Step-by-step — exactly what to click and type.
  • What happens next — where the information travels to.
  • Rules & warnings — the business rules BMS enforces, and the traps to avoid.

This edition is illustrated — every screen is shown with a caption like this:

*Weekly Schedule — full week view*.

Words used in this manual

TermMeaning in Broomstix
HCPHome Care Professional — a cleaner on the staff register.
ShiftOne fixed working block (08:00–10:30, 11:00–13:30, 14:00–16:30). Wages are paid per shift, never per hour.
Clean / Visit / JobOne booked cleaning appointment at one property, in one shift.
Job cardThe on-screen record of a single clean: rooms, team, sign-off, history.
Care PlanThe recurring service agreement for a property, from which cleans are generated.
Property A / Property BThe two property slots that can run at the same time in the same shift.
TL/QCTeam Leader / Quality Control — an HCP qualified to sign a job off.

A note on two terms in your brief

  • "Issued" — in BMS V1 an invoice that has been sent to the client carries the status Sent. Read "issued" as Sent throughout.
  • "Completed With Exception" — BMS V1 does not have a separate status by that name. An exception is recorded as sign-off notes on the job card by the team leader (see 12. Quality control and exceptions). The status remains Completed; the note is the exception record.

Nothing in this manual describes a feature that is not in the finished V1 application.


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 → Profit

When 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.

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.


9. HCP Staff management

Purpose. The staff register — the source for availability, team allocation and wages.

When to use it. When a cleaner joins, changes status, is vetted, qualifies as TL/QC, or gives you banking details.

Step-by-step.

  • Open HCP Staff (*HCP Staff Register*).
  • Add a cleaner: code, name, phone, email, ID number, address, prior experience, start date, car, status and status dates.
  • Tick TLQC if they are qualified to sign jobs off, and Vetted once vetting is complete.
  • Capture bank name, account number and branch code, and an individual shift rate if theirs differs from the standard rate.
  • Save.

*HCP Staff Register with counters*

*HCP detail — bank and rate fields*

What happens next. Active cleaners become available for Shift Availability and team allocation; their shifts flow into HCP Wages & Shifts and paid totals appear in Payroll by Month; their bank details print on the wage slip.

Rules & warnings.

  • Only TL/QC cleaners may sign a job off. Every working team needs one.
  • Without an email address you cannot email that cleaner a wage statement — BMS will tell you to add one under HCP Staff → Edit details.
  • Without bank details the wage slip has nowhere to pay.
  • Counters show Total HCPs, Active, TL/QC qualified and Vetted.

12. Weekly Schedule

Purpose. The operational heart of BMS: the whole week, shift by shift, with both property slots and the team on each job.

When to use it. Every day, and thoroughly once a week when you confirm teams for the week ahead.

Step-by-step.

  • Open Dashboard → Weekly Schedule. Monday to Friday runs across the top; the three fixed shifts run down the side.
  • Each cell shows Property A and Property B. A booked slot shows the client, the estate, the HCP count (for example HCP 3/3), the shift count, the allocated names and the agreement marker.
  • Use Review team / Team picker to tick the cleaners for that clean and set the team leader, then save the team.
  • Open Job card → to work on the clean itself.
  • Use the client lookup panel above the schedule to search a client by name, phone or email and see all their bookings, plans, invoices and balance at a glance.
  • Public holidays are badged on the day.

12.1 Using Property B for Broomstix days (vetting, training, in-house work)

A free Property B slot can be used for your own people — vetting, training or a working day at Broomstix (29 Hildebrand Road, Sitari Country Estate, Macassar) — but only when you choose to, one shift at a time. In a normal week Property B simply stays empty.

  • On the Weekly Schedule, click the free Property B slot for the day and shift you want.
  • Press Use for Broomstix, choose the reason (Vetting, Training or Working at Broomstix) and how many people are going.
  • Press Keep this slot, then tick the names of the cleaners who were there, exactly like booking a client clean.
  • The booked slot shows on the planner as Broomstix (in-house), and those shifts appear under HCP Wages & Shifts so the cleaners are paid for the shift.

Rules & warnings. A Broomstix day is never priced and never invoiced — no client is ever charged for it. Past shifts still show the Use for Broomstix button, so you can log the day afterwards.

*Weekly Schedule — full week grid*

*Weekly Schedule — Team picker*

*Client lookup panel*

What happens next. The team you confirm is stored against that visit and becomes the basis of shifts, wages and the payroll feed.

Rules & warnings.

  • A red HCP count means a staffing shortage — the clean is short of cleaners. Fix it before the day.
  • The colour markers distinguish Property A and Property B, and Agreement signed from Agreement outstanding.
  • Nobody on leave, unavailable for the shift, or already working another property in the same shift can be double-booked.
  • AVAILABLE in a cell means that property slot is free for new work.

13. Managing and completing jobs (the Job card)

Purpose. The job card is the operational record of one clean: what was cleaned, by whom, and who signed it off.

When to use it. On the day of the clean, and immediately afterwards to close it.

Step-by-step.

  • Open the clean from the Weekly Schedule, the Dashboard, the client's account, HCP Wages or Closed Jobs.
  • The header shows the weekday, full date and shift time prominently, and the Property A / Property B badge.
  • Check Property & client and Scope notes before the team starts.
  • Confirm the Allocated team and the team leader.
  • If this particular job needs a different team size, an Owner or Manager presses Change cleaners needed, enters the new number and confirms with their own password.
  • Work through the Room checklist, ticking rooms as they are completed. The counters show Rooms completed, Outstanding rooms and Team on site (for example 3/3).
  • When the work is done, the team leader completes Team leader sign-off, adding sign-off notes where anything must be recorded.
  • If the clean must move, use Move this clean and pick the new date; you may also keep, cancel or restore a clean.
  • Change history at the foot of the card shows every team-size change, move, cancellation, restore, keep and deletion — with the action, who did it and the exact date and time.
  • Delete job card removes the clean entirely and requires an Owner or Manager password.

*Job card — header, counters and sign-off*

*Job card — Room checklist*

*Job card — Change history*

What happens next. Sign-off is the switch that turns work into money. The moment the job card is closed:

  • the clean counts as revenue earned under Closed Jobs;
  • it becomes available to invoice under Invoices → Every finished clean, per client;
  • its shifts count towards the cleaners' wages.

Rules & warnings.

  • Only a TL/QC cleaner may sign off. Where a clean has no room list, it counts as complete so sign-off is still possible.
  • A clean that is not signed off earns nothing and can never be invoiced. This is the single most common cause of "missing" revenue.
  • A job card that has already been invoiced cannot be deleted.
  • Never delete a clean to correct it — move it. Deleting loses the record; moving keeps the audit trail.

Job statuses on the job card

StatusMeaning
ScheduledBooked in the diary, not started.
In progressWork under way; some rooms ticked.
Waiting final QCRooms done, team leader has not signed off yet.
CompletedSigned off. Revenue earned; ready to bill.
CancelledCalled off; no revenue, no wages from it.

An exception (something the client should know, damage, access refused, a room skipped) is captured as sign-off notes on a Completed job card — this is BMS V1's "completed with exception".


15. Quality control and exceptions

Purpose. To keep service quality visible and traceable.

When to use it. After every clean, and weekly when you review the week.

Step-by-step.

  • Dashboard → Waiting final QC shows cleans finished but not yet signed off. Clear this daily.
  • On each job card, confirm the room checklist is fully ticked and the team leader sign-off is complete.
  • Record anything unusual in the sign-off notes — this is the permanent exception record.
  • Use Change history on the job card, and Settings → Clean change history, to trace who moved, cancelled or deleted any clean and when.
  • Operations Report → Quality exceptions and Action list give you the weekly view.

*Settings — Clean change history*

Rules & warnings. A clean sitting in Waiting final QC is invisible to revenue and to wages. Sign-off notes are the only place an exception is recorded — write them at the time, not from memory.


17. Issuing invoices and recording payments

Purpose. To get the invoice to the client and to record the money coming back.

When to use it. Immediately after generating invoices, and every time a payment lands in the bank.

Step-by-step — issuing.

  • From the Invoice register on the Invoices page, open the invoice and press Preview & send to email it to the client — or print / save it as a PDF and send it yourself, then press Mark as sent.
  • To send to many clients at once, open Client Email List, choose what to send (latest quote, invoice or statement), tick the clients, send, and read the Send results.

*Client Email List — what to send and client selection*

Step-by-step — recording a payment.

  • Open Payments. A reminder at the top counts the invoices that are overdue.
  • Find the client's invoice under Client invoices and click the invoice reference — the payment box opens with the client's name in bold.
  • Enter the payment date, the amount (the outstanding balance is offered by default), the method, a reference and any notes.
  • Save. Part payments are fully supported — record exactly what came in, as many times as it takes, until the total is reached. Closing the box without saving records nothing.

*Payments — client invoices and payment capture*

What happens next. Balances, invoice status, the client statement, the client portal, Monthly Revenue vs Wages and Finance & Profit per Week all update automatically. Counters show Received, Outstanding, Fully paid invoices and Part paid.

Rules & warnings.

  • Never adjust an invoice total to match a short payment — record the part payment and leave the balance Outstanding.
  • Anyone in your business can record a payment on any invoice — payments are not tied to whoever created the invoice.
  • Client statements net off every recorded payment, so a part payment shows correctly on the statement.
  • If email sending is unavailable (the sending domain must be verified before BMS can email on your behalf), print or save documents as PDFs and send them from your own mailbox.

18. Payroll by Month

Purpose. To total what each cleaner was actually paid in every month and match it against the bank account.

When to use it. During month-end bank reconciliation, after staff payments have been recorded.

Step-by-step.

  • Open Payroll by Month and choose this year or last year.
  • Read Paid in the year, Shifts paid and Cleaners paid.
  • Under Month by month, open a month to see each cleaner's shift total, amount paid and number of payment days.
  • Open a cleaner inside the month to see the client work included on each payment day.

*Payroll by Month — monthly totals and payment days*

What happens next. This page is a reconciliation view. Record and correct the actual staff payments under HCP Wages & Shifts.

Rules & warnings.

  • Wages are per shift, never per hour.
  • A December shift paid in January appears in January, because this page groups by the payment date.
  • Use this page to match monthly totals against the bank; use HCP Wages & Shifts to make or correct payments.

19. HCP Wages & Shifts (paying the cleaners)

Purpose. To see every cleaner's shifts for a period and record what you paid them.

When to use it. Weekly, when you pay staff.

Step-by-step.

  • Open HCP Wages & Shifts and set the Period.
  • Read the counters: HCPs with shifts, Shifts allocated, Wages paid, Still outstanding.
  • Expand a cleaner under Per HCP. The row summary shows Shifts, Worked and Upcoming prominently, with their bank name, account number, branch code and email.
  • Each clean is listed with its weekday and date and client, and is clickable — it opens that job card.
  • Set the Payment day, then use Pay X shifts for the whole cleaner, or Mark paid per line.
  • Open the printable wage slip — cleaner, period, each shift, client, status, paid date, amount, paid and outstanding totals and bank details — to print or save as a PDF.
  • Email the cleaner their paid and outstanding shifts where an email address is on file.
  • Payments made to staff shows what was paid, to whom, on which day, for how many shifts.

*HCP Wages & Shifts — Per HCP expanded*

*Wage slip document*

*Payments made to staff*

What happens next. Paid and outstanding wages feed Monthly Revenue vs Wages; the cleaner sees the same figures in their portal.

Rules & warnings.

  • The wage for a clean uses the rate that applied on that clean's date (Settings → *Rate per shift from a date*), with a cleaner's own rate taking precedence.
  • Changing today's rate does not rewrite past wages — that is deliberate.
  • A cleaner with no email address cannot be emailed a statement; BMS says so instead of failing.

20. Monthly Revenue vs Wages

Purpose. Income earned from completed cleans against the wage bill for the same month.

When to use it. At month end.

Step-by-step. Open Monthly Revenue vs Wages and read Income (completed cleans), Cash received, Wages paid, Wages outstanding, Total wage bill and Profit, then Income by client and Wages by HCP.

*Monthly Revenue vs Wages*

Rules & warnings. *Income* is what you earned (cleans completed); *Cash received* is what actually arrived. They differ by whatever is still outstanding — that gap is your collections job.


21. Finance & Profit per Week

Purpose. True weekly profit: income from finished jobs, less cleaner wages, less running costs.

When to use it. Weekly, and whenever you pay a business expense.

Step-by-step.

  • Open Finance & Profit per Week.
  • Move between weeks with ← Previous week, This week and Next week →.
  • Choose Update figures to pull the latest jobs, shifts, payments, costs and shift prices for the week on screen.
  • Read the cards: Income from clients, Cash received, Cleaner wages, Running costs, Profit.
  • Use Profit week by week to compare recent weeks; click a row to jump to that week.
  • Record a cost under Add a running cost: date, category, what it was for, amount, notes.
  • Review Costs this week (with category totals) and Income this week (every finished clean that earned money).

*Finance & Profit per Week — cards and weekly table*

*Add a running cost*

Rules & warnings.

  • Income counts finished cleans, not money received.
  • Wages are shifts worked × the price per shift that applied on that date, whether or not the wages have been paid.
  • Capture running costs as they happen or your profit will look better than it is.

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

FigureCounted whenWhere to see it
Revenue earnedJob card signed offClosed Jobs, Monthly Revenue vs Wages, Finance
InvoicedInvoice createdInvoices, Operations Report
Cash receivedPayment recordedPayments, Monthly Revenue vs Wages, Finance
Wage billShift allocated to a signed-off cleanHCP Wages, Finance
Wages paidMarked paid with a payment dayHCP Wages, Monthly Revenue vs Wages
Running costsCost captured on FinanceFinance & Profit per Week

24.3 Status dictionary

StatusApplies toMeaning
DraftQuote, InvoicePrepared in BMS, not yet sent. Reversible.
Sent (issued)Quote, InvoiceSent to the client; a reply or payment is expected.
OutstandingInvoiceMoney still owing, including part-paid invoices.
OverdueInvoiceOutstanding past the due date.
PaidInvoicePayments equal the total; nothing owing.
CompletedClean / job cardSigned off by the team leader. Revenue earned; billable.
Completed with an exceptionClean / job cardCompleted, with the issue written into the team leader's sign-off notes. There is no separate status in BMS V1.
CancelledClean / job cardCalled off. No revenue, no wages.

25. The Broomstix operating rhythm

Every day

  • Dashboard — clear Waiting final QC and Understaffed.
  • Action new Enquiries and portal quote requests.
  • Sign off yesterday's job cards.

Every week

  • Capture Shift Availability for the coming week.
  • Confirm teams and team leaders on the Weekly Schedule.
  • Empty Jobs still to close.
  • Pay staff on HCP Wages, send wage slips, and use Payroll by Month for bank reconciliation.
  • Capture running costs and review Finance & Profit per Week.
  • Work the Operations Report action list.

Every month

  • Generate invoices, issue them, and send statements from the Client Email List.
  • Chase Overdue invoices.
  • Review Monthly Revenue vs Wages.

Every year

  • Load next year's public holidays in Settings and decide on the affected cleans.
  • Review the rate per shift with a new effective date.

26. Golden rules

  • Work runs Monday to Friday, in three fixed shifts, with at most two properties at a time.
  • No sign-off, no money. An unsigned clean earns nothing and cannot be invoiced.
  • Never delete a clean to correct it — move it. Deleting destroys the record; moving keeps the audit trail.
  • Every team needs a TL/QC cleaner.
  • Fix a price on the care plan, not on the invoice.
  • Record part payments exactly as received; never edit the invoice total.
  • Accept BMS's duplicate client warning — one client, one record.
  • Wages are per shift, at the rate effective on the clean's date, with the weekly minimum applied.
  • Capture running costs as they happen.
  • Only the Owner changes Settings; changing a job's required cleaners or deleting its job card needs an Owner or Manager password.
  • A Broomstix (in-house) day booked on Property B is paid to the cleaner as a shift, but is never priced and never invoiced to any client.

*Broomstix Management System (BMS) — User & Operations Manual · Version BMS V1.1 — 29 September 2026*