The Copy هو تطبيق ويب شامل للكتابة الإبداعية والتحليل الدرامي، مصمم خصيصاً للغة العربية. يجمع التطبيق بين:

• 🎭 تحليل المحطات السبع: تحليل درامي متقدم باستخدام الذكاء الاصطناعي
• 🎬 استوديو المخرجين: أدوات احترافية لإدارة المشاريع والمشاهد
• 🤖 ذكاء اصطناعي متقدم: يعتمد على Google Gemini API
• 📊 إدارة شاملة: تتبع الشخصيات، المشاهد، واللقطات

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: shadcn/ui + Radix UI
• State Management: React Hooks
• Monitoring: Sentry

• Runtime: Node.js 20+
• Framework: Express.js
• Language: TypeScript
• Database: PostgreSQL (Neon Serverless)
• ORM: Drizzle ORM
• Cache: Redis
• Queue: BullMQ
• Real-time: WebSocket + SSE
• Monitoring: Sentry + Prometheus

• Package Manager: pnpm
• Containerization: Docker + Docker Compose
• CI/CD: GitHub Actions (optional)
• Deployment: Vercel (Frontend) + Custom (Backend)

# Node.js 20+
node --version

# pnpm
npm install -g pnpm

# PostgreSQL (أو استخدم Neon)
psql --version

# Redis (اختياري - يمكن استخدام Docker)
redis-cli --version

# 1. استنساخ المشروع
git clone https://github.com/your-username/the-copy.git
cd the-copy

# 2. تثبيت Dependencies
pnpm install

# 3. إعداد Environment Variables
# Backend
cp backend/.env.example backend/.env
# Frontend
cp frontend/.env.example frontend/.env

# 4. إعداد قاعدة البيانات
cd backend
pnpm db:push

# 5. تشغيل Redis (Docker)
docker-compose up -d redis

# 6. تشغيل التطبيق
# Terminal 1 - Backend
cd backend
pnpm dev

# Terminal 2 - Frontend
cd frontend
pnpm dev

• Frontend: http://localhost:3000
• Backend API: http://localhost:3001
• Bull Board: http://localhost:3001/admin/queues
• Drizzle Studio: cd backend && pnpm db:studio

• Backend Documentation - دليل شامل للـ Backend
• Database Security - أمان قاعدة البيانات
• Docker Guide - دليل Docker

قمنا بإعداد دليل شامل لتحسين أداء التطبيق بنسبة 40-70%:

• README - نظرة عامة شاملة
• البدء السريع - تحسينات في 3-4 ساعات ⚡
• الخطة الكاملة - خطة 10 مراحل (أسبوعين)
• الملخص التنفيذي - للمدراء وصناع القرار

• متتبع التقدم - تتبع التنفيذ
• مرجع الأوامر - أوامر سريعة
• استكشاف الأخطاء - حل المشاكل

• تقرير الأداء - تحليل شامل
• Baseline Queries - استعلامات القياس

• ✅ 8 فهارس مركبة جديدة للمشاريع/المشاهد/الشخصيات/اللقطات
• ✅ Redis caching للبيانات المتكررة
• ✅ BullMQ لمعالجة المهام الطويلة
• ✅ WebSocket + SSE للتحديثات الفورية
• ✅ Security hardening مع Zod validation
• ✅ Monitoring مع Sentry + Prometheus

# البدء السريع (3-4 ساعات)
# اقرأ: docs/performance-optimization/QUICK_START.md

# 1. تطبيق فهارس قاعدة البيانات
cd backend
pnpm db:push

# 2. فحص Redis
redis-cli PING

# 3. تحليل Bundle
cd frontend
ANALYZE=true pnpm build

# 4. اختبار الأداء
bash scripts/test-performance.sh

• ⚡ تحسين 40-70% في سرعة الاستجابة
• 📊 تقليل 60% في استعلامات قاعدة البيانات
• 💰 توفير 60% في تكاليف Gemini API
• 🚀 تحسين 50% في زمن تحميل الصفحات

• تحليل درامي متقدم للنصوص
• 7 محطات تحليلية شاملة
• رؤى وتوصيات من الذكاء الاصطناعي
• تقارير مفصلة قابلة للتصدير

• إدارة مشاريع متعددة
• تنظيم المشاهد واللقطات
• تتبع الشخصيات والاتساق
• أدوات تخطيط بصري

