GiftBox-Customization-Marketplace
Team
- E/23/167 - Name, email
- E/23/351 - Sanjuna K.D - email
- E/23/412 - Name, email
- E/23/416 - Vishwaka A.G.S, email
Table of Contents
Introduction
Problem Statement
Online gift-giving has grown rapidly, yet existing e-commerce platforms offer no native way to select items from multiple vendors and combine them into a single gift package. Customers are forced to:
- Place separate orders across different stores
- Manually coordinate delivery timelines
- Accept inconsistent packaging and quality
- Manage multiple tracking systems for one occasion
These gaps are especially painful for time-sensitive, non-returnable gifts where quality and punctuality are critical.
Proposed Solution
Giftora is a centralized multi-vendor gift box customization marketplace. Customers build a single personalized gift box by selecting items from any number of registered vendors, check out once, and receive one professionally assembled, quality-checked delivery.
The platform introduces a centralized assembly workflow: a dedicated team collects items from vendors, inspects and assembles them, and dispatches the final gift box — ensuring consistent packaging standards and reliable delivery timelines.
Impact
For Customers — One checkout, one delivery, zero coordination headache. Personalized gifts without logistical complexity.
For Vendors — Broader customer reach, reduced individual shipping overhead, and clear order workflow integration.
For the Gift Industry — A scalable model for multi-vendor collaboration with built-in quality assurance.
Solution Architecture
Giftora is a full-stack web application structured around three tiers:
- Frontend — A React.js (v18+) single-page application serving role-specific dashboards for Customers, Vendors, Assembly Staff, and Administrators over HTTPS
- Backend — A Spring Boot (Java, v3+) RESTful API layer handling business logic, JWT-based authentication, RBAC enforcement, order splitting, and assembly workflow coordination
- Database — A MySQL (v8+) relational database storing users, products, orders, sub-orders, assembly records, and tracking milestones
A single customer order is split internally into sub-orders per vendor, each tracked independently and merged for the customer-facing milestone view. Real-time status updates are delivered via API polling or WebSocket connections.
Software Design
Core Modules
User Management — Secure registration and login for Customers, Vendors, and Administrators. JWT-based stateless authentication, BCrypt password hashing, and role-based access control (RBAC) enforced at both API and UI layers.
Gift Box Customisation Engine — An interactive canvas where customers browse a searchable, filterable multi-vendor catalogue, add items from different sellers into one gift box, view a real-time cost total, attach a personalised message, and save drafts for later.
Vendor & Item Management — A dedicated vendor portal for creating, editing, and managing product listings with images, pricing, and stock levels. Stock is automatically decremented on order confirmation.
Order Management & Splitting — On checkout, a master order record is created and automatically split into one sub-order per vendor. Vendors are notified immediately; administrators manage the assembly hub workflow.
Milestone-Based Order Tracking — Customers see a clear timeline across five stages: Order Placed → Vendor Processing → Items Dispatched to Hub → Quality Inspection → Out for Delivery, each with a recorded timestamp.
Technology Stack
| Layer | Technology |
|---|---|
| Frontend | React.js v18+ |
| Backend | Spring Boot v3+ (Java) |
| Database | MySQL v8+ |
| Auth | JWT + BCrypt |
| Version Control | Git / GitHub |
Testing
The system is verified across four strategies:
- Unit Tests — Backend service/utility methods with JUnit; frontend components with Jest
- Integration Tests — API endpoint behaviour verified against the SRS using Postman collections
- System Tests — End-to-end user journey scenarios on a deployed staging environment
- Security Tests — JWT validation, RBAC enforcement, and input sanitisation via targeted API tests
Automated regression tests run on every pull request to the main branch. Final User Acceptance Testing (UAT) simulates the full gift customization lifecycle with real user scenarios.
Conclusion
Giftora addresses a genuine gap in the online gifting market by combining multi-vendor item selection, centralized assembly, and milestone-based tracking into one seamless platform. The project demonstrates practical application of full-stack web development, secure system design, RESTful API architecture, and Agile project management — and provides a foundation for future enhancements including AI-powered gift recommendations, mobile applications, and multi-currency support.