Crefair Master BRD
Last updated 6 May 2026
Business Requirements Document

Crefair — Master BRD

Crefair is the unified platform for CRAWA — AI, deterministic workflows, user interfaces, client portal, operations dashboard, and everything else the business needs to run. This is the single source of truth for what we're building. It grows as new requirements surface and is updated as features ship. Nothing gets lost.

§ 1 Workstreams

Seven delivery streams. Each feature below maps to one.

Processes

AroFlo process optimisation

Stage 1 (map current state) → Stage 2 (design Crefair-optimised version) for every core business process that runs through AroFlo. The foundation all other workstreams build on.

Quoting

Quoting & estimation

Optimised quoting flow — structured field capture → agent assembly → expert approval. Eliminates VA bottleneck.

Field

Field technician UI

PWA replacing AroFlo's mobile portal for on-site data capture — structured notes, checklists, photos, readings, asset custom fields.

Client

Client-facing portal

Crefair's client-facing surface — visibility (job status, assets, reports), service requests (callouts, quotes), job interaction (notes, POs, signoff), account & site management, document exchange.

PDF

Branded document generation

Professional PDF output — service reports, quotes, invoices, asset reports — matching/exceeding competitor standard (Fridgair, Westcool).

Dashboard

Operations dashboard

Central command — senior-management KPIs fused with agent observability and operational metrics. Role-based default views.

Infra

Platform & infrastructure

The foundations Crefair runs on — AroFlo connector, Cloudflare hosting, PDF engine, supplier data pipelines, authentication, API permissions.

§ 2 Feature register

Every deliverable we've identified, ordered by workstream. IDs are stable — use them in conversation and commits.

