Welcome to the SafeTrack Web Application! This platform is designed to streamline Public Health Inspections (PHI) workflows in Sri Lanka, transitioning from outdated, paper-based systems to a fully digital, real-time solution for food safety inspections. The application offers real-time data entry, instant reporting, and complete digital record management, allowing PHIs to focus on what matters mostβensuring public health and safety.
π Figma Design Link
π Project Proposal Link
π Features Document Link
π Advanced User Manual Link
- Project Overview
- Problem Statement
- Proposed Solution
- Key Features
- Technology Stack
- Innovation & Uniqueness
- Feasibility & Implementation
- Impact & Benefits
- Team Members
- Additional Information
- Future Implementations
- Installation and Setup
- Contributing
- License
SafeTrack modernizes food safety inspection processes for Public Health Inspectors (PHIs) in Sri Lanka. This web application simplifies inspections by digitizing the entire process, offering PHIs a seamless, real-time platform to input data, track violations, and generate reports instantly, all from a user-friendly interface.
In Sri Lanka, Public Health Inspectors are burdened with a time-consuming and inefficient paper-based system:
- Manual Data Entry: A significant amount of time is spent on paper forms, leading to inefficiencies.
- Limited Accessibility: Past records are difficult to access, and data entry errors frequently occur.
- Cumbersome Record-Keeping: PHIs are required to carry large volumes of paperwork, which can be easily lost or damaged.
- Delayed Reporting: Lack of real-time reporting capabilities reduces operational speed.
- Lost Violations: Complaints or violations often get buried in paperwork, resulting in delayed action.
SafeTrack offers a modern, digital solution to streamline and optimize the inspection process:
- Instant Data Entry: PHIs can input inspection data directly into the platform, eliminating paper forms.
- Real-Time Tracking: Automated scheduling and tracking ensure inspections are always on schedule.
- Digital Records: All data is stored securely in the cloud, easily accessible at any time.
- Instant Reporting: Real-time, automated reporting offers valuable insights into compliance and trends.
- Efficient Complaint Management: Complaints are recorded and tracked for swift resolution.
- User-Friendly Interface: A clean, simple dashboard for efficient inspection management.
- Shop Management: Database of food establishments, inspection history, and compliance status.
- Digital Inspection Forms: Automated validation of digitized forms like HC 800 and Sandeeshaya.
- Task Scheduling: Schedule inspections, track follow-ups, and ensure compliance.
- Analytics and Reporting: Real-time reporting on food safety trends, violation tracking, and more.
- User Profile Management: PHIs can manage their profiles and inspect historical data.
- Frontend: React.js β A modern, fast, and interactive JavaScript library for building responsive UIs.
- Backend: Node.js with Express.js β Scalable server-side architecture to handle high data loads.
- Database: MongoDB β Flexible, scalable NoSQL database to manage inspection data.
- Authentication: Firebase Authentication β Secure user management and authentication.
- Deployment: Hosted on Netlify for seamless cloud-based deployment and auto-scaling.
- EOMIJS Optimization: Emphasis on Efficient Operations and Modern Interfaces (EOMIJS), optimizing data flow and enhancing user experience through modern JavaScript features, asynchronous programming, and performance enhancements.
SafeTrack stands out with the following unique features:
- Centralized Data Management: Everything is stored digitally, providing instant access to all records.
- Real-Time Reporting: Real-time data analysis and report generation, improving decision-making and transparency.
- Paperless Inspections: PHIs no longer need to carry physical documents, reducing overhead.
- Scalable Architecture: Built to scale as the user base and inspection volume grow.
- Technical Feasibility: Utilizes modern, reliable technologies that are well-supported, ensuring long-term sustainability.
- Scalability: MongoDBβs NoSQL database architecture is highly scalable and can handle increased inspection volumes effortlessly.
- Environmental Impact: By digitizing inspections, SafeTrack significantly reduces paper consumption, contributing to sustainability.
For PHIs:
- Reduced Time on Paperwork: Allows PHIs to focus on inspections rather than data entry.
- Faster Reporting: Immediate, automated reporting for faster decision-making and enforcement.
For Food Establishments:
- Transparency: Real-time access to inspection results ensures fair treatment.
- Streamlined Compliance: Ensures that food establishments stay compliant with safety regulations.
For Public Health:
- Improved Safety: Faster response to violations ensures better protection of public health.
- Public Trust: Transparency in the inspection process builds trust with the public.
- Senesh Fitzroy - Team Leader
- Nipuni Ariyathilaka
- Maleesha Devindi
- Pasindu Piyumika
- Duleesha Jayangani
- Collaboration with PHIs: SafeTrack was developed in consultation with Sri Lankan PHIs, ensuring the platform addresses real-world challenges.
- Scalable for Future Growth: Designed with future expansion in mind, SafeTrack can easily scale to include new regions or features.
- Admin Dashboard: A comprehensive admin panel for managing settings, users, and system activity.
- Geo-Tagging: Integration for tracking inspection locations.
- Photo Uploads: Ability to capture and store images during inspections for more detailed reports.
- Predictive Reporting: Use machine learning to predict potential violations.
- Offline Functionality: Record inspections offline and sync when connectivity is restored.
To get started with SafeTrack, follow the steps below:
git clone https://github.com/SeneshFitzroy/SafeTrack-Web-Application.git
cd safetrack-frontendnpm installCreate a .env file in the root directory with the following configuration:
# API Configuration
REACT_APP_API_URL=http://localhost:5001
REACT_APP_FRONTEND_URL=http://localhost:3000
# MongoDB Configuration
PORT=5001
MONGODB_URI=your_mongodb_connection_string
# JWT Configuration
JWT_SECRET=your_secure_jwt_secret
# OpenAI Configuration (if using AI features)
REACT_APP_OPENAI_API_KEY=your_openai_api_key
cd backend
node server.jsnpm startThe application will launch at http://localhost:3000.
We encourage contributions from the community:
- Fork the repository to your GitHub account.
- Create a new branch:
git checkout -b new-feature
- Make your changes, then commit:
git commit -m "Implement new feature" - Push to your fork:
git push origin new-feature
- Open a pull request to merge changes into the main repository.
This project is licensed under the Apache 2.0 License. See the LICENSE file for details.
The SafeTrack web application is deployed and hosted on Netlify for fast, reliable performance. Visit the live version here:
π SafeTrack Live