• استخراج تلقائي للمشاهد والشخصيات
• اقتراحات للقطات والزوايا
• تحليل الاتساق الدرامي
• توصيات إبداعية

• مصادقة آمنة (JWT)
• تشفير البيانات
• Rate limiting ذكي
• تخزين مؤقت محسّن
• معالجة غير متزامنة

# Backend Tests
cd backend
pnpm test
pnpm test:coverage

# Frontend Tests
cd frontend
pnpm test
pnpm test:e2e

# Performance Tests
bash scripts/test-performance.sh

# Linting
cd backend && pnpm lint
cd frontend && pnpm lint

• Bull Board: http://localhost:3001/admin/queues
• Metrics Dashboard: http://localhost:3000/admin/metrics
• Prometheus Metrics: http://localhost:3001/metrics
• Sentry: [Your Sentry Dashboard]

# Backend Health
curl http://localhost:3001/api/health

# Redis Health
redis-cli PING

# Database Health
psql $DATABASE_URL -c "SELECT 1;"

• ✅ CORS مُكوّن بشكل صارم
• ✅ Helmet مع CSP محسّن
• ✅ Rate Limiting متعدد المستويات
• ✅ UUID Validation شامل
• ✅ SQL Injection Prevention
• ✅ XSS Protection
• ✅ Security Event Logging
• ✅ JWT Authentication

راجع Database Security Guide للمزيد.

نرحب بمساهماتكم! يرجى:

1. Fork المشروع
2. إنشاء branch للميزة (git checkout -b feature/AmazingFeature)
3. Commit التغييرات (git commit -m 'Add some AmazingFeature')
4. Push للـ branch (git push origin feature/AmazingFeature)
5. فتح Pull Request

• اتبع معايير الكود الحالية
• أضف اختبارات للميزات الجديدة
• حدّث الوثائق عند الحاجة
• تأكد من نجاح جميع الاختبارات

هذا المشروع مرخص تحت MIT License.

صُمم وطُور بواسطة The Copy Team

• 📧 Email: [support@the-copy.app]
• 📖 Documentation: docs/
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

الملخص التنفيذي (5 دقائق)

• نظرة عامة سريعة
• المشاكل الحرجة والتكاليف
• التوصيات والخطة

التقرير الشامل (30 دقيقة)

• تحليل تفصيلي كامل
• جميع المشاكل والحلول
• خطة النشر الكاملة

قائمة المهام (دليل عملي)

• خطوات النشر بالترتيب
• Checklist قابل للتنفيذ
• الوقت المتوقع لكل مرحلة

• الأوامر المفيدة - مرجع سريع للأوامر
• التحقق قبل النشر - Checklist نهائي
• قائمة المهام الحالية - تتبع التقدم

الجاهزية: 75% ⚠️ يتطلب إجراءات حرجة

المشاكل الحرجة (يجب حلها قبل النشر):

• 🔴 الأمان: API Keys مكشوفة في .env files
• 🔴 قاعدة البيانات: SQLite (يجب التبديل لـ PostgreSQL)
• 🔴 MongoDB: Credentials تحتاج تدوير
• 🟡 Redis: غير مف��ّل (مطلوب للأداء الأمثل)
• 🟡 الاختبارات: بعض الاختبارات فاشلة

الوقت المتوقع للجاهزية الكاملة: 3-5 أيام عمل

التوصية: ابدأ بـ الملخص التنفيذي ثم اتبع قائمة المهام

• ✅ تحليل المحطات السبع
• ✅ استوديو المخرجين
• ✅ تحسينات الأداء
• ✅ نظام الطوابير
• ✅ التحديثات الفورية
• ⚠️ يتطلب إجراءات أمنية قبل النشر

• تصدير PDF/DOCX محسّن
• تعاون متعدد المستخدمين
• تطبيق الهاتف المحمول
• دعم لغات إضافية
• تحليلات متقدمة

• AI-powered scene generation
• Visual storyboarding
• Budget estimation tools
• Production scheduling
• Asset management

• Next.js - React Framework
• Drizzle ORM - TypeScript ORM
• Google Gemini - AI Analysis
• shadcn/ui - UI Components
• BullMQ - Queue System
• Sentry - Error Monitoring