Maintenance
Maintenance
This manual is a draft and may change.
What it does
Maintenance keeps a list of your equipment, schedules regular servicing, and tracks every repair from report to done, including parts used and time out of action. A sticker on each machine lets people report a problem without needing a login.
Who uses it
- Maintenance managers (Maintenance manager): register equipment, set up service plans, retire old equipment and keep the scheduler running.
- Technicians (Technician): pick up jobs, record parts used, meter readings and downtime, and mark jobs done.
- Anyone with a sticker code: can report a problem about that item.
Setup
- Ask your 1vsM contact to install Maintenance on your site.
- It installs these first, automatically: Attachments, Sequences, Activity, Outbox + bridge dispatcher, Access.
- Give your lead the Maintenance manager role and your repair staff the Technician role.
- Register each piece of equipment: a name, optionally a category, serial number and warranty end date. It gets an equipment number and a secret code for its sticker.
- For equipment that needs regular servicing, create a plan: every so many days, or every so many hours or kilometres on its meter.
- Ask your 1vsM team to make sure the maintenance check runs; it runs every 15 minutes and creates jobs when plans fall due.
- If you want spare parts deducted from stock, install the Inventory app.
Admin tasks
The admin menu has three pages: Equipment, Preventive plans and Requests. Managers and technicians can open all three, and the buttons depend on the role. These pages are in the latest version of the app and appear once your site has it. Assigning a job, recording parts used, adding notes and photos, and recording downtime have no page yet and are done by other parts of your site or by your 1vsM team.
- Register equipment (manager): on Equipment, under Register equipment, enter a name and optionally a category, serial number and warranty end date, then Register. Purchase date and links to a product, location or bookable resource are not on the form.
- Report-a-problem link: each active item has a link to its public report page, the page its sticker opens. No sticker image is produced for you.
- Meter readings (technician or manager): on each active item, enter the Meter and Reading (total) and choose Save reading. A reading can never be lower than the last.
- Retire equipment (manager): the Retire button appears only when the item has no open jobs. Retiring is final.
- Service plans (manager): on Preventive plans, under New plan, pick the equipment, a name, either Every N days or a meter with Every N meter units, how many days early to open the request, and a priority, then Add plan. Stop plan archives it. Open due requests now runs the check straight away.
- Jobs (technician or manager): on Requests, a board shows New, In progress, Waiting for parts, Done and Cancelled. Under New request, pick the equipment, say What is wrong, add details and a priority, then Open request. Each card has Start, Waiting for parts, Resume, Done and Cancel as the stage allows. Cancel records the reason "cancelled from admin"; you cannot type one.
- Scheduler: creates a job when a plan is due and records due and overdue notices.
Member view
Members do not see this app. A person holding an equipment sticker's code can report a problem about that item on a public page that needs no sign-in; it opens a new job.
Styling it to your brand
The Maintenance pages and the public report page use the shared inventory look. They take their colours, fonts and corners from the brand profile entered once in 1vsm.com's Brand intake, and that profile applies to every app automatically.
Troubleshooting
- "serial ... is already registered". Serial numbers must be unique on your site.
- "a reading never goes backwards". A meter reading must be equal to or higher than the last one.
- "has open maintenance requests - close or cancel them first". Finish or cancel the jobs before retiring the equipment.
- "is retired". Retired equipment accepts no new plans, readings or reports.
- "cannot move to ..." Jobs follow a fixed order: new, in progress, waiting for parts, done or cancelled. Done and cancelled jobs are final.
- "parts are stock moves, but ... is not installed". Install the Inventory app to record parts used.
- "unknown equipment sticker". The sticker code does not belong to this site's equipment.
FAQ
How are regular jobs created? The system checks every 15 minutes and creates one job when a plan falls due, never more than one open job per plan.
Will it email me when a job is due? It records due and overdue notices; delivering them is not built yet.
What happens to a plan when a job is finished? The next due date moves forward from the completion date or from the original schedule, depending on the plan.
Can I see how long something was down? Downtime is recorded per item; summary statistics are not built yet.
Can a job show on our project board? Yes, if the Work app is installed.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.