fix: jobs

Reviewed-on: http://95.38.179.159:3000/Amirmahdi/back-meditation/pulls/3

app/Http/Controllers/AppFeedbackController.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\AppFeedback;
+use Illuminate\Http\Request;
+use Illuminate\Validation\ValidationException;
+
+class AppFeedbackController extends Controller
+{
+    // USER: get the current user's feedback (null if none yet).
+    public function mine()
+    {
+        $feedback = AppFeedback::where('user_id', auth()->id())->first();
+
+        return response()->json($feedback);
+    }
+
+    // USER: submit or update feedback (one editable row per user).
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'stars' => 'nullable|integer|min:1|max:5',
+            'content' => 'nullable|string|max:2000',
+        ]);
+
+        if (!$request->filled('stars') && !$request->filled('content')) {
+            throw ValidationException::withMessages([
+                'content' => ['Either a rating or a comment is required.'],
+            ]);
+        }
+
+        $feedback = AppFeedback::firstOrNew(['user_id' => auth()->id()]);
+
+        if ($request->has('stars')) {
+            $feedback->stars = $data['stars'] ?? null;
+        }
+        if ($request->has('content')) {
+            $feedback->content = $data['content'] ?? null;
+        }
+
+        $feedback->save();
+
+        return response()->json([
+            'message' => 'Feedback submitted successfully',
+            'feedback' => $feedback,
+        ]);
+    }
+
+    // ADMIN: monitor all feedback, with a summary header.
+    public function adminIndex(Request $request)
+    {
+        $query = AppFeedback::with('user');
+
+        if ($request->filled('has_comment')) {
+            $query->whereNotNull('content')->where('content', '!=', '');
+        }
+        if ($request->filled('stars')) {
+            $query->where('stars', $request->integer('stars'));
+        }
+
+        $feedback = $query->latest()->paginate($request->integer('per_page', 20));
+
+        $base = AppFeedback::query();
+
+        return response()->json([
+            'summary' => [
+                'total' => (clone $base)->count(),
+                'rated' => (clone $base)->whereNotNull('stars')->count(),
+                'with_comment' => (clone $base)->whereNotNull('content')->where('content', '!=', '')->count(),
+                'average_stars' => round((float) (clone $base)->whereNotNull('stars')->avg('stars'), 2),
+            ],
+            'feedback' => $feedback,
+        ]);
+    }
+
+    // ADMIN: remove a feedback entry (moderation).
+    public function adminDestroy($id)
+    {
+        $feedback = AppFeedback::findOrFail($id);
+        $feedback->delete();
+
+        return response()->json(['message' => 'Feedback deleted successfully']);
+    }
+}

app/Http/Controllers/BackgroundSoundController.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\BackgroundSound;
+
+class BackgroundSoundController extends CatalogController
+{
+    protected function modelClass(): string
+    {
+        return BackgroundSound::class;
+    }
+
+    protected function fileFields(): array
+    {
+        return [
+            'sound' => ['column' => 'sound_path', 'folder' => 'background-sounds/sounds', 'rules' => 'nullable|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma|max:102400'],
+            'image' => ['column' => 'image_path', 'folder' => 'background-sounds/images', 'rules' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192'],
+        ];
+    }
+}

app/Http/Controllers/BellSoundController.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\BellSound;
+
+class BellSoundController extends CatalogController
+{
+    protected function modelClass(): string
+    {
+        return BellSound::class;
+    }
+
+    protected function fileFields(): array
+    {
+        return [
+            'sound' => ['column' => 'sound_path', 'folder' => 'bells/sounds', 'rules' => 'nullable|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma|max:51200'],
+            'image' => ['column' => 'image_path', 'folder' => 'bells/images', 'rules' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192'],
+        ];
+    }
+}

app/Http/Controllers/BreathingExerciseController.php

@@ -148,8 +148,8 @@ public function completeSession(Request $request)
             'duration' => $data['duration'] ?? $template->duration,
         ]);
 
-        // Increase XP
-        auth()->user()->increment('xp', 10);
+        // Increase XP (also credits the referrer's 10% share)
+        auth()->user()->awardXp(10);
 
         return response()->json(['message' => 'Session completed', 'session' => $session]);
     }

app/Http/Controllers/CatalogController.php

@@ -0,0 +1,121 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Traits\StoresUploads;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+/**
+ * Base controller for simple admin-managed catalogs that hold a name plus
+ * one or more uploaded files (image/sound). Subclasses declare the model
+ * and the file fields.
+ */
+abstract class CatalogController extends Controller
+{
+    use StoresUploads;
+
+    /** @return class-string<\Illuminate\Database\Eloquent\Model> */
+    abstract protected function modelClass(): string;
+
+    /**
+     * Map of request file field => ['column' => db column, 'folder' => storage folder, 'rules' => validation].
+     */
+    abstract protected function fileFields(): array;
+
+    public function index(Request $request)
+    {
+        $query = ($this->modelClass())::query();
+
+        if (!$request->boolean('include_inactive')) {
+            $query->where('is_active', true);
+        }
+
+        return response()->json($query->orderBy('order')->get());
+    }
+
+    public function show($id)
+    {
+        return response()->json(($this->modelClass())::findOrFail($id));
+    }
+
+    public function store(Request $request)
+    {
+        $data = $request->validate(array_merge([
+            'name' => 'required|string|max:255',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+        ], $this->fileRules()));
+
+        $attributes = [
+            'name' => $data['name'],
+            'order' => $data['order'] ?? 0,
+            'is_active' => $data['is_active'] ?? true,
+        ];
+
+        foreach ($this->fileFields() as $field => $config) {
+            $attributes[$config['column']] = $request->hasFile($field)
+                ? $this->storeUpload($request->file($field), $config['folder'])
+                : null;
+        }
+
+        $item = ($this->modelClass())::create($attributes);
+
+        return response()->json(['message' => 'Created successfully', 'item' => $item], 201);
+    }
+
+    public function update(Request $request, $id)
+    {
+        $item = ($this->modelClass())::findOrFail($id);
+
+        $data = $request->validate(array_merge([
+            'name' => 'sometimes|string|max:255',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+        ], $this->fileRules()));
+
+        foreach (['name', 'order', 'is_active'] as $field) {
+            if ($request->has($field)) {
+                $item->$field = $data[$field];
+            }
+        }
+
+        foreach ($this->fileFields() as $field => $config) {
+            if ($request->hasFile($field)) {
+                if ($item->{$config['column']}) {
+                    Storage::disk('public')->delete($item->{$config['column']});
+                }
+                $item->{$config['column']} = $this->storeUpload($request->file($field), $config['folder']);
+            }
+        }
+
+        $item->save();
+
+        return response()->json(['message' => 'Updated successfully', 'item' => $item]);
+    }
+
+    public function destroy($id)
+    {
+        $item = ($this->modelClass())::findOrFail($id);
+
+        foreach ($this->fileFields() as $config) {
+            if ($item->{$config['column']}) {
+                Storage::disk('public')->delete($item->{$config['column']});
+            }
+        }
+
+        $item->delete();
+
+        return response()->json(['message' => 'Deleted successfully']);
+    }
+
+    private function fileRules(): array
+    {
+        $rules = [];
+        foreach ($this->fileFields() as $field => $config) {
+            $rules[$field] = $config['rules'];
+        }
+
+        return $rules;
+    }
+}

