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.

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.


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.

10. HCP availability (Shift Availability)

Purpose. To know who can work which fixed shift, before you allocate teams.

When to use it. Weekly, before you confirm the coming week's teams — and again whenever someone reports leave or illness.

Step-by-step.

  • Open Shift Availability.
  • Step through the weeks with the arrows, or the days with the day arrows.
  • Capture availability for each fixed shift separately — availability is not "all day".
  • Read Available today to see your working strength.

*Shift Availability — week view*

What happens next. The Weekly Schedule and Schedule Job use this when offering cleaners, so you do not book someone who is unavailable.

Rules & warnings. Availability is per shift, not per day. Somebody unavailable for the shift, on leave, or already working another property in that same shift cannot be double-booked.


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*


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


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.