Feat: Implement V2 API-driven conversational AI system using Gemini 2.5 Flash Lite model

This commit marks a complete architectural overhaul of the project,
migrating from a simple prototype & mvp (v1) to a professional,
decoupled system (v2).

Key changes include:

- Establishes a professional project structure with distinct directories
for `v1_self_hosted_rag` and `v2_multilingual_api`.

- Implements the V2 backend as a secure FastAPI application, featuring:
- An advanced retrieve-and-re-rank pipeline with Pinecone and a
Cross-Encoder model for high-quality context retrieval.
- Integration with the Google Gemini API for state-of-the-art
generative responses.
- Full multilingual support for English and Malay.

- Develops the V2 frontend as a modern Streamlit chat interface that
communicates with the backend API and manages conversation state.

- Introduces a secure method for handling API keys using a `.env`
file for local development, which is protected by `.gitignore`.

This lays the foundation for all future development and deployment of
the v2 application.

.gitignore

@@ -12,133 +12,10 @@ __pycache__/
 # Jupyter Notebook checkpoints
 .ipynb_checkpoints/
 
-# Distribution / packaging
-*.egg-info/
-dist/
-build/
-wheels/
-*.tar.gz
-*.whl
-
-# Logs and reports
-*.log
-*.html # Ignore generated reports like profiling
-
-# IDE / OS specific
-.vscode/
-.idea/
-*.DS_Store
-Thumbs.db
-
-# Output directories / Large Files (IGNORED)
-malay-qa-model-finetuned/ # Ignore large saved fine-tuned model
-models/ # Generic models folder often ignored
-# *.joblib # Ignore generic joblib files (like from P1)
-# *.pkl # Ignore generic pickle files
-.hf_cache_st/ # Ignore downloaded embedding model cache
-.cache_st/ # Ignore downloaded embedding model cache (alternative name used)
-.dvc/cache # Ignore DVC cache if DVC is used
-
-# --- Files/Folders to *KEEP* for P3 Deployment ---
-# Ensure these lines are COMMENTED OUT or DELETED:
-# faiss_malay_ecommerce_kb_index/
-# knowledge_base/
-# squad_format_qa_pairs.json # Keep the source data JSON
-# ecommerce_malay_qa.csv # Keep source data CSV (optional if JSON is primary)
-
-# --- Other Ignores ---
-# *.zip # Keep commented if you might commit small zip files
-# *.png # Keep commented if you need specific image assets in repo
-# *.jpg # Keep commented if you need specific image assets in repo
-# app_old.py # Good to ignore backups
-# app_v*.py # Good to ignore backups
-
-# Add these cache folders
-.cache_st/
-.hf_cache_st/
-.hf_cache_st_test/
-
-# Add model output
-malay-qa-model-finetuned/
-
-# Add archives and specific media/temp files if not covered by *.ext
-*.zip
-*.png
-*.jpg
-Untitled.ipynb
-app_old.py
-app_v*.py # Covers app_v2.py, app_v3.2.py etc.
-drive1.png
-ecommerce_malay_qa.csv # Ignore CSV if JSON is source
-first*.png
-hf*.png
-inspo*.png
-latest*.png
-new*.png
-revolab*.png
-streamlit*.png
-ui*.jpg
-uiux*.png
-app_v3.py
-app_new.py
-
-# Ensure these are still ignored
+# Python virtual environment
 p3env/
 __pycache__/
 *.pyc
-# Ensure these are NOT ignored (remove lines if present)
-# faiss_malay_ecommerce_kb_index/
-# knowledge_base/
-
-# Ignore old app versions/duplicates
-app2.py
-app_v*.py
-*_needtofix.py
-*_testing.py
-
-# Ignore temporary/debug scripts
-debug_*.py
-custom_embedder.py # Assuming this was temporary
-
-# Ignore copies
-*Copy.txt
-*copy.txt
-
-# Ignore other potentially unwanted files/folders
-# Add anything else specific here
-
-# --- Ensure these are NOT ignored ---
-# Make sure lines starting with '#' are before these if they existed:
-# !faiss_malay_ecommerce_kb_index/ # Example if it was ignored before
-# !knowledge_base/
-
-# Ignore temporary/debug scripts
-# debug_*.py
-# custom_embedder.py
-
-# Ignore copies
-*Copy.txt
-
-# Ignore old app versions if any (based on previous issues)
-app_v*.py
-*_testing.py
-app2.py # If this was an old version
-
-
-# --- Ensure essential files/folders are NOT ignored ---
-!app.py
-!reindex.py
-!01-FineTuning-QA.ipynb
-!02-RAG-Pipeline.ipynb
-!requirements.txt
-!README.md
-!faiss_malay_ecommerce_kb_index/
-!knowledge_base/
-!squad_format_qa_pairs.json
-!ecommerce_malay_qa.csv
-#.gitattributes # Usually added by LFS, not manual ignore
-
-/p3env2/
-p3env2/
 
-.mailmap
+# Local secret file for v2
+.env

README.md

@@ -1,16 +1,23 @@
+# Advanced Conversational AI for E-Commerce: V1 vs. V2
+
+This repository showcases the evolution of a RAG-based chatbot, demonstrating a clear progression from a self-hosted prototype (v1) to a professional, API-driven conversational AI (v2).
+
 ---
-title: Bot Bantuan E-Dagang (Malay QA)
-emoji: 🛍️🇲🇾
-colorFrom: blue
-colorTo: indigo
-sdk: streamlit
-app_file: app_v3.py
-pinned: false
-# Add python_version if needed, e.g.:
-# python_version: 3.11
+
+## V2: The Professional Multilingual Assistant (API-Driven)
+
+This version represents a modern, production-ready system built on a decoupled architecture with full support for English and Malay.
+
+*   **Architecture (`/v2_multilingual_api`):**
+    *   **Backend:** A secure FastAPI server implementing an advanced **Retrieve-and-Re-rank** pipeline. It uses multilingual models, Pinecone for vector storage, and the Google Gemini API for generation.
+    *   **Frontend:** A responsive Streamlit chat interface.
+*   **Knowledge Base:** `/knowledge_base/v2_multilingual`
+
 ---
 
-# Malay E-commerce QA Bot (Project 3)
+## V1: The Self-Hosted Prototype (Malay-Only)
+
+This version is the original project, serving as a technical baseline.
 
-Simple RAG demo using LangChain, FAISS, MiniLM, and MT5-Small.
-Knowledge base focuses on Lazada/Shopee policies.
+*   **Architecture (`/v1_malay_selfhosted`):** A single Streamlit application using a self-hosted `mt5-small` model and a local FAISS index.
+*   **Knowledge Base:** `/knowledge_base/v1_malay`

debug_retriever.py

@@ -1,99 +0,0 @@
-# --- debug_retriever.py ---
-import os
-import torch
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_community.vectorstores import FAISS
-import time
-import numpy as np # Keep imports needed
-# from sklearn.metrics.pairwise import cosine_similarity # Uncomment if using direct similarity check
-
-# --- Configuration ---
-INDEX_PATH = "faiss_malay_ecommerce_kb_index"
-EMBEDDING_MODEL_NAME = "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2" # Back to MiniLM
-SEARCH_TYPE = "similarity" # Testing Similarity Search
-SEARCH_K = 5
-
-test_queries = [
-    "Status Penghantaran",
-    "Berapa lama tempoh pemulangan LazMall?",
-    "Adakah produk ini original?",
-    "Lazmall",
-    "Hi"
-]
-
-print("--- Starting Retriever Debug Script ---")
-
-# --- Load Embedding Model ---
-print(f"\nLoading embedding model: {EMBEDDING_MODEL_NAME}...")
-try:
-    device = 'cuda' if torch.cuda.is_available() else 'cpu'
-    embeddings = HuggingFaceEmbeddings(
-        model_name=EMBEDDING_MODEL_NAME,
-        model_kwargs={'device': device}
-    )
-    print(f">> Embedding model loaded on {device}.")
-except Exception as e:
-    print(f"FATAL: Error loading embedding model: {e}")
-    exit()
-
-# --- Load FAISS Index ---
-print(f"\nLoading FAISS index from: {INDEX_PATH}...")
-vector_store = None # Initialize vector_store
-if not os.path.exists(INDEX_PATH):
-    print(f"FATAL: FAISS index not found at {INDEX_PATH}. Run reindex.py first!")
-    exit()
-try:
-    vector_store = FAISS.load_local(
-        INDEX_PATH,
-        embeddings,
-        allow_dangerous_deserialization=True
-    )
-    print(f">> FAISS index loaded. Contains {vector_store.index.ntotal} vectors.")
-except Exception as e:
-    print(f"FATAL: Error loading FAISS index: {e}")
-    exit()
-
-# --- Create Retriever ---
-print(f"\nCreating retriever (Type: {SEARCH_TYPE}, k: {SEARCH_K})...")
-retriever = None # <<< Initialize retriever to None >>>
-if vector_store: # Ensure vector_store loaded successfully
-    try:
-        retriever = vector_store.as_retriever( # <<< Define retriever here >>>
-            search_type=SEARCH_TYPE,
-            search_kwargs={'k': SEARCH_K}
-        )
-        print(f">> Retriever created (Type: {SEARCH_TYPE}, k: {SEARCH_K}).") # Correct indentation
-    except Exception as e:
-        print(f"FATAL: Error creating retriever: {e}")
-        # No exit() here yet, let the check below handle it
-
-# --- Check if Retriever Creation Succeeded BEFORE Testing ---
-if not retriever: # <<< Add this check >>>
-    print("\nFATAL: Retriever object was not created successfully. Exiting.")
-    exit()
-
-# --- Test Queries ---
-print("\n--- Testing Queries ---")
-for query in test_queries:
-    print(f"\n>>> Testing Query: '{query}'")
-    try:
-        start_time = time.time()
-        # Now 'retriever' is guaranteed to exist if we reached here
-        retrieved_docs = retriever.invoke(query)
-        end_time = time.time()
-        print(f"    Time taken: {end_time - start_time:.2f} seconds")
-        print(f"    Retrieved {len(retrieved_docs)} documents.")
-
-        if retrieved_docs:
-            for i, doc in enumerate(retrieved_docs):
-                print(f"\n    --- Doc {i+1} ---")
-                print(f"    Source: {doc.metadata.get('source', 'N/A')}")
-                print(f"    Content Snippet: {doc.page_content[:250]}...")
-        else:
-            print("    !!! No documents retrieved !!!")
-
-    except Exception as e:
-        # This except block should now only catch errors from .invoke()
-        print(f"    ERROR running retriever invoke() for query '{query}': {e}")
-
-print("DEBUG SCRIPTED FINISHED")

knowledge_base/v2_multilingual/01_platform_and_account_en.md

@@ -0,0 +1,123 @@
+# Platform and Account Management
+
+Welcome to AuraCart! This document provides a comprehensive guide to managing your AuraCart account, from creation to security best practices.
+
+## 1. Account Creation
+
+Creating an AuraCart account is quick, free, and opens up a world of shopping possibilities.
+
+### How to Create an AuraCart Account
+
+To create a new account:
+1.  **Download the AuraCart App** from the App Store (iOS) or Google Play Store (Android), or visit the AuraCart website (www.auracart.com).
+2.  On the homepage, click on "Sign Up" or "Register".
+3.  You will be prompted to provide:
+    *   Your mobile number (for verification) or email address.
+    *   A secure password.
+4.  A One-Time Password (OTP) will be sent to your registered mobile number or email address for verification. Enter this OTP into the AuraCart platform.
+5.  Once verified, your AuraCart account is successfully created. You can now start exploring AuraMall and other features.
+
+### Information Required for Registration
+
+*   **Mobile Number or Email Address:** Essential for account verification and communication.
+*   **Password:** Must be at least 8 characters long, including a mix of uppercase and lowercase letters, numbers, and symbols for strong security.
+*   **Optional Information:** You may be asked for your name during initial setup or when completing your profile later.
+
+## 2. Login Procedures
+
+Accessing your AuraCart account is straightforward and secure.
+
+### How to Log In
+
+1.  **Open the AuraCart App** or visit the AuraCart website.
+2.  Click on "Login" or "Sign In".
+3.  Enter your registered mobile number/email address and password.
+4.  Click "Log In".
+
+### Troubleshooting Login Issues
+
+*   **Incorrect Password:** If you receive an "incorrect password" error, double-check your input or proceed with a password reset (see section 3).
+*   **Incorrect Username/Email:** Ensure you are using the mobile number or email address registered with your AuraCart account.
+*   **Account Locked:** For security reasons, multiple failed login attempts may temporarily lock your account. Wait for the specified time or contact AuraCart Customer Support.
+*   **No OTP Received:** Check your spam/junk folder for emails, or ensure your mobile number is correctly entered. You may request to resend the OTP after a short waiting period.
+
+## 3. Password Resets
+
+If you forget your password, you can easily reset it to regain access to your account.
+
+### How to Reset Your Password
+
+1.  On the AuraCart login page, click on "Forgot Password?".
+2.  Enter the mobile number or email address associated with your AuraCart account.
+3.  A verification code (OTP) will be sent to your registered mobile number or email.
+4.  Enter the OTP into the provided field.
+5.  You will then be prompted to create a new password. Choose a strong, unique password that you haven't used before.
+6.  Confirm your new password and click "Reset Password". Your password will be updated immediately.
+
+### Password Security Recommendations
+
+*   **Strong Passwords:** Always use a combination of uppercase and lowercase letters, numbers, and symbols.
+*   **Unique Passwords:** Do not reuse passwords across multiple online services.
+*   **Regular Updates:** Consider changing your password periodically, especially if you suspect any unauthorized access.
+
+## 4. Profile Management
+
+Managing your profile allows you to keep your personal information, shipping addresses, and payment methods up-to-date for a seamless shopping experience.
+
+### Updating Personal Information
+
+1.  Log in to your AuraCart account.
+2.  Navigate to "My Account" or your profile icon.
+3.  Select "Profile Settings" or "Personal Information".
+4.  You can update details such as:
+    *   **Name:** Your preferred name.
+    *   **Email Address:** Your primary email for communications.
+    *   **Mobile Number:** Your primary contact number (may require re-verification for security).
+5.  Save changes after updating.
+
+### Managing Shipping Addresses
+
+*   **Adding a New Address:**
+    1.  Go to "My Account" > "Addresses".
+    2.  Click "Add New Address".
+    3.  Enter the recipient's name, full street address, landmark (optional), city, state/province, postal code, and contact number.
+    4.  You can set this as your default shipping address.
+*   **Editing or Deleting an Address:**
+    1.  From "My Account" > "Addresses", select the address you wish to modify.
+    2.  Click "Edit" to update details or "Delete" to remove it.
+*   **Default Address:** Set a default address for faster checkout. You can always change it during the checkout process.
+
+### Managing Payment Methods
+
+AuraCart supports various secure payment methods, including AuraWallet.
+
+1.  Go to "My Account" > "Payment Methods" or "AuraWallet".
+2.  You can:
+    *   **Link AuraWallet:** Connect and manage your AuraWallet for seamless transactions and earning AuraCoins.
+    *   **Add Credit/Debit Cards:** Securely save your card details for future purchases (card verification may be required).
+    *   **Manage Bank Accounts:** Link bank accounts for direct transfers if applicable for certain services.
+3.  Your payment information is encrypted and stored securely by AuraCart.
+
+## 5. Account Security Best Practices
+
+AuraCart is committed to protecting your account, but your vigilance is key.
+
+### Strong Passwords and Two-Factor Authentication (2FA)
+
+*   **Create Strong, Unique Passwords:** As mentioned in Section 3, use a mix of characters and avoid common words.
+*   **Enable 2FA:** AuraCart strongly recommends enabling Two-Factor Authentication (2FA) for an added layer of security. This requires a verification code (sent to your phone or email) in addition to your password when logging in from a new device. You can enable 2FA in your "Security Settings" under "My Account".
+
+### Recognizing and Avoiding Phishing Attempts
+
+*   **Be Skeptical of Suspicious Emails/Messages:** AuraCart will never ask for your password, OTP, or full credit card details via email or unsolicited messages.
+*   **Check Sender and Links:** Always verify the sender's email address and hover over links before clicking to ensure they lead to legitimate AuraCart domains (e.g., auracart.com).
+*   **Report Suspected Phishing:** If you receive a suspicious communication purporting to be from AuraCart, please report it immediately to AuraCart Customer Support.
+
+### Protecting Your Devices
+
+*   **Keep Software Updated:** Ensure your operating system, web browser, and antivirus software are up-to-date on all devices used to access AuraCart.
+*   **Secure Your Wi-Fi:** Use a strong, unique password for your home Wi-Fi network. Avoid accessing your account on public, unsecured Wi-Fi networks.
+*   **Log Out After Use:** Especially on shared or public computers, always log out of your AuraCart account when you are finished.
+*   **Monitor Account Activity:** Regularly check your order history and AuraWallet transactions for any suspicious activity. If you notice anything unusual, contact AuraCart Customer Support immediately.
+
+By following these guidelines, you can ensure a secure and smooth experience on AuraCart.

knowledge_base/v2_multilingual/01_platform_and_account_my.md

@@ -0,0 +1,123 @@
+# Pengurusan Platform dan Akaun
+
+Selamat datang ke AuraCart! Dokumen ini menyediakan panduan komprehensif untuk menguruskan akaun AuraCart anda, daripada penciptaan hingga amalan terbaik keselamatan.
+
+## 1. Penciptaan Akaun
+
+Mencipta akaun AuraCart adalah pantas, percuma, dan membuka dunia kemungkinan membeli-belah.
+
+### Cara Membuat Akaun AuraCart
+
+Untuk membuat akaun baharu:
+1.  **Muat Turun Aplikasi AuraCart** dari App Store (iOS) atau Google Play Store (Android), atau lawati laman web AuraCart (www.auracart.com).
+2.  Di halaman utama, klik "Sign Up" atau "Register".
+3.  Anda akan diminta untuk menyediakan:
+    *   Nombor telefon bimbit anda (untuk pengesahan) atau alamat e-mel.
+    *   Kata laluan yang selamat.
+4.  Kata Laluan Sekali Sahaja (OTP) akan dihantar ke nombor telefon bimbit atau alamat e-mel berdaftar anda untuk pengesahan. Masukkan OTP ini ke dalam platform AuraCart.
+5.  Setelah disahkan, akaun AuraCart anda berjaya dicipta. Anda kini boleh mula meneroka AuraMall dan ciri-ciri lain.
+
+### Maklumat Diperlukan untuk Pendaftaran
+
+*   **Nombor Telefon Bimbit atau Alamat E-mel:** Penting untuk pengesahan akaun dan komunikasi.
+*   **Kata Laluan:** Mesti sekurang-kurangnya 8 aksara panjang, termasuk campuran huruf besar dan huruf kecil, nombor, dan simbol untuk keselamatan yang kuat.
+*   **Maklumat Pilihan:** Anda mungkin diminta untuk nama anda semasa persediaan awal atau apabila melengkapkan profil anda kemudian.
+
+## 2. Prosedur Log Masuk
+
+Mengakses akaun AuraCart anda adalah mudah dan selamat.
+
+### Cara Log Masuk
+
+1.  **Buka Aplikasi AuraCart** atau lawati laman web AuraCart.
+2.  Klik "Login" atau "Sign In".
+3.  Masukkan nombor telefon bimbit/alamat e-mel berdaftar anda dan kata laluan.
+4.  Klik "Log In".
+
+### Penyelesaian Masalah Log Masuk
+
+*   **Kata Laluan Salah:** Jika anda menerima ralat "kata laluan salah", semak semula input anda atau teruskan dengan penetapan semula kata laluan (lihat seksyen 3).
+*   **Nama Pengguna/E-mel Salah:** Pastikan anda menggunakan nombor telefon bimbit atau alamat e-mel yang didaftarkan dengan akaun AuraCart anda.
+*   **Akaun Terkunci:** Atas sebab keselamatan, beberapa percubaan log masuk yang gagal mungkin mengunci akaun anda sementara. Tunggu masa yang ditetapkan atau hubungi Sokongan Pelanggan AuraCart.
+*   **Tiada OTP Diterima:** Semak folder spam/junk anda untuk e-mel, atau pastikan nombor telefon bimbit anda dimasukkan dengan betul. Anda boleh meminta untuk menghantar semula OTP selepas tempoh menunggu yang singkat.
+
+## 3. Penetapan Semula Kata Laluan
+
+Jika anda terlupa kata laluan anda, anda boleh menetapkannya semula dengan mudah untuk mendapatkan semula akses kepada akaun anda.
+
+### Cara Menetapkan Semula Kata Laluan Anda
+
+1.  Di halaman log masuk AuraCart, klik "Forgot Password?".
+2.  Masukkan nombor telefon bimbit atau alamat e-mel yang dikaitkan dengan akaun AuraCart anda.
+3.  Kod pengesahan (OTP) akan dihantar ke nombor telefon bimbit atau e-mel berdaftar anda.
+4.  Masukkan OTP ke dalam medan yang disediakan.
+5.  Anda kemudian akan diminta untuk mencipta kata laluan baharu. Pilih kata laluan yang kuat dan unik yang belum pernah anda gunakan sebelum ini.
+6.  Sahkan kata laluan baharu anda dan klik "Reset Password". Kata laluan anda akan dikemas kini serta-merta.
+
+### Cadangan Keselamatan Kata Laluan
+
+*   **Kata Laluan Kuat:** Sentiasa gunakan gabungan huruf besar dan huruf kecil, nombor, dan simbol.
+*   **Kata Laluan Unik:** Jangan gunakan semula kata laluan di pelbagai perkhidmatan dalam talian.
+*   **Kemas Kini Berkala:** Pertimbangkan untuk menukar kata laluan anda secara berkala, terutamanya jika anda mengesyaki sebarang akses tanpa kebenaran.
+
+## 4. Pengurusan Profil
+
+Menguruskan profil anda membolehkan anda memastikan maklumat peribadi, alamat penghantaran, dan kaedah pembayaran anda sentiasa terkini untuk pengalaman membeli-belah yang lancar.
+
+### Mengemas Kini Maklumat Peribadi
+
+1.  Log masuk ke akaun AuraCart anda.
+2.  Navigasi ke "My Account" atau ikon profil anda.
+3.  Pilih "Profile Settings" atau "Personal Information".
+4.  Anda boleh mengemas kini butiran seperti:
+    *   **Nama:** Nama pilihan anda.
+    *   **Alamat E-mel:** E-mel utama anda untuk komunikasi.
+    *   **Nombor Telefon Bimbit:** Nombor hubungan utama anda (mungkin memerlukan pengesahan semula untuk keselamatan).
+5.  Simpan perubahan selepas mengemas kini.
+
+### Menguruskan Alamat Penghantaran
+
+*   **Menambah Alamat Baharu:**
+    1.  Pergi ke "My Account" > "Addresses".
+    2.  Klik "Add New Address".
+    3.  Masukkan nama penerima, alamat jalan penuh, mercu tanda (pilihan), bandar, negeri/provinsi, kod pos, dan nombor hubungan.
+    4.  Anda boleh menetapkan ini sebagai alamat penghantaran lalai anda.
+*   **Mengedit atau Memadam Alamat:**
+    1.  Dari "My Account" > "Addresses", pilih alamat yang ingin anda ubah suai.
+    2.  Klik "Edit" untuk mengemas kini butiran atau "Delete" untuk memadamnya.
+*   **Alamat Lalai:** Tetapkan alamat lalai untuk pembayaran yang lebih pantas. Anda sentiasa boleh menukarnya semasa proses pembayaran.
+
+### Menguruskan Kaedah Pembayaran
+
+AuraCart menyokong pelbagai kaedah pembayaran yang selamat, termasuk AuraWallet.
+
+1.  Pergi ke "My Account" > "Payment Methods" atau "AuraWallet".
+2.  Anda boleh:
+    *   **Pautkan AuraWallet:** Sambungkan dan uruskan AuraWallet anda untuk transaksi yang lancar dan pendapatan AuraCoins.
+    *   **Tambah Kad Kredit/Debit:** Simpan butiran kad anda dengan selamat untuk pembelian masa depan (pengesahan kad mungkin diperlukan).
+    *   **Urus Akaun Bank:** Pautkan akaun bank untuk pemindahan langsung jika berkenaan untuk perkhidmatan tertentu.
+3.  Maklumat pembayaran anda disulitkan dan disimpan dengan selamat oleh AuraCart.
+
+## 5. Amalan Terbaik Keselamatan Akaun
+
+AuraCart komited untuk melindungi akaun anda, tetapi kewaspadaan anda adalah kunci.
+
+### Kata Laluan Kuat dan Pengesahan Dua Faktor (2FA)
+
+*   **Cipta Kata Laluan Kuat, Unik:** Seperti yang dinyatakan dalam Seksyen 3, gunakan gabungan aksara dan elakkan perkataan biasa.
+*   **Dayakan 2FA:** AuraCart sangat mengesyorkan mendayakan Pengesahan Dua Faktor (2FA) untuk lapisan keselamatan tambahan. Ini memerlukan kod pengesahan (dihantar ke telefon atau e-mel anda) sebagai tambahan kepada kata laluan anda apabila log masuk dari peranti baharu. Anda boleh mendayakan 2FA dalam "Security Settings" di bawah "My Account" anda.
+
+### Mengenali dan Mengelak Cubaan Pancingan Data (Phishing)
+
+*   **Berhati-hati dengan E-mel/Mesej Mencurigakan:** AuraCart tidak akan sekali-kali meminta kata laluan, OTP, atau butiran kad kredit penuh anda melalui e-mel atau mesej yang tidak diminta.
+*   **Semak Penghantar dan Pautan:** Sentiasa sahkan alamat e-mel penghantar dan layangkan kursor ke atas pautan sebelum mengklik untuk memastikan ia menuju ke domain AuraCart yang sah (contohnya, auracart.com).
+*   **Laporkan Pancingan Data yang Disyaki:** Jika anda menerima komunikasi mencurigakan yang mendakwa dari AuraCart, sila laporkannya dengan segera kepada Sokongan Pelanggan AuraCart.
+
+### Melindungi Peranti Anda
+
+*   **Kekalkan Perisian Dikemas Kini:** Pastikan sistem pengendalian, pelayar web, dan perisian antivirus anda sentiasa terkini pada semua peranti yang digunakan untuk mengakses AuraCart.
+*   **Selamatkan Wi-Fi Anda:** Gunakan kata laluan yang kuat dan unik untuk rangkaian Wi-Fi rumah anda. Elakkan mengakses akaun anda di rangkaian Wi-Fi awam yang tidak selamat.
+*   **Log Keluar Selepas Penggunaan:** Terutamanya pada komputer kongsi atau awam, sentiasa log keluar dari akaun AuraCart anda apabila anda selesai.
+*   **Pantau Aktiviti Akaun:** Sentiasa semak sejarah pesanan dan transaksi AuraWallet anda untuk sebarang aktiviti yang mencurigakan. Jika anda melihat sesuatu yang luar biasa, hubungi Sokongan Pelanggan AuraCart dengan segera.
+
+Dengan mengikuti garis panduan ini, anda boleh memastikan pengalaman yang selamat dan lancar di AuraCart.

