DocumentationChapter 01 of 14
01Introduction
MaintDock is a web app for maintenance management. This kind of software is often called a CMMS (computerized maintenance management system). You install it on your own server, and your team opens it in a web browser.
MaintDock keeps a list of your machines and equipment, plans preventive maintenance, and runs work orders. Managers work on the desktop screens. Technicians can also use a phone view that works like an app.
What MaintDock does
- It keeps an asset register: your sites, the areas in each site, the machines, and the parts of each machine. Each asset can have a QR code label.
- It turns problem reports from staff into work orders, and it tracks each work order from open to closed.
- It creates preventive work orders by itself, by date (for example every month) or by meter reading (for example every 250 run hours).
- It logs downtime and calculates MTBF, MTTR, and availability.
- It tracks the stock of spare parts in each store, and it warns you when stock is low.
- It handles purchasing: purchase requests, approval, purchase orders, and receiving.
- It records every change in an audit trail.
Main features
Checklists, parts, labor, a job timer, attachments, and a history timeline. Print a work order as a PDF.
Staff report a problem. A manager approves it into a work order, or rejects it.
Schedules by date or by meter reading, a calendar of the next 2 weeks, and work orders that the system creates.
A hierarchy of site, area, machine, and part. Meters, spare parts lists, files, and QR code and barcode labels.
Planned and unplanned stops, causes, a weekly timeline, and availability.
Stock per store, minimum stock, low-stock alerts, issue, return, receive, adjust, and average cost.
Purchase requests with approval, purchase orders, receiving, and a vendor list.
A dashboard and 11 reports, including MTBF and MTTR. Export to Excel and print as PDF.
An installable web app for technicians: my jobs, job timer, checklist, parts, photos, QR scan, and problem reports. It needs a connection.
One company with many sites. Each user sees only the data of the sites they are given.
4 built-in roles, and custom roles with a permission matrix.
Who changed what and when. Notifications in the app and by email.
MaintDock also has light and dark mode, and every text on the screen can be translated.
Who MaintDock is for
MaintDock is for companies that maintain machines, buildings, vehicles, or other equipment. For example: factories, packaging and food plants, workshops, warehouses, and facility teams. One install serves one company and all of its sites.
The people who use it are maintenance managers and planners, technicians, storekeepers, and operators or other staff who report problems.
Technology
| Part | Technology |
|---|---|
| Framework | .NET 10 (long-term support release) and ASP.NET Core |
| User interface | Blazor with the Interactive Server render mode. MudBlazor for dialogs, pickers, and snackbars, on top of the MaintDock design (the "Control Room" look). |
| Database | Entity Framework Core 10 with SQL Server, PostgreSQL, or SQLite |
| Sign-in | ASP.NET Core Identity with local accounts (email and password) |
| Documents | PDFsharp and MigraDoc (PDF), ClosedXML (Excel), MailKit (email), ZXing.Net (QR codes and barcodes) |
Sample data and demo users
The setup wizard can add sample data, so you can try MaintDock before you enter your own data. The sample data is a made-up company, Riverbend Packaging Co., with 3 sites, machines, work orders, preventive schedules, spare parts, vendors, purchase orders, and people.
You sign in with the admin account that you create in the wizard. The sample users all have the password Demo@12345. For example:
| Name | Role | Sites | |
|---|---|---|---|
| Priya Nair | [email protected] | Manager | Riverbend Plant, Eastfield Plant |
| Luis Ortega | [email protected] | Technician | Riverbend Plant |
| Tom Walsh | [email protected] | Storekeeper (a custom role) | Riverbend Plant, Central Warehouse |
| Maria Lopez | [email protected] | Requester | Riverbend Plant |
Sign in on a phone as Luis Ortega to see the phone view of a technician. Sign in as Maria Lopez to see what an operator sees when they report a problem.
Sample data can only go into an empty database. Use it for a trial, not for your real data. If you put a demo on a public web address, remember that everyone who reads this guide knows the demo password.