About the Project

Jkay's is a robust, end-to-end digital transformation solution built for the modern grocery retail landscape. The platform decouples frontend customer experience from backend business logic through a secure, RESTful API architecture.

The customer application is a responsive, intuitive mobile interface that allows users to navigate a highly dynamic product catalog with real-time pricing, stock validation, and personalized offers. The app supports complex product configurations, multi-tier categorization, and seamless cart-to-checkout flow with integrated payment gateways and wallet-based transactions.

The admin panel is a full-fidelity web-based control system designed for operational command. It centralizes management of products, inventory, pricing rules, supplier coordination, procurement cycles, and customer relations. The panel incorporates role-based privilege hierarchies, keyboard shortcut workflows for power users, and state-driven UI components that reflect real-time business logic.

The system supports attribute-level pricing, stock-out alerting, referral-based cashback automation, and multi-location inventory transfers. It is engineered for high-volume SKU management and transactional integrity across all modules.

Key Features

Dynamic Product Engine

  • Supports SKU-level attributes including weight (g, kg, lt), pack size (PCS, PKT), and unit-based measurements with variant-specific pricing
  • Hierarchical cataloging with Category → Sub-category → Product → Attribute tree structure
  • Multi-language product descriptors with Gujarati localization support
  • Sort-order inheritance and featured/publish toggles for product visibility control

Real-Time Cart & Pricing Engine

  • Instant recalculation of MRP, selling price, and applied coupon logic
  • Real-time quantity validation against per-attribute maximum limits
  • Dynamic discount application with percentage-based and fixed amount calculations
  • Cart total recalculation with item total, applied coupon deduction, and final payable amount computation

Wallet & Loyalty Automation

  • Auto-credit referral cashbacks triggered on unique mobile number referrals
  • Order refund processing with direct wallet credit and transaction remarks logging
  • Granular wallet ledger with filtering by customer, reference type (order, refer, refund), and transaction date
  • Complete audit trails with updated-by and updated-on timestamps

Smart Filtering & Faceted Search

  • Category, sub-category, attribute, and discount range-based product discovery
  • Real-time product count display with discount bands (Upto 76% Discount)
  • Multi-option product cards displaying available attribute variants with respective pricing
  • Table-based data presentation with column filtering and pagination

Address & Delivery Orchestration

  • Geo-aware address selection with title selection (Home, Office), city, area, and pincode validation
  • Store pickup location integration with physical address display and pickup eligibility verification
  • Delivery charge computation logic with conditional charge applicability
  • Maximum quantity enforcement at checkout with user-facing limit messaging

Payment Abstraction Layer

  • Unified interface for Cash on Delivery, UPI, Net Banking, and Card payments with fallback handling
  • Wallet balance integration with use-my-wallet toggle and real-time balance display
  • Coupon code management with usage limits, user eligibility tiers, and max-use restriction enforcement

Product Lifecycle Management

  • Tax configuration with HSN codes and GST slab assignment
  • Minimum and maximum stock threshold configuration with negative stock prevention
  • Product tagging system with multi-tag assignment and filterable tag mappings
  • Brand, unit, and attribute master tables with status toggles

Attribute-Based Inventory Architecture

  • Each product variant (PCS, GM, LT, PKT) treated as a distinct inventory entity
  • Attribute-specific MRP, selling price, cart special price, and max-cart quantity enforcement
  • Real-time stock validation against per-attribute minimum and maximum quantity limits
  • Split product functionality for inventory breakdown operations

Purchase & Supplier Orchestration

  • End-to-end purchase order lifecycle with PO numbering (PO-1, PO-2, PO-3) and document date tracking
  • Supplier database with contact information, reference number mapping, and godown assignment
  • Delivery note reconciliation and location transfer logging across multiple warehouses (GD1, GD2)
  • Purchase return processing with separate delivery note return workflow

Customer Intelligence & Wallet Ledger

  • Granular view of customer wallet transactions filtered by reference type, amount range, and date
  • Complete transaction history with reference IDs and operator identification
  • Customer group segmentation and tag-based customer categorization
  • Referral tracking with unique mobile number mapping and cashback attribution

Stock-Out Intelligence Module

  • Real-time logging of out-of-stock notification requests with device ID and customer identification
  • Customer-device-product attribute level tracking with notify status toggle
  • Created On timestamp monitoring for stock-out pattern analysis
  • Direct visibility into customer demand for specific product variants

Operational Efficiency Tools

  • Shortcut-key driven navigation with ALT+P for purchase, F2 for form opening, F9 for delivery note, F4 for entry completion, and ALT+I for product list
  • Bulk filters, pagination, and configurable entries per page (25, 50, 100)
  • Inline table actions for high-speed data manipulation
  • Form submission approval workflow with APPROVED state confirmation

Reporting & Analytics

  • Daily sales aggregation with product-wise quantity sold and Sr No. indexing
  • Real-time visibility into top-moving SKUs across all categories
  • Inventory movement reports and slow-moving stock identification
  • Transaction date–based filtering and chronological data presentation

Security & Audit Compliance

  • Role-based access control hierarchy with distinct privilege levels for admin, managers, and staff
  • Comprehensive audit logging with Created On, Created By, Updated On, Updated By enforced across all transactional entities
  • Two-factor authentication support for secure login
  • Form submission approval matrix preventing unauthorized modifications

System Architecture & Engineering

  • Modular monolith with API-first design ensuring clean separation of concerns
  • State-driven UI components reflecting real-time entity states (APPROVED, PENDING, OUT OF STOCK)
  • Event-driven credit system for referral cashback automation
  • Scalable data modeling supporting composite keys and polymorphic attribute relationships

Business & Operational Impact

  • Digitized end-to-end retail operations eliminating manual ledger maintenance and order slips
  • Real-time inventory visibility reducing stock discrepancies and over-selling incidents
  • Referral engine and wallet cashbacks increasing repeat purchase rates
  • Shortcut keys and optimized forms reducing admin data entry time by significant margin
  • Enterprise-ready architecture supporting multi-branch, multi-warehouse, and franchise scalability