إتقان ملف CLAUDE.md — اجعل كلود يفهم مشروعك بالكامل

# CLAUDE.md

## نظرة عامة على المشروع
[وصف مختصر: ما هو المشروع، من يستخدمه، ما التقنيات الأساسية]

## الهيكل والتنظيم
[شرح المجلدات الرئيسية وما يوجد في كل واحد]

## أسلوب الكود والاتفاقيات
[naming conventions، indentation، patterns المستخدمة]

## تعليمات مهمة
[ما يجب فعله وما لا يجب، قواعد خاصة بالمشروع]

## أنماط محظورة
[أشياء بعينها لا يجوز استخدامها في هذا المشروع]

# CLAUDE.md — مشروع منصة التجارة الإلكترونية

## نظرة عامة
منصة تجارة إلكترونية للسوق السعودي. Laravel 11، MySQL، Redis، Livewire للـ frontend.
الجمهور: تجار التجزئة الصغار والمتوسطين.

## الهيكل
- app/Services/ — كل منطق الأعمال يجب أن يكون هنا
- app/Repositories/ — للتعامل مع قاعدة البيانات
- app/Http/Controllers/ — فقط للـ HTTP request/response، لا منطق أعمال
- resources/views/livewire/ — مكونات Livewire
- database/migrations/ — migrations فقط، لا seeders هنا

## الاتفاقيات
- أسماء الـ Services تنتهي بـ Service: OrderService, PaymentService
- أسماء الـ Repositories تنتهي بـ Repository
- العربية للـ validation messages دائماً
- استخدم Form Requests للـ validation — لا تضعه في Controller
- Eloquent Scopes للاستعلامات المتكررة

## Authentication
- نستخدم Laravel Sanctum للـ API
- نستخدم Breeze للـ web authentication
- لا تستخدم Passport — غير مثبت في المشروع

## تعليمات مهمة
- دائماً استخدم Transactions للعمليات المركبة
- كل Model يجب أن يحتوي $fillable محدداً
- لا تستخدم $guarded = [] أبداً
- استخدم Carbon للتعامل مع التواريخ
- الـ API responses دائماً عبر Resources
- كل الأسعار بالهللة (Integer) — لا Decimals

## أنماط محظورة
- لا var_dump أو dd() في الكود المُوجَّه للـ production
- لا raw SQL إلا في حالات الضرورة القصوى
- لا business logic في Blade views
- لا N+1 queries — استخدم eager loading دائماً

# CLAUDE.md — منصة تعليمية Next.js

## نظرة عامة
منصة تعليمية تفاعلية. Next.js 15، TypeScript، Prisma ORM، PostgreSQL، Tailwind CSS.
مستخدمو الـ backend: Prisma فقط — لا Drizzle ولا TypeORM.

## هيكل المشروع
- /app — App Router (Next.js 13+)
- /app/api — API Routes
- /components/ui — مكونات shadcn/ui، لا تُعدّلها مباشرة
- /components/features — مكونات خاصة بالمنصة
- /lib — utilities وhelpers
- /prisma — schema وmigrations

## قواعد TypeScript
- لا any مطلقاً — استخدم unknown إذا احتجت
- كل props تحتاج interface محددة
- استخدم zod للـ validation في API routes
- تسمية الـ types: PascalCase، الـ interfaces تبدأ بـ I مثل IUser

## State Management
- نستخدم Zustand للـ global state
- لا Redux في هذا المشروع
- Server State بـ TanStack Query (React Query)

## Styling
- Tailwind CSS فقط — لا inline styles ولا CSS modules إلا في حالات خاصة
- استخدم cn() من /lib/utils لدمج classes
- Dark mode مدعوم — دائماً أضف dark: classes

## تعليمات مهمة
- استخدم Server Components افتراضياً
- أضف 'use client' فقط حين تحتاج interactivity
- كل صورة عبر next/image
- كل link عبر next/link

# CLAUDE.md — API تحليل البيانات

## نظرة عامة
FastAPI backend لتحليل بيانات التسويق. Python 3.11، FastAPI، SQLAlchemy، PostgreSQL، Redis.
يُستخدم كـ microservice ضمن نظام أكبر.

## الهيكل
- /api/routers — API endpoints، مجمّعة حسب الوظيفة
- /api/services — business logic
- /api/models — SQLAlchemy models
- /api/schemas — Pydantic schemas للـ validation
- /api/utils — helper functions
- /tests — pytest tests

## قواعد مهمة
- Pydantic V2 للـ validation — استخدم الـ syntax الجديد
- Dependency Injection عبر Depends() دائماً
- كل endpoint يحتاج response_model محدد
- Async functions للـ database operations
- استخدم Alembic للـ migrations — لا تُعدّل DB مباشرة

## Error Handling
- HTTPException للأخطاء المتوقعة
- custom exception handlers في main.py
- كل الأخطاء تُسجَّل في structured JSON format

## Testing
- pytest مع pytest-asyncio
- كل endpoint يحتاج test واحد على الأقل
- استخدم fixtures من conftest.py

# CLAUDE.md — موقع WordPress للعيادة

## نظرة عامة
موقع WordPress لعيادة طبية. Child Theme من Astra.
الـ plugins المُركّبة: ACF Pro، WooCommerce للمواعيد، Yoast SEO.

## قواعد التطوير
- كل الكود المخصص في Child Theme فقط — لا تُعدّل Parent Theme
- استخدم ACF للـ custom fields — لا تُضف fields لـ database مباشرة
- hooks في functions.php، الـ classes في /inc folder
- نسمي ملفات الـ templates: template-pagename.php

## تعليمات مهمة
- الموقع عربي الاتجاه (RTL) — تأكد من دعم RTL في أي CSS تكتبه
- لا تستخدم jQuery من CDN — WordPress يُحمّله تلقائياً
- كل script وstyle يُسجَّل في functions.php عبر wp_enqueue_script

## محظور
- لا تُعدّل ملفات plugin مباشرة
- لا تستخدم update_option لحفظ بيانات كثيرة — استخدم ACF
- لا hard-coded URLs — استخدم get_site_url()

## معلومات مهمة للتذكر
- API الخارجي للدفع: Moyasar (لا Stripe — غير متاح في السعودية)
- السيرفر: Ubuntu 22.04 على AWS EC2 في منطقة me-south-1
- الـ deployment عبر GitHub Actions — لا تُنشئ scripts يدوية
- آخر upgrade لـ PHP كان في مارس 2026 — تأكد من compatibility

## قواعد حسب السياق
- للـ migrations الجديدة: دائماً اسأل قبل التنفيذ
- للملفات في /app/Core/: لا تُعدّلها إلا بعد موافقة صريحة
- للـ tests: استخدم factories وليس بيانات hardcoded