System Manual

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

Chapters

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.

2. Logging in and user access

Purpose. To make sure each person sees and changes only what their role allows.

When to use it. At the start of each working session, and whenever a new staff member or client needs access.

Step-by-step.

  • Open the BMS address in your browser. The Sign in screen appears.
  • Enter your email address and password, then choose Sign in. Google sign-in is also available.
  • Forgotten password: choose the reset option, then follow the link emailed to you to set a new one.
  • To see who has access: Settings → People & access and Who may do what.

*Sign-in screen*

*Settings — People & access*

What happens next. Every record you create is stamped with your franchise, so you only ever see your own franchise's clients, staff, cleans and money.

Rules & warnings.

  • Roles are Owner, Manager, Viewer, HCP and Demo.
  • Only the Owner may change the values in Settings (pay rates, shift times, cars, estates, frequencies).
  • A Demo account is read-only: it can look at everything and change nothing.
  • Deleting a job card requires an Owner or Manager password re-entered on the spot.
  • Never share a login. The change history records the email address of whoever acted.

The Client & Cleaner Portal

Purpose. A separate, simple screen for people outside the office.

  • A client signs in and sees their own statement, what has been invoiced, what has been paid, what is outstanding, their upcoming cleans, and can request a quote.
  • A cleaner signs in and sees their own shifts, logged hours, wage totals, the bank details held on file, and their upcoming allocated cleans.

*Portal — client view*

*Portal — cleaner view*

Rules & warnings. A portal account only ever shows the records that match that person's email address. A quote request from a client lands at the top of Enquiries for you to action.


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.


8. Creating a New Home Care Plan

Purpose. The care plan is the engine of the diary. It holds the agreement for one property and generates the recurring cleans.

When to use it. As soon as a quote is accepted and the client confirms a start date.

Step-by-step.

  • Open Care Plans → New care plan (or create it from the accepted quote).
  • Capture client name, phone, email, estate / complex, address, service type and frequency (weekly, fortnightly, monthly, once-off).
  • Set the shift start time. For two cleans per week, set the first day of the week and its shift, and the second day and its shift.
  • Set HCPs required, the shift count, and the team car.
  • Set the effective date — the date the plan starts working from.
  • Set price per clean and, if the first clean is a deep clean, the deep clean price and its shift count.
  • Choose the Agreement state and capture scope / special notes.
  • Save. BMS then generates the cleans forward into the diary.
  • Open Agreement to print or save the client service agreement as a PDF for signature.

*New care plan dialog*

*Care Plans — Active plans table* Example — Client Service Agreement.

*Example Client Service Agreement — first part*

*Example Client Service Agreement — second part*

What happens next. Generated cleans appear on the Weekly Schedule as job cards, each carrying the plan's shift time, shift count, required HCPs and price. The plan is listed with Starts (effective date), Shifts, Next clean and how far it has been generated.

Rules & warnings.

  • Cleans are generated on or after the effective date, on the chosen weekday(s) only, Monday to Friday.
  • Changing the frequency or day mid-plan changes future cleans from the effective date forward — it does not rewrite history.
  • Care plans are listed oldest effective date first.
  • The price per clean on the plan is what gets invoiced. Correct it here, not on the invoice.
  • Changing the type of clean in Edit care plan also changes the name that invoices and job cards show for that plan.

11. Scheduling jobs — putting a client on the calendar

There are three ways a client gets onto the calendar. Use the first that fits the situation.

11.1 By accepting a quote — the normal way for a new client

This is the easiest route, because the day and shift are agreed before the work is booked.

  • Every clean on the quote already carries its offered day and shift (chosen on the quote, where the free/busy calendar shows what fits).
  • When the client accepts, open the quote and press Client accepted. BMS asks you to confirm a day and shift for each clean on the quote — Clean 1, Clean 2, and so on.
  • BMS then creates a care plan per clean and generates the cleans forward into the diary automatically. Nothing further to book.

The team, price, shifts and notes from the quote travel with the work — you never retype them.

11.2 By hand, with **Care Plans → New care plan** (repeating work without a quote)

Purpose. To start a repeating clean directly — for example a referral client who agreed everything over the phone.

Step-by-step. Open Care Plans → + New care plan, capture the client and property, choose the frequency, weekday(s) and shift, the team size, shift count, price and effective date, then save. BMS generates the cleans into the diary from the effective date — see section 8 for the full detail.

11.3 By hand, with **Schedule Job** (a single clean)

Purpose. To book one clean on one day — a spring clean, a deep clean, a favour, a move-out clean.

When to use it. Whenever the work does not repeat and therefore needs no care plan.

Step-by-step.

  • Open the Weekly Schedule and click a cell marked AVAILABLE — the date, shift and property slot (A or B) are filled in for you. (You can also open Dashboard → Schedule Job and choose them yourself.)
  • Job details — choose the client. For an existing client, BMS asks "Which clean?" and lists their cleans as *Clean 1, Clean 2, …*. Pick one and the price, shift count and number of cleaners fill in automatically from that clean. For a brand new client, capture the details and set these yourself.
  • Under Team allocation, allocate the cleaners by name and choose the team leader.
  • Save. One job card is created immediately.

*Schedule Job — job details and team allocation*

What happens next. The clean appears on the Weekly Schedule exactly like a care-plan clean, and follows the same road: complete → sign off → revenue → invoice.

Rules & warnings. One job fills one property slot in one fixed shift. If both slots are taken in that shift, choose another shift or another day. Schedule Job creates one clean — it never repeats. For repeating work, use 11.1 or 11.2 instead.

11.4 To-Do Calendar

Purpose. Your own reminders (call a client, order products, chase a signature) alongside the operational diary.

Step-by-step. Open Dashboard → To-Do Calendar, add the item with its due date and notes, and tick it complete when done.

*To-Do Calendar*


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.

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.