A production-grade Java coffee marketplace — built in the open, for engineers who want real experience.
🌐 Live Demo · 📖 API Specs · 🟢 Good First Issues · 💬 Community
📊 Key stats across all three repositories:
⭐ If this project helps you learn or inspires you, please give it a star — it means a lot to the community!
📋 Prerequisites: Java 25, Maven 3.9+, Docker Desktop
# 1. 📥 Clone
git clone https://github.com/Sunagatov/Iced-Latte.git && cd Iced-Latte
# 2. 🐳 Start infrastructure (PostgreSQL, Redis, MinIO)
docker compose --env-file .env.example up -d postgres redis minio minio-init
# 3. ▶️ Run
# Linux / macOS / Git Bash on Windows:
set -a && source .env.example && set +a && mvn spring-boot:run🪟 Windows (PowerShell / CMD): the shell command above won't work as written. Use IntelliJ with
.env.exampleloaded in the run configuration, or use the full Docker path instead — see Getting Started.
⚠️ Important:.env.exampleis intentionally tuned for contributors:SPRING_PROFILES_ACTIVE=dev, optional integrations such as Stripe stay disabled, and local HTTP access logs run atDEBUG.
🌐 App runs at http://localhost:8083 · 📚 Swagger UI at http://localhost:8083/api/docs/swagger-ui/index.html
💡 Using IntelliJ? See Getting Started for all four local run modes, IDE run configuration, Docker-only setup, and troubleshooting.
🎞️ Want to run the frontend too? Clone the frontend repo as a sibling and use Options 1-4 in Getting Started:
git clone https://github.com/Sunagatov/Iced-Latte-Frontend.git # sibling of Iced-Latte/Frontend can run either locally or in Docker, depending on the mode you pick.
⚠️ Docker commands should also use.env.example, so the backend container starts in the same localdevprofile unless you explicitly override it.
🧪 Run the tests:
mvn test✅ Tests use Testcontainers — Docker must be running.
Live application interface
Iced Latte is a non-profit sandbox project started in 2022 as a private pet project. It was later opened to the community to give junior engineers, students, and mentees practical experience in a real tech project with processes similar to those in actual tech teams. The first participants were students, Telegram channel subscribers, and mentees from ADPList and Women In Tech. The project has since grown and earned recognition from the wider developer community.
⭐ If this project helps you learn or inspires you, please give it a star — it means a lot to the community!
Iced Latte has earned recognition from the broader tech community.
🔥 GitHub Trending 🔥 — May 22, 2024
- The backend repository reached GitHub's Trending page — listed among resources "the GitHub community is most excited about today" — gaining 85 stars in a single day with 27 active contributors. (link to the archive)
🥉 KaiCode 2024 Finalist 🥉
- Iced Latte made it to the finals of KaiCode — an annual developer festival launched by Huawei, which positions itself as an incubator of collaborative technologies and rewards promising projects. Iced Latte was selected among 412 applications and placed in the third group of 26 finalist repositories considered for the prize. Jury members are not allowed to assess their own projects, so the selection was fully independent.
🛠️JetBrains Open Source License 🛠
- Iced Latte was recognized by JetBrains — a leading software company specializing in intelligent development tools. JetBrains granted Iced Latte 8 free All Products Pack licenses (February 2024, License Reference No. D379769990).
👨💻 Recommended by a GitHub Star 👨
- Iced Latte was recommended in this LinkedIn post by a well-known creator and GitHub Star, who called it a great example of a Java project. Many Iced Latte contributors shared their positive experience in the comments.
- 💻 Language: Java 25
- 🏗️ Framework: Spring Boot 4.0.5, Spring Security, Spring Data JPA, Spring Retry, Spring Actuator
- 🗄️ Database: PostgreSQL, Liquibase
- ⚡ Cache: Redis, Caffeine
- 🔒 Security: JWT (JJWT 0.13), Google OAuth2, Argon2
- ☁️ Cloud: AWS S3 SDK 2.x, CloudFront, MinIO
- 💳 Payment: Stripe
- 🤖 AI: LangChain4j, OpenAI-compatible APIs
- 📊 Observability: Micrometer, Prometheus, OpenTelemetry, Sentry, Loki, Datadog
- 🧪 Testing: JUnit 5, Testcontainers, REST Assured, Instancio, Jacoco
- 📋 API: OpenAPI 3, SpringDoc 3.0, OpenAPI Generator 7
- 🔄 Mapping: MapStruct 1.6, Lombok
- 📄 Getting Started — all four local run modes, IDE setup, Docker-only mode, troubleshooting
- 📄 Infrastructure — how the database, object storage, and Redis cache are wired together, with free-tier provider options and env vars explained
- 📄 Architecture: Feature Packaging — modular-monolith rule: keep business code inside its owning feature package
- 📄 Contributing — how to contribute, PR guidelines, branching
- 📄 Security Policy — security policy and vulnerability reporting
- 📄 Code of Conduct — community standards and expected behavior
- 📄 LICENSE — personal local evaluation only; public/educational/commercial use requires permission
src/main/java/com/zufar/icedlatte/
├── 🔒 security/ # JWT auth, Google OAuth2, registration, login, sessions, rate limiting
├── 🔑 auth/ # Google OAuth2 callback, auth redirects
├── 👤 user/ # User profile, addresses, avatars
├── 📦 product/ # Product catalog, filters, images
├── 🛒 cart/ # Shopping cart
├── 📋 order/ # Orders, order lifecycle, order history
├── 💳 payment/ # Stripe payment, checkout, webhooks
├── ⭐ review/ # Product reviews, ratings, AI moderation
├── ❤️ favorite/ # Favorites list
├── 📧 email/ # Email verification & notifications
├── 📁 filestorage/ # AWS S3 / MinIO file upload/download
├── 🔧 common/ # Shared utilities, validation, monitoring, HTTP helpers
└── 🚀 astartup/ # Startup data migration and bootstrap tasks
🎉 Contributions are welcome. Here's how to get involved:
- 🐛 Found a bug: Open an issue with the
buglabel - 💡 Want a feature: start a Discussion first
- 👨💻 Ready to code: pick a
good first issue, then comment "I'm on it" - 🔧 Big change: comment on the issue before writing code — many tickets have hidden constraints
- 🟢
good first issue— simple, well-scoped, and great for first-timers - 🔴
bug— something is broken - 🔵
high priority— do this first - 🟡
enhancement— accepted improvement to an existing module - 🟠
new feature— new functionality; discuss before starting - ⚪
idea— needs design discussion; don't implement yet
- 🔍 Search existing issues before opening a new one
- 📝 Clearly describe observed vs expected behavior
- 🚀 For minor fixes, just open a PR directly
- 🎯 Keep PRs focused — one concern per PR
- ✅ Make sure
mvn testpasses locally before pushing - 🔗 Reference the issue number in your PR description
🤝 Forks are welcome. Please share useful features back via PR so the community benefits and your fork stays easy to sync.
📜 Iced Latte Personal Evaluation License 2026 — personal local evaluation only. Public, educational, remote-hosted, and commercial use require explicit written permission from the author (zufar.sunagatov@gmail.com).
- 💬 Telegram community: Project community
- 👤 Personal Telegram: @lucky_1uck
- 📱 WhatsApp: Message me
- 📧 Email: zufar.sunagatov@gmail.com
- 🐛 Issues: GitHub Issues
❤️