Maintenance help

Adding boats

1. Open the Fleet tab from the left sidebar (shortcut 6).
2. Click New Boat (or press N).
3. Fill in the boat details: class, sail number, name (optional), and current status.
4. Upload a photo if you have one. This helps with identification on the water.
5. Click Save to add the boat to your fleet register.

Importing your fleet

1. If you have an existing spreadsheet, open the Fleet tab and press I to open the import panel.
2. Download the CSV template to see the required column format.
3. Populate the template with your fleet data and upload it.
4. Review the preview table and confirm the import. Duplicates are flagged automatically.

Generating QR codes

1. Select a boat from the Fleet list and open its detail page.
2. Click Generate QR Code.
3. Print the QR code and attach it to the boat. A waterproof sticker works best.
4. Anyone who scans the QR code is taken to a mobile-friendly fault reporting form for that specific boat.

QR code settings

QR behaviour, such as whether a login is required to submit a fault report, is configured under the Config tab.

Reporting faults via QR

1. Scan the QR code on the boat using any phone camera or QR reader app.
2. The fault form opens in your browser, pre-filled with the boat's details.
3. Describe the fault, select a category (rigging, hull, foils, and so on), and choose a severity level.
4. Optionally attach a photo. Tap Submit to send the report.
5. No login is required for QR-based reporting, making it easy for all club members to contribute.

Managing pending jobs

1. Open the Pending jobs tab (shortcut 2) to see all open fault reports.
2. Use the filter bar to narrow by boat, category, severity, or date range.
3. Click a job to view full details, add notes, or assign it to a staff member.
4. Change the status to In Progress when work begins.

Completing a job

1. Once the repair is finished, open the job in Pending jobs and click Mark Completed.
2. Add a completion note describing what was done and any parts used.
3. The job moves to Completed jobs (the maintenance log) and the boat's status updates automatically.

The maintenance log

The Completed jobs tab (shortcut 3) is the maintenance log. Every job moved from Pending jobs via Mark Completed appears here as a permanent record.

Logging completed work directly

1. You can add a record directly from the Completed jobs tab by clicking Log Work.
2. Select the boat, describe the work carried out, and record the date.
3. Add any costs (parts, labour) so they appear in your spending reports.
4. Attach receipts or photos as supporting evidence if needed.

Filtering and exporting

1. Use the filters (press F) to narrow records by boat, date range, category, or staff member.
2. Click Export (or press X) to download the filtered records as a CSV file.
3. Exports include all visible columns and are useful for committee reports or insurance documentation.

Analysis

Press A on the Completed jobs tab to open the analysis view. It shows a breakdown of maintenance activity including:

• Total jobs completed this month and year
• Average time to resolve faults
• Most common fault categories
• Cost breakdown by boat class
• Boats with the highest number of completed jobs

Requesting parts

1. Open the Order parts tab (shortcut 4).
2. Click Request Part to flag that a part is needed.
3. Enter the part name, supplier (if known), estimated cost, and quantity.
4. The request appears in the Order parts queue for an admin to review.

Approving orders

1. Admins can view all pending part requests in the Order parts tab.
2. Review the details, adjust the quantity or supplier if needed, and click Approve.
3. Rejected requests can include a note explaining why.

Creating bulk orders

1. Select multiple approved parts from the list using the checkboxes.
2. Click Create Bulk Order to combine them into a single purchase order.
3. The order summary can be exported to send to your supplier.

Inventory management

1. Track parts you already have in stock under the Inventory tab (shortcut 5).
2. Set minimum stock levels to receive alerts when supplies run low.
3. When a part is used during a job, deduct it from inventory to keep counts accurate.

Enabling and disabling boats

1. In Fleet, select a boat and open its detail page.
2. Toggle the Enabled switch to control whether the boat appears in dropdowns, fault forms, and active fleet counts.
3. Disabled boats are not deleted. They remain in your records and can be re-enabled at any time.

Managing staff

1. Open the Config tab (shortcut 8) and select the Staff section.
2. Edit a staff member's role, deactivate their account, or resend their invitation email.
3. Deactivated users cannot sign in but their historical activity is preserved.

Setting up categories

1. Open the Config tab and select the Categories section.
2. Add, rename, or reorder the fault and maintenance categories that appear in forms (for example rigging, hull, foils, sails, trailer).
3. Categories help you filter and analyse data more effectively.

Role permissions

FleetFixer Maintenance uses three roles:

• Admin: full access. Can manage staff, approve orders, configure settings, and view all data.
• Bosun: can report faults, complete jobs, request parts, and view the fleet. Cannot manage staff or approve orders.
• Viewer: read-only access to the Home panel and fleet status. Useful for committee members who need visibility without editing rights.

Press ? at any time inside the app to open the keyboard shortcuts overlay. The main shortcuts are:

Key	Action
?	Open keyboard shortcuts overlay
/	Focus the search bar
1	Go to Home
2	Go to Pending jobs
3	Go to Completed jobs
4	Go to Order parts
5	Go to Inventory
6	Go to Fleet
7	Go to Archive
8	Go to Config
N	New or add (boat, job, or part request, depending on the current tab)
I	Import (Inventory tab)
X	Export current view as CSV
H	Open help or guidelines for the current tab
A	Analyse (Completed jobs tab)
F	Filter (Completed jobs tab)
Escape	Close any open modal, overlay, or panel
Ctrl + Enter	Submit the current form

Shortcuts are disabled when you are typing in an input field or textarea, so they do not interfere with normal text entry.

Do members need an account to report a fault?

No. Anyone can scan a boat's QR code and submit a fault report without signing in. Whether a login is required is a setting you control under Config.

What is the difference between Pending jobs and Completed jobs?

Pending jobs are open fault reports still to be actioned. When you mark one complete it moves to Completed jobs, which is your permanent maintenance log.

Can I get the maintenance history out of FleetFixer?

Yes. From Completed jobs, filter to what you need and click Export (or press X) to download a CSV for committee reports or insurance.

A boat is out of action. How do I hide it?

Open the boat in Fleet and turn off the Enabled switch. It disappears from fault forms and active counts but keeps its history.