🛍️ Atelier - Online Shopping Cart System

💻 A full-stack web application demonstrating Object-Oriented Programming principles using Java

🧰 Stack

✨ Key Features

• 🗂️ Product Catalog Management (CRUD)
• 🛒 Shopping Cart & Checkout
• 📊 Sales Reporting System

🗂️ Project Structure

atelier/
├── backend/                          # Spring Boot REST API
│   ├── src/main/java/com/shoppingcart/atelier/
│   │   ├── models/                   # Domain entities 
│   │   ├── repositories/             # Spring Data JPA repositories
│   │   ├── services/                 # Business logic
│   │   ├── controllers/              # REST endpoints
│   │   ├── dto/                      # Data Transfer Objects
│   │   ├── config/                   # Configuration
│   │   └── utils/                    # Utilities
│   ├── src/main/resources/
│   │   ├── application.properties.example  # Template
│   │   └── application.properties          
│   └── pom.xml
├── frontend/                         
│   ├── src/
│   │   ├── components/               # React components
│   │   ├── pages/                    # Route pages
│   │   ├── lib/                      # Utilities
│   │   └── hooks/                    # Custom hooks
│   └── package.json
├── database/                         # SQL scripts
├── docs/                             # Documentation
│   ├── uml/                          # UML diagrams
│   ├── api/                          # API documentation
│   └── report/                      # Final report
├── docker-compose.yml                # PostgreSQL container
├── .gitignore
└── README.md

🚀 Setup Guide

🧩 Prerequisites

• Java JDK 21
• Node.js 24+
• PostgreSQL JDBC Driver
• Git
• IntelliJ IDEA Community & VS Code
• Postman

---

📥 1. Clone Repository

git clone https://github.com/NSBM-SE-Projects/atelier.git
cd atelier

---

⚙️ 2. Backend Setup

cd backend

# Request the application.propeties from @dwainXDL
# Then paste in backend/src/main/resources

# Run the application in IntelliJ

🔗 Backend URL - http://localhost:8080

📘 Full API documentation: ./docs/api

---

🎨 3. Frontend Setup

cd frontend

# Install node dependencies
npm i

# Run development server
npm run dev

🔗 Frontend URL - http://localhost:5173

---

🧪 Testing

🔍 Backend API Testing (Postman)

1. Import collection from docs/api/atelier_api_collection.json
2. Verify responses and status codes

👥 The Team

• Project Lead: @dwainXDL
• Documentation Lead: @drnykteresteinwayne
• Software Development Lead: @PWTMihisara
• UI/UX Lead: @thiranya123
• UI/UX Designer: @Yameesha
• UI/UX Designer: @kmss-sew

📫 Contact

Further questions? Contact @dwainXDL : D