Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sunagatov/iced-latte
a online Marketplace for coffee retail (Backend)
https://github.com/sunagatov/iced-latte
docker java jwt kubernetes log4j2 lombok maven postgresql-database postman sonarqube spring-boot spring-data-jpa stripe
Last synced: 4 days ago
JSON representation
a online Marketplace for coffee retail (Backend)
- Host: GitHub
- URL: https://github.com/sunagatov/iced-latte
- Owner: Sunagatov
- License: mit
- Created: 2022-12-09T14:00:14.000Z (about 2 years ago)
- Default Branch: development
- Last Pushed: 2024-04-12T12:14:51.000Z (8 months ago)
- Last Synced: 2024-04-13T18:05:32.915Z (8 months ago)
- Topics: docker, java, jwt, kubernetes, log4j2, lombok, maven, postgresql-database, postman, sonarqube, spring-boot, spring-data-jpa, stripe
- Language: Java
- Homepage: https://iced-latte.uk
- Size: 6.59 MB
- Stars: 192
- Watchers: 6
- Forks: 63
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Iced-Latte
[](https://github.com/Sunagatov/Iced-Latte/actions)
[](https://github.com/danilqa/node-file-router/blob/main/LICENSE)
[](https://github.com/Sunagatov/Iced-Latte/issues)
[](https://github.com/Sunagatov/Iced-Latte)
[](https://app.codecov.io/github/Sunagatov/Iced-Latte)
[](https://hub.docker.com/r/zufarexplainedit/iced-latte-backend/)
[](https://github.com/Sunagatov/Iced-Latte/graphs/contributors)
[](https://github.com/Sunagatov/Iced-Latte/stargazers)
[](https://github.com/Sunagatov/Iced-Latte/network/members)
## Table of Contents
- [Introduction](#introduction)
- [Github-Stars](#Github-Stars)
- [Tech Stack](#tech-stack)
- [Quick Start](#quick-start)
- [Deployment](#-deployment)
- [Forking and tweaking](#-forking-and-tweaking)
- [How to report a bug?](#-how-to-report-a-bug)
- [Now to propose a new feature?](#-now-to-propose-a-new-feature)
- [Contributions](#-contributions)
- [Code of Conduct](#code-of-conduct)
- [Our top contributors](#-our-top-contributors)
- [License](#-license)
- [Contact](#-contact-)
## Introduction
**🟥 Iced-Latte (Backend)** is a non-profit sandbox project where a team of IT enthusiasts are working on creating a modern marketplace (https://iced-latte.uk/) for selling coffee in order to pump up their soft and hard skills and have fun working on an interesting project.
🟥 It's crucial to note that we operate without financial support from any party, and we don't compensate anyone financially either. Our efforts are fuelled solely by passion and dedication.
### 🔥 Github-Stars 🔥
Please support Iced Latte project by Giving Stars 🌟 on Github repositories - your ratings mean a lot to us!🙂
## Tech Stack
- **Architecture:** Monolith.
- **Computer language:** Java 17.
- **Framework:** Spring Web, Spring Boot 3, Spring Data, Spring Security, Spring Actuator, Spring Web, Spring Retry, Lombok, Apache Commons, Spring Mail, Google Guava.
- **Security:** JWT, TLS.
- **Migration tool:** Liquabase.
- **Logging:** Log4j2, Slf4j.
- **Unit Tests:** JUnit 5.
- **E2E Tests**: Rest Assured, Test containers.
- **Converter:** Mapstruct.
- **Test coverage:** Jacoco.
- **API Specs:** Open API + Spring Docs.
- **Validation:** Javax validation.
## Quick Start
Follow the setup instructions in [START.MD](START.md) to get the project up and running.
## 🚢 Deployment
No k8s, no AWS, we ship dockers directly via ssh and it's beautiful!
The entire production configuration is described in the [docker-compose.local.yml](docker-compose.local.yml) file.
Then, [Github Actions](.github/workflows/dev-branch-pr-deployment-pipeline.yml) have to take all the dirty work. They build, test and deploy changes to production on every merge to master (only official maintainers can do it).
Explore the whole [.github](.github) folder for more insights.
We're open for proposals on how to improve our deployments.
## 🛤 Forking and tweaking
Forks are welcome.
Three huge requests for everyone:
- Please share new features you implement with us, so other folks can also benefit from them, and your own codebase minimally diverges from the original one (so you can sync updates and security fixes) .
- Do not use our issues and other official channels as a support desk. Use [chats](https://t.me/lucky_1uck).
## 🙋♂️ How to report a bug?
- 🆕 Open [a new issue](https://github.com/Sunagatov/Iced-Latte/issues/new).
- 🔦 Please, **use a search**, to check, if there is already existed issue!
- Explain your idea or proposal in all the details:
- Make sure you clearly describe "observed" and "expected" behaviour. It will dramatically save time for our contributors and maintainers.
- **For minor fixes** please just open a PR.
## 💎 Now to propose a new feature?
- Go to our [Discussions](https://github.com/Iced-Latte/discussions)
- Check to see if someone else has already come up with the idea before
- Create a new discussion
- 🖼 If it's **UI/UX** related: attach a screenshot or wireframe
## 😍 Contributions
Contributions are welcome.
The main point of interaction is the [Issues page](https://github.com/Sunagatov/Iced-Latte/issues).
> The official development language at the moment is English, because 100% of our users speak it. We don't want to introduce unnecessary barriers for them. But we are used to writing commits and comments in Russian and we won't mind communicating with you in it.
The bussiness docs are here [Docs](https://drive.google.com/drive/folders/1vvfXy6n4cz01JjNyTgoYG0g6EIRvyHDw?usp=share_link).
Swagger REST APIs contracts described [here](https://iced-latte.uk/backend/api/docs/swagger-ui/index.html).
### 😎 I want to write some code
- Open our [Issues page](https://github.com/Sunagatov/Iced-Latte/issues) to see the most important tickets at top.
- Pick one issue you like and **leave a comment** inside that you're getting it.
**For big changes** open an issues first or (if it's already opened) leave a comment with brief explanation what and why you're going to change. Many tickets hang open not because they cannot be done, but because they cause many logical contradictions that you may not know. It's better to clarify them in comments before sending a PR.
### 🚦Pay attention to issue labels!
#### 🟩 Ready to implement
- **good first issue** — good tickets **for first-timers**. Usually these are simple and not critical things that allow you to quickly feel the code and start contributing to it.
- **bug** — if **something is not working**, it needs to be fixed, obviously.
- **high priority** — the **first priority** tickets.
- **enhancement** — accepted improvements for an existing module. Like adding a sort parameter to the feed. If improvement requires UI, **be sure to provide a sketch before you start.**
#### 🟨 Discussion is needed
- **new feature** — completely new features. Usually they're too hard for newbies, leave them **for experienced contributors.**
- **idea** — **discussion is needed**. Those tickets look adequate, but waiting for real proposals how they will be done. Don't implement them right away.
#### 🟥 Questionable
- [¯\\_(ツ)\_/¯](https://github.com/Sunagatov/Iced-Latte/labels/%C2%AF%5C_%28%E3%83%84%29_%2F%C2%AF) - special label for **questionable issues**. (should be closed in 60 days of inactivity)
- **[no label]** — ticket is new, unclear or still not reviewed. Feel free to comment it but **wait for our maintainers' decision** before starting to implement it.
## 👍 Our top contributors
Take some time to press F and give some respects to our [best contributors](https://github.com/Sunagatov/Iced-Latte/graphs/contributors), who spent their own time to make the club better.
#### 😎 Iced Latte project creator / Product owner / Tech Lead
- [@Sunagatov](https://github.com/Sunagatov)
#### 😇 Project manager
- [@oonovikova](https://github.com/oonovikova)
#### 🕵️♀️ QA engineers
- [@TetianaPerinha](https://github.com/TetianaPerinha)
- [@ilsinyakov](https://github.com/ilsinyakov)
- [@Diana-Smolnikova](https://github.com/Diana-Smolnikova)
#### ⚙️ Backend developers
- [@annstriganova](https://github.com/annstriganova)
- [@M437A](https://github.com/M437A)
- [@Sunagatov](https://github.com/Sunagatov)
- [@vitaliibredun](https://github.com/vitaliibredun)
- [@plakhov](https://github.com/plakhov)
- [@shpali4](https://github.com/shpali4)
- [@yevr19](https://github.com/yevr19)
- [@andrew13pol](https://github.com/andrew13pol)
- [@nnick44](https://github.com/nnick44)
#### 🖥️ Frontend developers
- [@iakivpekarskyi](https://github.com/iakivpekarskyi)
- [@anksuunamun-govorov](https://github.com/anksuunamun)
- [@DmitriyUshkvarok](https://github.com/DmitriyUshkvarok)
- [@Wdyffs](https://github.com/Wdyffs)
- [@Gerasko-Vadim](https://github.com/Gerasko-Vadim)
- [@FMajesty](https://github.com/Lightness322)
- [@freecree](https://github.com/freecree)
#### 🎨 UX/UI designers
- [@vilena1me](https://github.com/vilena1me)
- [@monsoonsiren](https://github.com/monsoonsiren)
- [@ilyasgaifullin](https://github.com/ilyasgaifullin)
#### 📊 Business and system analysts
- [@nemeziss](https://github.com/nemeziss)
- [@anastasiiaerokhina](https://github.com/anastasiiaerokhina)
- [@Umk_aa](https://github.com/Umk_aa)
- [@dianarudometova](https://github.com/dianarudometova)
Let's press F to pay respects to these awesome contributors!
## 👩💼 License
[MIT](LICENSE)
In other words, you can use the code for private and commercial purposes with an author attribution (by including the original license file or mentioning the Iced-Latte project).
## 📞 Contact (Community and Support)
Join our IT community [Zufar Explained IT](https://t.me/zufarexplained) on Telegram.
Feel free to contact us via email: [[email protected]](mailto:[email protected]).
❤️