Vehicle Portal — Help Guide

Login & Access

• Root Login: / shows a unified login with User Type dropdown (Admin, Issuer, DA-POOL). All role-specific login URLs route to this page.
• Unauthorized Page: If a protected route is accessed without a session, you are sent to /unauthorized with Admin Login and Back to Portal buttons.
• Default Accounts:
  • Admin: admin / admin123
  • Issuer: issuer / issuer
  • DA-POOL: da-pool / da-pool
• Change Password: Available for all roles:
  • Admin: /admin/change-password
  • Issuer: /issuer/change-password
  • DA-POOL: /viewer/change-password

Roles & Capabilities

• Admin: Full management of Vehicles, Pumps, Fuel Prices, Mobil Prices, Issuances, Slip Numbers, Reports.
• Issuer: Issue Fuel (create issuance, generate slip), View Reports, manage Slip Numbers (series setup).
  • Issuer navigation is simplified to “Issue Fuel” and “View Reports”.
• DA-POOL: Manage Vehicles, Manage Petrol Pump, Manage Fuel Price, Manage Mobil Price, View Reports.
  • Issuance actions (add/regenerate) are not available to DA-POOL.

Slip Numbers (Series Setup)

• Admin: /admin/slips, /admin/slips/create.
• Issuer: /issuer/slips, /issuer/slips/create.
• Usage: Enter a vehicle and a range (e.g., 100 to 150). The system creates individual slip numbers for that vehicle.
• Issuance Enforcement: Only unused slip numbers for the selected vehicle appear in the “Slip Number” dropdown. On save, the slip is marked used.
• Issued By: Issuance list shows who created the issuance (Admin or Issuer).

Issuances

• Create: Admin: /admin/issuances/create, Issuer: /issuer/issuances/create.
• Slip Number: Dropdown filtered by selected vehicle, shows unused slips only.
• Fuel Balance: The form shows “Fuel Balance (as on date)” which is computed for the current month:
  • Balance = Issued − (KM ÷ Run per Liter)
  • API: Admin /admin/api/fuel-stock, Issuer /issuer/api/fuel-stock
• Rates: Latest price on/before issuance date is used.
• Slip: “Generate Slip” opens a printable slip view.

Monthly Bill & Reports

• Monthly Bill: /admin/reports/bill, /viewer/reports/bill, /issuer/reports/bill.
• Print/PDF: Print view is optimized with clear grid lines; download PDF via /.../reports/bill/pdf.
• Add/Less Clarity: Bill shows “Add” when shortage and “Less” when excess, with absolute liters/amounts to avoid sign confusion.
• Synopsis: Vehicle-wise month synopsis is available for all roles.

Navigation Highlights

• Issuer: Sidebar shows “⛽ Issue Fuel” and “📊 View Reports” only; active items are highlighted.
• DA-POOL: Buttons/links for managing Vehicles, Pumps, Fuel/Mobil Prices, plus Reports and Logout.
• Admin: Full menu including Slip Numbers.

Troubleshooting

• Unauthorized: If redirected to /unauthorized, use the appropriate login or go back to the portal.
• Slip Validation: If you see “Invalid or already used slip number”, ensure the slip belongs to the selected vehicle and is unused.
• PDF Layout: If tables don’t show grid lines in PDF, ensure you are using the Bill Print/PDF pages.
• Fuel Balance: Balance is month-to-date; verify vehicle’s Run per Liter is set.

Key Code References

• Unified Login: app/Http/Controllers/AdminWebController.php (rootLoginForm/rootLogin)
• Unauthorized page: resources/views/errors/unauthorized.blade.php
• Issuer navigation & routes: resources/views/layouts/admin.blade.php, routes/web.php
• Slip Numbers: app/Http/Controllers/AdminWebController.php, resources/views/admin/slips/*
• Issuance form (slips, balance): resources/views/admin/issuances/create.blade.php
• Fuel stock API: app/Http/Controllers/AdminWebController.php (fuelStock)
• Bill print/PDF: resources/views/admin/reports/bill_print.blade.php, routes to /.../bill/pdf

Support

For access issues or data inconsistencies, contact the system administrator.