ID Feature Description Source Priority Status Depends on
AroFlo Process Optimisation
PRC-01 Quoting process Stage 1: current-state mapped (5 actors, 11 steps, 4 rework loops — validated). Stage 2: initial optimised design proposed (3 actors, 6 steps). Needs further validation and refinement. Richard P1 Active
PRC-02 Task / job lifecycle End-to-end job flow: creation → assignment → dispatch → execution → completion → close-out. Includes reactive callouts and scheduled maintenance paths. Richard P1 Planned
PRC-03 Invoicing & payments Job completion → invoice generation → client delivery → payment collection → reconciliation. Identify where manual steps can be automated or eliminated. Richard P1 Planned PRC-02
PRC-04 Purchasing & procurement PO creation → approval → supplier dispatch → goods receipt → bill matching. Covers both field-raised POs and office-raised POs. Richard P2 Planned
PRC-05 Scheduling & dispatch Recurring maintenance scheduling, reactive dispatch, tech assignment and route logic. How work gets to the right tech at the right time. Richard P1 Planned
PRC-06 Asset management Asset register maintenance, inspection workflows, maintenance history tracking, lifecycle management. How assets are created, updated, and tracked across service visits. Richard P1 Planned
PRC-07 Inventory & stock Workshop stock levels, van stock, replenishment triggers, stocktake process. Covers both warehouse inventory and field consumables. Richard P2 Planned
PRC-08 Client management Client onboarding, site setup, contact maintenance, contract management. How new clients and sites get into the system and stay current. Richard P2 Planned
PRC-09 Work orders & projects Multi-task groupings, project-level tracking, stage gates. How larger scopes of work are managed across multiple tasks and visits. Richard P2 Planned
PRC-10 Timesheets & labour Labour capture, timesheet approval, payroll feed. How tech time on jobs gets recorded, verified, and pushed to payroll. Richard P2 Planned
Infrastructure
INF-01 AroFlo API connector HMAC-SHA512 signed connector for tasks, clients, locations, assets, inventory. Postman collection saved. Richard P1 Active
INF-02 AroFlo API user permissions Fix restricted permissions — assets, locations, inventory endpoints currently blocked for the API user. Ops P1 Blocked INF-01
INF-03 Cloudflare zone & DNS crefair.com.au zone on Cloudflare. GoDaddy nameservers pointed. Hosting base for all web UIs. Richard P1 Propagating
INF-04 Cloudflare Pages deployment Crefair hosting — Pages project for PWA, client portal and dashboard on crefair.com.au subdomains. Richard P1 Planned INF-03
INF-05 PDF rendering engine HTML→PDF pipeline (Puppeteer on Cloudflare Workers or equivalent). Template-driven, CRAWA-branded output. Joel P2 Planned INF-04
INF-06 Supplier price index Structured price data from key suppliers — enables agent to pull current part costs during quote assembly. Process P2 Planned
INF-07 Authentication & role system Crefair-wide auth — field PWA, client portal and dashboard. Role-based access: tech, office expert, manager, client. Ops P2 Planned INF-04
Quoting & Estimation
QTE-03 Agent: quote assembly Agent takes structured field notes + asset history + supplier pricing → assembles draft quote (parts, labour, narrative). Process P1 Planned PRC-01 INF-01 INF-06 FLD-01
QTE-04 Expert review & approval UI Single approval gate — office expert reviews agent-assembled quote, edits if needed, approves to send. Process P1 Planned QTE-03 INF-04
QTE-05 Asset history service Structured query against AroFlo — prior tasks, parts used, notes on a given asset. Feeds quote context. Not RAG. Process P2 Planned INF-01 INF-02
QTE-06 Auto-schedule follow-up On quote approval, agent auto-creates follow-up task in AroFlo with correct scheduling and assignment. Process P3 Planned QTE-04 INF-01
Field Technician UI
FLD-01 Structured field capture PWA Mobile-first PWA for techs on site. Replaces AroFlo mobile portal's clunky multi-step entry. Structured notes, not free text. Richard Joel P1 Planned INF-04 INF-07
FLD-02 Per-asset checklist engine Configurable checklist per asset type (cold room, split system, evap cooler, etc.). Pass/fail, readings, notes per item. Mirrors Fridgair/Westcool standard. Joel P1 Planned FLD-01
FLD-03 Photo capture & annotation In-app camera → photo attached to specific asset + checklist item. Inline in reports (Westcool pattern). Joel P1 Planned FLD-01
FLD-04 Labour time capture Start/stop timer or manual entry for labour hours per task. Feeds quote and invoice generation. Joel P2 Planned FLD-01
FLD-05 Purchase order creation Tech raises PO from field — parts selected from supplier index, approval routed to office. Joel P2 Planned FLD-01 INF-06
FLD-06 Client card access Tech views client details, site contacts, access instructions and special requirements from field. Joel P2 Planned FLD-01 INF-01
FLD-07 Asset custom fields display Tech sees all AroFlo custom fields for the asset on-site — make, model, serial, refrigerant type, location, history. Joel P1 Planned FLD-01 INF-02
FLD-08 Offline / low-signal support PWA works offline — caches task data, queues submissions, syncs when connectivity returns. Critical for roof/plant room access. Ops P2 Planned FLD-01
FLD-09 Digital forms & compliance SWMS, JSAs, site inductions, signoff forms — digital capture replacing paper. Attached to task record. Joel P3 Planned FLD-01
Branded Document Generation
PDF-01 Service report template Maintenance/service report — cover page summary, one-page-per-asset detail, checklist results, photos, defect cards, technician signoff. Exceeds Fridgair/Westcool standard. Joel P1 Planned INF-05 FLD-02
PDF-02 Quote PDF template Professional branded quote — scope, line-item pricing, terms, validity. Generated from agent-assembled data. Joel P1 Planned INF-05 QTE-03
PDF-03 Invoice PDF template Branded invoice matching quote format — consistent visual identity across all client-facing documents. Joel P2 Planned INF-05
PDF-04 Asset report template Per-asset report pulling custom fields — type, make, model, serial, location, maintenance history, readings trend, photos. Client-facing. Joel P2 Planned INF-05 QTE-05
PDF-05 Defect severity system Colour-coded defect scale (critical → recommendation → informational) with badges. Matches Westcool's visual hierarchy — clients scan for red. Joel P2 Planned FLD-02
Client Portal — Visibility
CLI-01 Job status & sub-status view Client sees live status of their jobs — scheduled, in progress, awaiting parts, complete, invoiced. Real-time push from AroFlo task status. Joel P1 Planned INF-04 INF-07 INF-01
CLI-02 Asset register view Client sees their full asset register — pass/fail status per asset, last service date, next scheduled. The live version of Fridgair's page-1 summary table. Joel P1 Planned CLI-01 INF-02
CLI-03 Report download & history Client downloads branded PDF reports for any past job. Full history of service reports, quotes, invoices. Joel P2 Planned CLI-01 PDF-01
CLI-04 Defect & recommendation tracker Client sees open defects/recommendations across their sites — severity, status, linked quotes. Drives proactive maintenance conversations. Joel P2 Planned CLI-02 PDF-05
CLI-05 Maintenance schedule view Client sees upcoming scheduled maintenance across all their sites — next visit dates, scope, assigned tech. Reduces inbound "when are you coming?" calls. Richard P2 Planned CLI-01 INF-01
Client Portal — Service Requests
CLI-10 Reactive callout request Client submits a callout — selects site, asset (if known), describes fault/symptoms, indicates urgency. Creates task in AroFlo, triggers CRAWA dispatch. Richard P1 Planned CLI-01 INF-01
CLI-11 Quote request Client requests a new quote — describes scope of work, selects site/assets, attaches reference documents. Feeds into quoting workflow. Richard P1 Planned CLI-01 QTE-03
CLI-12 Warranty claim submission Client lodges a warranty claim against a prior job — selects original task, describes issue, attaches photos. Routed to office for review. Richard P3 Planned CLI-01 CLI-03
Client Portal — Job Interaction
CLI-20 Job notes & messaging Client adds comments or questions to an active job — threaded conversation visible to CRAWA office. Replaces email/phone tag. Richard P1 Planned CLI-01
CLI-21 Purchase order entry Client provides their PO number against a job or approved quote. Stored against the AroFlo task, appears on invoice. Richard P1 Planned CLI-01
CLI-22 Job completion signoff Client reviews completed work and signs off — confirms satisfaction or flags issues. Digital signature capture. Triggers invoicing workflow. Richard P2 Planned CLI-01 PDF-01
CLI-23 Job feedback & rating Client rates completed jobs (quality, timeliness, communication). Feeds internal quality metrics on dashboard. Richard P3 Planned CLI-22
Client Portal — Quotes & Invoices
CLI-30 Quote review & approval Client reviews quote PDF inline, approves/rejects/requests revision with comments. Provides PO number on approval. Status syncs to AroFlo. Joel Process P1 Planned CLI-01 QTE-04 PDF-02
CLI-31 Quote revision request Client requests changes to a quote — line-item queries, scope changes, alternative options. Threaded against original quote. Routes back to office expert. Richard P2 Planned CLI-30
CLI-32 Invoice view & history Client views all invoices — outstanding, paid, overdue. Download as PDF. Links back to original job and quote. Richard P2 Planned CLI-01 PDF-03
Client Portal — Account & Site Management
CLI-40 Site access details Client maintains site access info — key/code locations, security contacts, parking, restricted hours, safety requirements. Visible to techs via field PWA. Richard P1 Planned CLI-01
CLI-41 Site contact management Client adds/edits contacts per site — who to call on arrival, after-hours contact, facilities manager, accounts payable. Syncs to AroFlo. Richard P1 Planned CLI-01 INF-01
CLI-42 Billing details management Client updates billing address, ABN, payment terms, accounts payable contacts. Changes sync to AroFlo client record. Richard P2 Planned CLI-01 INF-01
CLI-43 Portal user management Client admin invites/removes users from their own organisation's portal access. Sets roles (viewer, approver, admin). Richard P2 Planned CLI-01 INF-07
CLI-44 Site add/remove requests Client requests to add a new site or decommission an existing one. Triggers CRAWA setup process (asset register, schedule, access details). Richard P3 Planned CLI-41
Client Portal — Documents
CLI-50 Document upload Client uploads specs, floor plans, compliance certificates, previous reports. Attached to site or asset record. Available to techs in field. Richard P2 Planned CLI-01
CLI-51 Compliance document countersign Client reviews and countersigns SWMS, induction forms, or other compliance documents digitally. Stored against task record. Richard P3 Planned CLI-50 FLD-09
Operations Dashboard
DSH-01 Senior management KPIs Revenue, job volume, quote conversion, margin, WIP ageing — the numbers Joel and Richard need at a glance. Richard P1 Planned INF-01 INF-04
DSH-02 Agent observability What the agent did, what it's working on, success/fail rates, queue depth, items awaiting human review. Richard P1 Planned DSH-01 QTE-03
DSH-03 Operational dispatch view Today's jobs, tech locations, unassigned work, overdue tasks. The office coordinator's working screen. Ops P2 Planned DSH-01
DSH-04 Role-based default views Each role (MD, COO, coordinator, tech lead) lands on their view by default. Configurable. Richard P2 Planned DSH-01 INF-07
DSH-05 VA redeployment tracking Track hours freed by automation — VA's time shifted from quote assembly to higher-value work. Proves ROI. Process P3 Planned DSH-02

