1. System Overview
▼HangarHub Mx is KP Aviation’s maintenance management system. It runs in your web browser — no app to install.
| Dashboard | Main control panel — aircraft queue, status updates, work orders, messaging, timekeeping, quoting |
| Work Order | Full-page work order editor — discrepancies, labor tracking, parts, AD compliance, sign-off |
| AD Compliance | Airworthiness directive tracking per aircraft and work order |
| AMTS Portal | Customer-facing status and messaging portal |
| Dashboard URL | kpaviationservices.com/mechanic-dashboard.html |
| AMTS Portal URL | kpaviationservices.com/customer-portal.html |
| Shop phone | (208) 557-3709 |
| SMS number | +1 (208) 980-2553 (Twilio) |
2. Creating a Mechanic Account
▶Create via Admin Panel (recommended)
- Log in as an admin and click ⚙ Admin in the topbar.
- Click the 👤 Accounts tab.
- Fill in username, display name, password, and confirm password.
- Check Grant admin access if needed.
- Click Create account.
Reset a Password
3. Logging In
▶- Navigate to the dashboard URL.
- Enter your username and password.
- Press Enter or click Sign In.
- Session stays active until you sign out.
4. The Dashboard
▶Topbar
| ✈ HangarHub Mx | Shop logo |
| Clock widget | Live timer, Clock In/Out/Break, Timesheet, My Hours (apprentices only) |
| ⚙ Admin | Admin panel — admin accounts only |
| ✈ Savvy Aviation | Opens Savvy portal in new tab |
| ❓ Help | Opens this guide |
| Sign Out | Logs you out |
Adding an Aircraft
- Click + Add Aircraft.
- Type the N-number and press Tab — auto-fills make, model, year, serial, engine, owner name, address from FAA registry.
- Fill in owner cell phone, service type, assigned mechanic, estimated completion.
- Click Add & Send Welcome SMS.
Status Update
- Click Update on the aircraft row.
- Select status: Pending / In Progress / Waiting on Parts / Complete / Grounded.
- Select the current stage.
- Enter a customer note (sent in SMS and AMTS portal).
- Enter a shop note if needed — internal only.
- Update estimated completion if changed.
- Toggle Send SMS — defaults to OFF.
- Click Send update.
5. Work Order — Full Page
▶Opens in a new tab when you click the WO button on any aircraft row.
Labor Hours — Two Options Per Discrepancy
| Manual entry | Type hours directly into the Labor Hrs field (e.g. 2.5). Updates the total immediately. |
| ▶ Start timer | Click ▶ Start to begin automatic timing. Live counter updates the field in real time. |
| ⏸ Pause timer | Click ⏸ Pause to stop. Hours written into the field. Manual edits always allowed. |
Parts Entry — Multiple Parts Per Discrepancy
- Type a part name or number in the Parts / Costs field — autocomplete searches your inventory.
- Click a result to insert it. The part fills in with description and cost.
- Press Enter to start a new line, then type the next part name to add additional parts.
- You can also type free-text descriptions for items not in inventory.
Saving
- Click 💾 Save (green pulsing button, top right).
- Autosave runs every 60 seconds silently.
Topbar Buttons
| ← Dashboard | Returns to the dashboard |
| 💾 Save | Saves all work order data |
| ⚖ AD Compliance ↗ | Opens AD compliance for this work order |
| 💬 MSG | Opens customer message thread |
| Prints work order with QR code and sign-off block |
6. Customer Messaging System
▶Every aircraft has a message ticket automatically created at check-in.
- Open the work order and click 💬 MSG.
- Type your message and click Send, or attach a photo with 📎 Photo.
- Check Internal to send a note visible only to mechanics.
| Red ! on WO button | Unread customer message. Clears when you open the thread. |
| Slide-in toast | Pops up when a new message arrives. |
Customers visit kpaviationservices.com/customer-portal.html, enter their phone number, and see status plus the full message thread.
7. AD Compliance
▶Open from the work order topbar: ⚖ AD Compliance ↗
| Status | Open / ✅ Complied / ➖ N/A / ⏳ Deferred |
| Recurring | Check if repetitive compliance required |
| Method of Compliance | How the AD was complied with |
| Date / Hours | Date and aircraft hours when complied |
| Next Due | When next action required (recurring ADs) |
| Internal Notes | Shop notes — not printed on customer copy |
- 💾 Save saves all AD data.
- 🖨 Print AD List generates a printable 14 CFR Part 39 compliance report.
8. SMS Notification System
▶HangarHub sends SMS from +1 (208) 980-2553.
| Welcome SMS | Sent automatically when aircraft is added |
| Status Update SMS | Sent when you update status — defaults to OFF |
| 24-Hour Pickup Reminder | Sent automatically the day after status is set to Complete |
9. Manual Library (HangarHub)
▶Click the 📚 Manuals button on the dashboard to open the HangarHub manual browser overlay. Contains 619 built-in manuals plus any custom manuals added by an admin.
| Aircraft tab | Filter by manufacturer and category (POH, Maintenance Manual, Parts Catalog, Wiring Diagram) |
| Engines tab | Filter by manufacturer and manual type (Lycoming, Continental, Rotax, etc.) |
| Components tab | Filter by component type and brand (avionics, props, magnetos, landing gear, etc.) |
| QRG tab | FAR Part 43 and Quick Reference Guides |
Relevant Manuals on Work Orders
When you open a work order, the Relevant Manuals section auto-matches the aircraft make/model and engine. Click Show ▼ to expand. Results grouped by ✈ Airframe, 🔧 Engine, ⚙ Component.
Adding Custom Manuals (Admin)
Admin Panel → 📚 Manuals tab → + Add manual → fill in title, manufacturer, model, category, type, and URL. Custom manuals appear automatically in work order Relevant Manuals.
10. QR Code System
▶- QR code printed on every work order — links to the AMTS customer portal.
- Customer scans QR → enters phone number → sees status AND message thread.
- QR scanner in dashboard — scan to jump to that aircraft’s update panel.
11. Employee Timekeeping
▶The time clock lives in the topbar — always visible after login.
Clock In / Out / Break
| Clock In | Click Clock In when you arrive. Live timer starts immediately. |
| Start Break | Click Start Break. Timer pauses; break time deducted. |
| End Break | Click End Break when returning. Timer resumes. |
| Clock Out | Click Clock Out and confirm. Total hours calculated automatically. |
My Timesheet
- Click Timesheet in the topbar.
- View Mon–Sun breakdown: clock in/out, break minutes, daily hours.
- Summary shows Regular (up to 40 hrs), Overtime, and Total.
- Click ⬇ Download PDF to print for signing.
- Use ◄ Prev / Next ► to view other weeks.
Manual Time Entry (Admin)
- Admin Panel → ⏱ Timekeeping → click + Add Entry.
- Select employee, date, clock in time, clock out time, break minutes, and optional note.
- Live preview shows calculated hours.
- Click Save Entry.
12. Apprentice Tracker
▶FAA-compliant apprentice hour log for mechanics working toward their A&P certificate under 14 CFR Part 65.
Hour Targets
| Airframe (A) only | 2,880 hours |
| Powerplant (P) only | 2,880 hours |
| Airframe & Powerplant (A&P) | 4,800 hours |
Logging an Entry
- Click My Hours in the topbar.
- Click + Log Entry.
- Fill in: Date, N-Number, Aircraft Type, ATA Chapter, Hours, Task Description.
- Click Save Entry.
Verification and Locking
| Pending ⏳ | Entry is editable and deletable by the apprentice |
| Verified ✅ | Entry is locked — apprentice cannot edit or delete. Admin can unlock. |
Experience Letter PDF
- Click ⬇ Experience Letter in the My Hours modal.
- PDF shows: name, program dates, verified hour totals, progress bar, full entry table, and signature lines.
- Print and present to supervising mechanic for signature.
13. Admin Panel
▶Click ⚙ Admin in the topbar. Only visible to admin accounts.
📦 Parts Inventory Tab
- Search and filter by name or stock level (In Stock / Low / Out).
- Click any field to edit inline — a Save button appears on that row. Click it to commit the change.
- Use the Set button to update quantity on hand.
- + Add part — part number, description, cost, qty, min qty, location.
- 虹 Import CSV — accepts QuickBooks export. Filters out service/labor items automatically.
- 蚁 Export CSV — downloads full parts list.
👤 Accounts Tab
- Create accounts with username, display name, and password.
- Toggle Admin checkbox to grant or revoke admin access.
- Delete accounts with the Delete button.
📉 Display Tab
- Enable/disable screens, set duration, reorder with arrows.
- Built-in screens: Shop Status Board, KIDA Weather, Flight Tracker.
- Add custom URL screens. Set background color, accent, font, and transition.
- Click 💾 Save Display Config — shop display updates within 30 seconds.
💰 Rates & Fees Tab
Set your shop labor rates and fees. These are used automatically when creating new quotes.
| Pistons @ KIDA | Default $130/hr |
| Pistons — Mobile | Default $135/hr |
| Turboprops @ KIDA | Default $145/hr |
| Turboprops — Mobile | Default $150/hr |
| Turbine Jets & Helicopters @ KIDA | Default $165/hr |
| Turbine Jets & Helicopters — Mobile | Default $170/hr |
| Mileage Rate | Default $1.50/mile — applied to travel jobs |
| Emergency Call Out Fee | Default $250 flat fee |
- Edit any value and click 💾 Save Rates.
- Changes apply to all new quotes immediately. Existing saved quotes are not affected.
- Rates auto-fill on new quotes based on detected aircraft type and whether it is a travel job.
📚 Manuals Tab
- Shows the full 619-manual built-in library merged with your custom manuals.
- Filter by manufacturer or category using the dropdowns.
- + Add manual — title, manufacturer, model, category, type, URL. Appears automatically in work order Relevant Manuals.
- Built-in manuals show a Built-in label. Custom manuals show an X delete button.
⏱ Timekeeping Tab
- View all employees’ time entries for any week using Prev / Next.
- LIVE badge shows anyone currently clocked in.
- Edit — correct clock in/out, break minutes, or notes on any entry.
- Del — permanently delete an entry.
- ✅ Approve Week — marks the week as approved.
- + Add Entry — manually add a time entry for any employee for any date.
- 蚁 Export All PDFs — prints all employee timesheets for the selected week.
✍ Apprentice Tab
- Lists all mechanic accounts with total hour progress at a glance.
- Expand any account to configure: supervising mechanic, A&P cert number, program start date, and Certificate Pursuing (A / P / A&P).
- Check Mark as apprentice to enable the My Hours button for that account.
- Click Load Entries to see all log entries in a scrollable list.
- Filter entries by All / Verified / Pending using the dropdown.
- Verify — locks an entry permanently.
- Unlock — removes verification if a correction is needed.
- Edit — modify any entry (admin can edit even verified entries).
- + Add Entry — add an entry on behalf of the apprentice.
- 蚁 Experience Letter — generates a print-ready FAA experience letter.
📋 Quotes Tab
Create, manage, and send maintenance estimates to customers. Admin-only.
Creating a Quote
- Click + New Quote.
- Enter the N-number and press Tab — auto-fills aircraft and owner info from the FAA registry.
- Select the service type — the system checks past completed work orders and shows historical labor averages for that service + aircraft combination.
- Adjust Est. Hours and Rate ($/hr) (default $130/hr).
- Toggle Travel job to add a travel fee line.
- Search your parts inventory to add line items, or click + Custom line for items not in inventory.
- Add optional notes (printed on the quote).
- Click 💾 Save Quote.
Quote Status Flow
| ⬜ Draft | Being built, not yet sent |
| 📤 Sent | Emailed to customer, awaiting response |
| ✅ Accepted | Customer approved |
| ❌ Declined | Customer passed |
| ⏰ Expired | Past validity date (auto after 10 days) |
| 🔄 Converted | Turned into a work order |
Sending and Managing
- 📄 PDF — generates a print-ready estimate with KP Aviation branding and signature lines.
- 📧 Send — emails the estimate directly to the customer’s email address on the quote.
- Accept / Decline — mark the customer’s response.
- ⇄ WO — converts an accepted quote to a work order in one click. Pre-fills the aircraft, customer info, and service type automatically.
EMAIL_USER and EMAIL_PASS environment variables configured on the server. Without them, quotes still mark as Sent but the email won’t go out.14. Archiving Aircraft
▶- Open the work order for the completed aircraft.
- Click Archive in the update panel → Confirm.
- Aircraft removed from queue. All data preserved permanently.
Restoring
- Dashboard → Archive panel → ↩ Restore.
15. Savvy Aviation
▶Click ✈ Savvy Aviation in the topbar to open apps.savvyaviation.com in a new tab.
16. Quick Reference — Common Tasks
▶| Create mechanic account | Admin Panel → 👤 Accounts → fill form → Create account |
| Reset a password | Render Shell → node src/manage-users.js reset <user> "<pass>" |
| Add a new aircraft | Dashboard → + Add Aircraft → N-number → Tab → fill fields → Add & Send Welcome SMS |
| Update aircraft status | Dashboard → Update → status + stage + note → Send update |
| Open a work order | Dashboard → WO button |
| Enter labor hours manually | Work Order → type hours into the Labor Hrs field |
| Time a discrepancy | Work Order → discrepancy row → ▶ Start → ⏸ Pause when done |
| Add multiple parts | Work Order → Parts field → type part → select from autocomplete → Enter for next line |
| Send customer a message | Work Order → 💬 MSG → type → Send |
| Save a work order | Work Order → 💾 Save (green, top right) |
| Open AD compliance | Work Order → ⚖ AD Compliance ↗ |
| Print work order | Work Order → 🖨 Print |
| Clock in | Topbar → Clock In |
| Clock out | Topbar → Clock Out → Confirm |
| View my timesheet | Topbar → Timesheet |
| Add manual time entry (admin) | Admin Panel → ⏱ Timekeeping → + Add Entry |
| Approve employee week (admin) | Admin Panel → ⏱ Timekeeping → expand employee → Approve Week |
| View my apprentice hours | Topbar → My Hours (apprentice accounts only) |
| Log an apprentice entry | My Hours → + Log Entry → fill all fields → Save Entry |
| Generate experience letter | My Hours → ⬇ Experience Letter |
| Verify an apprentice entry (admin) | Admin Panel → ✍ Apprentice → expand → Load Entries → Verify |
| Enable apprentice mode (admin) | Admin Panel → ✍ Apprentice → expand → Mark as apprentice → Save Profile |
| Update shop rates (admin) | Admin Panel → 💰 Rates & Fees → edit values → Save Rates |
| Create a new quote (admin) | Admin Panel → 📋 Quotes → + New Quote → fill form → Save Quote |
| Send a quote to customer (admin) | Admin Panel → 📋 Quotes → 📧 Send on the quote row |
| Convert accepted quote to WO (admin) | Admin Panel → 📋 Quotes → ⇄ WO button on accepted quote |
| Preview / print quote PDF (admin) | Admin Panel → 📋 Quotes → PDF button on quote row |
| Archive a completed aircraft | Work Order → Archive → Confirm |
| Add a custom manual (admin) | Admin Panel → 📚 Manuals → + Add manual |
| Import parts from QuickBooks (admin) | Admin Panel → 📦 Parts → 虹 Import CSV |
| Save a part price change (admin) | Admin Panel → 📦 Parts → edit inline → click Save on the row |
| Configure shop display (admin) | Admin Panel → 📉 Display → configure → Save Display Config |
| Sign out | Dashboard → Sign Out (top right) |
17. System Information
▶| Dashboard URL | kpaviationservices.com/mechanic-dashboard.html |
| Work Order URL | kpaviationservices.com/work-order.html |
| AMTS Portal URL | kpaviationservices.com/customer-portal.html |
| AD Compliance URL | kpaviationservices.com/ad-compliance.html |
| Help URL | kpaviationservices.com/help.html |
| Backend | kp-aviation-backend.onrender.com |
| SMS number | +1 (208) 980-2553 (Twilio) |
| Image storage | Cloudinary (dqykqykh4) |
| Shop email | kpaviationmx@gmail.com |
| Shop phone | (208) 557-3709 |
| Shop address | 1940 International Way, Idaho Falls, ID 83402 |
This system was built specifically for KP Aviation Services. For technical issues or new features, contact your system developer.