جستجوگر سریع شناسه کالا (CSV)

این ابزار یک برنامه وب تک‌فایلی (Single-Page Application - SPA) است که با استفاده از HTML، CSS (به کمک فریمورک Tailwind CSS) و جاوا اسکریپت خالص ساخته شده است تا یک موتور جستجوی بسیار سریع را در سمت مرورگر شما پیاده‌سازی کند.

مراحل اصلی کارکرد:

1. بارگذاری داده (Load Data):

   برنامه تلاش می‌کند تا فایل 1.csv را به صورت محلی بارگذاری کند. به دلیل مشکلات امنیتی شبکه (CORS و قطع شدن اتصال)، یک مجموعه داده نمونه داخلی (Fallback) در کد تعبیه شده است. اگر بارگذاری فایل اصلی شکست بخورد، برنامه به طور خودکار از این داده‌های داخلی استفاده می‌کند و یک پیام هشدار زرد رنگ نمایش می‌دهد. تمام محتویات CSV به صورت یک آرایه جاوا اسکریپتی به نام allData در حافظه مرورگر ذخیره می‌شود.

2. پردازش و تجزیه (Parsing):

   تابع processData، متن CSV را خط به خط می‌خواند. **این فرآیند اکنون شامل استخراج نوع، وضعیت و شمول مالیاتی کالا نیز هست.**

3. جستجوی سریع (SearchData - Debounced):

   هر بار که شما تایپ می‌کنید، تابع searchData اجرا می‌شود، اما برای جلوگیری از کندی، از تکنیک Debounce استفاده می‌کند. این بدان معناست که جستجو تنها زمانی انجام می‌شود که تایپ کردن شما برای ۱۰۰ میلی‌ثانیه متوقف شود. جستجوگر، تمام ردیف‌های موجود در آرایه allData را فیلتر می‌کند. از آنجا که تمام داده‌ها قبلاً در حافظه مرورگر لود شده‌اند، فرآیند جستجو بسیار **سریع و آنی** است.

4. نمایش نتایج (DisplayResults):

   نتایج فیلتر شده (حداکثر ۵۰ مورد) به صورت کارت‌های زیبا و خوانا نمایش داده می‌شوند. **این کارت‌ها اکنون اطلاعات مالیاتی (مشمول/معاف) و نوع شناسه را نیز نشان می‌دهند.**