§ 3 Conventions

How to read this register.

Source tags

  • Richard — Richard identified or requested this directly
  • Joel — Joel Baldini (COO) identified or requested this
  • Process — emerged from process mapping (quoting Stage 1/2)
  • Ops — operational necessity identified during build

Status values

  • Done / Live — built, tested, in use
  • Active — currently being worked on
  • Planned — scoped, not started
  • Blocked — waiting on a dependency or external action

Priority

  • P1 — must have for first usable release
  • P2 — high value, second wave
  • P3 — desirable, sequence later

ID format

  • PRC-## — Process optimisation
  • INF-## — Infrastructure
  • QTE-## — Quoting
  • FLD-## — Field UI
  • PDF-## — Document gen
  • CLI-## — Client portal
  • DSH-## — Dashboard

§ 4 Dependency map

Critical path — what unblocks what. Read left to right.

Layer 0 — No dependencies (start here)
  PRC-01 Quoting process   🔵 active
  PRC-02 Job lifecycle
  PRC-04 Purchasing
  PRC-05 Scheduling
  PRC-06 Asset management
  PRC-07 Inventory
  PRC-08 Client management
  PRC-09 Work orders
  PRC-10 Timesheets
  INF-01 AroFlo connector  🔵 active
  INF-03 Cloudflare zone   ⏳ propagating
  INF-06 Supplier price index