knowledge_base/v2_multilingual/02_shopping_guide_en.md

@@ -0,0 +1,105 @@
+# Shopping Guide
+
+Welcome to AuraCart's comprehensive shopping guide! This document will walk you through the entire process of finding products, managing your shopping cart, applying discounts, and completing your purchase on AuraMall.
+
+## 1. How to Search for Products
+
+Finding what you need on AuraCart is easy and intuitive.
+
+### Using the Search Bar
+
+*   **Location:** The search bar is prominently located at the top of the AuraCart website or app interface.
+*   **Keywords:** Enter relevant keywords for the product you are looking for (e.g., "smartphone," "wireless headphones," "men's t-shirt").
+*   **Brand Names:** You can also search directly by brand name (e.g., "Samsung," "Nike").
+*   **Product ID/SKU:** If you have a specific product ID or SKU, you can use that for precise searches.
+
+### Browsing by Categories
+
+*   **Access Categories:** On the AuraCart homepage or navigation menu, you will find a list of main product categories (e.g., Electronics, Fashion, Home & Living, Groceries).
+*   **Sub-Categories:** Clicking on a main category will often reveal sub-categories to help you narrow down your search even further (e.g., Electronics > Mobile Phones > Android Phones).
+
+### Applying Filters for Refined Search
+
+Once you have searched or navigated to a category, you can refine your results using various filters:
+*   **Price Range:** Set a minimum and maximum price.
+*   **Brand:** Filter by specific brands available on AuraMall.
+*   **Rating:** Show products with a certain average customer rating.
+*   **Seller:** Filter by specific sellers or official stores.
+*   **Shipping Options:** Filter by local or international shipping, or products eligible for fast delivery.
+*   **Promotions:** See products eligible for specific promotions or discounts.
+*   **Features/Specifications:** For electronics or specific items, filter by color, size, capacity, etc.
+
+## 2. Using the Shopping Cart
+
+The shopping cart is where you collect items you intend to purchase.
+
+### Adding Items to Cart
+
+1.  **Product Page:** Once you've found an item you want to buy, navigate to its product details page.
+2.  **Select Options:** If applicable, choose variations like size, color, or quantity.
+3.  **"Add to Cart" Button:** Click the "Add to Cart" button. A confirmation message will usually appear, and the item will be added to your cart.
+4.  **Continue Shopping or View Cart:** You can continue browsing AuraMall or proceed to view your cart immediately.
+
+### Reviewing and Modifying Cart Items
+
+*   **Accessing Your Cart:** Click on the shopping cart icon (usually located at the top right corner of the page/app) to view your cart contents.
+*   **Quantity Adjustment:** Change the quantity of any item by using the "+" and "-" buttons or directly inputting the desired number.
+*   **Removing Items:** To remove an item, click the "Remove" or "Delete" button next to it.
+*   **Saving for Later:** Some items may have an option to "Save for Later," which moves them out of your immediate cart but keeps them saved for future consideration.
+
+## 3. Applying Promotional Vouchers and Discounts
+
+AuraCart offers various ways to save money on your purchases.
+
+### How to Apply a Voucher/Promo Code
+
+1.  **Voucher Collection:** Vouchers can often be collected directly from promotion banners on the AuraCart homepage, product pages, or seller stores.
+2.  **During Checkout:** When you proceed to the checkout page from your shopping cart, you will see a section for "Voucher Code" or "Apply Promo Code."
+3.  **Enter Code:** If you have a specific code, type it accurately into the field and click "Apply."
+4.  **Select Collected Voucher:** If you have collected a voucher, it will usually appear as an option to select from a list. Choose the voucher you wish to use.
+5.  **Verify Discount:** The discount will be applied to your total, and you will see the updated price before confirming your order.
+
+### Voucher Terms and Conditions
+
+*   **Eligibility:** Vouchers often have specific eligibility criteria, such as minimum spend, specific products/categories, or certain payment methods (e.g., AuraWallet exclusive).
+*   **Expiry Date:** All vouchers have an expiry date. Ensure you use them before they expire.
+*   **Usage Limit:** Vouchers may be limited to one per customer or one per transaction.
+*   **Non-Stackable:** Vouchers are generally not stackable, meaning you can typically only use one voucher per order. AuraCart automatically applies the best available discount if multiple are collected.
+*   **Refunds:** If an order purchased with a voucher is cancelled or returned, the voucher amount is usually not refunded, but the paid amount will be. Check specific voucher terms.
+
+## 4. The Complete Checkout Process
+
+Once you're ready to buy, the checkout process is streamlined for convenience.
+
+### Step 1: Review Your Order
+
+*   After clicking "Checkout" from your shopping cart, you will be taken to an order summary page.
+*   **Verify Items and Quantities:** Double-check all items and their quantities.
+*   **Shipping Address:** Confirm your default shipping address or select/add a new one. Ensure all details are correct to avoid delivery issues.
+*   **Select Shipping Option:** Choose your preferred shipping method if multiple options are available (e.g., standard, express).
+
+### Step 2: Select Payment Method
+
+AuraCart offers a variety of secure payment options:
+
+*   **AuraWallet:** For fast, seamless payments and potential exclusive discounts/AuraCoin earning opportunities. Ensure your AuraWallet has sufficient balance or is linked to a top-up source.
+*   **Credit/Debit Card:** Enter your card details securely. You may have the option to save your card for future purchases (encrypted).
+*   **Bank Transfer:** Follow instructions for direct bank transfers; this method may require manual verification and take longer for order confirmation.
+*   **Cash on Delivery (COD):** Available for selected products and locations. Please have the exact amount ready upon delivery.
+*   **Installment Plans:** For higher-value items, AuraCart may offer installment options through partnered banks/providers.
+
+### Step 3: Apply Vouchers and AuraCoins
+
+*   On the checkout page, locate the "Voucher" or "AuraCoins" section.
+*   **Voucher:** Select or input your desired voucher code (as detailed in section 3).
+*   **AuraCoins:** If you have sufficient AuraCoins, you will see an option to apply them to your purchase. You can choose to use all available AuraCoins or a specific amount. Each AuraCoin has a specific monetary value which will be displayed (e.g., 100 AuraCoins = $1).
+
+### Step 4: Place Order
+
+*   **Review Final Total:** Before confirming, carefully review the final breakdown, including item costs, shipping fees, applied discounts, and the total amount due.
+*   **Terms and Conditions:** By placing an order, you agree to AuraCart's Terms of Service and Privacy Policy.
+*   **"Place Order" / "Confirm Payment" Button:** Click this button to finalize your purchase.
+*   **Payment Gateway Redirection:** For card payments or bank transfers, you may be redirected to a secure payment gateway to complete the transaction.
+*   **Order Confirmation:** Upon successful payment, you will receive an order confirmation on the screen, typically with an order ID. An email confirmation will also be sent to your registered email address.
+
+Congratulations! Your AuraCart order is now placed. You can track its status in your "My Orders" section.

knowledge_base/v2_multilingual/02_shopping_guide_my.md

@@ -0,0 +1,105 @@
+# Panduan Membeli-belah
+
+Selamat datang ke panduan membeli-belah komprehensif AuraCart! Dokumen ini akan membimbing anda melalui keseluruhan proses mencari produk, menguruskan troli beli-belah anda, menggunakan diskaun, dan melengkapkan pembelian anda di AuraMall.
+
+## 1. Cara Mencari Produk
+
+Mencari apa yang anda perlukan di AuraCart adalah mudah dan intuitif.
+
+### Menggunakan Bar Carian
+
+*   **Lokasi:** Bar carian terletak dengan jelas di bahagian atas laman web AuraCart atau antara muka aplikasi.
+*   **Kata Kunci:** Masukkan kata kunci yang relevan untuk produk yang anda cari (contohnya, "telefon pintar," "fon kepala tanpa wayar," "t-shirt lelaki").
+*   **Nama Jenama:** Anda juga boleh mencari terus mengikut nama jenama (contohnya, "Samsung," "Nike").
+*   **ID Produk/SKU:** Jika anda mempunyai ID produk atau SKU tertentu, anda boleh menggunakannya untuk carian yang tepat.
+
+### Melayari Mengikut Kategori
+
+*   **Akses Kategori:** Di halaman utama AuraCart atau menu navigasi, anda akan menemui senarai kategori produk utama (contohnya, Elektronik, Fesyen, Kediaman & Kehidupan, Barangan Runcit).
+*   **Sub-Kategori:** Mengklik pada kategori utama sering kali akan mendedahkan sub-kategori untuk membantu anda mempersempitkan carian anda dengan lebih jauh (contohnya, Elektronik > Telefon Bimbit > Telefon Android).
+
+### Menggunakan Penapis untuk Carian Diperhalusi
+
+Setelah anda mencari atau menavigasi ke kategori, anda boleh memperhalusi hasil anda menggunakan pelbagai penapis:
+*   **Julat Harga:** Tetapkan harga minimum dan maksimum.
+*   **Jenama:** Tapis mengikut jenama tertentu yang tersedia di AuraMall.
+*   **Penilaian:** Tunjukkan produk dengan penilaian pelanggan purata tertentu.
+*   **Penjual:** Tapis mengikut penjual tertentu atau kedai rasmi.
+*   **Pilihan Penghantaran:** Tapis mengikut penghantaran tempatan atau antarabangsa, atau produk yang layak untuk penghantaran pantas.
+*   **Promosi:** Lihat produk yang layak untuk promosi atau diskaun tertentu.
+*   **Ciri-ciri/Spesifikasi:** Untuk elektronik atau barangan tertentu, tapis mengikut warna, saiz, kapasiti, dsb.
+
+## 2. Menggunakan Troli Beli-belah
+
+Troli beli-belah adalah tempat anda mengumpul barangan yang ingin anda beli.
+
+### Menambah Barangan ke Troli
+
+1.  **Halaman Produk:** Setelah anda menemui barangan yang ingin anda beli, navigasi ke halaman butiran produknya.
+2.  **Pilih Pilihan:** Jika berkenaan, pilih variasi seperti saiz, warna, atau kuantiti.
+3.  **Butang "Add to Cart":** Klik butang "Add to Cart". Mesej pengesahan biasanya akan muncul, dan barangan akan ditambahkan ke troli anda.
+4.  **Teruskan Membeli-belah atau Lihat Troli:** Anda boleh terus melayari AuraMall atau terus melihat troli anda dengan serta-merta.
+
+### Menyemak dan Mengubah Suai Barangan Troli
+
+*   **Mengakses Troli Anda:** Klik pada ikon troli beli-belah (biasanya terletak di sudut kanan atas halaman/aplikasi) untuk melihat kandungan troli anda.
+*   **Pelarasan Kuantiti:** Ubah kuantiti mana-mana barangan dengan menggunakan butang "+" dan "-" atau memasukkan terus nombor yang dikehendaki.
+*   **Mengeluarkan Barangan:** Untuk mengeluarkan barangan, klik butang "Remove" atau "Delete" di sebelahnya.
+*   **Menyimpan untuk Kemudian:** Sesetengah barangan mungkin mempunyai pilihan "Save for Later," yang memindahkannya keluar dari troli anda tetapi menyimpannya untuk pertimbangan masa depan.
+
+## 3. Menggunakan Baucar Promosi dan Diskaun
+
+AuraCart menawarkan pelbagai cara untuk menjimatkan wang pada pembelian anda.
+
+### Cara Menggunakan Baucar/Kod Promo
+
+1.  **Pengumpulan Baucar:** Baucar selalunya boleh dikumpul terus daripada sepanduk promosi di halaman utama AuraCart, halaman produk, atau kedai penjual.
+2.  **Semasa Pembayaran:** Apabila anda meneruskan ke halaman pembayaran dari troli beli-belah anda, anda akan melihat bahagian untuk "Voucher Code" atau "Apply Promo Code."
+3.  **Masukkan Kod:** Jika anda mempunyai kod tertentu, taipkan dengan tepat ke dalam medan dan klik "Apply."
+4.  **Pilih Baucar yang Dikumpul:** Jika anda telah mengumpul baucar, ia biasanya akan muncul sebagai pilihan untuk dipilih daripada senarai. Pilih baucar yang ingin anda gunakan.
+5.  **Sahkan Diskaun:** Diskaun akan dikenakan pada jumlah keseluruhan anda, dan anda akan melihat harga yang dikemas kini sebelum mengesahkan pesanan anda.
+
+### Terma dan Syarat Baucar
+
+*   **Kelayakan:** Baucar sering mempunyai kriteria kelayakan tertentu, seperti perbelanjaan minimum, produk/kategori tertentu, atau kaedah pembayaran tertentu (contohnya, eksklusif AuraWallet).
+*   **Tarikh Luput:** Semua baucar mempunyai tarikh luput. Pastikan anda menggunakannya sebelum ia luput.
+*   **Had Penggunaan:** Baucar mungkin terhad kepada satu setiap pelanggan atau satu setiap transaksi.
+*   **Tidak Boleh Ditindan:** Baucar umumnya tidak boleh ditindan, yang bermaksud anda biasanya hanya boleh menggunakan satu baucar setiap pesanan. AuraCart secara automatik akan menggunakan diskaun terbaik yang tersedia jika beberapa baucar dikumpul.
+*   **Bayaran Balik:** Jika pesanan yang dibeli dengan baucar dibatalkan atau dipulangkan, jumlah baucar biasanya tidak akan dikembalikan, tetapi jumlah yang dibayar akan dikembalikan. Semak terma baucar tertentu.
+
+## 4. Proses Pembayaran Lengkap
+
+Setelah anda bersedia untuk membeli, proses pembayaran dipermudahkan untuk kemudahan.
+
+### Langkah 1: Semak Pesanan Anda
+
+*   Selepas mengklik "Checkout" dari troli beli-belah anda, anda akan dibawa ke halaman ringkasan pesanan.
+*   **Sahkan Barangan dan Kuantiti:** Semak semula semua barangan dan kuantitinya.
+*   **Alamat Penghantaran:** Sahkan alamat penghantaran lalai anda atau pilih/tambah yang baharu. Pastikan semua butiran adalah betul untuk mengelakkan masalah penghantaran.
+*   **Pilih Pilihan Penghantaran:** Pilih kaedah penghantaran pilihan anda jika beberapa pilihan tersedia (contohnya, standard, ekspres).
+
+### Langkah 2: Pilih Kaedah Pembayaran
+
+AuraCart menawarkan pelbagai pilihan pembayaran yang selamat:
+
+*   **AuraWallet:** Untuk pembayaran yang pantas, lancar dan potensi diskaun eksklusif/peluang mendapatkan AuraCoins. Pastikan AuraWallet anda mempunyai baki yang mencukupi atau dipautkan kepada sumber tambah nilai.
+*   **Kad Kredit/Debit:** Masukkan butiran kad anda dengan selamat. Anda mungkin mempunyai pilihan untuk menyimpan kad anda untuk pembelian masa depan (disulitkan).
+*   **Pindahan Bank:** Ikut arahan untuk pindahan bank secara langsung; kaedah ini mungkin memerlukan pengesahan manual dan mengambil masa yang lebih lama untuk pengesahan pesanan.
+*   **Tunai Semasa Penghantaran (COD):** Tersedia untuk produk dan lokasi terpilih. Sila sediakan jumlah yang tepat semasa penghantaran.
+*   **Pelan Ansuran:** Untuk barangan bernilai tinggi, AuraCart mungkin menawarkan pilihan ansuran melalui bank/penyedia rakan kongsi.
+
+### Langkah 3: Gunakan Baucar dan AuraCoins
+
+*   Di halaman pembayaran, cari bahagian "Voucher" atau "AuraCoins".
+*   **Baucar:** Pilih atau masukkan kod baucar yang anda inginkan (seperti yang diperincikan dalam seksyen 3).
+*   **AuraCoins:** Jika anda mempunyai AuraCoins yang mencukupi, anda akan melihat pilihan untuk menggunakannya pada pembelian anda. Anda boleh memilih untuk menggunakan semua AuraCoins yang tersedia atau jumlah tertentu. Setiap AuraCoin mempunyai nilai monetari tertentu yang akan dipaparkan (contohnya, 100 AuraCoins = $1).
+
+### Langkah 4: Buat Pesanan
+
+*   **Semak Jumlah Akhir:** Sebelum mengesahkan, semak dengan teliti pecahan akhir, termasuk kos barangan, yuran penghantaran, diskaun yang digunakan, dan jumlah keseluruhan yang perlu dibayar.
+*   **Terma dan Syarat:** Dengan membuat pesanan, anda bersetuju dengan Terma Perkhidmatan dan Dasar Privasi AuraCart.
+*   **Butang "Place Order" / "Confirm Payment":** Klik butang ini untuk memuktamadkan pembelian anda.
+*   **Pengalihan Gerbang Pembayaran:** Untuk pembayaran kad atau pindahan bank, anda mungkin dialihkan ke gerbang pembayaran yang selamat untuk melengkapkan transaksi.
+*   **Pengesahan Pesanan:** Setelah pembayaran berjaya, anda akan menerima pengesahan pesanan pada skrin, biasanya dengan ID pesanan. Pengesahan e-mel juga akan dihantar ke alamat e-mel berdaftar anda.
+
+Tahniah! Pesanan AuraCart anda kini telah dibuat. Anda boleh menjejaki statusnya dalam bahagian "My Orders" anda.

knowledge_base/v2_multilingual/03_shipping_and_delivery_en.md

