updates on the backend

data/seed_catalogs/brand_catalog_naga.json

@@ -0,0 +1,59 @@
+{
+  "brand": "naga",
+  "search_query": "Naga products catalog",
+  "generation_timestamp": "C:\\Brand_Catalog_LLM\\RAG_Model_Nutrition_Intelligence\\RAG_Model_Full_Implement\\backend\\app\\api\\routers\\user_products.py",
+  "total_products": 1,
+  "total_images": 2,
+  "products": [
+    {
+      "image_id": "naga_naga_maida_2kg",
+      "product_name": "Naga Maida 2kg",
+      "title": "Naga Maida 2kg",
+      "brand": "Naga",
+      "brand_name": "Naga",
+      "category": "Flour & Grains",
+      "description": "High grade refined wheat flour maida",
+      "price_range": "₹90-110",
+      "size_variants": [
+        "2kg"
+      ],
+      "providers": [
+        "Amazon",
+        "Flipkart",
+        "BigBasket",
+        "Jiomart",
+        "Blinkit",
+        "Zepto"
+      ],
+      "highlights": [
+        "Naga Brand - Trusted Quality",
+        "Atta & Staples Category",
+        "Affordable at ₹41-49",
+        "Available in 250g",
+        "Premium Quality",
+        "Available on 6 platforms"
+      ],
+      "nutrients": [
+        "Carbohydrates - Sustained energy",
+        "Dietary Fiber - Digestive health",
+        "Vitamin B1 (Thiamine) - Energy metabolism",
+        "Iron - Blood health",
+        "Folic Acid - Cell growth"
+      ],
+      "fssai_license": "10012042000192",
+      "product_sku": "NAGA-NAGA_M-001",
+      "sku_source": "User Upload",
+      "hsn_code": "1101",
+      "final_selling_price": 98.0,
+      "selling_price": 98.0,
+      "barcode": "8906012345001",
+      "barcode_type": "GTIN-13",
+      "image_url": "https://nearle.sgp1.digitaloceanspaces.com/daily/brands/naga/naga_naga_maida_250g/image_000.jpg",
+      "image_urls": [
+        "https://nearle.sgp1.digitaloceanspaces.com/daily/brands/naga/naga_naga_maida_250g/image_000.jpg",
+        "https://nearle.sgp1.digitaloceanspaces.com/daily/brands/naga/naga_naga_maida_250g/image_001.png"
+      ],
+      "search_query": "Naga Naga Maida 2kg Flour & Grains High grade refined wheat flour maida ₹90-110"
+    }
+  ]
+}

data/seed_catalogs/hsn_gst_master.json

