Catalog feature updates on column fields

.env.example

@@ -340,10 +340,24 @@ ENABLE_PER_VARIANT_IMAGES=true
 PER_VARIANT_IMAGE_MAX_RESULTS=10
 
 # Barcode Retrieval & Product Enrichment (see
-# app/services/enrichment/barcode/ and docs/BARCODE_ENRICHMENT.md). Set to
-# false to disable barcode lookup entirely (rows are stored with
-# barcode=NULL, barcode_lookup_status="disabled").
-ENABLE_BARCODE_LOOKUP=true
+# app/services/enrichment/barcode/ and docs/BARCODE_ENRICHMENT.md).
+#
+# INLINE, per product, during ingestion. Defaults FALSE in settings.py and this
+# file used to ship `true`, which disagreed with the code for as long as both
+# existed - anyone copying .env.example got a very different pipeline from
+# anyone relying on the defaults. It is false here now to match.
+#
+# Leave it false unless you know the upload is small: it costs one search
+# request per product against an endpoint capped at 10 requests/minute, so a
+# 200-row sheet is twenty minutes of held request. ENRICH_BARCODES_ON_UPLOAD
+# below is the cheap path and is on by default.
+ENABLE_BARCODE_LOOKUP=false
+
+# BULK, per brand, after the upload settles. Fetches each brand's whole Open
+# Food Facts catalogue (~5 requests) and matches offline, on the enrichment
+# job's own thread. Runs before the nutrition phase, because a barcode turns a
+# 0.32-confidence name lookup into a 0.95-confidence exact one.
+ENRICH_BARCODES_ON_UPLOAD=true
 BARCODE_LOOKUP_TIMEOUT_SECONDS=10
 # 30 days, in seconds
 BARCODE_LOOKUP_CACHE_TTL_SECONDS=2592000