https://github.com/smdthiranjaya/geo-360-Server
https://github.com/smdthiranjaya/Geo-360
https://www.geo360live.tech/api-docs/#/
Geo-360 Server is a backend service designed to provide comprehensive geographical data processing capabilities. Built with Node.js and Express, it leverages several key technologies including CORS, dotenv for environment variable management, node-fetch for making HTTP requests, nodemailer for email sending functionalities, PostgreSQL (pg) for database management, and Swagger for API documentation.
To develop a single-page application (SPA) and RESTful Web API that provide real-time weather updates (temperature, humidity, air pressure, wind speed) for Sri Lanka, enhancing the current weather information system.
Scope
- RESTful API: To serve real-time weather data.
- SPA: Interactive map displaying live weather data.
- Data Simulation: Use generated data for system testing.
- Cloud Deployment: Ensure scalability and accessibility.
- Security & Testing: Implement security measures and conduct thorough testing.
Explores the need for a real-time weather mapping system to improve upon Sri Lanka’s Department of Meteorology’s existing three-hour update cycle, utilizing IoT for live data on temperature, humidity, and air pressure across the island.
Details the design principles of a RESTful API and a React-based Single Page Application (SPA) to meet the project's goals, including data flow and user interaction.
Describes the technical architecture encompassing the backend server on Heroku, database integration using Heroku’s PostgreSQL, frontend deployment on Azure, domain management, and use of GitHub Actions for CI/CD.
Provides specifics on the REST API development with Node.js, including the use of Express, CORS, and other packages for backend functionality, along with Swagger for API documentation. Live Map Single Page Application (SPA) Implementation Outlines the creation of the React SPA using packages like Leaflet for mapping, detailing how the application consumes the API and presents data dynamically.
Discusses the use of Heroku's PostgreSQL for data storage and management, and Azure Web App Service for SPA hosting, ensuring a scalable cloud-based environment.
These instructions will get your copy of the project up and running on your local machine for development and testing purposes.
Before you begin, ensure you have Node.js and npm (Node Package Manager) installed on your machine. If not, you can download and install them from Node.js official website.
A step-by-step series of examples that tell you how to get a development env running.
First, clone the repository to your local machine:
git clone https://github.com/smdthiranjaya/geo-360-Server.git
cd geo-360-server
To start the server, run:
npm start
Once the server is running, you can access the Swagger UI for the API documentation by navigating to https://www.geo360live.tech/api-docs, where {PORT} is your server's running port.