North Star Transit LLCFleet Management System
Open application

The North Star handbook

Your fleet.
Your workflow.
One clear guide.

Everything your team needs to operate confidently—from the first load to the final approved settlement.

Start with the essentials

Driven for a
brighter tomorrow.

Fleet operationsFinancial claritySecure records
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.

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

  1. Open the application and sign in with your own active account. Use Remember Me only on a trusted private device.
  2. 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.
  3. Use the sidebar to open modules. On a phone, use the navigation toggle. Open the profile menu to update your profile or sign out.
  4. Choose the correct reporting period before interpreting financial information. Business dates use America/Chicago and financial displays use USD.
  5. 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.
Back to top
02

Start here

Your daily routine

Follow a consistent sequence so operational records and financial reviews stay reliable.

How to use it

  1. Review the Dashboard period, fleet counts, recent records, and attention panels.
  2. Open Notifications and follow each accessible reminder to its authoritative record.
  3. Confirm truck and driver assignments before entering loads or fuel purchases.
  4. Record actual loads, ordinary expenses, fuel purchases, and supporting files in their respective modules.
  5. At the end of the period, reconcile source records, prepare settlements, and follow the review and approval workflow.
  6. Use Reports to verify the filtered scope before exporting or sharing a report with an authorized recipient.

Keep in mind

  • Never enter fictional transactions into production for practice. Ask your administrator for an isolated training environment.
Back to top
03

Fleet operations

Dashboard & KPI cards

The Dashboard brings together fleet counts and trusted operational and settlement measures.

How to use it

  1. Open Dashboard and select its existing period option or permitted custom range.
  2. Read Active Trucks and Active Drivers as status-based fleet counts, not revenue measures.
  3. Review Delivered Revenue, Outstanding Delivered Revenue, Fuel Cost, and Recorded Operating Expenses separately.
  4. Review Approved Settlement Net Position and Approved Company Share as saved Approved/Paid settlement results, where permitted.
  5. Use the truck charts, performance tables, recent activity, and awaiting-action panels to open the underlying records.

Keep in mind

  • Zero values and empty charts are expected when no eligible records match. The application does not invent growth percentages.
  • Delivered Revenue and customer collection status answer different questions. Company Share is shown separately from Net Position.
Back to top
04

Fleet operations

Trucks & VIN verification

Keep vehicle information factual while retaining historical relationships and records.

How to use it

  1. Open Trucks. Search by the supported truck fields and apply the available status or VIN filters.
  2. Choose Add Truck if authorized. Enter the unique truck number and factual VIN, vehicle, purchase, status, and notes information.
  3. Save, then open the truck detail page to review the current driver, assignment history, related activity, and documents.
  4. Use Edit for authorized corrections. Change status through the existing permitted controls instead of deleting history.
  5. Only authorized management should mark a VIN verified after checking the actual vehicle or authoritative documents.

Keep in mind

  • An incomplete supplied VIN may remain stored and unverified; do not guess missing characters.
  • A VIN reminder is advisory. Reading it does not verify the VIN or change truck status.
Back to top
05

Fleet operations

Drivers & license information

Driver profiles and historical assignments are separate, coordinated records.

How to use it

  1. Open Drivers and use the existing search and status filters.
  2. Choose Add Driver if permitted. Enter factual identity, contact, license, expiry, status, and notes information.
  3. Open the driver profile to review the current assignment and earlier assignment segments.
  4. Use Edit for accurate corrections. Use Inactive or Former as appropriate instead of deleting history.
  5. Upload supporting driver documents through the Documents section without changing the license fields automatically.

Keep in mind

  • Driver License documents and the driver license-expiry field are separate sources. Uploading a document does not synchronize them.
  • Only Active drivers with an eligible license expiry receive license reminders.
Back to top
06

Fleet operations

Assign, reassign & end assignments

Historical assignment dates determine which driver belongs to a truck for a given operating period.

How to use it

  1. Open the relevant driver profile and choose the available assignment action.
  2. Select the correct truck and date information. Review any conflicts or current relationships displayed by the application.
  3. Use the review step to check the proposed changes, including any relationship that will end.
  4. Confirm only after checking the boundaries. The server prevents overlapping or conflicting assignments.
  5. To end an assignment, use its End action and complete the existing confirmation/date requirements.
  6. Review assignment history after saving. Use historical relationships when entering dated loads or fuel purchases.

Keep in mind

  • Imported unknown assignment start dates remain unknown. Do not invent a date to make history look complete.
  • A reassignment must not rewrite already-approved settlement snapshots.
Back to top
07

Fleet operations

Loads, delivered revenue & payments

Operational status tracks the work; payment status tracks customer collection.

