# 🚀 Material Kai Vision Platform Documentation

Welcome to the Material Kai Vision Platform documentation site!

## 📖 View Documentation

**[📚 Browse Full Documentation](https://basilakis.github.io/)**

## 🔗 Quick Links

- **[📡 API Documentation](https://v1api.materialshub.gr/docs)** - Interactive Swagger API documentation (113 endpoints)
- **[📋 ReDoc API](https://v1api.materialshub.gr/redoc)** - Alternative API documentation format

## 📊 Platform Stats

- **39** Comprehensive Documentation Files
- **120+** API Endpoints across **15** categories
- **14** AI Models (Claude Sonnet 4.5, Haiku 4.5, GPT-5, Qwen3-VL-8B/32B, CLIP, etc.)
- **6** Embedding Types (text, visual, color, texture, application, multimodal)
- **14-Stage** PDF Processing Pipeline with checkpoint recovery and real-time monitoring
- **Complete Quote System** with status tags, upsells/extras, and project timeline tracking
- **Real-time Monitoring** with Supabase subscriptions and comprehensive analytics
- **5,000+** Active Users
- **99.5%+** Uptime

## 📋 Available Documentation

- [INDEX](https://basilakis.github.io/INDEX.html)
- [README](https://basilakis.github.io/README.html)
- [Agent System](https://basilakis.github.io/agent-system.html)
- [Ai Models Architecture](https://basilakis.github.io/ai-models-architecture.html)
- [Ai Models Complete List](https://basilakis.github.io/ai-models-complete-list.html)
- [Ai Models Guide](https://basilakis.github.io/ai-models-guide.html)
- [Ai Reranking](https://basilakis.github.io/ai-reranking.html)
- [Ai Usage Logging Guide](https://basilakis.github.io/ai-usage-logging-guide.html)
- [Api Configuration Examples](https://basilakis.github.io/api-configuration-examples.html)
- [Api Docs](https://basilakis.github.io/api-docs.html)
- [Api Endpoints](https://basilakis.github.io/api-endpoints.html)
- [Api Master Reference](https://basilakis.github.io/api-master-reference.html)
- [README](https://basilakis.github.io/api/README.html)
- [Agent Chat Api](https://basilakis.github.io/api/agent-chat-api.html)
- [Ai Rerank Api](https://basilakis.github.io/api/ai-rerank-api.html)
- [Crm Companies Api](https://basilakis.github.io/api/crm-companies-api.html)
- [Crm Contacts Api](https://basilakis.github.io/api/crm-contacts-api.html)
- [Crm Stripe Api](https://basilakis.github.io/api/crm-stripe-api.html)
- [Crm Users Api](https://basilakis.github.io/api/crm-users-api.html)
- [Email Api](https://basilakis.github.io/api/email-api.html)
- [Flow Engine Api](https://basilakis.github.io/api/flow-engine-api.html)
- [Generate Interior Gemini Api](https://basilakis.github.io/api/generate-interior-gemini-api.html)
- [Generate Interior Video V2 Api](https://basilakis.github.io/api/generate-interior-video-v2-api.html)
- [Generate Region Edit Api](https://basilakis.github.io/api/generate-region-edit-api.html)
- [Generate Virtual Staging Api](https://basilakis.github.io/api/generate-virtual-staging-api.html)
- [Late Social Api](https://basilakis.github.io/api/late-social-api.html)
- [Messaging Api](https://basilakis.github.io/api/messaging-api.html)
- [Mivaa Gateway Api](https://basilakis.github.io/api/mivaa-gateway-api.html)
- [Pdf Batch Process Api](https://basilakis.github.io/api/pdf-batch-process-api.html)
- [Price Monitoring Cron Api](https://basilakis.github.io/api/price-monitoring-cron-api.html)
- [Pricing Api](https://basilakis.github.io/api/pricing-api.html)
- [Quotes Api](https://basilakis.github.io/api/quotes-api.html)
- [Recommendations Api](https://basilakis.github.io/api/recommendations-api.html)
- [Scrape Session Manager Api](https://basilakis.github.io/api/scrape-session-manager-api.html)
- [Slig Inference](https://basilakis.github.io/api/slig-inference.html)
- [Stripe Webhooks Api](https://basilakis.github.io/api/stripe-webhooks-api.html)
- [Swagger](https://basilakis.github.io/api/swagger.html)
- [Xml Import Orchestrator Api](https://basilakis.github.io/api/xml-import-orchestrator-api.html)
- [App Details](https://basilakis.github.io/app-details.html)
- [Ar Material Preview](https://basilakis.github.io/ar-material-preview.html)
- [Async Processing And Limits](https://basilakis.github.io/async-processing-and-limits.html)
- [Background Agents](https://basilakis.github.io/background-agents.html)
- [Billing Credits System](https://basilakis.github.io/billing-credits-system.html)
- [Campaign System](https://basilakis.github.io/campaign-system.html)
- [Category Field Registry](https://basilakis.github.io/category-field-registry.html)
- [Collaborative Filtering Recommendations](https://basilakis.github.io/collaborative-filtering-recommendations.html)
- [Comprehensive Metadata Fields Guide](https://basilakis.github.io/comprehensive-metadata-fields-guide.html)
- [Crm System](https://basilakis.github.io/crm-system.html)
- [Data Import System](https://basilakis.github.io/data-import-system.html)
- [Data Retention Policy](https://basilakis.github.io/data-retention-policy.html)
- [Deployment Guide](https://basilakis.github.io/deployment-guide.html)
- [Design System](https://basilakis.github.io/design-system.html)
- [Duplicate Detection Merging](https://basilakis.github.io/duplicate-detection-merging.html)
- [Email System](https://basilakis.github.io/email-system.html)
- [Embedding Generation Improvements](https://basilakis.github.io/embedding-generation-improvements.html)
- [Extract Categories Guide](https://basilakis.github.io/extract-categories-guide.html)
- [Features Guide](https://basilakis.github.io/features-guide.html)
- [Flow Engine](https://basilakis.github.io/flow-engine.html)
- [Image Relevancy And Search](https://basilakis.github.io/image-relevancy-and-search.html)
- [Intelligent Page Type Detection](https://basilakis.github.io/intelligent-page-type-detection.html)
- [Interior Design Data Flow](https://basilakis.github.io/interior-design-data-flow.html)
- [Interior Design Models](https://basilakis.github.io/interior-design-models.html)
- [Interior Designer Agent User Guide](https://basilakis.github.io/interior-designer-agent-user-guide.html)
- [Interior Video Generation](https://basilakis.github.io/interior-video-generation.html)
- [Internal Pricing Credit System](https://basilakis.github.io/internal-pricing-credit-system.html)
- [Job Queue System](https://basilakis.github.io/job-queue-system.html)
- [Knowledge Base Implementation](https://basilakis.github.io/knowledge-base-implementation.html)
- [Langgraph Implementation](https://basilakis.github.io/langgraph-implementation.html)
- [Lighting Simulation](https://basilakis.github.io/lighting-simulation.html)
- [Logger Service](https://basilakis.github.io/logger-service.html)
- [Manufacturer Analytics](https://basilakis.github.io/manufacturer-analytics.html)
- [Meta Field Aggregation](https://basilakis.github.io/meta-field-aggregation.html)
- [Metadata Management System](https://basilakis.github.io/metadata-management-system.html)
- [Metadata Prototype Validation System](https://basilakis.github.io/metadata-prototype-validation-system.html)
- [Metafield Extraction Guide](https://basilakis.github.io/metafield-extraction-guide.html)
- [Modular Pipeline Endpoints](https://basilakis.github.io/modular-pipeline-endpoints.html)
- [Monitoring Analytics System](https://basilakis.github.io/monitoring-analytics-system.html)
- [Monitoring And Alerting](https://basilakis.github.io/monitoring-and-alerting.html)
- [Multi Source Meta Extraction Plan](https://basilakis.github.io/multi-source-meta-extraction-plan.html)
- [Overview](https://basilakis.github.io/overview.html)
- [Page Aware Chunking Implementation](https://basilakis.github.io/page-aware-chunking-implementation.html)
- [Pdf Processing Pipeline](https://basilakis.github.io/pdf-processing-pipeline.html)
- [Pinterest Integration](https://basilakis.github.io/pinterest-integration.html)
- [Platform Flows](https://basilakis.github.io/platform-flows.html)
- [Price Monitoring Deployment Guide](https://basilakis.github.io/price-monitoring-deployment-guide.html)
- [Price Monitoring System](https://basilakis.github.io/price-monitoring-system.html)
- [Product Discovery Architecture](https://basilakis.github.io/product-discovery-architecture.html)
- [Professional Marketplace](https://basilakis.github.io/professional-marketplace.html)
- [Prompt Based Extraction Architecture](https://basilakis.github.io/prompt-based-extraction-architecture.html)
- [Prompt Enhancement System](https://basilakis.github.io/prompt-enhancement-system.html)
- [Push Notifications Admin](https://basilakis.github.io/push-notifications-admin.html)
- [Quotes System Architecture](https://basilakis.github.io/quotes-system-architecture.html)
- [Relevancy System](https://basilakis.github.io/relevancy-system.html)
- [Saved Searches Deduplication](https://basilakis.github.io/saved-searches-deduplication.html)
- [Scraping Job Integration](https://basilakis.github.io/scraping-job-integration.html)
- [Scraping Workflow Guide](https://basilakis.github.io/scraping-workflow-guide.html)
- [Search Strategies](https://basilakis.github.io/search-strategies.html)
- [Search Suggestions](https://basilakis.github.io/search-suggestions.html)
- [Segmentation Inpainting](https://basilakis.github.io/segmentation-inpainting.html)
- [Social Media System](https://basilakis.github.io/social-media-system.html)
- [Supabase Types Automation](https://basilakis.github.io/supabase-types-automation.html)
- [System Architecture](https://basilakis.github.io/system-architecture.html)
- [Troubleshooting Guide](https://basilakis.github.io/troubleshooting-guide.html)
- [Unified Job Tracking](https://basilakis.github.io/unified-job-tracking.html)
- [Unified Product Generation Flow](https://basilakis.github.io/unified-product-generation-flow.html)
- [User Levels Access](https://basilakis.github.io/user-levels-access.html)
- [Virtual Staging](https://basilakis.github.io/virtual-staging.html)
- [Vr World Generation](https://basilakis.github.io/vr-world-generation.html)
- [Web Scraping Integration](https://basilakis.github.io/web-scraping-integration.html)
- [Xml Import Orchestrator](https://basilakis.github.io/xml-import-orchestrator.html)

---

## 🏗️ Architecture

- **Frontend**: React + TypeScript + Vite (Vercel)
- **Backend**: FastAPI + Python 3.11 (Docker)
- **Database**: Supabase PostgreSQL with pgvector
- **AI Services**: OpenAI, Anthropic, HuggingFace, Voyage AI, Replicate
- **Vector Search**: Voyage AI embeddings (1024D), SigLIP2 (768D)

## 🚀 Key Features

### 📄 PDF Processing & AI Pipeline
- **14-Stage AI Pipeline**: Complete PDF processing with checkpoint recovery and async job queuing
- **Real-time Monitoring**: Live progress tracking with Supabase subscriptions and comprehensive metrics
- **Product Discovery**: AI-powered dynamic product identification with metadata extraction
- **Document Entities**: Certificates, logos, specifications as separate knowledge base
- **Stage-by-Stage Tracking**: Detailed monitoring for all 14 stages (INITIALIZED → COMPLETED)
- **Error Recovery**: Automatic retry logic with Sentry integration for all failures

### 🔍 Search & Discovery
- **Multi-Vector Search**: 6 specialized embeddings (text, visual, color, texture, application, multimodal)
- **Duplicate Detection**: Smart material deduplication with factory/manufacturer matching
- **Search Suggestions**: AI-powered auto-complete, trending searches, and typo correction
- **Material Recognition**: Qwen3-VL-8B (69.4% MMMU, #1 OCR performance)
- **Relevancy System**: Multi-source linking between chunks, images, and products

### 💼 Quote & CRM System
- **Quote Management**: Complete quote system with status tags, upsells/extras, and project timeline tracking
- **Project Timeline**: 9-step visual timeline with admin updates and customer progress tracking
- **Custom Requests**: Support for text-based quote requests without products
- **CRM Integration**: User management with role-based access and subscription tracking
- **Status Tags**: Customizable quote status workflow with filtering and sorting

### 📊 Monitoring & Analytics
- **Analytics Dashboard**: Comprehensive metrics for search, API usage, PDF processing, and quality
- **Async Job Queue Monitor**: Real-time job tracking with 7 compact metrics and live updates
- **AI Model Tracking**: Monitor which models are used at each pipeline stage
- **Cost Tracking**: Track API costs across all AI providers (Anthropic, OpenAI, Voyage AI, HuggingFace)
- **Performance Metrics**: Processing time, success rates, and resource utilization

### ⚙️ Admin & Configuration
- **Prompt Enhancement**: Admin-configurable extraction prompts with version control
- **AI Model Selection**: API-configurable model selection for each processing stage
- **Knowledge Base**: User-created documentation with PDF upload and markdown editor
- **Metadata Management**: Configure extraction categories and discovery prompts
- **System Settings**: Centralized configuration for all platform features

---

**Material Kai Vision Platform v2.5.0** - AI-powered material intelligence system with real-time monitoring & analytics

*This documentation is automatically generated and deployed from the main repository.*
*Last updated: $(date +"%Y-%m-%d %H:%M:%S UTC")*