Visitar URL original
GitHub - sinajr2011-prog/Gavin-shop: A secure & elegant online store for handmade Iranian crafts. Built with pure PHP, modern design, real order system, chat, and powerful admin panels. · GitHub
Skip to content

About

A secure & elegant online store for handmade Iranian crafts. Built with pure PHP, modern design, real order system, chat, and powerful admin panels.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

🌿 Gavin Shop

Handmade · Nature · Story

A premium, production-ready online store for authentic Iranian handicrafts

PHP MySQL Status License


GitHub


✨ About the Project

Gavin is a complete, elegant, and production-ready e-commerce platform built specifically for selling handmade Iranian crafts.

It focuses on beautiful design, smooth user experience, real security, and clean architecture — ready for real-world deployment.

What you get:

  • Stunning public storefront with gallery & storytelling pages
  • Full order system with province/city-based shipping calculation
  • Real-time chat between customer and store owner
  • Powerful Seller Panel + Developer Panel
  • Notifications, audit logs, and payment gateway management

🚀 Key Features

For Customers

  • Beautiful homepage with featured products
  • Full shop with clean product pages
  • Real prices, stock management & add-to-cart
  • Smart cart & checkout flow
  • Direct chat with the store owner
  • Personal account (orders, notifications, profile)

For Store Owner / Seller

  • Complete order management dashboard
  • Smart shipping system (province + city + approved rates)
  • Product & dynamic category management
  • Financial overview & payout requests
  • Internal notification system

For Developer

  • Full developer control panel
  • Audit logs for every important action
  • Payment gateway management
  • Seller & order monitoring
  • Role-based access control

🛠️ Tech Stack

Layer Technology
Backend PHP 8.1+ (Native)
Database MySQL 8 / MariaDB
Frontend HTML5 · CSS3 · Vanilla JavaScript
Security CSRF · Password Hashing · Prepared Statements
Architecture Clean Structure · Role-based Access · Atomic Transactions

📁 Project Structure

Gavin-shop/
├── assets/                 # CSS, JS, gallery images
├── config/                 # Database, auth, helpers
├── account/                # Customer account panel
├── panel/
│   ├── seller/             # Seller panel
│   └── developer/          # Developer panel
├── api/                    # Order API endpoints
├── database/               # Schema, seed & migrations
├── uploads/products/       # Product images (must be writable)
├── index.php
├── shop.php
├── product.php
├── checkout.php
├── chat.php
└── ...

⚙️ Installation

1. Clone the repository

git clone https://github.com/sinajr2011-prog/Gavin-shop.git
cd Gavin-shop

2. Create the database

CREATE DATABASE gavin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Then run these files in order:

  1. database/schema.sql
  2. database/production-final.sql (if upgrading)
  3. database/seed.php (run once)

3. Configure

Edit config/config.php:

const DB_HOST = 'localhost';
const DB_NAME = 'gavin';
const DB_USER = 'your_user';
const DB_PASS = 'your_password';
const BASE_URL = 'https://yourdomain.com'; // optional

4. Make uploads writable

chmod -R 755 uploads/products

5. Run the seeder

php database/seed.php

⚠️ Change the default passwords immediately after seeding!


🎨 Design Philosophy

  • Color palette inspired by nature and traditional crafts
  • Clean, modern, fully RTL-ready interface
  • Soft shadows, elegant typography, and smooth interactions
  • Mobile-first & fully responsive

👨‍💻 Developer

Sina Jafari
Main Developer & UI/UX Designer


📜 License

This project is private and owned by the Gavin team.
Any commercial use or redistribution without permission is strictly prohibited.


Made with ❤️ in Iran
From hand to life · Gavin


⬆ Back to top

About

A secure & elegant online store for handmade Iranian crafts. Built with pure PHP, modern design, real order system, chat, and powerful admin panels.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages