Lesson: a full maintenance cycle, from order to closure

1. Review the maintenance-type catalog

Open Maintenance Types from the sidebar. On first visit the catalog seeds itself with 12 types in two groups: preventive (periodic service 1/2/3 and full periodic service) and corrective (mechanical, electrical, accident repair, brake system, chassis, welding, tire repair, other).

Admin/CEO can add tenant-specific types via «+ إضافة نوع» — remember the code is immutable after creation, and a type referenced by records is deactivated on delete, never hard-deleted.

2. Create the work order for the external shop

If «ورشة النخبة» isn't registered yet, open الورش والموردون (Vendors) from the sidebar and press «+ إضافة جهة»: Arabic name «ورشة النخبة», kind: "external shop", then save. (Your own in-house workshop registers the same way with kind "in-house".)

From the Maintenance page press «+ أمر عمل» and fill in:

1. Toggle to 🛻 trailer (we'll service a reefer trailer in this example) and pick the asset.
2. Category: repair.
3. Class: corrective; type: «صيانة ميكانيكية» (mechanical).
4. Description: «استبدال وحدة تبريد المقطورة — ورشة النخبة» (required).
5. Cost (SAR): 1850.
6. Service odometer (km): 412300 — the reading from the shop's job card.
7. Interval (km): 20000; leave next due (km) empty so the system computes it (432300).
8. Vendor (الجهة المنفذة): «ورشة النخبة — خارجية».
9. Assigned technician: «ورشة النخبة» (the shop's name).

Save — the server issues the record number automatically (say MNT014) and the next-due value is written onto the trailer itself.

3. Start and close it from Work Orders

Open Work Orders — your record sits in the "open" tile at the top. Press «بدء» (start) to move it to "in progress", and when the shop returns with the invoice press «إكمال» (complete) — the completion date is stamped automatically if empty and the record turns "completed". Adjust the final cost from the edit dialog if the invoice differs from the estimate.

If the work was called off: «إلغاء» (cancel) removes it from the due bands, and «إعادة فتح» (reopen) returns any finished record to "open".

4. Read the due bands

Back on the Maintenance page:

• In the asset-level due band, the trailer appears once it is within 5,000 km of the 432300 threshold — with its «كم للصيانة» (km to service) column and a "soon" status, then "overdue" at the threshold.
• A completed record carries the next service (its future due), so it stays visible in the upcoming band — the next cycle can't slip past you.
• The per-vendor spend band has now appeared at the top: an "in-house" tile vs "external shops" tile and a per-vendor table — the 1850-SAR order sits under "external shops" against «ورشة النخبة».
• The distance-due band lists parts nearing end-of-life from the next step.

Once you bind an Afaqy device later, the km-to-service column feeds itself from the live odometer — nothing changes about how you read it.

5. Register the trailer's tires

Open the trailer page → the «الإطارات والبطاريات» (tires & batteries) card → «+ إضافة قطعة»:

1. Type: tire; name: «ميشلان 295/80» (required); position: «أمامي يمين» (front right).
2. Odometer at install: 412300.
3. Expected life (km): 100000 — for a battery use the months field instead.
4. In the financials section: purchase date, price, and salvage value — these feed the book value.

It appears as "good" with a progress bar; at ≤ 5,000 km or ≤ 1 month left it turns "due soon" (yellow), then "overdue" (red), and shows up in the maintenance page's distance-due band. On replacement, mark it «مُستبعَدة» (retired) and register the new part.

6. Resolve a driver's fault report

Open Fault Reports — a driver reported «حرارة المقطورة مرتفعة» (trailer temperature high) with a photo. Review the description and photo, then press «تحديد كمحلول» (mark resolved) once the fault is fixed — the report moves to the resolved tile and notifications go out.

7. Add the fixed costs

On the trailer page → the «التكاليف الثابتة والتكلفة التشغيلية» card → «+ إضافة تكلفة»: type "periodic inspection", amount 1500, period "annual". Watch the tiles: annual fixed costs + annual depreciation = annual running cost, with its monthly equivalent. Repeat for insurance, registration, and the operation card to complete the cost-of-ownership picture.

8. Export the register

From the Maintenance page press the Excel button — whatever the filters match exports with the same Arabic columns (record number, asset, category, status, cost, next due…). Use it for the monthly review meeting or to share a shop-spend sheet with management.