@@ -0,0 +1,101 @@
+# Shipping and Delivery
+
+This document provides a comprehensive guide to understanding AuraCart's shipping and delivery processes, from tracking your order to what to do if your item doesn't arrive as expected.
+
+## 1. Order Tracking
+
+Keeping track of your purchase is easy with AuraCart's integrated tracking system.
+
+### How to Track Your Order
+
+1.  **Log In to Your Account:** Access your AuraCart account through the app or website.
+2.  **Navigate to "My Orders":** From your dashboard or profile, select "My Orders" or "Order History."
+3.  **Select the Order:** Find the specific order you wish to track.
+4.  **View Tracking Details:** Click on the order. You will see its current status and a "Track Shipment" button or direct tracking information. This will display detailed real-time updates from the logistics partner.
+
+### Tracking Number and Updates
+
+*   **Tracking Number:** A unique tracking number is automatically assigned to your order once it has been shipped by the seller. This number is accessible within your order details.
+*   **Update Frequency:** Tracking information is updated regularly by the shipping carrier. Updates typically occur when the package reaches a new checkpoint (e.g., departing a sorting facility, arriving at a local hub, out for delivery).
+*   **Information Provided:** The tracking page will show the current location of your package, estimated delivery date (if available), and a history of its journey.
+
+## 2. Understanding Order Statuses
+
+Your order will move through several statuses from purchase to delivery. Here's what each status means:
+
+*   **Pending Payment:** Your order has been placed, but payment is still being processed or has not yet been completed.
+*   **Processing / Awaiting Shipment:** Your payment has been confirmed, and the seller is preparing your order for shipment (e.g., picking, packing).
+*   **Shipped / In Transit:** Your order has been handed over to the logistics partner and is on its way to your delivery address. You can typically begin tracking your order at this stage.
+*   **Out for Delivery:** Your package has arrived at the local delivery hub and is with a courier for final delivery to your address.
+*   **Delivered:** Your package has been successfully delivered to the specified address.
+*   **Cancelled:** The order has been cancelled, either by the buyer, seller, or AuraCart. Reasons may include payment issues, item unavailability, or buyer request.
+*   **Return Initiated:** The buyer has initiated a return request for the item.
+*   **Return Approved / Rejected:** The return request has been reviewed and either approved or denied.
+*   **Refunded:** A refund has been processed for your order, either due to a return, cancellation, or other resolution.
+
+## 3. Estimated Delivery Times
+
+Delivery times on AuraCart depend on several factors, including the seller's location, your delivery address, the type of product, and the chosen shipping method.
+
+### Domestic Shipping (within the same country)
+
+*   **Standard Shipping:**
+    *   **Within Major Cities:** Typically 2-5 business days.
+    *   **Inter-city / Remote Areas:** Typically 5-10 business days.
+*   **Express Shipping (if available):**
+    *   **Within Major Cities:** Often 1-2 business days.
+*   **Factors Affecting Domestic Delivery:**
+    *   **Seller Processing Time:** Time taken by the seller to prepare and hand over the item to the courier.
+    *   **Logistics Partner Efficiency:** The speed of the selected courier service.
+    *   **Public Holidays & Weekends:** Deliveries do not typically occur on public holidays or weekends, extending delivery times.
+    *   **Unforeseen Circumstances:** Extreme weather, natural disasters, or major public events can cause delays.
+
+### International Shipping (cross-border)
+
+*   **Standard International Shipping:**
+    *   Typically 7-25 business days, varying significantly by origin and destination country.
+*   **Express International Shipping (if available):**
+    *   Can be faster, often 3-7 business days, but at a higher cost.
+*   **Factors Affecting International Delivery:**
+    *   **Customs Clearance:** Packages must pass through customs in both the origin and destination countries, which can sometimes cause significant delays.
+    *   **Import Duties & Taxes:** Buyers are responsible for any applicable import duties, taxes, or customs fees levied by the destination country's customs authorities. These are not included in the item price or shipping cost and may need to be paid upon delivery.
+    *   **International Logistics:** The complexity of international shipping networks.
+
+### General Notes on Delivery Times
+
+*   **Business Days:** All estimated delivery times refer to business days (Monday to Friday, excluding public holidays).
+*   **Estimates Only:** The provided delivery times are estimates. While AuraCart and its logistics partners strive to meet them, occasional delays can occur.
+*   **Check Product Page:** Always refer to the estimated delivery time displayed on the product page and during checkout for the most accurate projection for your specific order.
+
+## 4. What to Do If Your Item Doesn't Arrive
+
+While rare, delays or lost packages can happen. Here's a step-by-step guide on how to proceed:
+
+### Step 1: Check Tracking and Estimated Delivery Time
+
+*   **Re-check "My Orders":** Go to your "My Orders" section and review the latest tracking updates.
+*   **Compare with ETA:** Cross-reference the current status with the estimated delivery date provided at the time of purchase. It's common for packages to arrive slightly after the initial estimate, especially during peak seasons.
+
+### Step 2: Verify Your Shipping Address
+
+*   **Accuracy Check:** Go to "My Account" > "Addresses" and ensure the shipping address provided for the order is accurate and complete, including unit numbers, street names, postal codes, and contact numbers. An incorrect address is a common reason for delivery issues.
+
+### Step 3: Check Around Your Delivery Location
+
+*   **Neighbors/Family Members:** Ask if a neighbor or family member might have received the package on your behalf.
+*   **Security/Building Management:** If you live in an apartment or gated community, check with your building's security or front desk.
+*   **Safe Place:** Couriers sometimes leave packages in a safe, hidden spot near your door if direct handover isn't possible. Check common "safe places" like behind a plant or near a back entrance.
+
+### Step 4: Contact AuraCart Customer Support
+
+*   **When to Contact:** If the estimated delivery time has passed by a reasonable margin (e.g., 3-5 business days beyond the latest estimate for domestic, or 5-7 business days for international) and you have completed the checks above, it's time to contact AuraCart Customer Support.
+*   **How to Contact:** Go to the "Customer Support" section of the AuraCart app or website and initiate a chat or submit a ticket, providing your order ID.
+*   **Information to Provide:** Be ready to provide your order number, details of what you've already checked, and any relevant tracking information.
+
+### Step 5: AuraCart's Buyer Protection
+
+*   **Dispute Resolution:** AuraCart is committed to ensuring you receive your orders. If an item is genuinely lost in transit or was never delivered, AuraCart's Buyer Protection program will assist in investigating the issue with the seller and courier.
+*   **Resolution:** Depending on the outcome of the investigation, you may be eligible for a full refund or a re-shipment of the item (subject to seller availability and policy).
+*   **Timelines:** Investigations may take some time, but AuraCart will keep you updated throughout the process.
+
+Your satisfaction is our priority, and we're here to help ensure your AuraCart experience is smooth and reliable.

knowledge_base/v2_multilingual/03_shipping_and_delivery_my.md

@@ -0,0 +1,101 @@
+# Penghantaran dan Penyerahan
+
+Dokumen ini menyediakan panduan komprehensif untuk memahami proses penghantaran dan penyerahan AuraCart, daripada penjejakan pesanan anda hingga tindakan yang perlu diambil jika item anda tidak tiba seperti yang dijangka.
+
+## 1. Penjejakan Pesanan
+
+Mengesan pembelian anda adalah mudah dengan sistem penjejakan bersepadu AuraCart.
+
+### Cara Menjejaki Pesanan Anda
+
+1.  **Log Masuk ke Akaun Anda:** Akses akaun AuraCart anda melalui aplikasi atau laman web.
+2.  **Navigasi ke "My Orders":** Dari papan pemuka atau profil anda, pilih "My Orders" atau "Order History."
+3.  **Pilih Pesanan:** Cari pesanan tertentu yang ingin anda jejaki.
+4.  **Lihat Butiran Penjejakan:** Klik pada pesanan. Anda akan melihat status semasa dan butang "Track Shipment" atau maklumat penjejakan terus. Ini akan memaparkan kemas kini masa nyata yang terperinci daripada rakan kongsi logistik.
+
+### Nombor Penjejakan dan Kemas Kini
+
+*   **Nombor Penjejakan:** Nombor penjejakan unik secara automatik diberikan kepada pesanan anda setelah dihantar oleh penjual. Nombor ini boleh diakses dalam butiran pesanan anda.
+*   **Kekerapan Kemas Kini:** Maklumat penjejakan dikemas kini secara berkala oleh pembawa penghantaran. Kemas kini biasanya berlaku apabila pakej mencapai pusat pemeriksaan baharu (contohnya, meninggalkan kemudahan pengasingan, tiba di hab tempatan, keluar untuk penghantaran).
+*   **Maklumat yang Disediakan:** Halaman penjejakan akan menunjukkan lokasi semasa pakej anda, anggaran tarikh penghantaran (jika tersedia), dan sejarah perjalanannya.
+
+## 2. Memahami Status Pesanan
+
+Pesanan anda akan melalui beberapa status dari pembelian hingga penyerahan. Berikut adalah maksud setiap status:
+
+*   **Pending Payment:** Pesanan anda telah dibuat, tetapi pembayaran masih dalam proses atau belum selesai.
+*   **Processing / Awaiting Shipment:** Pembayaran anda telah disahkan, dan penjual sedang menyediakan pesanan anda untuk penghantaran (contohnya, memilih, membungkus).
+*   **Shipped / In Transit:** Pesanan anda telah diserahkan kepada rakan kongsi logistik dan sedang dalam perjalanan ke alamat penghantaran anda. Anda biasanya boleh mula menjejaki pesanan anda pada peringkat ini.
+*   **Out for Delivery:** Pakej anda telah tiba di hab penghantaran tempatan dan bersama kurier untuk penghantaran akhir ke alamat anda.
+*   **Delivered:** Pakej anda telah berjaya dihantar ke alamat yang ditentukan.
+*   **Cancelled:** Pesanan telah dibatalkan, sama ada oleh pembeli, penjual, atau AuraCart. Sebab-sebab mungkin termasuk isu pembayaran, ketiadaan item, atau permintaan pembeli.
+*   **Return Initiated:** Pembeli telah memulakan permintaan pemulangan untuk item tersebut.
+*   **Return Approved / Rejected:** Permintaan pemulangan telah disemak dan sama ada diluluskan atau ditolak.
+*   **Refunded:** Bayaran balik telah diproses untuk pesanan anda, sama ada disebabkan oleh pemulangan, pembatalan, atau penyelesaian lain.
+
+## 3. Anggaran Masa Penghantaran
+
+Masa penghantaran di AuraCart bergantung kepada beberapa faktor, termasuk lokasi penjual, alamat penghantaran anda, jenis produk, dan kaedah penghantaran yang dipilih.
+
+### Penghantaran Domestik (dalam negara yang sama)
+
+*   **Penghantaran Standard:**
+    *   **Dalam Bandar-bandar Utama:** Biasanya 2-5 hari bekerja.
+    *   **Antara Bandar / Kawasan Pedalaman:** Biasanya 5-10 hari bekerja.
+*   **Penghantaran Ekspres (jika tersedia):**
+    *   **Dalam Bandar-bandar Utama:** Selalunya 1-2 hari bekerja.
+*   **Faktor-faktor yang Mempengaruhi Penghantaran Domestik:**
+    *   **Masa Pemprosesan Penjual:** Masa yang diambil oleh penjual untuk menyediakan dan menyerahkan item kepada kurier.
+    *   **Kecekapan Rakan Logistik:** Kelajuan perkhidmatan kurier yang dipilih.
+    *   **Cuti Umum & Hujung Minggu:** Penghantaran biasanya tidak berlaku pada cuti umum atau hujung minggu, memanjangkan masa penghantaran.
+    *   **Keadaan Luar Jangka:** Cuaca ekstrem, bencana alam, atau acara awam utama boleh menyebabkan kelewatan.
+
+### Penghantaran Antarabangsa (rentas sempadan)
+
+*   **Penghantaran Antarabangsa Standard:**
+    *   Biasanya 7-25 hari bekerja, berbeza secara signifikan mengikut negara asal dan destinasi.
+*   **Penghantaran Antarabangsa Ekspres (jika tersedia):**
+    *   Boleh lebih pantas, selalunya 3-7 hari bekerja, tetapi dengan kos yang lebih tinggi.
+*   **Faktor-faktor yang Mempengaruhi Penghantaran Antarabangsa:**
+    *   **Pelepasan Kastam:** Pakej mesti melalui kastam di kedua-dua negara asal dan destinasi, yang kadangkala boleh menyebabkan kelewatan yang signifikan.
+    *   **Duti Import & Cukai:** Pembeli bertanggungjawab untuk sebarang duti import, cukai, atau yuran kastam yang dikenakan oleh pihak berkuasa kastam negara destinasi. Ini tidak termasuk dalam harga item atau kos penghantaran dan mungkin perlu dibayar semasa penyerahan.
+    *   **Logistik Antarabangsa:** Kerumitan rangkaian penghantaran antarabangsa.
+
+### Nota Umum Mengenai Masa Penghantaran
+
+*   **Hari Perniagaan:** Semua anggaran masa penghantaran merujuk kepada hari bekerja (Isnin hingga Jumaat, tidak termasuk cuti umum).
+*   **Anggaran Sahaja:** Masa penghantaran yang diberikan adalah anggaran. Walaupun AuraCart dan rakan kongsi logistiknya berusaha untuk memenuhinya, kelewatan sekali-sekala boleh berlaku.
+*   **Semak Halaman Produk:** Sentiasa rujuk kepada anggaran masa penghantaran yang dipaparkan di halaman produk dan semasa pembayaran untuk unjuran yang paling tepat untuk pesanan khusus anda.
+
+## 4. Apa yang Perlu Dilakukan Jika Item Anda Tidak Tiba
+
+Walaupun jarang berlaku, kelewatan atau kehilangan pakej boleh terjadi. Berikut adalah panduan langkah demi langkah tentang cara untuk meneruskan:
+
+### Langkah 1: Semak Penjejakan dan Anggaran Masa Penghantaran
+
+*   **Semak Semula "My Orders":** Pergi ke bahagian "My Orders" anda dan semak kemas kini penjejakan terkini.
+*   **Bandingkan dengan ETA:** Bandingkan status semasa dengan anggaran tarikh penghantaran yang diberikan pada masa pembelian. Adalah biasa bagi pakej untuk tiba sedikit selepas anggaran awal, terutamanya semasa musim puncak.
+
+### Langkah 2: Sahkan Alamat Penghantaran Anda
+
+*   **Semakan Ketepatan:** Pergi ke "My Account" > "Addresses" dan pastikan alamat penghantaran yang diberikan untuk pesanan adalah tepat dan lengkap, termasuk nombor unit, nama jalan, kod pos, dan nombor hubungan. Alamat yang salah adalah sebab biasa untuk isu penghantaran.
+
+### Langkah 3: Semak Sekitar Lokasi Penghantaran Anda
+
+*   **Jiran/Ahli Keluarga:** Tanya sama ada jiran atau ahli keluarga mungkin telah menerima pakej bagi pihak anda.
+*   **Pengurusan Keselamatan/Bangunan:** Jika anda tinggal di pangsapuri atau komuniti berpagar, semak dengan keselamatan bangunan atau kaunter depan anda.
+*   **Tempat Selamat:** Kurier kadangkala meninggalkan pakej di tempat yang selamat dan tersembunyi berhampiran pintu anda jika penyerahan terus tidak dapat dilakukan. Semak "tempat selamat" biasa seperti di belakang pokok atau berhampiran pintu belakang.
+
+### Langkah 4: Hubungi Sokongan Pelanggan AuraCart
+
+*   **Bila Perlu Menghubungi:** Jika anggaran masa penghantaran telah berlalu dengan margin yang munasabah (contohnya, 3-5 hari bekerja melebihi anggaran terkini untuk domestik, atau 5-7 hari bekerja untuk antarabangsa) dan anda telah menyelesaikan semakan di atas, sudah tiba masanya untuk menghubungi Sokongan Pelanggan AuraCart.
+*   **Cara Menghubungi:** Pergi ke bahagian "Customer Support" aplikasi atau laman web AuraCart dan mulakan sembang atau serahkan tiket, berikan ID pesanan anda.
+*   **Maklumat untuk Disediakan:** Sediakan nombor pesanan anda, butiran apa yang telah anda semak, dan sebarang maklumat penjejakan yang relevan.
+
+### Langkah 5: Perlindungan Pembeli AuraCart
+
+*   **Penyelesaian Pertikaian:** AuraCart komited untuk memastikan anda menerima pesanan anda. Jika item benar-benar hilang dalam transit atau tidak pernah dihantar, program Perlindungan Pembeli AuraCart akan membantu dalam menyiasat isu tersebut dengan penjual dan kurier.
+*   **Penyelesaian:** Bergantung pada hasil siasatan, anda mungkin layak mendapat bayaran balik penuh atau penghantaran semula item (tertakluk kepada ketersediaan dan dasar penjual).
+*   **Garis Masa:** Siasatan mungkin mengambil masa, tetapi AuraCart akan memastikan anda sentiasa dikemas kini sepanjang proses.
+
+Kepuasan anda adalah keutamaan kami, dan kami sedia membantu memastikan pengalaman AuraCart anda lancar dan boleh dipercayai.

knowledge_base/v2_multilingual/04_returns_and_refunds_en.md

@@ -0,0 +1,82 @@
+# Returns and Refunds Policy
+
+At AuraCart, we strive to ensure your satisfaction with every purchase on AuraMall. This comprehensive policy outlines the conditions and procedures for returns and refunds, designed to be fair and transparent.
+
+## 1. 30-Day Return Window
+
+AuraCart offers a generous **30-day return window** from the date of delivery for most items purchased on AuraMall. This gives you ample time to inspect your purchase and decide if it meets your expectations.
+
+*   **Eligibility Start Date:** The 30-day period begins on the date the item is marked as "Delivered" by our logistics partners.
+*   **Request Deadline:** All return requests must be submitted within this 30-day period. Requests made after this window will generally not be accepted.
+
+## 2. Conditions for Returns
+
+For a return to be eligible, the item must meet specific conditions. Failure to meet these conditions may result in the rejection of your return request.
+
+### General Conditions for All Returns
+
+*   **Within the 30-Day Window:** The return request must be initiated within 30 days of delivery.
+*   **Original Condition:** The item must be returned in its original, unused, and re-sellable condition. This includes all original packaging, tags, manuals, accessories, and free gifts or promotional items that came with the product.
+*   **Reason for Return:** You must select a valid reason for return (e.g., defective item, wrong item, damaged during shipping, changed mind).
+*   **Proof of Purchase:** A valid proof of purchase (e.g., AuraCart order number, invoice) is required.
+
+### Specific Item Conditions
+
+*   **Apparel & Fashion:** Must be unworn, unwashed, and have all original tags still attached. Undergarments, swimwear, and intimate apparel are generally non-returnable for hygiene reasons unless defective.
+*   **Electronics & Gadgets:** Must be in original packaging with all accessories (cables, chargers, earphones, manuals). If the item is faulty, any user data must be wiped before returning. Items with clear signs of misuse or physical damage not present upon delivery will not be accepted.
+*   **Health & Beauty Products:** Non-returnable if the seal is broken or if used, due to hygiene reasons. This includes cosmetics, skincare, and personal care items, unless defective or wrongly sent.
+*   **Perishable/Groceries:** Generally non-returnable unless expired upon delivery, incorrect item, or clearly damaged/spoiled. Returns must be reported immediately upon receipt.
+*   **Digital Products:** Non-returnable once redeemed or downloaded.
+*   **Customized/Personalized Items:** Generally non-returnable unless defective or incorrect due to seller error.
+*   **Items Marked "Non-Returnable":** Some specific items may be explicitly marked as non-returnable on their product page. Please check this before purchasing.
+
+## 3. Step-by-Step Return Process
+
+Follow these steps to initiate and complete a return request:
+
+1.  **Initiate Return Request:**
+    *   Log in to your AuraCart account.
+    *   Go to "My Orders" and select the order containing the item you wish to return.
+    *   Click on "Return/Refund" or "Request Return" next to the relevant item.
+    *   Select the reason for your return from the provided options.
+    *   Provide a clear description of the issue and upload supporting evidence (photos/videos) if applicable (e.g., for damaged or defective items).
+2.  **Seller Review / AuraCart Review:**
+    *   Your return request will be submitted to the seller for their review. For certain cases or if the seller doesn't respond promptly, AuraCart's dispute resolution team may step in to review.
+    *   You may be contacted by the seller or AuraCart for further information or clarification.
+3.  **Return Approval:**
+    *   If your return request is approved, you will receive instructions on how to return the item. This typically includes a return shipping label or instructions for drop-off.
+    *   **Packaging:** Securely package the item in its original packaging, ensuring all original contents are included.
+    *   **Shipping:** Ship the item back using the provided label or method within the specified timeframe (usually 5-7 days after approval). AuraCart may cover return shipping costs for valid reasons (e.g., defective, wrong item). For "change of mind" returns, return shipping costs may be borne by the buyer.
+4.  **Item Inspection:**
+    *   Once the returned item is received by the seller or AuraCart, it will undergo an inspection to ensure it meets the return conditions.
+5.  **Refund Processing:**
+    *   If the item passes inspection, your refund will be processed according to the refund policy (see section 5). If it fails inspection, the item may be returned to you, and the refund denied.
+
+## 4. AuraMall-Specific Policies
+
+AuraMall, our premium marketplace, hosts official brands and authorized sellers. While the general AuraCart return policy applies, some AuraMall sellers may offer enhanced or specific return conditions.
+
+*   **Official Store Policies:** Some official brand stores on AuraMall may have their own slightly modified return policies (e.g., longer return windows for specific items, direct exchange options). Always check the seller's specific policy on their AuraMall store page or the product description.
+*   **Authenticity Guarantee:** All products on AuraMall are guaranteed to be authentic. If you receive an item from AuraMall that you believe is not authentic, your return will be prioritized, and a full refund will be issued upon verification.
+*   **Enhanced Support:** Disputes for AuraMall purchases may receive expedited attention from AuraCart's customer support team.
+
+## 5. Refund Processing Times
+
+Once a refund is approved and processed, the time it takes for the funds to appear in your account depends on the original payment method.
+
+### Refund Methods
+
+*   **AuraWallet:** Refunds to your AuraWallet are the fastest, typically processed within **1-3 business days** after the returned item passes inspection.
+*   **Credit/Debit Card:** Refunds to credit or debit cards usually take **5-10 business days** to appear on your statement, depending on your bank's processing times.
+*   **Bank Transfer:** Refunds to bank accounts can take **3-7 business days** to reflect, depending on interbank processing.
+*   **Cash on Delivery (COD):** For COD orders, refunds are typically issued to your AuraWallet or a specified bank account. This process can take **3-7 business days** after you provide your details and the return is approved.
+
+### General Refund Notes
+
+*   **Processing Start:** The refund processing time begins *after* the returned item has been successfully received and inspected by the seller or AuraCart, and the return is confirmed as eligible.
+*   **Partial Refunds:** In some cases (e.g., only part of a bundled item is returned, or minor damage to packaging), a partial refund may be issued at AuraCart's discretion.
+*   **Shipping Fees:** Original shipping fees are generally non-refundable unless the return is due to a seller error (e.g., defective, wrong item).
+*   **Vouchers/AuraCoins:** If a voucher or AuraCoins were used, the monetary value of the voucher is typically not refunded, but the portion paid by other means (e.g., AuraWallet, card) will be. AuraCoins used may be re-credited to your account.
+*   **Notification:** You will receive an email notification once your refund has been processed.
+
+We encourage you to review this policy thoroughly before making a purchase. AuraCart is committed to making your shopping experience as smooth and risk-free as possible.

knowledge_base/v2_multilingual/04_returns_and_refunds_my.md

