Repository navigation
UC‐01
| Field | Content |
|---|---|
| Use Case Number: | UC-1.1 |
| Use Case Name: | View Map & Outdoor GPS Positioning |
| Actor(s): | Visitor |
| Maturity: | Focused |
| Summary: | The Visitor views the outdoor museum map and tracks their current real-time location via GPS positioning. |
| Basic Course of Events: |
Actor Action 1. The use case begins when the Visitor selects the "Map" feature on the web application. System Response 2. The system requests location permission and retrieves the device's current GPS coordinates. A1. 3. The system verifies that the coordinates are within the museum grounds, loads the outdoor map, and displays the current location marker along with outdoor POI markers. A2, E1 Actor Action 4. The Visitor performs zoom in, zoom out, or pan gestures on the map. (Repeat as many times as necessary.) System Response 5. The system updates the outdoor map viewport accordingly. |
| Alternative Paths: |
A1: Location Permission Denied or GPS Disabled Actor Action 1. The Visitor denies location permission on the browser prompt or has device GPS disabled. System Response 2. The system displays a notification: "Unable to get current location. Defaulting to Main Entrance." 3. The system loads the outdoor map centered at the Main Entrance. 4. Return to step 4 of the Basic Course of Events. A2: GPS coordinates outside museum grounds (> 300m radius) System Response 1. The system displays a notice and automatically centers the map at the Main Entrance. 2. Return to step 4 of Basic Course of Events. |
| Exception Paths: | None. |
| Extension Points: | None. |
| Triggers: | Visitor wishes to view the outdoor museum layout and their current position. |
| Assumptions: | The Visitor's mobile browser supports the standard HTML5 Geolocation API. |
| Preconditions: | The web application is active on the Visitor's mobile browser. |
| Postconditions: | The interactive outdoor map and the Visitor's current location marker (or default Main Entrance marker) are displayed on the screen. |
| Field | Content |
|---|---|
| Use Case Number: | UC-1.2 |
| Use Case Name: | View Exhibit POI Information |
| Actor(s): | Visitor |
| Maturity: | Focused |
| Summary: | The Visitor taps on an exhibit Point of Interest (POI) marker on the outdoor map to view a summary preview card and navigate to the audio guide. |
| Basic Course of Events: |
Actor Action 1. The use case begins when the Visitor taps an exhibit marker (POI Marker) on the outdoor map. System Response 2. The system queries the database for the corresponding exhibit summary details. 3. The system highlights the selected marker and displays a bottom preview card containing: exhibit name, thumbnail image, short description, an "Audio Guide" button, and a "Directions" button. Actor Action 4. The Visitor selects the "Audio Guide" button to listen to the exhibit narration. A1, A2 System Response 5. The system redirects the Visitor to the audio guide player screen for the selected exhibit. |
| Alternative Paths: |
A1: Select another POI marker 1. The Visitor has the ability to select another POI marker on the map to update the preview card with a different exhibit's information. 2. Return to step 2 of Basic Course of Events. A2: Close preview card 1. The Visitor has the ability to tap on an empty area of the map to close the preview card. 2. The use case ends. |
| Exception Paths: | None. |
| Extension Points: | None. |
| Triggers: | Visitor taps on a specific POI marker displayed on the outdoor map. |
| Assumptions: | Outdoor POI GPS coordinates and exhibit metadata are pre-configured in the database. |
| Preconditions: | The outdoor map and POI markers are currently displayed on the Visitor's screen. |
| Postconditions: | The exhibit preview card is displayed, or the Visitor is redirected to the corresponding exhibit audio player page. |
| Field | Content |
|---|---|
| Use Case Number: | UC-1.3 |
| Use Case Name: | View Recommended Tour Route |
| Actor(s): | Visitor |
| Maturity: | Focused |
| Summary: | The Visitor views the suggested navigation route from their current outdoor location to a selected exhibit or along the standard museum tour route. |
| Basic Course of Events: |
Actor Action 1. The use case begins when the Visitor selects the "Directions" button on a POI preview card (or activates the "Recommended Route" toggle on the map). A1. System Response 2. The system retrieves the starting point (Visitor's current GPS location) and the target POI coordinates. A2 3. The system calculates the walking distance and draws a polyline route connecting the starting point to the destination on the map. 4. The system displays the visual route overlay along with the estimated walking distance in meters. |
| Alternative Paths: |
A1: GPS Location Unavailable or Outside Museum Grounds Actor Action 1. The Visitor requests a route while GPS permission is denied or while located outside the museum perimeter. System Response 2. The system automatically sets the Main Entrance coordinates as the default starting point. 3. The system informs the Visitor: "Displaying route starting from Main Entrance." 4. Return to step 3 of the Basic Course of Events. A2: Clear Route Actor Action 1. The Visitor selects "Clear Route" on the map screen to remove the polyline overlay and return to the standard map view. 2. The use case ends. |
| Exception Paths: | None. |
| Extension Points: | None. |
| Triggers: | Visitor wishes to see the walking path to a specific outdoor exhibit or follow the suggested tour sequence. |
| Assumptions: | Walking distances are calculated using the Haversine formula or predefined outdoor pathway nodes. |
| Preconditions: | The outdoor interactive map screen is active. |
| Postconditions: | The recommended polyline route and estimated walking distance are rendered on the outdoor map. |