Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/horaciomuller/event-api
Developed with Java 17, Spring, Docker, Flyway, JUnit, Mockito, and deployed on AWS EC2 with GitHub Actions automation.
https://github.com/horaciomuller/event-api
aws docker githubactions java postgres spring
Last synced: 3 days ago
JSON representation
Developed with Java 17, Spring, Docker, Flyway, JUnit, Mockito, and deployed on AWS EC2 with GitHub Actions automation.
- Host: GitHub
- URL: https://github.com/horaciomuller/event-api
- Owner: horaciomuller
- Created: 2024-12-14T16:14:53.000Z (13 days ago)
- Default Branch: main
- Last Pushed: 2024-12-24T01:12:19.000Z (3 days ago)
- Last Synced: 2024-12-24T02:22:57.920Z (3 days ago)
- Topics: aws, docker, githubactions, java, postgres, spring
- Language: Java
- Homepage:
- Size: 43.5 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Event and Venue Management API
An advanced and scalable API for managing events and venues, built with modern technologies and principles. This project is designed to deliver robust performance, maintainable code, and seamless integration with existing systems.
## Features
- **Event Management**: Create, update, delete, and retrieve events with ease.
- **Venue Management**: Manage venue details, availability, and bookings.
- **Clean Architecture**: Following Clean Architecture principles for better code organization and maintainability.
- **Database Versioning**: Leveraging Flyway for consistent and traceable database migrations.
- **Containerization**: Built with Docker for simplified deployment and scalability.
- **Modern Java**: Developed with Java 17, utilizing the latest language features.
---
## Tech Stack
- **Java 17**: Modern Java features for cleaner and more efficient code.
- **Spring Framework**: Includes Spring Boot for rapid development and Spring Data for database interaction.
- **Docker**: Containerized application for easy deployment.
- **Flyway**: For managing database schema migrations.
- **PostgreSQL**: Reliable and scalable database backend.
---
## Architecture
The project follows the principles of **Clean Architecture**, ensuring:
- **Separation of Concerns**: Dividing the application into clear layers (Domain, Application, Infrastructure, and Presentation).
- **Testability**: High test coverage and easily testable components.
- **Flexibility**: Easy adaptability for new features and integrations.
### Project Structure
```plaintext
src
├── main
│ ├── java
│ │ └── com.example.eventmanagement
│ │ ├── application # Application logic
│ │ ├── domain # Core business rules
│ │ ├── infrastructure # External integrations and database
│ │ └── presentation # Controllers and REST endpoints
│ └── resources
│ ├── db/migration # Flyway migrations
│ └── application.yml # Application configuration
└── test
└── java # Unit and integration tests
```
---
## Getting Started
### Prerequisites
Ensure you have the following installed:
- [Java 17](https://www.oracle.com/java/technologies/javase-jdk17-downloads.html)
- [Docker](https://www.docker.com/)
- [Maven](https://maven.apache.org/) (optional, if not using Docker)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/horaciomuller/EventClean.git
cd event-management-api
```
2. Start the application with Docker:
```bash
docker-compose up
```
3. Access the API documentation (Swagger):
```
http://localhost:8080/swagger-ui/index.html
```
---
## API Endpoints
### Events
- **GET /events**: Retrieve a list of events.
- **POST /events**: Create a new event.
- **PUT /events/{id}**: Update an event by ID.
- **DELETE /events/{id}**: Delete an event by ID.
### Venues
- **GET /venues**: Retrieve a list of venues.
- **POST /venues**: Create a new venue.
- **PUT /venues/{id}**: Update a venue by ID.
- **DELETE /venues/{id}**: Delete a venue by ID.
---
## Database Migrations
This project uses **Flyway** for database schema migrations. All migration scripts are located in the `src/main/resources/db/migration` folder. To run migrations manually, use:
```bash
mvn flyway:migrate
```
---
## Testing
### Unit Tests
Run unit tests with:
```bash
mvn test
```
### Integration Tests
Ensure the database is running and execute:
```bash
mvn verify
```
---
## Contributing
Contributions are welcome! Please follow these steps:
1. Fork the repository.
2. Create a feature branch: `git checkout -b feature-name`
3. Commit your changes: `git commit -m 'Add new feature'`
4. Push to the branch: `git push origin feature-name`
5. Submit a pull request.
---
## License
This project is licensed under the [MIT License](LICENSE).
---
## Contact
For questions or feedback, please contact us at [[email protected]](mailto:[email protected]).