Skip to content

keithaumiller/safesense.world

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SafeSense.World

A comprehensive safety and crime awareness application with geolocation tracking and intelligent alert notifications.

Project Overview

SafeSense.World is designed to provide users with real-time safety information and crime rate awareness based on their location. The application uses geofencing technology to detect significant changes in crime rates and provide timely notifications to keep users informed about their surroundings.

Key Features

  • Geolocation Tracking: 5-minute interval location tracking
  • Crime Rate Analysis: County-level crime rate data integration
  • Geofence Alerts: Notifications when crime rates change by >5% upon crossing geofences
  • Firebase Backend: Real-time data synchronization and user management
  • Push Notifications: Consistent alert delivery system
  • Emergency Alert Integration: County-level emergency notifications

Architecture

This repository contains two complete implementations of the SafeSense.World application:

1. Native Android Implementation (implementations/native-android/)

A native Android application built with Java and Gradle.

Technology Stack:

  • Java
  • Android SDK
  • Gradle build system
  • Firebase integration
  • Google Maps API

Key Features:

  • Native Android performance
  • Advanced mapping capabilities
  • Optimized for Android devices
  • Direct integration with Android services

Getting Started:

cd implementations/native-android
./gradlew build
./gradlew installDebug

2. React Native Implementation (implementations/react-native/)

A cross-platform mobile application built with React Native.

Technology Stack:

  • React Native 0.64.1
  • JavaScript/TypeScript
  • Firebase SDK
  • React Navigation
  • Background Geolocation
  • Push Notifications

Key Dependencies:

  • @react-native-firebase/app - Firebase integration
  • @mauron85/react-native-background-geolocation - Background location tracking
  • react-native-push-notification - Push notification system
  • @react-navigation/native - Navigation system

Getting Started:

cd implementations/react-native
npm install
# For Android
npm run android
# For iOS
npm run ios

Backend Infrastructure

Firebase Services

  • Authentication: User registration and login
  • Firestore Database: Real-time data storage
  • Cloud Messaging: Push notification delivery
  • Analytics: User behavior tracking

Firebase Console: https://console.firebase.google.com/project/safesenseworld/overview

Client-Side Requirements

  1. Authentication & Registration

    • Branded user interface
    • Secure user registration and login
    • Session management
  2. Background Services

    • Geolocation retrieval every 5 minutes
    • Automatic data submission to Firebase
    • Battery-optimized background processing
  3. Alert System

    • Message queue retrieval from Firebase
    • Real-time alert display
    • Notification sound and vibration

Development Roadmap

Phase 1: Core Functionality ✅

  • Basic geolocation tracking
  • Firebase backend setup
  • User authentication
  • Push notification system

Phase 2: Enhanced Features

  • County-level crime rate integration
  • Sophisticated risk index model
  • Enhanced notification algorithms
  • Performance optimizations

Phase 3: Production Release

  • App store deployment (Android & iOS)
  • User testing and feedback integration
  • Analytics and monitoring setup
  • Performance optimization

Phase 4: Scaling & Growth

  • Funding and investment rounds
  • Additional data source integration
  • Advanced ML models for risk prediction
  • Agile development methodology implementation

Contributing

This project uses a standard ticketing/agile methodology for development. Please refer to the project board for current development priorities and feature requests.

Data Sources

  • County-level crime statistics
  • Emergency alert systems
  • Geofencing data
  • Real-time location services

Security & Privacy

  • End-to-end encryption for sensitive data
  • Privacy-compliant location tracking
  • Secure authentication protocols
  • GDPR and privacy regulation compliance

License

[Specify license information]

Contact

For questions about development, funding, or partnerships, please contact Keith Aumiller.


Last updated: October 2025

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published