How to use it

  1. Open Loads and filter by date, truck, driver, operational status, payment status, or supported search.
  2. Choose Add Load if permitted. Enter the load date, truck, driver, customer/broker, route, reference information, and exact gross revenue.
  3. Check the historical driver suggestion for the load date. A permitted override requires the existing reason safeguards.
  4. Keep operational status accurate. Only Delivered loads contribute Delivered Revenue.
  5. Use the payment action to maintain collection status, payment date, and payment information where authorized.
  6. If a load needs cancellation, use the existing Cancel workflow and required reason/confirmation. Review paid-load safeguards carefully.

Keep in mind

  • Delivered loads can still be unpaid. Marking a settlement Paid does not mark its customer loads Paid.
  • After settlement approval, protected truck, driver, date, revenue, and operational fields cannot be changed. Authorized collection fields remain editable.
Back to top
08

Financial work

Expenses & private receipts

Record actual ordinary operating expenses, with source protection and a clear retained history.

How to use it

  1. Open Expenses and select the period, truck, category, status, and search filters as needed.
  2. Choose Add Expense if permitted. Enter the date, truck, active category, description, vendor/reference, and actual amount.
  3. Attach a supported receipt through the file control if available. Follow the type and size guidance on the form.
  4. Save and open the detail page to verify the number, amount, status, and secure receipt view/download.
  5. 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.
Back to top
09

Financial work

Fuel entries & actual totals

Fuel purchases are a dedicated source and never automatically create an Expense.

How to use it

  1. Open Fuel and choose Add Fuel if authorized.
  2. Enter truck, fuel date, historical driver, gallons, and price per gallon; include station, city/state, odometer, reference, and notes where useful.
  3. Compare the calculated amount with the receipt. An actual-total override must use the existing authorized override and reason workflow.
  4. Attach the receipt using the existing private upload control and save.
  5. Review Calculated Total and Actual Total on the detail page. Authorized edits/voids remain subject to source protection.
  6. Use the Fuel Report to review Total Gallons, Total Fuel Cost, and Average Price / Gallon.

Keep in mind

  • Gallons support up to three decimal places; price per gallon supports up to four. Money uses two decimal places.
  • Fuel contributes to a settlement once through Fuel Entries. Do not record a second ordinary Expense for the same purchase.
Back to top
10

Financial work

Financial settings & fixed costs

Effective-dated versions support future calculations while approved historical results remain fixed.

How to use it

  1. Open Financial Settings if your role permits it. Review the initial baseline and effective-dated history.
  2. Authorized management can create a new version with an accurate effective date, percentages, monthly fixed costs, and required notes.
  3. Use Truck Fixed-Cost Overrides for permitted truck-specific, effective-dated cost versions.
  4. Check the version and allocation mode selected during settlement preparation. Review authorized overrides and their required reasons.
  5. Keep earlier versions as history. Check the new configuration on an eligible draft before approval.

Keep in mind

  • The initial baseline has no invented effective date. Do not overwrite approved historical snapshots.
  • Default fixed costs prorate calendar days. Full Monthly or manual modes use the existing permission and confirmation safeguards.
Back to top
11

Financial work

Settlements: prepare to paid

Prepare → Review → Approve → Paid. Each transition has a distinct purpose and permission.

How to use it

  1. Check delivered loads, eligible expenses, fuel, assignment boundaries, rates, and fixed-cost configuration for the period.
  2. Choose Prepare Settlement. Select one truck, driver assignment segment, and a suitable period; do not combine different driver segments.
  3. Review the Draft source lists and exact calculated results. Refresh an eligible draft when its inputs need updating.
  4. Choose Review and complete the confirmation. A Reviewed settlement waits for authorized approval.
  5. Authorized management approves only after checking the final sources, rates, and costs. Approval saves an immutable snapshot and protects its sources.
  6. When driver payment is actually completed, an authorized user marks the settlement Paid and records the required payment details.
  7. If a reviewed draft becomes stale, Return to Draft, Refresh, and Review again. Follow the displayed state restrictions.

Keep in mind

  • Company Share is separate from Total Deductions and Net Position; it is not labeled Company Profit.
  • Prepare, Review, Approve, and Paid do not send emails or create customer payment transactions.
Back to top
12

Financial work

Settlement corrections & source protection

Correct approved or paid settlement history with the authorized void-and-replacement process.

How to use it

  1. Open the settlement and inspect its saved snapshot and protected source records.
  2. For an authorized correction, choose Void, supply the required reason, and complete the confirmation.
  3. Verify the historical settlement remains visible as Voided and eligible source claims are released.
  4. Make permitted source corrections through their original module workflows.
  5. Prepare a corrected replacement settlement and repeat Review, Approve, and Paid as appropriate.

Keep in mind

  • Do not force-edit an Approved/Paid snapshot, delete history, or bypass source protection.
  • An Expense or Fuel entry claimed by an approved settlement cannot be edited/voided until it is eligible under the authoritative workflow.