@@ -0,0 +1,83 @@
+# Dasar Pemulangan dan Bayaran Balik
+
+Di AuraCart, kami berusaha untuk memastikan kepuasan anda dengan setiap pembelian di AuraMall. Dasar komprehensif ini menggariskan syarat dan prosedur untuk pemulangan dan bayaran balik, yang direka bentuk untuk menjadi adil dan telus.
+
+## 1. Tempoh Pemulangan 30 Hari
+
+AuraCart menawarkan **tempoh pemulangan 30 hari** yang murah hati dari tarikh penyerahan untuk kebanyakan item yang dibeli di AuraMall. Ini memberi anda masa yang mencukupi untuk memeriksa pembelian anda dan memutuskan sama ada ia memenuhi jangkaan anda.
+
+*   **Tarikh Mula Kelayakan:** Tempoh 30 hari bermula pada tarikh item ditandakan sebagai "Delivered" oleh rakan kongsi logistik kami.
+*   **Tarikh Akhir Permintaan:** Semua permintaan pemulangan mesti dihantar dalam tempoh 30 hari ini. Permintaan yang dibuat selepas tempoh ini secara umumnya tidak akan diterima.
+
+## 2. Syarat untuk Pemulangan
+
+Untuk pemulangan layak, item mesti memenuhi syarat-syarat tertentu. Kegagalan memenuhi syarat-syarat ini boleh mengakibatkan penolakan permintaan pemulangan anda.
+
+### Syarat Umum untuk Semua Pemulangan
+
+*   **Dalam Tempoh 30 Hari:** Permintaan pemulangan mesti dimulakan dalam tempoh 30 hari dari penyerahan.
+*   **Keadaan Asal:** Item mesti dipulangkan dalam keadaan asal, tidak digunakan, dan boleh dijual semula. Ini termasuk semua pembungkusan asal, tag, manual, aksesori, dan hadiah percuma atau item promosi yang disertakan dengan produk.
+*   **Sebab Pemulangan:** Anda mesti memilih sebab pemulangan yang sah (contohnya, item rosak, item salah, rosak semasa penghantaran, berubah fikiran).
+*   **Bukti Pembelian:** Bukti pembelian yang sah (contohnya, nombor pesanan AuraCart, invois) diperlukan.
+
+### Syarat Item Khusus
+
+*   **Pakaian & Fesyen:** Mesti belum dipakai, belum dicuci, dan mempunyai semua tag asal masih terlekat. Pakaian dalam, pakaian renang, dan pakaian intim secara umumnya tidak boleh dipulangkan atas sebab-sebab kebersihan kecuali jika rosak.
+*   **Elektronik & Gadget:** Mesti dalam pembungkusan asal dengan semua aksesori (kabel, pengecas, fon telinga, manual). Jika item rosak, sebarang data pengguna mesti dipadam sebelum memulangkan. Item dengan tanda-tanda jelas penyalahgunaan atau kerosakan fizikal yang tidak wujud semasa penghantaran tidak akan diterima.
+*   **Produk Kesihatan & Kecantikan:** Tidak boleh dipulangkan jika meterai rosak atau jika digunakan, atas sebab-sebab kebersihan. Ini termasuk kosmetik, penjagaan kulit, dan item penjagaan diri, kecuali jika rosak atau salah dihantar.
+*   **Barangan Mudah Rosak/Runcit:** Secara umumnya tidak boleh dipulangkan kecuali tamat tempoh semasa penghantaran, item tidak betul, atau jelas rosak/busuk. Pemulangan mesti dilaporkan serta-merta setelah diterima.
+*   **Produk Digital:** Tidak boleh dipulangkan setelah ditebus atau dimuat turun.
+*   **Item Disesuaikan/Disesuaikan Peribadi:** Secara umumnya tidak boleh dipulangkan kecuali rosak atau tidak betul disebabkan kesilapan penjual.
+*   **Item Bertanda "Non-Returnable":** Sesetengah item tertentu mungkin ditandakan secara jelas sebagai tidak boleh dipulangkan di halaman produknya. Sila semak ini sebelum membeli.
+
+## 3. Proses Pemulangan Langkah demi Langkah
+
+Ikut langkah-langkah ini untuk memulakan dan melengkapkan permintaan pemulangan:
+
+1.  **Mulakan Permintaan Pemulangan:**
+    *   Log masuk ke akaun AuraCart anda.
+    *   Pergi ke "My Orders" dan pilih pesanan yang mengandungi item yang ingin anda pulangkan.
+    *   Klik "Return/Refund" atau "Request Return" di sebelah item yang relevan.
+    *   Pilih sebab pemulangan anda dari pilihan yang disediakan.
+    *   Berikan penerangan yang jelas mengenai isu tersebut dan muat naik bukti sokongan (gambar/video) jika berkenaan (contohnya, untuk item rosak atau cacat).
+2.  **Semakan Penjual / Semakan AuraCart:**
+    *   Permintaan pemulangan anda akan dihantar kepada penjual untuk semakan mereka. Untuk kes-kes tertentu atau jika penjual tidak bertindak balas dengan segera, pasukan penyelesaian pertikaian AuraCart mungkin campur tangan untuk menyemak.
+    *   Anda mungkin dihubungi oleh penjual atau AuraCart untuk maklumat lanjut atau penjelasan.
+3.  **Kelulusan Pemulangan:**
+    *   Jika permintaan pemulangan anda diluluskan, anda akan menerima arahan tentang cara memulangkan item tersebut. Ini biasanya termasuk label penghantaran pemulangan atau arahan untuk penghantaran drop-off.
+    *   **Pembungkusan:** Bungkus item dengan selamat dalam pembungkusan asalnya, pastikan semua kandungan asal disertakan.
+    *   **Penghantaran:** Hantar semula item menggunakan label atau kaedah yang disediakan dalam tempoh masa yang ditentukan (biasanya 5-7 hari selepas kelulusan). AuraCart mungkin menanggung kos penghantaran pemulangan untuk sebab-sebab yang sah (contohnya, item rosak, item salah). Untuk pemulangan "berubah fikiran", kos penghantaran pemulangan mungkin ditanggung oleh pembeli.
+4.  **Pemeriksaan Item:**
+    *   Setelah item yang dipulangkan diterima oleh penjual atau AuraCart, ia akan menjalani pemeriksaan untuk memastikan ia memenuhi syarat pemulangan.
+5.  **Pemprosesan Bayaran Balik:**
+    *   Jika item melepasi pemeriksaan, bayaran balik anda akan diproses mengikut dasar bayaran balik (lihat seksyen 5). Jika ia gagal pemeriksaan, item tersebut mungkin dipulangkan kepada anda, dan bayaran balik ditolak.
+
+## 4. Dasar Khusus AuraMall
+
+AuraMall, pasaran premium kami, menjadi tuan rumah jenama rasmi dan penjual yang sah. Walaupun dasar pemulangan AuraCart umum terpakai, sesetengah penjual AuraMall mungkin menawarkan syarat pemulangan yang dipertingkatkan atau khusus.
+
+*   **Dasar Kedai Rasmi:** Sesetengah kedai jenama rasmi di AuraMall mungkin mempunyai dasar pemulangan mereka sendiri yang diubah suai sedikit (contohnya, tempoh pemulangan yang lebih lama untuk item tertentu, pilihan pertukaran langsung). Sentiasa semak dasar khusus penjual di halaman kedai AuraMall mereka atau penerangan produk.
+*   **Jaminan Ketulenan:** Semua produk di AuraMall dijamin ketulenannya. Jika anda menerima item dari AuraMall yang anda percaya tidak tulen, pemulangan anda akan diutamakan, dan bayaran balik penuh akan dikeluarkan setelah pengesahan.
+*   **Sokongan Dipertingkatkan:** Pertikaian untuk pembelian AuraMall mungkin menerima perhatian yang dipercepatkan daripada pasukan sokongan pelanggan AuraCart.
+
+## 5. Masa Pemprosesan Bayaran Balik
+
+Setelah bayaran balik diluluskan dan diproses, masa yang diambil untuk dana muncul dalam akaun anda bergantung pada kaedah pembayaran asal.
+
+### Kaedah Bayaran Balik
+
+*   **AuraWallet:** Bayaran balik ke AuraWallet anda adalah yang terpantas, biasanya diproses dalam masa **1-3 hari bekerja** setelah item yang dipulangkan melepasi pemeriksaan.
+*   **Kad Kredit/Debit:** Bayaran balik ke kad kredit atau debit biasanya mengambil masa **5-10 hari bekerja** untuk muncul dalam penyata anda, bergantung pada masa pemprosesan bank anda.
+*   **Pindahan Bank:** Bayaran balik ke akaun bank boleh mengambil masa **3-7 hari bekerja** untuk ditunjukkan, bergantung pada pemprosesan antara bank.
+*   **Tunai Semasa Penghantaran (COD):** Untuk pesanan COD, bayaran balik biasanya dikeluarkan ke AuraWallet anda atau akaun bank yang ditentukan. Proses ini boleh mengambil masa **3-7 hari bekerja** selepas anda memberikan butiran anda dan pemulangan diluluskan.
+
+### Nota Umum Bayaran Balik
+
+*   **Mula Pemprosesan:** Masa pemprosesan bayaran balik bermula *setelah* item yang dipulangkan berjaya diterima dan diperiksa oleh penjual atau AuraCart, dan pemulangan disahkan layak.
+*   **Bayaran Balik Sebahagian:** Dalam beberapa kes (contohnya, hanya sebahagian daripada item gabungan dipulangkan, atau kerosakan kecil pada pembungkusan), bayaran balik sebahagian mungkin dikeluarkan atas budi bicara AuraCart.
+*   **Yuran Penghantaran:** Yuran penghantaran asal umumnya tidak boleh dikembalikan kecuali jika pemulangan disebabkan oleh kesilapan penjual (contohnya, item rosak, item salah).
+*   **Baucar/AuraCoins:** Jika baucar atau AuraCoins digunakan, nilai monetari baucar biasanya tidak dikembalikan atau dikeluarkan semula.
+*   Jumlah yang anda *bayar* setelah diskaun baucar akan dikembalikan. AuraCoins yang digunakan mungkin dikreditkan semula ke akaun anda.
+*   **Pemberitahuan:** Anda akan menerima pemberitahuan e-mel setelah bayaran balik anda diproses.
+
+Kami menggalakkan anda untuk menyemak dasar ini dengan teliti sebelum membuat pembelian. AuraCart komited untuk menjadikan pengalaman membeli-belah anda selancar dan bebas risiko yang mungkin.

knowledge_base/v2_multilingual/05_rewards_and_promotions_en.md

@@ -0,0 +1,100 @@
+# Rewards and Promotions
+
+AuraCart values your loyalty! This document outlines how you can earn and utilize AuraCoins, understand the benefits of our loyalty program, and effectively use promotional vouchers to enhance your shopping experience on AuraMall.
+
+## 1. How to Earn AuraCoins
+
+AuraCoins are AuraCart's loyalty points, designed to reward you for your activity on the platform.
+
+### Earning AuraCoins Through Purchases
+
+*   **Eligible Purchases:** You earn AuraCoins on most purchases made through AuraMall. The specific earning rate (e.g., 1 AuraCoin for every $1 spent) will be displayed on product pages or during checkout.
+*   **AuraMall Exclusive Offers:** Look out for special promotions on AuraMall that offer boosted AuraCoin earnings for specific products, categories, or sellers.
+*   **Payment Method Bonuses:** Sometimes, paying with AuraWallet may offer additional AuraCoin bonuses.
+*   **Calculation:** AuraCoins are typically calculated based on the net purchase amount (after discounts, excluding shipping fees and taxes).
+*   **Coin Issuance:** AuraCoins are usually credited to your account once your order is successfully delivered and the return window has passed (to account for potential cancellations or returns). You will receive a notification when coins are credited.
+
+### Earning AuraCoins Through Activities
+
+*   **Product Reviews:** Earn AuraCoins by submitting eligible reviews for products you've purchased, especially those with photos or videos.
+*   **Seller Ratings:** Providing ratings and feedback for sellers can also contribute to your AuraCoin balance.
+*   **Special Campaigns:** Participate in AuraCart's promotional campaigns, games, or events, which often offer AuraCoins as rewards. Keep an eye on the AuraCart app and website for announcements.
+*   **Referral Program:** Refer new users to AuraCart, and you both may earn AuraCoins once the referred user completes their first eligible purchase. (Specific terms and conditions for referral programs will be detailed separately).
+
+## 2. How to Use AuraCoins
+
+AuraCoins can be redeemed to get discounts on your future purchases on AuraMall.
+
+### Redeeming AuraCoins During Checkout
+
+1.  **Add Items to Cart:** Select the items you wish to purchase and proceed to checkout.
+2.  **Review Order:** On the checkout page, after confirming your shipping address and selected payment method, you will see a section for "AuraCoins."
+3.  **Apply AuraCoins:** If you have a sufficient balance, you will see the option to apply your AuraCoins. You can choose to use all available AuraCoins or a specific amount.
+4.  **Value:** The monetary value of AuraCoins will be clearly displayed (e.g., "100 AuraCoins = $1 discount").
+5.  **Confirm Discount:** The equivalent discount will be applied to your total order amount, reducing the final price you need to pay.
+6.  **Complete Purchase:** Proceed to complete your payment for the remaining balance.
+
+### AuraCoin Redemption Rules
+
+*   **Minimum Redemption:** There may be a minimum number of AuraCoins required for redemption (e.g., a minimum of 100 AuraCoins).
+*   **No Cash Value:** AuraCoins cannot be converted into cash or transferred to another user.
+*   **Expiry:** AuraCoins may have an expiry date. Please check your AuraCoin balance in your "My Account" section for specific expiry details. Expired AuraCoins cannot be used.
+*   **Refunds:** If an order where AuraCoins were used is cancelled or returned, the AuraCoins will typically be re-credited to your account.
+*   **Combined Use:** AuraCoins can often be combined with promotional vouchers, allowing for greater savings.
+
+## 3. Benefits of the AuraCart Loyalty Program
+
+AuraCart's loyalty program is designed to enhance your shopping experience and reward you for choosing us.
+
+### Tiered Membership (Future Enhancement)
+
+AuraCart plans to introduce tiered loyalty membership levels (e.g., Silver, Gold, Platinum) with escalating benefits for our most loyal customers. These benefits may include:
+*   **Higher AuraCoin Earning Rates:** Earn more AuraCoins per dollar spent.
+*   **Exclusive Vouchers:** Access to special vouchers and discounts.
+*   **Priority Customer Support:** Expedited assistance from our support team.
+*   **Early Access:** Be among the first to know about new product launches or flash sales.
+*   **Birthday Rewards:** Special treats during your birthday month.
+
+### Exclusive Offers and Events
+
+*   **Member-Only Sales:** Access to sales and promotions exclusive to loyalty program members.
+*   **Special AuraCoin Offers:** Periodic opportunities to earn bonus AuraCoins through specific purchases or activities.
+*   **Personalized Recommendations:** Get tailored product recommendations based on your shopping history and preferences.
+
+### Enhanced Experience
+
+*   **Seamless Redemption:** Easy redemption of AuraCoins and vouchers directly at checkout.
+*   **Transparent Tracking:** Monitor your AuraCoin balance, earning history, and redemption history within your AuraCart account.
+
+## 4. Terms for Using Vouchers
+
+Vouchers are a great way to save money on AuraCart. While generally covered in the Shopping Guide, here's a focus on their specific terms related to promotions.
+
+### Types of Vouchers
+
+*   **AuraCart Vouchers:** Issued by AuraCart directly, applicable across various sellers and products.
+*   **Seller Vouchers:** Issued by individual sellers or brands, valid only for their specific stores or products on AuraMall.
+*   **Payment Method Vouchers:** Discounts applicable when using specific payment methods, such as AuraWallet or a particular bank card.
+*   **Shipping Vouchers:** Vouchers that offer discounts on or free shipping fees.
+
+### Important Voucher Conditions
+
+*   **Validity Period:** All vouchers have an expiration date. Ensure you use them before they expire. Expired vouchers cannot be reactivated or redeemed.
+*   **Minimum Spend:** Many vouchers require a minimum purchase amount to be eligible for use. This will be clearly stated on the voucher.
+*   **Product/Category Specificity:** Vouchers may be limited to certain product categories, specific products, or sellers. Check the "applicable to" section of the voucher.
+*   **New vs. Existing Users:** Some vouchers are exclusively for new AuraCart users, while others are for existing customers.
+*   **Single Use:** Most vouchers are for single use per customer per transaction.
+*   **Non-Stackable (Generally):** While you can often combine a voucher with AuraCoin redemption, you typically cannot use multiple vouchers on a single order. AuraCart's system will usually apply the best available voucher if you have multiple eligible ones collected.
+*   **Refunds and Cancellations:**
+    *   If an order using a voucher is cancelled or returned, the voucher amount itself is generally not refunded or re-issued.
+    *   The amount you *paid* after the voucher discount will be refunded.
+    *   Always refer to the specific terms and conditions of each voucher before use.
+
+### How to Collect Vouchers
+
+*   **Promotional Banners:** Look for vouchers prominently displayed on the AuraCart homepage, category pages, or during special campaigns.
+*   **Seller Stores:** Visit your favorite seller's AuraMall store page to find their exclusive vouchers.
+*   **Notifications:** Keep an eye on AuraCart app notifications and emails for personalized voucher offers.
+*   **Voucher Centre:** AuraCart typically has a dedicated "Voucher Centre" or "My Vouchers" section in your account where you can browse and collect available vouchers.
+
+By understanding and utilizing AuraCoins and vouchers, you can maximize your savings and enjoy a more rewarding shopping experience on AuraCart.

knowledge_base/v2_multilingual/05_rewards_and_promotions_my.md

@@ -0,0 +1,100 @@
+# Ganjaran dan Promosi
+
+AuraCart menghargai kesetiaan anda! Dokumen ini menggariskan cara anda boleh mendapatkan dan menggunakan AuraCoins, memahami faedah program kesetiaan kami, dan menggunakan baucar promosi dengan berkesan untuk meningkatkan pengalaman membeli-belah anda di AuraMall.
+
+## 1. Cara Mendapatkan AuraCoins
+
+AuraCoins adalah mata kesetiaan AuraCart, yang direka untuk memberi ganjaran kepada anda atas aktiviti anda di platform.
+
+### Mendapatkan AuraCoins Melalui Pembelian
+
+*   **Pembelian Layak:** Anda memperoleh AuraCoins pada kebanyakan pembelian yang dibuat melalui AuraMall. Kadar perolehan tertentu (contohnya, 1 AuraCoin untuk setiap $1 yang dibelanjakan) akan dipaparkan di halaman produk atau semasa pembayaran.
+*   **Tawaran Eksklusif AuraMall:** Cari promosi istimewa di AuraMall yang menawarkan perolehan AuraCoin yang dipertingkatkan untuk produk, kategori, atau penjual tertentu.
+*   **Bonus Kaedah Pembayaran:** Kadangkala, pembayaran dengan AuraWallet mungkin menawarkan bonus AuraCoin tambahan.
+*   **Pengiraan:** AuraCoins biasanya dikira berdasarkan jumlah pembelian bersih (selepas diskaun, tidak termasuk yuran penghantaran dan cukai).
+*   **Pengeluaran Syiling:** AuraCoins biasanya dikreditkan ke akaun anda setelah pesanan anda berjaya dihantar dan tempoh pemulangan telah berlalu (untuk mengambil kira kemungkinan pembatalan atau pemulangan). Anda akan menerima pemberitahuan apabila syiling dikreditkan.
+
+### Mendapatkan AuraCoins Melalui Aktiviti
+
+*   **Ulasan Produk:** Dapatkan AuraCoins dengan menghantar ulasan yang layak untuk produk yang anda beli, terutamanya yang disertakan dengan foto atau video.
+*   **Penilaian Penjual:** Memberikan penilaian dan maklum balas untuk penjual juga boleh menyumbang kepada baki AuraCoin anda.
+*   **Kempen Khas:** Sertai kempen promosi, permainan, atau acara AuraCart, yang sering menawarkan AuraCoins sebagai ganjaran. Perhatikan aplikasi dan laman web AuraCart untuk pengumuman.
+*   **Program Rujukan:** Rujuk pengguna baharu kepada AuraCart, dan anda berdua mungkin memperoleh AuraCoins setelah pengguna yang dirujuk melengkapkan pembelian layak pertama mereka. (Terma dan syarat khusus untuk program rujukan akan diperincikan secara berasingan).
+
+## 2. Cara Menggunakan AuraCoins
+
+AuraCoins boleh ditebus untuk mendapatkan diskaun pada pembelian masa depan anda di AuraMall.
+
+### Menebus AuraCoins Semasa Pembayaran
+
+1.  **Tambah Item ke Troli:** Pilih item yang ingin anda beli dan teruskan ke pembayaran.
+2.  **Semak Pesanan:** Di halaman pembayaran, setelah mengesahkan alamat penghantaran anda dan kaedah pembayaran yang dipilih, anda akan melihat bahagian untuk "AuraCoins."
+3.  **Gunakan AuraCoins:** Jika anda mempunyai baki yang mencukupi, anda akan melihat pilihan untuk menggunakan AuraCoins anda. Anda boleh memilih untuk menggunakan semua AuraCoins yang tersedia atau jumlah tertentu.
+4.  **Nilai:** Nilai monetari AuraCoins akan dipaparkan dengan jelas (contohnya, "100 AuraCoins = diskaun $1").
+5.  **Sahkan Diskaun:** Diskaun yang setara akan dikenakan pada jumlah pesanan anda, mengurangkan harga akhir yang perlu anda bayar.
+6.  **Selesaikan Pembelian:** Teruskan untuk melengkapkan pembayaran anda untuk baki yang tinggal.
+
+### Peraturan Penebusan AuraCoin
+
+*   **Penebusan Minimum:** Mungkin terdapat jumlah minimum AuraCoins yang diperlukan untuk penebusan (contohnya, minimum 100 AuraCoins).
+*   **Tiada Nilai Tunai:** AuraCoins tidak boleh ditukar menjadi tunai atau dipindahkan kepada pengguna lain.
+*   **Tarikh Luput:** AuraCoins mungkin mempunyai tarikh luput. Sila semak baki AuraCoin anda di bahagian "My Account" anda untuk butiran luput tertentu. AuraCoins yang telah luput tidak boleh digunakan.
+*   **Bayaran Balik:** Jika pesanan di mana AuraCoins digunakan dibatalkan atau dipulangkan, AuraCoins biasanya akan dikreditkan semula ke akaun anda.
+*   **Penggunaan Gabungan:** AuraCoins sering boleh digabungkan dengan baucar promosi, membolehkan penjimatan yang lebih besar.
+
+## 3. Faedah Program Kesetiaan AuraCart
+
+Program kesetiaan AuraCart direka untuk meningkatkan pengalaman membeli-belah anda dan memberi ganjaran kepada anda kerana memilih kami.
+
+### Keahlian Berperingkat (Peningkatan Masa Depan)
+
+AuraCart merancang untuk memperkenalkan tahap keahlian kesetiaan berperingkat (contohnya, Perak, Emas, Platinum) dengan faedah yang meningkat untuk pelanggan kami yang paling setia. Faedah ini mungkin termasuk:
+*   **Kadar Perolehan AuraCoin yang Lebih Tinggi:** Dapatkan lebih banyak AuraCoins bagi setiap dolar yang dibelanjakan.
+*   **Baucar Eksklusif:** Akses kepada baucar dan diskaun istimewa.
+*   **Sokongan Pelanggan Keutamaan:** Bantuan dipercepatkan daripada pasukan sokongan kami.
+*   **Akses Awal:** Jadilah antara yang pertama mengetahui tentang pelancaran produk baharu atau jualan kilat.
+*   **Ganjaran Hari Lahir:** Hadiah istimewa semasa bulan ulang tahun anda.
+
+### Tawaran dan Acara Eksklusif
+
+*   **Jualan Khas Ahli:** Akses kepada jualan dan promosi eksklusif untuk ahli program kesetiaan.
+*   **Tawaran AuraCoin Khas:** Peluang berkala untuk mendapatkan bonus AuraCoins melalui pembelian atau aktiviti tertentu.
+*   **Cadangan Peribadi:** Dapatkan cadangan produk yang disesuaikan berdasarkan sejarah membeli-belah dan pilihan anda.
+
+### Pengalaman Dipertingkatkan
+
+*   **Penebusan Lancar:** Penebusan mudah AuraCoins dan baucar terus di pembayaran.
+*   **Penjejakan Telus:** Pantau baki AuraCoin anda, sejarah perolehan, dan sejarah penebusan dalam akaun AuraCart anda.
+
+## 4. Terma Penggunaan Baucar
+
+Baucar adalah cara terbaik untuk menjimatkan wang di AuraCart. Walaupun secara amnya dilindungi dalam Panduan Membeli-belah, berikut adalah tumpuan pada terma khusus mereka yang berkaitan dengan promosi.
+
+### Jenis-jenis Baucar
+
+*   **Baucar AuraCart:** Dikeluarkan oleh AuraCart secara langsung, boleh digunakan di pelbagai penjual dan produk.
+*   **Baucar Penjual:** Dikeluarkan oleh penjual atau jenama individu, sah hanya untuk kedai atau produk tertentu mereka di AuraMall.
+*   **Baucar Kaedah Pembayaran:** Diskaun yang boleh digunakan apabila menggunakan kaedah pembayaran tertentu, seperti AuraWallet atau kad bank tertentu.
+*   **Baucar Penghantaran:** Baucar yang menawarkan diskaun atau yuran penghantaran percuma.
+
+### Syarat Baucar Penting
+
+*   **Tempoh Sah Laku:** Semua baucar mempunyai tarikh luput. Pastikan anda menggunakannya sebelum ia luput. Baucar yang telah luput tidak boleh diaktifkan semula atau ditebus.
+*   **Perbelanjaan Minimum:** Banyak baucar memerlukan jumlah pembelian minimum untuk layak digunakan. Ini akan dinyatakan dengan jelas pada baucar.
+*   **Produk/Kategori Khusus:** Baucar mungkin terhad kepada kategori produk tertentu, produk tertentu, atau penjual. Semak bahagian "berkenaan dengan" baucar.
+*   **Pengguna Baharu vs. Sedia Ada:** Sesetengah baucar adalah eksklusif untuk pengguna AuraCart baharu, manakala yang lain adalah untuk pelanggan sedia ada.
+*   **Satu Penggunaan:** Kebanyakan baucar adalah untuk satu penggunaan setiap pelanggan setiap transaksi.
+*   **Tidak Boleh Ditindan (Umumnya):** Walaupun anda sering boleh menggabungkan baucar dengan penebusan AuraCoin, anda biasanya tidak boleh menggunakan beberapa baucar pada satu pesanan. Sistem AuraCart biasanya akan menggunakan baucar terbaik yang tersedia jika anda mempunyai beberapa baucar yang layak dikumpul.
+*   **Bayaran Balik dan Pembatalan:**
+    *   Jika pesanan menggunakan baucar dibatalkan atau dipulangkan, jumlah baucar itu sendiri secara amnya tidak akan dikembalikan atau dikeluarkan semula.
+    *   Jumlah yang anda *bayar* selepas diskaun baucar akan dikembalikan.
+    *   Sentiasa rujuk kepada terma dan syarat khusus setiap baucar sebelum menggunakannya.
+
+### Cara Mengumpul Baucar
+
+*   **Sepanduk Promosi:** Cari baucar yang dipaparkan dengan jelas di halaman utama AuraCart, halaman kategori, atau semasa kempen khas.
+*   **Kedai Penjual:** Lawati halaman kedai AuraMall penjual kegemaran anda untuk mencari baucar eksklusif mereka.
+*   **Pemberitahuan:** Perhatikan pemberitahuan aplikasi AuraCart dan e-mel untuk tawaran baucar yang diperibadikan.
+*   **Pusat Baucar:** AuraCart biasanya mempunyai bahagian "Pusat Baucar" atau "Baucar Saya" yang khusus dalam akaun anda di mana anda boleh melayari dan mengumpul baucar yang tersedia.
+
+Dengan memahami dan menggunakan AuraCoins serta baucar, anda boleh memaksimumkan penjimatan anda dan menikmati pengalaman membeli-belah yang lebih bermanfaat di AuraCart.

