A Modern E-Commerce Platform Celebrating Palestinian Heritage.
Author: Mohammed Alhajeen
Project: Suqnna Marketplace — Palestinian Heritage Commerce Platform
License: MIT License © 2025 Mohammed Alhajeen
Suqnna is a next-generation e-commerce platform that empowers Palestinian artisans and small businesses to sell handcrafted and ready-made products online.
It is not a regular e-commerce system — it integrates cultural identity, financial safety, and modular scalability.
| Feature | Description |
|---|---|
| Multi-Company Architecture | Each artisan or company has its own isolated dashboard, site, and cart. |
| Deposit (عربون) System | Customers can pay a partial deposit for handmade products to protect both sides. |
| Wallet Escrow | Secure smart wallet locks funds until successful delivery. |
| Arabic FTS Search | Full-text search with Arabic language support and synonym dictionary. |
| Shipment & Refund Logic | Advanced delivery workflow with fair refund policies. |
| Company Site Builder | Each business can design its own branded micro-website. |
| Role-Based Auth | Supports customers, companies, drivers, and admins. |
| Spring Boot + PostgreSQL 17 | Clean, modular backend with modern Java 25 support. |
| Docker Ready | Fully containerized with Compose for production deployment. |
| Folder | Description |
|---|---|
01-Architecture-Overview |
Global system overview and diagram |
02-Media-Management |
Image/video handling, storage, validation |
03-Company-Site-Management |
Custom storefront builder for artisans |
04-Product-System |
Product logic for ready & handmade crafts |
05-Cart-System |
Multi-company shopping cart with deposit logic |
06-Order-Management |
Secure order lifecycle with refund protection |
07-Shipment-System |
Delivery workflow & driver management |
08-Wallet-Escrow |
Smart wallet and transaction engine |
09-Security-Auth |
JWT authentication and role authorization |
10-Data-Architecture |
PostgreSQL schema and FTS setup |
- Backend: Java 25 (Spring Boot 3.x)
- Database: PostgreSQL 17
- Auth: JWT + Role-based access
- Containerization: Docker + Compose
- Search: PostgreSQL Full Text Search (Arabic)
- Frontend (planned): React + Tailwind CSS
- Deployment: Nginx + Docker stack
Suqnna is built to preserve heritage and build trust in a complex ecosystem:
- It combines traditional Palestinian crafts with modern financial protection (escrow).
- It enables artisans to own their brand identity while using a shared infrastructure.
- It allows customers to pre-order handmade products securely, with refundable deposits.
- It uses modular microservice-like architecture ready for future scalability.
Licensed under the MIT License.
© 2025 Mohammed Alhajeen — Suqnna Marketplace.
To create a trusted, ethical, and modern Palestinian e-commerce ecosystem
that celebrates authentic craftsmanship, economic empowerment,
and digital independence.