app/Http/Controllers/CategoryController.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Category;
+use App\Traits\StoresUploads;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+class CategoryController extends Controller
+{
+    use StoresUploads;
+
+    public function index(Request $request)
+    {
+        $query = Category::query()->withCount('subcategories');
+
+        if ($request->boolean('with_subcategories')) {
+            $query->with('subcategories');
+        }
+
+        return response()->json(
+            $query->orderBy('name')->get()
+        );
+    }
+
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'name' => 'required|string|max:255|unique:categories,name',
+            'description' => 'nullable|string',
+            'icon' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+        ]);
+
+        $category = Category::create([
+            'name' => $data['name'],
+            'description' => $data['description'] ?? null,
+            'icon' => $request->hasFile('icon')
+                ? $this->storeUpload($request->file('icon'), 'categories/icons')
+                : null,
+        ]);
+
+        return response()->json([
+            'message' => 'Category created successfully',
+            'category' => $category,
+        ], 201);
+    }
+
+    public function show($id)
+    {
+        $category = Category::with('subcategories')->withCount('subcategories')->findOrFail($id);
+
+        return response()->json($category);
+    }
+
+    public function update(Request $request, $id)
+    {
+        $category = Category::findOrFail($id);
+
+        $data = $request->validate([
+            'name' => 'sometimes|string|max:255|unique:categories,name,' . $category->id,
+            'description' => 'nullable|string',
+            'icon' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+        ]);
+
+        if (array_key_exists('name', $data)) {
+            $category->name = $data['name'];
+        }
+        if (array_key_exists('description', $data)) {
+            $category->description = $data['description'];
+        }
+        if ($request->hasFile('icon')) {
+            if ($category->icon) {
+                Storage::disk('public')->delete($category->icon);
+            }
+            $category->icon = $this->storeUpload($request->file('icon'), 'categories/icons');
+        }
+
+        $category->save();
+
+        return response()->json([
+            'message' => 'Category updated successfully',
+            'category' => $category,
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $category = Category::findOrFail($id);
+
+        if ($category->icon) {
+            Storage::disk('public')->delete($category->icon);
+        }
+
+        $category->delete();
+
+        return response()->json(['message' => 'Category deleted successfully']);
+    }
+}

app/Http/Controllers/ChatTopicController.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\ChatTopic;
+use Illuminate\Http\Request;
+
+class ChatTopicController extends Controller
+{
+    // Suggested chat topics (موضوعات پیشنهادی). Active only unless include_inactive=1.
+    public function index(Request $request)
+    {
+        $query = ChatTopic::query();
+
+        if (!$request->boolean('include_inactive')) {
+            $query->where('is_active', true);
+        }
+
+        return response()->json($query->orderBy('order')->get());
+    }
+
+    public function show($id)
+    {
+        return response()->json(ChatTopic::findOrFail($id));
+    }
+
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'title' => 'required|string|max:255',
+            'description' => 'nullable|string',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+        ]);
+
+        $topic = ChatTopic::create($data);
+
+        return response()->json([
+            'message' => 'Topic created successfully',
+            'topic' => $topic,
+        ], 201);
+    }
+
+    public function update(Request $request, $id)
+    {
+        $topic = ChatTopic::findOrFail($id);
+
+        $data = $request->validate([
+            'title' => 'sometimes|string|max:255',
+            'description' => 'nullable|string',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+        ]);
+
+        $topic->update($data);
+
+        return response()->json([
+            'message' => 'Topic updated successfully',
+            'topic' => $topic,
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $topic = ChatTopic::findOrFail($id);
+        $topic->delete();
+
+        return response()->json(['message' => 'Topic deleted successfully']);
+    }
+}

app/Http/Controllers/CommentController.php

@@ -127,10 +127,11 @@ private function getModelClass($type)
         $models = [
             'music' => \App\Models\Music::class,
             'media' => \App\Models\Media::class,
+            'playlist' => \App\Models\MusicPlaylist::class, 
         ];
         
         if (!isset($models[$type])) {
-            abort(404, 'Invalid model type');
+            abort(404, 'Invalid model type. Supported types: music, media, playlist');
         }
         
         return $models[$type];

app/Http/Controllers/ImageController.php

@@ -4,21 +4,24 @@
 namespace App\Http\Controllers;
 
 use App\Models\Image;
+use App\Traits\StoresUploads;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Storage;
 
 class ImageController extends Controller
 {
+    use StoresUploads;
+
    public function store(Request $request)
 {
     $data = $request->validate([
-        'image' => 'required|image|max:2048',
+        'image' => 'required|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
         'title' => 'nullable|string|max:255',
         'description' => 'nullable|string|max:500',
         'type' => 'nullable|in:public,private',
     ]);
 
-    $path = $request->file('image')->store('images', 'public');
+    $path = $this->storeUpload($request->file('image'), 'images');
 
     $image = Image::create([
         'user_id' => auth()->id(),
@@ -83,7 +86,7 @@ public function update(Request $request, $id)
             'title' => 'nullable|string|max:255',
             'description' => 'nullable|string|max:500',
             'type' => 'nullable|in:public,private',
-            'image' => 'nullable|image|max:2048',
+            'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
         ]);
 
         if ($request->hasFile('image')) {
@@ -91,7 +94,7 @@ public function update(Request $request, $id)
             Storage::disk('public')->delete($image->path);
 
             // store new one
-            $path = $request->file('image')->store('images', 'public');
+            $path = $this->storeUpload($request->file('image'), 'images');
             $image->path = $path;
         }
 

app/Http/Controllers/LikeController.php

@@ -0,0 +1,236 @@
+<?php
+
+namespace App\Http\Controllers;
+use App\Models\Like;
+use Illuminate\Http\Request;
+
+class LikeController extends Controller
+{
+     /**
+     * Like an item (music or media)
+     */
+    public function like(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->addLike();
+        
+        return response()->json([
+            'message' => 'Item liked successfully',
+            'is_liked' => true,
+            'likes_count' => $model->likes_count
+        ]);
+    }
+    
+    /**
+     * Unlike an item
+     */
+    public function unlike(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->removeLike();
+        
+        return response()->json([
+            'message' => 'Item unliked successfully',
+            'is_liked' => false,
+            'likes_count' => $model->likes_count
+        ]);
+    }
+    
+    /**
+     * Toggle like status
+     */
+    public function toggleLike(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->toggleLike();
+        
+        return response()->json([
+            'message' => $result ? 'Item liked successfully' : 'Item unliked successfully',
+            'is_liked' => $model->is_liked,
+            'likes_count' => $model->likes_count
+        ]);
+    }
+    
+    /**
+     * Get all liked items for the authenticated user
+     */
+    public function myLikedItems(Request $request)
+    {
+        $type = $request->get('type'); // Optional filter by type (music or media)
+        
+        $query = Like::with('likeable')
+            ->where('user_id', auth()->id());
+        
+        if ($type) {
+            $modelClass = $this->getModelClass($type);
+            $query->where('likeable_type', $modelClass);
+        }
+        
+        $likedItems = $query->latest()->paginate(20);
+
+          return response()->json([
+            'data' => $likedItems,
+            'total' => $likedItems->total(),
+            'types' => [
+                'music' => 'App\\Models\\Music',
+                'media' => 'App\\Models\\Media',
+                'playlist' => 'App\\Models\\MusicPlaylist',
+            ]
+        ]);
+        // Transform the response
+        // $transformedItems = $likedItems->map(function ($likeItem) {
+        //     $item = $likeItem->likeable;
+            
+        //     if (!$item) return null;
+            
+        //     $baseData = [
+        //         'like_id' => $likeItem->id,
+        //         'liked_at' => $likeItem->created_at,
+        //         'type' => class_basename($likeItem->likeable_type),
+        //         'is_liked' => true,
+        //     ];
+            
+        //     // Add type-specific data
+        //     if ($item instanceof \App\Models\Music) {
+        //         return array_merge($baseData, [
+        //             'id' => $item->id,
+        //             'title' => $item->title,
+        //             'artist' => $item->artist,
+        //             'duration' => $item->duration_formatted ?? $item->duration,
+        //             'image_url' => $item->image_url,
+        //             'likes_count' => $item->likes_count,
+        //             'type_display' => 'music'
+        //         ]);
+        //     } elseif ($item instanceof \App\Models\Media) {
+        //         return array_merge($baseData, [
+        //             'id' => $item->id,
+        //             'title' => $item->title,
+        //             'caption' => $item->caption,
+        //             'media_type' => $item->type,
+        //             'duration' => $item->duration,
+        //             'image_url' => $item->image->url ?? null,
+        //             'likes_count' => $item->likes_count,
+        //             'type_display' => 'media'
+        //         ]);
+        //     }
+            
+        //     return $baseData;
+        // })->filter();
+        
+        // return response()->json([
+        //     'data' => $transformedItems,
+        //     'total' => $likedItems->total(),
+        //     'current_page' => $likedItems->currentPage(),
+        //     'last_page' => $likedItems->lastPage(),
+        //     'per_page' => $likedItems->perPage(),
+        // ]);
+    }
+    
+    /**
+     * Check if specific item is liked by user
+     */
+    public function checkLiked(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        return response()->json([
+            'is_liked' => $model->is_liked,
+            'likes_count' => $model->likes_count
+        ]);
+    }
+    
+    /**
+     * Get top liked items
+     */
+    public function topLiked(Request $request)
+    {
+        $type = $request->get('type', 'music'); // Default to music
+        $limit = $request->get('limit', 10);
+        
+        $modelClass = $this->getModelClass($type);
+        
+        $items = $modelClass::with(['image'])
+            ->withCount('likes')
+            ->where(function($query) use ($modelClass) {
+                if (property_exists($modelClass, 'type')) {
+                    $query->where('type', 'public');
+                }
+                if (property_exists($modelClass, 'visibility')) {
+                    $query->where('visibility', 'public');
+                }
+            })
+            ->orderBy('likes_count', 'desc')
+            ->limit($limit)
+            ->get();
+        
+        return response()->json([
+            'data' => $items,
+            'type' => $type,
+            'total' => $items->count()
+        ]);
+    }
+    
+    private function getModel($type, $id)
+    {
+        $modelClass = $this->getModelClass($type);
+        return $modelClass::find($id);
+    }
+    
+    private function getModelClass($type)
+    {
+        $models = [
+            'music' => \App\Models\Music::class,
+            'media' => \App\Models\Media::class,
+            'playlist' => \App\Models\MusicPlaylist::class,
+        ];
+
+        return $models[$type] ?? null;
+    }
+}

app/Http/Controllers/MediaController.php

@@ -3,14 +3,20 @@
 namespace App\Http\Controllers;
 
 use App\Models\Media;
+use App\Models\MediaPlay;
 use App\Models\Category;
+use App\Models\SubCategory;
 use App\Models\Tag;
+use App\Traits\HandlesImageUpload;
+use App\Traits\StoresUploads;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Storage;
 
 class MediaController extends Controller
 {
+    use HandlesImageUpload, StoresUploads;
+
     // CREATE media
     public function store(Request $request)
     {
@@ -18,12 +24,17 @@ public function store(Request $request)
             'title' => 'required|string|max:255',
             'caption' => 'nullable|string',
             'type' => 'required|in:audio,video',
-            'category_id' => 'nullable|exists:categories,id',
-            'category_name' => 'nullable|string|max:255',
+            'category_ids' => 'nullable|array',
+            'category_ids.*' => 'integer|exists:categories,id',
+            'subcategory_ids' => 'nullable|array',
+            'subcategory_ids.*' => 'integer|exists:sub_categories,id',
             'image_id' => 'nullable|exists:images,id',
+            'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+            'detail_image_id' => 'nullable|exists:images,id',
+            'detail_image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
             'duration' => 'nullable|integer',
             'is_premium' => 'nullable|boolean',
-            'file' => 'nullable|mimes:mp3,wav,mp4,mov|max:512000',
+            'file' => 'nullable|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma,mp4,mov,m4v,webm,mkv,avi,3gp|max:512000',
             'external_url' => 'nullable|string',
             'visibility' => 'nullable|in:public,private',
 
@@ -31,32 +42,36 @@ public function store(Request $request)
              'tags.*' => 'string',
         ]);
 
-         $categoryId = $data['category_id'] ?? null;
-
-        if (!$categoryId && isset($data['category_name'])) {
-            $category = Category::firstOrCreate([
-                'name' => $data['category_name']
-            ]);
-            $categoryId = $category->id;
-        }
         $path = null;
         if ($request->hasFile('file')) {
-            $path = $request->file('file')->store('media', 'public');
+            $path = $this->storeUpload($request->file('file'), 'media');
         }
 
+        // An uploaded image file takes precedence over a provided image_id.
+        $imageId = $this->uploadedImageId($request) ?? ($data['image_id'] ?? null);
+        $detailImageId = $this->uploadedImageId($request, 'detail_image') ?? ($data['detail_image_id'] ?? null);
+
+        // When a file is uploaded, expose its public URL as external_url too
+        // (older front-end versions read external_url for the playable source).
+        $externalUrl = $path ? asset('storage/' . $path) : ($data['external_url'] ?? null);
+
         $media = Media::create([
             'user_id' => auth()->id(),
             'title' => $data['title'],
             'caption' => $data['caption'] ?? null,
             'type' => $data['type'],
             'file_path' => $path,
-            'external_url' => $data['external_url'] ?? null,
-            'image_id' => $data['image_id'] ?? null,
-            'category_id' => $categoryId,
+            'external_url' => $externalUrl,
+            'image_id' => $imageId,
+            'detail_image_id' => $detailImageId,
             'duration' => $data['duration'] ?? null,
             'visibility' => $data['visibility'] ?? 'public',
             'is_premium'=> $data['is_premium'] ?? false
         ]);
+
+        $media->categories()->sync($data['category_ids'] ?? []);
+        $media->subCategories()->sync($data['subcategory_ids'] ?? []);
+
         if (!empty($data['tags'])) {
             $tagIds = [];
 
@@ -69,12 +84,12 @@ public function store(Request $request)
         }
         return response()->json([
             'message' => 'Media created successfully',
-            'media' => $media->load(['image', 'category' , 'tags']),
+            'media' => $media->load(['image', 'detailImage', 'categories', 'subCategories', 'tags']),
         ]);
     }
 public function index(Request $request)
 {
-    $query = Media::with(['image', 'category', 'myNote', 'tags','comments'])
+    $query = Media::with(['image', 'detailImage', 'categories', 'subCategories', 'myNote', 'tags','comments'])
         ->where(function ($q) {
             $q->where('visibility', 'public')
               ->orWhere('user_id', auth()->id());
@@ -88,7 +103,16 @@ public function index(Request $request)
 
     if ($request->filled('categories')) {
         $categories = explode(',', $request->categories);
-        $query->whereIn('category_id', $categories);
+        $query->whereHas('categories', function ($q) use ($categories) {
+            $q->whereIn('categories.id', $categories);
+        });
+    }
+
+    if ($request->filled('subcategories')) {
+        $subcategories = explode(',', $request->subcategories);
+        $query->whereHas('subCategories', function ($q) use ($subcategories) {
+            $q->whereIn('sub_categories.id', $subcategories);
+        });
     }
 
     /*
@@ -164,9 +188,12 @@ public function index(Request $request)
 
             $q->where('title', 'LIKE', "%$search%")
               ->orWhere('caption', 'LIKE', "%$search%")
-              ->orWhereHas('category', function ($c) use ($search) {
+              ->orWhereHas('categories', function ($c) use ($search) {
                   $c->where('name', 'LIKE', "%$search%");
               })
+              ->orWhereHas('subCategories', function ($s) use ($search) {
+                  $s->where('name', 'LIKE', "%$search%");
+              })
               ->orWhereHas('tags', function ($t) use ($search) {
                   $t->where('name', 'LIKE', "%$search%");
               });
@@ -266,21 +293,28 @@ public function filters(Request $request)
     |--------------------------------------------------------------------------
     */
 
-    $categories = Category::select(
-            'categories.id',
-            'categories.name',
-            DB::raw('COUNT(media.id) as media_count')
-        )
-        ->leftJoin('media', function ($join) {
-            $join->on('categories.id', '=', 'media.category_id')
-                ->where(function ($q) {
-                    $q->where('media.visibility', 'public')
-                      ->orWhere('media.user_id', auth()->id());
-                });
-        })
-        ->groupBy('categories.id', 'categories.name')
+    $visibleMedia = function ($q) {
+        $q->where(function ($inner) {
+            $inner->where('media.visibility', 'public')
+                  ->orWhere('media.user_id', auth()->id());
+        });
+    };
+
+    $categories = Category::query()
+        ->withCount(['media as media_count' => $visibleMedia])
         ->orderByDesc('media_count')
-        ->get();
+        ->get(['id', 'name', 'description', 'icon']);
+
+    /*
+    |--------------------------------------------------------------------------
+    | 1️⃣.5 Subcategories with media count
+    |--------------------------------------------------------------------------
+    */
+
+    $subcategories = SubCategory::query()
+        ->withCount(['media as media_count' => $visibleMedia])
+        ->orderByDesc('media_count')
+        ->get(['id', 'category_id', 'name', 'description']);
 
 
     /*
@@ -314,8 +348,9 @@ public function filters(Request $request)
         ->get();
 
     return response()->json([
-        'categories' => $categories,
-        'durations'  => $durations,
+        'categories'    => $categories,
+        'subcategories' => $subcategories,
+        'durations'     => $durations,
     ]);
 }
 
@@ -323,7 +358,9 @@ public function show($id)
 {
     $media = Media::with([
             'image',
-            'category', 
+            'detailImage',
+            'categories',
+            'subCategories',
             'myNote',
             'tags',
             'comments' => function($query) {
@@ -360,7 +397,9 @@ public function show($id)
         'updated_at' => $media->updated_at,
         'is_premium' => $media->is_premium,
         'image' => $media->image,
-        'category' => $media->category,
+        'detail_image' => $media->detailImage,
+        'categories' => $media->categories,
+        'sub_categories' => $media->subCategories,
         'tags' => $media->tags,
         'myNote' => $media->myNote,
         'is_saved' => $media->is_saved,
@@ -442,33 +481,31 @@ public function update(Request $request, $id)
         'caption' => 'nullable|string',
         'type' => 'nullable|in:audio,video',
 
-        // support both: category_id or category_name
-        'category_id' => 'nullable|exists:categories,id',
-        'category_name' => 'nullable|string|max:255',
+        'category_ids' => 'nullable|array',
+        'category_ids.*' => 'integer|exists:categories,id',
+        'subcategory_ids' => 'nullable|array',
+        'subcategory_ids.*' => 'integer|exists:sub_categories,id',
         'is_premium' => 'nullable|boolean',
         'image_id' => 'nullable|exists:images,id',
+        'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+        'detail_image_id' => 'nullable|exists:images,id',
+        'detail_image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
         'duration' => 'nullable|integer',
-        'file' => 'nullable|mimes:mp3,wav,mp4,mov|max:512000',
+        'file' => 'nullable|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma,mp4,mov,m4v,webm,mkv,avi,3gp|max:512000',
         'external_url' => 'nullable|string',
         'visibility' => 'nullable|in:public,private',
         'tags' => 'nullable|array',
         'tags.*' => 'string',
     ]);
 
-    // --- handle auto-create category ---
-    $categoryId = $data['category_id'] ?? $media->category_id;
-
-    if (isset($data['category_name'])) {
-        $category = Category::firstOrCreate([
-            'name' => $data['category_name']
-        ]);
-        $categoryId = $category->id;
-    }
-
     // --- handle file replace ---
     if ($request->hasFile('file')) {
-        Storage::disk('public')->delete($media->file_path);
-        $data['file_path'] = $request->file('file')->store('media', 'public');
+        if ($media->file_path) {
+            Storage::disk('public')->delete($media->file_path);
+        }
+        $data['file_path'] = $this->storeUpload($request->file('file'), 'media');
+        // Keep external_url pointing at the newly uploaded file for the old front-end.
+        $data['external_url'] = asset('storage/' . $data['file_path']);
     }
 
     // --- Prepare update data ---
@@ -476,7 +513,6 @@ public function update(Request $request, $id)
         'title' => $data['title'] ?? $media->title,
         'caption' => $data['caption'] ?? $media->caption,
         'type' => $data['type'] ?? $media->type,
-        'category_id' => $categoryId,
         'is_premium' => $data['is_premium'] ?? $media->is_premium,
         'duration' => $data['duration'] ?? $media->duration,
         'external_url' => $data['external_url'] ?? $media->external_url,
@@ -484,18 +520,39 @@ public function update(Request $request, $id)
         'file_path' => $data['file_path'] ?? $media->file_path,
     ];
 
-    // --- Handle image_id specifically ---
-    // If image_id is provided in request, use it (even if null to remove association)
-    // If not provided, keep the existing value
-    if (array_key_exists('image_id', $data)) {
+    // --- Handle image ---
+    // An uploaded image file wins; otherwise an explicit image_id (even null to
+    // clear) is honored; otherwise the existing value is kept.
+    $uploadedImageId = $this->uploadedImageId($request);
+    if ($uploadedImageId !== null) {
+        $updateData['image_id'] = $uploadedImageId;
+    } elseif (array_key_exists('image_id', $data)) {
         $updateData['image_id'] = $data['image_id'];
     } else {
         $updateData['image_id'] = $media->image_id;
     }
 
+    // --- Handle detail image (shown on the show-by-id screen) ---
+    $uploadedDetailImageId = $this->uploadedImageId($request, 'detail_image');
+    if ($uploadedDetailImageId !== null) {
+        $updateData['detail_image_id'] = $uploadedDetailImageId;
+    } elseif (array_key_exists('detail_image_id', $data)) {
+        $updateData['detail_image_id'] = $data['detail_image_id'];
+    } else {
+        $updateData['detail_image_id'] = $media->detail_image_id;
+    }
+
     // --- update media ---
     $media->update($updateData);
 
+    if (array_key_exists('category_ids', $data)) {
+        $media->categories()->sync($data['category_ids'] ?? []);
+    }
+
+    if (array_key_exists('subcategory_ids', $data)) {
+        $media->subCategories()->sync($data['subcategory_ids'] ?? []);
+    }
+
     if (isset($data['tags'])) {
         $tagIds = [];
 
@@ -509,7 +566,7 @@ public function update(Request $request, $id)
 
     return response()->json([
         'message' => 'Media updated successfully',
-        'media' => $media->load(['image', 'category' , 'tags']),
+        'media' => $media->load(['image', 'detailImage', 'categories', 'subCategories', 'tags']),
     ]);
 }
 
@@ -520,7 +577,9 @@ public function destroy($id)
             ->where('user_id', auth()->id())
             ->firstOrFail();
 
-        Storage::disk('public')->delete($media->file_path);
+        if ($media->file_path) {
+            Storage::disk('public')->delete($media->file_path);
+        }
 
         $media->delete();
 
@@ -546,7 +605,77 @@ public function toggleSaveMedia($id)
     // GET saved
     public function saved()
     {
-        return auth()->user()->savedMedia()->with(['image','category' , 'myNote' , 'tags'])->get();
+        return auth()->user()->savedMedia()->with(['image','detailImage','categories', 'subCategories', 'myNote' , 'tags'])->get();
+    }
+
+    // RECORD a play for the current user (feeds popular + recently played).
+    public function recordPlay($id)
+    {
+        $media = Media::where('id', $id)
+            ->where(function ($q) {
+                $q->where('visibility', 'public')->orWhere('user_id', auth()->id());
+            })
+            ->firstOrFail();
+
+        $play = MediaPlay::firstOrNew([
+            'user_id' => auth()->id(),
+            'media_id' => $media->id,
+        ]);
+        $play->play_count = ($play->play_count ?? 0) + 1;
+        $play->last_played_at = now();
+        $play->save();
+
+        return response()->json([
+            'message' => 'Play recorded',
+            'play_count' => $play->play_count,
+            'last_played_at' => $play->last_played_at,
+        ]);
+    }
+
+    // POPULAR media (global), ranked by total play count across all users.
+    public function popular(Request $request)
+    {
+        $limit = (int) $request->input('limit', 20);
+
+        $media = Media::query()
+            ->where(function ($q) {
+                $q->where('visibility', 'public')->orWhere('user_id', auth()->id());
+            })
+            ->withCount('plays as listeners_count')                 // distinct users who played
+            ->withSum('plays as plays_count', 'play_count')         // total plays
+            ->with(['image', 'detailImage', 'categories', 'subCategories', 'tags'])
+            ->orderByDesc('plays_count')
+            ->orderByDesc('listeners_count')
+            ->orderByDesc('created_at')
+            ->limit($limit)
+            ->get();
+
+        return response()->json($media);
+    }
+
+    // RECENTLY PLAYED media for the current user, most recent first.
+    public function recentlyPlayed(Request $request)
+    {
+        $limit = (int) $request->input('limit', 20);
+
+        $plays = MediaPlay::where('user_id', auth()->id())
+            ->whereNotNull('last_played_at')
+            ->with(['media' => fn ($q) => $q->with(['image', 'detailImage', 'categories', 'subCategories', 'tags'])])
+            ->orderByDesc('last_played_at')
+            ->limit($limit)
+            ->get();
+
+        $media = $plays->map(function ($play) {
+            $media = $play->media;
+            if (!$media) {
+                return null;
+            }
+            $media->last_played_at = $play->last_played_at;
+            $media->play_count = $play->play_count;
+            return $media;
+        })->filter()->values();
+
+        return response()->json($media);
     }
 
 public function storeNote(Request $request, $mediaId)

app/Http/Controllers/MoodController.php

@@ -35,7 +35,7 @@ public function storeUserMood(Request $request)
             );
         }
       
-            $user->increment('xp', 10);
+            $user->awardXp(10);
       
         return response()->json([
             'message' => 'Mood saved successfully',

app/Http/Controllers/MusicCategoryController.php

@@ -82,7 +82,7 @@ public function show($id)
     {
         $category = MusicCategory::with(['image', 'playlists' => function($q) {
             $q->with(['image', 'musics' => function($q2) {
-                $q2->where('is_active', true)->with('image')->orderBy('order');
+                $q2->where('music.is_active', true)->with('image')->orderBy('music_playlist.order');
             }])->where('is_active', true)->orderBy('order');
         }])->findOrFail($id);
         

app/Http/Controllers/MusicController.php

@@ -5,16 +5,38 @@
 use Illuminate\Http\Request;
 use App\Models\MusicPlaylist;
 use App\Models\Music;
+use App\Traits\HandlesImageUpload;
+use App\Traits\StoresUploads;
 use Illuminate\Support\Facades\Storage;
 
 class MusicController extends Controller
 {
+    use HandlesImageUpload, StoresUploads;
+
+    // Add this new method to your MusicController
+    public function getAllMusic()
+    {
+        $userId = auth()->id();
+
+        $music = Music::with(['image', 'playlists'])
+            ->where('type', 'public')
+            ->orWhere(function($query) use ($userId) {
+                $query->where('type', 'private')
+                    ->where('user_id', $userId);
+            })
+            ->orderBy('created_at', 'desc')
+            ->get();
+
+        // Return as array directly (not wrapped in 'data' object)
+        // to match what your old Flutter app expects
+        return response()->json($music);
+    }
 
     public function index()
     {
         $userId = auth()->id();
 
-        $music = Music::with(['image', 'playlist'])
+        $music = Music::with(['image', 'playlists'])
             ->where('type', 'public')
             ->orWhere(function($query) use ($userId) {
                 $query->where('type', 'private')
@@ -33,10 +55,10 @@ public function getMusicByPlaylist($playlistId)
     {
         $playlist = MusicPlaylist::findOrFail($playlistId);
 
-        $music = Music::where('playlist_id', $playlistId)
-            ->where('is_active', true)
+        $music = $playlist->musics()
+            ->where('music.is_active', true)
             ->with(['image', 'tags'])
-            ->orderBy('order')
+            ->orderBy('music_playlist.order')
             ->get();
 
         return response()->json([
@@ -59,24 +81,30 @@ public function addToPlaylist(Request $request, $musicId)
             'order' => 'nullable|integer',
         ]);
 
-        $music->update([
-            'playlist_id' => $data['playlist_id'],
-            'order' => $data['order'] ?? $music->order,
+        $order = $data['order'] ?? $this->getNextOrderInPlaylist($data['playlist_id']);
+
+        // Add (or update its order) without removing the music from other playlists.
+        $music->playlists()->syncWithoutDetaching([
+            $data['playlist_id'] => ['order' => $order],
         ]);
 
         return response()->json([
             'message' => 'Music added to playlist successfully',
-            'music' => $music->load(['image', 'playlist'])
+            'music' => $music->load(['image', 'playlists'])
         ]);
     }
 
-    public function removeFromPlaylist($musicId)
+    public function removeFromPlaylist(Request $request, $musicId)
     {
         $music = Music::where('id', $musicId)
             ->where('user_id', auth()->id())
             ->firstOrFail();
 
-        $music->update(['playlist_id' => null]);
+        $data = $request->validate([
+            'playlist_id' => 'required|exists:music_playlists,id',
+        ]);
+
+        $music->playlists()->detach($data['playlist_id']);
 
         return response()->json(['message' => 'Music removed from playlist']);
     }
@@ -84,15 +112,18 @@ public function removeFromPlaylist($musicId)
     public function updateOrder(Request $request)
     {
         $data = $request->validate([
+            'playlist_id' => 'required|exists:music_playlists,id',
             'musics' => 'required|array',
             'musics.*.id' => 'required|exists:music,id',
             'musics.*.order' => 'required|integer',
         ]);
 
+        $playlist = MusicPlaylist::findOrFail($data['playlist_id']);
+
         foreach ($data['musics'] as $item) {
-            Music::where('id', $item['id'])
-                ->where('user_id', auth()->id())
-                ->update(['order' => $item['order']]);
+            $playlist->musics()->updateExistingPivot($item['id'], [
+                'order' => $item['order'],
+            ]);
         }
 
         return response()->json(['message' => 'Order updated successfully']);
@@ -104,11 +135,14 @@ public function store(Request $request)
             $data = $request->validate([
                 'title' => 'required|string|max:255',
                 'artist' => 'nullable|string|max:255',
-                'file' => 'required|mimes:mp3,wav,ogg|max:20971520',
+                'file' => 'required|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma|max:20971520',
                 'type' => 'nullable|in:public,private',
                 'image_id' => 'nullable|exists:images,id',
-                'playlist_id' => 'nullable|exists:music_playlists,id',
-                'duration' => 'nullable|string|regex:/^(?:\d+:)?[0-5]?\d:[0-5]\d$/', // validates mm:ss or hh:mm:ss
+                'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+                'playlist_id' => 'nullable|exists:music_playlists,id', // single (backward compatible)
+                'playlist_ids' => 'nullable|array',                    // multiple
+                'playlist_ids.*' => 'integer|exists:music_playlists,id',
+                'duration' => 'nullable|integer|min:1', // validates mm:ss or hh:mm:ss
             ]);
 
             // Handle file upload
@@ -127,7 +161,7 @@ public function store(Request $request)
                 ], 422);
             }
 
-            $path = $file->store('music', 'public');
+            $path = $this->storeUpload($file, 'music');
 
             if (!$path) {
                 return response()->json([
@@ -135,22 +169,36 @@ public function store(Request $request)
                 ], 500);
             }
 
+            // An uploaded image file takes precedence over a provided image_id.
+            $imageId = $this->uploadedImageId($request) ?? ($data['image_id'] ?? null);
+
             $music = Music::create([
                 'user_id' => auth()->id(),
                 'title' => $data['title'],
                 'artist' => $data['artist'] ?? null,
                 'file_path' => $path,
                 'type' => $data['type'] ?? 'private',
-                'image_id' => $data['image_id'] ?? null,
-                'playlist_id' => $data['playlist_id'] ?? null,
+                'image_id' => $imageId,
                 'duration' => $data['duration'] ?? null, // Store as string
-                'order' => $this->getNextOrderInPlaylist($data['playlist_id'] ?? null),
                 'is_active' => true,
             ]);
 
+            // Merge single + multiple playlist inputs into a unique list.
+            $playlistIds = collect($data['playlist_ids'] ?? [])
+                ->push($data['playlist_id'] ?? null)
+                ->filter()
+                ->unique()
+                ->values();
+
+            foreach ($playlistIds as $playlistId) {
+                $music->playlists()->syncWithoutDetaching([
+                    $playlistId => ['order' => $this->getNextOrderInPlaylist($playlistId)],
+                ]);
+            }
+
             return response()->json([
                 'message' => 'Music uploaded successfully',
-                'music' => $music->load(['image', 'playlist', 'tags']),
+                'music' => $music->load(['image', 'playlists', 'tags']),
                 'url' => asset('storage/' . $path),
             ], 201);
             
@@ -174,7 +222,10 @@ private function getNextOrderInPlaylist($playlistId)
             return 0;
         }
 
-        $maxOrder = Music::where('playlist_id', $playlistId)->max('order');
+        $maxOrder = \DB::table('music_playlist')
+            ->where('playlist_id', $playlistId)
+            ->max('order');
+
         return ($maxOrder ?? -1) + 1;
     }
 
@@ -188,28 +239,36 @@ public function update(Request $request, $id)
                 'title' => 'nullable|string|max:255',
                 'artist' => 'nullable|string|max:255',
                 'type' => 'nullable|in:public,private',
-                'file' => 'nullable|mimes:mp3,wav,ogg|max:10240',
+                'file' => 'nullable|file|extensions:mp3,wav,ogg,flac,aac,m4a,opus,mpga,wma|max:20971520',
                 'image_id' => 'nullable|exists:images,id',
-                'playlist_id' => 'nullable|exists:music_playlists,id',
-                'duration' => 'nullable|string|regex:/^(?:\d+:)?[0-5]?\d:[0-5]\d$/',
-                'order' => 'nullable|integer',
+                'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+                'duration' => 'nullable|integer|min:1',
                 'is_active' => 'nullable|boolean',
             ]);
 
             if ($request->hasFile('file')) {
                 // Delete old file
-                Storage::disk('public')->delete($music->file_path);
-                $path = $request->file('file')->store('music', 'public');
+                if ($music->file_path) {
+                    Storage::disk('public')->delete($music->file_path);
+                }
+                $path = $this->storeUpload($request->file('file'), 'music');
                 $music->file_path = $path;
             }
 
-            // Update only provided fields
-            $music->fill($data);
+            // Update only provided fields (drop the raw file input from mass-assign).
+            $music->fill(collect($data)->except('image')->toArray());
+
+            // An uploaded image file takes precedence over a provided image_id.
+            $uploadedImageId = $this->uploadedImageId($request);
+            if ($uploadedImageId !== null) {
+                $music->image_id = $uploadedImageId;
+            }
+
             $music->save();
 
             return response()->json([
                 'message' => 'Music updated successfully',
-                'music' => $music->load(['image', 'playlist', 'tags']),
+                'music' => $music->load(['image', 'playlists', 'tags']),
                 'url' => asset('storage/' . $music->file_path),
             ]);
             
@@ -229,7 +288,7 @@ public function show($id)
 
     $music = Music::with([
             'image',
-            'playlist', 
+            'playlists',
             'tags',
             'comments' => function($query) {
                 $query->with('user')->latest()->limit(10);
@@ -277,7 +336,9 @@ public function show($id)
     public function destroy($id)
     {
         $music = Music::where('id', $id)->where('user_id', auth()->id())->firstOrFail();
-        Storage::disk('public')->delete($music->file_path);
+        if ($music->file_path) {
+            Storage::disk('public')->delete($music->file_path);
+        }
         $music->delete();
 
         return response()->json(['message' => 'Music deleted successfully']);

app/Http/Controllers/MusicPlaylistController.php

@@ -3,69 +3,136 @@
 namespace App\Http\Controllers;
 
 use App\Models\MusicPlaylist;
+use App\Traits\HandlesImageUpload;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
 
 class MusicPlaylistController extends Controller
 {
-    public function index(Request $request)
-    {
-        $query = MusicPlaylist::with(['category', 'image']);
+    use HandlesImageUpload;
 
-        if ($request->has('category_id')) {
-            $query->where('category_id', $request->category_id);
+   public function index(Request $request, $categoryId = null)
+        {
+            $query = MusicPlaylist::with(['categories', 'subcategories', 'image', 'detailImage']);
+
+            $categoryId = $categoryId ?? $request->input('category_id');
+
+            if ($categoryId) {
+                $query->whereHas('categories', function ($q) use ($categoryId) {
+                    $q->where('music_categories.id', $categoryId);
+                });
+            }
+
+            if ($request->filled('subcategory_id')) {
+                $subcategoryId = $request->input('subcategory_id');
+                $query->whereHas('subcategories', function ($q) use ($subcategoryId) {
+                    $q->where('music_subcategories.id', $subcategoryId);
+                });
+            }
+
+            $playlists = $query->where('is_active', true)->orderBy('order')->get();
+
+            return response()->json($playlists);
         }
             
-        $playlists = $query->where('is_active', true)->orderBy('order')->get();
-        
-        return response()->json($playlists);
-    }
-    
     public function store(Request $request)
-    {
-        $data = $request->validate([
-            'category_id' => 'required|exists:music_categories,id',
-            'name' => 'required|string|max:255',
-            'description' => 'nullable|string',
-            'image_id' => 'nullable|exists:images,id',
-            'order' => 'nullable|integer',
-            'is_active' => 'nullable|boolean',
-        ]);
-        
-        $data['slug'] = Str::slug($data['name']);
-        
-        $playlist = MusicPlaylist::create($data);
+{
+    $data = $request->validate([
+        'category_ids' => 'nullable|array',
+        'category_ids.*' => 'integer|exists:music_categories,id',
+        'subcategory_ids' => 'nullable|array',
+        'subcategory_ids.*' => 'integer|exists:music_subcategories,id',
+        'name' => 'required|string|max:255',
+        'description' => 'nullable|string',
+        'image_id' => 'nullable|exists:images,id',
+        'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+        'detail_image_id' => 'nullable|exists:images,id',
+        'detail_image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+        'order' => 'nullable|integer',
+        'is_active' => 'nullable|boolean',
+    ]);
 
+    // Ensure at least one category or subcategory is provided
+    if (empty($data['category_ids']) && empty($data['subcategory_ids'])) {
         return response()->json([
-            'message' => 'Playlist created successfully',
-            'playlist' => $playlist->load(['category', 'image'])
-        ], 201);
+            'message' => 'At least one category or subcategory is required'
+        ], 422);
     }
 
+    $data['slug'] = Str::slug($data['name']);
+
+    // An uploaded image file takes precedence over a provided image_id.
+    $data['image_id'] = $this->uploadedImageId($request) ?? ($data['image_id'] ?? null);
+    $data['detail_image_id'] = $this->uploadedImageId($request, 'detail_image') ?? ($data['detail_image_id'] ?? null);
+
+    $playlist = MusicPlaylist::create($data);
+
+    $playlist->categories()->sync($data['category_ids'] ?? []);
+    $playlist->subcategories()->sync($data['subcategory_ids'] ?? []);
+
+    return response()->json([
+        'message' => 'Playlist created successfully',
+        'playlist' => $playlist->load(['categories', 'subcategories', 'image', 'detailImage'])
+    ], 201);
+}
+    
     public function show($id)
-    {
-        $playlist = MusicPlaylist::with([
-            'category', 
-            'image', 
-            'musics' => function($q) {
-                $q->where('is_active', true)
-                  ->with(['image', 'tags'])
-                  ->orderBy('order');
-            }
-        ])->findOrFail($id);
+        {
+            $playlist = MusicPlaylist::with([
+                'categories',
+                'subcategories',
+                'image',
+                'detailImage',
+                'musics' => function($q) {
+                    $q->where('music.is_active', true)
+                    ->with(['image', 'tags'])
+                    ->orderBy('music_playlist.order');
+                },
+                'comments' => function($q) { // Add comments relationship
+                    $q->with('user')->latest()->limit(10);
+                }
+            ])->findOrFail($id);
+            $userComment = $playlist->userComment();
+            $comments = $playlist->comments()
+                ->with('user')
+                ->latest()
+                ->paginate(15);
             
-        return response()->json($playlist);
-    }
+            return response()->json([
+                'playlist' => $playlist,
+                'statistics' => [
+                    'total_musics' => $playlist->musics->count(),
+                    'total_duration' => $playlist->total_duration,
+                    'total_comments' => $playlist->comments_count,
+                    'total_likes' => $playlist->likes_count,
+                    'total_saves' => $playlist->saved_count,
+                ],
+                'user_interaction' => [
+                    'has_commented' => $playlist->has_user_commented,
+                    'user_comment' => $playlist->user_comment,
+                    'user_comment_id' => $playlist->user_comment_id,
+                    'has_liked' => $playlist->is_liked,
+                    'has_saved' => $playlist->is_saved,
+                ],
+                'comments' => $comments,
+            ]);
+        }
     
     public function update(Request $request, $id)
     {
         $playlist = MusicPlaylist::findOrFail($id);
         
         $data = $request->validate([
-            'category_id' => 'sometimes|exists:music_categories,id',
+            'category_ids' => 'sometimes|array',
+            'category_ids.*' => 'integer|exists:music_categories,id',
+            'subcategory_ids' => 'sometimes|array',
+            'subcategory_ids.*' => 'integer|exists:music_subcategories,id',
             'name' => 'sometimes|string|max:255',
             'description' => 'nullable|string',
             'image_id' => 'nullable|exists:images,id',
+            'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+            'detail_image_id' => 'nullable|exists:images,id',
+            'detail_image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
             'order' => 'nullable|integer',
             'is_active' => 'nullable|boolean',
         ]);
@@ -74,11 +141,27 @@ public function update(Request $request, $id)
             $data['slug'] = Str::slug($data['name']);
         }
 
+        // An uploaded image file takes precedence over a provided image_id.
+        if (($uploadedImageId = $this->uploadedImageId($request)) !== null) {
+            $data['image_id'] = $uploadedImageId;
+        }
+        if (($uploadedDetailImageId = $this->uploadedImageId($request, 'detail_image')) !== null) {
+            $data['detail_image_id'] = $uploadedDetailImageId;
+        }
+
         $playlist->update($data);
 
+        if (array_key_exists('category_ids', $data)) {
+            $playlist->categories()->sync($data['category_ids'] ?? []);
+        }
+
+        if (array_key_exists('subcategory_ids', $data)) {
+            $playlist->subcategories()->sync($data['subcategory_ids'] ?? []);
+        }
+
         return response()->json([
             'message' => 'Playlist updated successfully',
-            'playlist' => $playlist->load(['category', 'image'])
+            'playlist' => $playlist->load(['categories', 'subcategories', 'image', 'detailImage'])
         ]);
     }
     

app/Http/Controllers/MusicSubcategoryController.php

@@ -0,0 +1,117 @@
+<?php
+
+namespace App\Http\Controllers;
+
+
+use App\Models\MusicSubcategory;
+use App\Models\MusicCategory;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+class MusicSubcategoryController extends Controller
+{
+   public function index(Request $request)
+    {
+        $query = MusicSubcategory::with(['category', 'image', 'playlists' => function($q) {
+            $q->where('is_active', true)->orderBy('order');
+        }]);
+        
+        if ($request->has('category_id')) {
+            $query->where('category_id', $request->category_id);
+        }
+        
+        $subcategories = $query->where('is_active', true)->orderBy('order')->get();
+        
+        return response()->json($subcategories);
+    }
+    
+    public function store(Request $request)
+    {
+        try {
+            $data = $request->validate([
+                'category_id' => 'required|exists:music_categories,id',
+                'name' => 'required|string|max:255',
+                'description' => 'nullable|string',
+                'image_id' => 'nullable|exists:images,id',
+                'order' => 'nullable|integer',
+                'is_active' => 'nullable|boolean',
+            ]);
+            
+            $slug = Str::slug($data['name']);
+            
+            // Check for duplicate in same category
+            $existing = MusicSubcategory::where('category_id', $data['category_id'])
+                ->where('slug', $slug)
+                ->first();
+            
+            if ($existing) {
+                return response()->json([
+                    'message' => 'A subcategory with this name already exists in this category',
+                    'errors' => ['name' => ['The subcategory name must be unique within this category.']]
+                ], 422);
+            }
+            
+            $data['slug'] = $slug;
+            $subcategory = MusicSubcategory::create($data);
+            
+            return response()->json([
+                'message' => 'Subcategory created successfully',
+                'subcategory' => $subcategory->load(['category', 'image'])
+            ], 201);
+            
+        } catch (\Exception $e) {
+            return response()->json([
+                'message' => 'An error occurred while creating the subcategory',
+                'error' => $e->getMessage()
+            ], 500);
+        }
+    }
+    
+    public function show($id)
+    {
+        $subcategory = MusicSubcategory::with([
+            'category',
+            'image',
+            'playlists' => function($q) {
+                $q->with(['image', 'musics' => function($q2) {
+                    $q2->where('music.is_active', true)->with('image')->orderBy('music_playlist.order');
+                }])->where('is_active', true)->orderBy('order');
+            }
+        ])->findOrFail($id);
+        
+        return response()->json($subcategory);
+    }
+    
+    public function update(Request $request, $id)
+    {
+        $subcategory = MusicSubcategory::findOrFail($id);
+        
+        $data = $request->validate([
+            'category_id' => 'sometimes|exists:music_categories,id',
+            'name' => 'sometimes|string|max:255',
+            'description' => 'nullable|string',
+            'image_id' => 'nullable|exists:images,id',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+        ]);
+        
+        if (isset($data['name'])) {
+            $data['slug'] = Str::slug($data['name']);
+        }
+        
+        $subcategory->update($data);
+        
+        return response()->json([
+            'message' => 'Subcategory updated successfully',
+            'subcategory' => $subcategory->load(['category', 'image'])
+        ]);
+    }
+    
+    public function destroy($id)
+    {
+        $subcategory = MusicSubcategory::findOrFail($id);
+        $subcategory->delete();
+        
+        return response()->json(['message' => 'Subcategory deleted successfully']);
+    }
+}

app/Http/Controllers/QuestionController.php

@@ -41,7 +41,48 @@ public function index(Request $request)
         });
     }
 
-        return response()->json($query->get());
+        return response()->json(
+            $query->get()->map(fn ($q) => $this->formatQuestion($q))->values()
+        );
+    }
+
+    /**
+     * Shape a question into the legacy (old Flutter) response: category_id and
+     * category are always present and non-null, tags is always an array, and
+     * timestamps are always ISO strings — so the old client never hits a null.
+     */
+    private function formatQuestion(Question $question): array
+    {
+        $question->loadMissing(['tags', 'category']);
+
+        $createdAt = optional($question->created_at)->toIso8601String();
+        $updatedAt = optional($question->updated_at)->toIso8601String();
+        $categoryId = $question->category_id ?? 0;
+
+        $category = $question->category;
+        $categoryPayload = $category
+            ? [
+                'id' => $category->id,
+                'name' => $category->name ?? '',
+                'created_at' => optional($category->created_at)->toIso8601String() ?? $createdAt,
+                'updated_at' => optional($category->updated_at)->toIso8601String() ?? $updatedAt,
+            ]
+            : [
+                'id' => $categoryId,
+                'name' => '',
+                'created_at' => $createdAt,
+                'updated_at' => $updatedAt,
+            ];
+
+        return [
+            'id' => $question->id,
+            'title' => $question->title ?? '',
+            'category_id' => $categoryId,
+            'created_at' => $createdAt,
+            'updated_at' => $updatedAt,
+            'tags' => $question->tags->values(),
+            'category' => $categoryPayload,
+        ];
     }
 
     /**
@@ -75,7 +116,7 @@ public function store(Request $request)
             $question->tags()->sync($tagIds);
         }
 
-        return response()->json($question->load(['tags', 'category']), 201);
+        return response()->json($this->formatQuestion($question), 201);
     }
 
     /**
@@ -83,7 +124,7 @@ public function store(Request $request)
      */
     public function show(Question $question)
     {
-        return response()->json($question->load(['tags', 'category']));
+        return response()->json($this->formatQuestion($question));
     }
 
     /**
@@ -120,7 +161,7 @@ public function update(Request $request, Question $question)
             $question->tags()->sync($tagIds);
         }
 
-        return response()->json($question->load(['tags', 'category']));
+        return response()->json($this->formatQuestion($question->fresh()));
     }
 
     /**

app/Http/Controllers/SaveController.php

@@ -0,0 +1,227 @@
+<?php
+// app/Http/Controllers/SaveController.php
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use App\Models\SavedItem;
+
+class SaveController extends Controller
+{
+    /**
+     * Save an item (music, media, breathing template, etc.)
+     */
+    public function save(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,breathing-template,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->addSave();
+        
+        return response()->json([
+            'message' => 'Item saved successfully',
+            'is_saved' => true,
+            'saved_count' => $model->saved_count
+        ]);
+    }
+    
+    /**
+     * Unsave an item
+     */
+    public function unsave(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,breathing-template,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->removeSave();
+        
+        return response()->json([
+            'message' => 'Item removed from saved',
+            'is_saved' => false,
+            'saved_count' => $model->saved_count
+        ]);
+    }
+    
+    /**
+     * Toggle save status
+     */
+    public function toggleSave(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,breathing-template,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        $result = $model->toggleSaveStatus();
+        
+        return response()->json([
+            'message' => $result ? 'Item saved successfully' : 'Item removed from saved',
+            'is_saved' => $model->is_saved,
+            'saved_count' => $model->saved_count
+        ]);
+    }
+    
+    /**
+     * Get all saved items for the authenticated user
+     */
+     public function mySavedItems(Request $request)
+    {
+        $type = $request->get('type'); // Optional filter by type
+        
+        $query = SavedItem::with('saveable')
+            ->where('user_id', auth()->id());
+        
+        if ($type) {
+            $modelClass = $this->getModelClass($type);
+            $query->where('saveable_type', $modelClass);
+        }
+        
+        $savedItems = $query->latest()->paginate(20);
+        
+        return response()->json([
+            'data' => $savedItems,
+            'total' => $savedItems->total(),
+            'types' => [
+                'music' => 'App\\Models\\Music',
+                'media' => 'App\\Models\\Media',
+                'breathing-template' => 'App\\Models\\BreathingTemplate',
+                'playlist' => 'App\\Models\\MusicPlaylist',
+            ]
+        ]);
+    }
+    /**
+     * Check if specific item is saved by user
+     */
+    public function checkSaved(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|string|in:music,media,breathing-template,playlist',
+            'id' => 'required|integer',
+        ]);
+        
+        $model = $this->getModel($request->type, $request->id);
+        
+        if (!$model) {
+            return response()->json([
+                'message' => 'Item not found'
+            ], 404);
+        }
+        
+        return response()->json([
+            'is_saved' => $model->is_saved,
+            'saved_count' => $model->saved_count
+        ]);
+    }
+    
+    private function getModel($type, $id)
+    {
+        $modelClass = $this->getModelClass($type);
+        return $modelClass::find($id);
+    }
+    
+    private function getModelClass($type)
+    {
+        $models = [
+            'music' => \App\Models\Music::class,
+            'media' => \App\Models\Media::class,
+            'breathing-template' => \App\Models\BreathingTemplate::class,
+            'playlist' => \App\Models\MusicPlaylist::class,
+        ];
+
+        return $models[$type] ?? null;
+    }
+}
+
+
+
+
+
+//    public function mySavedItems(Request $request)
+//     {
+//         $type = $request->get('type');
+        
+//         $query = SavedItem::with('saveable')
+//             ->where('user_id', auth()->id());
+        
+//         if ($type) {
+//             $modelClass = $this->getModelClass($type);
+//             $query->where('saveable_type', $modelClass);
+//         }
+        
+//         $savedItems = $query->latest()->paginate(20);
+        
+//         // Transform the response to include formatted data
+//         $transformedItems = $savedItems->map(function ($savedItem) {
+//             $item = $savedItem->saveable;
+            
+//             if (!$item) return null;
+            
+//             $baseData = [
+//                 'saved_id' => $savedItem->id,
+//                 'saved_at' => $savedItem->created_at,
+//                 'type' => class_basename($savedItem->saveable_type),
+//             ];
+            
+//             // Add type-specific data
+//             if ($item instanceof \App\Models\Music) {
+//                 return array_merge($baseData, [
+//                     'id' => $item->id,
+//                     'title' => $item->title,
+//                     'artist' => $item->artist,
+//                     'duration' => $item->duration_formatted ?? $item->duration,
+//                     'image_url' => $item->image_url,
+//                     'is_saved' => true,
+//                 ]);
+//             } elseif ($item instanceof \App\Models\Media) {
+//                 return array_merge($baseData, [
+//                     'id' => $item->id,
+//                     'title' => $item->title,
+//                     'caption' => $item->caption,
+//                     'type' => $item->type,
+//                     'duration' => $item->duration,
+//                     'image_url' => $item->image->url ?? null,
+//                     'is_saved' => true,
+//                 ]);
+//             } elseif ($item instanceof \App\Models\BreathingTemplate) {
+//                 return array_merge($baseData, [
+//                     'id' => $item->id,
+//                     'name' => $item->name,
+//                     'description' => $item->description,
+//                     'duration' => $item->duration,
+//                     'inhale' => $item->inhale,
+//                     'exhale' => $item->exhale,
+//                     'breath_hold' => $item->breath_hold,
+//                     'image_url' => $item->image_url,
+//                     'is_saved' => true,
+//                 ]);
+//             }
+            
+//             return $baseData;
+//         })->filter();

app/Http/Controllers/SceneController.php

@@ -0,0 +1,155 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Scene;
+use App\Models\UserSceneSetting;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+class SceneController extends Controller
+{
+    // CONSOLIDATED: everything the scene-settings screen needs in one call.
+    public function settings()
+    {
+        $settings = UserSceneSetting::with('activeScene')
+            ->firstOrNew(['user_id' => auth()->id()]);
+
+        return response()->json([
+            'scenes' => Scene::where('is_active', true)->orderBy('order')->get(),
+            'settings' => [
+                'active_scene_id' => $settings->active_scene_id,
+                'active_scene' => $settings->activeScene,
+                'scene_volume' => $settings->scene_volume ?? 100,
+                'background_play_seconds' => $settings->background_play_seconds ?? 0,
+                'video_enabled' => (bool) ($settings->video_enabled ?? false),
+            ],
+        ]);
+    }
+
+    // Persist the current user's scene preferences.
+    public function updateSettings(Request $request)
+    {
+        $data = $request->validate([
+            'active_scene_id' => 'nullable|exists:scenes,id',
+            'scene_volume' => 'nullable|integer|min:0|max:100',
+            'background_play_seconds' => 'nullable|integer|min:0',
+            'video_enabled' => 'nullable|boolean',
+        ]);
+
+        $settings = UserSceneSetting::firstOrNew(['user_id' => auth()->id()]);
+
+        foreach (['active_scene_id', 'scene_volume', 'background_play_seconds', 'video_enabled'] as $field) {
+            if ($request->has($field)) {
+                $settings->$field = $data[$field] ?? ($field === 'video_enabled' ? false : null);
+            }
+        }
+
+        $settings->save();
+
+        return response()->json([
+            'message' => 'Settings saved successfully',
+            'settings' => $settings->load('activeScene'),
+        ]);
+    }
+
+    public function index(Request $request)
+    {
+        $query = Scene::query();
+
+        if (!$request->boolean('include_inactive')) {
+            $query->where('is_active', true);
+        }
+
+        return response()->json($query->orderBy('order')->get());
+    }
+
+    public function show($id)
+    {
+        return response()->json(Scene::findOrFail($id));
+    }
+
+    // CREATE a scene with its image / video / sound uploads.
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'name' => 'required|string|max:255',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+            'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+            'video' => 'nullable|mimes:mp4,mov,webm|max:512000',
+            'sound' => 'nullable|mimes:mp3,wav,ogg,flac|max:51200',
+        ]);
+
+        $scene = Scene::create([
+            'name' => $data['name'],
+            'order' => $data['order'] ?? 0,
+            'is_active' => $data['is_active'] ?? true,
+            'image_path' => $request->hasFile('image') ? $request->file('image')->store('scenes/images', 'public') : null,
+            'video_path' => $request->hasFile('video') ? $request->file('video')->store('scenes/videos', 'public') : null,
+            'sound_path' => $request->hasFile('sound') ? $request->file('sound')->store('scenes/sounds', 'public') : null,
+        ]);
+
+        return response()->json([
+            'message' => 'Scene created successfully',
+            'scene' => $scene,
+        ], 201);
+    }
+
+    // UPDATE a scene; any uploaded file replaces the old one (POST for multipart support).
+    public function update(Request $request, $id)
+    {
+        $scene = Scene::findOrFail($id);
+
+        $data = $request->validate([
+            'name' => 'sometimes|string|max:255',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+            'image' => 'nullable|file|extensions:jpg,jpeg,png,gif,webp,bmp,svg|max:8192',
+            'video' => 'nullable|mimes:mp4,mov,webm|max:512000',
+            'sound' => 'nullable|mimes:mp3,wav,ogg,flac|max:51200',
+        ]);
+
+        if (array_key_exists('name', $data)) {
+            $scene->name = $data['name'];
+        }
+        if (array_key_exists('order', $data)) {
+            $scene->order = $data['order'];
+        }
+        if (array_key_exists('is_active', $data)) {
+            $scene->is_active = $data['is_active'];
+        }
+
+        foreach (['image' => 'scenes/images', 'video' => 'scenes/videos', 'sound' => 'scenes/sounds'] as $field => $folder) {
+            if ($request->hasFile($field)) {
+                $column = $field === 'image' ? 'image_path' : ($field === 'video' ? 'video_path' : 'sound_path');
+                if ($scene->$column) {
+                    Storage::disk('public')->delete($scene->$column);
+                }
+                $scene->$column = $request->file($field)->store($folder, 'public');
+            }
+        }
+
+        $scene->save();
+
+        return response()->json([
+            'message' => 'Scene updated successfully',
+            'scene' => $scene,
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $scene = Scene::findOrFail($id);
+
+        foreach (['image_path', 'video_path', 'sound_path'] as $column) {
+            if ($scene->$column) {
+                Storage::disk('public')->delete($scene->$column);
+            }
+        }
+
+        $scene->delete();
+
+        return response()->json(['message' => 'Scene deleted successfully']);
+    }
+}

app/Http/Controllers/SubCategoryController.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\SubCategory;
+use Illuminate\Http\Request;
+
+class SubCategoryController extends Controller
+{
+    public function index(Request $request, $categoryId = null)
+    {
+        $query = SubCategory::with('category')->withCount('media');
+
+        $categoryId = $categoryId ?? $request->input('category_id');
+
+        if ($categoryId) {
+            $query->where('category_id', $categoryId);
+        }
+
+        return response()->json(
+            $query->orderBy('name')->get()
+        );
+    }
+
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'category_id' => 'required|exists:categories,id',
+            'name' => 'required|string|max:255',
+            'description' => 'nullable|string',
+        ]);
+
+        $existing = SubCategory::where('category_id', $data['category_id'])
+            ->where('name', $data['name'])
+            ->first();
+
+        if ($existing) {
+            return response()->json([
+                'message' => 'A subcategory with this name already exists in this category',
+                'errors' => ['name' => ['The subcategory name must be unique within this category.']],
+            ], 422);
+        }
+
+        $subCategory = SubCategory::create($data);
+
+        return response()->json([
+            'message' => 'Subcategory created successfully',
+            'sub_category' => $subCategory->load('category'),
+        ], 201);
+    }
+
+    public function show($id)
+    {
+        $subCategory = SubCategory::with('category')->withCount('media')->findOrFail($id);
+
+        return response()->json($subCategory);
+    }
+
+    public function update(Request $request, $id)
+    {
+        $subCategory = SubCategory::findOrFail($id);
+
+        $data = $request->validate([
+            'category_id' => 'sometimes|exists:categories,id',
+            'name' => 'sometimes|string|max:255',
+            'description' => 'nullable|string',
+        ]);
+
+        $categoryId = $data['category_id'] ?? $subCategory->category_id;
+        $name = $data['name'] ?? $subCategory->name;
+
+        $existing = SubCategory::where('category_id', $categoryId)
+            ->where('name', $name)
+            ->where('id', '!=', $subCategory->id)
+            ->first();
+
+        if ($existing) {
+            return response()->json([
+                'message' => 'A subcategory with this name already exists in this category',
+                'errors' => ['name' => ['The subcategory name must be unique within this category.']],
+            ], 422);
+        }
+
+        $subCategory->update($data);
+
+        return response()->json([
+            'message' => 'Subcategory updated successfully',
+            'sub_category' => $subCategory->load('category'),
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $subCategory = SubCategory::findOrFail($id);
+        $subCategory->delete();
+
+        return response()->json(['message' => 'Subcategory deleted successfully']);
+    }
+}

app/Http/Controllers/SurveyQuestionController.php

@@ -0,0 +1,305 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Media;
+use App\Models\SurveyAnswer;
+use App\Models\SurveyQuestion;
+use App\Models\Tag;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Validation\ValidationException;
+
+class SurveyQuestionController extends Controller
+{
+    // USER: list active questions with their options and the current user's own answers.
+    public function index(Request $request)
+    {
+        $questions = SurveyQuestion::with(['options.tags', 'userAnswers'])
+            ->where('is_active', true)
+            ->orderBy('order')
+            ->get();
+
+        return response()->json($questions);
+    }
+
+    // USER: a single question with its options and the current user's own answers.
+    public function show($id)
+    {
+        $question = SurveyQuestion::with(['options.tags', 'userAnswers'])->findOrFail($id);
+
+        return response()->json($question);
+    }
+
+    // ADMIN: list every question (incl. inactive) with options (+ vote tallies) and all answers.
+    public function adminIndex(Request $request)
+    {
+        $questions = SurveyQuestion::with([
+                'options' => fn ($q) => $q->withCount('answers')->with('tags'),
+                'answers' => fn ($q) => $q->with(['user', 'option']),
+            ])
+            ->orderBy('order')
+            ->get();
+
+        return response()->json($questions);
+    }
+
+    // ADMIN: a single question with options (+ vote tallies) and all users' answers.
+    public function adminShow($id)
+    {
+        $question = SurveyQuestion::with([
+                'options' => fn ($q) => $q->withCount('answers')->with('tags'),
+                'answers' => fn ($q) => $q->with(['user', 'option']),
+            ])
+            ->findOrFail($id);
+
+        return response()->json($question);
+    }
+
+    // ADMIN: clean aggregated results — per option vote counts & percentages, no raw rows.
+    // Pass an $id for one question, omit it for all questions.
+    public function adminAnalytics($id = null)
+    {
+        $query = SurveyQuestion::with(['options' => fn ($q) => $q->withCount('answers')]);
+
+        if (!is_null($id)) {
+            $query->where('id', $id);
+        }
+
+        $questions = $query->orderBy('order')->get();
+
+        if (!is_null($id) && $questions->isEmpty()) {
+            abort(404);
+        }
+
+        $analytics = $questions->map(function (SurveyQuestion $question) {
+            // Respondents = distinct users who answered (not number of selections).
+            $respondents = $question->answers()->distinct('user_id')->count('user_id');
+            $totalSelections = (int) $question->options->sum('answers_count');
+
+            return [
+                'id' => $question->id,
+                'question' => $question->question,
+                'description' => $question->description,
+                'type' => $question->type,
+                'is_active' => $question->is_active,
+                'total_respondents' => $respondents,
+                'total_selections' => $totalSelections,
+                'options' => $question->options->map(function ($option) use ($respondents) {
+                    $votes = (int) $option->answers_count;
+
+                    return [
+                        'id' => $option->id,
+                        'label' => $option->label,
+                        'value' => $option->value,
+                        'votes' => $votes,
+                        // % of respondents who picked this option (can exceed 100% summed for multi-select).
+                        'percentage' => $respondents > 0 ? round($votes / $respondents * 100, 1) : 0,
+                    ];
+                })->values(),
+            ];
+        });
+
+        return response()->json(is_null($id) ? $analytics->values() : $analytics->first());
+    }
+
+    // CREATE a question together with its options.
+    public function store(Request $request)
+    {
+        $data = $request->validate([
+            'question' => 'required|string|max:255',
+            'description' => 'nullable|string',
+            'type' => 'required|in:single,multiple',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+            'options' => 'required|array|min:1',
+            'options.*.label' => 'required|string|max:255',
+            'options.*.value' => 'nullable|string|max:255',
+            'options.*.order' => 'nullable|integer',
+            'options.*.tags' => 'nullable|array',
+            'options.*.tags.*' => 'string',
+        ]);
+
+        $question = DB::transaction(function () use ($data) {
+            $question = SurveyQuestion::create([
+                'question' => $data['question'],
+                'description' => $data['description'] ?? null,
+                'type' => $data['type'],
+                'order' => $data['order'] ?? 0,
+                'is_active' => $data['is_active'] ?? true,
+            ]);
+
+            $this->syncOptions($question, $data['options']);
+
+            return $question;
+        });
+
+        return response()->json([
+            'message' => 'Question created successfully',
+            'question' => $question->load('options.tags'),
+        ], 201);
+    }
+
+    // UPDATE a question; if options are provided they replace the existing set.
+    public function update(Request $request, $id)
+    {
+        $question = SurveyQuestion::findOrFail($id);
+
+        $data = $request->validate([
+            'question' => 'sometimes|string|max:255',
+            'description' => 'nullable|string',
+            'type' => 'sometimes|in:single,multiple',
+            'order' => 'nullable|integer',
+            'is_active' => 'nullable|boolean',
+            'options' => 'sometimes|array|min:1',
+            'options.*.label' => 'required_with:options|string|max:255',
+            'options.*.value' => 'nullable|string|max:255',
+            'options.*.order' => 'nullable|integer',
+            'options.*.tags' => 'nullable|array',
+            'options.*.tags.*' => 'string',
+        ]);
+
+        DB::transaction(function () use ($question, $data) {
+            $question->update(array_filter(
+                [
+                    'question' => $data['question'] ?? null,
+                    'description' => array_key_exists('description', $data) ? $data['description'] : null,
+                    'type' => $data['type'] ?? null,
+                    'order' => $data['order'] ?? null,
+                    'is_active' => $data['is_active'] ?? null,
+                ],
+                fn ($value) => !is_null($value)
+            ));
+
+            if (array_key_exists('options', $data)) {
+                // Replacing options invalidates existing answers for this question.
+                $question->answers()->delete();
+                $question->options()->delete();
+                $this->syncOptions($question, $data['options']);
+            }
+        });
+
+        return response()->json([
+            'message' => 'Question updated successfully',
+            'question' => $question->load('options.tags'),
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $question = SurveyQuestion::findOrFail($id);
+        $question->delete(); // options + answers cascade
+
+        return response()->json(['message' => 'Question deleted successfully']);
+    }
+
+    // USER submits their answer(s) for a question.
+    public function answer(Request $request, $id)
+    {
+        $question = SurveyQuestion::findOrFail($id);
+
+        $data = $request->validate([
+            'option_ids' => 'required|array|min:1',
+            'option_ids.*' => 'integer',
+        ]);
+
+        $optionIds = array_values(array_unique($data['option_ids']));
+
+        // Every selected option must belong to this question.
+        $validOptionIds = $question->options()->pluck('id')->all();
+        if (array_diff($optionIds, $validOptionIds)) {
+            throw ValidationException::withMessages([
+                'option_ids' => ['One or more options do not belong to this question.'],
+            ]);
+        }
+
+        // Enforce single vs multiple selection.
+        if ($question->type === 'single' && count($optionIds) > 1) {
+            throw ValidationException::withMessages([
+                'option_ids' => ['This question allows only a single option.'],
+            ]);
+        }
+
+        $userId = auth()->id();
+
+        DB::transaction(function () use ($question, $optionIds, $userId) {
+            // Replace any previous answer for this user + question.
+            $question->answers()->where('user_id', $userId)->delete();
+
+            $rows = array_map(fn ($optionId) => [
+                'user_id' => $userId,
+                'survey_question_id' => $question->id,
+                'survey_option_id' => $optionId,
+                'created_at' => now(),
+                'updated_at' => now(),
+            ], $optionIds);
+
+            $question->answers()->getRelated()->insert($rows);
+        });
+
+        return response()->json([
+            'message' => 'Answer submitted successfully',
+            'question' => $question->load(['options', 'userAnswers']),
+        ]);
+    }
+
+    // USER: suggest media based on the tags attached to the options this user has chosen.
+    public function suggestedMedia(Request $request)
+    {
+        $userId = auth()->id();
+
+        $answersQuery = SurveyAnswer::where('user_id', $userId);
+        if ($request->filled('question_id')) {
+            $answersQuery->where('survey_question_id', $request->question_id);
+        }
+        $optionIds = $answersQuery->pluck('survey_option_id');
+
+        if ($optionIds->isEmpty()) {
+            return response()->json([]);
+        }
+
+        // Collect the tags behind the chosen options.
+        $tagIds = DB::table('survey_option_tag')
+            ->whereIn('survey_option_id', $optionIds)
+            ->pluck('tag_id')
+            ->unique()
+            ->values();
+
+        if ($tagIds->isEmpty()) {
+            return response()->json([]);
+        }
+
+        // Media sharing those tags, ranked by how many of them match.
+        $media = Media::query()
+            ->whereHas('tags', fn ($q) => $q->whereIn('tags.id', $tagIds))
+            ->withCount(['tags as match_count' => fn ($q) => $q->whereIn('tags.id', $tagIds)])
+            ->where(function ($q) use ($userId) {
+                $q->where('visibility', 'public')->orWhere('user_id', $userId);
+            })
+            ->with(['image', 'categories', 'subCategories', 'tags'])
+            ->orderByDesc('match_count')
+            ->orderByDesc('created_at')
+            ->get();
+
+        return response()->json($media);
+    }
+
+    private function syncOptions(SurveyQuestion $question, array $options): void
+    {
+        foreach (array_values($options) as $i => $option) {
+            $created = $question->options()->create([
+                'label' => $option['label'],
+                'value' => $option['value'] ?? null,
+                'order' => $option['order'] ?? $i,
+            ]);
+
+            if (!empty($option['tags'])) {
+                $tagIds = collect($option['tags'])
+                    ->map(fn ($name) => Tag::firstOrCreate(['name' => $name])->id)
+                    ->all();
+
+                $created->tags()->sync($tagIds);
+            }
+        }
+    }
+}

app/Http/Controllers/TimerPresetController.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\BackgroundSound;
+use App\Models\BellSound;
+use App\Models\Image;
+use App\Models\TimerPreset;
+use Illuminate\Http\Request;
+
+class TimerPresetController extends Controller
+{
+    // All catalogs needed to build a timer (pickers), in one call.
+    public function options()
+    {
+        return response()->json([
+            'bell_sounds' => BellSound::where('is_active', true)->orderBy('order')->get(),
+            'background_sounds' => BackgroundSound::where('is_active', true)->orderBy('order')->get(),
+            'background_images' => Image::where('type', 'public')->get(),
+        ]);
+    }
+
+    // USER: their saved timers (ذخیره‌شده‌های من).
+    public function index()
+    {
+        $presets = TimerPreset::with(TimerPreset::RELATIONS)
+            ->where('user_id', auth()->id())
+            ->latest()
+            ->get();
+
+        return response()->json($presets);
+    }
+
+    public function show($id)
+    {
+        $preset = TimerPreset::with(TimerPreset::RELATIONS)
+            ->where('user_id', auth()->id())
+            ->findOrFail($id);
+
+        return response()->json($preset);
+    }
+
+    public function store(Request $request)
+    {
+        $data = $this->validatePreset($request);
+
+        $preset = TimerPreset::create($data + ['user_id' => auth()->id()]);
+
+        return response()->json([
+            'message' => 'Timer saved successfully',
+            'preset' => $preset->load(TimerPreset::RELATIONS),
+        ], 201);
+    }
+
+    public function update(Request $request, $id)
+    {
+        $preset = TimerPreset::where('user_id', auth()->id())->findOrFail($id);
+
+        $data = $this->validatePreset($request, false);
+
+        $preset->fill($data)->save();
+
+        return response()->json([
+            'message' => 'Timer updated successfully',
+            'preset' => $preset->load(TimerPreset::RELATIONS),
+        ]);
+    }
+
+    public function destroy($id)
+    {
+        $preset = TimerPreset::where('user_id', auth()->id())->findOrFail($id);
+        $preset->delete();
+
+        return response()->json(['message' => 'Timer deleted successfully']);
+    }
+
+    private function validatePreset(Request $request, bool $creating = true): array
+    {
+        $required = $creating ? 'required' : 'sometimes';
+
+        return $request->validate([
+            'name' => "$required|string|max:255",
+            'duration_seconds' => "$required|integer|min:1",
+            'start_bell_id' => 'nullable|exists:bell_sounds,id',
+            'end_bell_id' => 'nullable|exists:bell_sounds,id',
+            'interval_bell_id' => 'nullable|exists:bell_sounds,id',
+            'interval_seconds' => 'nullable|integer|min:1',
+            'interval_repeat' => 'nullable|integer|min:1',
+            'background_sound_id' => 'nullable|exists:background_sounds,id',
+            'background_image_id' => 'nullable|exists:images,id',
+            'volume' => 'nullable|integer|min:0|max:100',
+        ]);
+    }
+}

app/Http/Controllers/UserController.php

@@ -63,7 +63,8 @@ public function loginV2(Request $request)
             // 'name' => trim(($response['first_name'] ?? '') . ' ' . ($response['last_name'] ?? '')),
             'mobile' => $mobile,
             'first_name' => $response['first_name'] ?? null,
-            'last_name' => $response['last_name'] ?? null
+            'last_name' => $response['last_name'] ?? null,
+            'referral_code' => $response['referral_code'] ?? null,
         ]);
     } else {
         // Only update name and mobile for existing user
@@ -71,12 +72,21 @@ public function loginV2(Request $request)
         $user->last_name = $response['last_name'] ?? $user->last_name;
         // $user->name = trim(($response['first_name'] ?? '') . ' ' . ($response['last_name'] ?? ''));
         $user->mobile = $mobile ?? $user->mobile;
+        $user->referral_code = $response['referral_code'] ?? $user->referral_code;
         $user->save();
     }
 