knowledge_base/v2_multilingual/06_seller_guide_basics_en.md

@@ -0,0 +1,124 @@
+# Basics for Sellers
+
+Welcome to AuraCart's seller community! This document provides an essential guide for new sellers looking to establish their presence on AuraMall, covering registration, product listing, understanding fees, and managing your first orders.
+
+## 1. How to Register as a Seller
+
+Becoming a seller on AuraCart is a straightforward process, opening your business to a vast customer base across Southeast Asia.
+
+### Eligibility Requirements
+
+To register as an AuraCart seller, you typically need:
+*   **Business Registration:** A valid business registration or company license (e.g., Sole Proprietorship, Partnership, Private Limited Company) in the country where you operate and plan to sell. Individual sellers may be allowed for certain product categories or initial stages, but business registration is highly recommended for full features.
+*   **Valid Identification:** A copy of your official identification (e.g., National ID, Passport) for verification purposes.
+*   **Bank Account:** A local bank account in your business name for receiving payouts.
+*   **Contact Information:** A valid email address and mobile number.
+
+### Step-by-Step Registration Process
+
+1.  **Visit the Seller Center:** Navigate to the AuraCart Seller Center website (e.g., seller.auracart.com) or download the AuraCart Seller App.
+2.  **Click "Register" / "Become a Seller":** Locate and click the registration button.
+3.  **Choose Account Type:** Select whether you are registering as an "Individual Seller" (if applicable) or "Business Seller." Business accounts unlock more features.
+4.  **Provide Basic Information:** Enter your email address and mobile number. An OTP will be sent for verification.
+5.  **Set Up Shop Name:** Choose a unique and professional name for your AuraMall shop. This name will be visible to buyers.
+6.  **Upload Documents:** Upload scanned copies or clear photos of your required business registration documents and identification for verification.
+7.  **Bank Account Details:** Provide your bank account information for payouts. Ensure the bank account name matches your registered business name.
+8.  **Agree to Terms:** Read and accept AuraCart's Seller Terms and Conditions, Privacy Policy, and Platform Policies.
+9.  **Submit for Review:** Your application will be submitted for review by the AuraCart team. This process typically takes 1-3 business days.
+10. **Activation:** Once approved, you will receive a confirmation email, and your seller account will be activated. You can then log in to the Seller Center to set up your shop and start listing products.
+
+## 2. Listing Your First Product
+
+Once your seller account is active, you can begin populating your AuraMall shop with products.
+
+### Preparing Your Product Information
+
+Before you start listing, gather the following for each product:
+*   **High-Quality Images:** At least 3-5 clear, well-lit images showing the product from different angles, including lifestyle shots if possible. AuraCart recommends specific image dimensions and formats.
+*   **Product Title:** A clear, concise, and keyword-rich title (e.g., "Brand Name Model Name - Key Feature - Color").
+*   **Detailed Description:** A comprehensive description highlighting features, benefits, specifications, materials, and any relevant usage instructions. Use bullet points for readability.
+*   **Category:** The most appropriate category and sub-category for your product.
+*   **Price:** Your selling price.
+*   **Stock/Inventory:** The number of units available.
+*   **SKU (Stock Keeping Unit):** Your internal product identifier (optional but recommended).
+*   **Variations (if applicable):** Sizes, colors, models, etc., and their respective stock and prices.
+*   **Weight & Dimensions:** Accurate weight and dimensions of the packaged item, crucial for shipping cost calculation.
+*   **Brand:** The brand of the product.
+*   **Warranty Information:** Details about any warranty offered.
+
+### Steps to List a Product
+
+1.  **Log in to Seller Center:** Access your AuraCart Seller Center.
+2.  **Navigate to "Products" > "Add New Product":** Locate the product management section.
+3.  **Enter Basic Information:** Fill in the product title and select the correct category. AuraCart's system may suggest categories based on your title.
+4.  **Upload Images:** Drag and drop or upload your high-quality product images.
+5.  **Provide Details:** Fill in the product description, brand, weight, dimensions, and other specifications.
+6.  **Set Pricing and Inventory:** Enter your selling price, original price (for showing discounts), and available stock.
+7.  **Add Variations (if needed):** If your product has different sizes, colors, or styles, add them here with their respective prices and stock levels.
+8.  **Shipping Information:** Confirm the package weight and dimensions. This helps AuraCart calculate shipping fees accurately.
+9.  **Publish:** Review all details carefully. Once satisfied, click "Publish" or "Save and Publish." Your product will then appear on AuraMall, usually after a quick review.
+
+## 3. Understanding Platform Fees
+
+AuraCart operates on a transparent fee structure. It's crucial to understand these fees to price your products competitively and accurately calculate your profit margins.
+
+### Types of Fees
+
+*   **Commission Fee:**
+    *   **Definition:** A percentage of the product's selling price (excluding shipping fees) charged by AuraCart for each successful sale.
+    *   **Rate:** Commission rates vary by product category. High-value or fast-moving consumer goods may have lower commission, while specialized items might have higher rates. Specific rates are available in your Seller Center's "Fee Structure" section.
+    *   **AuraMall vs. Regular Sellers:** Premium AuraMall sellers (official brands, authorized distributors) may have different commission structures or agreement terms.
+*   **Payment Gateway Fee:**
+    *   **Definition:** A small percentage fee charged by payment processors for handling online transactions (e.g., credit card, AuraWallet, bank transfers).
+    *   **Rate:** Typically a small percentage (e.g., 1-3%) of the total transaction amount.
+*   **Shipping Fee (Seller's Portion):**
+    *   **Definition:** While buyers pay for shipping, sellers are often responsible for accurate package weight and dimensions. If these are incorrect, leading to undercharging the buyer, the difference may be charged back to the seller. AuraCart's integrated logistics ensure transparent shipping costs.
+*   **Optional Service Fees:**
+    *   **Promotional Tools:** Fees for using AuraCart's optional marketing and advertising tools (e.g., sponsored ads, voucher creation). These are elective.
+    *   **Fulfillment Services:** If you opt for AuraCart's fulfillment services (e.g., warehousing, pick-and-pack), corresponding fees will apply.
+
+### Fee Calculation Example (Illustrative)
+
+*   Product Price: $100
+*   Commission Rate: 5% = $5.00
+*   Payment Gateway Fee: 2% of $100 = $2.00
+*   **Net Payout to Seller:** $100 - $5.00 - $2.00 = $93.00 (Excluding shipping, if applicable)
+
+### Payout Schedule
+
+*   AuraCart typically processes seller payouts on a regular schedule (e.g., weekly or bi-weekly).
+*   Payouts cover confirmed, delivered orders, usually after the buyer's return window has closed, to ensure funds are not clawed back due to returns/refunds.
+*   You can view your transaction history and payout reports in your Seller Center.
+
+## 4. Managing Orders
+
+Efficient order management is crucial for good seller performance and customer satisfaction.
+
+### New Order Notifications
+
+*   **Real-time Alerts:** You will receive immediate notifications via the AuraCart Seller App, email, and within the Seller Center dashboard when a new order is placed.
+*   **Dashboard Overview:** Your Seller Center dashboard provides a clear overview of new orders, pending shipments, and orders awaiting action.
+
+### Order Processing Steps
+
+1.  **Review Order Details:** Carefully check the product, quantity, buyer's shipping address, and any specific notes from the buyer.
+2.  **Prepare Item:** Pick and carefully pack the item(s) according to AuraCart's packaging guidelines. Ensure adequate protection to prevent damage during transit.
+3.  **Print Shipping Label:** Generate and print the shipping label directly from your Seller Center. This label contains tracking information and buyer address details.
+4.  **Handover to Courier:**
+    *   **Drop-off:** Drop off the packaged item at a designated AuraCart logistics partner's collection point.
+    *   **Pickup:** Schedule a pickup from your location if this service is available in your area and for your shop.
+5.  **Update Status:** Ensure the order status is updated to "Shipped" or "Ready for Pickup/Drop-off" in the Seller Center once the package is ready for courier collection. The tracking information will automatically be updated for the buyer.
+6.  **Monitor Delivery:** Keep an eye on the tracking status until the order is marked as "Delivered."
+
+### Dealing with Order Issues
+
+*   **Cancellations:**
+    *   **Buyer Initiated:** Buyers can cancel orders before shipment. If an order is cancelled, do not ship it.
+    *   **Seller Initiated:** In rare cases (e.g., out of stock), you may need to cancel an order. Always communicate promptly with the buyer and select a valid reason. Excessive seller-initiated cancellations negatively impact your performance rating.
+*   **Returns/Refunds:**
+    *   **Notification:** You will be notified via Seller Center if a buyer initiates a return request.
+    *   **Review and Respond:** Review the buyer's reason and evidence, then respond within the stipulated time frame (e.g., 2-3 business days) to approve, reject, or request more information.
+    *   **Inspection:** Once the returned item is received, inspect it according to AuraCart's Returns Policy.
+    *   **Action:** Process the refund or reject the return based on the inspection outcome and AuraCart policy.
+
+By mastering these basics, you can effectively launch and grow your business on AuraCart, providing a positive experience for your customers.

knowledge_base/v2_multilingual/06_seller_guide_basics_my.md

@@ -0,0 +1,124 @@
+# Asas untuk Penjual
+
+Selamat datang ke komuniti penjual AuraCart! Dokumen ini menyediakan panduan penting untuk penjual baharu yang ingin menubuhkan kehadiran mereka di AuraMall, merangkumi pendaftaran, penyenaraian produk, pemahaman yuran, dan pengurusan pesanan pertama anda.
+
+## 1. Cara Mendaftar sebagai Penjual
+
+Menjadi penjual di AuraCart adalah proses yang mudah, membuka perniagaan anda kepada pangkalan pelanggan yang luas di seluruh Asia Tenggara.
+
+### Syarat Kelayakan
+
+Untuk mendaftar sebagai penjual AuraCart, anda biasanya memerlukan:
+*   **Pendaftaran Perniagaan:** Pendaftaran perniagaan atau lesen syarikat yang sah (contohnya, Milikan Tunggal, Perkongsian, Syarikat Sendirian Berhad) di negara tempat anda beroperasi dan merancang untuk menjual. Penjual individu mungkin dibenarkan untuk kategori produk tertentu atau peringkat awal, tetapi pendaftaran perniagaan sangat disyorkan untuk ciri penuh.
+*   **Pengenalan Diri Sah:** Salinan pengenalan diri rasmi anda (contohnya, Kad Pengenalan Kebangsaan, Pasport) untuk tujuan pengesahan.
+*   **Akaun Bank:** Akaun bank tempatan atas nama perniagaan anda untuk menerima bayaran.
+*   **Maklumat Hubungan:** Alamat e-mel dan nombor telefon bimbit yang sah.
+
+### Proses Pendaftaran Langkah demi Langkah
+
+1.  **Lawati Pusat Penjual:** Navigasi ke laman web AuraCart Seller Center (contohnya, seller.auracart.com) atau muat turun Aplikasi AuraCart Seller.
+2.  **Klik "Register" / "Become a Seller":** Cari dan klik butang pendaftaran.
+3.  **Pilih Jenis Akaun:** Pilih sama ada anda mendaftar sebagai "Individual Seller" (jika berkenaan) atau "Business Seller." Akaun perniagaan membuka lebih banyak ciri.
+4.  **Berikan Maklumat Asas:** Masukkan alamat e-mel dan nombor telefon bimbit anda. OTP akan dihantar untuk pengesahan.
+5.  **Tetapkan Nama Kedai:** Pilih nama yang unik dan profesional untuk kedai AuraMall anda. Nama ini akan kelihatan kepada pembeli.
+6.  **Muat Naik Dokumen:** Muat naik salinan imbasan atau foto jelas dokumen pendaftaran perniagaan dan pengenalan diri yang diperlukan untuk pengesahan.
+7.  **Butiran Akaun Bank:** Berikan maklumat akaun bank anda untuk bayaran. Pastikan nama akaun bank sepadan dengan nama perniagaan berdaftar anda.
+8.  **Setuju dengan Terma:** Baca dan terima Terma dan Syarat Penjual AuraCart, Dasar Privasi, dan Dasar Platform.
+9.  **Hantar untuk Semakan:** Permohonan anda akan dihantar untuk semakan oleh pasukan AuraCart. Proses ini biasanya mengambil masa 1-3 hari bekerja.
+10. **Pengaktifan:** Setelah diluluskan, anda akan menerima e-mel pengesahan, dan akaun penjual anda akan diaktifkan. Anda kemudian boleh log masuk ke Seller Center untuk menyediakan kedai anda dan mula menyenaraikan produk.
+
+## 2. Menyenaraikan Produk Pertama Anda
+
+Setelah akaun penjual anda aktif, anda boleh mula mengisi kedai AuraMall anda dengan produk.
+
+### Menyediakan Maklumat Produk Anda
+
+Sebelum anda mula menyenaraikan, kumpulkan yang berikut untuk setiap produk:
+*   **Gambar Berkualiti Tinggi:** Sekurang-kurangnya 3-5 gambar yang jelas, terang menunjukkan produk dari sudut yang berbeza, termasuk gambar gaya hidup jika boleh. AuraCart mengesyorkan dimensi dan format imej tertentu.
+*   **Tajuk Produk:** Tajuk yang jelas, ringkas, dan kaya kata kunci (contohnya, "Nama Jenama Nama Model - Ciri Utama - Warna").
+*   **Penerangan Terperinci:** Penerangan komprehensif yang menonjolkan ciri-ciri, faedah, spesifikasi, bahan, dan sebarang arahan penggunaan yang relevan. Gunakan poin-poin untuk kemudahan membaca.
+*   **Kategori:** Kategori dan sub-kategori yang paling sesuai untuk produk anda.
+*   **Harga:** Harga jualan anda.
+*   **Stok/Inventori:** Bilangan unit yang tersedia.
+*   **SKU (Stock Keeping Unit):** Pengenal pasti produk dalaman anda (pilihan tetapi disyorkan).
+*   **Variasi (jika berkenaan):** Saiz, warna, model, dsb., dan stok serta harga masing-masing.
+*   **Berat & Dimensi:** Berat dan dimensi tepat item yang dibungkus, penting untuk pengiraan kos penghantaran.
+*   **Jenama:** Jenama produk tersebut.
+*   **Maklumat Waranti:** Butiran mengenai sebarang waranti yang ditawarkan.
+
+### Langkah-langkah untuk Menyenaraikan Produk
+
+1.  **Log masuk ke Seller Center:** Akses AuraCart Seller Center anda.
+2.  **Navigasi ke "Products" > "Add New Product":** Cari bahagian pengurusan produk.
+3.  **Masukkan Maklumat Asas:** Isi tajuk produk dan pilih kategori yang betul. Sistem AuraCart mungkin mencadangkan kategori berdasarkan tajuk anda.
+4.  **Muat Naik Gambar:** Seret dan lepas atau muat naik gambar produk berkualiti tinggi anda.
+5.  **Berikan Butiran:** Isi penerangan produk, jenama, berat, dimensi, dan spesifikasi lain.
+6.  **Tetapkan Harga dan Inventori:** Masukkan harga jualan anda, harga asal (untuk menunjukkan diskaun), dan stok yang tersedia.
+7.  **Tambah Variasi (jika perlu):** Jika produk anda mempunyai saiz, warna, atau gaya yang berbeza, tambahkannya di sini dengan harga dan paras stok masing-masing.
+8.  **Maklumat Penghantaran:** Sahkan berat dan dimensi pakej. Ini membantu AuraCart mengira yuran penghantaran dengan tepat.
+9.  **Terbitkan:** Semak semua butiran dengan teliti. Setelah berpuas hati, klik "Publish" atau "Save and Publish." Produk anda kemudian akan muncul di AuraMall, biasanya selepas semakan ringkas.
+
+## 3. Memahami Yuran Platform
+
+AuraCart beroperasi berdasarkan struktur yuran yang telus. Adalah penting untuk memahami yuran ini untuk menetapkan harga produk anda secara kompetitif dan mengira margin keuntungan anda dengan tepat.
+
+### Jenis-jenis Yuran
+
+*   **Yuran Komisen:**
+    *   **Definisi:** Peratusan daripada harga jualan produk (tidak termasuk yuran penghantaran) yang dicaj oleh AuraCart untuk setiap jualan yang berjaya.
+    *   **Kadar:** Kadar komisen berbeza mengikut kategori produk. Barangan bernilai tinggi atau barangan pengguna bergerak pantas mungkin mempunyai komisen yang lebih rendah, manakala barangan khusus mungkin mempunyai kadar yang lebih tinggi. Kadar khusus tersedia di bahagian "Fee Structure" dalam Seller Center anda.
+    *   **AuraMall vs. Penjual Biasa:** Penjual AuraMall premium (jenama rasmi, pengedar sah) mungkin mempunyai struktur komisen atau terma perjanjian yang berbeza.
+*   **Yuran Gerbang Pembayaran:**
+    *   **Definisi:** Yuran peratusan kecil yang dicaj oleh pemproses pembayaran untuk mengendalikan transaksi dalam talian (contohnya, kad kredit, AuraWallet, pindahan bank).
+    *   **Kadar:** Biasanya peratusan kecil (contohnya, 1-3%) daripada jumlah transaksi.
+*   **Yuran Penghantaran (Bahagian Penjual):**
+    *   **Definisi:** Walaupun pembeli membayar untuk penghantaran, penjual sering bertanggungjawab untuk berat dan dimensi pakej yang tepat. Jika ini tidak betul, menyebabkan caj kurang kepada pembeli, perbezaan tersebut mungkin dicaj semula kepada penjual. Logistik bersepadu AuraCart memastikan kos penghantaran yang telus.
+*   **Yuran Perkhidmatan Pilihan:**
+    *   **Alat Promosi:** Yuran untuk menggunakan alat pemasaran dan pengiklanan pilihan AuraCart (contohnya, iklan bersponsor, penciptaan baucar). Ini adalah pilihan.
+    *   **Perkhidmatan Pemenuhan Pesanan:** Jika anda memilih perkhidmatan pemenuhan pesanan AuraCart (contohnya, pergudangan, pick-and-pack), yuran yang sepadan akan dikenakan.
+
+### Contoh Pengiraan Yuran (Ilustratif)
+
+*   Harga Produk: $100
+*   Kadar Komisen: 5% = $5.00
+*   Yuran Gerbang Pembayaran: 2% daripada $100 = $2.00
+*   **Bayaran Bersih kepada Penjual:** $100 - $5.00 - $2.00 = $93.00 (Tidak termasuk penghantaran, jika berkenaan)
+
+### Jadual Bayaran
+
+*   AuraCart biasanya memproses bayaran kepada penjual mengikut jadual tetap (contohnya, mingguan atau dua mingguan).
+*   Bayaran meliputi pesanan yang disahkan dan dihantar, biasanya selepas tempoh pemulangan pembeli telah ditutup, untuk memastikan dana tidak ditarik balik disebabkan pemulangan/bayaran balik.
+*   Anda boleh melihat sejarah transaksi dan laporan bayaran anda di Seller Center anda.
+
+## 4. Menguruskan Pesanan
+
+Pengurusan pesanan yang cekap adalah penting untuk prestasi penjual yang baik dan kepuasan pelanggan.
+
+### Pemberitahuan Pesanan Baharu
+
+*   **Peringatan Masa Nyata:** Anda akan menerima pemberitahuan segera melalui Aplikasi AuraCart Seller, e-mel, dan dalam papan pemuka Seller Center apabila pesanan baharu dibuat.
+*   **Gambaran Keseluruhan Papan Pemuka:** Papan pemuka Seller Center anda menyediakan gambaran keseluruhan yang jelas mengenai pesanan baharu, penghantaran yang belum selesai, dan pesanan yang menunggu tindakan.
+
+### Langkah-langkah Pemprosesan Pesanan
+
+1.  **Semak Butiran Pesanan:** Periksa dengan teliti produk, kuantiti, alamat penghantaran pembeli, dan sebarang nota khusus daripada pembeli.
+2.  **Sediakan Item:** Pilih dan bungkus item dengan teliti mengikut garis panduan pembungkusan AuraCart. Pastikan perlindungan yang mencukupi untuk mengelakkan kerosakan semasa transit.
+3.  **Cetak Label Penghantaran:** Jana dan cetak label penghantaran terus dari Seller Center anda. Label ini mengandungi maklumat penjejakan dan butiran alamat pembeli.
+4.  **Serahan kepada Kurier:**
+    *   **Hantar di Pusat:** Hantar item yang dibungkus di pusat pengumpulan rakan kongsi logistik AuraCart yang ditetapkan.
+    *   **Pengambilan:** Jadualkan pengambilan dari lokasi anda jika perkhidmatan ini tersedia di kawasan anda dan untuk kedai anda.
+5.  **Kemas Kini Status:** Pastikan status pesanan dikemas kini kepada "Shipped" atau "Ready for Pickup/Drop-off" dalam Seller Center sebaik sahaja pakej sedia untuk diambil oleh kurier. Maklumat penjejakan akan dikemas kini secara automatik untuk pembeli.
+6.  **Pantau Penghantaran:** Perhatikan status penjejakan sehingga pesanan ditandakan sebagai "Delivered."
+
+### Menangani Isu Pesanan
+
+*   **Pembatalan:**
+    *   **Dimulakan oleh Pembeli:** Pembeli boleh membatalkan pesanan sebelum penghantaran. Jika pesanan dibatalkan, jangan hantar.
+    *   **Dimulakan oleh Penjual:** Dalam kes yang jarang berlaku (contohnya, kehabisan stok), anda mungkin perlu membatalkan pesanan. Sentiasa berkomunikasi dengan segera dengan pembeli dan pilih sebab yang sah. Pembatalan yang terlalu banyak yang dimulakan oleh penjual akan menjejaskan penilaian prestasi anda secara negatif.
+*   **Pemulangan/Bayaran Balik:**
+    *   **Pemberitahuan:** Anda akan dimaklumkan melalui Seller Center jika pembeli memulakan permintaan pemulangan.
+    *   **Semak dan Balas:** Semak sebab dan bukti pembeli, kemudian balas dalam tempoh masa yang ditetapkan (contohnya, 2-3 hari bekerja) untuk meluluskan, menolak, atau meminta maklumat lanjut.
+    *   **Pemeriksaan:** Setelah item yang dipulangkan diterima, periksa ia mengikut Dasar Pemulangan AuraCart.
+    *   **Tindakan:** Proses bayaran balik atau tolak pemulangan berdasarkan hasil pemeriksaan dan dasar AuraCart.
+
+Dengan menguasai asas-asas ini, anda boleh melancarkan dan mengembangkan perniagaan anda di AuraCart dengan berkesan, memberikan pengalaman positif kepada pelanggan anda.

knowledge_base/v2_multilingual/07_seller_guide_advanced_en.md

@@ -0,0 +1,153 @@
+# Advanced Seller Tools
+
+This document provides an in-depth guide for AuraCart sellers to leverage advanced tools available in the Seller Center. Mastering these features will help you boost sales, optimize operations, and enhance customer satisfaction on AuraMall.
+
+## 1. Using AuraCart's Marketing Tools
+
+AuraCart provides a suite of marketing tools to help sellers increase product visibility, attract more buyers, and drive conversions.
+
+### 1.1 Sponsored Product Ads
+
+Sponsored Product Ads allow your products to appear prominently in search results and on relevant product pages, reaching buyers actively looking for items like yours.
+
+*   **How They Work:** You bid on keywords relevant to your products. When a buyer searches for those keywords, your sponsored ad may appear at the top or in designated ad slots. You pay only when a buyer clicks on your ad (Cost-Per-Click).
+*   **Campaign Setup:**
+    1.  **Access:** In Seller Center, navigate to "Marketing Center" > "Sponsored Ads."
+    2.  **Campaign Type:** Choose between "Auto Campaigns" (AuraCart's AI optimizes targeting) or "Manual Campaigns" (you select keywords and bids).
+    3.  **Ad Group & Products:** Select the products you want to promote within an ad group.
+    4.  **Budget & Duration:** Set your daily or total budget and campaign duration.
+    5.  **Keywords & Bids (Manual):** For manual campaigns, research and select relevant keywords. Set competitive bids for each keyword. AuraCart provides keyword suggestions and bid estimates.
+*   **Targeting Options:** Target specific demographics, locations, or even interests to reach the most relevant audience.
+*   **Monitoring & Optimization:** Regularly review your ad performance (impressions, clicks, conversion rate, ROI) in the ad dashboard. Adjust bids, keywords, and budgets to optimize campaign effectiveness.
+
+### 1.2 Vouchers and Promotions
+
+Create various types of vouchers and promotions to incentivize purchases and drive sales for your AuraMall shop.
+
+*   **Seller Vouchers:**
+    *   **Creation:** In "Marketing Center," select "Vouchers." Define the discount type (fixed amount, percentage off), minimum spend, validity period, and products/categories it applies to.
+    *   **Visibility:** Vouchers can be displayed on your shop page, product pages, or distributed via chat.
+*   **Bundle Deals:** Offer discounts when buyers purchase a specific combination of your products (e.g., "Buy 2, Get 10% Off").
+*   **Flash Sales:** Participate in AuraCart's platform-wide flash sales or create your own limited-time, high-discount promotions to create urgency and drive impulse buys. Ensure you have sufficient stock.
+*   **Follower Vouchers:** Encourage new followers to your shop by offering exclusive vouchers when they follow your AuraMall store.
+*   **Promotion Planning:** Plan your promotions strategically, aligning them with AuraCart's major campaign periods (e.g., 11.11, payday sales) for maximum impact.
+
+### 1.3 Shop Decorations & Livestreaming (AuraLive)
+
+Enhance your brand presence and engage buyers with rich content.
+
+*   **Shop Decorations:** Customize your AuraMall store page using various templates and modules (banners, product grids, videos) to create an attractive and professional storefront that reflects your brand identity. A well-designed shop page encourages longer browsing times and higher conversion rates.
+*   **AuraLive (Livestreaming):** Host live video sessions directly within the AuraCart app to showcase products, demonstrate usage, answer live questions, and offer exclusive flash deals.
+    *   **Engagement:** Interact directly with potential buyers, building trust and rapport.
+    *   **Sales:** Drive immediate sales through "add-to-cart" links within the livestream.
+    *   **Preparation:** Plan your content, prepare product samples, and ensure good lighting and audio quality. Promote your AuraLive sessions in advance.
+
+### 1.4 Affiliate Marketing Program (Seller Side)
+
+Leverage AuraCart's network of affiliates (influencers, content creators) to promote your products.
+
+*   **Enabling Products:** Opt-in specific products for the affiliate program in your Seller Center.
+*   **Commission Rate:** Set a competitive commission rate for affiliates for each successful sale they drive.
+*   **Tracking:** AuraCart provides detailed tracking and reporting on affiliate-driven sales, allowing you to see the ROI of your affiliate efforts.
+*   **Increased Reach:** This program extends your marketing reach beyond your direct efforts, tapping into diverse audiences.
+
+## 2. Understanding Seller Performance Analytics
+
+AuraCart's Seller Center provides robust analytics to help you monitor your shop's performance, identify strengths, and pinpoint areas for improvement.
+
+### 2.1 Key Performance Indicators (KPIs)
+
+*   **Sales Volume:** Total number of units sold and total revenue.
+*   **Conversion Rate:** Percentage of visitors who make a purchase. Indicates the effectiveness of your product listings and promotions.
+*   **Average Order Value (AOV):** The average amount spent per order. Strategies like bundles and upsells can increase AOV.
+*   **Unique Visitors:** Number of distinct users who visited your shop or product pages.
+*   **Product Views:** Number of times your product pages were viewed.
+*   **Add-to-Cart Rate:** Percentage of product views that result in an item being added to the cart.
+
+### 2.2 Operational Performance
+
+*   **Shipment Lead Time:** Average time from order confirmation to package handover to the courier. Crucial for customer satisfaction.
+*   **Cancellation Rate:** Percentage of orders cancelled (seller-initiated or buyer-initiated due to seller issues like stock-out). Aim for a low cancellation rate.
+*   **Return Rate:** Percentage of orders returned. High return rates can indicate product quality issues or inaccurate descriptions.
+*   **Late Shipment Rate:** Percentage of orders shipped past the promised timeframe.
+
+### 2.3 Customer Satisfaction Metrics
+
+*   **Seller Rating:** Average rating given by buyers to your shop. A high rating (e.g., 4.8 stars or above) is vital for trust and visibility.
+*   **Chat Response Rate (CRR):** Percentage of buyer inquiries you respond to within a set timeframe. Fast responses improve customer satisfaction.
+*   **Chat Response Time (CRT):** Average time taken to respond to buyer messages.
+*   **Negative Review Percentage:** Percentage of orders that receive low ratings or negative feedback.
+
+### 2.4 Accessing and Interpreting Data
+
+1.  **Seller Center Dashboard:** Your main dashboard provides a quick overview of key metrics, alerts, and pending tasks.
+2.  **Business Insights / Analytics Tab:** Navigate to this section in Seller Center for detailed reports.
+3.  **Report Types:**
+    *   **Sales Report:** Break down sales by product, category, date, etc.
+    *   **Traffic Report:** Understand where your buyers come from (search, category, ads).
+    *   **Product Performance Report:** Analyze individual product performance, identifying bestsellers and underperforming items.
+    *   **Operational Performance Report:** Detailed view of your shipping, cancellation, and return metrics.
+    *   **Customer Service Report:** Insights into your chat performance and customer feedback.
+4.  **Actionable Insights:** Use the data to make informed decisions:
+    *   Identify slow-moving products and consider promotions.
+    *   Improve product descriptions or images if conversion rates are low.
+    *   Optimize operational processes to reduce lead times and cancellations.
+    *   Address negative feedback and improve customer service.
+
+## 3. Managing Customer Reviews
+
+Customer reviews are vital for building trust and influencing purchasing decisions on AuraMall. Active and professional management of reviews is essential.
+
+### 3.1 Importance of Reviews
+
+*   **Credibility & Trust:** High ratings and positive reviews build buyer confidence in your products and shop.
+*   **SEO & Visibility:** Products with good reviews often rank higher in search results.
+*   **Buyer Insights:** Reviews provide valuable feedback on product quality, accuracy of description, and delivery experience.
+
+### 3.2 Responding to Reviews
+
+Always respond to reviews, both positive and negative, in a professional and constructive manner.
+
+*   **For Positive Reviews (4-5 stars):**
+    *   **Thank the Customer:** Express gratitude for their purchase and positive feedback.
+    *   **Personalize:** Mention specific details if applicable (e.g., "Glad you enjoyed the color!").
+    *   **Encourage Repeat Business:** "We look forward to serving you again!"
+*   **For Negative Reviews (1-3 stars):**
+    *   **Apologize Sincerely:** Acknowledge the customer's dissatisfaction. "We are truly sorry to hear that you had this experience."
+    *   **Empathize:** Show understanding for their frustration.
+    *   **Offer Solution/Next Steps:** If the issue is solvable (e.g., defective item), suggest contacting customer support or direct messaging for resolution. "Please contact our customer service team via chat so we can assist you further."
+    *   **Learn from Feedback:** Internalize the feedback to improve your product or service.
+    *   **Maintain Professionalism:** Avoid argumentative or defensive tones.
+*   **Response Guidelines:**
+    *   **Timeliness:** Respond promptly, ideally within 24-48 hours.
+    *   **Conciseness:** Keep responses clear and to the point.
+    *   **Professional Language:** Always use polite and respectful language.
+    *   **No Personal Information:** Never share private details of the customer or your business in public responses.
+
+### 3.3 Reporting Inappropriate Reviews
+
+AuraCart has strict community guidelines. You can report reviews that violate these policies.
+
+*   **When to Report:** Report reviews that contain:
+    *   Hate speech, obscenities, or discrimination.
+    *   Personal attacks or harassment.
+    *   Spam or promotional content unrelated to the product/service.
+    *   False or misleading information intended to harm your business maliciously.
+    *   Disclosure of personal information.
+    *   Content unrelated to the product or delivery experience (e.g., only commenting on courier service without product mention).
+*   **How to Report:**
+    1.  In Seller Center, navigate to "Product Ratings & Reviews."
+    2.  Find the review you wish to report.
+    3.  Click on the "Report" or "Dispute" option next to the review.
+    4.  Select the reason for reporting and provide clear evidence or explanation.
+*   **AuraCart Review:** AuraCart's moderation team will review your report and take appropriate action if the review violates guidelines.
+
+### 3.4 Encouraging Positive Reviews
+
+*   **Excellent Service:** The best way to get positive reviews is to consistently provide high-quality products and exceptional customer service.
+*   **Timely Shipping:** Fast and reliable delivery significantly influences buyer satisfaction.
+*   **Accurate Descriptions:** Ensure your product listings are accurate and detailed to manage buyer expectations.
+*   **Gentle Reminders:** After a successful delivery, AuraCart's system may automatically prompt buyers for a review. You can also include a polite note in your packaging asking for feedback.
+*   **Address Issues Proactively:** Resolve any customer issues or complaints quickly and professionally *before* they turn into negative public reviews.
+
+By utilizing these advanced tools, you can optimize your AuraCart store for growth, efficiency, and sustained success.

knowledge_base/v2_multilingual/07_seller_guide_advanced_my.md

@@ -0,0 +1,153 @@
+# Panduan Terperinci Penjual
+
+Dokumen ini menyediakan panduan mendalam untuk penjual AuraCart bagi memanfaatkan alat canggih yang tersedia di Seller Center. Menguasai ciri-ciri ini akan membantu anda meningkatkan jualan, mengoptimumkan operasi, dan meningkatkan kepuasan pelanggan di AuraMall.
+
+## 1. Menggunakan Alat Pemasaran AuraCart
+
+AuraCart menyediakan pelbagai alat pemasaran untuk membantu penjual meningkatkan keterlihatan produk, menarik lebih ramai pembeli, dan mendorong penukaran.
+
+### 1.1 Iklan Produk Bersponsor
+
+Iklan Produk Bersponsor membolehkan produk anda muncul dengan jelas dalam hasil carian dan di halaman produk yang relevan, mencapai pembeli yang aktif mencari item seperti anda.
+
+*   **Bagaimana Ia Berfungsi:** Anda membida kata kunci yang relevan dengan produk anda. Apabila pembeli mencari kata kunci tersebut, iklan bersponsor anda mungkin muncul di bahagian atas atau di slot iklan yang ditetapkan. Anda hanya membayar apabila pembeli mengklik iklan anda (Kos Per Klik).
+*   **Persediaan Kempen:**
+    1.  **Akses:** Di Seller Center, navigasi ke "Marketing Center" > "Sponsored Ads."
+    2.  **Jenis Kempen:** Pilih antara "Auto Campaigns" (AI AuraCart mengoptimumkan sasaran) atau "Manual Campaigns" (anda memilih kata kunci dan bidaan).
+    3.  **Kumpulan Iklan & Produk:** Pilih produk yang ingin anda promosikan dalam kumpulan iklan.
+    4.  **Bajet & Tempoh:** Tetapkan bajet harian atau keseluruhan anda dan tempoh kempen.
+    5.  **Kata Kunci & Bidaan (Manual):** Untuk kempen manual, selidik dan pilih kata kunci yang relevan. Tetapkan bidaan yang kompetitif untuk setiap kata kunci. AuraCart menyediakan cadangan kata kunci dan anggaran bidaan.
+*   **Pilihan Sasaran:** Sasar demografi, lokasi, atau minat tertentu untuk mencapai audiens yang paling relevan.
+*   **Pemantauan & Pengoptimuman:** Semak prestasi iklan anda secara berkala (tayangan, klik, kadar penukaran, ROI) dalam papan pemuka iklan. Laraskan bidaan, kata kunci, dan bajet untuk mengoptimumkan keberkesanan kempen.
+
+### 1.2 Baucar dan Promosi
+
+Cipta pelbagai jenis baucar dan promosi untuk mendorong pembelian dan meningkatkan jualan untuk kedai AuraMall anda.
+
+*   **Baucar Penjual:**
+    *   **Penciptaan:** Di "Marketing Center," pilih "Vouchers." Takrifkan jenis diskaun (jumlah tetap, peratusan diskaun), perbelanjaan minimum, tempoh sah laku, dan produk/kategori yang terpakai.
+    *   **Keterlihatan:** Baucar boleh dipaparkan di halaman kedai anda, halaman produk, atau diedarkan melalui sembang.
+*   **Tawaran Kombo:** Tawarkan diskaun apabila pembeli membeli kombinasi produk anda yang tertentu (contohnya, "Beli 2, Dapatkan Diskaun 10%").
+*   **Jualan Kilat:** Sertai jualan kilat di seluruh platform AuraCart atau cipta promosi diskaun tinggi masa terhad anda sendiri untuk mencipta desakan dan mendorong pembelian impuls. Pastikan anda mempunyai stok yang mencukupi.
+*   **Baucar Pengikut:** Galakkan pengikut baharu ke kedai anda dengan menawarkan baucar eksklusif apabila mereka mengikuti kedai AuraMall anda.
+*   **Perancangan Promosi:** Rancang promosi anda secara strategik, selaraskannya dengan tempoh kempen utama AuraCart (contohnya, 11.11, jualan gaji) untuk impak maksimum.
+
+### 1.3 Hiasan Kedai & Penstriman Langsung (AuraLive)
+
+Tingkatkan kehadiran jenama anda dan libatkan pembeli dengan kandungan yang kaya.
+
+*   **Hiasan Kedai:** Sesuaikan halaman kedai AuraMall anda menggunakan pelbagai templat dan modul (sepanduk, grid produk, video) untuk mencipta etalase yang menarik dan profesional yang mencerminkan identiti jenama anda. Halaman kedai yang direka dengan baik menggalakkan masa melayari yang lebih lama dan kadar penukaran yang lebih tinggi.
+*   **AuraLive (Penstriman Langsung):** Anjurkan sesi video langsung terus dalam aplikasi AuraCart untuk mempamerkan produk, menunjukkan penggunaan, menjawab soalan langsung, dan menawarkan tawaran kilat eksklusif.
+    *   **Penglibatan:** Berinteraksi terus dengan pembeli berpotensi, membina kepercayaan dan hubungan.
+    *   **Jualan:** Dorong jualan segera melalui pautan "tambah ke troli" dalam penstriman langsung.
+    *   **Persediaan:** Rancang kandungan anda, sediakan sampel produk, dan pastikan pencahayaan dan kualiti audio yang baik. Promosikan sesi AuraLive anda lebih awal.
+
+### 1.4 Program Pemasaran Afiliat (Sisi Penjual)
+
+Manfaatkan rangkaian afiliat AuraCart (pengaruh, pencipta kandungan) untuk mempromosikan produk anda.
+
+*   **Mendayakan Produk:** Pilih produk tertentu untuk program afiliat di Seller Center anda.
+*   **Kadar Komisen:** Tetapkan kadar komisen yang kompetitif untuk afiliat bagi setiap jualan berjaya yang mereka dorong.
+*   **Penjejakan:** AuraCart menyediakan penjejakan dan pelaporan terperinci mengenai jualan yang didorong oleh afiliat, membolehkan anda melihat ROI usaha afiliat anda.
+*   **Jangkauan Peningkatan:** Program ini meluaskan jangkauan pemasaran anda di luar usaha langsung anda, menembusi pelbagai audiens.
+
+## 2. Memahami Analitik Prestasi Penjual
+
+Seller Center AuraCart menyediakan analitik yang kukuh untuk membantu anda memantau prestasi kedai anda, mengenal pasti kekuatan, dan mengenal pasti bidang untuk penambahbaikan.
+
+### 2.1 Petunjuk Prestasi Utama (KPI)
+
+*   **Jumlah Jualan:** Jumlah unit yang dijual dan jumlah pendapatan.
+*   **Kadar Penukaran:** Peratusan pelawat yang membuat pembelian. Menunjukkan keberkesanan penyenaraian produk dan promosi anda.
+*   **Nilai Pesanan Purata (AOV):** Jumlah purata yang dibelanjakan bagi setiap pesanan. Strategi seperti kombo dan upsell boleh meningkatkan AOV.
+*   **Pelawat Unik:** Bilangan pengguna berbeza yang melawat kedai atau halaman produk anda.
+*   **Paparan Produk:** Bilangan kali halaman produk anda dilihat.
+*   **Kadar Tambah ke Troli:** Peratusan paparan produk yang mengakibatkan item ditambahkan ke troli.
+
+### 2.2 Prestasi Operasi
+
+*   **Masa Utama Penghantaran:** Purata masa dari pengesahan pesanan hingga penyerahan pakej kepada kurier. Penting untuk kepuasan pelanggan.
+*   **Kadar Pembatalan:** Peratusan pesanan yang dibatalkan (dimulakan oleh penjual atau dimulakan oleh pembeli disebabkan isu penjual seperti kehabisan stok). Sasarkan kadar pembatalan yang rendah.
+*   **Kadar Pemulangan:** Peratusan pesanan yang dipulangkan. Kadar pemulangan yang tinggi boleh menunjukkan isu kualiti produk atau penerangan yang tidak tepat.
+*   **Kadar Penghantaran Lambat:** Peratusan pesanan yang dihantar melebihi tempoh masa yang dijanjikan.
+
+### 2.3 Metrik Kepuasan Pelanggan
+
+*   **Penilaian Penjual:** Penilaian purata yang diberikan oleh pembeli kepada kedai anda. Penilaian yang tinggi (contohnya, 4.8 bintang atau lebih) adalah penting untuk kepercayaan dan keterlihatan.
+*   **Kadar Respons Sembang (CRR):** Peratusan pertanyaan pembeli yang anda balas dalam tempoh masa yang ditetapkan. Respons pantas meningkatkan kepuasan pelanggan.
+*   **Masa Respons Sembang (CRT):** Purata masa yang diambil untuk membalas mesej pembeli.
+*   **Peratusan Ulasan Negatif:** Peratusan pesanan yang menerima penilaian rendah atau maklum balas negatif.
+
+### 2.4 Mengakses dan Mentafsir Data
+
+1.  **Papan Pemuka Seller Center:** Papan pemuka utama anda menyediakan gambaran keseluruhan pantas mengenai metrik utama, amaran, dan tugas yang belum selesai.
+2.  **Tab Wawasan Perniagaan / Analitik:** Navigasi ke bahagian ini di Seller Center untuk laporan terperinci.
+3.  **Jenis Laporan:**
+    *   **Laporan Jualan:** Pecahan jualan mengikut produk, kategori, tarikh, dsb.
+    *   **Laporan Trafik:** Fahami dari mana pembeli anda datang (carian, kategori, iklan).
+    *   **Laporan Prestasi Produk:** Analisis prestasi produk individu, mengenal pasti produk terlaris dan produk yang kurang berprestasi.
+    *   **Laporan Prestasi Operasi:** Paparan terperinci mengenai metrik penghantaran, pembatalan, dan pemulangan anda.
+    *   **Laporan Khidmat Pelanggan:** Wawasan mengenai prestasi sembang anda dan maklum balas pelanggan.
+4.  **Wawasan Boleh Tindakan:** Gunakan data untuk membuat keputusan yang bermaklumat:
+    *   Kenal pasti produk yang bergerak perlahan dan pertimbangkan promosi.
+    *   Perbaiki penerangan atau gambar produk jika kadar penukaran rendah.
+    *   Optimumkan proses operasi untuk mengurangkan masa utama dan pembatalan.
+    *   Tangani maklum balas negatif dan tingkatkan perkhidmatan pelanggan.
+
+## 3. Menguruskan Ulasan Pelanggan
+
+Ulasan pelanggan adalah penting untuk membina kepercayaan dan mempengaruhi keputusan pembelian di AuraMall. Pengurusan ulasan yang aktif dan profesional adalah penting.
+
+### 3.1 Kepentingan Ulasan
+
+*   **Kredibiliti & Kepercayaan:** Penilaian tinggi dan ulasan positif membina keyakinan pembeli terhadap produk dan kedai anda.
+*   **SEO & Keterlihatan:** Produk dengan ulasan yang baik sering menduduki ranking lebih tinggi dalam hasil carian.
+*   **Wawasan Pembeli:** Ulasan memberikan maklum balas berharga mengenai kualiti produk, ketepatan penerangan, dan pengalaman penghantaran.
+
+### 3.2 Membalas Ulasan
+
+Sentiasa balas ulasan, baik positif mahupun negatif, dengan cara yang profesional dan konstruktif.
+
+*   **Untuk Ulasan Positif (4-5 bintang):**
+    *   **Ucapkan Terima Kasih kepada Pelanggan:** Nyatakan penghargaan atas pembelian dan maklum balas positif mereka.
+    *   **Peribadikan:** Sebutkan butiran khusus jika berkenaan (contohnya, "Gembira anda menyukai warna ini!").
+    *   **Menggalakkan Perniagaan Berulang:** "Kami menantikan untuk melayani anda lagi!"
+*   **Untuk Ulasan Negatif (1-3 bintang):**
+    *   **Mohon Maaf dengan Ikhlas:** Akui ketidakpuasan hati pelanggan. "Kami amat kesal mendengar pengalaman anda ini."
+    *   **Berempati:** Tunjukkan pemahaman terhadap kekecewaan mereka.
+    *   **Tawarkan Penyelesaian/Langkah Seterusnya:** Jika isu boleh diselesaikan (contohnya, item rosak), cadangkan menghubungi sokongan pelanggan atau mesej langsung untuk penyelesaian. "Sila hubungi pasukan khidmat pelanggan kami melalui sembang agar kami dapat membantu anda dengan lebih lanjut."
+    *   **Belajar daripada Maklum Balas:** Gunakan maklum balas tersebut untuk memperbaiki produk atau perkhidmatan anda.
+    *   **Kekalkan Profesionalisme:** Elakkan nada yang argumentatif atau defensif.
+*   **Garis Panduan Respons:**
+    *   **Ketepatan Masa:** Balas dengan segera, sebaik-baiknya dalam masa 24-48 jam.
+    *   **Keringkasan:** Kekalkan respons yang jelas dan tepat.
+    *   **Bahasa Profesional:** Sentiasa gunakan bahasa yang sopan dan hormat.
+    *   **Tiada Maklumat Peribadi:** Jangan sekali-kali berkongsi butiran peribadi pelanggan atau perniagaan anda dalam respons awam.
+
+### 3.3 Melaporkan Ulasan Tidak Sesuai
+
+AuraCart mempunyai garis panduan komuniti yang ketat. Anda boleh melaporkan ulasan yang melanggar dasar ini.
+
+*   **Bila Melapor:** Laporkan ulasan yang mengandungi:
+    *   Ucapan kebencian, kata-kata lucah, atau diskriminasi.
+    *   Serangan peribadi atau gangguan.
+    *   Spam atau kandungan promosi yang tidak berkaitan dengan produk/perkhidmatan.
+    *   Maklumat palsu atau mengelirukan yang bertujuan untuk merugikan perniagaan anda secara berniat jahat.
+    *   Pendedahan maklumat peribadi.
+    *   Kandungan yang tidak berkaitan dengan produk atau pengalaman penghantaran (contohnya, hanya mengulas perkhidmatan kurier tanpa menyebut produk).
+*   **Cara Melapor:**
+    1.  Di Seller Center, navigasi ke "Product Ratings & Reviews."
+    2.  Cari ulasan yang ingin anda laporkan.
+    3.  Klik pada pilihan "Report" atau "Dispute" di sebelah ulasan.
+    4.  Pilih sebab pelaporan dan berikan bukti atau penjelasan yang jelas.
+*   **Semakan AuraCart:** Pasukan moderasi AuraCart akan menyemak laporan anda dan mengambil tindakan yang sesuai jika ulasan tersebut melanggar garis panduan.
+
+### 3.4 Menggalakkan Ulasan Positif
+
+*   **Perkhidmatan Cemerlang:** Cara terbaik untuk mendapatkan ulasan positif adalah dengan secara konsisten menyediakan produk berkualiti tinggi dan perkhidmatan pelanggan yang luar biasa.
+*   **Penghantaran Tepat Masa:** Penghantaran yang pantas dan boleh dipercayai secara signifikan mempengaruhi kepuasan pembeli.
+*   **Penerangan Tepat:** Pastikan penyenaraian produk anda adalah tepat dan terperinci untuk menguruskan jangkaan pembeli.
+*   **Peringatan Lembut:** Selepas penghantaran yang berjaya, sistem AuraCart mungkin secara automatik meminta pembeli untuk memberikan ulasan. Anda juga boleh menyertakan nota sopan dalam pembungkusan anda meminta maklum balas.
+*   **Menangani Isu Secara Proaktif:** Selesaikan sebarang isu atau aduan pelanggan dengan cepat dan profesional *sebelum* ia bertukar menjadi ulasan negatif di khalayak ramai.
+
+Dengan menggunakan alat canggih ini, anda boleh mengoptimumkan kedai AuraCart anda untuk pertumbuhan, kecekapan, dan kejayaan yang berterusan.

knowledge_base/v2_multilingual/08_platform_policies_en.md

@@ -0,0 +1,103 @@
+# Platform Policies and Community Guidelines
+
+AuraCart is committed to fostering a safe, trustworthy, and fair environment for all users on AuraMall. This document outlines our essential platform policies and community guidelines, covering prohibited items, intellectual property rights, and expected standards for reviews and communication.
+
+## 1. Prohibited and Restricted Items Policy
+
+To ensure safety, compliance with regulations, and a reliable marketplace, certain items are strictly prohibited or restricted from being sold on AuraCart.
+
+### 1.1 Prohibited Items
+
+These items are **strictly forbidden** from being listed or sold on AuraCart under any circumstances. Listing such items will result in immediate removal, potential account suspension, and reporting to relevant authorities.
+
+*   **Illegal Drugs and Drug Paraphernalia:** Any illegal substances, controlled narcotics, or instruments used for their consumption.
+*   **Weapons and Ammunition:** Firearms, explosives, knives (beyond common kitchen/utility knives), martial arts weapons, and related accessories.
+*   **Live Animals:** With the exception of certain regulated pet supplies in specific categories.
+*   **Adult/Obscene Material:** Pornographic content, explicit or suggestive materials, or items promoting hate speech or discrimination.
+*   **Stolen Goods:** Any items obtained illegally.
+*   **Counterfeit and Replica Items:** Any product that infringes on existing trademarks or copyrights, falsely claiming to be an authentic brand (see section 2.1).
+*   **Hazardous Materials:** Toxic chemicals, poisons, radioactive materials, or dangerous substances without proper licensing and handling protocols.
+*   **Medical Drugs (Prescription & Illicit):** Any pharmaceutical drugs, prescription medications, or unapproved medical devices.
+*   **Gambling Devices:** Any tools or machines primarily designed for illegal gambling.
+*   **Human Remains & Body Parts:** Including organs, blood, and other bodily fluids.
+*   **Government-Issued Documents & IDs:** Passports, driver's licenses, birth certificates, etc.
+*   **Burial Artefacts:** Items recovered from grave sites or archaeological excavations.
+*   **Embargoed Goods:** Items from countries under international embargo.
+
+### 1.2 Restricted Items
+
+These items may be sold but are subject to strict regulations, require specific licenses, or have limitations on quantity or description. Sellers must ensure full compliance with all applicable laws and AuraCart's specific requirements.
+
+*   **Alcohol:** Sales may be restricted to licensed sellers in specific regions, with age verification upon delivery.
+*   **Tobacco Products:** Similar to alcohol, subject to strict age and licensing regulations.
+*   **Medicines & Health Supplements (Over-the-Counter):** Must be approved by relevant health authorities and accurately labeled.
+*   **Food Products:** Must comply with food safety standards, accurate labeling, and expiry dates. Perishable items may have specific shipping requirements.
+*   **Cosmetics & Skincare:** Must be registered with relevant health authorities and adhere to labeling standards.
+*   **Software & Digital Goods:** Must be legitimately licensed and not violate intellectual property rights.
+*   **Pre-loved/Used Items:** Must be clearly declared as such and meet quality and hygiene standards. Certain categories (e.g., intimate apparel, some electronics) may have stricter rules.
+
+### 1.3 Consequences of Policy Violation
+
+*   **Item Removal:** Prohibited/restricted listings will be immediately removed.
+*   **Account Suspension/Termination:** Repeated or severe violations can lead to temporary or permanent suspension of your seller account.
+*   **Legal Action:** AuraCart cooperates with law enforcement and will report illegal activities.
+*   **Loss of Payouts:** Funds from sales of prohibited items may be withheld.
+
+Sellers are solely responsible for ensuring their listings comply with all applicable local laws, international regulations, and AuraCart's policies.
+
+## 2. Intellectual Property Rights (IPR) Policy
+
+AuraCart respects and upholds intellectual property rights. We prohibit the listing and sale of any items that infringe upon trademarks, copyrights, or patents.
+
+### 2.1 Counterfeit and Infringing Goods
+
+*   **Zero Tolerance:** AuraCart has a zero-tolerance policy against counterfeit products, unauthorized replicas, and items that infringe on trademarks or copyrights.
+*   **Examples of Infringement:**
+    *   Selling fake designer bags, apparel, or electronics bearing a brand's logo without authorization.
+    *   Selling pirated software, movies, music, or e-books.
+    *   Using copyrighted images, text, or designs in product listings without permission.
+    *   Selling patented inventions without license.
+*   **Seller Responsibility:** Sellers are responsible for ensuring that all products they list and sell are authentic and do not infringe on any third-party intellectual property rights.
+
+### 2.2 Reporting IPR Violations
+
+*   **Rights Holders:** If you are an intellectual property rights holder and believe your rights have been violated by a listing on AuraCart, please contact us through our dedicated IPR Infringement Reporting portal in the Seller Center or via our customer support channels.
+*   **Required Information:** Provide clear evidence of your IP ownership (e.g., trademark registration, copyright certificate) and specific details of the infringing listings (e.g., product links, seller names).
+*   **AuraCart's Action:** Upon valid verification, AuraCart will promptly remove the infringing listings and take appropriate action against the offending seller, which may include account suspension.
+
+### 2.3 Consequences for IPR Infringement
+
+*   **Listing Removal:** Infringing listings will be immediately removed.
+*   **Points Deduction/Penalties:** Sellers may incur penalty points or fines.
+*   **Account Suspension/Termination:** Repeated or severe IPR violations will result in the permanent termination of the seller's account.
+*   **Legal Liability:** Sellers found guilty of IPR infringement may face legal action from rights holders, independent of AuraCart's actions.
+
+## 3. Community Standards for Reviews and Communication
+
+AuraCart fosters a respectful and transparent community. These guidelines apply to all user-generated content, including product reviews, seller ratings, Q&A sections, and direct messages.
+
+### 3.1 Content Guidelines for Reviews and Q&A
+
+*   **Relevant & Factual:** Reviews and questions should be directly related to the product or the buyer/seller experience with that specific order. Provide factual information and constructive feedback.
+*   **Respectful Language:** Use polite, respectful, and appropriate language. Do not use profanity, hate speech, discriminatory remarks, or personal attacks.
+*   **No Personal Information:** Do not share personal contact details (phone numbers, email addresses, social media links) of yourself or others.
+*   **No Spam/Advertising:** Do not use reviews or Q&A for unsolicited advertising, promotional content, or external links.
+*   **Authenticity:** Reviews must be based on genuine purchase experiences. Fake reviews or review manipulation are strictly prohibited.
+*   **Photos/Videos:** Images and videos uploaded should be relevant to the product and safe for all audiences. No nudity, violence, or illegal content.
+
+### 3.2 Communication Guidelines (Chat, Q&A)
+
+*   **Professionalism:** Maintain a professional and courteous tone in all communications between buyers and sellers.
+*   **Clarity & Timeliness:** Be clear and concise in your messages. Sellers are expected to respond to buyer inquiries promptly.
+*   **Stay On-Platform:** Conduct all official communication and transactions through the AuraCart platform to ensure buyer/seller protection and for dispute resolution purposes. Do not attempt to move conversations or transactions off-platform.
+*   **No Harassment/Abuse:** Any form of harassment, intimidation, threats, or abusive language is strictly prohibited.
+*   **No Scams/Fraud:** Do not engage in any activity intended to defraud or mislead other users.
+*   **Pricing Discussions:** Do not attempt to negotiate prices outside the listed price or established promotional mechanisms.
+
+### 3.3 Consequences of Guideline Violations
+
+*   **Content Removal:** Violating content (reviews, Q&A, chat messages) will be removed.
+*   **Account Penalties:** Users (buyers or sellers) who repeatedly or severely violate community guidelines may face account warnings, temporary suspensions, or permanent bans.
+*   **Seller Performance Impact:** For sellers, poor chat response rates, negative reviews (due to unprofessional conduct), or policy violations will negatively impact your seller performance metrics.
+
+AuraCart reserves the right to update these policies periodically. It is the responsibility of all users to stay informed and adhere to the latest guidelines to ensure a safe and positive environment for everyone.

knowledge_base/v2_multilingual/08_platform_policies_my.md

@@ -0,0 +1,103 @@
+# Dasar Platform dan Garis Panduan Komuniti
+
+AuraCart komited untuk memupuk persekitaran yang selamat, boleh dipercayai, dan adil untuk semua pengguna di AuraMall. Dokumen ini menggariskan dasar platform dan garis panduan komuniti penting kami, meliputi item terlarang, hak harta intelek, dan standard yang diharapkan untuk ulasan dan komunikasi.
+
+## 1. Dasar Item Terlarang dan Terhad
+
+Untuk memastikan keselamatan, pematuhan terhadap peraturan, dan pasaran yang boleh dipercayai, item-item tertentu adalah dilarang keras atau dihadkan daripada dijual di AuraCart.
+
+### 1.1 Item Terlarang
+
+Item-item ini **dilarang keras** daripada disenaraikan atau dijual di AuraCart dalam apa jua keadaan. Menyenaraikan item sedemikian akan mengakibatkan pengalihan keluar serta-merta, kemungkinan penggantungan akaun, dan pelaporan kepada pihak berkuasa yang berkaitan.
+
+*   **Dadah Haram dan Peralatan Dadah:** Sebarang bahan haram, narkotik terkawal, atau instrumen yang digunakan untuk pengambilannya.
+*   **Senjata dan Peluru:** Senjata api, bahan letupan, pisau (selain pisau dapur/utiliti biasa), senjata seni mempertahankan diri, dan aksesori berkaitan.
+*   **Haiwan Hidup:** Kecuali bekalan haiwan peliharaan terkawal tertentu dalam kategori khusus.
+*   **Bahan Dewasa/Lucah:** Kandungan pornografi, bahan eksplisit atau sugestif, atau item yang mempromosikan ucapan kebencian atau diskriminasi.
+*   **Barang Curi:** Mana-mana item yang diperoleh secara haram.
+*   **Item Tiruan dan Replika:** Mana-mana produk yang melanggar tanda dagangan atau hak cipta sedia ada, secara palsu mendakwa sebagai jenama tulen (lihat seksyen 2.1).
+*   **Bahan Berbahaya:** Bahan kimia toksik, racun, bahan radioaktif, atau bahan berbahaya tanpa pelesenan dan protokol pengendalian yang betul.
+*   **Ubat Perubatan (Preskripsi & Haram):** Sebarang ubat farmaseutikal, ubat preskripsi, atau peranti perubatan yang tidak diluluskan.
+*   **Peranti Perjudian:** Sebarang alat atau mesin yang direka terutamanya untuk perjudian haram.
+*   **Mayat Manusia & Bahagian Badan:** Termasuk organ, darah, dan cecair badan lain.
+*   **Dokumen & ID Keluaran Kerajaan:** Pasport, lesen memandu, sijil kelahiran, dsb.
+*   **Artifak Pengebumian:** Item yang diperoleh dari tapak kubur atau penggalian arkeologi.
+*   **Barang Embargo:** Item dari negara di bawah embargo antarabangsa.
+
+### 1.2 Item Terhad
+
+Item-item ini boleh dijual tetapi tertakluk kepada peraturan ketat, memerlukan lesen khusus, atau mempunyai batasan kuantiti atau penerangan. Penjual mesti memastikan pematuhan penuh dengan semua undang-undang yang berkenaan dan keperluan khusus AuraCart.
+
+*   **Alkohol:** Jualan mungkin dihadkan kepada penjual berlesen di wilayah tertentu, dengan pengesahan umur semasa penyerahan.
+*   **Produk Tembakau:** Serupa dengan alkohol, tertakluk kepada peraturan umur dan pelesenan yang ketat.
+*   **Ubat & Suplemen Kesihatan (Over-the-Counter):** Mesti diluluskan oleh pihak berkuasa kesihatan yang berkaitan dan dilabel dengan tepat.
+*   **Produk Makanan:** Mesti mematuhi standard keselamatan makanan, pelabelan yang tepat, dan tarikh luput. Item mudah rosak mungkin mempunyai keperluan penghantaran khusus.
+*   **Kosmetik & Penjagaan Kulit:** Mesti didaftarkan dengan pihak berkuasa kesihatan yang berkaitan dan mematuhi standard pelabelan.
+*   **Perisian & Barangan Digital:** Mesti dilesenkan secara sah dan tidak melanggar hak harta intelek.
+*   **Item Terpakai/Digunakan:** Mesti diisytiharkan dengan jelas sebagai itu dan memenuhi standard kualiti dan kebersihan. Kategori tertentu (contohnya, pakaian intim, beberapa elektronik) mungkin mempunyai peraturan yang lebih ketat.
+
+### 1.3 Akibat Pelanggaran Dasar
+
+*   **Pengalihan Keluar Item:** Penyenaraian yang dilarang/dihadkan akan segera dialihkan keluar.
+*   **Penggantungan/Penamatan Akaun:** Pelanggaran berulang atau teruk boleh menyebabkan penggantungan sementara atau kekal akaun penjual anda.
+*   **Tindakan Undang-undang:** AuraCart bekerjasama dengan penguatkuasaan undang-undang dan akan melaporkan aktiviti haram.
+*   **Kehilangan Bayaran:** Dana daripada jualan item terlarang mungkin ditahan.
+
+Penjual bertanggungjawab sepenuhnya untuk memastikan penyenaraian mereka mematuhi semua undang-undang tempatan yang berkenaan, peraturan antarabangsa, dan dasar AuraCart.
+
+## 2. Dasar Hak Harta Intelek (IPR)
+
+AuraCart menghormati dan menegakkan hak harta intelek. Kami melarang penyenaraian dan penjualan mana-mana item yang melanggar tanda dagangan, hak cipta, atau paten.
+
+### 2.1 Barangan Tiruan dan Melanggar Hak
+
+*   **Toleransi Sifar:** AuraCart mempunyai dasar toleransi sifar terhadap produk tiruan, replika tidak sah, dan item yang melanggar tanda dagangan atau hak cipta.
+*   **Contoh Pelanggaran:**
+    *   Menjual beg, pakaian, atau elektronik berjenama palsu yang menggunakan logo jenama tanpa kebenaran.
+    *   Menjual perisian, filem, muzik, atau e-buku cetak rompak.
+    *   Menggunakan imej, teks, atau reka bentuk berhak cipta dalam penyenaraian produk tanpa kebenaran.
+    *   Menjual ciptaan berpaten tanpa lesen.
+*   **Tanggungjawab Penjual:** Penjual bertanggungjawab untuk memastikan semua produk yang mereka senaraikan dan jual adalah tulen dan tidak melanggar mana-mana hak harta intelek pihak ketiga.
+
+### 2.2 Melaporkan Pelanggaran IPR
+
+*   **Pemilik Hak:** Jika anda adalah pemilik hak harta intelek dan percaya hak anda telah dilanggar oleh penyenaraian di AuraCart, sila hubungi kami melalui portal Pelaporan Pelanggaran IPR kami yang khusus di Seller Center atau melalui saluran sokongan pelanggan kami.
+*   **Maklumat Diperlukan:** Berikan bukti jelas pemilikan IP anda (contohnya, pendaftaran tanda dagangan, sijil hak cipta) dan butiran khusus penyenaraian yang melanggar (contohnya, pautan produk, nama penjual).
+*   **Tindakan AuraCart:** Setelah pengesahan yang sah, AuraCart akan segera mengalihkan keluar penyenaraian yang melanggar dan mengambil tindakan yang sesuai terhadap penjual yang bersalah, yang mungkin termasuk penggantungan akaun.
+
+### 2.3 Akibat Pelanggaran IPR
+
+*   **Pengalihan Keluar Penyenaraian:** Penyenaraian yang melanggar akan segera dialihkan keluar.
+*   **Potongan Mata/Penalti:** Penjual mungkin dikenakan mata penalti atau denda.
+*   **Penggantungan/Penamatan Akaun:** Pelanggaran IPR yang berulang atau teruk akan mengakibatkan penamatan kekal akaun penjual.
+*   **Liabiliti Undang-undang:** Penjual yang didapati bersalah melanggar IPR mungkin menghadapi tindakan undang-undang daripada pemilik hak, bebas daripada tindakan AuraCart.
+
+## 3. Standard Komuniti untuk Ulasan dan Komunikasi
+
+AuraCart memupuk komuniti yang hormat dan telus. Garis panduan ini terpakai kepada semua kandungan yang dijana pengguna, termasuk ulasan produk, penilaian penjual, bahagian Soal Jawab, dan mesej langsung.
+
+### 3.1 Garis Panduan Kandungan untuk Ulasan dan Soal Jawab
+
+*   **Relevan & Fakta:** Ulasan dan soalan harus berkaitan secara langsung dengan produk atau pengalaman pembeli/penjual dengan pesanan khusus itu. Berikan maklumat fakta dan maklum balas yang membina.
+*   **Bahasa Hormat:** Gunakan bahasa yang sopan, hormat, dan sesuai. Jangan gunakan kata-kata kesat, ucapan kebencian, komen diskriminasi, atau serangan peribadi.
+*   **Tiada Maklumat Peribadi:** Jangan berkongsi butiran hubungan peribadi (nombor telefon, alamat e-mel, pautan media sosial) anda atau orang lain.
+*   **Tiada Spam/Iklan:** Jangan gunakan ulasan atau Soal Jawab untuk pengiklanan yang tidak diminta, kandungan promosi, atau pautan luaran.
+*   **Ketulenan:** Ulasan mesti berdasarkan pengalaman pembelian yang tulen. Ulasan palsu atau manipulasi ulasan adalah dilarang keras.
+*   **Foto/Video:** Imej dan video yang dimuat naik harus relevan dengan produk dan selamat untuk semua audiens. Tiada kandungan lucah, keganasan, atau haram.
+
+### 3.2 Garis Panduan Komunikasi (Sembang, Soal Jawab)
+
+*   **Profesionalisme:** Kekalkan nada yang profesional dan berbudi bahasa dalam semua komunikasi antara pembeli dan penjual.
+*   **Kejelasan & Ketepatan Masa:** Berhati-hati dan ringkas dalam mesej anda. Penjual dijangka membalas pertanyaan pembeli dengan segera.
+*   **Kekal di Platform:** Lakukan semua komunikasi rasmi dan transaksi melalui platform AuraCart untuk memastikan perlindungan pembeli/penjual dan untuk tujuan penyelesaian pertikaian. Jangan cuba memindahkan perbualan atau transaksi di luar platform.
+*   **Tiada Gangguan/Penyalahgunaan:** Sebarang bentuk gangguan, ugutan, ancaman, atau bahasa kasar adalah dilarang keras.
+*   **Tiada Penipuan/Penipuan:** Jangan terlibat dalam sebarang aktiviti yang bertujuan untuk menipu atau mengelirukan pengguna lain.
+*   **Perbincangan Harga:** Jangan cuba merundingkan harga di luar harga yang disenaraikan atau mekanisme promosi yang ditetapkan.
+
+### 3.3 Akibat Pelanggaran Garis Panduan
+
+*   **Pengalihan Keluar Kandungan:** Kandungan yang melanggar (ulasan, Soal Jawab, mesej sembang) akan dialihkan keluar.
+*   **Penalti Akaun:** Pengguna (pembeli atau penjual) yang berulang kali atau secara serius melanggar garis panduan komuniti mungkin menghadapi amaran akaun, penggantungan sementara, atau larangan kekal.
+*   **Impak Prestasi Penjual:** Bagi penjual, kadar respons sembang yang buruk, ulasan negatif (disebabkan tingkah laku tidak profesional), atau pelanggaran dasar akan menjejaskan metrik prestasi penjual anda secara negatif.
+
+AuraCart berhak untuk mengemas kini dasar ini secara berkala. Adalah menjadi tanggungjawab semua pengguna untuk sentiasa dimaklumkan dan mematuhi garis panduan terkini bagi memastikan persekitaran yang selamat dan positif untuk semua.

knowledge_base/v2_multilingual/09_customer_support_and_disputes_en.md

@@ -0,0 +1,99 @@
+# Customer Support and Dispute Resolution
+
+At AuraCart, we are committed to providing excellent customer service and ensuring a fair and efficient process for resolving any issues you may encounter. This document outlines how to contact AuraCart support, the process for resolving order-related disputes, and details our comprehensive Buyer/Seller Protection Program.
+
+## 1. How to Contact AuraCart Support
+
+AuraCart offers multiple channels for you to reach our customer support team.
+
+### 1.1 In-App / Website Help Center
+
+*   **Self-Service:** Our Help Center, accessible through the AuraCart app or website, contains a vast library of frequently asked questions (FAQs) and knowledge base articles (like this one!). Many common queries can be resolved here directly.
+*   **Searching for Answers:** Use the search bar within the Help Center to find articles related to your specific issue (e.g., "return status," "AuraWallet top-up").
+
+### 1.2 Live Chat Support
+
+*   **Availability:** Live chat is typically the fastest way to get assistance from a customer service representative. It's available during specific operating hours, which can be found in the Help Center.
+*   **Access:** Look for the "Chat with Us" or "Contact Support" button, usually found within the Help Center or "My Account" section of the app/website.
+*   **Connecting with an Agent:** You may first interact with a chatbot that can answer basic questions or direct you to the relevant articles. If your issue requires human assistance, the chatbot will guide you to connect with a live agent.
+*   **Information to Prepare:** Have your order ID, relevant screenshots, or specific details of your issue ready to expedite the process.
+
+### 1.3 Email Support
+
+*   **Non-Urgent Issues:** For less urgent matters or inquiries that require detailed explanations and attachments, email support is available.
+*   **How to Email:** Submit a ticket or send an email through the "Contact Us" form in the Help Center.
+*   **Response Time:** Email responses typically take 24-48 business hours, depending on query volume.
+*   **Include Details:** Always include your AuraCart registered email/phone, order ID (if applicable), and a clear, detailed description of your issue.
+
+### 1.4 Social Media (for General Inquiries)
+
+*   **Community Engagement:** AuraCart's official social media channels can be used for general inquiries, announcements, and community engagement.
+*   **Avoid Sensitive Information:** Do not share personal or sensitive account details via social media DMs. For specific account or order issues, always use the in-app/website chat or email support for security reasons.
+
+## 2. Process for Resolving Issues with Orders
+
+AuraCart has a structured process for handling order-related issues, ensuring fairness for both buyers and sellers.
+
+### 2.1 Before Initiating a Formal Dispute
+
+*   **Contact the Seller First (for non-delivery/item issues):** For issues like a missing item, wrong product received, or a damaged item, it's often best to try and communicate directly with the seller via AuraCart's chat function first. Many issues can be quickly resolved through direct communication.
+*   **Provide Evidence:** Always provide clear evidence (photos, videos) if the issue is related to product condition (e.g., damaged, defective, wrong item).
+
+### 2.2 Initiating a Return/Refund Request
+
+If direct communication with the seller doesn't resolve the issue, or if the issue is related to product quality/condition, proceed with a formal return/refund request.
+
+1.  **Access "My Orders":** Log in to your AuraCart account and go to "My Orders."
+2.  **Select Order & Item:** Find the specific order and item you have an issue with.
+3.  **Click "Return/Refund":** Select the option to initiate a return or refund request.
+4.  **Choose Reason & Provide Details:** Select the most appropriate reason for your request (e.g., "Received damaged item," "Missing item," "Product not as described"). Provide a detailed explanation of the problem and upload all relevant supporting evidence (photos, videos, chat logs if applicable).
+5.  **Submit Request:** Confirm and submit your request.
+
+### 2.3 Seller's Response and AuraCart Intervention
+
+*   **Seller Review:** The seller will be notified of your request and given a timeframe (e.g., 2-3 business days) to review it and propose a solution (e.g., approve return, offer partial refund, reject).
+*   **AuraCart Intervention (Dispute Resolution):**
+    *   **Automatic Escalation:** If the seller fails to respond within the stipulated time, or if the buyer and seller cannot agree on a resolution, the case will automatically escalate to AuraCart's dispute resolution team.
+    *   **Manual Escalation:** You can also manually escalate a case to AuraCart if you believe the seller's response is unsatisfactory or unreasonable, and the option becomes available after the initial communication period.
+    *   **Investigation:** AuraCart's team will thoroughly review all evidence provided by both the buyer and the seller. They may also contact either party for further clarification or request additional evidence.
+    *   **Decision:** Based on the investigation and AuraCart's policies, a final decision will be made. This decision is binding for both parties. Possible outcomes include:
+        *   Full refund to the buyer.
+        *   Partial refund to the buyer.
+        *   Return of the item for a refund.
+        *   Rejection of the refund/return request.
+
+### 2.4 Resolution and Follow-Up
+
+*   **Refund Processing:** If a refund is approved, it will be processed according to AuraCart's Returns and Refunds Policy (see `04_returns_and_refunds_en.md` for details on processing times).
+*   **Return Instructions:** If a return is required, clear instructions on how to ship the item back will be provided.
+*   **Communication:** You will receive notifications on the progress and final resolution of your dispute.
+
+## 3. Buyer and Seller Protection Program
+
+AuraCart's Buyer/Seller Protection Program is designed to ensure a fair and secure trading environment for everyone on AuraMall.
+
+### 3.1 Buyer Protection
+
+AuraCart is committed to protecting buyers from fraudulent sellers and ensuring they receive what they paid for.
+
+*   **Authenticity Guarantee:** AuraMall products are guaranteed to be authentic. If a buyer receives a counterfeit item from an AuraMall seller, they are entitled to a full refund.
+*   **Money-Back Guarantee:** Buyers are protected by a money-back guarantee if:
+    *   The item does not arrive within the estimated delivery time frame.
+    *   The item received is significantly not as described (e.g., wrong item, defective, damaged).
+    *   The item received is incomplete (missing parts/accessories).
+*   **Secure Payment System:** AuraCart holds payments in escrow until the buyer confirms satisfactory receipt of the item, or the return window has passed. Funds are only released to the seller after successful delivery and buyer satisfaction.
+*   **Dispute Resolution Support:** Access to AuraCart's dispute resolution team to mediate and resolve conflicts between buyers and sellers.
+*   **Data Security:** Protection of personal and payment information through encryption and secure protocols.
+
+### 3.2 Seller Protection
+
+AuraCart also protects sellers from fraudulent buyers and ensures fair play.
+
+*   **Proof of Delivery:** Sellers are protected against "item not received" claims when valid proof of delivery (tracking information provided by AuraCart's logistics partners) is available.
+*   **Return Policy Enforcement:** AuraCart enforces its return policy, ensuring that items returned by buyers meet the required conditions (e.g., original condition, all parts included).
+*   **Protection Against Abusive Returns:** Sellers are protected against buyers who abuse the return policy (e.g., returning a different item, significant damage not present at delivery, buyer-caused damage).
+*   **Secured Payouts:** Funds are released to sellers only after a successful transaction, minimizing risk from fraudulent payments.
+*   **Dispute Resolution Support:** Access to AuraCart's dispute resolution team to mediate conflicts and review evidence from both sides.
+*   **Community Guidelines:** Protection from abusive or inappropriate content/communication from buyers.
+
+By leveraging these support channels and understanding the dispute resolution process, you can navigate any challenges confidently, knowing that AuraCart is dedicated to a secure and satisfactory experience for all users.

knowledge_base/v2_multilingual/09_customer_support_and_disputes_my.md

@@ -0,0 +1,99 @@
+# Sokongan Pelanggan dan Penyelesaian Pertikaian
+
+Di AuraCart, kami komited untuk menyediakan perkhidmatan pelanggan yang cemerlang dan memastikan proses yang adil dan cekap untuk menyelesaikan sebarang isu yang mungkin anda hadapi. Dokumen ini menggariskan cara menghubungi sokongan AuraCart, proses untuk menyelesaikan pertikaian berkaitan pesanan, dan memperincikan Program Perlindungan Pembeli/Penjual kami yang komprehensif.
+
+## 1. Cara Menghubungi Sokongan AuraCart
+
+AuraCart menawarkan pelbagai saluran untuk anda menghubungi pasukan sokongan pelanggan kami.
+
+### 1.1 Pusat Bantuan dalam Aplikasi / Laman Web
+
+*   **Layan Diri:** Pusat Bantuan kami, yang boleh diakses melalui aplikasi AuraCart atau laman web, mengandungi perpustakaan besar soalan lazim (FAQ) dan artikel pangkalan pengetahuan (seperti yang ini!). Banyak pertanyaan umum boleh diselesaikan terus di sini.
+*   **Mencari Jawapan:** Gunakan bar carian dalam Pusat Bantuan untuk mencari artikel yang berkaitan dengan isu khusus anda (contohnya, "status pemulangan," "tambah nilai AuraWallet").
+
+### 1.2 Sokongan Sembang Langsung
+
+*   **Ketersediaan:** Sembang langsung biasanya adalah cara terpantas untuk mendapatkan bantuan daripada wakil khidmat pelanggan. Ia tersedia semasa waktu operasi tertentu, yang boleh didapati di Pusat Bantuan.
+*   **Akses:** Cari butang "Chat with Us" atau "Contact Support", biasanya terdapat dalam Pusat Bantuan atau bahagian "My Account" dalam aplikasi/laman web.
+*   **Berhubung dengan Ejen:** Anda mungkin terlebih dahulu berinteraksi dengan chatbot yang boleh menjawab soalan asas atau mengarahkan anda ke artikel yang berkaitan. Jika isu anda memerlukan bantuan manusia, chatbot akan membimbing anda untuk berhubung dengan ejen langsung.
+*   **Maklumat untuk Disediakan:** Sediakan ID pesanan anda, tangkapan skrin yang berkaitan, atau butiran khusus isu anda untuk mempercepatkan proses.
+
+### 1.3 Sokongan E-mel
+
+*   **Isu Tidak Mendesak:** Untuk perkara yang kurang mendesak atau pertanyaan yang memerlukan penjelasan terperinci dan lampiran, sokongan e-mel tersedia.
+*   **Cara Menghantar E-mel:** Hantar tiket atau hantar e-mel melalui borang "Contact Us" di Pusat Bantuan.
+*   **Masa Respons:** Respons e-mel biasanya mengambil masa 24-48 jam bekerja, bergantung pada jumlah pertanyaan.
+*   **Sertakan Butiran:** Sentiasa sertakan e-mel/telefon berdaftar AuraCart anda, ID pesanan (jika berkenaan), dan penerangan yang jelas dan terperinci tentang isu anda.
+
+### 1.4 Media Sosial (untuk Pertanyaan Umum)
+
+*   **Penglibatan Komuniti:** Saluran media sosial rasmi AuraCart boleh digunakan untuk pertanyaan umum, pengumuman, dan penglibatan komuniti.
+*   **Elakkan Maklumat Sensitif:** Jangan berkongsi butiran akaun peribadi atau sensitif melalui mesej langsung media sosial. Untuk isu akaun atau pesanan tertentu, sentiasa gunakan sembang dalam aplikasi/laman web atau sokongan e-mel atas sebab keselamatan.
+
+## 2. Proses Menyelesaikan Isu dengan Pesanan
+
+AuraCart mempunyai proses berstruktur untuk mengendalikan isu berkaitan pesanan, memastikan keadilan untuk pembeli dan penjual.
+
+### 2.1 Sebelum Memulakan Pertikaian Formal
+
+*   **Hubungi Penjual Terlebih Dahulu (untuk isu bukan penghantaran/item):** Untuk isu seperti item hilang, produk salah diterima, atau item rosak, selalunya lebih baik untuk cuba berkomunikasi terus dengan penjual melalui fungsi sembang AuraCart terlebih dahulu. Banyak isu boleh diselesaikan dengan cepat melalui komunikasi langsung.
+*   **Berikan Bukti:** Sentiasa berikan bukti yang jelas (gambar, video) jika isu berkaitan dengan keadaan produk (contohnya, rosak, cacat, item salah).
+
+### 2.2 Memulakan Permintaan Pemulangan/Bayaran Balik
+
+Jika komunikasi langsung dengan penjual tidak menyelesaikan isu tersebut, atau jika isu berkaitan dengan kualiti/keadaan produk, teruskan dengan permintaan pemulangan/bayaran balik formal.
+
+1.  **Akses "My Orders":** Log masuk ke akaun AuraCart anda dan pergi ke "My Orders."
+2.  **Pilih Pesanan & Item:** Cari pesanan dan item khusus yang anda mempunyai isu dengannya.
+3.  **Klik "Return/Refund":** Pilih pilihan untuk memulakan permintaan pemulangan atau bayaran balik.
+4.  **Pilih Sebab & Berikan Butiran:** Pilih sebab yang paling sesuai untuk permintaan anda (contohnya, "Menerima item rosak," "Item hilang," "Produk tidak seperti yang diterangkan"). Berikan penjelasan terperinci mengenai masalah tersebut dan muat naik semua bukti sokongan yang relevan (gambar, video, log sembang jika berkenaan).
+5.  **Hantar Permintaan:** Sahkan dan hantar permintaan anda.
+
+### 2.3 Respons Penjual dan Campur Tangan AuraCart
+
+*   **Semakan Penjual:** Penjual akan dimaklumkan mengenai permintaan anda dan diberikan tempoh masa (contohnya, 2-3 hari bekerja) untuk menyemaknya dan mencadangkan penyelesaian (contohnya, meluluskan pemulangan, menawarkan bayaran balik separa, menolak).
+*   **Campur Tangan AuraCart (Penyelesaian Pertikaian):**
+    *   **Eskalasi Automatik:** Jika penjual gagal bertindak balas dalam tempoh masa yang ditetapkan, atau jika pembeli dan penjual tidak dapat mencapai persetujuan mengenai penyelesaian, kes akan secara automatik dieskalasi kepada pasukan penyelesaian pertikaian AuraCart.
+    *   **Eskalasi Manual:** Anda juga boleh secara manual mengeskalasi kes kepada AuraCart jika anda percaya respons penjual tidak memuaskan atau tidak munasabah, dan pilihan tersebut akan tersedia selepas tempoh komunikasi awal.
+    *   **Siasatan:** Pasukan AuraCart akan menyemak dengan teliti semua bukti yang diberikan oleh pembeli dan penjual. Mereka juga mungkin menghubungi mana-mana pihak untuk penjelasan lanjut atau meminta bukti tambahan.
+    *   **Keputusan:** Berdasarkan siasatan dan dasar AuraCart, keputusan akhir akan dibuat. Keputusan ini mengikat kedua-dua pihak. Hasil yang mungkin termasuk:
+        *   Bayaran balik penuh kepada pembeli.
+        *   Bayaran balik separa kepada pembeli.
+        *   Pemulangan item untuk bayaran balik.
+        *   Penolakan permintaan bayaran balik/pemulangan.
+
+### 2.4 Resolusi dan Tindakan Susulan
+
+*   **Pemprosesan Bayaran Balik:** Jika bayaran balik diluluskan, ia akan diproses mengikut Dasar Pemulangan dan Bayaran Balik AuraCart (lihat `04_returns_and_refunds_en.md` untuk butiran mengenai masa pemprosesan).
+*   **Arahan Pemulangan:** Jika pemulangan diperlukan, arahan yang jelas mengenai cara menghantar semula item akan diberikan.
+*   **Komunikasi:** Anda akan menerima pemberitahuan mengenai kemajuan dan penyelesaian akhir pertikaian anda.
+
+## 3. Program Perlindungan Pembeli dan Penjual
+
+Program Perlindungan Pembeli/Penjual AuraCart direka untuk memastikan persekitaran perdagangan yang adil dan selamat untuk semua orang di AuraMall.
+
+### 3.1 Perlindungan Pembeli
+
+AuraCart komited untuk melindungi pembeli daripada penjual penipu dan memastikan mereka menerima apa yang mereka bayar.
+
+*   **Jaminan Ketulenan:** Produk AuraMall dijamin ketulenannya. Jika pembeli menerima item tiruan daripada penjual AuraMall, mereka berhak mendapat bayaran balik penuh.
+*   **Jaminan Wang Dikembalikan:** Pembeli dilindungi oleh jaminan wang dikembalikan jika:
+    *   Item tidak tiba dalam tempoh masa penghantaran yang dianggarkan.
+    *   Item yang diterima adalah tidak seperti yang diterangkan secara signifikan (contohnya, item salah, cacat, rosak).
+    *   Item yang diterima tidak lengkap (bahagian/aksesori hilang).
+*   **Sistem Pembayaran Selamat:** AuraCart memegang pembayaran dalam escrow sehingga pembeli mengesahkan penerimaan item yang memuaskan, atau tempoh pemulangan telah berlalu. Dana hanya akan dilepaskan kepada penjual selepas penghantaran yang berjaya dan kepuasan pembeli.
+*   **Sokongan Penyelesaian Pertikaian:** Akses kepada pasukan penyelesaian pertikaian AuraCart untuk menjadi pengantara dan menyelesaikan konflik antara pembeli dan penjual.
+*   **Keselamatan Data:** Perlindungan maklumat peribadi dan pembayaran melalui penyulitan dan protokol selamat.
+
+### 3.2 Perlindungan Penjual
+
+AuraCart juga melindungi penjual daripada pembeli penipu dan memastikan permainan yang adil.
+
+*   **Bukti Penyerahan:** Penjual dilindungi daripada tuntutan "item tidak diterima" apabila bukti penyerahan yang sah (maklumat penjejakan yang disediakan oleh rakan kongsi logistik AuraCart) tersedia.
+*   **Penguatkuasaan Dasar Pemulangan:** AuraCart menguatkuasakan dasar pemulangan, memastikan item yang dipulangkan oleh pembeli memenuhi syarat yang diperlukan (contohnya, keadaan asal, semua bahagian disertakan).
+*   **Perlindungan Terhadap Pemulangan Berlebihan:** Penjual dilindungi daripada pembeli yang menyalahgunakan dasar pemulangan (contohnya, memulangkan item yang berbeza, kerosakan signifikan yang tidak wujud semasa penyerahan, kerosakan yang disebabkan oleh pembeli).
+*   **Bayaran Terjamin:** Dana dilepaskan kepada penjual hanya selepas transaksi yang berjaya, meminimumkan risiko daripada pembayaran penipuan.
+*   **Sokongan Penyelesaian Pertikaian:** Akses kepada pasukan penyelesaian pertikaian AuraCart untuk menjadi pengantara konflik dan menyemak bukti dari kedua-dua belah pihak.
+*   **Garis Panduan Komuniti:** Perlindungan daripada kandungan/komunikasi yang menyalahgunakan atau tidak sesuai daripada pembeli.
+
+Dengan memanfaatkan saluran sokongan ini dan memahami proses penyelesaian pertikaian, anda boleh menavigasi sebarang cabaran dengan yakin, mengetahui bahawa AuraCart berdedikasi untuk pengalaman yang selamat dan memuaskan untuk semua pengguna.

v1_malay_selfhosted/.gitattributes

@@ -0,0 +1,38 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.faiss filter=lfs diff=lfs merge=lfs -text
+*.docx filter=lfs diff=lfs merge=lfs -text
+faiss_malay_ecommerce_kb_index/index.faiss filter=lfs diff=lfs merge=lfs -text
+faiss_malay_ecommerce_kb_index/index.pkl filter=lfs diff=lfs merge=lfs -text

v1_malay_selfhosted/.gitignore

@@ -0,0 +1,144 @@
+# Environments
+p3env/
+venv/
+env/
+
+# Python cache and compiled files
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints/
+
+# Distribution / packaging
+*.egg-info/
+dist/
+build/
+wheels/
+*.tar.gz
+*.whl
+
+# Logs and reports
+*.log
+*.html # Ignore generated reports like profiling
+
+# IDE / OS specific
+.vscode/
+.idea/
+*.DS_Store
+Thumbs.db
+
+# Output directories / Large Files (IGNORED)
+malay-qa-model-finetuned/ # Ignore large saved fine-tuned model
+models/ # Generic models folder often ignored
+# *.joblib # Ignore generic joblib files (like from P1)
+# *.pkl # Ignore generic pickle files
+.hf_cache_st/ # Ignore downloaded embedding model cache
+.cache_st/ # Ignore downloaded embedding model cache (alternative name used)
+.dvc/cache # Ignore DVC cache if DVC is used
+
+# --- Files/Folders to *KEEP* for P3 Deployment ---
+# Ensure these lines are COMMENTED OUT or DELETED:
+# faiss_malay_ecommerce_kb_index/
+# knowledge_base/
+# squad_format_qa_pairs.json # Keep the source data JSON
+# ecommerce_malay_qa.csv # Keep source data CSV (optional if JSON is primary)
+
+# --- Other Ignores ---
+# *.zip # Keep commented if you might commit small zip files
+# *.png # Keep commented if you need specific image assets in repo
+# *.jpg # Keep commented if you need specific image assets in repo
+# app_old.py # Good to ignore backups
+# app_v*.py # Good to ignore backups
+
+# Add these cache folders
+.cache_st/
+.hf_cache_st/
+.hf_cache_st_test/
+
+# Add model output
+malay-qa-model-finetuned/
+
+# Add archives and specific media/temp files if not covered by *.ext
+*.zip
+*.png
+*.jpg
+Untitled.ipynb
+app_old.py
+app_v*.py # Covers app_v2.py, app_v3.2.py etc.
+drive1.png
+ecommerce_malay_qa.csv # Ignore CSV if JSON is source
+first*.png
+hf*.png
+inspo*.png
+latest*.png
+new*.png
+revolab*.png
+streamlit*.png
+ui*.jpg
+uiux*.png
+app_v3.py
+app_new.py
+
+# Ensure these are still ignored
+p3env/
+__pycache__/
+*.pyc
+# Ensure these are NOT ignored (remove lines if present)
+# faiss_malay_ecommerce_kb_index/
+# knowledge_base/
+
+# Ignore old app versions/duplicates
+app2.py
+app_v*.py
+*_needtofix.py
+*_testing.py
+
+# Ignore temporary/debug scripts
+debug_*.py
+custom_embedder.py # Assuming this was temporary
+
+# Ignore copies
+*Copy.txt
+*copy.txt
+
+# Ignore other potentially unwanted files/folders
+# Add anything else specific here
+
+# --- Ensure these are NOT ignored ---
+# Make sure lines starting with '#' are before these if they existed:
+# !faiss_malay_ecommerce_kb_index/ # Example if it was ignored before
+# !knowledge_base/
+
+# Ignore temporary/debug scripts
+# debug_*.py
+# custom_embedder.py
+
+# Ignore copies
+*Copy.txt
+
+# Ignore old app versions if any (based on previous issues)
+app_v*.py
+*_testing.py
+app2.py # If this was an old version
+
+
+# --- Ensure essential files/folders are NOT ignored ---
+!app.py
+!reindex.py
+!01-FineTuning-QA.ipynb
+!02-RAG-Pipeline.ipynb
+!requirements.txt
+!README.md
+!faiss_malay_ecommerce_kb_index/
+!knowledge_base/
+!squad_format_qa_pairs.json
+!ecommerce_malay_qa.csv
+#.gitattributes # Usually added by LFS, not manual ignore
+
+/p3env2/
+p3env2/
+
+.mailmap