SureCommerce - eCommerce Platform & QR Warranty System

SureCommerce is a modern Laravel Ecommerce Platform designed for businesses selling physical products with built-in QR Warranty Management and Anti-Counterfeit Protection.

Unlike traditional ecommerce solutions, SureCommerce manages the complete product lifecycle:

• Sell products online
• Generate QR warranty codes
• Verify genuine products
• Activate warranties
• Handle warranty claims
• Manage returns and exchanges
• Detect counterfeit products

Everything is included in a single Laravel application with no third-party warranty plugins required.

The platform provides a modern admin dashboard, customer portal, CMS, SEO tools, payment integrations, warehouse management and a complete after-sales solution for physical products.

Suitable for electronics, home appliances, automotive parts, industrial equipment, medical devices, fashion brands and any business that requires warranty management and product authentication.

Main Features

🛒 Ecommerce Store

• Product catalog with unlimited categories, brands, labels
• Product variants (Color, Size, Material) with per-variant pricing and stock
• Inventory & warehouse management
• Flash sales, coupon codes, bulk discounts
• Shopping cart & multi-gateway checkout
• Order management (receive → process → ship → deliver → return)
• Wishlist, product compare, product reviews
• Blog system with full SEO tools

💳 Payment Gateways (5)

• Stripe
• PayPal
• VNPay
• Bank Transfer
• Cash On Delivery

🔐 QR Warranty System

• Bulk QR Batch Generator — up to 50,000 unique codes per batch
• Cryptographically unique QR code + serial number + warranty code per unit
• Print-ready PDF label export (label printer compatible)
• Customer scans QR with any smartphone — no app required
• Self-service warranty activation in under 60 seconds
• Auto expiry date calculation from activation date
• Email confirmation on successful activation

🛡 Anti-Counterfeit Protection

• Cryptographic server-side verification on every QR scan
• Detects duplicate & cloned QR codes instantly
• Counterfeit attempts logged with timestamp, IP, location
• Risk-level flagging (High / Medium / Low) in admin report

🔄 After-Sales Management

• Warranty claims — customer submits online, admin reviews with full workflow
• Returns & exchanges with complete status tracking
• Full claim and return history per product and per customer

👤 Customer Portal

• Order history & real-time tracking
• Purchased products with warranty status + expiry countdown
• Submit warranty claims & return requests online
• Product reviews, wishlists, address book, personal coupons

🔌 REST API (12 Endpoints)

• 12 token-authenticated endpoints built on Laravel Sanctum
• Rate limiting: 60 requests / minute per token
• Endpoints: Products (2), Categories (2), Brands (2), Orders (3), Warranty (3)
• Admin panel token generator — create & revoke API clients from UI

⚙ Admin Panel

• Dashboard with revenue, order, and warranty KPIs
• Product, order, customer management
• QR Batch Manager — create, export, regenerate labels
• Warranty & return management with workflow actions
• API Clients — generate and revoke REST API tokens
• Reports & analytics
• Role-based access control (Admin / Staff)
• Media manager, email template management

🚀 Web Installer

No Composer, no CLI, no manual .env editing. Upload the source code (vendor dependencies bundled), open /install in your browser, and complete the 7-step wizard:

1. Requirements check (PHP version, extensions)
2. File permissions check
3. Database configuration (auto-creates database if missing)
4. Site name & URL
5. Admin account (you set your own credentials)
6. Language & timezone
7. One-click install with live progress log

Install time: 30–60 seconds. Tested on shared hosting, VPS, and Docker.

Technical Stack

• Laravel 13 · PHP 8.4+
• MySQL 8.0+ / MariaDB 10.3+
• TailwindCSS · Alpine.js
• Laravel Sanctum (REST API auth)
• Repository Pattern · Service Layer architecture
• Redis ready (optional — for cache & queue)
• Mobile-responsive (dedicated mobile theme)
• Docker support for local development
• 100% unencoded source code

What's Included

