{"id":20094418,"url":"https://github.com/dbacilio88/archetype-api-microservices","last_synced_at":"2025-05-06T04:32:35.535Z","repository":{"id":244288724,"uuid":"814390050","full_name":"dbacilio88/archetype-api-microservices","owner":"dbacilio88","description":"archetype-api-microservices","archived":false,"fork":false,"pushed_at":"2024-12-21T19:42:05.000Z","size":112,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T08:39:37.542Z","etag":null,"topics":["archetype","contibution","gradle","ideas","java","maven","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dbacilio88.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2024-06-12T23:24:33.000Z","updated_at":"2024-12-21T19:40:20.000Z","dependencies_parsed_at":"2024-11-11T18:26:49.780Z","dependency_job_id":"bee4ba13-ae91-4913-ad5c-9ed2b2f454fe","html_url":"https://github.com/dbacilio88/archetype-api-microservices","commit_stats":null,"previous_names":["dbacilio88/archetype-api-microservices"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbacilio88%2Farchetype-api-microservices","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbacilio88%2Farchetype-api-microservices/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbacilio88%2Farchetype-api-microservices/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbacilio88%2Farchetype-api-microservices/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbacilio88","download_url":"https://codeload.github.com/dbacilio88/archetype-api-microservices/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252622567,"owners_count":21778017,"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":["archetype","contibution","gradle","ideas","java","maven","spring-boot"],"created_at":"2024-11-13T16:50:39.812Z","updated_at":"2025-05-06T04:32:35.528Z","avatar_url":"https://github.com/dbacilio88.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Discord](https://img.shields.io/discord/738601834096099409)](https://discord.gg/cwpS3acj)\n[![GitHub commit activity](https://img.shields.io/github/commit-activity/t/dbacilio88/archetype-api-microservices)](https://github.com/dbacilio88/archetype-api-microservices/graphs/commit-activity)\n[![GitHub forks](https://img.shields.io/github/forks/dbacilio88/archetype-api-microservices?style=social)](https://github.com/dbacilio88/archetype-api-microservices/forks)\n[![GitHub Release](https://img.shields.io/github/v/release/dbacilio88/archetype-api-microservices)](https://github.com/dbacilio88/archetype-api-microservices/releases)\n[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/dbacilio88/archetype-api-microservices/ci.yml)](https://github.com/dbacilio88/archetype-api-microservices/actions)\n[![GitHub contributors](https://img.shields.io/github/contributors/dbacilio88/archetype-api-microservices)](https://github.com/dbacilio88/archetype-api-microservices/graphs/contributors)\n[![GitHub License](https://img.shields.io/github/license/dbacilio88/archetype-api-microservices)](https://github.com/dbacilio88/archetype-api-microservices/blob/master/LICENSE)\n\n\n# 🎯 archetype-api-microservices\n\n\u003c!-- TOC --\u003e\n* [🎯 archetype-api-microservices](#-archetype-api-microservices)\n* [🧩 Descripción general](#-descripción-general)\n* [🔖 Características](#-características)\n  * [📋 Requisitos](#-requisitos)\n* [🪛 Crear un proyecto](#-crear-un-proyecto)\n  * [📀 Instalación](#-instalación)\n  * [💻 Construir en Terminal bash](#-construir-en-terminal-bash)\n  * [🖥️ Construir en Terminal cmd](#-construir-en-terminal-cmd)\n  * [🧮 Estructura del proyecto](#-estructura-del-proyecto)\n  * [🔧 Tecnologías Usadas](#-tecnologías-usadas)\n  * [⚙️ Configuración rápida](#-configuración-rápida)\n  * [🧰 Integración de dependencias](#-integración-de-dependencias)\n  * [📦 Ejemplo de código](#-ejemplo-de-código)\n* [🧪 Uso](#-uso)\n* [👨🏻‍💻 Contribuciones](#-contribuciones)\n* [📞 Contacto](#-contacto-)\n\u003c!-- TOC --\u003e\n\n# 🧩 Descripción general\n\nEste arquetipo proporciona una estructura básica para iniciar proyectos en Java utilizando el framework Spring. Está\ndiseñado para facilitar el desarrollo rápido y eficiente de aplicaciones rest.\n\n# 🔖 Características\n\n## 📋 Requisitos\n\nAsegúrate de tener instalado:\n\n- Java OpenJDK 21\n- Maven 3.6 o superior\n- Git\n\n| Herramienta  | Version | Recurso                                                                                                                           |\n|--------------|:-------:|-----------------------------------------------------------------------------------------------------------------------------------|\n| Java OpenJDK |   21    | [resources](https://jdk.java.net/java-se-ri/21)                                                                                   |\n| Maven        |  3.6.2  | [resources](https://archive.apache.org/dist/maven/maven-3/3.6.2/)                                                                 |\n| Git          | latest  | [win](https://git-scm.com/downloads/win),  [mac](https://git-scm.com/downloads/mac), [linux](https://git-scm.com/downloads/linux) |\n\n# 🪛 Crear un proyecto\n\n## 📀 Instalación\n\n**Clonar el Proyecto**\n\nPara clonar este proyecto, utiliza el siguiente comando:\n\n```bash\ngit clone https://github.com/dbacilio88/archetype-api-microservices.git\n```\n\n```bash\ncd archetype-api-microservices\n```\n\n```bash\nmvn clean install\n```\n\n## 💻 Construir en Terminal bash\n\n```shell\nmvn archetype:generate \\\n-DarchetypeGroupId=com.bacsystem \\\n-DarchetypeArtifactId=archetype-api-microservices \\\n-DarchetypeVersion=1.1.0 \\\n-DgroupId=com.example \\\n-DartifactId=archetype-example \\\n-Dversion=1.0.0 \\\n-Dversion=1.0.0 \\\n-DpackageName=microservice \\\n-Dpackage=com.example \\\n-DinteractiveMode=false\n```\n\n## 🖥️ Construir en Terminal cmd\n\n```shell\nmvn archetype:generate ^\n-DarchetypeGroupId=com.bacsystem ^\n-DarchetypeArtifactId=archetype-api-microservices ^\n-DarchetypeVersion=1.1.0 ^\n-DgroupId=com.example ^\n-DartifactId=archetype-example ^\n-Dversion=1.0.0 ^\n-DpackageName=microservice ^\n-Dpackage=com.example ^\n-DinteractiveMode=false\n```\n\n## 🧮 Estructura del proyecto\n\n```\nDisk:\n├───deploy\n├───docs\n│   └───collections\n├───gradle\n│   └───wrapper\n└───src\n    ├───main\n    │   ├───java\n    │   │   └───com\n    │   │       └───example\n    │   │           └───microservice\n    │   │               └───application\n    │   │                   ├───components\n    │   │                   │   ├───configuration\n    │   │                   │   ├───enums\n    │   │                   │   ├───exceptions\n    │   │                   │   │   └───handler\n    │   │                   │   ├───interfaces\n    │   │                   │   ├───mappers\n    │   │                   │   └───utils\n    │   │                   ├───controllers\n    │   │                   │   ├───contracts\n    │   │                   │   └───implementations\n    │   │                   ├───dtos\n    │   │                   ├───repositories\n    │   │                   │   └───entities\n    │   │                   └───services\n    │   │                       ├───contracts\n    │   │                       └───implementations\n    │   └───resources\n    └───test\n        ├───java\n        │   └───com\n        │       └───example\n        └───resources\n```\n\n## 🔧 Tecnologías Usadas\n\n|    java    | Spring Boot |   Gradle   | Maven          | Branch                                                                                         |\n|:----------:|:-----------:|:----------:|----------------|------------------------------------------------------------------------------------------------|\n| openJDK-21 |     3.*     | gradle-8.5 | 3.6 o superior | [console](https://github.com/dbacilio88/archetype-api-microservices/tree/spring-boot-3-jdk-21) |\n\n## ⚙️ Configuración rápida\n\nIncluye configuraciones predeterminadas para Spring Boot.\n\n## 🧰 Integración de dependencias\n\nConfiguración básica de Maven o Gradle para gestionar dependencias.\n\n## 📦 Ejemplo de código\n\nIncluye ejemplos de controladores, servicios y repositorios.\n\n**Ojo**: Leer deploy.md del proyecto generado\n\n# 🧪 Uso\n\nPuedes agregar tus propios controladores, servicios y repositorios en las carpetas correspondientes. Modifica\n`application.properties` o  `application.yml` para configurar tu aplicación según sea necesario.\n\nNota: ejecutar el componente o aplicación en perfil **`dev`**\n\n# 👨🏻‍💻 Contribuciones\n\n¿Cómo puedes ayudar?\n\n¡Las contribuciones son bienvenidas! Si deseas contribuir a este arquetipo, por favor abre un issue o envía un pull\nrequest.\n\n1. [ ] Prueba el arquetipo y compárteme tus impresiones.\n2. [ ] Contribuye con código, ideas o mejoras.\n3. [ ] Comparte este mensaje con tus colegas y en tus redes sociales.\n\nTu apoyo puede hacer una gran diferencia y juntos podemos construir algo increíble. 🚀 ¡Espero contar contigo!\n\n# 📞 Contacto \n\nPara más información, puedes contactar a [dbacilio88](https://github.com/dbacilio88)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbacilio88%2Farchetype-api-microservices","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbacilio88%2Farchetype-api-microservices","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbacilio88%2Farchetype-api-microservices/lists"}