marwangpt237/algerian-pos-engine

Product classification data engine for Algerian POS systems with trust-based feedback learning # 🛒 Algerian POS Engine A product classification data engine for Algerian POS (Point of Sale) systems with trust-based feedback learning. ## 🎯 Features - **Product Classification**: Automatically classify products into 28 categories (Eau, Lait, Fromage, etc.) - **Open Food Facts Integration**: Fetch and ingest product data from the Open Food Facts API - **Trust-Based Feedback**: Machine learning-like system that adjusts classifications based on customer corrections - **Deduplication**: Remove duplicate products using barcode matching and fuzzy matching - **Versioned Exports**: Export datasets as JSON, CSV, and SQLite snapshots - **Admin Dashboard**: Full-featured web interface for managing products, feedback, and customers ## 📁 Project Structure ``` ├── src/ │ ├── app/ # Next.js App Router │ │ ├── api/ # API routes │ │ ├── page.tsx # Dashboard │ │ ├── products/ # Products management │ │ ├── feedback/ # Feedback management │ │ ├── customers/ # Customer management │ │ ├── classify/ # Manual classification │ │ └── export/ # Data export │ ├── stages/ # Data engine stages │ │ ├── fetch.ts # Open Food Facts ingestion │ │ ├── normalize.ts # Text normalization │ │ ├── classify.ts # Product classification │ │ ├── deduplicate.ts # Deduplication │ │ ├── reweight.ts # Weight adjustment │ │ ├── feedback.ts # Feedback recording │ │ └── export.ts # Dataset export │ ├── engine.ts # Main orchestrator │ └── types.ts # Type definitions ├── exports/ # Exported datasets ├── products.db # SQLite database └── package.json ``` ## 🚀 Getting Started ### Prerequisites - Node.js 20+ - npm or yarn ### Installation ```bash # Clone the repository git clone cd algerian-pos-engine # Install dependencies npm ins …