{"id":31693776,"url":"https://github.com/trehanpraharsh/ezshop","last_synced_at":"2026-04-07T08:02:12.300Z","repository":{"id":315655861,"uuid":"1060387375","full_name":"trehanpraharsh/ezShop","owner":"trehanpraharsh","description":"EzShop is a demo microservices-based e-commerce platform composed of several Spring Boot backend services and React frontends. The repository contains independent modules for product, cart, offers, orders, payment, user management, a gateway, and a service registry plus a Vite + React frontend apps.","archived":false,"fork":false,"pushed_at":"2025-09-19T20:47:59.000Z","size":147,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-19T23:22:26.327Z","etag":null,"topics":["html","java","javascript","react-router","reactjs","relational-databases","spring-boot","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trehanpraharsh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-19T20:33:17.000Z","updated_at":"2025-09-19T20:50:19.000Z","dependencies_parsed_at":"2025-09-19T23:38:35.912Z","dependency_job_id":null,"html_url":"https://github.com/trehanpraharsh/ezShop","commit_stats":null,"previous_names":["trehanpraharsh/ezshop"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/trehanpraharsh/ezShop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehanpraharsh%2FezShop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehanpraharsh%2FezShop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehanpraharsh%2FezShop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehanpraharsh%2FezShop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trehanpraharsh","download_url":"https://codeload.github.com/trehanpraharsh/ezShop/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehanpraharsh%2FezShop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278972328,"owners_count":26078017,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["html","java","javascript","react-router","reactjs","relational-databases","spring-boot","tailwindcss"],"created_at":"2025-10-08T15:53:06.563Z","updated_at":"2025-10-08T15:53:09.712Z","avatar_url":"https://github.com/trehanpraharsh.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EzShop\n\nEzShop is a demo microservices-based e-commerce platform composed of several Spring Boot backend services and React frontends. The repository contains independent modules for product, cart, offers, orders, payment, user management, a gateway, and a service registry plus two Vite + React frontend apps.\n\nThis README gives a quick project overview, tech stack, how to run services locally, and pointers for contribution.\n\n## Table of Contents\n\n- Project overview\n- Architecture\n- Services (backend)\n- Frontends\n- Prerequisites\n- Quick start (local)\n- Running individual modules\n- Tests\n- Contributing\n- License\n\n\n## Project overview\n\nRoot folders:\n\n- `ezShop-backend/` — multiple Spring Boot microservices (each under its own folder, e.g. `product-ms`, `cart-ms`, `offers-ms`, `order-ms`, `payment-ms`, `user-ms`, `shop-gateway`, `shop-registry`).\n- `ezShop-frontend/` — frontend apps built with React + Vite. Notable subfolders: `ecom-frontend/` (main storefront). A separate `user-frontend/` exists for user-facing flows.\n\n\n## Architecture\n\n- Microservices: each backend module is a standalone Spring Boot application (Java 17). Services use Spring Cloud components (Eureka for service discovery, Gateway for routing, WebFlux for reactive clients where applicable).\n- Data: modules expect a relational DB (PostgreSQL appears referenced in some modules). Each service uses Spring Data JPA where persistence is required.\n- Frontend: built with React + Vite and Tailwind/Bootstrap. Communication is via REST to the gateway which proxies to backend services.\n\n\n## Services (backend)\n\nTypical backend folders you will find inside `ezShop-backend/`:\n\n- `product-ms`\n- `cart-ms`\n- `offers-ms`\n- `order-ms`\n- `payment-ms`\n- `user-ms`\n- `shop-gateway` (Spring Cloud Gateway)\n- `shop-registry` (Eureka server)\n\nEach service is a Maven project with a `pom.xml` and includes a Maven wrapper (`mvnw`) so you can build/run without a local Maven installation.\n\n\n## Frontends\n\n- `ezShop-frontend/ecom-frontend` — React+Vite storefront. Uses dependencies such as React, React Router, Tailwind, Bootstrap, and Vite. Scripts available in `package.json` include `dev`, `build`, `preview`, and `lint`.\n- `user-frontend` — another React+Vite frontend (similar stack) (if present).\n\n\n## Prerequisites\n\n- Java 17 (required by Spring Boot applications)\n- Node.js 18+ and npm/yarn (for frontend)\n- Docker \u0026 Docker Compose (optional, recommended for running DBs and multiple services locally)\n- (Optional) PostgreSQL if you want to run services directly against a DB instead of Docker\n\n\n## Quick start (local)\n\nThis project is modular — you can run services individually. A common local dev workflow:\n\n1. Start the service registry (Eureka):\n\n\t- Open a terminal in `ezShop-backend/shop-registry`\n\t- Run the Maven wrapper:\n\n```\n./mvnw spring-boot:run\n```\n\n2. Start the gateway:\n\n```\ncd ezShop-backend/shop-gateway\n./mvnw spring-boot:run\n```\n\n3. Start required backend services (for example product, cart, payment):\n\n```\ncd ezShop-backend/product-ms\n./mvnw spring-boot:run\n```\n\nRepeat for `cart-ms`, `offers-ms`, `order-ms`, `payment-ms`, `user-ms` as needed. Services should register with the registry and be reachable through the gateway.\n\n4. Start the frontend (storefront):\n\n```\ncd ezShop-frontend/ecom-frontend\nnpm install\nnpm run dev\n```\n\nOpen the Vite dev URL (usually http://localhost:5173) and use the app. The frontend will make API calls to the gateway.\n\n\n## Running individual modules (notes)\n\n- Use the included Maven wrapper (`mvnw`) in each backend module to build or run the service.\n- To build a jar for a module:\n\n```\n./mvnw clean package -DskipTests\n```\n\n- To run tests for a module:\n\n```\n./mvnw test\n```\n\n\n## Tests\n\n- Backend modules include unit tests under `src/test/java`. Run them with `./mvnw test` inside the module folder.\n- Frontend linting is available via `npm run lint` in the frontend folders.\n\n\n## Contributing\n\n1. Open an issue describing the bug or feature.\n2. Create a git branch for your work.\n3. Add tests for new behavior where applicable.\n4. Submit a pull request and reference the issue.\n\n\n## Next steps and suggestions\n\n- Add a `docker-compose.yml` to orchestrate the registry, gateway, database, and a few services for easier local setup.\n- Document each module's default ports and configuration properties (e.g., `application.properties` keys) to simplify local runs.\n- Add a top-level `Makefile` or npm script to boot the common local developer flow.\n\n\n## License\n\nAdd your project license here (e.g. MIT) if this repo is public.\n\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrehanpraharsh%2Fezshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrehanpraharsh%2Fezshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrehanpraharsh%2Fezshop/lists"}