Heartisans

---

🌟 About Heartisans

Heartisans is a revolutionary full-stack marketplace that bridges the gap between traditional craftsmanship and modern e-commerce. Built with cutting-edge technology, it empowers artisans to showcase, sell, and auction their handcrafted treasures while providing buyers with an immersive shopping experience powered by AI-driven insights.

🎯 Mission

To preserve and promote traditional artisanship through technology, creating sustainable livelihoods for craftspeople while connecting global audiences with authentic handmade products.

---

✨ Key Features

🛍️ Comprehensive Marketplace

• Product Catalog: Extensive collection of handcrafted items from verified artisans
• Advanced Search & Filtering: Find products by category, state, material, and price range
• Shopping Cart & Wishlist: Seamless shopping experience with persistent cart functionality
• Secure Payments: Integrated with Cashfree for safe and reliable transactions

🏺 Live Auction System

• Real-time Bidding: WebSocket-powered live auctions with instant updates
• Auction Management: Create, manage, and participate in timed auctions
• Bidding Leaderboard: Live ranking of bidders with real-time updates
• Smart Notifications: Instant alerts for bid updates and auction status changes

♻️ Resale Marketplace

• AI-Powered Pricing: SAP Business AI integration for intelligent price predictions
• Condition-Based Pricing: Transparent pricing based on item condition
• Image Recognition: Multi-image upload with cloud storage
• Interest Management: Buyer-seller communication system

🔐 Advanced Authentication

• Multi-Provider Auth: Support for Google OAuth and local authentication
• OTP Verification: Email-based verification system
• Role-Based Access: Admin, Artisan, and Customer role management
• Account Security: Login attempt tracking and temporary account locking

💳 Subscription System

• Artisan Plans: Monthly and yearly subscription options
• Enhanced Features: Premium tools for verified artisans
• Payment Processing: Automated subscription management
• Commission Tracking: Transparent earnings and commission system

🤖 AI & Analytics

• SAP Business AI: Enterprise-grade AI for pricing and descriptions
• Product Descriptions: AI-generated product descriptions
• Market Analysis: Intelligent pricing recommendations
• Business Intelligence: Comprehensive analytics dashboard

📱 Modern User Experience

• Responsive Design: Optimized for all devices
• Internationalization: Multi-language support (English, Bengali, Hindi)
• Real-time Updates: Live notifications and status updates

👥 Community Features

• Story Sharing: User experience stories with image uploads
• Reviews & Ratings: Comprehensive feedback system
• Ambassador Program: Community leadership opportunities
• Admin Panel: Comprehensive platform management

---

🏗️ Architecture

Frontend Stack

Technology	Purpose
React	Frontend Framework
Vite	Build Tool & Dev Server
React Router DOM	Client-side Navigation
Tailwind CSS	Utility-first Styling
Axios	HTTP Client
Socket.io Client	Real-time Communication
React i18next	Internationalization
Context API	State Management

Backend Stack

Technology	Purpose
Node.js	Runtime Environment
Express	Web Framework
MongoDB	NoSQL Database
Mongoose	ODM for MongoDB
Socket.io	WebSocket Server
Cloudinary	Image Storage & CDN
Cashfree	Payment Gateway
JWT	Authentication Tokens
Multer	File Upload Middleware
bcryptjs	Password Hashing
Nodemailer	Email Service

External Integrations

Technology	Purpose
SAP Business AI	Intelligent pricing and descriptions
Cloudinary	Cloud-based image and video management
Cashfree	Payment gateway for secure transactions
Socket.io	Real-time bidding and notifications

---

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• MongoDB (v5 or higher)
• Git

Installation

1. Clone the repository

   git clone https://github.com/imsudiptaa/Heartisans1.git
   cd Heartisans1

2. Backend Setup

   cd backend
   npm install

3. Frontend Setup

   cd frontend
   npm install

4. Environment Configuration

   Create .env files in both backend and frontend directories:

   Backend .env:

   MONGODB_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret
   CLOUD_NAME=your_cloudinary_cloud_name
   API_KEY=your_cloudinary_api_key
   API_SECRET=your_cloudinary_api_secret
   CASHFREE_APP_ID=your_cashfree_app_id
   CASHFREE_SECRET_KEY=your_cashfree_secret_key
   EMAIL_USER=your_email_for_notifications
   EMAIL_PASS=your_email_password
   GOOGLE_CLIENT_ID=your_google_oauth_client_id
   GOOGLE_CLIENT_SECRET=your_google_oauth_client_secret

5. Start Development Servers

   Backend:

   cd backend
   npm run dev

   Frontend:

   cd frontend
   npm run dev