+        // Link the referral relationship and reward the referrer (کد معرف)
+        $this->linkReferral($user, $response);
 
         $access_token = $user->createToken('user')->plainTextToken;
 
+        // Whether this user has answered any survey question.
+        $user->setAttribute(
+            'has_answered_survey',
+            \App\Models\SurveyAnswer::where('user_id', $user->id)->exists()
+        );
+
         return [
             'email' => $user->email,
             'identifier' => $user->identifier,
@@ -111,6 +121,7 @@ private function syncUserFromStatus(array $response, ?User $user = null): User
             'mobile' => $mobile,
             'first_name' => $response['first_name'] ?? null,
             'last_name' => $response['last_name'] ?? null,
+            'referral_code' => $response['referral_code'] ?? null,
             'email_verified_at' => $response['email_verified_at'] ?? null
         ]);
     } else {
@@ -118,13 +129,68 @@ private function syncUserFromStatus(array $response, ?User $user = null): User
         $user->first_name = $response['first_name'] ?? $user->first_name;
         $user->last_name  = $response['last_name'] ?? $user->last_name;
         $user->mobile     = $mobile ?? $user->mobile;
+        $user->referral_code = $response['referral_code'] ?? $user->referral_code;
         $user->email_verified_at = $response['email_verified_at'] ?? $user->email_verified_at;
         $user->save();
     }
 
