SSTRACK

Overview
This document outlines the development of a mobile application designed to track user location, time, and distance traveled. The application includes features to start and stop tracking, periodically store tracking data to a database via an API, and ensures data is collected at regular intervals when tracking is active.


Packages
Finalized Package List:
@react-native-async-storage/async-storage
@react-native-community/geolocation
@react-native-masked-view/masked-view
@react-navigation/bottom-tabs
@react-navigation/native
@react-navigation/native-stack
@react-navigation/stack
haversine
jwt-decode
react-native-background-actions
react-native-background-timer
react-native-base64
react-native-chart-kit
react-native-circular-progress-indicator
react-native-geocoding
react-native-geolocation-service
react-native-gesture-handler
react-native-gifted-charts
react-native-image-picker
react-native-maps
react-native-permissions
react-native-reanimated
react-native-screens
react-native-sensors
react-native-shake
react-native-svg-transformer
react-native-vector-icons
react-native-vision-camera


Engines
Node.js
Version: >=18
Description: The application requires Node.js version 18 or higher.

Screens and there function


Home Screen
The Home screen in the application serves as the main interface for initiating and managing location tracking sessions. It provides functionalities to start and stop tracking, display the user's current location on a map, and track elapsed time and distance traveled during the session.
Functions
readData
Description: Reads the user's token from AsyncStorage for authentication purposes.
handleStartTracker
Description: Initiates the tracking session by sending a POST request to the backend API to start tracking the user's location.
handlePauseTracker
Description: Pauses the tracking session by sending a POST request to the backend API to stop tracking the user's location temporarily.
handleUpdateLocations
Description: Updates the user's current location by sending a POST request to the backend API with updated latitude, longitude, and location ID.
calculateDistance
Description: Calculates the distance between two geographical coordinates using the Haversine formula.
startForegroundLocationUpdates
Description: Starts updating the user's location in the foreground at regular intervals using the device's geolocation service.
stopForegroundLocationUpdates
Description: Stops updating the user's location in the foreground and clears the interval set for location updates.
startLocationTracking
Description: Initiates location tracking by starting foreground location updates and setting up a timer to track elapsed time.
stopLocationTracking
Description: Stops location tracking by stopping foreground location updates, calculating distance traveled, and sending the final tracking data to the backend API.




Timeline Screen
Functions
readData
Description: Reads the user's token from AsyncStorage for authentication purposes.
calculateTotalDistance
Description: Calculates the total distance traveled based on the tracking sessions data.
useEffect
Description: Invokes the readData function on component mount to fetch tracking data.




Activity Screen
Functions

toggleShow1
Description: Toggles the visibility of the dropdown menu for selecting the year.
toggleShow2
Description: Toggles the visibility of the dropdown menu for selecting the month.
toggleShow3
Description: Toggles the visibility of the dropdown menu for selecting the day.
setDay
Description: Sets the selected day for viewing activity data.
setMonth
Description: Sets the selected month for viewing activity data.
setYear
Description: Sets the selected year for viewing activity data.


Profile Screen
Functions
getToken
Description: Fetches the user's authentication token from AsyncStorage.
toggleIsLogin
Description: Toggles the user's login status.
toggleUserLoginStatus
Description: Toggles the user's login status and updates AsyncStorage accordingly.