6. Access the Application

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:5000

---

📁 Project Structure

Heartisans1/
├── 📁 backend/
│   ├── 📁 config/          # Configuration files
│   ├── 📁 controllers/     # Route handlers
│   ├── 📁 middleware/      # Custom middleware
│   ├── 📁 models/          # Database schemas
│   ├── 📁 routes/          # API routes
│   ├── 📁 services/        # Business logic
│   ├── 📁 utils/           # Utility functions
│   └── 📄 server.js        # Entry point
├── 📁 frontend/
│   ├── 📁 public/          # Static assets
│   ├── 📁 src/
│   │   ├── 📁 components/  # React components
│   │   ├── 📁 pages/       # Page components
│   │   ├── 📁 contexts/    # React contexts
│   │   ├── 📁 hooks/       # Custom hooks
│   │   ├── 📁 i18n/        # Internationalization
│   │   └── 📁 constants/   # App constants
│   └── 📄 index.html       # Entry HTML
└── 📄 README.md

---

🎯 Core Features Deep Dive

🔨 Auction System

The real-time auction system is powered by Socket.io, enabling:

• Live Bidding: Instant bid updates across all connected clients
• Auction States: Automatic management of upcoming, live, and ended auctions
• Bid Validation: Server-side validation to prevent invalid bids
• Real-time Leaderboard: Dynamic ranking updates

🤖 AI Integration

SAP Business AI powers intelligent features:

• Price Prediction: Market-based pricing recommendations
• Content Generation: AI-generated product descriptions
• Market Analysis: Comprehensive analytics and insights
• Condition Assessment: Automated quality evaluation

💳 Payment Processing

Secure payment handling with:

• Multiple Payment Methods: Cards, UPI, Net Banking, Wallets
• Subscription Management: Automated recurring payments
• Commission Tracking: Transparent fee calculation
• Refund Processing: Automated refund workflows

📊 Analytics Dashboard

Comprehensive insights including:

• Sales Analytics: Revenue, orders, and performance metrics
• User Behavior: Engagement and interaction patterns
• Product Performance: Best-selling items and categories
• Market Trends: Pricing and demand analysis

---

📷 Screenshots

🏠 Homepage & Hero Section

Beautiful hero section showcasing handcrafted treasures

🛍️ Product Catalog & Shop

Comprehensive product catalog with advanced filtering

🏺 Live Auction Experience

Real-time bidding with WebSocket-powered updates

---

🔧 Development Tools

Available Scripts

Backend:

• npm run dev - Start development server with nodemon
• npm start - Start production server
• npm test - Run tests

Frontend:

• npm run dev - Start Vite development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

---

🌍 Internationalization

Heartisans supports multiple languages:

• English (Default)
• Bengali (বাংলা)
• Hindi (हिन्दी)
• Tamil (தமிழ்)
• Telugu (తెలుగు)

Language files are located in frontend/src/i18n/ with easy expansion for additional languages.

---

🔒 Security Features

• JWT Authentication: Secure token-based authentication
• Password Hashing: bcrypt for secure password storage
• Rate Limiting: API rate limiting to prevent abuse
• Input Validation: Comprehensive data validation
• CORS Protection: Controlled cross-origin requests

---

📈 Performance Optimizations

• Image Optimization: Cloudinary automatic optimization
• Code Splitting: React lazy loading and Vite optimization
• Database Indexing: Optimized MongoDB queries
• Caching: Strategic caching for frequently accessed data
• CDN Integration: Global content delivery
• Bundle Analysis: Webpack bundle optimization

---

👥 Meet Our Team

Core Development Team

Profile	Name	Social Links
	Sudipta Mandal
	Khushi Kumari Gupta
	Md Haaris Hussain
	Sk Faizanuddin
	Sangneel Deb

Contributors & Supporters

We're grateful to all contributors who have helped make Heartisans a reality. Every contribution, from code to feedback, helps preserve and promote traditional artisanship.

Want to join our team? We're always looking for passionate developers, designers, and artisan advocates. Check out our Contributing Guidelines to get started!

---

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow the existing code style
• Write clear commit messages
• Add tests for new features
• Update documentation as needed

---

📞 Support & Contact

• Email: [email protected]
• GitHub Issues: Create an Issue
• Documentation: Wiki

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• React Team for the amazing frontend framework
• MongoDB for the flexible database solution
• Cloudinary for robust media management
• SAP for enterprise-grade AI capabilities
• Cashfree for secure payment processing
• Socket.io for real-time functionality

---

🎨 Built with ❤️ for Artisans Worldwide

Empowering traditional craftsmanship through modern technology

⭐ Star this repository if you found it helpful! ⭐