+    // Link the referral relationship and reward the referrer (کد معرف)
+    $this->linkReferral($user, $response);
+
     return $user;
 }
 
+    /**
+     * Resolve the approagency referrer (by uuid/identifier) to a local
+     * meditation user, record the relationship once, and grant the referrer
+     * their per-invite points. The free-month subscription milestone is
+     * handled in approagency, where products/plans/transactions are managed.
+     */
+    private function linkReferral(User $user, array $response): void
+    {
+        if ($user->referred_by) {
+            return; // already linked — never reward twice
+        }
+
+        $referrerUuid = $response['referrer_uuid'] ?? null;
+        if (!$referrerUuid) {
+            return;
+        }
+
+        $referrer = User::where('identifier', $referrerUuid)->first();
+        if (!$referrer || $referrer->id === $user->id) {
+            return;
+        }
+
+        $user->referred_by = $referrer->id;
+        $user->save();
+
+        // 100 points per successful invite
+        $referrer->increment('referral_points', User::REFERRAL_POINTS_PER_INVITE);
+    }
+
+    /**
+     * Referral dashboard data (دعوت دوستان page).
+     */
+    public function referral(Request $request)
+    {
+        $user = auth()->user();
+        $invites = $user->referrals()->count();
+        $target = User::REFERRAL_SUBSCRIPTION_TARGET;
+
+        return response()->json([
+            'referral_code' => $user->referral_code,
+            'referral_points' => (int) $user->referral_points,
+            'successful_invites' => $invites,
+            'subscription_target' => $target,
+            'remaining_to_subscription' => max(0, $target - $invites),
+            'rewards' => [
+                'points_per_invite' => User::REFERRAL_POINTS_PER_INVITE,
+                'friend_points_share_percent' => (int) (User::REFERRAL_SHARE * 100),
+                'subscription_invite_target' => $target,
+            ],
+        ]);
+    }
 
     public function loginForeginer(Request $request)
     {
@@ -499,6 +565,13 @@ public function profile(Request $request)
         : [];
 
         $user->load(['breathingSessions.template']);
+
+        // Whether this user has answered any survey question.
+        $user->setAttribute(
+            'has_answered_survey',
+            \App\Models\SurveyAnswer::where('user_id', $user->id)->exists()
+        );
+
         return response()->json([
             'user' => $user,
             'reminders' => $reminders,

app/Models/AppFeedback.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AppFeedback extends Model
+{
+    protected $table = 'app_feedback';
+
+    protected $fillable = ['user_id', 'stars', 'content'];
+
+    protected $casts = [
+        'stars' => 'integer',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/BackgroundSound.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class BackgroundSound extends Model
+{
+    protected $fillable = ['name', 'sound_path', 'image_path', 'order', 'is_active'];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+
+    protected $appends = ['sound_url', 'image_url'];
+
+    public function getSoundUrlAttribute(): ?string
+    {
+        return $this->sound_path ? asset('storage/' . $this->sound_path) : null;
+    }
+
+    public function getImageUrlAttribute(): ?string
+    {
+        return $this->image_path ? asset('storage/' . $this->image_path) : null;
+    }
+}

app/Models/BellSound.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class BellSound extends Model
+{
+    protected $fillable = ['name', 'sound_path', 'image_path', 'order', 'is_active'];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+
+    protected $appends = ['sound_url', 'image_url'];
+
+    public function getSoundUrlAttribute(): ?string
+    {
+        return $this->sound_path ? asset('storage/' . $this->sound_path) : null;
+    }
+
+    public function getImageUrlAttribute(): ?string
+    {
+        return $this->image_path ? asset('storage/' . $this->image_path) : null;
+    }
+}

app/Models/BreathingTemplate.php

@@ -3,16 +3,18 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
+use App\Traits\HasSaves;
 
 class BreathingTemplate extends Model
 {
+     use HasSaves;
     protected $fillable = ['user_id', 'name', 'inhale', 'exhale', 'breath_hold' , 'duration' , 'description','image_id' , 'source'];
 
     public function user()
     {
         return $this->belongsTo(User::class);
     }
-    protected $appends = ['image_url'];
+    protected $appends = ['image_url', 'is_saved','saved_count'];
 
     public function getImageUrlAttribute()
     {

app/Models/Category.php

@@ -6,11 +6,28 @@
 
 class Category extends Model
 {
-    protected $fillable = ['name'];
+    protected $fillable = ['name', 'description', 'icon'];
+
+    protected $appends = ['icon_url'];
+
+    public function getIconUrlAttribute(): ?string
+    {
+        return $this->icon ? asset('storage/' . $this->icon) : null;
+    }
 
     public function questions()
     {
         return $this->hasMany(Question::class);
     }
+
+    public function subcategories()
+    {
+        return $this->hasMany(SubCategory::class);
+    }
+
+    public function media()
+    {
+        return $this->belongsToMany(Media::class, 'category_media');
+    }
 }
 

app/Models/ChatTopic.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class ChatTopic extends Model
+{
+    protected $fillable = ['title', 'description', 'order', 'is_active'];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+}

app/Models/Like.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+class Like extends Model
+{
+    protected $table = 'likes';
+    
+    protected $fillable = [
+        'user_id',
+        'likeable_id',
+        'likeable_type',
+    ];
+    
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+    
+    public function likeable(): MorphTo
+    {
+        return $this->morphTo();
+    }
+    
+    // Helper methods
+    public static function getLikedItemsForUser($userId, $type = null)
+    {
+        $query = self::with('likeable')->where('user_id', $userId);
+        
+        if ($type) {
+            $query->where('likeable_type', $type);
+        }
+        
+        return $query->latest()->get();
+    }
+    
+    public static function isLikedByUser($userId, $likeableId, $likeableType)
+    {
+        return self::where([
+            'user_id' => $userId,
+            'likeable_id' => $likeableId,
+            'likeable_type' => $likeableType,
+        ])->exists();
+    }
+    
+    public static function getLikeCount($likeableId, $likeableType)
+    {
+        return self::where([
+            'likeable_id' => $likeableId,
+            'likeable_type' => $likeableType,
+        ])->count();
+    }
+}

app/Models/Media.php

@@ -5,13 +5,15 @@
 use Illuminate\Database\Eloquent\Model;
 use App\Traits\HasRatings;
 use App\Traits\HasComments;
+use App\Traits\HasSaves;
+use App\Traits\HasLikes;
 class Media extends Model
 {
-     use HasRatings, HasComments;
+     use HasRatings, HasComments,HasSaves,HasLikes;
   protected $fillable = [
         'user_id',
         'image_id',
-        'category_id',
+        'detail_image_id',
         'title',
         'caption',
         'type',
@@ -21,29 +23,50 @@ class Media extends Model
         'visibility',
         'is_premium'
     ];
-protected $appends = [
-    'average_rating',
+    protected $appends = [
+        'average_rating',
         'user_rating',
         'ratings_count',
         'comments_count',
-         'has_user_commented',      // Add this
-        'user_comment',            // Add this
-        'user_comment_id',         // Add this
-        'has_user_rated'           // Add this
-];
+        'has_user_commented',    
+        'user_comment',         
+        'user_comment_id',      
+        'has_user_rated',   
+        'is_saved',
+        'saved_count',
+        'is_liked',
+        'likes_count',
+        'url',
+    ];
     public function image()
     {
         return $this->belongsTo(Image::class);
     }
 
-    public function category()
+    // Image shown on the detail (show-by-id) screen; image() is the list thumbnail.
+    public function detailImage()
     {
-        return $this->belongsTo(Category::class);
+        return $this->belongsTo(Image::class, 'detail_image_id');
+    }
+
+    public function categories()
+    {
+        return $this->belongsToMany(Category::class, 'category_media');
+    }
+
+    public function subCategories()
+    {
+        return $this->belongsToMany(SubCategory::class, 'media_sub_category');
     }
     public function tags()
     {
         return $this->belongsToMany(Tag::class, 'media_tag');
     }
+
+    public function plays()
+    {
+        return $this->hasMany(MediaPlay::class);
+    }
     public function notes()
     {
         return $this->morphMany(Note::class, 'noteable');

app/Models/MediaPlay.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class MediaPlay extends Model
+{
+    protected $fillable = ['user_id', 'media_id', 'play_count', 'last_played_at'];
+
+    protected $casts = [
+        'play_count' => 'integer',
+        'last_played_at' => 'datetime',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function media(): BelongsTo
+    {
+        return $this->belongsTo(Media::class);
+    }
+}

app/Models/Music.php

@@ -10,20 +10,21 @@
 use Illuminate\Database\Eloquent\Relations\MorphMany;    // ← Add this
 use App\Traits\HasRatings;
 use App\Traits\HasComments;
+use App\Traits\HasSaves;
+use App\Traits\HasLikes;
 
 class Music extends Model
 {   
-     use HasFactory, HasRatings, HasComments;
+     use HasFactory, HasRatings, HasComments , HasSaves,HasLikes;
      protected $table = 'music';
     
 
     protected $fillable = [
     'user_id', 'title', 'artist', 'file_path', 'type',
-        'playlist_id', 'image_id', 'duration', 'order', 'is_active'
+        'image_id', 'duration', 'is_active'
     ];
  protected $casts = [
-        'duration' => 'string',
-        'order' => 'integer',
+        'duration' => 'integer',
         'is_active' => 'boolean',
     ];
     protected $attributes = [
@@ -34,19 +35,30 @@ public function user()
     {
         return $this->belongsTo(User::class);
     }
-     public function playlist(): BelongsTo
+     public function playlists(): BelongsToMany
     {
-        return $this->belongsTo(MusicPlaylist::class, 'playlist_id');
+        return $this->belongsToMany(MusicPlaylist::class, 'music_playlist', 'music_id', 'playlist_id')
+            ->withPivot('order')
+            ->withTimestamps();
     }
      public function tags(): BelongsToMany
     {
         return $this->belongsToMany(Tag::class, 'music_tags');
     }
     
-    protected $appends = ['url', 'image_url' , 'average_rating', 'user_rating', 'comments_count' ,     'has_user_commented',      // Add this
-    'user_comment',            // Add this
-    'user_comment_id',         // Add this
-    'has_user_rated'           // Add this];
+    protected $appends = ['url',
+    'image_url' , 
+    'average_rating',
+    'user_rating', 
+    'comments_count' , 
+    'has_user_commented',  
+    'user_comment',         
+    'user_comment_id',         
+    'has_user_rated' ,
+    'is_saved', 
+    'saved_count',
+    'is_liked',
+    'likes_count'      
     ];
 
     public function getUrlAttribute()

app/Models/MusicCategory.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;  // ← Add this
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;    // ← Add this
 class MusicCategory extends Model
 {
@@ -18,11 +19,26 @@ class MusicCategory extends Model
         'order' => 'integer',
     ];
 
-    public function playlists(): HasMany
+    public function playlists(): BelongsToMany
     {
-        return $this->hasMany(MusicPlaylist::class, 'category_id');
+        return $this->belongsToMany(MusicPlaylist::class, 'music_category_playlist', 'category_id', 'playlist_id');
     }
 
+    public function subcategories(): HasMany
+    {
+        return $this->hasMany(MusicSubcategory::class, 'category_id');
+    }
+       // All playlists (including those in subcategories)
+    public function allPlaylists()
+    {
+        $playlists = collect($this->playlists);
+        
+        foreach ($this->subcategories as $subcategory) {
+            $playlists = $playlists->merge($subcategory->playlists);
+        }
+        
+        return $playlists;
+    }
     public function image(): BelongsTo
     {
         return $this->belongsTo(Image::class);
@@ -30,6 +46,20 @@ public function image(): BelongsTo
     
     public function getActivePlaylistsAttribute()
     {
-        return $this->playlists()->where('is_active', true)->get();
+        return $this->playlists()->where('music_playlists.is_active', true)->get();
+    }
+
+      // Total music count across all playlists and subcategories
+    public function getTotalMusicCountAttribute()
+    {
+        $count = $this->playlists->sum(function($playlist) {
+            return $playlist->musics->count();
+        });
+        
+        foreach ($this->subcategories as $subcategory) {
+            $count += $subcategory->total_music_count;
+        }
+        
+        return $count;
     }
 }

app/Models/MusicPlaylist.php

@@ -4,28 +4,50 @@
 
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;  // ← Add this
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;    // ← Add this
+use App\Traits\HasComments; // Add this
+use App\Traits\HasLikes;
+use App\Traits\HasSaves;
 class MusicPlaylist extends Model
 {
+    use HasComments, HasLikes, HasSaves;
     protected $table = 'music_playlists';
     
     protected $fillable = [
-        'category_id', 'name', 'slug', 'description', 'image_id', 'order', 'is_active'
+        'name', 'slug', 'description', 'image_id', 'detail_image_id', 'order', 'is_active'
     ];
     
     protected $casts = [
         'is_active' => 'boolean',
         'order' => 'integer',
     ];
-    
-    public function category(): BelongsTo
+    protected $appends = [
+        'comments_count',
+        'has_user_commented',
+        'user_comment',
+        'user_comment_id',
+        'is_liked',
+        'likes_count',
+        'is_saved',
+        'saved_count'
+    ];
+    public function categories(): BelongsToMany
     {
-        return $this->belongsTo(MusicCategory::class, 'category_id');
+        return $this->belongsToMany(MusicCategory::class, 'music_category_playlist', 'playlist_id', 'category_id');
     }
 
-    public function musics(): HasMany
+    public function subcategories(): BelongsToMany
     {
-        return $this->hasMany(Music::class, 'playlist_id');
+        return $this->belongsToMany(MusicSubcategory::class, 'music_subcategory_playlist', 'playlist_id', 'subcategory_id');
+    }
+    
+    
+    public function musics(): BelongsToMany
+    {
+        return $this->belongsToMany(Music::class, 'music_playlist', 'playlist_id', 'music_id')
+            ->withPivot('order')
+            ->withTimestamps();
     }
     
     public function image(): BelongsTo
@@ -33,13 +55,19 @@ public function image(): BelongsTo
         return $this->belongsTo(Image::class);
     }
 
+    // Image shown on the detail (show-by-id) screen; image() is the list thumbnail.
+    public function detailImage(): BelongsTo
+    {
+        return $this->belongsTo(Image::class, 'detail_image_id');
+    }
+    
     public function getActiveMusicsAttribute()
     {
-        return $this->musics()->where('is_active', true)->orderBy('order')->get();
+        return $this->musics()->where('music.is_active', true)->orderBy('music_playlist.order')->get();
     }
 
     public function getTotalDurationAttribute()
     {
-        return $this->musics()->where('is_active', true)->sum('duration');
+        return $this->musics()->where('music.is_active', true)->sum('music.duration');
     }
 }

app/Models/MusicSubcategory.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+class MusicSubcategory extends Model
+{
+        protected $table = 'music_subcategories';
+    
+    protected $fillable = [
+        'category_id', 'name', 'slug', 'description', 'image_id', 'order', 'is_active'
+    ];
+    
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+    
+    public function category(): BelongsTo
+    {
+        return $this->belongsTo(MusicCategory::class, 'category_id');
+    }
+    
+    public function playlists(): BelongsToMany
+    {
+        return $this->belongsToMany(MusicPlaylist::class, 'music_subcategory_playlist', 'subcategory_id', 'playlist_id');
+    }
+    
+    public function image(): BelongsTo
+    {
+        return $this->belongsTo(Image::class);
+    }
+    
+    public function getActivePlaylistsAttribute()
+    {
+        return $this->playlists()->where('music_playlists.is_active', true)->orderBy('music_playlists.order')->get();
+    }
+    
+    // Get total music count across all playlists in this subcategory
+    public function getTotalMusicCountAttribute()
+    {
+        return $this->playlists()
+            ->withCount('musics')
+            ->get()
+            ->sum('musics_count');
+    }
+    
+    // Get total duration across all music in this subcategory
+    public function getTotalDurationAttribute()
+    {
+        $totalSeconds = 0;
+        foreach ($this->playlists as $playlist) {
+            foreach ($playlist->musics as $music) {
+                $totalSeconds += $this->durationToSeconds($music->duration);
+            }
+        }
+        return $this->secondsToDuration($totalSeconds);
+    }
+    
+    private function durationToSeconds($duration)
+    {
+        if (!$duration) return 0;
+        $parts = explode(':', $duration);
+        if (count($parts) === 2) {
+            return (int)$parts[0] * 60 + (int)$parts[1];
+        } elseif (count($parts) === 3) {
+            return (int)$parts[0] * 3600 + (int)$parts[1] * 60 + (int)$parts[2];
+        }
+        return 0;
+    }
+    
+    private function secondsToDuration($seconds)
+    {
+        $hours = floor($seconds / 3600);
+        $minutes = floor(($seconds % 3600) / 60);
+        $secs = $seconds % 60;
+        
+        if ($hours > 0) {
+            return sprintf("%d:%02d:%02d", $hours, $minutes, $secs);
+        }
+        return sprintf("%d:%02d", $minutes, $secs);
+    }
+}

app/Models/SavedItem.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+class SavedItem extends Model
+{
+    protected $table = 'saved_items';
+    
+    protected $fillable = [
+        'user_id',
+        'saveable_id',
+        'saveable_type',
+    ];
+    
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+    
+    public function saveable(): MorphTo
+    {
+        return $this->morphTo();
+    }
+    
+    // Helper to get saved items by type
+    public static function getSavedItemsForUser($userId, $type = null)
+    {
+        $query = self::with('saveable')->where('user_id', $userId);
+        
+        if ($type) {
+            $query->where('saveable_type', $type);
+        }
+        
+        return $query->latest()->get();
+    }
+    
+    // Check if user has saved specific item
+    public static function isSavedByUser($userId, $saveableId, $saveableType)
+    {
+        return self::where([
+            'user_id' => $userId,
+            'saveable_id' => $saveableId,
+            'saveable_type' => $saveableType,
+        ])->exists();
+    }
+}

app/Models/Scene.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Scene extends Model
+{
+    protected $fillable = ['name', 'image_path', 'video_path', 'sound_path', 'order', 'is_active'];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+
+    protected $appends = ['image_url', 'video_url', 'sound_url', 'has_video'];
+
+    public function getImageUrlAttribute(): ?string
+    {
+        return $this->image_path ? asset('storage/' . $this->image_path) : null;
+    }
+
+    public function getVideoUrlAttribute(): ?string
+    {
+        return $this->video_path ? asset('storage/' . $this->video_path) : null;
+    }
+
+    public function getSoundUrlAttribute(): ?string
+    {
+        return $this->sound_path ? asset('storage/' . $this->sound_path) : null;
+    }
+
+    // Whether this scene can be shown as a video (the "تبدیل صحنه به ویدیو" toggle).
+    public function getHasVideoAttribute(): bool
+    {
+        return !empty($this->video_path);
+    }
+}

app/Models/SubCategory.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+
+class SubCategory extends Model
+{
+    protected $table = 'sub_categories';
+
+    protected $fillable = ['category_id', 'name', 'description'];
+
+    public function category(): BelongsTo
+    {
+        return $this->belongsTo(Category::class);
+    }
+
+    public function media(): BelongsToMany
+    {
+        return $this->belongsToMany(Media::class, 'media_sub_category');
+    }
+}

app/Models/SurveyAnswer.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class SurveyAnswer extends Model
+{
+    protected $fillable = ['user_id', 'survey_question_id', 'survey_option_id'];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function question(): BelongsTo
+    {
+        return $this->belongsTo(SurveyQuestion::class, 'survey_question_id');
+    }
+
+    public function option(): BelongsTo
+    {
+        return $this->belongsTo(SurveyOption::class, 'survey_option_id');
+    }
+}

app/Models/SurveyOption.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class SurveyOption extends Model
+{
+    protected $fillable = ['survey_question_id', 'label', 'value', 'order'];
+
+    protected $casts = [
+        'order' => 'integer',
+    ];
+
+    public function question(): BelongsTo
+    {
+        return $this->belongsTo(SurveyQuestion::class, 'survey_question_id');
+    }
+
+    public function answers(): HasMany
+    {
+        return $this->hasMany(SurveyAnswer::class);
+    }
+
+    // Tags used to suggest media when a user picks this option.
+    public function tags(): BelongsToMany
+    {
+        return $this->belongsToMany(Tag::class, 'survey_option_tag');
+    }
+}

app/Models/SurveyQuestion.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class SurveyQuestion extends Model
+{
+    protected $fillable = ['question', 'description', 'type', 'order', 'is_active'];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'order' => 'integer',
+    ];
+
+    public function options(): HasMany
+    {
+        return $this->hasMany(SurveyOption::class)->orderBy('order');
+    }
+
+    public function answers(): HasMany
+    {
+        return $this->hasMany(SurveyAnswer::class);
+    }
+
+    // The current user's selected option ids for this question.
+    public function userAnswers(): HasMany
+    {
+        return $this->hasMany(SurveyAnswer::class)->where('user_id', auth()->id());
+    }
+}

app/Models/TimerPreset.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class TimerPreset extends Model
+{
+    protected $fillable = [
+        'user_id',
+        'name',
+        'duration_seconds',
+        'start_bell_id',
+        'end_bell_id',
+        'interval_bell_id',
+        'interval_seconds',
+        'interval_repeat',
+        'background_sound_id',
+        'background_image_id',
+        'volume',
+    ];
+
+    protected $casts = [
+        'duration_seconds' => 'integer',
+        'interval_seconds' => 'integer',
+        'interval_repeat' => 'integer',
+        'volume' => 'integer',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function startBell(): BelongsTo
+    {
+        return $this->belongsTo(BellSound::class, 'start_bell_id');
+    }
+
+    public function endBell(): BelongsTo
+    {
+        return $this->belongsTo(BellSound::class, 'end_bell_id');
+    }
+
+    public function intervalBell(): BelongsTo
+    {
+        return $this->belongsTo(BellSound::class, 'interval_bell_id');
+    }
+
+    public function backgroundSound(): BelongsTo
+    {
+        return $this->belongsTo(BackgroundSound::class, 'background_sound_id');
+    }
+
+    public function backgroundImage(): BelongsTo
+    {
+        return $this->belongsTo(Image::class, 'background_image_id');
+    }
+
+    // Eager-load set for returning a fully-resolved preset to the front.
+    public const RELATIONS = [
+        'startBell',
+        'endBell',
+        'intervalBell',
+        'backgroundSound',
+        'backgroundImage',
+    ];
+}

app/Models/User.php

@@ -18,6 +18,12 @@ class User extends Authenticatable
         'male' => 1,
         'female' => 2,
     ];
+
+    // Referral program (کد معرف)
+    const REFERRAL_POINTS_PER_INVITE = 100;   // points granted to the referrer per successful invite
+    const REFERRAL_SHARE = 0.10;              // referrer keeps 10% of each friend's earned xp, forever
+    const REFERRAL_SUBSCRIPTION_TARGET = 10;  // successful invites needed for the free-month milestone
+
     /**
      * The attributes that are mass assignable.
      *
@@ -69,6 +75,32 @@ public function otpTokens()
         return $this->hasMany(OtpTokens::class);
     }
 
+    public function referrer()
+    {
+        return $this->belongsTo(User::class, 'referred_by');
+    }
+
+    public function referrals()
+    {
+        return $this->hasMany(User::class, 'referred_by');
+    }
+
+    /**
+     * Award xp to this user and, if they were referred, credit the
+     * referrer their permanent 10% share of the earned points.
+     */
+    public function awardXp(int $amount): void
+    {
+        $this->increment('xp', $amount);
+
+        if ($this->referred_by) {
+            $share = (int) floor($amount * self::REFERRAL_SHARE);
+            if ($share > 0) {
+                self::where('id', $this->referred_by)->increment('referral_points', $share);
+            }
+        }
+    }
+
     public function transactions()
     {
         return $this->hasMany(Transaction::class);

app/Models/UserSceneSetting.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class UserSceneSetting extends Model
+{
+    protected $fillable = [
+        'user_id',
+        'active_scene_id',
+        'scene_volume',
+        'background_play_seconds',
+        'video_enabled',
+    ];
+
+    protected $casts = [
+        'scene_volume' => 'integer',
+        'background_play_seconds' => 'integer',
+        'video_enabled' => 'boolean',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function activeScene(): BelongsTo
+    {
+        return $this->belongsTo(Scene::class, 'active_scene_id');
+    }
+}

app/Traits/HandlesImageUpload.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Traits;
+
+use App\Models\Image;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+trait HandlesImageUpload
+{
+    /**
+     * If the request carries an uploaded image file, store it, create an Image
+     * record for it, and return that record's id. Returns null when no file is
+     * present so callers can fall back to a provided image_id.
+     */
+    protected function uploadedImageId(Request $request, string $field = 'image'): ?int
+    {
+        if (!$request->hasFile($field)) {
+            return null;
+        }
+
+        $file = $request->file($field);
+        $ext = $file->getClientOriginalExtension() ?: ($file->guessExtension() ?: 'jpg');
+        $path = $file->storeAs('images', Str::random(40) . '.' . $ext, 'public');
+
+        return Image::create([
+            'user_id' => auth()->id(),
+            'path' => $path,
+            'type' => 'public',
+        ])->id;
+    }
+}

app/Traits/HasLikes.php

@@ -0,0 +1,59 @@
+<?php
+// app/Traits/HasLikes.php
+namespace App\Traits;
+
+use App\Models\Like;
+use Illuminate\Database\Eloquent\Relations\MorphMany;
+
+trait HasLikes
+{
+    public function likes(): MorphMany
+    {
+        return $this->morphMany(Like::class, 'likeable');
+    }
+    
+    public function getIsLikedAttribute()
+    {
+        if (!auth()->check()) return false;
+        
+        return $this->likes()
+            ->where('user_id', auth()->id())
+            ->exists();
+    }
+    
+    public function getLikesCountAttribute()
+    {
+        return $this->likes()->count();
+    }
+    
+    public function toggleLike()
+    {
+        if ($this->getIsLikedAttribute()) {
+            return $this->removeLike();
+        } else {
+            return $this->addLike();
+        }
+    }
+    
+    public function addLike()
+    {
+        if ($this->getIsLikedAttribute()) return false;
+        
+        return Like::create([
+            'user_id' => auth()->id(),
+            'likeable_id' => $this->id,
+            'likeable_type' => get_class($this),
+        ]);
+    }
+    
+    public function removeLike()
+    {
+        if (!$this->getIsLikedAttribute()) return false;
+        
+        return Like::where([
+            'user_id' => auth()->id(),
+            'likeable_id' => $this->id,
+            'likeable_type' => get_class($this),
+        ])->delete();
+    }
+}

app/Traits/HasSaves.php

@@ -0,0 +1,59 @@
+<?php
+// app/Traits/HasSaves.php
+namespace App\Traits;
+
+use App\Models\SavedItem;
+use Illuminate\Database\Eloquent\Relations\MorphMany;
+
+trait HasSaves
+{
+    public function saves()
+    {
+        return $this->morphMany(SavedItem::class, 'saveable');
+    }
+    
+    public function getIsSavedAttribute()
+    {
+        if (!auth()->check()) return false;
+        
+        return $this->saves()
+            ->where('user_id', auth()->id())
+            ->exists();
+    }
+    
+    public function getSavedCountAttribute()
+    {
+        return $this->saves()->count();
+    }
+    
+    public function toggleSaveStatus()
+    {
+        if ($this->getIsSavedAttribute()) {
+            return $this->removeSave();
+        } else {
+            return $this->addSave();
+        }
+    }
+    
+    public function addSave()
+    {
+        if ($this->getIsSavedAttribute()) return false;
+        
+        return SavedItem::create([
+            'user_id' => auth()->id(),
+            'saveable_id' => $this->id,
+            'saveable_type' => get_class($this),
+        ]);
+    }
+    
+    public function removeSave()
+    {
+        if (!$this->getIsSavedAttribute()) return false;
+        
+        return SavedItem::where([
+            'user_id' => auth()->id(),
+            'saveable_id' => $this->id,
+            'saveable_type' => get_class($this),
+        ])->delete();
+    }
+}

app/Traits/StoresUploads.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Traits;
+
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Str;
+
+trait StoresUploads
+{
+    /**
+     * Store an uploaded file under a random name while preserving its real
+     * extension (from the original filename). Laravel's default store() derives
+     * the extension from the sniffed MIME type, which yields ".bin" for files
+     * that sniff as application/octet-stream (e.g. some valid .mp3 files).
+     */
+    protected function storeUpload(UploadedFile $file, string $folder, string $disk = 'public'): string
+    {
+        $ext = $file->getClientOriginalExtension()
+            ?: ($file->guessExtension() ?: 'bin');
+
+        return $file->storeAs($folder, Str::random(40) . '.' . $ext, $disk);
+    }
+}

database/migrations/2026_05_21_105404_create_music_subcategories_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('music_subcategories', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('category_id')->constrained('music_categories')->onDelete('cascade');
+            $table->string('name');
+            $table->string('slug')->unique();
+            $table->text('description')->nullable();
+            $table->foreignId('image_id')->nullable()->constrained('images')->onDelete('set null');
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+            
+            $table->index(['category_id', 'order']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('music_subcategories');
+    }
+};

database/migrations/2026_05_21_105523_add_subcategory_to_playlists.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('music_playlists', function (Blueprint $table) {
+           $table->foreignId('subcategory_id')->nullable()->after('category_id')
+                  ->constrained('music_subcategories')->onDelete('cascade');
+            // Make category_id nullable since playlist can belong to subcategory
+            $table->foreignId('category_id')->nullable()->change();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('music_playlists', function (Blueprint $table) {
+           $table->dropForeign(['subcategory_id']);
+            $table->dropColumn('subcategory_id');
+            $table->foreignId('category_id')->nullable(false)->change();
+        });
+    }
+};

database/migrations/2026_05_22_175608_change_duration_to_integer_in_music_table.php

@@ -0,0 +1,55 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Get the database driver
+        $driver = DB::connection()->getDriverName();
+        
+        if ($driver === 'pgsql') {
+            // PostgreSQL: Use raw statement with USING clause
+            DB::statement('ALTER TABLE music ALTER COLUMN duration TYPE integer USING (duration::integer)');
+            
+            Schema::table('music', function (Blueprint $table) {
+                $table->integer('duration')->nullable()->change();
+            });
+        } elseif ($driver === 'mysql') {
+            // MySQL: Can directly change column type
+            Schema::table('music', function (Blueprint $table) {
+                $table->integer('duration')->nullable()->change();
+            });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        // Get the database driver
+        $driver = DB::connection()->getDriverName();
+        
+        if ($driver === 'pgsql') {
+            // PostgreSQL: Convert back to text
+            DB::statement('ALTER TABLE music ALTER COLUMN duration TYPE text USING (duration::text)');
+            
+            Schema::table('music', function (Blueprint $table) {
+                $table->string('duration')->nullable()->change();
+            });
+        } elseif ($driver === 'mysql') {
+            // MySQL: Change back to string
+            Schema::table('music', function (Blueprint $table) {
+                $table->string('duration')->nullable()->change();
+            });
+        }
+    }
+};

database/migrations/2026_05_22_200854_create_saved_items_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('saved_items', function (Blueprint $table) {
+           $table->id();
+            $table->foreignId('user_id')->constrained()->onDelete('cascade');
+            $table->morphs('saveable'); // saveable_id + saveable_type
+            $table->timestamps();
+            
+            $table->unique(['user_id', 'saveable_id', 'saveable_type']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('saved_items');
+    }
+};

database/migrations/2026_05_24_192058_create_likes_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('likes', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->onDelete('cascade');
+            $table->morphs('likeable'); 
+            $table->timestamps();
+            $table->unique(['user_id', 'likeable_id', 'likeable_type']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('likes');
+    }
+};

database/migrations/2026_05_30_100000_create_sub_categories_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('sub_categories', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('category_id')->constrained('categories')->cascadeOnDelete();
+            $table->string('name');
+            $table->timestamps();
+
+            $table->unique(['category_id', 'name']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('sub_categories');
+    }
+};

database/migrations/2026_05_30_100100_add_subcategory_id_to_media_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->unsignedBigInteger('subcategory_id')->nullable()->after('category_id');
+
+            $table->foreign('subcategory_id')->references('id')->on('sub_categories')->nullOnDelete();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->dropForeign(['subcategory_id']);
+            $table->dropColumn('subcategory_id');
+        });
+    }
+};

database/migrations/2026_05_31_100000_create_media_category_pivot_tables.php

@@ -0,0 +1,79 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('category_media', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('media_id')->constrained('media')->cascadeOnDelete();
+            $table->foreignId('category_id')->constrained('categories')->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['media_id', 'category_id']);
+        });
+
+        Schema::create('media_sub_category', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('media_id')->constrained('media')->cascadeOnDelete();
+            $table->foreignId('sub_category_id')->constrained('sub_categories')->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['media_id', 'sub_category_id']);
+        });
+
+        // Backfill the new pivots from the existing single columns.
+        if (Schema::hasColumn('media', 'category_id')) {
+            DB::table('media')
+                ->whereNotNull('category_id')
+                ->orderBy('id')
+                ->select('id', 'category_id')
+                ->chunk(200, function ($rows) {
+                    $now = now();
+                    $insert = $rows->map(fn ($row) => [
+                        'media_id' => $row->id,
+                        'category_id' => $row->category_id,
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ])->all();
+
+                    DB::table('category_media')->insertOrIgnore($insert);
+                });
+        }
+
+        if (Schema::hasColumn('media', 'subcategory_id')) {
+            DB::table('media')
+                ->whereNotNull('subcategory_id')
+                ->orderBy('id')
+                ->select('id', 'subcategory_id')
+                ->chunk(200, function ($rows) {
+                    $now = now();
+                    $insert = $rows->map(fn ($row) => [
+                        'media_id' => $row->id,
+                        'sub_category_id' => $row->subcategory_id,
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ])->all();
+
+                    DB::table('media_sub_category')->insertOrIgnore($insert);
+                });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('media_sub_category');
+        Schema::dropIfExists('category_media');
+    }
+};

database/migrations/2026_05_31_100100_drop_category_columns_from_media_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->dropForeign(['category_id']);
+            $table->dropColumn('category_id');
+
+            $table->dropForeign(['subcategory_id']);
+            $table->dropColumn('subcategory_id');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->unsignedBigInteger('category_id')->nullable()->after('image_id');
+            $table->foreign('category_id')->references('id')->on('categories')->nullOnDelete();
+
+            $table->unsignedBigInteger('subcategory_id')->nullable()->after('category_id');
+            $table->foreign('subcategory_id')->references('id')->on('sub_categories')->nullOnDelete();
+        });
+    }
+};

