Dependents + assets — family + firm property
Two more sub-tabs on the employee detail page. Dependents tracks sponsored family members with their own civil ID / passport / visa expiries. Assets tracks firm-issued laptops, phones, access cards, vehicles — issue date, condition, return-on-leave.
Dependents
9 relationship types
Spouse · Son · Daughter · Father · Mother · Brother · Sister · Guardian · Other. Each tracked with own identity docs because their renewals are the firm's responsibility (sponsorship implication).
Family member legal name as on their docs.
Determines reporting + medical-insurance enrolment rules.
Drives child-vs-adult logic in some authority forms.
Tracked separately; expires before the employee's = renewal blocker.
Critical for travel + visa renewal.
Visa is sponsored by the employee. Expiry = renewal trigger.
True for spouse + minor children typically. Drives MOLP visa-quota count.
Surfaced on the Overview tab as the emergency-contact card.
Validation enforces phone presence when emergency_contact=1.
Assets
12 asset types
Laptop · Desktop · Monitor · Mobile · SIM card · Access card · Office key · Vehicle · Tablet · Headset · Printer · Other.
Drives icon, default condition options.
Firm internal tag (sticker / label). Searchable across employees.
Spec for inventory + warranty tracking.
For warranty + insurance + theft reporting.
When the asset was handed over.
Baseline for return condition comparison.
NULL = still issued. Stamped on offboarding clearance tick.
Captured on return. Drives any deduction for damage.
"Charger missing — OMR 25 deducted from FS".
The "outstanding asset" badge
The employee Overview tab shows a header badge: "3 assets outstanding" when SELECT COUNT(*) FROM employee_assets WHERE employee_id = ? AND returned_date IS NULL AND deleted_at IS NULL > 0. Surfaces during offboarding as a clearance gate (one of the 6 flags — see Wave 2f).
Step-by-step — issue an asset
Open employee → Assets tab
Inline add-form at the bottom of the existing list.
Pick type, enter spec
Asset_type from dropdown · asset_tag · make/model · serial_no · issued_date · condition.
Save
Insert + audit log. Outstanding-count on header increments.
Mark returned (later)
Click the row's "Return" button. Inline form: returned_date, condition_at_return, return_notes. Save → row marked returned · outstanding-count decrements.
Issue 3 assets to a test employee. Check the Overview header — "3 assets outstanding" badge. Mark one returned. Badge updates to "2 assets outstanding". Now initiate offboarding from Lifecycle tab — the Assets clearance flag stays unticked until all 2 are returned.
Don't soft-delete an issued asset row instead of marking it returned. The audit trail captures both events differently — return = legitimate handover, delete = "row created in error". Soft-deleting a real asset issuance hides the firm's exposure.
Asset issuance/return is usually IT's responsibility, not HR's. Give IT staff the m13.manage_assets permission with department=IT scope. They can record issuances + returns without touching the rest of HR data. Cleaner separation of duties.
The 9 dependent relationship types
| Relationship | Common scenario in Oman | Visa-sponsored? |
|---|---|---|
| spouse | Husband / wife | Yes (residence visa) |
| son | Sons under 21 (or under 24 if studying) | Yes |
| daughter | Unmarried daughters (any age) | Yes |
| father | Aged dependent parent | Yes (visit / residence) |
| mother | Aged dependent parent | Yes |
| brother | Adult sibling — special-needs | Special permission |
| sister | Adult sibling — unmarried / widowed | Special permission |
| guardian | Legal guardian relationship | Case-by-case |
| other | Domestic worker · custom | Different visa class |
The 12 asset categories
Tag · serial · spec · purchase value (for asset register cross-link).
Less often returned — usually decommissioned in place.
Track separately from desktop for stock control.
IMEI as serial. Lock policy via MDM.
SIM number · operator · monthly cap · billed-to.
Card number · zones · revoke on offboarding day 1.
Key tag · floor · cabinet locks.
Plate · model · ownership doc · insurance.
For workpaper signing in field.
Often not returned — track for asset register only.
Rare — usually shared.
USB key · ID badge · uniform · special tooling.
Worked example — offboarding asset clearance
Employee: Antony Joseph (Manager) · resigning · LWD 2026-05-31
Open assets at offboarding-init (2026-05-15):
ASSET-LAP-0042 Dell Latitude 7440 · issued 2024-04-01
ASSET-MOB-0019 iPhone 14 Pro · issued 2024-04-01
ASSET-SIM-0019 SIM 9512xxxx · issued 2024-04-01
ASSET-CARD-0042 Access card · zone A,B,C · issued 2024-04-01
ASSET-KEY-0042 Office key · 7th floor · issued 2024-04-01
Asset clearance procedure (HR + IT):
Day -10 IT generates exit-checklist: 5 assets pending return.
Day -5 IT meeting: laptop wipe scheduled, MDM unenrol planned.
Day -3 IT clears MDM, demobilises mobile, retains access cards.
Day -1 Employee returns laptop + mobile (working) + SIM (cancelled).
Access card returned same day. Office key handed to admin.
Day 0 All 5 rows marked returned in /employees/{id}/assets/.
Outstanding-count badge: 0.
Offboarding clearance gate "Assets returned" auto-ticks.
Day +5 Final settlement processed (no asset deduction needed).
Common pitfalls
If IT physically issues a laptop without recording it on M13, the offboarding clearance gate misses it. Result: laptop walks out the door, no recourse. Make recording mandatory before handover.
Always record condition_at_return + return_notes. Photo evidence in storage/employees/{id}/assets/. Final-settlement deduction only valid if photographed at return.
Dependent passport expiries are tracked separately. If a dependent passport expires while sponsor (employee) is mid-renewal, the dependent goes out-of-status. M17 reminder is your safety net.
Office keys are a security audit finding. Make returns physical (key handed to admin, signature on form, photo of return). Don't accept "I left it on my desk".
Dependents: m13.manage_dependents — typically HR + super_admin/partner only. Assets: m13.manage_assets — HR + IT department-scope (so IT can record issuances without touching salary or appraisals). Both gated by employee scope: managers see their department's employees; senior + staff see only themselves.