# llms.txt - AI Assistant Context File
# Updated: 2026-05-25
# Purpose: Provide structured information about this website for AI assistants and LLMs

# Project Overview
> 4-u.live - منصة متكاملة للمقالات والمدونات والمنتجات
> نظام Laravel متقدم مع محرر Gutenberg-style وإدارة محتوى احترافية
> Focus: SEO-optimized content management, Arabic RTL support, Advanced Schema markup

# Key Features
- محرر مقالات متقدم مع دعم Gutenberg blocks
- نظام SEO متكامل مع Schema.org markup
- دعم كامل للغة العربية RTL
- نظام كاش متقدم لتحسين الأداء
- إدارة متعددة للمحتوى (Posts, Blogs, Products)
- نظام مراجعات وتقييمات
- RSS feeds و Sitemaps تلقائية
- Image optimization and lazy loading
- Mobile-first responsive design

# Technical Stack
## Backend
- Framework: Laravel 11.x
- PHP: 8.2+
- Database: MySQL/MariaDB
- Cache: Redis/Database driver
- Queue: Database/Redis

## Frontend
- Build Tool: Vite
- CSS: Tailwind CSS
- JavaScript: Vanilla JS with Alpine.js patterns
- Editor: Custom Gutenberg-style block editor

## SEO Features
- Structured Data (JSON-LD): Article, BlogPosting, FAQ, HowTo, Review, BreadcrumbList
- Open Graph & Twitter Cards
- Canonical URLs
- NoIndex control per article
- Meta descriptions & keywords
- XML Sitemaps (posts, blogs, categories, products)
- RSS Feeds
- Image optimization with alt tags

# API Endpoints
## Public Routes
- GET / - Homepage
- GET /category/{slug} - Category listing
- GET /category/{category}/{slug} - Single post
- GET /blog - Blog index
- GET /blog/{slug} - Single blog post
- GET /products - Products listing
- GET /product/{slug} - Single product
- GET /sitemap.xml - XML sitemap index
- GET /rss - RSS feed

## Dashboard Routes (Admin)
- POST /dashboard/post - Create new post
- PUT /dashboard/post/{id} - Update post
- DELETE /dashboard/post/{id} - Soft delete post
- GET /dashboard/post/trashed - View trashed posts
- POST /dashboard/blog/post - Create blog post
- PUT /dashboard/blog/post/{id} - Update blog post

# Database Schema
## Key Tables
- posts: id, title, description, keywords, my_content, slug, schema, category_id, writer_id, photo, status, noindex, canonical, created_at, updated_at, deleted_at
- blogs: id, title, description, keywords, my_content, slug, writer_id, category_id, photo, status, noindex, canonical, created_at, updated_at, deleted_at
- categories: id, title, slug, description, photo, created_at, updated_at
- products: id, title, description, slug, photo, price, user_id, created_at, updated_at
- reviews: id, product_id, user_id, review, comment, created_at, updated_at

# Content Types & Schema
## Article/Post
- Schema Type: Article or BlogPosting
- Required: headline, datePublished, dateModified, author, image
- Optional: keywords, wordCount, articleBody

## FAQ
- Schema Type: FAQPage
- Structure: mainEntity array with Question/Answer pairs
- Usage: Add FAQ blocks in content editor

## HowTo
- Schema Type: HowTo
- Structure: step-by-step instructions
- Usage: Add HowTo blocks in content editor

## Review
- Schema Type: Review
- Required: itemReviewed, reviewRating, author
- Usage: Product review system

# File Structure
```
/app
  /Http/Controllers
    /Dashboard - Admin controllers
    /Front - Frontend controllers
  /Models - Eloquent models
  /View/Components - Blade components
/resources
  /views
    /frontend - Public pages
    /dashboard - Admin interface
    /components - Reusable components
  /js - JavaScript files
  /css - Stylesheets
/public_html - Web root
  /site/images - Uploaded images
  /build - Compiled assets
/routes
  web.php - Public routes
  dashboard.php - Admin routes
  api.php - API routes
```

# Caching Strategy
- Route caching: Enabled in production
- View caching: Blade templates compiled
- Query caching: Database results cached for 1 hour
- Posts cache: Individual posts cached for 24 hours
- Categories cache: Cached for 12 hours
- Full-page cache: Coming soon with Redis

# Performance Optimizations
- Lazy loading images
- Minified CSS/JS via Vite
- Database query optimization with eager loading
- CDN-ready asset URLs
- Gzip compression
- Browser caching headers

# Security Features
- CSRF protection on all forms
- XSS prevention with blade escaping
- SQL injection protection via Eloquent ORM
- Password hashing with bcrypt
- Rate limiting on API endpoints
- Secure file upload validation

# Accessibility
- Semantic HTML5
- ARIA labels where needed
- Keyboard navigation support
- RTL language support
- Alt text for all images
- Color contrast compliance

# Browser Support
- Chrome/Edge: Last 2 versions
- Firefox: Last 2 versions
- Safari: Last 2 versions
- Mobile browsers: iOS 14+, Android 10+

# Contact & Support
- Website: https://4-u.live
- Admin Panel: https://4-u.live/dashboard
- Support: Contact form on website

# Development Guidelines
## Code Style
- PSR-12 for PHP
- Prettier for JavaScript
- Tailwind CSS utilities preferred
- Arabic comments in code are acceptable

## Git Workflow
- Main branch: production
- Development branch: staging
- Feature branches: feature/name

## Deployment
- Server: Apache/Nginx with PHP-FPM
- Environment: Production uses .env file
- Assets: npm run build before deploy
- Database: Migrations run automatically

# Known Limitations
- Maximum upload size: 5MB per image
- Posts per page: 20 (paginated)
- Cache TTL: 1-24 hours depending on content type
- Supported languages: Arabic primary, English secondary

# Future Roadmap
- Advanced analytics dashboard
- Multi-language support
- Progressive Web App (PWA)
- Real-time notifications
- Advanced search with Algolia/Meilisearch
- Social media auto-posting
- Video content support
- Newsletter integration

# Notes for AI Assistants
- This is an Arabic-first platform, RTL layout is default
- Always use Laravel best practices
- Schema.org markup is critical for SEO
- Cache invalidation must be handled on content updates
- Images are stored in public_html/site/images/
- Admin authentication uses 'admin' guard
- User authentication uses 'user' guard (web)

---
Last Updated: 2026-05-25
Version: 2.0