DEV Community: joaofelipefaria

[FR] MapData App (un terrain de jeu full-stack)

joaofelipefaria — Sat, 29 Mar 2025 17:42:34 +0000

Bienvenue dans le Projet MapData : Votre Terrain de Jeu Full-Stack !

Salut, développeur ! Prêt à plonger dans un projet qui n'est pas seulement une expérience d'apprentissage, mais aussi un environnement pratique pour le développement full-stack avec Java et Angular ? Laissez-moi vous présenter le Projet MapData, un système modulaire parfait pour gérer les données cartographiques et les métadonnées, tout en vous offrant la flexibilité d'explorer plusieurs frameworks et outils.

Qu'est-ce que le Projet MapData ?

Le Projet MapData est avant tout un environnement de travail de base pour les développeurs full-stack. Il repose sur une architecture de microservices avec une API backend, une application frontend Single Page Application (SPA) et des utilitaires pour gérer la base de données et l'environnement. Que vous soyez un développeur expérimenté ou débutant, ce projet est une excellente opportunité pour explorer les technologies modernes.

Voici ce qui est inclus :

mapdata-api : Une API RESTful pour gérer les données cartographiques et les métadonnées.
mapdata-app : Une application frontend élégante basée sur Angular pour l'interaction utilisateur.
mapdata-db : Gère la création et la maintenance du schéma de la base de données.
mapdata-web : Une version frontend légère utilisant HTML, CSS et JavaScript pur.
mapdata-automations-python : Scripts Python pour automatiser et gérer l'environnement.

Et le meilleur ? Vous pouvez changer les frameworks ! Vous voulez essayer Quarkus au lieu de Spring Boot ? React au lieu de Angular ? Allez-y ! Le projet est conçu pour être flexible.

La Technologie Derrière la Magie

Voici un aperçu rapide :

Java : Le backend est construit avec Java, le langage incontournable pour les applications d'entreprise. Fiable, évolutif et parfaitement intégré avec des frameworks comme Spring Boot ou Quarkus.
Angular : Le frontend SPA est construit avec Angular, un framework puissant pour créer des applications web dynamiques et réactives.
Docker : Tout fonctionne dans des conteneurs, ce qui simplifie le déploiement et la gestion de l'environnement.
Python : Les scripts d'automatisation sont écrits en Python, une langue polyvalente idéale pour les tâches d'automatisation.
JavaScript Pur : Pour ceux qui aiment la simplicité, le composant mapdata-web est une version frontend pure en HTML/JS.

Comment Créer l'API et l'Application

Création de l'API

Clonez le dépôt :

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

Construisez le projet :

   mvn clean install

Lancez l'API :

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

Création de l'Application

Accédez au répertoire de l'application :

   cd mapdata/mapdata-app

Installez les dépendances :

   npm install

Lancez l'application en mode développement :

   ng serve

Accédez à l'application à l'adresse http://localhost:4200.

Et la Base de Données et le Web ?

mapdata-db : Ce composant gère le schéma de la base de données. Configurez simplement le fichier pom.xml et exécutez :

   mvn clean install

Cela créera toutes les tables et séquences nécessaires.

mapdata-web : Vous voulez un frontend simple ? C'est celui qu'il vous faut. Ouvrez simplement le fichier index.html dans votre navigateur, et c'est parti.

Automatisation : Votre Nouveau Meilleur Ami

Gérer les environnements peut être compliqué, mais pas avec mapdata-automations-python. Ces scripts Python vous permettent de démarrer, arrêter et gérer les services Docker facilement. Par exemple :

Démarrez l'environnement :

   python run_env.py

Arrêtez tout :

   python shutdown_env.py

C'est aussi simple que ça. Plus besoin de commandes Docker manuelles !

Prêt à Vous Lancer ?

Le Projet MapData est bien plus qu'un simple projet : c'est un terrain de jeu pour les développeurs full-stack. Que vous construisiez quelque chose de nouveau ou que vous exploriez simplement, c'est l'environnement parfait pour affiner vos compétences. Alors, qu'attendez-vous ? Clonez le dépôt et commencez à coder !

GITHUB

https://github.com/joaofelipefaria/mapdata

MapData App (a full-stack playground)

joaofelipefaria — Sat, 29 Mar 2025 17:36:38 +0000

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