Layer 1 — Depends on Layer 0
  PRC-03 Invoicing         → PRC-02
  INF-02 API permissions   → INF-01  ⛔ BLOCKED
  INF-04 Pages deployment  → INF-03

Layer 2 — Depends on Layer 1
  INF-05 PDF engine        → INF-04
  INF-07 Auth system       → INF-04
  FLD-01 Field PWA         → INF-04, INF-07
  DSH-01 Mgmt KPIs         → INF-01, INF-04
  QTE-05 Asset history     → INF-01, INF-02

Layer 3 — Depends on Layer 2
  FLD-02 Checklist engine  → FLD-01
  FLD-03 Photo capture     → FLD-01
  FLD-04 Labour capture    → FLD-01
  FLD-05 PO creation       → FLD-01, INF-06
  FLD-06 Client card       → FLD-01, INF-01
  FLD-07 Asset fields      → FLD-01, INF-02
  FLD-08 Offline support   → FLD-01
  FLD-09 Digital forms     → FLD-01
  QTE-03 Agent assembly    → PRC-01, INF-01, INF-06, FLD-01
  CLI-01 Job status view   → INF-04, INF-07, INF-01
  DSH-02 Agent observ.     → DSH-01, QTE-03
  DSH-03 Dispatch view     → DSH-01
  DSH-04 Role views        → DSH-01, INF-07

Layer 4 — Depends on Layer 3
  QTE-04 Expert review UI  → QTE-03, INF-04
  PDF-01 Service report    → INF-05, FLD-02
  PDF-02 Quote PDF         → INF-05, QTE-03
  PDF-03 Invoice PDF       → INF-05
  PDF-04 Asset report      → INF-05, QTE-05
  PDF-05 Defect system     → FLD-02
  CLI-02 Asset register    → CLI-01, INF-02
  CLI-05 Schedule view     → CLI-01, INF-01
  CLI-10 Callout request   → CLI-01, INF-01
  CLI-11 Quote request     → CLI-01, QTE-03
  CLI-20 Job notes         → CLI-01
  CLI-21 PO entry          → CLI-01
  CLI-40 Site access       → CLI-01
  CLI-41 Site contacts     → CLI-01, INF-01
  CLI-50 Doc upload        → CLI-01
  DSH-05 VA tracking       → DSH-02

Layer 5 — Depends on Layer 4
  QTE-06 Auto-schedule     → QTE-04, INF-01
  CLI-03 Report download   → CLI-01, PDF-01
  CLI-04 Defect tracker    → CLI-02, PDF-05
  CLI-22 Job signoff       → CLI-01, PDF-01
  CLI-30 Quote approval    → CLI-01, QTE-04, PDF-02
  CLI-32 Invoice history   → CLI-01, PDF-03
  CLI-42 Billing mgmt      → CLI-01, INF-01
  CLI-43 Portal users      → CLI-01, INF-07
  CLI-44 Site add/remove   → CLI-41
  CLI-12 Warranty claim    → CLI-01, CLI-03
  CLI-51 Compliance sign   → CLI-50, FLD-09

Layer 6 — Depends on Layer 5
  CLI-23 Job feedback      → CLI-22
  CLI-31 Quote revision    → CLI-30
    

§ 5 Open questions

Things we know we don't know yet. Add here as they surface.

# Area Question Affects Status
Q-01 AroFlo What permissions does CRAWA's AroFlo admin need to grant the API user for asset/location/inventory access? INF-02 Open
Q-02 Field UX What is the exact sequence techs currently go through in the AroFlo portal to capture on-site data? (Need to map before we can replace.) FLD-01 Parked
Q-03 Checklists How many distinct asset types does CRAWA service, and what checklist items apply to each? Need AroFlo asset type taxonomy. FLD-02 Open
Q-04 Supplier data Which suppliers provide structured price lists (CSV, API, portal scrape)? What's the update frequency? INF-06 Open
Q-05 Branding Does CRAWA have a brand style guide, logo files (SVG/PNG), and colour palette for client-facing documents? PDF-01 PDF-02 Open
Q-06 Client access How will clients authenticate to the portal? Email magic link, SSO, password? What client data lives in AroFlo vs elsewhere? CLI-01 INF-07 Open
Q-07 Compliance Which compliance forms (SWMS, JSA, induction) does CRAWA use today, and are they standardised or client-specific? FLD-09 Open