Warning This Project is no longer maintained, there might be vulnerabilities in dependencies! Use it at your own risk!

Warning Some of the docker images are incompatible with ARM architecture! You can use gitpod or github codesapaces, incase you own such device.

Warning Due to new Geolocation limitations from the Tehran geo physics center, only Iranian IPs can reach the API. Therefore you have to follow this guide to add earthquakes. Firstly you need to start database containers in development mode. Be sure you have docker and docker-compose.

cd docker # Changing the directory
sudo docker compose -f ./docker-compose.dev.yml up -d # Starting docker containers

Then you need to start a Prisma studio server. Keep in mind you need pnpm and node.js for the following commands. Open another terminal and run the following commands.

cd cronjob # Changing the directory
pnpm install # Installing dependencies 
pnpm run prisma-init # Initializing Prisma 
pnpm run prisma-generate # Generating Prisma schemas
pnpm run prisma-migrate-prod # Deploying initial migrations
pnpm run prisma-studio # Starting Prisma studio

Lastly, you can add the necessary data manually with the help of Prisma studio. After data insertion, close the Prisma studio by clicking left-control + C ( Windows and Linux ) or command + C on MacOS. Write the following commands on the first terminal to start the prod containers.

sudo docker compose -f ./docker-compose.dev.yml down # Stopping development containers
sudo docker compose -f ./docker-compose.prod.yml up -d # Starting production containers

You can use the following data, incase you can't access the original API.

Cities

name	nameFa	index	earthquakes
Ghaem shahr	قائم شهر	-	-
Meraveh tappe	مراوه تپه	-	-
Natanz	نطنز	-	-
Rabor	روبار	-	-
Ravar	راور	-	-

EarthQuakes

ID	state	reg	mag	dep	long	lat	date	city
0001	23	0	3.9	6	56.00	38.06	23:03-12T:00:00:00+00:00	Meraveh tappe
0002	20	0	2.2	25	57.09	29.16	23:03-11T:00:00:00+00:00	Rabor
0003	20	0	2.6	8	57.47	31.18	23:03-10T:00:00:00+00:00	Ravar
0004	26	0	2.5	21	52.93	36.50	23:03-09T:00:00:00+00:00	Ghaem Shahr
0005	3	0	3.4	10	51.88	33.54	23:03-03T:00:00:00+00:00	Natanz

I am deeply sorry for your incontinent.

Earthquake monitoring

About 🪪

This project is the final project of my bachelors of computer engineering program. The goal of the project is to help to distribute the earthquake information to the masses, therefore the project is designed to be scalable and reliable. Project has been built on reliable and battle tested solutions. Here are a short list of libraries in use in different parts of the application:

Web:

• mantine ( styled components for React )
• ajv ( schema validation )
• geolib ( utils for geo calculations )
• leaflet ( interactive maps )
• next
• rcode.react ( Generating Qr-codes )
• redis ( Client for Redis database )
• prisma ( Client for Postgres database )
• swr ( Providing Client side data fetching )

Mobile:

• mantine ( styled components for React )
• ajv ( schema validation )
• geolib ( utils for geo calculations )
• leaflet ( interactive maps )
• vite
• rcode.react ( Generating Qr-codes )
• prisma ( Generating types )
• swr ( Providing Client side data fetching )

Cronjob:

• prisma ( Client for Postgres database )
• fast-xml-parser ( Parsing Xml to json )

---

Development setup 💻

Requirements

• Node.js ( 18.7.0 or higher )
• pnpm ( 7.9.0 or higher )
• Docker ( 20.10.17 or higher )
• Docker compose ( 1.29.2 or higher )

development databases

you need to run the following commands to start databases in docker

cd /docker
# You might need to change "docker compose" to "docker-compose"
docker compose -f docker-compose.dev.yml up -d

Web development ( needs database to be online )

you need to run the following commands to start a development server:

cd /web
pnpm install # Installing dependencies
pnpm run init-prisma-schema # Generating prisma types
pnpm run prisma-migrate-dev # Applying schemas to database
pnpm run dev # Starting the development server

Mobile development ( needs web to be online )

you need to run the following commands to do the initial setup:

cd /mobile
pnpm install # Installing dependencies
pnpm run prisma-types # generating prisma types

Then you can start PWA development by the following command

pnpm run pwa-dev # Starting the development server

Or run the following command to start dev server with android env files

pnpm run android-dev # Starting the development server

Cronjob ( needs database to be online )

you need to run the following commands to start a development server:

cd /web
pnpm install # Installing dependencies
pnpm run init-prisma-schema # Generating prisma types
pnpm run prisma-migrate-dev # Applying schemas to database
pnpm run dev # Starting the development server

---

Hosting 🔥

software requirements:

• Docker ( 20.10.17 or higher )
• Docker compose ( 1.29.2 or higher )

Hardware requirements:

• Storage: 5G or more
• Ram: 512mg or more
• Cpu: 2cores or more

Guide

you need to run the following commands to start hosting server, keep in mind in case your server user is root, you need to make some changes in web Dockerfile. Before hosting your application you have to update couples of env files in compose.prod.yml, we recommend making a copy of the original file and applying your changes to the copied version.

cd /docker
cp  docker-compose.prod.yml docker-compose.local.yml # then update the new file and add your env files
# You might need to change "docker compose" to "docker-compose"
docker compose -f docker-compose.local.yml up -d

Building application

please read our guide in here