Scenic-Mall System Requirements Document

Introduction

The "Scenic-Mall" project is designed to provide users with the ability to search for nearby places such as malls, hospitals, schools, medical facilities, temples, and parks using live location data. Additionally, it offers insights into the crowd density of these areas through voice assistance. This project is tailored for a college setting, focusing on innovation and usability, primarily as a mobile application leveraging GPS and voice capabilities.

System Overview

The Scenic-Mall application aims to enhance user convenience by integrating live location searches with voice assistance. It provides real-time information about nearby places and their crowd density, helping users make informed decisions. The application is designed for mobile platforms, utilizing GPS for location tracking and voice recognition for user interaction.

Functional Requirements

• As a User, I should be able to search for nearby places like malls, hospitals, schools, medical facilities, temples, and parks using live location data.
• As a User, I should be able to receive information about the crowd density of these places.
• As a User, I should be able to interact with the application using voice commands to facilitate searches and receive information.

User Personas

• Student: A college student who uses the app to find nearby amenities and assess crowd levels for convenience and safety.
• Traveler: An individual visiting a new area who needs quick access to essential services and crowd information.
• Local Resident: A person living in the area who uses the app to plan visits to less crowded places.

Visuals Colors and Theme

• primary: #1A73E8 (a deep blue representing trust and reliability)
• primary_light: #E8F0FE (a light blue for hover states and secondary UI)
• secondary: #FF6F61 (a coral hue for emphasis and links)
• accent: #FFD700 (a vibrant gold for CTAs and active states)
• highlight: #FFA500 (a warm orange for hover states and notifications)
• bg: #FFFFFF (a clean white background)
• surface: rgba(240, 240, 240, 0.8) (a light grey for cards and panels)
• text: #333333 (a dark grey for primary text)
• text_muted: #777777 (a softer grey for secondary text)
• border: rgba(200, 200, 200, 0.5) (a subtle grey for borders)

Signature Design Concept

The Scenic-Mall app will feature an interactive 3D cityscape on the home page, where users can explore different areas by zooming in and out. Each building in the cityscape represents a category of places (e.g., malls, hospitals). Users can click on a building to view detailed information about nearby places and their crowd density. The cityscape will dynamically change based on the user's location, providing a personalized experience. This concept will be brought to life using @react-three/fiber for 3D rendering and gsap for smooth animations and transitions.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the app. Decorative elements like floating icons and animated paths will move at different speeds, enhancing the storytelling aspect. Internal pages will maintain a "static" layout for clarity and ease of use, focusing on delivering information quickly.

Non-Functional Requirements

• The application must be responsive and function seamlessly on various mobile devices.
• Voice recognition should have a high accuracy rate for understanding user commands.
• The app should provide real-time updates on location and crowd density.

Tech Stack

• Frontend: React Native for mobile app development
• Backend: Python with FastAPI for handling API requests
• Database: MongoDB for storing location and crowd data
• Mapping/Geospatial Data: OpenStreetMap for accurate and open-source map data
• AI Models: GPT 5.4 for user-friendly voice interactions
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker for containerization
• Server-side Orchestration: Kubernetes for managing deployment

Assumptions and Constraints

• The application assumes users have a stable internet connection for real-time data updates.
• GPS accuracy may vary based on the user's device and location.
• Voice recognition performance may be affected by background noise.

Glossary

• GPS: Global Positioning System, used for determining the user's location.
• Voice Assistance: Technology that allows users to interact with the app using voice commands.
• Crowd Density: A measure of how crowded a particular area is at a given time.