# Fursan AI (فرسان Ai) - Full Documentation

> Fursan AI is an Arabic artificial intelligence platform specialized in designing courses, training advertisements, and professional training packages. It enables trainers, content creators, and businesses to generate marketing materials, course outlines, visual assets, and training guides using state-of-the-art AI models.

This file provides comprehensive technical details, routes, features, and schemas for Fursan AI.

---

## 🛠️ Main Features & Modules

### 1. Course Designer (مصمم الدورات)
An AI tool that builds comprehensive educational courses.
- Generates curriculum structures.
- Generates detailed session goals.
- Provides materials checklist and teacher guides.
- Outputs content in multiple formats.

### 2. Ad Designer (مصمم الإعلانات)
Creates high-performance advertisement layouts and content.
- Visual and textual prompts tailored for Arabian Gulf and Middle Eastern aesthetics.
- Custom templates for Instagram, Twitter, LinkedIn, and WhatsApp ads.

### 3. Media Generators
- **Image Generator**: Uses advanced text-to-image models to produce Arabic-themed training illustrations, workspace designs, and banner templates.
- **Video & Avatar Generator**: Creates synthetic videos with talking avatars for instructional design.
- **Audio & Voice Cloning**: Synthesizes natural Arabic narration using selected or cloned voices.

### 4. SEO & Strategic Experts
- **Geo-SEO Expert**: Specialized local search engine optimizer focusing on Middle East cities and local listing optimization.
- **Competitor Analyzer**: Evaluates rival training portals and extracts marketing insights.
- **Feasibility Study**: Estimates training program costs, expected revenue, and market size.

---

## 🗂️ Project Structure & Development

The platform is built as a single-page application (SPA) using React, TypeScript, and Vite.

### Key Directories
- `src/components/`: Reusable UI components (buttons, modal, sidebar, forms).
- `src/pages/`: Page containers (Landing, Dashboard, Auth, Admin modules).
- `src/services/`: Integration files for Firebase Firestore, Supabase, Google Gemini API, OpenAI API, and Stripe.
- `src/store/`: State management (Zustand) for user sessions, dark mode, language, and workspace variables.
- `public/`: Publicly accessible static assets, including sitemaps, icons, and configuration files.

---

## 📂 Public Navigation Paths
- `/` - Main landing page detailing services, plans, and value propositions.
- `/portfolio` - User-facing public gallery of AI-generated designs.
- `/free-tools` - Free lightweight utilities for quick marketing copy or outlines.
- `/contact` - Support form.
- `/privacy` - Privacy policies.
- `/terms` - Terms of service.

## 🔒 Protected User Paths (Dashboard)
All routes under `/dashboard` require user authentication:
- `/dashboard` - Home panel showing usage stats, current projects, and recommendations.
- `/dashboard/ai-tools` - Complete toolkit menu.
- `/dashboard/projects` - Project organization and management dashboard.
- `/dashboard/upgrade` - Subscription plan pricing (Free, Pro, Premium, Enterprise).
- `/dashboard/settings` - Account details, API keys, and workspace parameters.

---

## 🤖 API & Integration Overview
The platform integrates directly with:
- **Firebase/Supabase** for user metadata, files storage, and subscription logging.
- **Google Gemini & OpenAI** for large language model inference (text generation, outlines, analysis).
- **Stripe** for automated credit card transactions, plan upgrades, and billing.