database/migrations/2026_05_31_110000_create_music_playlist_category_pivot_tables.php

@@ -0,0 +1,79 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('music_category_playlist', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('playlist_id')->constrained('music_playlists')->cascadeOnDelete();
+            $table->foreignId('category_id')->constrained('music_categories')->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['playlist_id', 'category_id']);
+        });
+
+        Schema::create('music_subcategory_playlist', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('playlist_id')->constrained('music_playlists')->cascadeOnDelete();
+            $table->foreignId('subcategory_id')->constrained('music_subcategories')->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['playlist_id', 'subcategory_id']);
+        });
+
+        // Backfill the new pivots from the existing single columns.
+        if (Schema::hasColumn('music_playlists', 'category_id')) {
+            DB::table('music_playlists')
+                ->whereNotNull('category_id')
+                ->orderBy('id')
+                ->select('id', 'category_id')
+                ->chunk(200, function ($rows) {
+                    $now = now();
+                    $insert = $rows->map(fn ($row) => [
+                        'playlist_id' => $row->id,
+                        'category_id' => $row->category_id,
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ])->all();
+
+                    DB::table('music_category_playlist')->insertOrIgnore($insert);
+                });
+        }
+
+        if (Schema::hasColumn('music_playlists', 'subcategory_id')) {
+            DB::table('music_playlists')
+                ->whereNotNull('subcategory_id')
+                ->orderBy('id')
+                ->select('id', 'subcategory_id')
+                ->chunk(200, function ($rows) {
+                    $now = now();
+                    $insert = $rows->map(fn ($row) => [
+                        'playlist_id' => $row->id,
+                        'subcategory_id' => $row->subcategory_id,
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ])->all();
+
+                    DB::table('music_subcategory_playlist')->insertOrIgnore($insert);
+                });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('music_subcategory_playlist');
+        Schema::dropIfExists('music_category_playlist');
+    }
+};

