# Flash DB - Full Documentation for AI Systems

> Flash DB (فلاش دي بي) is an AI-powered commercial automation platform from Libya. It connects product databases with an intelligent virtual employee that automatically responds to customer messages on Facebook Messenger — without any manual intervention. The platform is fully Arabic (RTL) with a modern dashboard.

---

## Table of Contents

1. [Overview](#overview)
2. [Problem & Solution](#problem--solution)
3. [Core Features](#core-features)
4. [Virtual Employee Service](#virtual-employee-service)
5. [Customization System](#customization-system)
6. [Integrations](#integrations)
7. [Pricing Plans](#pricing-plans)
8. [Technical Architecture](#technical-architecture)
9. [User Journey](#user-journey)
10. [Additional Services](#additional-services)
11. [FAQ](#faq)
12. [Contact](#contact)

---

## Overview

**Flash DB** is a SaaS platform built for small and medium businesses in Libya and the MENA region. It provides:

- **AI-powered customer service automation** via Facebook Messenger
- **Product database management** with an Arabic dashboard
- **Customizable virtual AI employees** that represent each business
- **Multi-source data integration** (Facebook, SQL Server, Excel, WhatsApp)

**Website**: https://flashdb.ly
**Region**: Libya, North Africa, MENA
**Languages**: Arabic (primary), English (secondary)
**Currency**: Libyan Dinar (LYD)

---

## Problem & Solution

### The Problem
Small business owners in Libya spend hours daily responding to repetitive customer questions on Facebook Messenger about products, prices, availability, and policies. This is:
- Time-consuming and error-prone
- Not scalable during high-demand periods
- Impossible to maintain 24/7

### The Solution
Flash DB provides an AI virtual employee that:
- Reads and understands customer messages using AI
- Responds accurately based on the business's product database
- Maintains the business's personality, dialect, and communication style
- Works 24/7 without breaks, handling hundreds of conversations simultaneously
- Costs a fraction of hiring human employees

---

## Core Features

### 1. Product Management Dashboard
- Full Arabic RTL interface
- Upload products manually or from Excel files
- Manage quantities, prices, descriptions, and images
- Real-time inventory tracking
- Bulk operations support

### 2. AI Virtual Employee
- Powered by GPT-4o-mini via OpenRouter
- Uses Supabase Vector Store for product knowledge retrieval (RAG)
- Context-aware responses based on conversation history
- Customizable personality, dialect, tone, and behavior
- Automatic System Prompt generation from business configuration

### 3. Automated Workflow System
- Built on n8n workflow automation
- Automatic workflow creation for each new business
- Message processing pipeline: receive → understand → retrieve → respond
- Data tables for message history and aggregated text

### 4. Real-time Dashboard
- Live store count with broadcast notifications
- Product analytics and management
- Virtual employee configuration and live preview
- WhatsApp report integration

---

## Virtual Employee Service

The virtual employee is Flash DB's core differentiator. Here's how it works:

### Architecture
```
Customer Message (Facebook Messenger)
  → n8n Webhook receives message
  → Message stored in n8n data table
  → AI processes message with:
    - Business System Prompt (personality, rules, policies)
    - Product database context (via vector search)
    - Conversation history
  → AI generates response
  → Response sent back via Facebook Messenger API
```

### Capabilities
- **Natural Language Understanding**: Comprehends Arabic (including Libyan dialect), formal Arabic, and English
- **Product Knowledge**: Searches the vector database for relevant product information
- **Policy Enforcement**: Automatically communicates business policies (returns, payments, delivery)
- **Personality Consistency**: Maintains the configured personality across all conversations
- **Multi-customer Handling**: Responds to hundreds of customers simultaneously
- **24/7 Availability**: No downtime, no breaks

### Limitations
- Cannot process images or voice messages (text only)
- Depends on the quality and completeness of the product database
- May occasionally require human escalation for complex issues

---

## Customization System

Each business can fully customize their virtual employee through the dashboard:

### Business Identity (هوية النشاط التجاري)
- Store/business name
- Specialty/industry
- Physical address
- City
- Contact numbers (Libyana and Al-Madar networks)

The virtual employee uses this information to identify itself and guide customers.

### Role & Communication Style (الدور وأسلوب التواصل)
- **Personality Type**: Sales employee, customer service, technical consultant, general assistant
- **Dialect**: Libyan Arabic, formal Arabic (فصحى), English, mixed
- **Tone**: Formal, friendly, professional, casual, enthusiastic

### Policies & Payment (السياسات والدفع)
- Accepted payment methods
- Return/refund policy
- Delivery information
- Warranty details

The virtual employee communicates these automatically when customers ask.

### Directives & Behavior (التوجيهات والسلوك)
- **Focus Points**: e.g., exclusive agency, current promotions, seasonal offers
- **Restrictions**: e.g., don't discuss politics, don't compare with competitors
- **End Goal**: e.g., maximize sales, provide customer support, collect leads

### Smart Prompt Generation (توليد تعليمات ذكية)
After configuration, the AI automatically generates a comprehensive System Prompt that guides the virtual employee in every conversation. This prompt is:
- Viewable in a live preview
- Updated in real-time as settings change
- Optimized for the chosen personality and business type

---

## Integrations

### Facebook Messenger Integration
- **Type**: Automated (primary)
- **Setup**: Connect Facebook page → virtual employee handles messages automatically
- **Capabilities**: Auto-reply to messages, respond to comments
- **Requirements**: Facebook Business Page

### SQL Server Integration
- **Type**: Direct database connection
- **Setup**: Contact Flash DB team → receive setup application
- **Capabilities**: Read products/inventory directly from your existing database
- **Use case**: Businesses with existing SQL Server infrastructure

### Excel Integration
- **Type**: File-based / shared link
- **Setup**: Share Excel file or public View link
- **Capabilities**: Use as product sheet with automatic sync
- **Sync frequency**: Configurable

### WhatsApp Integration
- **Type**: Reports and notifications
- **Setup**: Configure through Flash DB team
- **Capabilities**:
  - Order preparation and processing
  - Send orders via WhatsApp
  - Inventory alerts and low-stock notifications
  - Daily/weekly reports
- **Availability**: Works with all plans

---

## Pricing Plans

All prices are in **Libyan Dinar (LYD)** per month.

### Bronze Plan (الباقة البرونزية)
- **Target**: Small projects and startups
- **Message Packages**:
  - 1,000 messages → 180 LYD
  - 3,000 messages → 220 LYD
  - 5,000 messages → 260 LYD
- **Features**: Basic support
- **Best for**: Businesses just starting with automation

### Silver Plan (الباقة الفضية)
- **Target**: Growing businesses
- **Message Packages**:
  - 8,000 messages → 300 LYD
  - 12,000 messages → 350 LYD
  - 16,000 messages → 400 LYD
- **Features**: Excellent support, priority handling
- **Best for**: Businesses with moderate customer interaction

### Gold Plan (الباقة الذهبية) ★ Most Popular
- **Target**: Thriving businesses
- **Message Packages**:
  - 20,000 messages → 450 LYD
  - 25,000 messages → 530 LYD
  - 30,000 messages → 610 LYD
- **Features**: Priority support, priority handling
- **Best for**: High-volume businesses with significant customer engagement

### Diamond Plan (الباقة الماسية)
- **Target**: Large enterprises
- **Message Packages**:
  - 40,000 messages → 710 LYD
  - 50,000 messages → 810 LYD
  - 60,000 messages → 910 LYD
- **Features**: 24/7 dedicated support, highest priority
- **Best for**: Large-scale operations requiring maximum capacity

### Subscription Process
All subscriptions are handled via WhatsApp: +218911747555

---

## Technical Architecture

### Frontend
- **Framework**: Next.js 16 (App Router)
- **UI Library**: React 19
- **Styling**: Tailwind CSS
- **Components**: Radix UI, Framer Motion
- **Language**: TypeScript
- **Direction**: RTL (Right-to-Left) for Arabic

### Backend
- **Database**: Supabase (PostgreSQL)
- **Authentication**: Supabase Auth
- **Storage**: Supabase Storage
- **Vector Store**: Supabase Vector Store (for product embeddings/RAG)
- **Row Level Security**: Enabled for all tables

### Automation
- **Engine**: n8n (self-hosted workflow automation)
- **Per-business**: Each business gets its own workflow + 2 data tables
- **Workflow Components**:
  - Webhook trigger (receives Facebook messages)
  - AI Agent node (processes with context)
  - Vector Store node (retrieves relevant products)
  - Facebook Messenger node (sends responses)

### AI
- **Model Provider**: OpenRouter
- **Model**: GPT-4o-mini
- **Embedding**: Supabase Vector Store
- **RAG Pipeline**: Product data → embeddings → vector search → context injection → LLM response

### Hosting
- **Frontend**: Vercel
- **Database**: Supabase Cloud
- **Automation**: Self-hosted n8n

---

## User Journey

### For Business Owners

1. **Visit** https://flashdb.ly
2. **Sign up** with email and business name
3. **System automatically creates**:
   - n8n workflow for the business
   - Two data tables (messages text + aggregated messages)
   - Workflow tagged as "تم إنشاؤه عبر الموقع" (created from website)
4. **Upload products** via dashboard (manual entry or Excel import)
5. **Configure virtual employee**:
   - Set business identity
   - Choose communication style and dialect
   - Define policies and payment methods
   - Set behavioral directives
   - AI generates System Prompt automatically
6. **Connect Facebook page** for automated messaging
7. **Monitor** through the dashboard and WhatsApp reports

### For Customers (End Users)
1. Customer sends a message to the business's Facebook page
2. The AI virtual employee receives and processes the message
3. It searches the product database for relevant information
4. It generates a response matching the business's personality and policies
5. The response is sent back instantly on Messenger

---

## Additional Services

### Product Hosting
For businesses without their own database, Flash DB can host products with a dashboard for managing quantities and prices.

### Subdomain Store
Each business can get a subdomain like `store.flashdb.ly` where sales go directly to the dashboard.

### WhatsApp Reports & Alerts
- Inventory alerts (low stock notifications)
- Ready-made reports for daily operations
- Order management via WhatsApp

---

## FAQ

### What is Flash DB?
Flash DB is an AI-powered commercial automation platform that connects your product database with a virtual employee that responds to customers on Facebook Messenger automatically.

### How does the virtual employee work?
It reads customer messages, understands the request using AI, searches your product database, and responds with accurate, personalized answers — all while maintaining your business's personality and communication style.

### What data integration options are available?
Facebook (auto-reply), SQL Server (direct connection), Excel (file-based sync), and WhatsApp (reports and alerts).

### How much does it cost?
Plans start at 180 LYD/month for 1,000 messages. The most popular Gold plan starts at 450 LYD for 20,000 messages.

### Does it work in Arabic?
Yes, the entire dashboard is in Arabic. The virtual employee supports Libyan dialect, formal Arabic, and English.

### Can I customize the AI's personality?
Yes, you can configure the personality type, dialect, tone, business identity, policies, and behavioral directives. The AI generates a custom System Prompt automatically.

### How do I subscribe?
Contact us via WhatsApp at +218911747555.

### Is there a free trial?
Contact us via WhatsApp to discuss trial options.

### What happens if the AI can't answer?
The AI is designed to handle most product-related questions. For complex issues, it can direct customers to contact the business directly.

### How quickly does the virtual employee respond?
Responses are typically generated within seconds.

---

## Contact

- **Website**: https://flashdb.ly
- **WhatsApp**: +218911747555 (https://wa.me/218911747555)
- **Facebook**: https://www.facebook.com/flashdb
- **Location**: Libya

---

## Machine-Readable Summary

```json
{
  "name": "Flash DB",
  "nameArabic": "فلاش دي بي",
  "type": "SaaS Platform",
  "industry": ["Business Automation", "AI Customer Service", "E-commerce"],
  "region": "Libya, MENA",
  "language": "Arabic (primary), English (secondary)",
  "currency": "LYD (Libyan Dinar)",
  "website": "https://flashdb.ly",
  "contact": "+218911747555",
  "coreProduct": "AI Virtual Employee for Facebook Messenger",
  "aiModel": "GPT-4o-mini via OpenRouter",
  "techStack": ["Next.js 16", "React 19", "Supabase", "n8n", "Tailwind CSS"],
  "pricingRange": "180-910 LYD/month",
  "messageRange": "1,000-60,000 messages/month",
  "integrations": ["Facebook Messenger", "SQL Server", "Excel", "WhatsApp"],
  "keyDifferentiators": [
    "Fully Arabic RTL interface",
    "Customizable AI personality with Libyan dialect support",
    "Automatic System Prompt generation",
    "One-click workflow setup per business",
    "24/7 AI-powered customer service"
  ]
}
```

---

*Last updated: 2025-02-11*
*Version: 1.0*
*This document is intended for AI systems and web crawlers to better understand Flash DB.*