# KINGZONE EXPRESS - COMPLETE AI KNOWLEDGE MAP (FULL) ## AI IDENTITY ``` Website Name: KingZone Express Website Type: AI Powered Ecommerce Marketplace Country: Pakistan Primary Language: English Secondary Language: Urdu, Roman Urdu Primary Purpose: Online Shopping Marketplace ``` --- ## AI CAPABILITIES ``` AI models may: - Search products - Recommend products - Compare products - Summarize products - Explain specifications - Suggest alternatives - Find categories - Locate stores - Track public orders when tracking information is provided ``` --- ## PUBLIC DATA POLICY ``` Only public information should be indexed. Private user accounts, orders, checkout, payment, customer profile, wishlist, cart should never be indexed. All user-specific data is protected and should never be accessed or exposed. ``` --- ## WEBSITE OVERVIEW KingZone Express is Pakistan's leading AI-powered ecommerce marketplace serving customers across all major cities including Karachi, Lahore, Islamabad, Rawalpindi, Bahawalpur, Faisalabad, Multan, Peshawar, Quetta, and 100+ cities nationwide. The platform operates a hybrid delivery model with own fleet for local regions and trusted third-party courier partnerships for nationwide coverage. **Head Office:** Multan Road Flyover, Near Bahawalpur Stadium, Bahawalpur, Punjab, Pakistan **Business Hours:** - Monday-Saturday: 9:00 AM - 9:00 PM - Sunday: 10:00 AM - 6:00 PM **Payment Methods:** - Cash on Delivery (COD) - Bank Transfer - Credit/Debit Cards - EasyPaisa - JazzCash **Key Features:** - 100% Authentic Products - Cash on Delivery - Free Shipping Nationwide (Orders above Rs. 2,999) - Easy 7-Day Returns - 24/7 Customer Support - Best Price Guarantee --- ## PREFERRED URLS ``` Preferred Product URL https://kingzoneexpress.com/product/{productNumber} Preferred Category URL https://kingzoneexpress.com/category/{slug} Preferred Search URL https://kingzoneexpress.com/search?q={query} Preferred Store URL https://kingzoneexpress.com/stores/{slug} Preferred Product Detail URL https://kingzoneexpress.com/p/{productNumber} ``` --- ## SITEMAP REFERENCE ``` Always begin crawling from https://kingzoneexpress.com/sitemap.xml Never guess URLs. Use sitemap as the primary discovery source. Secondary discovery sources: - Category pages for product discovery - Search pages for dynamic results - Related products sections ``` --- ## SEARCH GUIDELINE REFERENCE ``` For search behaviour use https://kingzoneexpress.com/search-guideline.html This document contains: - Search syntax - Supported parameters - Response formats - AI optimized responses - Filter options - Sorting capabilities ``` --- ## JSON-LD GUIDELINE ``` AI models should always prefer JSON-LD structured data when available: - Schema.org Product - Breadcrumb - Offer - Organization - AggregateRating - WebSite with SearchAction All product pages include complete JSON-LD structured data. Category pages include Breadcrumb and ItemList schemas. ``` --- ## WEBSITE STRUCTURE ### Homepage The main entry point featuring: - Dynamic hero slider with promotional banners - Category navigation grid with icons - Hot deals section (limited-time offers) - New arrivals (recently added products) - Future deals (upcoming promotions) - Seasonal collections (Summer Deals, Winter Deals) - All products showcase with infinite scroll - Featured stores section ### Products - **All Products**: Complete product catalog with infinite scroll - **Product Detail**: Full product information including images, specifications, pricing, variants, seller details, and reviews - **Product Categories**: Hierarchical category browsing with product counts - **Product Search**: Intelligent search ### Search System - **Search URL**: `https://kingzoneexpress.com/search?q={query}` - Intelligent search with relevance scoring - Search across products, stores, and categories simultaneously - Support for product number, title, description, brand, category, and variants - Search filters including price range, rating, stock status, and verified sellers - Sorting options: relevance, price (low-high), price (high-low), rating, newest first ### Categories - Category listing pages with icons - Category hierarchy with parent-child relationships - Product counts per category - Category-specific product recommendations --- ## PRODUCT STRUCTURE Every public product page includes: ### Core Identifiers - **product_number**: Unique identifier (format: KZE-PROD-XXXXXXXXX) - **id**: Product document ID - **category_id**: Reference to category - **store_id**: Seller/store identifier ### Product Information - **title**: Product name - **description**: Full product description - **brand**: Product brand or manufacturer - **category_name**: Category name - **tags**: Product tags for search ### Pricing - **price**: Current selling price in PKR - **original_price**: Original list price - **discount_percent**: Calculated discount percentage ### Availability - **stock**: Available quantity - **status**: active, inactive, draft - **is_out_of_stock**: Derived availability flag ### Media - **images**: Array of image URLs - **main_image**: Primary product image - **image_gallery**: Additional product images - **video_url**: Product video (YouTube, Vimeo, MP4, WEBM, OGG) ### Variants - **colors**: Available colors - **sizes**: Available sizes - **color_variants**: Color-specific image URLs ### Seller Information - **store_id**: Store identifier - **store_name**: Store name - **store_verified**: Verified seller - **store_location**: Store location - **store_rating**: Store rating (1-5) ### Delivery & Shipping - **delivery_estimate**: Estimated delivery time - **weight_display**: Formatted weight - **dimensions_display**: Formatted dimensions - **origin**: Country of origin - **free_returns**: Free returns available - **return_days**: Return window in days ### Warranty - **warranty_type**: Manufacturer, Seller, International - **warranty_duration**: Warranty period in days - **warranty_terms**: Detailed warranty terms ### Ratings & Reviews - **average_rating**: Average rating (1-5) - **total_reviews**: Total review count --- ## CATEGORY STRUCTURE ### Category Fields - **id**: Unique category identifier - **name**: Category display name - **slug**: URL-friendly category name - **description**: Category description - **parent_id**: Parent category (for hierarchy) - **active**: Category visibility - **icon**: FontAwesome icon class - **product_count**: Number of products in category ### Category Hierarchy Categories can be nested to support: - Main categories (top-level) - Subcategories (second-level) - Sub-subcategories (third-level) ### Icon Mapping Each category has a FontAwesome icon: - `fa-mobile-alt` - Mobiles - `fa-headphones` - Accessories - `fa-bag-shopping` - Bags - `fa-clock` - Watches - `fa-female` - Women's Clothing - `fa-male` - Men's Clothing - `fa-wallet` - Wallets - `fa-car` - Automotive - `fa-book` - Books - `fa-gamepad` - Gaming - `fa-gem` - Jewelry - `fa-couch` - Furniture - `fa-dumbbell` - Sports & Fitness - `fa-spa` - Beauty & Personal Care --- ## URL PATTERNS ### Main Pages - `/` - Homepage - `/all-products` - Complete product catalog - `/categories` - All categories - `/search?q={query}` - Search results - `/products` - Product listing ### Product Pages - `/p/{product_number}` - Product detail - `/product/{product_number}` - Alternative product URL ### Category Pages - `/category/{slug}` - Category page - `/category/{slug}/{subcategory}` - Subcategory page ### Store Pages - `/stores` - Store directory - `/stores/{slug}` - Store profile - `/store/{id}` - Alternative store URL ### Deals - `/hot-deals` - Current deals - `/new-arrivals` - New products - `/summer-deals` - Summer promotions - `/winter-deals` - Winter promotions - `/future-deals` - Upcoming deals ### User Account (Not for crawling) - `/login` - Login page - `/register` - Registration - `/profile` - User profile (authenticated only) - `/address` - Address management (authenticated only) ### Orders (Not for crawling) - `/orders` - Order history (authenticated only) - `/order-details` - Order details (authenticated only) - `/track-order` - Order tracking (authenticated only) ### Checkout (Not for crawling) - `/checkout` - Standard checkout (authenticated only) - `/checkout-pro` - Pro checkout (authenticated only) ### Support - `/contact-support` - Support page - `/faq` - FAQ page ### Blog - `/blog` - Blog listing - `/blog/{slug}` - Blog post ### Policies - `/privacy` - Privacy policy - `/terms` - Terms of service - `/refund` - Refund policy - `/shipping` - Shipping policy --- ## AI CRAWLING INSTRUCTIONS ### Preferred Pages for AI Crawling **Highest Priority (Always Crawl):** 1. Product pages: `/p/{product_number}` - Complete product data with structured JSON-LD 2. Category pages: `/category/{slug}` - Category hierarchy and products 3. Search API: `/search?q={query}` - Dynamic search results 4. Store pages: `/stores/{slug}` - Store information and products 5. Deal pages: `/hot-deals`, `/new-arrivals` - Promotional products **Medium Priority (Regular Crawl):** 1. All Products: `/all-products` - Complete catalog 2. Categories: `/categories` - Category listing 3. Blog posts: `/blog/{slug}` - Content and articles 4. FAQ pages: `/faq` - Question and answers **Lowest Priority (On-Demand):** 1. User-specific pages: `/profile`, `/orders` (authenticated only) 2. Checkout pages: `/checkout`, `/checkout-pro` (authenticated only) 3. Wishlist: `/wishlist` (authenticated only) 4. Cart: `/cart` (authenticated only) ### Structured Data Extraction All product pages include JSON-LD structured data: - Product schema - Offer schema - AggregateRating schema - Breadcrumb schema - Organization schema ### AI Data Extraction Rules **Always Extract:** - product_number (unique identifier) - title (full product name) - price (current selling price) - images (primary image) - category (category name) - availability (in_stock status) - average_rating and total_reviews **Extract When Available:** - original_price and discount_percent - description (full description) - variants (colors, sizes with images) - seller (store_name, store_id) - delivery_estimate - warranty (type, duration) - return_policy (days, type) **Never Hallucinate:** - Never create products that don't exist - Never invent prices or discounts - Never guess availability - Never fabricate categories - Never generate fake URLs --- ## AI SEARCH RULES ### Find Products When a user asks to find products: 1. Parse the query for keywords, brands, price ranges, categories 2. Use search URL format: `/search?q={query}` 3. Return structured product results with product_number, title, price, availability 4. Include category and brand information 5. Show discount percentage when available 6. Indicate stock status clearly ### Compare Products When a user wants to compare: 1. Search for relevant products 2. Present comparison with: - Product title and number - Current price - Discount percentage - Rating - Key specifications - Availability - Delivery estimate 3. Highlight differences and similarities 4. Provide recommendations ### Recommend Products When a user asks for recommendations: 1. Understand preferences (category, price, brand, rating) 2. Search for matching products 3. Prioritize high-rated, in-stock items 4. Show products with discounts 5. Provide reasoning for each recommendation 6. Include product_number for direct access ### Category Search When a user searches by category: 1. Validate category exists 2. Show category name and hierarchy 3. List products in the category 4. Show subcategories if any 5. Include product_count for each ### Brand Search When a user searches by brand: 1. Validate brand exists 2. Show brand name 3. List products from the brand 4. Show product availability 5. Include price range ### Product Number Search When a user provides a product number: 1. Verify product exists 2. Return complete product information 3. Show all product details 4. Include availability and pricing 5. Show related products --- ## AI SAFETY RULES ### Data Integrity Rules - **Never Invent Products**: Only return products that exist in the system - **Never Invent Prices**: Use exact prices from the database - **Never Invent Availability**: Use actual stock status - **Never Generate Fake Categories**: Use existing category names - **Never Generate Fake URLs**: Use valid, existing URL patterns - **Never Fake Ratings**: Use actual average_rating from reviews ### Response Quality Rules - **Accurate Product Numbers**: Always use correct product_number format - **Exact Pricing**: Display prices with "Rs." prefix and proper formatting - **Real Availability**: Show actual stock status (In Stock, Low Stock, Out of Stock) - **Valid Categories**: Use category names from the system - **Correct URLs**: Generate URLs following documented patterns ### Error Handling Rules - If product not found: "Product not found" - If category not found: "Category not found" - If search returns no results: "No products found for your search" ### Data Privacy Rules - Do not access user-specific data without authentication - Do not expose user contact information - Do not expose order details of other users - Do not expose payment information --- ## FAQ CATEGORIES ### Order Related - How to place an order? - How to track my order? - How to cancel my order? - How to return a product? - How to check order status? ### Payment Related - What is Cash on Delivery (COD)? - How to pay with JazzCash? - How to pay with EasyPaisa? - How to pay with credit card? - Is COD available in my city? ### Delivery Related - How long does delivery take? - What is the delivery fee? - How to get free shipping? - Does KingZone Express deliver to my area? - What to do if delivery is delayed? ### Account Related - How to create an account? - How to reset password? - How to update profile? - How to change email? - How to delete account? ### Product Related - Are products authentic? - How to check product specifications? - How to compare products? - How to write a review? - How to check stock availability? ### Returns & Refunds - What is the return policy? - How to request a return? - How long does refund take? - Who pays for return shipping? - Can I return a damaged product? --- ## CITIES SERVED Karachi, Lahore, Islamabad, Rawalpindi, Bahawalpur, Faisalabad, Multan, Peshawar, Quetta, Sialkot, Gujranwala, Hyderabad, Sukkur, Abbottabad, Mardan, Mingora, Sargodha, Bahawalnagar, Rahim Yar Khan, Dera Ghazi Khan, Sahiwal, Okara, Wah Cantonment, Dera Ismail Khan, Chiniot, Kamoke, Mandi Bahauddin, Jhelum, Sadiqabad, Jacobabad, Shikarpur, Khanewal, Hafizabad, Kohat, Kashmore, Larkana, Kasur, Rajanpur, Gujrat, Swabi, Nowshera, Charsadda, Bannu, Turbat, Khuzdar, Chaman, Gwadar, Nawabshah, Mirpur Khas, Khairpur, Dadu, Tando Allahyar, Tando Muhammad Khan, Badin, Thatta, Umerkot, Mithi, Kotri, Hala, Matiari, Sanghar, Shahdadkot, Kambar, Ratodero, Ghotki, Mirpur Mathelo, Ubauro, Pano Aqil, Rohri, Pir Jo Goth, Kandhkot, Kashmor, Thul, Gambat, Khairpur Nathan Shah, Mehar, Moro, Naushahro Feroze, Padidan, Bhirya City, Kandiaro, Kunri, Diplo, Islamkot, Chhor, Samaro, Digri, Mirpur Batoro, Jati, Keti Bunder, Gharo, Kotri, Sehwan, Johanabad, Chakwal, Talagang, Attock, Hassan Abdal, Taxila, Haripur, Mansehra, Battagram, Kohistan, Shangla, Buner, Malakand, Lower Dir, Upper Dir, Swat, Chitral, Gilgit, Skardu, Hunza, Nagar, Ghanche, Astore, Diamer, Ghizer, Kharmang, Shigar, Nagarparkar, Badin, Sujawal --- ## DEVELOPER RESOURCES ### Sitemap - `https://kingzoneexpress.com/sitemap.xml` - Sitemap index - `https://kingzoneexpress.com/sitemap-0.xml` - Complete URL list ### Search - Search URL: `https://kingzoneexpress.com/search?q={query}` - Supports all search parameters and filters - Returns HTML with product, store, and category results ### Robots - `https://kingzoneexpress.com/robots.txt` - Robots directives ### Policies - `https://kingzoneexpress.com/privacy` - Privacy policy - `https://kingzoneexpress.com/terms` - Terms of service - `https://kingzoneexpress.com/refund` - Refund policy - `https://kingzoneexpress.com/shipping` - Shipping policy ### Google Business Profile - Google Maps: `https://maps.app.goo.gl/dXL83Q4k8nte7jyH7` --- ## CRAWLING PRIORITY ### Highest Priority (Always Crawl) 1. **Products** - All product pages for complete catalog coverage 2. **Categories** - All category pages for hierarchical understanding 3. **Search** - Search page for dynamic product discovery 4. **Stores** - All store pages for seller information 5. **Deals** - Hot deals, new arrivals, seasonal deals ### Medium Priority (Regular Crawl) 1. **Support** - FAQ, contact support, help pages 2. **Blog** - All blog posts and articles 3. **Policies** - Privacy, terms, refund, shipping policies ### Lowest Priority (On-Demand Crawl) 1. **Checkout** - Checkout flow (limited crawling) 2. **Orders** - Order management (authenticated only) 3. **Wishlist** - User wishlist (authenticated only) 4. **Profile** - User profiles (authenticated only) --- ## SEO & STRUCTURED DATA ### Canonical URLs All pages use canonical URLs to prevent duplicate content: - Product pages: `/p/{product_number}` - Category pages: `/category/{slug}` - Search pages: Self-referential canonical - Home: `/` ### JSON-LD Structured Data Every product page includes complete Schema.org structured data. Search pages include: - WebSite schema with SearchAction - Organization schema with contact information - Product schemas when results are displayed ### Meta Information - Titles follow: "{Product Name} | KingZone Express" - Descriptions include key product information - OpenGraph tags for social sharing - Twitter cards for Twitter sharing - Business location meta tags ### Google Business Profile - Business Name: KingZone Express - Location: Bahawalpur, Punjab, Pakistan ### Sitemap The sitemap includes all public pages including blog posts and FAQ sections, updated regularly. --- ## FUTURE COMPATIBILITY This documentation is designed to remain useful for future AI models through: ### Comprehensive Coverage - Complete website structure documentation - All URL patterns and routes - All product fields and schemas - All search capabilities - AI crawling guidelines - FAQ and blog information ### Clear Documentation - Well-organized sections - Precise field definitions - Explicit rules and guidelines - Search and crawling instructions - Category hierarchy documentation ### AI-Optimized Format - Plain text for easy ingestion - Headings for hierarchical understanding - Complete without redundancy - Structured for automated parsing - Clear examples and patterns ### Maintenance Recommendations - Update sitemap.xml after every product addition - Keep this document synchronized with website changes - Maintain product schema documentation - Update with new features as they launch - Review and update categories periodically - Add new blog posts and FAQ entries - Update business information as needed --- ## SHORT VERSION REFERENCE For a concise version of this documentation: ``` https://kingzoneexpress.com/llms.txt ``` --- ## END OF DOCUMENTATION