database/migrations/2026_05_31_110100_drop_category_columns_from_music_playlists_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('music_playlists', function (Blueprint $table) {
+            $table->dropForeign(['subcategory_id']);
+            $table->dropColumn('subcategory_id');
+
+            $table->dropForeign(['category_id']);
+            $table->dropColumn('category_id');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('music_playlists', function (Blueprint $table) {
+            $table->foreignId('category_id')->nullable()->after('id')
+                ->constrained('music_categories')->nullOnDelete();
+            $table->foreignId('subcategory_id')->nullable()->after('category_id')
+                ->constrained('music_subcategories')->nullOnDelete();
+        });
+    }
+};

database/migrations/2026_05_31_120000_create_music_playlist_pivot_table.php

@@ -0,0 +1,53 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('music_playlist', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('music_id')->constrained('music')->cascadeOnDelete();
+            $table->foreignId('playlist_id')->constrained('music_playlists')->cascadeOnDelete();
+            $table->integer('order')->default(0);
+            $table->timestamps();
+
+            $table->unique(['music_id', 'playlist_id']);
+        });
+
+        // Backfill the pivot from the existing single playlist_id column.
+        if (Schema::hasColumn('music', 'playlist_id')) {
+            DB::table('music')
+                ->whereNotNull('playlist_id')
+                ->orderBy('id')
+                ->select('id', 'playlist_id', 'order')
+                ->chunk(200, function ($rows) {
+                    $now = now();
+                    $insert = $rows->map(fn ($row) => [
+                        'music_id' => $row->id,
+                        'playlist_id' => $row->playlist_id,
+                        'order' => $row->order ?? 0,
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ])->all();
+
+                    DB::table('music_playlist')->insertOrIgnore($insert);
+                });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('music_playlist');
+    }
+};

