System Requirements Document (SRD)

Project Name: sapphire-flowchart

1. Introduction

The sapphire-flowchart project is a mobile application designed to enhance the tourism experience in Bali, Indonesia. This app aims to provide users with a seamless and personalized way to explore Bali by offering curated recommendations for accommodations, dining, and attractions. The app will also feature an interactive map to highlight specific hotspots and provide directions, ensuring travelers can easily navigate the island.

This document outlines the system requirements for the sapphire-flowchart project, incorporating user feedback and specific feature requests.

2. System Overview

The sapphire-flowchart app is a mobile-first tourism platform tailored for travelers visiting Bali. It will provide users with:

• A welcoming and intuitive interface to explore Bali's offerings.
• Categorized recommendations for accommodations and dining based on budget preferences.
• An interactive map that highlights specific hotspots and provides real-time directions.
• User account functionality for personalized experiences, including sign-up, login, and profile management.

The app will cater to both first-time visitors and seasoned travelers, ensuring a rich and user-friendly experience.

3. Functional Requirements

As a User:

• I should be able to view a Home/Welcome page introducing the app.
• I should be able to Sign Up/Register or Login to personalize my experience.
• I should be able to explore Places to Stay, categorized into:
  • Budget accommodations.
  • Medium accommodations.
  • Expensive accommodations.
• I should be able to explore Places to Eat, categorized into:
  • Budget dining options.
  • Medium to expensive dining options.
• I should be able to explore Places to Explore using an interactive map that:
  • Highlights specific hotspots.
  • Provides real-time directions to selected hotspots.

4. User Personas

1. Traveler

• Description: A general user visiting Bali, looking for recommendations on where to stay, eat, and explore.
• Needs: Easy navigation, budget-specific options, and reliable directions to attractions.

2. Admin

• Description: The app administrator responsible for managing content, updating hotspots, and ensuring app functionality.
• Needs: Tools to add/edit/remove content, monitor user activity, and troubleshoot issues.

5. Visuals Colors and Theme

The sapphire-flowchart app will use a vibrant and tropical-inspired color palette to reflect the beauty of Bali:

• Background: #F5F5DC (Beige Sand)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Ocean Blue)
• Accent: #FF4500 (Sunset Orange)
• Muted Tones: #A9A9A9 (Soft Gray)

This palette evokes a sense of relaxation, adventure, and tropical warmth, aligning perfectly with the theme of Bali tourism.

6. Signature Design Concept

The sapphire-flowchart app will feature a Living Map Experience as its signature design concept.

Details:

• Interactive Map: The homepage will prominently feature a dynamic map of Bali.
• Hotspot Highlights: Key attractions (e.g., beaches, temples, waterfalls) will glow softly in Sunset Orange (#FF4500) when hovered over.
• Micro-Animations: When a user selects a hotspot, the map will zoom in smoothly, and a pop-up card will appear with details, images, and a "Get Directions" button.
• Directional Guidance: Users can toggle between walking, driving, or biking routes, with animated paths drawn on the map in Deep Ocean Blue (#2C3E50).
• Ambient Background: A subtle animation of ocean waves will play in the background, creating a calming effect.

This immersive design will make the app visually stunning and highly functional, leaving a lasting impression on users.

7. Non-Functional Requirements

• The app must load within 3 seconds on a 4G network.
• The map feature should function offline after initial download.
• The app must support both iOS and Android platforms.
• The system should handle up to 10,000 concurrent users.

8. Tech Stack

Frontend:

• React Native for mobile app development.

Backend:

• Python with FastAPI for API development.

Database:

• MySQL for structured data (e.g., user accounts, accommodations, dining options).
• MongoDB for unstructured data (e.g., user reviews, images).

AI Models:

• GPT 5.4 for user-friendly responses and recommendations.

AI Tools:

• Langchain for conversational AI integration.

Orchestration:

• Docker for local development.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

• The app will primarily target English-speaking users visiting Bali.
• The app will assume a default timezone of GMT+8 (Bali Time).
• Internet connectivity may be limited in certain areas; hence, offline map functionality is critical.
• The app will comply with Australian and Indonesian data privacy regulations.

10. Glossary

• Hotspot: A popular tourist attraction or point of interest.
• Interactive Map: A digital map that allows users to interact with elements such as hotspots and routes.
• Directional Guidance: Step-by-step navigation instructions provided to users.
• Frontend: The part of the app that users interact with directly.
• Backend: The server-side logic and database management of the app.