Back to top
13

Reports & files

Reports & branded PDF / Excel

Seven reports share trusted filters and calculations across the screen and exported files.

How to use it

  1. Open Reports and select Truck Revenue, Expense, Fuel, Driver Earnings, Truck Profitability, Company Summary, or Settlement Register as permitted.
  2. 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.
  3. Click Apply Filters to refresh the screen. Check the readable filter scope and summary before exporting.
  4. Click Export PDF or Export Excel where authorized. The export uses the current form selections, including selections changed before Apply Filters was clicked.
  5. 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.
  6. 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.
Back to top
14

Reports & files

Documents & expiry dates

Central Documents manages private Truck, Driver, Load, and Company/General files.

How to use it

  1. Choose Documents → Add/Upload Document, or Add Document from a Truck, Driver, or Load profile.
  2. Select exactly one owner context, the related record if required, and an active document type valid for that scope.
  3. Enter the title and attach a PDF, JPG/JPEG, or PNG. The application limit is 10 MB; hosting limits must also support the upload.
  4. Add issue date, expiry date, reference, and notes where useful. Expiry may be historical but cannot precede issue when both are supplied.
  5. Save and use the authorized View or Download actions. Filter by owner, type, lifecycle, expiry condition, and supported search.
  6. Correct metadata on eligible Active documents. For a substantial file replacement, Archive the old document and upload a new one.
  7. 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.
Back to top
15

Reports & files

Notifications & reminders

Condition status and personal read state are separate. Reading a reminder does not fix its source.

How to use it

  1. Use the header bell or Notifications page. The badge counts only your accessible Open Unread reminders.
  2. Filter by Open/Resolved, Read/Unread, type, and severity; the default prioritizes Open notifications.
  3. Open a reminder and follow its authorized related-record link.
  4. 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.
  5. Correct the underlying condition through the original module. The system resolves the reminder when it no longer applies.
  6. 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.
Back to top
16

Administration

Users, roles & company branding

Use administration screens only where your current account has the required permissions.

How to use it

  1. Super Admin can open Users, create actual staff accounts, choose the appropriate role/status, and provide a unique strong initial password with confirmation.
  2. Use the minimum role necessary. Edit or deactivate accounts through the existing controls instead of sharing credentials.
  3. Keep at least one Active Super Admin. Changing your own email or password requires your current password through the normal application workflow.
  4. Use Company Settings to maintain the company identity, address, contacts, USDOT/MC, currency, timezone, and actual logo.
  5. Use Expense Categories and Document Types where authorized. Deactivate used configuration rather than deleting historical context.
  6. 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.
Back to top
17

Reference

Troubleshooting & safe habits

Resolve common issues without bypassing permissions or damaging historical data.

How to use it

  1. No records or zero totals: check period, search, status, truck/driver, and other filters; clear filters to return to the approved default.
  2. Validation error: read the field message, correct the highlighted input, and resubmit. Previously entered values are normally retained.
  3. Session expired (419): reopen the page, sign in if needed, and submit a fresh form. Do not disable CSRF protection.
  4. Permission denied (403): contact your administrator to review the required permission and underlying-record access.
  5. Protected or stale record: follow the settlement lifecycle or reopen a fresh review form; never force a direct database edit.
  6. Upload failed: check file type, size, and hosting limits. Keep private files on authorized routes.
  7. Reset email missing: check the account email and spam folder, then ask the administrator to verify production mail delivery. Never publish reset tokens.
  8. 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.
Back to top
18

Reference

Administrator & handover checklist

A short checklist for a safe, consistent working system.

How to use it

  1. Confirm actual company settings, logo if available, America/Chicago business time, and USD currency.
  2. Confirm factual truck/driver profiles and current/historical assignments without inventing missing imported dates.
  3. Review financial baseline and effective-dated versions; keep Company Share separate and avoid duplicate fixed-cost/fuel deductions.
  4. Test an individual staff login and appropriate role visibility. Keep password recovery mail working.
  5. Confirm the production scheduler is active and the real unresolved VIN reminder remains visible while applicable.
  6. Have the hosting administrator verify coordinated database/private-file backups and an isolated restore test.
  7. Use authorized training data only outside production. Keep production free of fictional practice transactions.
  8. Confirm important history is retained: Cancel Loads, Void Expenses/Fuel/Settlements, Archive Documents, Resolve Notifications.

Keep in mind

  • Version 1 does not include maintenance, loans, payroll, general ledger, GPS, CRM, portals, AI/OCR, or external reminder channels.
Back to top

Ready for the road

Good records make stronger operations.

Start with accurate source records. Review before approval. Keep your team’s access secure.

Open Fleet Management System