• 100% Laravel source code — no encoding, no obfuscation
• Vendor dependencies bundled — no Composer required to install
• 7-step browser-based web installer
• REST API with 12 endpoints + full API reference documentation
• Complete HTML documentation (install guide, user manual, API reference, FAQ)
• Docker Compose for local development
• Database seeders with demo data
• 6 months author support
• Free future updates

Server Requirements

• PHP 8.4+ with extensions: curl, gd, imagick, json, zip, mbstring, xml, pdo, bcmath
• MySQL 8.0+ or MariaDB 10.3+
• Apache 2.4+ (mod_rewrite) or Nginx 1.10+
• 512 MB RAM minimum (1 GB+ recommended)
• Composer not required — vendor is bundled in the package
• Redis optional (recommended for production queues)

Demo & Documentation

• Landing Page (Feature Introduction): https://surecommerce.dreamteam...
• Store Demo (Store): https://demo.surecommerce.drea...
• Admin Panel: https://demo.surecommerce.drea...
• Documentation: https://surecommerce.dreamteam...
• REST API Reference: https://surecommerce.dreamteam...
• Video Demo: View Demo on Youtube

Admin Demo Login

Email: admin

Password: KRYkfXADWR95

Changelog

Version 1.1.3

• Security: Replaced extract() with explicit input assignments across all admin controllers — prevents variable injection via crafted request payloads.
• Security: Removed raw exception messages from HTTP responses — internal error details (stack traces, file paths, DB errors) are now logged server-side only; users receive a generic localized message.
• Security: Replaced exit()/die() calls in controllers with proper abort(403)/abort(404) — correct Laravel lifecycle termination, prevents response bypass.
• Security: Removed Debugbar::enable() from admin mail config endpoint — debug toolbar can no longer be activated in production via HTTP request.
• Dependency: Moved laravel-debugbar and orangehill/iseed from production require to require-dev — debug tooling is no longer included in production autoload.
• Performance: Production autoloader is lighter and faster — debug packages (debugbar, iseed) removed from production dependency tree, reducing autoload overhead on every request.
• Performance: Replaced global extract() calls with direct $request->input() access — eliminates unnecessary full-array variable dump on every admin form submission.
• Performance: Replaced exit()/die() with abort() — proper Laravel response lifecycle ensures middleware teardown and response finalization run correctly, avoiding resource leaks on early termination.
• Improvements: Added localized error messages for media file and folder operations (available in English and Vietnamese).
• Improvements: All exception details are now written to the application log before returning a generic error to the client.

Version 1.1.2

• FIX: Author page display issue causing blank or broken layout in certain configurations
• FIX: Editing a product review created a duplicate entry instead of updating the existing one
• FIX: Existing review images were lost when editing a review and uploading new images
• FIX: Visiting the site before installation caused SQL errors instead of redirecting to /install
• IMPROVED: Author profile editing in admin panel — cleaner form, better field organization
• IMPROVED: Mobile customer portal UI — modernized layout, improved spacing and typography for a better on-device experience
• IMPROVED: Various UX and system-level optimizations for smoother performance and more consistent behavior across the platform

Version 1.1.1

• Fix: admin login page inaccessible after installation
• Fix: password validation on user registration page

Version 1.1.0

• NEW: REST API — 12 token-authenticated endpoints (Products, Categories, Brands, Orders, Warranty)
• NEW: Browser-based Web Installer — 7-step wizard at /install, no Composer or CLI required
• NEW: Admin API Client Manager — generate and revoke API tokens from admin panel
• NEW: Full REST API reference documentation

Version 1.0.0

• Initial release
• Complete Laravel ecommerce platform with product variants, orders, warehouse management
• 5 payment gateways (Stripe, PayPal, VNPay, Bank Transfer, COD)
• QR warranty system with bulk batch generator (50,000+ codes per batch)
• Anti-counterfeit protection with cryptographic verification
• After-sales: warranty claims, returns & exchanges
• Customer portal, blog, SEO tools, role-based admin