Skip to content

ContextCommerce

ContextCommerce provides the commerce domain for ContextUnity — a Django/Oscar-based Product Information Management (PIM) platform with AI-powered enrichment, matching, and taxonomy.

Catalog & PIM

Django/Oscar product CRUD with admin UI, variant management, and editorial workflows.

Harvester Pipelines

Pluggable supplier data ingestion — fetchers (HTTP, file) and transformers (XLSX, CSV, XML, JSON).

AI Enrichment

Product descriptions, taxonomy classification, and semantic matching via ContextRouter agents.

MCP Server

17 FastMCP tools for AI-driven product search, matching, enrichment, and supplier operations.

Architecture

commerce

Key Modules

Catalogue (catalogue/)

Oscar-based product domain:

  • Product, Category, ProductAttribute models
  • Rich admin with inline editors
  • Full-text + pgvector search

Harvester (harvester/)

Supplier data import pipeline:

  • Fetchers — HTTP, file-based data sources
  • Transformers — XLSX, CSV, XML, JSON format parsers
  • Registry — pluggable fetcher + transformer registration
  • Skills — AI-powered harvester capabilities

MCP Server (mcp/)

17 FastMCP tools organized by domain:

CategoryTools
Productssearch_products, get_product, update_product, update_product_price, get_catalog_stats
Supplierssearch_dealer_products, get_dealer_product, list_dealers, list_unmatched_products
Matchingfind_match_candidates, link_products, unlink_product, bulk_link_products
Enrichmentget_enrichment_status, list_enrichment_queue, enrich_product_description, get_taxonomy_tree

Temporal Workflows (temporal/)

Brain synchronization:

  • SyncProductToBrainWorkflow — sync canonical products
  • SyncDealerProductToBrainWorkflow — sync supplier products
  • Activities: fetch_product, generate_embedding, upsert_to_brain