database/migrations/2026_05_31_120100_drop_playlist_columns_from_music_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('music', function (Blueprint $table) {
+            $table->dropForeign(['playlist_id']);
+            $table->dropColumn('playlist_id');
+            $table->dropColumn('order');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('music', function (Blueprint $table) {
+            $table->foreignId('playlist_id')->nullable()->after('type')
+                ->constrained('music_playlists')->nullOnDelete();
+            $table->integer('order')->default(0)->after('duration');
+        });
+    }
+};

database/migrations/2026_06_01_100000_create_survey_questions_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('survey_questions', function (Blueprint $table) {
+            $table->id();
+            $table->string('question');
+            $table->text('description')->nullable();
+            // single = user picks exactly one option, multiple = user can pick many
+            $table->enum('type', ['single', 'multiple'])->default('single');
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('survey_questions');
+    }
+};

database/migrations/2026_06_01_100100_create_survey_options_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('survey_options', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('survey_question_id')->constrained('survey_questions')->cascadeOnDelete();
+            $table->string('label');
+            $table->string('value')->nullable(); // optional machine value
+            $table->integer('order')->default(0);
+            $table->timestamps();
+
+            $table->index(['survey_question_id', 'order']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('survey_options');
+    }
+};

database/migrations/2026_06_01_100200_create_survey_answers_table.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('survey_answers', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->foreignId('survey_question_id')->constrained('survey_questions')->cascadeOnDelete();
+            $table->foreignId('survey_option_id')->constrained('survey_options')->cascadeOnDelete();
+            $table->timestamps();
+
+            // A user can select a given option only once.
+            $table->unique(['user_id', 'survey_option_id']);
+            $table->index(['user_id', 'survey_question_id']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('survey_answers');
+    }
+};

database/migrations/2026_06_01_110000_create_survey_option_tag_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('survey_option_tag', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('survey_option_id')->constrained('survey_options')->cascadeOnDelete();
+            $table->foreignId('tag_id')->constrained('tags')->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['survey_option_id', 'tag_id']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('survey_option_tag');
+    }
+};

database/migrations/2026_06_01_120000_create_media_plays_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('media_plays', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->foreignId('media_id')->constrained('media')->cascadeOnDelete();
+            $table->unsignedInteger('play_count')->default(0);
+            $table->timestamp('last_played_at')->nullable();
+            $table->timestamps();
+
+            // One row per user + media; updated on each play.
+            $table->unique(['user_id', 'media_id']);
+            $table->index('last_played_at');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('media_plays');
+    }
+};

