MapData App (a full-stack playground)

Welcome to the MapData Project: Your Full-Stack Playground! Hey there, developer! Are you ready to dive into a project that’s not just a learning experience but also a practical environment for full-stack Java and Angular development? Let me introduce you to the MapData Project, a modular system that’s perfect for managing map data and metadata while giving you the flexibility to explore multiple frameworks and tools. What’s the MapData Project? At its core, the MapData Project is a basic work environment for full-stack developers. It’s built around a microservices architecture with a backend API, a frontend Single Page Application (SPA), and utilities to manage the database and environment. Whether you’re a seasoned developer or just starting out, this project is a great way to get your hands dirty with modern tech. Here’s what’s included: mapdata-api: A RESTful API built to handle map data and metadata. It’s your backend powerhouse. mapdata-app: A sleek Angular-based frontend for user interaction. mapdata-db: Handles database schema creation and maintenance. mapdata-web: A lightweight frontend using pure HTML, CSS, and Vanilla JavaScript. mapdata-automations-python: Python scripts to automate and manage the environment. Oh, and did I mention? You can swap out frameworks! Want to try Quarkus instead of Spring Boot? React instead of Angular? Go for it! The project is designed to be flexible. The Tech Behind the Magic Let’s break it down: Java: The backend is built with Java, the go-to language for enterprise applications. It’s reliable, scalable, and integrates seamlessly with frameworks like Spring Boot or Quarkus. Angular: The frontend SPA is built with Angular, a powerful framework for creating dynamic, responsive web applications. Docker: Everything runs in containers, making deployment and environment management a breeze. Python: The automation scripts are written in Python, a versatile language that’s perfect for scripting and task automation. Vanilla JavaScript: For those who love simplicity, the mapdata-web component is a pure HTML/JS version of the frontend. How to Create the API and App Creating the API Clone the repository: git clone https://github.com/joaofelipefaria/mapdata.git cd mapdata/mapdata-api Build the project: mvn clean install Run the API: java -jar target/mapdata-api-0.0.1-SNAPSHOT.jar Creating the App Navigate to the app directory: cd mapdata/mapdata-app Install dependencies: npm install Run the app in development mode: ng serve Access the app at http://localhost:4200. What About the Database and Web? mapdata-db: This component manages the database schema. Just configure the pom.xml file and run: mvn clean install It’ll create all the necessary tables and sequences for you. mapdata-web: Want a simple frontend? This is your go-to. Just open the index.html file in your browser, and you’re good to go. Automations: Your New Best Friend Managing environments can be a pain, but not with mapdata-automations-python. These Python scripts let you start, stop, and manage Docker services with ease. For example: Start the environment: python run_env.py Shut everything down: python shutdown_env.py It’s that simple. No more manual Docker commands! Multiple Framework Choices One of the coolest things about the MapData Project is its flexibility. Want to try a different backend framework like Quarkus? Or maybe a frontend in React or Flutter? The project is modular, so you can experiment with different tech stacks without breaking a sweat. Ready to Dive In? The MapData Project is more than just a project—it’s a playground for full-stack developers. Whether you’re building something new or just exploring, this is the perfect environment to sharpen your skills. So, what are you waiting for? Clone the repo and start coding! GITHUB https://github.com/joaofelipefaria/mapdata

Mar 29, 2025 - 19:23

Welcome to the MapData Project: Your Full-Stack Playground!

Hey there, developer! Are you ready to dive into a project that’s not just a learning experience but also a practical environment for full-stack Java and Angular development? Let me introduce you to the MapData Project, a modular system that’s perfect for managing map data and metadata while giving you the flexibility to explore multiple frameworks and tools.

What’s the MapData Project?

At its core, the MapData Project is a basic work environment for full-stack developers. It’s built around a microservices architecture with a backend API, a frontend Single Page Application (SPA), and utilities to manage the database and environment. Whether you’re a seasoned developer or just starting out, this project is a great way to get your hands dirty with modern tech.

Here’s what’s included:

mapdata-api: A RESTful API built to handle map data and metadata. It’s your backend powerhouse.
mapdata-app: A sleek Angular-based frontend for user interaction.
mapdata-db: Handles database schema creation and maintenance.
mapdata-web: A lightweight frontend using pure HTML, CSS, and Vanilla JavaScript.
mapdata-automations-python: Python scripts to automate and manage the environment.

Oh, and did I mention? You can swap out frameworks! Want to try Quarkus instead of Spring Boot? React instead of Angular? Go for it! The project is designed to be flexible.

The Tech Behind the Magic

Let’s break it down:

Java: The backend is built with Java, the go-to language for enterprise applications. It’s reliable, scalable, and integrates seamlessly with frameworks like Spring Boot or Quarkus.
Angular: The frontend SPA is built with Angular, a powerful framework for creating dynamic, responsive web applications.
Docker: Everything runs in containers, making deployment and environment management a breeze.
Python: The automation scripts are written in Python, a versatile language that’s perfect for scripting and task automation.
Vanilla JavaScript: For those who love simplicity, the mapdata-web component is a pure HTML/JS version of the frontend.

How to Create the API and App

Creating the API

Clone the repository:

   git clone https://github.com/joaofelipefaria/mapdata.git
   cd mapdata/mapdata-api

Build the project:

   mvn clean install

Run the API:

   java -jar target/mapdata-api-0.0.1-SNAPSHOT.jar

Creating the App

Navigate to the app directory:

   cd mapdata/mapdata-app

Install dependencies:

   npm install

Run the app in development mode:

   ng serve

Access the app at http://localhost:4200.

What About the Database and Web?

mapdata-db: This component manages the database schema. Just configure the pom.xml file and run:

   mvn clean install

It’ll create all the necessary tables and sequences for you.

mapdata-web: Want a simple frontend? This is your go-to. Just open the index.html file in your browser, and you’re good to go.

Automations: Your New Best Friend

Managing environments can be a pain, but not with mapdata-automations-python. These Python scripts let you start, stop, and manage Docker services with ease. For example:

Start the environment:

   python run_env.py

Shut everything down:

   python shutdown_env.py

It’s that simple. No more manual Docker commands!

Multiple Framework Choices

One of the coolest things about the MapData Project is its flexibility. Want to try a different backend framework like Quarkus? Or maybe a frontend in React or Flutter? The project is modular, so you can experiment with different tech stacks without breaking a sweat.

Ready to Dive In?

The MapData Project is more than just a project—it’s a playground for full-stack developers. Whether you’re building something new or just exploring, this is the perfect environment to sharpen your skills. So, what are you waiting for? Clone the repo and start coding!

GITHUB

https://github.com/joaofelipefaria/mapdata