{"id":21593625,"url":"https://github.com/University-Experience/EcoTrack","last_synced_at":"2025-07-17T01:31:58.007Z","repository":{"id":218076904,"uuid":"745532528","full_name":"BaraSedih11/EcoTrack","owner":"BaraSedih11","description":"Platform using RESTful APIs (Mysql, Nodejs, Express)","archived":false,"fork":false,"pushed_at":"2024-05-22T23:06:32.000Z","size":223,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-22T23:29:16.187Z","etag":null,"topics":["express","mysql","nodejs","postman","software-engineering"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BaraSedih11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-01-19T14:42:27.000Z","updated_at":"2024-05-22T23:06:35.000Z","dependencies_parsed_at":"2024-03-03T09:31:09.282Z","dependency_job_id":"34ee44d5-e831-4ee1-8068-36d53c5b6bd3","html_url":"https://github.com/BaraSedih11/EcoTrack","commit_stats":null,"previous_names":["barasedih11/echotrack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaraSedih11%2FEcoTrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaraSedih11%2FEcoTrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaraSedih11%2FEcoTrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaraSedih11%2FEcoTrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BaraSedih11","download_url":"https://codeload.github.com/BaraSedih11/EcoTrack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226193696,"owners_count":17588179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["express","mysql","nodejs","postman","software-engineering"],"created_at":"2024-11-24T17:13:46.428Z","updated_at":"2025-07-17T01:31:52.681Z","avatar_url":"https://github.com/BaraSedih11.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/BaraSedih11/EcoTrack/assets/98843912/9086ea16-4349-4efd-8c4c-bce1c571c29f\" width=500px/\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n  \n ![GitHub repo size](https://img.shields.io/github/repo-size/BaraSedih11/EcoTrack) ![GitHub repo file count (file type)](https://img.shields.io/github/directory-file-count/BaraSedih11/EcoTrack) ![NPM Version](https://img.shields.io/npm/v/npm) ![GitHub last commit (branch)](https://img.shields.io/github/last-commit/BaraSedih11/EcoTrack/main)\n\n\u003c/div\u003e  \n\n\u003ch1\u003eEnvironmental Monitoring and Reporting Platform\u003c/h1\u003e\nEcoTrack is a cutting-edge platform for environmental reporting and monitoring; it manages the distribution of environmental data and modifies it. This platform, a backend API built with Node.js, was developed to provide a robust framework for user interaction, data collection, and insightful reporting to satisfy the growing need for all-encompassing environmental solutions.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Project Folders](#project-folders)\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Getting Started](#getting-started)\n- [API Documentation](#api-documentation)\n- [Testing](#testing)\n- [Vision](#vision)\n\n\n## Introduction\n\nEcoTrack serves as a robust backend API designed to handle environmental data collection, user profile management, environmental alerts, community reporting, sustainability scoring, educational resources provision, and open data access for researchers and organizations. It's a platform aimed at promoting environmental awareness, facilitating data sharing, and encouraging sustainable practices.\n\n## Features\n\n### Main Features:\n\n1. **Data Collection:** Enables users to submit environmental data from various sources like IoT sensors, manual observations, or data uploads.\n2. **User Profiles:** Users can create and manage profiles to track contributions and connect with others.\n3. **Environmental Alerts:** Notification system for significant changes or concerning trends in environmental data.\n4. **Community Reporting:** Allows users to report environmental issues such as pollution, deforestation, or wildlife endangerment.\n5. **Sustainability Score:** A scoring system assessing users' environmental contributions and sustainability efforts.\n6. **Educational Resources:** Provides articles and guides on environmental topics to raise awareness and educate users.\n7. **Open Data Access:** Offers APIs for researchers, scientists, and organizations to access aggregated environmental data for research and analysis.\n\n### Additional Features:\n\n- **Socket.IO Integration:** bidirectional communication between clients and server.\n- **External API Integration:** Utilized to enhance functionality and supplement data collection.\n\n## Technologies Used\n\n- **Node.js:** Backend development platform.\n- **Socket.IO:** Real-time communication for alerts.\n- **MySQL:** Database for CRUD operations.\n- **Postman:** API building, testing and documentation tool.\n- **Git:** Version control system.\n- **Axios:** making and managing HTTP requests.\n\n## Getting Started\n\nTo get started with EcoTrack API, follow these steps:\n\n1. Clone the repository: `git clone https://github.com/AdvancedSoftwareTeam/EcoTrack.git` \n2. Install dependencies: `npm install`\n3. Configure environment variables.\n4. Setup the database using mysql ( sql code is inside database folder ).\n5. Run the application: `npm start`\n\n## API Documentation\n\nThe API is fully documented using Postman. Access the documentation [here](https://documenter.getpostman.com/view/29528140/2s9YkuZyR9).\n\n## Testing\n\n#### Postman Testing Strategy\n\nWe have employed Postman for comprehensive API testing to ensure the functionality, reliability, and accuracy of the EcoTrack platform. Our testing strategy involves:\n\n- **Automated Tests:** Writing automated test scripts within Postman to perform API endpoint testing, covering scenarios for data submission, user profile management, environmental alerts, community reporting, and more.\n- **Environment Setup:** Configuring different environments within Postman to simulate various conditions and perform thorough testing.\n- **Collection Runs:** Executing collection runs in Postman to validate endpoints, data validations, authentication mechanisms, and error handling.\n\n**Instructions for Testing Using Postman:**\n\n1. Import the provided Postman collection.\n2. Set up the necessary environment variables, choose the *EcoTrack Env*.\n3. Run collection tests individually or perform a collection run to test various API endpoints.\n\n#### Demo \n\nclick on the following link to watch the testing [demo video](https://drive.google.com/file/d/1IhVZ-JUvbNWw50SRC-YMC2zegsws5C2s/view?usp=sharing).\n\n## Vision\n\nEcoTrack strives to be more than a data platform—it's a catalyst for change. Through collaboration, awareness, and informed decisions, it spearheads environmental initiatives, empowering global communities and organizations.\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUniversity-Experience%2FEcoTrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUniversity-Experience%2FEcoTrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUniversity-Experience%2FEcoTrack/lists"}