@@ -0,0 +1,66 @@
+{
+  "_meta": {
+    "description": "HSN (Harmonized System of Nomenclature) code and GST% reference table, keyed by the free-text 'category' values this project already assigns to products (see app/core/catalog_engine.py category_map and app/services/brand_registry.get_sub_brand_category). This file is the ONLY source of HSN/GST values used by the pipeline - see app/services/tax_master.py. Nothing here is predicted or inferred by the LLM/ML models; it is a plain lookup table, by design (regulatory values must not be ML-derived).",
+    "basis": "Rates reflect India's 'GST 2.0' rate rationalization from the 56th GST Council meeting, effective 22 September 2025, which collapsed the old 5/12/18/28% slabs into mainly 5%/18% (plus a 40% slab for sin/luxury goods). Most branded packaged FMCG (soap, shampoo, biscuits, namkeen, noodles, chocolates, ghee, etc.) moved from 12-18% down to 5%. A handful of categories (deodorants/perfume, premium cosmetics, mosquito repellents, air fresheners) were NOT part of that cut and remain at 18%.",
+    "disclaimer": "THIS IS A STARTING REFERENCE, NOT A LEGAL SOURCE. GST rates and HSN classifications are set by the CBIC/GST Council and can change; several entries below also depend on exact product formulation/packaging (e.g. loose vs branded, medicament vs cosmetic) which a category-level table cannot fully capture. Before using this for real invoicing or GST returns, verify every rate against the official CBIC notifications at https://cbic.gov.in and/or a qualified tax advisor. Entries with \"needs_review\": true are especially uncertain or category is a data-quality catch-all, not a real GST classification.",
+    "last_reviewed": "2026-07-30",
+    "default": {
+      "hsn_code": "9999",
+      "gst_percent": 18,
+      "needs_review": true,
+      "notes": "Fallback used when a product's category has no entry below (including 'Uncategorized'/'General'). 9999 is a placeholder, not an official HSN code - classify the product properly and update this table before invoicing against it."
+    }
+  },
+  "categories": {
+    "Atta & Staples": { "hsn_code": "1101", "gst_percent": 5, "needs_review": false, "notes": "Branded packaged atta/maida/sooji/flour. Loose/unbranded staples are Nil (0%) - this table only covers the branded-packaged case this project catalogs." },
+    "Baby Care": { "hsn_code": "9619", "gst_percent": 5, "needs_review": true, "notes": "Diapers/baby napkins moved 12%->5%. Baby food, lotion, oil, powder fall under different headings (1901/3304/3401) and may differ - verify per SKU." },
+    "Bakery & Breads": { "hsn_code": "1905", "gst_percent": 0, "needs_review": true, "notes": "Plain bread, roti, chapati, paratha, khakhra are Nil-rated from Sept 2025. Sweetened/filled bakery items may not qualify - verify per SKU." },
+    "Bath Soap": { "hsn_code": "3401", "gst_percent": 5, "needs_review": false, "notes": "Bar/liquid soap, was 18% pre-Sept-2025." },
+    "Beauty Care": { "hsn_code": "3304", "gst_percent": 18, "needs_review": true, "notes": "Makeup/cosmetics (foundation, lipstick, mascara) remain 18% (\"non-basic cosmetics\" were excluded from the 5% cut). Basic face powder/talc may qualify for 5% - verify per SKU." },
+    "Beverages": { "hsn_code": "2009", "gst_percent": 5, "needs_review": true, "notes": "Generic catch-all for juice/lassi/buttermilk/squash/milkshake. Non-carbonated fruit juice is 5%. CARBONATED/aerated drinks are a separate 40% slab - verify the specific product isn't fizzy before using this rate." },
+    "Biscuits & Cookies": { "hsn_code": "1905", "gst_percent": 5, "needs_review": false, "notes": "Was 18% pre-Sept-2025." },
+    "Breakfast Cereal": { "hsn_code": "1904", "gst_percent": 5, "needs_review": false, "notes": "Cornflakes/muesli/oats, was 18%." },
+    "Cakes & Muffins": { "hsn_code": "1905", "gst_percent": 5, "needs_review": true, "notes": "Assumed aligned with the broader HSN 1905 bakery cut; unlike plain bread this is NOT explicitly Nil-rated - verify." },
+    "Candy & Confectionery": { "hsn_code": "1704", "gst_percent": 5, "needs_review": false, "notes": "Sugar confectionery/toffee/candy, was 18%." },
+    "Cheese": { "hsn_code": "0406", "gst_percent": 5, "needs_review": false, "notes": "Packaged cheese, was 12%." },
+    "Chocolates": { "hsn_code": "1806", "gst_percent": 5, "needs_review": false, "notes": "Was 18% pre-Sept-2025." },
+    "Cooking Oils": { "hsn_code": "1507", "gst_percent": 5, "needs_review": true, "notes": "Edible oils span HSN 1507-1516 depending on the specific oil (sunflower/groundnut/mustard/olive etc.) - 1507 used as a representative code; rate itself (5%) is unchanged by the reform and applies broadly." },
+    "Crackers": { "hsn_code": "1905", "gst_percent": 5, "needs_review": false, "notes": "Savoury crackers/saltines, grouped with biscuits under 1905." },
+    "Dairy": { "hsn_code": "0401", "gst_percent": 5, "needs_review": true, "notes": "Generic catch-all (milk/paneer/butter/curd/ghee/yogurt). Ghee, butter and curd are 5%, but loose milk and packaged/UHT milk and paneer are Nil-rated - this single category can't capture that split, verify per SKU." },
+    "Dairy - Desserts": { "hsn_code": "2105", "gst_percent": 5, "needs_review": true, "notes": "Treated like Ice Cream/kulfi/frozen dessert (HSN 2105), was 18%." },
+    "Detergents & Fabric Care": { "hsn_code": "3402", "gst_percent": 5, "needs_review": false, "notes": "Washing powder/liquid/bars, was 18%." },
+    "Dishwash": { "hsn_code": "3402", "gst_percent": 5, "needs_review": true, "notes": "Assumed aligned with the detergent HSN 3402 rate cut; some disinfectant-classified cleaners (HSN 3808) stayed at 18% - verify for dishwash-specific sub-heading." },
+    "Dry Fruits & Nuts": { "hsn_code": "0813", "gst_percent": 5, "needs_review": false, "notes": "Dried fruit/nuts/raisins/almonds/cashews, moved 12%->5%." },
+    "Feminine Hygiene": { "hsn_code": "9619", "gst_percent": 0, "needs_review": false, "notes": "Sanitary napkins have been Nil-rated since 2018, unchanged by the 2025 reform." },
+    "Food & Beverages": { "hsn_code": "2106", "gst_percent": 5, "needs_review": true, "notes": "Broad catch-all category - classify to a more specific category where possible instead of relying on this entry." },
+    "Food - Mixes": { "hsn_code": "2106", "gst_percent": 5, "needs_review": true, "notes": "Ready-to-cook mixes (dosa/idli/etc.), assumed aligned with the namkeen/mixed-preparations cut from 12-18% to 5% - verify per SKU." },
+    "Food - Soups & Sauces": { "hsn_code": "2103", "gst_percent": 5, "needs_review": false, "notes": "Ketchup/sauces confirmed moved 12%->5%; soups (2104) assumed to follow the same cut." },
+    "Food - Spreads": { "hsn_code": "2007", "gst_percent": 5, "needs_review": false, "notes": "Jam/jelly/marmalade moved 12%->5%; honey (0409) already 5%, unchanged." },
+    "Fragrance & Deodorants": { "hsn_code": "3307", "gst_percent": 18, "needs_review": false, "notes": "Deodorants/perfume/cologne were explicitly excluded from the September 2025 cut and remain 18% - a frequent compliance mistake, do not assume this follows soap/shampoo down to 5%." },
+    "General": { "hsn_code": "9999", "gst_percent": 18, "needs_review": true, "notes": "Not a real GST category - this is this project's fallback bucket for products the pipeline couldn't classify. Reclassify into a specific category before relying on this rate." },
+    "Hair Care": { "hsn_code": "3305", "gst_percent": 5, "needs_review": false, "notes": "Shampoo/hair oil/conditioner, was 18%." },
+    "Health Care - Antiseptic": { "hsn_code": "3004", "gst_percent": 5, "needs_review": true, "notes": "Assumes medicament classification (most medicines moved to 5% in the reform). Disinfectant-only formulations (HSN 3808) may differ - verify per SKU." },
+    "Health Care - Ayurvedic": { "hsn_code": "3004", "gst_percent": 5, "needs_review": true, "notes": "AYUSH/Ayurvedic medicaments, assumed to follow the general medicine cut to 5%. A short list of lifesaving drugs is Nil-rated - verify per SKU." },
+    "Health Care - Cold & Cough": { "hsn_code": "3004", "gst_percent": 5, "needs_review": true, "notes": "Assumed to follow the general medicine cut to 5% - verify per SKU." },
+    "Health Care - Digestive": { "hsn_code": "3004", "gst_percent": 5, "needs_review": true, "notes": "Assumed to follow the general medicine cut to 5% - verify per SKU." },
+    "Health Drinks": { "hsn_code": "1901", "gst_percent": 5, "needs_review": false, "notes": "Malted/nutrition drinks (Horlicks, Bournvita, Complan) - malt extract preparations moved 18%->5%." },
+    "Health Foods": { "hsn_code": "2106", "gst_percent": 5, "needs_review": true, "notes": "Health mixes/nutrition mixes, assumed aligned with the general food-preparation cut to 5%." },
+    "Household - Air Freshener": { "hsn_code": "3307", "gst_percent": 18, "needs_review": false, "notes": "Room deodorizers/perfuming preparations, NOT part of the September 2025 cut - remains 18%." },
+    "Household Cleaning": { "hsn_code": "3402", "gst_percent": 5, "needs_review": true, "notes": "Floor/toilet cleaner, handwash, fabric softener - mostly surfactant-based (HSN 3402, cut to 5%), but some disinfectant-classified toilet cleaners (HSN 3808) stayed at 18%. Verify per SKU, especially disinfectant-labelled products." },
+    "Ice Cream": { "hsn_code": "2105", "gst_percent": 5, "needs_review": false, "notes": "Was 18% pre-Sept-2025." },
+    "Men's Grooming": { "hsn_code": "8212", "gst_percent": 18, "needs_review": true, "notes": "Mixed bucket: shaving cream/foam moved to 5%, but razors/blades/electric trimmers are hardware (HSN 8212/8510) and were not part of the FMCG cut. Defaulted to 18% since razors/trimmers are the higher-value items here - verify per SKU, shaving cream specifically may be 5%." },
+    "Noodles & Instant Food": { "hsn_code": "1902", "gst_percent": 5, "needs_review": false, "notes": "Instant noodles (Maggi, Yippee), was 18%." },
+    "Oral Care": { "hsn_code": "3306", "gst_percent": 5, "needs_review": false, "notes": "Toothpaste (3306) and toothbrush (9603) both moved 18%->5%." },
+    "Pasta & Noodles": { "hsn_code": "1902", "gst_percent": 5, "needs_review": false, "notes": "Pasta/vermicelli/semiya, was 18%." },
+    "Personal Care": { "hsn_code": "3304", "gst_percent": 5, "needs_review": true, "notes": "Generic personal-care catch-all - most personal care moved to 5% in the reform, but deodorant/perfume/premium cosmetics/razors did not (see their own categories). Verify per SKU before relying on this default." },
+    "Personal Care - Mosquito Repellent": { "hsn_code": "38089191", "gst_percent": 18, "needs_review": false, "notes": "Household insecticides (coils, mats, vaporizers, sprays) were explicitly excluded from the September 2025 cut and remain 18%, despite industry lobbying (EY-HICA report, 2026) to reduce this to 5%." },
+    "Pickles & Chutneys": { "hsn_code": "2001", "gst_percent": 5, "needs_review": true, "notes": "Assumed aligned with the jam/sauce cut from 12%->5% - verify per SKU." },
+    "Rusk": { "hsn_code": "1905", "gst_percent": 5, "needs_review": false, "notes": "Grouped with biscuits under HSN 1905." },
+    "Skin & Bath Care": { "hsn_code": "3401", "gst_percent": 5, "needs_review": false, "notes": "Soap/body wash/basic moisturiser, was 18%." },
+    "Skin Care": { "hsn_code": "3304", "gst_percent": 5, "needs_review": true, "notes": "Basic skin cream/moisturiser is 5%, but premium/cosmetic-grade skin care remains 18% - verify per SKU (see also Beauty Care)." },
+    "Snacks": { "hsn_code": "2106", "gst_percent": 5, "needs_review": false, "notes": "Namkeen/bhujia (2106) and potato chips (2005) both moved to 5%; 2106 used as the representative code." },
+    "Spices & Masalas": { "hsn_code": "0910", "gst_percent": 5, "needs_review": false, "notes": "Spices are 5%, unchanged by the reform." },
+    "Tea & Coffee": { "hsn_code": "0902", "gst_percent": 5, "needs_review": false, "notes": "Tea (0902) and coffee (0901), unchanged at 5% by the reform." },
+    "Uncategorized": { "hsn_code": "9999", "gst_percent": 18, "needs_review": true, "notes": "vector_store.py's default category value when none was assigned. Same treatment as 'General' - reclassify before relying on this rate." }
+  }
+}