This guide helps lecturers verify that the system meets the three project objectives. Follow the steps for each objective to assess the implementation.
The system automates fuel dispensing and supports prepaid PetroCards (and cash).
- Register: Use Register – choose Customer or Organization. Log in after registration (email is auto-confirmed).
- PetroCards (Organisation): Log in as Organisation → Management → PetroCards. Create a new PetroCard and assign it to a user. Ensure the card has a positive balance (top up if your app supports it, or use seed data).
- PetroCards (Customer): As Customer, go to My Cards to see cards assigned to you.
- Stations & stock (Organisation): Under Management → Stations, ensure at least one station exists and has coordinates. Under Management → Fuel Stock, add or confirm fuel stock for that station so pumps have fuel.
- Start dispensing: Go to Dispensing → select a station and pump → Start Dispensing. Choose PetroCard and tap/enter card ID, or choose Cash. Enter quantity, then complete the dispensing flow. Confirm that a fuel transaction is created and appears under Transactions or My Transactions.
Completed fuel transactions are recorded on the blockchain; records can be viewed and verified.
- Complete a dispensing: Finish at least one fuel dispensing (PetroCard or cash) so that a transaction is completed. Blockchain recording runs on completion when the service is configured.
- Secured Records: Log in as Organisation (or admin) → Management → Secured Records. You should see blockchain records linked to fuel transactions (transaction number, hash, block number). This shows blockchain integration for fuel transactions.
- Verify on blockchain: Go to Management → Verify. Enter a transaction number from a completed dispensing. The system verifies that the transaction exists on the blockchain and shows the result (and explorer link if configured). This demonstrates transparent, tamper-proof verification.
The system provides real-time fuel availability and routing to stations.
- Availability list: Go to Availability → List. Confirm that stations are listed with open/closed status, fuel types, and current stock levels. This is the real-time fuel availability feature.
- Map and routing: Go to Availability → Map. Click Use My Location (allow browser location). The map shows your position and the nearest station; a route from your location to the station is drawn automatically. You can also use Get Directions on any station card. This demonstrates the routing feature.
Note: Organisation/admin users see Management (Stations, Pumps, PetroCards, Fuel Stock, Fuel Types, Transactions, Secured Records, Verify). Customers see My Cards and My Transactions only. Use an Organisation account to test Objectives 1–2 fully; both roles can test Availability and Map (Objective 3).