database/migrations/2026_06_01_130000_create_scenes_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('scenes', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('image_path')->nullable(); // scene background image
+            $table->string('video_path')->nullable(); // animated/video version of the scene
+            $table->string('sound_path')->nullable(); // scene ambient sound
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('scenes');
+    }
+};

database/migrations/2026_06_01_140000_create_user_scene_settings_table.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('user_scene_settings', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->foreignId('active_scene_id')->nullable()->constrained('scenes')->nullOnDelete();
+            $table->unsignedInteger('scene_volume')->default(100);            // صدای صحنه (0-100)
+            $table->unsignedInteger('background_play_seconds')->default(0);   // پخش صدا خارج از برنامه
+            $table->boolean('video_enabled')->default(false);                 // تبدیل صحنه به ویدیو
+            $table->timestamps();
+
+            $table->unique('user_id'); // one settings row per user
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('user_scene_settings');
+    }
+};

database/migrations/2026_06_02_100000_create_bell_sounds_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Bell sounds used for start / end / interval bells (زنگ شروع/پایان/بین‌راهی).
+        Schema::create('bell_sounds', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('sound_path')->nullable();
+            $table->string('image_path')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('bell_sounds');
+    }
+};

database/migrations/2026_06_02_100100_create_background_sounds_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Ambient background sounds (صدای پس‌زمینه).
+        Schema::create('background_sounds', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('sound_path')->nullable();
+            $table->string('image_path')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('background_sounds');
+    }
+};

database/migrations/2026_06_02_100200_create_background_images_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Background images (تصویر پس‌زمینه).
+        Schema::create('background_images', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('image_path')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('background_images');
+    }
+};

database/migrations/2026_06_02_100300_create_timer_presets_table.php

@@ -0,0 +1,46 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // A saved meditation timer (ذخیره‌شده‌های من) configured by a user.
+        Schema::create('timer_presets', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->string('name');
+            $table->unsignedInteger('duration_seconds')->default(0); // مدت زمان
+
+            // Bells
+            $table->foreignId('start_bell_id')->nullable()->constrained('bell_sounds')->nullOnDelete();
+            $table->foreignId('end_bell_id')->nullable()->constrained('bell_sounds')->nullOnDelete();
+            $table->foreignId('interval_bell_id')->nullable()->constrained('bell_sounds')->nullOnDelete();
+            $table->unsignedInteger('interval_seconds')->nullable();  // هر چند ثانیه یک‌بار
+            $table->unsignedInteger('interval_repeat')->nullable();   // تکرار چند بار
+
+            // Ambience
+            $table->foreignId('background_sound_id')->nullable()->constrained('background_sounds')->nullOnDelete();
+            $table->foreignId('background_image_id')->nullable()->constrained('background_images')->nullOnDelete();
+
+            $table->unsignedInteger('volume')->default(100); // صدای دستگاه (0-100)
+            $table->timestamps();
+
+            $table->index('user_id');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('timer_presets');
+    }
+};

database/migrations/2026_06_03_100000_use_images_for_timer_background_image.php

@@ -0,0 +1,48 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Repoint timer background image to the shared `images` table and drop the
+     * dedicated background_images catalog.
+     */
+    public function up(): void
+    {
+        Schema::table('timer_presets', function (Blueprint $table) {
+            $table->dropForeign(['background_image_id']);
+        });
+
+        Schema::dropIfExists('background_images');
+
+        Schema::table('timer_presets', function (Blueprint $table) {
+            $table->foreign('background_image_id')->references('id')->on('images')->nullOnDelete();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('timer_presets', function (Blueprint $table) {
+            $table->dropForeign(['background_image_id']);
+        });
+
+        Schema::create('background_images', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('image_path')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+
+        Schema::table('timer_presets', function (Blueprint $table) {
+            $table->foreign('background_image_id')->references('id')->on('background_images')->nullOnDelete();
+        });
+    }
+};

database/migrations/2026_06_03_110000_add_description_and_icon_to_categories_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('categories', function (Blueprint $table) {
+            $table->text('description')->nullable()->after('name');
+            $table->string('icon')->nullable()->after('description'); // stored icon image path
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('categories', function (Blueprint $table) {
+            $table->dropColumn(['description', 'icon']);
+        });
+    }
+};

database/migrations/2026_06_03_110100_add_description_to_sub_categories_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('sub_categories', function (Blueprint $table) {
+            $table->text('description')->nullable()->after('name');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('sub_categories', function (Blueprint $table) {
+            $table->dropColumn('description');
+        });
+    }
+};

database/migrations/2026_06_03_120000_create_chat_topics_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('chat_topics', function (Blueprint $table) {
+            $table->id();
+            $table->string('title');                 // chip text shown in the advisor chat
+            $table->text('description')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('chat_topics');
+    }
+};

database/migrations/2026_06_03_130000_add_detail_image_to_media_and_playlists.php

@@ -0,0 +1,41 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Add a second image reference: image_id = list/thumbnail image,
+     * detail_image_id = image shown on the detail (show-by-id) screen.
+     */
+    public function up(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->unsignedBigInteger('detail_image_id')->nullable()->after('image_id');
+            $table->foreign('detail_image_id')->references('id')->on('images')->nullOnDelete();
+        });
+
+        Schema::table('music_playlists', function (Blueprint $table) {
+            $table->unsignedBigInteger('detail_image_id')->nullable()->after('image_id');
+            $table->foreign('detail_image_id')->references('id')->on('images')->nullOnDelete();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('media', function (Blueprint $table) {
+            $table->dropForeign(['detail_image_id']);
+            $table->dropColumn('detail_image_id');
+        });
+
+        Schema::table('music_playlists', function (Blueprint $table) {
+            $table->dropForeign(['detail_image_id']);
+            $table->dropColumn('detail_image_id');
+        });
+    }
+};

database/migrations/2026_06_06_000000_add_referral_code_to_users_table.php

@@ -0,0 +1,42 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            // Own shareable code, mirrored from approagency (source of truth).
+            if (!Schema::hasColumn('users', 'referral_code')) {
+                $table->string('referral_code', 12)->nullable()->after('identifier');
+            }
+            // Local meditation user who referred this user (resolved from approagency's referrer_uuid).
+            if (!Schema::hasColumn('users', 'referred_by')) {
+                $table->foreignId('referred_by')->nullable()->after('referral_code')
+                    ->constrained('users')->nullOnDelete();
+            }
+            // Points earned through referrals (100 per invite + 10% of friends' xp).
+            if (!Schema::hasColumn('users', 'referral_points')) {
+                $table->unsignedInteger('referral_points')->default(0)->after('referred_by');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            if (Schema::hasColumn('users', 'referred_by')) {
+                $table->dropForeign(['referred_by']);
+                $table->dropColumn('referred_by');
+            }
+            foreach (['referral_code', 'referral_points'] as $column) {
+                if (Schema::hasColumn('users', $column)) {
+                    $table->dropColumn($column);
+                }
+            }
+        });
+    }
+};

database/migrations/2026_06_06_100000_create_app_feedback_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * App-level feedback (نظرات و ایده‌ها): one editable entry per user holding an
+     * overall star rating and/or an idea/comment about the application.
+     */
+    public function up(): void
+    {
+        Schema::create('app_feedback', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->unsignedTinyInteger('stars')->nullable(); // 1-5 overall rating
+            $table->text('content')->nullable();              // idea / comment
+            $table->timestamps();
+
+            $table->unique('user_id'); // one feedback row per user (edited in place)
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('app_feedback');
+    }
+};

routes/api.php

@@ -11,15 +11,26 @@
 use App\Http\Controllers\WorryController;
 use Illuminate\Support\Facades\Hash;
 use App\Http\Controllers\QuestionController;
+use App\Http\Controllers\SurveyQuestionController;
+use App\Http\Controllers\ChatTopicController;
+use App\Http\Controllers\AppFeedbackController;
 use App\Http\Controllers\SliderController;
+use App\Http\Controllers\SceneController;
+use App\Http\Controllers\BellSoundController;
+use App\Http\Controllers\BackgroundSoundController;
+use App\Http\Controllers\TimerPresetController;
 use App\Http\Controllers\ImageController;
 use App\Http\Controllers\MusicController;
 use App\Http\Controllers\MediaController;
+use App\Http\Controllers\CategoryController;
+use App\Http\Controllers\SubCategoryController;
 use App\Http\Controllers\MusicCategoryController;
 use App\Http\Controllers\MusicPlaylistController;
 use App\Http\Controllers\RatingController;
 use App\Http\Controllers\CommentController;
-
+use App\Http\Controllers\MusicSubcategoryController;
+use App\Http\Controllers\SaveController;
+use App\Http\Controllers\LikeController;
 
 Route::get('/test-hash', function() {
     $plain = 'amnk1380';
@@ -71,6 +82,9 @@
    ////-- leader board
    Route::get('/leader-board', [UserController::class, 'leaderBoard']);
 
+   ////-- referral (دعوت دوستان)
+   Route::get('/referral', [UserController::class, 'referral']);
+
     ///--  mood routes
 
      Route::post('/moods/today', [MoodController::class, 'storeUserMood']);
@@ -112,6 +126,34 @@
     Route::delete('/questions/{question}', [QuestionController::class, 'destroy']);
 
 
+    /// advisor chat — suggested topics (موضوعات پیشنهادی)
+    Route::apiResource('chat-topics', ChatTopicController::class);
+
+
+    /// app feedback — ideas & reviews (نظرات و ایده‌ها)
+    Route::get('/app-feedback', [AppFeedbackController::class, 'mine']);
+    Route::post('/app-feedback', [AppFeedbackController::class, 'store']);
+    Route::middleware('abilities:admin')->group(function () {
+        Route::get('/admin/app-feedback', [AppFeedbackController::class, 'adminIndex']);
+        Route::delete('/admin/app-feedback/{id}', [AppFeedbackController::class, 'adminDestroy']);
+    });
+
+
+    /// survey questions feature (question + description + single/multi options, answered by users)
+    // Admin: see all users' answers (must be registered before the resource so it isn't caught by {survey_question}).
+    Route::middleware('abilities:admin')->group(function () {
+        // Aggregated analytics — register before the {id} routes so "analytics" isn't read as an id.
+        Route::get('/admin/survey-questions/analytics', [SurveyQuestionController::class, 'adminAnalytics']);
+        Route::get('/admin/survey-questions/{id}/analytics', [SurveyQuestionController::class, 'adminAnalytics']);
+        Route::get('/admin/survey-questions', [SurveyQuestionController::class, 'adminIndex']);
+        Route::get('/admin/survey-questions/{id}', [SurveyQuestionController::class, 'adminShow']);
+    });
+    // User: answer + read questions with their own answers only.
+    Route::get('/survey-questions/suggested-media', [SurveyQuestionController::class, 'suggestedMedia']);
+    Route::post('/survey-questions/{id}/answer', [SurveyQuestionController::class, 'answer']);
+    Route::apiResource('survey-questions', SurveyQuestionController::class);
+
+
     /// slider feature
     // Route::get('/slider', [SliderController::class, 'index']);
 
@@ -138,15 +180,56 @@
     Route::delete('/slider/{id}', [SliderController::class, 'destroy']); // delete slider
 
 
+    /// scenes (تنظیمات صحنه) — each scene has an image, optional video, and sound
+    // Consolidated settings screen (all scenes + current user's preferences) in one call.
+    Route::get('/scene-settings', [SceneController::class, 'settings']);
+    Route::put('/scene-settings', [SceneController::class, 'updateSettings']);
+    Route::get('/scenes', [SceneController::class, 'index']);
+    Route::post('/scenes', [SceneController::class, 'store']);          // multipart: image, video, sound
+    Route::get('/scenes/{id}', [SceneController::class, 'show']);
+    Route::post('/scenes/{id}', [SceneController::class, 'update']);    // multipart update
+    Route::delete('/scenes/{id}', [SceneController::class, 'destroy']);
+
+
+    /// insight timer (زمان‌سنج)
+    // Builder catalogs (bells / background sounds / background images) in one call.
+    Route::get('/timer/options', [TimerPresetController::class, 'options']);
+
+    // Saved timers per user (ذخیره‌شده‌های من).
+    Route::get('/timer-presets', [TimerPresetController::class, 'index']);
+    Route::post('/timer-presets', [TimerPresetController::class, 'store']);
+    Route::get('/timer-presets/{id}', [TimerPresetController::class, 'show']);
+    Route::put('/timer-presets/{id}', [TimerPresetController::class, 'update']);
+    Route::delete('/timer-presets/{id}', [TimerPresetController::class, 'destroy']);
+
+    // Timer sound/image catalogs (POST update for multipart uploads).
+    Route::get('/bell-sounds', [BellSoundController::class, 'index']);
+    Route::post('/bell-sounds', [BellSoundController::class, 'store']);
+    Route::get('/bell-sounds/{id}', [BellSoundController::class, 'show']);
+    Route::post('/bell-sounds/{id}', [BellSoundController::class, 'update']);
+    Route::delete('/bell-sounds/{id}', [BellSoundController::class, 'destroy']);
+
+    Route::get('/background-sounds', [BackgroundSoundController::class, 'index']);
+    Route::post('/background-sounds', [BackgroundSoundController::class, 'store']);
+    Route::get('/background-sounds/{id}', [BackgroundSoundController::class, 'show']);
+    Route::post('/background-sounds/{id}', [BackgroundSoundController::class, 'update']);
+    Route::delete('/background-sounds/{id}', [BackgroundSoundController::class, 'destroy']);
+
+    // Background images for timers reuse the shared images catalog (see /images routes).
+
+
 
     ///media
     Route::get('/media/filters', [MediaController::class, 'filters']);
+    Route::get('/media/popular', [MediaController::class, 'popular']);
+    Route::get('/media/recently-played', [MediaController::class, 'recentlyPlayed']);
     Route::post('/media', [MediaController::class, 'store']);
     Route::get('/media', [MediaController::class, 'index']);
     Route::post('/media/{id}', [MediaController::class, 'update']);
     Route::get('/media/saved', [MediaController::class, 'saved']);
     Route::delete('/media/{id}', [MediaController::class, 'destroy']);
     Route::get('/media/{id}', [MediaController::class, 'show']);
+    Route::post('/media/{id}/play', [MediaController::class, 'recordPlay']);
     Route::post('/media/{id}/save', [MediaController::class, 'toggleSaveMedia']);
     Route::post('/media/{id}/rate', [MediaController::class, 'rate']);
     Route::post('/media/{id}/comment', [MediaController::class, 'storeComment']);
@@ -156,6 +239,15 @@
     //add note to media
     Route::post('/media/{id}/note', [MediaController::class, 'storeNote']);
 
+    // Media categories
+    // Explicit POST update so an icon image can be uploaded (multipart can't ride a PUT).
+    Route::post('categories/{id}', [CategoryController::class, 'update']);
+    Route::apiResource('categories', CategoryController::class);
+
+    // Media sub categories
+    Route::get('sub-categories/by-category/{categoryId}', [SubCategoryController::class, 'index']);
+    Route::apiResource('sub-categories', SubCategoryController::class);
+
 
 
     // Music Categories
@@ -163,9 +255,19 @@
     Route::get('public/music-categories', [MusicCategoryController::class, 'index']);
 
     // Music Playlists
+    // Explicit POST update so a playlist image can be uploaded (multipart can't ride a PUT).
+    Route::post('music-playlists/{music_playlist}', [MusicPlaylistController::class, 'update']);
     Route::apiResource('music-playlists', MusicPlaylistController::class);
     Route::get('playlists/by-category/{categoryId}', [MusicPlaylistController::class, 'index']);
 
+    // Subcategory routes
+    Route::apiResource('music-subcategories', MusicSubcategoryController::class);
+    Route::get('subcategories/by-category/{categoryId}', [MusicSubcategoryController::class, 'index']);
+
+
+    // Music Routes - Add this line before your other routes
+    Route::get('music/all', [MusicController::class, 'getAllMusic']); // For old app compatibility
+
     // Music
     Route::get('music/playlist/{playlistId}', [MusicController::class, 'getMusicByPlaylist']);
     Route::post('music/{musicId}/add-to-playlist', [MusicController::class, 'addToPlaylist']);
@@ -174,6 +276,7 @@
     Route::apiResource('music', MusicController::class);
 
     
+
     // Generic Rating Routes (works for both music and media)
     Route::prefix('ratings')->group(function () {
     Route::post('{type}/{id}', [RatingController::class, 'rate']);
@@ -191,4 +294,25 @@
         Route::delete('{type}/{id}/{commentId}', [CommentController::class, 'deleteComment']);
         Route::get('most/{type}', [CommentController::class, 'mostCommented']);
     });
+
+
+    // Save routes (works for all models)
+    Route::prefix('saves')->group(function () {
+        Route::post('/save', [SaveController::class, 'save']);
+        Route::post('/unsave', [SaveController::class, 'unsave']);
+        Route::post('/toggle', [SaveController::class, 'toggleSave']);
+        Route::get('/my-saved', [SaveController::class, 'mySavedItems']);
+        Route::post('/check', [SaveController::class, 'checkSaved']);
+    });
+
+
+    // Like routes (only for music and media)
+    Route::prefix('likes')->group(function () {
+        Route::post('/like', [LikeController::class, 'like']);
+        Route::post('/unlike', [LikeController::class, 'unlike']);
+        Route::post('/toggle', [LikeController::class, 'toggleLike']);
+        Route::get('/my-liked', [LikeController::class, 'myLikedItems']);
+        Route::post('/check', [LikeController::class, 'checkLiked']);
+        Route::get('/top-liked', [LikeController::class, 'topLiked']);
+    });
   });