layout	permalink	repository-name	title
home	index.html	e21-co227-Crowd-Balance-Mobile-App	EngEx Crowd Balance Mobile App

EngEx Crowd Balance Mobile App

---

Table of Contents

1. Introduction
2. Key Features
3. Software Architecture
4. Deployment
5. User Manual
6. Team
7. Links

---

Introduction

A smart crowd management mobile app developed for the 75th Anniversary Exhibition (PeraVerse) at the University of Peradeniya. The EngEx Crowd Balance Mobile App offers real-time crowd monitoring, missing person alerts, car park tracking, and AI chatbot support to ensure efficient event management.

Project Goals:

• Efficiently monitor and manage crowd flow across the exhibition
• Quickly locate and assist missing persons
• Ensure smooth communication between organizers and main panel
• Optimize car park and hall usage to prevent overcrowding
• Provide real-time data to improve decision-making during the event

Technology Stack: React Native, Expo, MongoDB, Express.js, and Node.js

Key Features

1. Real-Time Crowd Management System

The app supports two types of users: Organizers and Main Panel.

• Update Current Crowd Status (Organizers): Organizers can instantly update crowd status based on current conditions at their assigned locations.

• Assign Organizers to High-Crowded Areas (Main Panel): The main panel receives real-time crowd data and can efficiently assign available organizers to specific locations based on current needs.

• Send Actionable Notifications: The system directly notifies organizers of their new location assignments and critical crowd levels, prompting rapid and informed responses.

2. Missing Person Alert System

• Create Missing Person Alerts: Any authorized user can create a new missing person alert by filling in crucial details including:

  • Name, Age, Gender
  • Last seen location
  • Photo (optional)
  • Description summary (optional)

• Real-Time Alert Display: Once created, the alert is immediately visible to all teams, displaying the person's details and last known location.

• Mark as Found: With a single tap, users can mark the person as "FOUND," instantly closing the alert loop and notifying all relevant parties.

3. Car Park Management System

• Real-Time Status Dashboard: Gain instant visibility into the real-time status of all parking areas, clearly showing capacity and availability for each lot.

• Update Car Park Count (Organizers): Organizers on the ground can quickly adjust vehicle counts using '+' and '-' buttons as cars enter and exit, ensuring accurate status updates and preventing overcrowding.

• Add and Remove Car Parks (Main Panel): The main panel can dynamically manage parking areas based on exhibition requirements.

4. AI Chatbot (Web App Feature)

• Instant Support: Provides instant access to critical event information through a built-in chatbot powered by n8n workflow automation.
• Knowledge Base Assistant: Capable of answering common questions such as event schedules, location details, and general exhibition information.

Software Architecture

Three-Tier Architecture

Frontend (React Native + Expo):

• Interactive dashboards for organizers and main panel users
• File-based navigation using Expo Router for clean, maintainable routing
• Styling with TailwindCSS core utility classes

Backend (Node.js + Express.js):

• RESTful API handling logic, authentication, and data flow
• MVC (Model-View-Controller) architecture pattern for organized, maintainable, and scalable code
• Hosted on Microsoft Azure for reliable performance

Database (MongoDB Atlas):

• Cloud-based, secure data storage

Deployment

Mobile App

• Platform: Built using Expo
• Availability:
  • Android APK (fully built and tested)
  • Expo Go client (iOS and Android)

Download Android APK:

DOWNLOAD APP
Click here to Download the APK

Scan QR to Download the APK

Note: iOS deployment was successfully tested via Expo Go app, but a dedicated iOS IPA was not built due to platform constraints and limitations.

Backend

• Hosting: Microsoft Azure (Students)

API Documentation

• Postman Collection: API Documentation

Database

• Service: MongoDB Atlas (cloud-based, managed database)

User Manual

Download the complete user manual:

Download User Manual

Click the link above to access the complete user manual with step-by-step instructions for using the EngEx Crowd Balance Mobile App.

Team

• E/21/444, Wijesinghe R.M.S.D, [email protected]
• E/21/045, Baines S.M, [email protected]
• E/21/065, Chamod S.A.R, [email protected]
• E/21/277, Padukka V.K, [email protected]

Supervisors

• Ms. Yasodha Vimukthi, [email protected]

Links

• Project Repository
• [Project Page](https://cepdnaclk.github.io/{{ page.repository-name}}){:target="_blank"}
• Department of Computer Engineering
• University of Peradeniya