feat: country tag on catalogue items for locale-based grounding

Catalogue items and tool matches carry a 2-letter country code (default
ZW). The client filters matches to the viewer country, so a supplier only
shows in its own market.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

main.py

@@ -185,6 +185,11 @@ _TOOL_STOPWORDS = {'a', 'an', 'the', 'of', 'for', 'and', 'or', 'with', 'to', 'in
 
 SUPPORTED_CITIES = ['Harare', 'Bulawayo', 'Gweru', 'Mutare', 'Other']
 
+# Country a supplier's catalogue serves. The client detects the viewer's country
+# (timezone/IP) and only surfaces catalogues for their country; everyone else
+# gets the generic tools list. Add a code here when onboarding a new market.
+DEFAULT_CATALOGUE_COUNTRY = 'ZW'
+
 def _normalize_tool_name(name):
     """Lowercase, strip punctuation/stopwords, singularize trailing 's' for catalogue matching."""
     words = re.sub(r"[^a-z0-9\s]", " ", (name or "").lower()).split()
@@ -229,6 +234,7 @@ def match_tools_to_catalogue(tools_list):
                 'currency': item.get('currency', 'USD'),
                 'supplier': item.get('supplier', 'Electrosales'),
                 'city':     item.get('city', 'Harare'),
+                'country':  item.get('country', DEFAULT_CATALOGUE_COUNTRY),
                 'imageUrl': item.get('imageUrl', ''),
             })
     return matches
@@ -1079,6 +1085,9 @@ def _build_catalogue_item(data, admin_uid):
         if isinstance(extra, str):
             tokens |= set(_normalize_tool_name(extra).split())
 
+    raw_country = (data.get('country') or DEFAULT_CATALOGUE_COUNTRY).strip().upper()
+    country = raw_country if len(raw_country) == 2 else DEFAULT_CATALOGUE_COUNTRY
+
     return {
         'name':           name,
         'normalizedName': normalized,
@@ -1087,6 +1096,7 @@ def _build_catalogue_item(data, admin_uid):
         'currency':       (data.get('currency') or 'USD').upper(),
         'supplier':       (data.get('supplier') or 'Electrosales').strip(),
         'city':           data.get('city') if data.get('city') in SUPPORTED_CITIES else 'Harare',
+        'country':        country,
         'category':       (data.get('category') or 'General').strip(),
         'imageUrl':       data.get('imageUrl') or '',
         'inStock':        bool(data.get('inStock', True)),
@@ -1239,6 +1249,11 @@ def admin_update_catalogue_item(item_id):
         if data['city'] not in SUPPORTED_CITIES:
             return jsonify({'error': f'city must be one of: {", ".join(SUPPORTED_CITIES)}'}), 400
         updates['city'] = data['city']
+    if 'country' in data:
+        country = (data.get('country') or '').strip().upper()
+        if len(country) != 2:
+            return jsonify({'error': 'country must be a 2-letter ISO code'}), 400
+        updates['country'] = country
     if 'inStock' in data:
         updates['inStock'] = bool(data['inStock'])
     if not updates: