Canofy Process Standardization & Refactoring

User Story
As a Canofy user, I want to retrieve FASTag details and visualise the associated toll-plaza locations on a map so that I can understand the vehicle's FASTag information and recent location activity geographically.

Description
Develop the FASTAG/02 Details & Location Visualisation functionality within the Canofy ULIP application.
The module retrieves FASTag details using either a vehicle registration number or FASTag ID and presents the returned FASTag information in a structured interface.
The FASTag transaction/location information is also integrated with Leaflet and OpenStreetMap to provide an interactive map-based representation of the toll-plaza locations. The coordinates returned by the simulated ULIP FASTAG data are converted into map markers, allowing the user to visually identify where the recorded FASTag activity occurred.
The current implementation uses simulated ULIP responses for development and demonstration. Once the application receives ULIP approval and access to the relevant production APIs, the mock response can be replaced with the actual ULIP response while retaining the same application/service and map-integration structure.

Configuration / Prerequisites
Common Canofy ULIP integration framework configured.
FASTAG/02 service integration implemented.
FASTag registration number / FASTag ID search functionality available.
Leaflet configured for interactive map rendering.
OpenStreetMap configured as the map tile provider.
FASTag response containing valid latitude/longitude coordinates available.
Map markers and location display integrated with the returned transaction data.
Mock FASTag data available for successful, failed and service-error scenarios.

Acceptance Criteria
Users can search for FASTag details using the supported search methods.
Successful FASTAG/02 responses are displayed in a structured format.
FASTag details such as Tag ID, registration number, tag status, vehicle class, issue date and issuing bank are displayed correctly.
FASTag location coordinates returned by the service can be plotted on an interactive map.
Leaflet successfully renders the map within the Canofy application.
OpenStreetMap tiles are used as the map layer.
Each available location is represented using an appropriate map marker.
Selecting/viewing a marker provides the relevant toll-plaza/location information.
The map and FASTag data remain consistent with the underlying ULIP response.
Missing or invalid location information does not break the rest of the FASTag results.
The implementation is structured so that the mock ULIP response can later be replaced by the approved ULIP API response without redesigning the map functionality.

Test Cases
TC01 – FASTag Details Search
Search using registration number KA01AB1234.
Expected Result: FASTag details are successfully retrieved and displayed, including Tag ID, registration number, status, vehicle class, issue date and issuing bank.

TC02 – FASTag ID Search
Search using 3416FAKE12345678.
Expected Result: The associated FASTag details for KA01AB1234 are returned successfully.

TC03 – Map Rendering
Load the FASTag transaction/location data containing the configured coordinates.
Expected Result: Leaflet loads successfully and displays the corresponding locations using map markers over OpenStreetMap.

TC04 – Location Verification
Inspect the locations returned for KA01AB1234.
Expected Result: The configured coordinates correspond to the intended toll-plaza locations, including Electronic City, NICE Road, Attibele and Hosur Road.

TC05 – Marker Information
Select a displayed map marker.
Expected Result: The relevant toll-plaza/location information is displayed for that marker.

TC06 – No Location / Failed Search
Use MH12TAG9999 or a response without valid location information.
Expected Result: The application handles the unavailable data gracefully without breaking the FASTag results or map interface.

TC07 – ULIP Service Error
Enter ERROR500.
Expected Result: The simulated ULIP service failure is handled gracefully and an appropriate error state is displayed.