Complete user & administrator handbookUSD · America/Chicago18 practical chapters
Trusted records. Clear decisions. Keep financial sources separate, preserve approved history, and use only authorized actions. This handbook does not display live account or business data.
No chapters match your search. Try a shorter term or clear the search.
01
Start here
Getting started
A practical handbook for the North Star Transit Fleet Management System. Use it alongside the live application; your assigned permissions determine the actions you can perform.
How to use it
Open the application and sign in with your own active account. Use Remember Me only on a trusted private device.
If you forget your password, choose Forgot Password, enter your account email, and follow the reset link delivered to that address. Check spam. If delivery fails, contact your administrator; an on-screen request confirmation does not prove inbox delivery.
Use the sidebar to open modules. On a phone, use the navigation toggle. Open the profile menu to update your profile or sign out.
Choose the correct reporting period before interpreting financial information. Business dates use America/Chicago and financial displays use USD.
Use an individual account rather than sharing an administrator login. Sign out on shared devices.
Keep in mind
Passwords require at least 12 characters, uppercase and lowercase letters, and a number. Keep them private.
This guide contains instructions, not live business data. No example represents a saved transaction.
Record actual ordinary operating expenses, with source protection and a clear retained history.
How to use it
Open Expenses and select the period, truck, category, status, and search filters as needed.
Choose Add Expense if permitted. Enter the date, truck, active category, description, vendor/reference, and actual amount.
Attach a supported receipt through the file control if available. Follow the type and size guidance on the form.
Save and open the detail page to verify the number, amount, status, and secure receipt view/download.
Edit only eligible unprotected records. To reverse an eligible record, use Void and provide the mandatory reason/confirmation.
Keep in mind
Fuel belongs in Fuel, not in ordinary Expenses. Factoring, Dispatch, Driver Amount, and Company Share are calculated settlement concepts, not normal expense transactions.
Voided expenses stay in history but are excluded from Active Expense totals. Protected approved-settlement sources cannot be edited or voided.
Seven reports share trusted filters and calculations across the screen and exported files.
How to use it
Open Reports and select Truck Revenue, Expense, Fuel, Driver Earnings, Truck Profitability, Company Summary, or Settlement Register as permitted.
Choose Today, This Week, This Month, Last Month, or Custom Date Range. Apply the applicable truck, driver, status, category, payment, operational, state, and search filters.
Click Apply Filters to refresh the screen. Check the readable filter scope and summary before exporting.
Click Export PDF or Export Excel where authorized. The export uses the current form selections, including selections changed before Apply Filters was clicked.
Exports include all matching records, not just the visible page. Narrow the date range or filters if the 1,000-row limit is exceeded; custom periods are limited to 366 days.
Open the PDF or XLSX and check report title, company identity, period, filters, rows, and summary. Company Settings supplies branding; an absent logo is supported.
Delivered Revenue
Earned gross revenue from Delivered Loads, independent of collection status.
Recorded Expenses / Fuel Cost
Separate actual transaction summaries, not a substitute profitability formula.
Approved Settlement Net Position
Saved Approved/Paid settlement Gross Revenue minus Total Deductions, reported using settlement period end.
Company Share
A separate internal allocation, never another deduction from Net Position.
Keep in mind
For identical applied filters, screen, PDF, and Excel totals agree. XLSX financial cells are numeric; negative Net Position stays negative.
Driver Earnings and Truck Profitability use saved settlement results. Draft/Reviewed rows in Settlement Register remain non-final workflow data.
Central Documents manages private Truck, Driver, Load, and Company/General files.
How to use it
Choose Documents → Add/Upload Document, or Add Document from a Truck, Driver, or Load profile.
Select exactly one owner context, the related record if required, and an active document type valid for that scope.
Enter the title and attach a PDF, JPG/JPEG, or PNG. The application limit is 10 MB; hosting limits must also support the upload.
Add issue date, expiry date, reference, and notes where useful. Expiry may be historical but cannot precede issue when both are supplied.
Save and use the authorized View or Download actions. Filter by owner, type, lifecycle, expiry condition, and supported search.
Correct metadata on eligible Active documents. For a substantial file replacement, Archive the old document and upload a new one.
Authorized management can restore an Archived document. Its historical file remains retained and private.
Keep in mind
Expiry is derived from the Chicago business date: before today = Expired; today through +30 days = Expiring Soon; beyond +30 days = Valid; no date = No Expiry.
Uploading a document never changes driver license fields, load payment/revenue, expenses, or fixed costs. Expense/Fuel receipts remain in their own modules.
Condition status and personal read state are separate. Reading a reminder does not fix its source.
How to use it
Use the header bell or Notifications page. The badge counts only your accessible Open Unread reminders.
Filter by Open/Resolved, Read/Unread, type, and severity; the default prioritizes Open notifications.
Open a reminder and follow its authorized related-record link.
Use Mark Read or Mark Unread to change only your personal state. Mark All Accessible Open as Read applies to accessible Open reminders across pages.
Correct the underlying condition through the original module. The system resolves the reminder when it no longer applies.
Use Resolved history to review previous conditions. Resolved unread reminders do not contribute to the bell count.
Keep in mind
The six reminder types are Document Expiring Soon/Expired, Driver License Expiring Soon/Expired, VIN Verification Required, and Settlement Awaiting Approval.
Expiry and VIN conditions synchronize daily at 00:05 America/Chicago when the scheduler runs. Settlement review reminders are immediate. These are in-app reminders, not email/SMS/push notifications.
Use administration screens only where your current account has the required permissions.
How to use it
Super Admin can open Users, create actual staff accounts, choose the appropriate role/status, and provide a unique strong initial password with confirmation.
Use the minimum role necessary. Edit or deactivate accounts through the existing controls instead of sharing credentials.
Keep at least one Active Super Admin. Changing your own email or password requires your current password through the normal application workflow.
Use Company Settings to maintain the company identity, address, contacts, USDOT/MC, currency, timezone, and actual logo.
Use Expense Categories and Document Types where authorized. Deactivate used configuration rather than deleting historical context.
Use My Profile for permitted personal details and password changes. An empty optional password field on an edit form retains the existing password.
Super Admin
Full authorized administration and business actions; last-active-admin safeguards apply.
Manager
Operational management, settlement approval/void, configuration actions where granted; user/company administration is not granted by default.
Finance
Financial entry, settlement preparation/review/payment, permitted reports and exports; no settlement approval/void by default.
Operations
Fleet, loads, assignments, fuel, and permitted operational documents/reports; no sensitive settlement approval reminders.
Viewer
Permitted read-only screens and downloads; no write or export actions by default.
Keep in mind
Role labels are defaults; actual grants/revocations and underlying-record checks determine every action. Hidden buttons never grant access.
Account credential/status/role changes invalidate affected sessions. Keep production secrets and backup access outside the application guide.
Resolve common issues without bypassing permissions or damaging historical data.
How to use it
No records or zero totals: check period, search, status, truck/driver, and other filters; clear filters to return to the approved default.
Validation error: read the field message, correct the highlighted input, and resubmit. Previously entered values are normally retained.
Session expired (419): reopen the page, sign in if needed, and submit a fresh form. Do not disable CSRF protection.
Permission denied (403): contact your administrator to review the required permission and underlying-record access.
Protected or stale record: follow the settlement lifecycle or reopen a fresh review form; never force a direct database edit.
Upload failed: check file type, size, and hosting limits. Keep private files on authorized routes.
Reset email missing: check the account email and spam folder, then ask the administrator to verify production mail delivery. Never publish reset tokens.
Export too large: narrow the scope. The application rejects excessive exports instead of silently truncating them.
Keep in mind
Avoid duplicate submissions; wait for the server confirmation. Never assume success before a confirmed save.
For support, provide the module, business reference, time, and safe error description. Do not send passwords, reset tokens, private storage paths, or full confidential documents.