{"id":28466049,"url":"https://github.com/negarprh/shopeasy","last_synced_at":"2025-10-12T01:10:03.377Z","repository":{"id":288343753,"uuid":"963538422","full_name":"negarprh/ShopEasy","owner":"negarprh","description":"Full-stack Java EE shopping site 🛒 with product listings, cart system, user roles, and database integration.","archived":false,"fork":false,"pushed_at":"2025-06-23T15:06:39.000Z","size":794,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-23T16:26:10.369Z","etag":null,"topics":["css","html","jakarta-ee","java","jsp","jsp-servlet","oop"],"latest_commit_sha":null,"homepage":"","language":"Java","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/negarprh.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}},"created_at":"2025-04-09T20:43:57.000Z","updated_at":"2025-06-23T15:06:42.000Z","dependencies_parsed_at":"2025-04-17T11:55:35.691Z","dependency_job_id":"df45cfb1-7712-420f-bd37-51d3c3304d5f","html_url":"https://github.com/negarprh/ShopEasy","commit_stats":null,"previous_names":["negarprh/shopeasy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/negarprh/ShopEasy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/negarprh%2FShopEasy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/negarprh%2FShopEasy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/negarprh%2FShopEasy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/negarprh%2FShopEasy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/negarprh","download_url":"https://codeload.github.com/negarprh/ShopEasy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/negarprh%2FShopEasy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279009683,"owners_count":26084645,"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-11T02:00:06.511Z","response_time":55,"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":["css","html","jakarta-ee","java","jsp","jsp-servlet","oop"],"created_at":"2025-06-07T06:08:12.765Z","updated_at":"2025-10-12T01:10:03.369Z","avatar_url":"https://github.com/negarprh.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 ShopEasy – Java E-commerce Platform\n\nShopEasy is a full-stack e-commerce web application built with **JSP**, **Servlets**, and **JDBC** (Java EE stack). It enables users to browse products, view details, manage a cart, and complete a checkout process. Admins can manage the inventory through a separate dashboard.\n\n---\n\n## 📸 Screenshots\n\n### 🏠 Homepage\n![Homepage](screenshots/homepage.png)\n\n### 🧾 Product Detail\n![Product Detail](screenshots/productdetail.png)\n\n### 🛍️ Cart Page\n![Cart Page](screenshots/cart.png)\n\n### 💳 Checkout Page\n![Checkout Page](screenshots/checkout.png)\n\n---\n\n## ⚙️ Features\n\n### ✅ User Features\n- Sign up, log in, and manage sessions\n- Browse products and view details\n- Add to cart, update quantity, and remove items\n- Checkout with form validation\n\n### ✅ Admin Features\n- Access `AdminPanel.jsp`\n- View all products\n- Add/edit/delete products (CRUD)\n- Role-based access control\n\n---\n\n## 🧱 Technologies Used\n\n- **Java EE** (Servlets + JSP)\n- **JDBC** for database interaction\n- **HTML/CSS** for UI\n- **H2 Database** (H2 Database)\n- **Git \u0026 GitHub** for version control\n\n---\n\n## 🧠 Object-Oriented Principles\n\n- ✅ **Encapsulation**: Private fields with public getters/setters\n- ✅ **Inheritance**: `User` inherits from `Person`\n- ✅ **Interface implementation**: `User implements IUser`, `Product implements IProduct`\n- ✅ **Polymorphism**: Interfaces used for flexibility\n- ✅ **Exception Handling**: Input validation and DB error handling\n\n---\n\n## 📁 Folder Structure\n\n```\n\nsrc/\n├── controller/          // Servlets (e.g., LoginServlet, RegisterServlet)\n├── dao/                // Database access logic\n├── model/              // POJOs: User, Product, CartItem, + interfaces\n├── views/              // JSP pages: index.jsp, product.jsp, cart.jsp\n└── utils/              // DBConnection.java\n\n```\n\n---\n\n## 📖 Setup Instructions\n\n1. Clone the repository  \n   `git clone https://github.com/yourusername/shopeasy.git`\n\n2. Import the project in IntelliJ (Java + Maven/EE)\n\n3. Configure your database connection in `DBConnection.java`\n\n4. Run on a servlet container (e.g., Apache Tomcat)\n\n5. Access the app on `http://localhost:8080/ShopEasy`\n\n---\n\n## 💬 Reflection \u0026 Learning\n\n\u003e \"This project helped me understand how to design and build an end-to-end application using Java EE. I strengthened my understanding of Servlets, MVC architecture, JDBC integration, form validation, and Git workflows. It was a great opportunity to apply object-oriented programming concepts in a real-world context.\"\n\n---\n## 📋 Project Task Backlog – ShopEasy\n\nThis project follows the structure outlined in the final evaluation for `420-PA3-AS`. The frontend is built with JSP/CSS, backend with Java Servlets and JDBC, and deployed via Apache Tomcat.\n\n| Task Name               | Category        | Description                                            | Assigned To         |\n|-------------------------|-----------------|--------------------------------------------------------|---------------------|\n| Setup Project Structure | Core            | Initialize folders: model, dao, servlet, WEB-INF       | Negar               |\n| Create Database Schema  | Core            | Design tables: products, users, orders, cart_items     | Betty               |\n| Configure DB Connection | Core            | Create DB connection utility and test it               | Betty               |\n| Product Entity \u0026 DAO    | Core            | Create Product class and CRUD                          | Betty               |\n| User Entity \u0026 DAO       | Core            | Implement User class, login, and registration          | Negar               |\n| Order Entity \u0026 DAO      | Core            | Handle order storage and retrieval                     | Naomi               |\n| Basic UI Layout (JSP)   | UI              | Create `index.jsp` and layout templates with CSS       | Negar               |\n| Product Listing Page    | User            | List products using Servlet + JSTL                     | Negar, Naomi        |\n| Product Details Page    | User            | View detailed info when clicking product               | Betty               |\n| Cart Page               | User            | Add/view/remove items using session tracking           | Naomi               |\n| Checkout Page           | User            | Capture user info and process order                    | Naomi               |\n| Admin Panel (JSP)       | Admin           | Add/edit/delete products                               | Betty               |\n| Error Handling          | Core            | Implement try/catch and user error messages            | All team            |\n| JavaDoc Documentation   | Documentation   | Add JavaDoc to all classes and methods                 | All team            |\n| GitHub Repo Setup       | Version Control | Initialize and push initial project                    | Negar               |\n| Branching for Team      | Version Control | Create branches per developer                          | All team            |\n| Final UI Styling        | UI              | Polish layout and make responsive                      | Negar               |\n| User Manual             | Documentation   | Write brief usage guide in `README.md`                 | Negar               |\n| Team Reflection         | Professional    | Prepare final 500-word team reflection                 | All team            |\n| Presentation Prep       | Professional    | Build final demo and slides                            | All team            |\n| Create Base Class       | OOP             | Inherit User/Admin from `Person`                       | Betty               |\n| Implement Interfaces    | OOP             | Implement `IUser`, `IProduct` (or Payable, etc.)       | Negar               |\n\n---\n\n## 👨‍💻 Author\n\n**Negar Pirasteh**  \nCollege: LaSalle College | Program: Computer Science Technology  \nGitHub: [@negarprh](https://github.com/negarprh)\n\n**Betty Dang**  \nCollege: LaSalle College | Program: Computer Science Technology  \nGitHub: [@BettyDang](https://github.com/BettyDang)\n\n**Naomi (Ngoc Yen Nhi) Pham**  \nCollege: LaSalle College | Program: Computer Science Technology  \nGitHub: [@Naomiphamm](https://github.com/Naomiphamm)\n\n---\n\n## 📝 License\n\nThis project is for educational purposes under the LaSalle College Winter 2025 Java OOP course.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnegarprh%2Fshopeasy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnegarprh%2Fshopeasy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnegarprh%2Fshopeasy/lists"}