How vinaybhadane/catalogforge works
CatalogForge is a web platform for turning supplier files, product labels, and OEM URLs into enriched, governed catalog records. Users upload or submit source data, review preflight results, follow background enrichment, inspect provenance and confidence, correct low-confidence records, and export catalog deliveries. The graph preserves the documented review, audit, analytics, and export capabilities alongside the sampled ingestion and enrichment services. Several UI and API modules are represented by their exact tree paths but were not sampled; those relationships are omitted or marked unverified.
Main entry points: ingestion.service.ts Ingestion orchestration · gemini-search.service.ts OEM search enrichment · ingestion.routes.ts Ingestion endpoints · product.routes.ts Product endpoints
Components 23
Catalog Workspace
- Upload center
src/app/(app)/upload/page.tsx - Operations dashboard
src/app/(app)/dashboard/page.tsx - Product master
src/app/(app)/products/page.tsx - Review workspace
src/app/(app)/jobs/[jobId]/page.tsx - Audit and governance
src/app/(app)/audit/page.tsx - Analytics views
src/app/(app)/analytics/page.tsx - API client
src/lib/api/client.ts
Ingestion and Review
- Ingestion endpoints
unihack-backend/apps/api/src/routes/ingestion/ingestion.routes.ts - Ingestion orchestration
unihack-backend/apps/api/src/services/ingestion.service.ts - Label OCR gate
unihack-backend/apps/api/src/services/ocr-ingestion.service.ts - Review endpoints
unihack-backend/apps/api/src/routes/reviews/review.routes.ts - Product endpoints
unihack-backend/apps/api/src/routes/products/product.routes.ts
Enrichment Pipeline
- AI governance pipeline
unihack-backend/apps/api/src/services/ai-pipeline.service.ts - OEM search enrichment
unihack-backend/apps/api/src/services/gemini-search.service.ts - File parser
unihack-backend/apps/api/src/services/file-parser.service.ts - Vocabulary and UOM
unihack-backend/apps/api/src/services/lov-normalizer.service.ts - Delivery exporter
unihack-backend/apps/api/src/services/delivery-exporter.service.ts
Catalog Data
- Raw input records
unihack-backend/apps/api/src/repositories/raw-input.repository.ts - Product catalog
unihack-backend/apps/api/src/repositories/product.repository.ts - Job state
unihack-backend/apps/api/src/repositories/job.repository.ts - Azure SQL
unihack-backend/apps/api/src/plugins/db.plugin.ts
Other components
- Catalog operator
- Search and AI providers
Connections 28
- Catalog operator → Upload center: submits sources
- Upload center → API client: uploads files
src/app/(app)/upload/page.tsx - API client → Ingestion endpoints: sends API requests
- Ingestion endpoints → Ingestion orchestration: invokes ingestion
unihack-backend/apps/api/src/routes/ingestion/ingestion.routes.ts - Ingestion endpoints → Label OCR gate: hands off OCR
unihack-backend/apps/api/src/routes/ingestion/ingestion.routes.ts - Ingestion orchestration → File parser: parses files
unihack-backend/apps/api/src/services/ingestion.service.ts - Ingestion orchestration → Raw input records: persists raw rows
unihack-backend/apps/api/src/services/ingestion.service.ts - Ingestion orchestration → AI governance pipeline: enriches rows
unihack-backend/apps/api/src/services/ingestion.service.ts - Ingestion orchestration → Job state: updates job
unihack-backend/apps/api/src/services/ingestion.service.ts - Label OCR gate → OEM search enrichment: enriches identifiers
unihack-backend/apps/api/src/services/ocr-ingestion.service.ts - AI governance pipeline → OEM search enrichment: searches OEM sources
unihack-backend/apps/api/src/services/ai-pipeline.service.ts - AI governance pipeline → Vocabulary and UOM: normalizes values
unihack-backend/apps/api/src/services/ai-pipeline.service.ts - OEM search enrichment → Search and AI providers: queries providers
unihack-backend/apps/api/src/services/gemini-search.service.ts - OEM search enrichment → Vocabulary and UOM: normalizes results
unihack-backend/apps/api/src/services/gemini-search.service.ts - Catalog operator → Operations dashboard: monitors jobs
- Catalog operator → Review workspace: reviews records
- Review workspace → Review endpoints: submits decisions
- Catalog operator → Product master: inspects catalog
- Product master → Product endpoints: requests products
- Catalog operator → Audit and governance: checks audit trail
- Catalog operator → Analytics views: views metrics
- Product endpoints → Product catalog: reads catalog
unihack-backend/apps/api/src/routes/products/product.routes.ts - Review endpoints → Product catalog: updates records
unihack-backend/apps/api/src/routes/reviews/review.routes.ts - Product catalog → Azure SQL: queries database
unihack-backend/apps/api/src/repositories/product.repository.ts - Raw input records → Azure SQL: writes raw data
unihack-backend/apps/api/src/repositories/raw-input.repository.ts - Job state → Azure SQL: stores job state
unihack-backend/apps/api/src/repositories/job.repository.ts - Catalog operator → Product master: exports catalog
- Product endpoints → Delivery exporter: generates delivery
unihack-backend/apps/api/src/routes/products/product.routes.ts