feat: add description to breathing template

app/Http/Controllers/BreathingExerciseController.php

@@ -16,7 +16,8 @@ public function createTemplate(Request $request)
             'inhale' => 'required|integer|min:1',
             'exhale' => 'required|integer|min:1',
             'breath_hold' => 'required|integer|min:0',
-            'duration' => 'sometimes|integer|min:10'
+            'duration' => 'sometimes|integer|min:10',
+            'description' => 'sometimes|string'
         ]);
 
         $template = BreathingTemplate::create([
@@ -26,6 +27,7 @@ public function createTemplate(Request $request)
             'exhale' => $data['exhale'],
             'breath_hold'=> $data['breath_hold'] ?? 0,
             'duration'=> $data['duration'] ?? 60,
+            'description' => $data['description']
         ]);
 
         return response()->json(['message' => 'Template created', 'template' => $template]);
@@ -43,6 +45,7 @@ public function updateTemplate(Request $request, $id)
         'exhale' => 'sometimes|required|integer|min:1',
         'breath_hold' => 'sometimes|integer|min:0',
         'duration' => 'sometimes|integer|min:10',
+        'description' => 'sometimes|string'
     ]);
 
     $template->update($data);

app/Models/BreathingTemplate.php

@@ -6,7 +6,7 @@
 
 class BreathingTemplate extends Model
 {
-    protected $fillable = ['user_id', 'name', 'inhale', 'exhale', 'breath_hold' , 'duration'];
+    protected $fillable = ['user_id', 'name', 'inhale', 'exhale', 'breath_hold' , 'duration' , 'description'];
 
     public function user()
     {

database/migrations/2025_09_14_081020_update_breathing_template_add_description.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('breathing_templates', function (Blueprint $table) {
+            $table->text('description')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('breathing_templates', function (Blueprint $table) {
+            $table->dropColumn('description');
+        });
+    }
+};

database/seeders/BreathingTemplateSeeder.php

@@ -5,6 +5,7 @@
 use Illuminate\Database\Seeder;
 use App\Models\BreathingTemplate;
 use Illuminate\Support\Facades\DB;
+
 class BreathingTemplateSeeder extends Seeder
 {
     public function run(): void
@@ -18,76 +19,87 @@ public function run(): void
         } elseif ($driver === 'pgsql') {
             DB::statement('ALTER SEQUENCE breathing_templates_id_seq RESTART WITH 1');
         }
+
         $templates = [
             [
                 'name' => '۴-۷-۸ تنفس آرام',
                 'inhale' => 4,
                 'exhale' => 8,
                 'breath_hold' => 7,
-                'duration' => 60
+                'duration' => 60,
+                'description' => "این روش تنفس یکی از معروف‌ترین تکنیک‌ها برای آرام‌سازی ذهن و بدن است. شما با چهار ثانیه دم، هفت ثانیه حبس نفس و هشت ثانیه بازدم، ریتم طبیعی بدن را به حالت تعادل بازمی‌گردانید.\n\nتمرین ۴-۷-۸ معمولاً برای کاهش استرس و آماده‌سازی برای خواب عمیق توصیه می‌شود. اجرای منظم آن به مرور سیستم عصبی را آرام می‌کند و کیفیت خواب را افزایش می‌دهد.",
             ],
             [
                 'name' => 'تنفس جعبه‌ای (Box Breathing)',
                 'inhale' => 4,
                 'exhale' => 4,
                 'breath_hold' => 4,
-                'duration' => 60
+                'duration' => 60,
+                'description' => "تنفس جعبه‌ای با الگوی چهار ثانیه دم، چهار ثانیه حبس، چهار ثانیه بازدم و چهار ثانیه مکث شناخته می‌شود. این روش معمولاً توسط ورزشکاران و نیروهای نظامی برای حفظ تمرکز استفاده می‌شود.\n\nاجرای این تمرین باعث افزایش اکسیژن‌رسانی، بهبود تمرکز ذهنی و کاهش اضطراب در شرایط پراسترس می‌شود.",
             ],
             [
                 'name' => 'تنفس هماهنگ (Coherent Breathing)',
                 'inhale' => 5,
                 'exhale' => 5,
                 'breath_hold' => 0,
-                'duration' => 60
+                'duration' => 60,
+                'description' => "در این تکنیک، دم و بازدم هر دو پنج ثانیه طول می‌کشد و ریتم تنفس با ضربان قلب هماهنگ می‌شود. این هماهنگی، آرامش عمیقی در بدن ایجاد می‌کند.\n\nتمرین تنفس هماهنگ به بهبود ضربان قلب، کاهش استرس و افزایش احساس آرامش عمومی کمک می‌کند.",
             ],
             [
                 'name' => 'تنفس آرام عمیق',
                 'inhale' => 6,
                 'exhale' => 6,
                 'breath_hold' => 0,
-                'duration' => 90
+                'duration' => 90,
+                'description' => "تنفس عمیق با دم و بازدم طولانی به بدن کمک می‌کند اکسیژن بیشتری دریافت کند و سموم بیشتری دفع کند. این روش به ویژه برای آرام‌سازی قبل از خواب مناسب است.\n\nاجرای مداوم این تمرین باعث بهبود عملکرد ریه‌ها، آرامش ذهن و کاهش فشار خون می‌شود.",
             ],
             [
                 'name' => 'تنفس تمرکزی ساده',
                 'inhale' => 4,
                 'exhale' => 4,
                 'breath_hold' => 0,
-                'duration' => 60
+                'duration' => 60,
+                'description' => "این تمرین ساده با دم و بازدم مساوی طراحی شده تا تمرکز ذهنی را افزایش دهد. برای شروع تمرین‌های مدیتیشن یا یوگا بسیار مناسب است.\n\nبا انجام مداوم، ذهن شما کمتر به افکار مزاحم مشغول می‌شود و توانایی تمرکزتان به مرور زمان تقویت خواهد شد.",
             ],
             [
                 'name' => 'تنفس برای کاهش استرس',
                 'inhale' => 5,
                 'exhale' => 7,
                 'breath_hold' => 0,
-                'duration' => 120
+                'duration' => 120,
+                'description' => "این تکنیک با بازدم طولانی‌تر نسبت به دم طراحی شده است تا سیستم عصبی پاراسمپاتیک فعال شود. همین موضوع باعث آرامش و کاهش اضطراب می‌شود.\n\nتنفس کاهش استرس برای مواقعی که در شرایط پراسترس یا عصبی قرار دارید بسیار کاربردی و موثر است.",
             ],
             [
                 'name' => 'تنفس پاکسازی',
                 'inhale' => 3,
                 'exhale' => 5,
                 'breath_hold' => 0,
-                'duration' => 60
+                'duration' => 60,
+                'description' => "در این تمرین، بازدم طولانی‌تر از دم است تا بدن بتواند دی‌اکسیدکربن و سموم بیشتری دفع کند. این روش به‌خصوص بعد از فعالیت‌های سنگین بدنی مفید است.\n\nبا ادامه‌ی تمرین، حس سبکی و شادابی در بدن ایجاد می‌شود و انرژی تازه‌ای به شما بازمی‌گردد.",
             ],
             [
                 'name' => 'تنفس ذهنی کوتاه',
                 'inhale' => 4,
                 'exhale' => 4,
                 'breath_hold' => 0,
-                'duration' => 30
+                'duration' => 30,
+                'description' => "این تکنیک کوتاه برای مواقعی طراحی شده که زمان کافی ندارید اما نیاز به آرامش سریع دارید. دم و بازدم مساوی ذهن شما را در لحظه حال نگه می‌دارد.\n\nتمرین مداوم حتی در بازه‌های کوتاه به شما کمک می‌کند تمرکز بیشتری داشته باشید و استرس روزانه را کاهش دهید.",
             ],
             [
                 'name' => 'تنفس خواب‌آور ۴-۷-۸',
                 'inhale' => 4,
                 'exhale' => 8,
                 'breath_hold' => 7,
-                'duration' => 120
+                'duration' => 120,
+                'description' => "نسخه خواب‌آور تکنیک ۴-۷-۸ برای آماده‌سازی بدن قبل از خواب استفاده می‌شود. با طولانی‌تر شدن مدت زمان تمرین، بدن آرام‌تر و ذهن خاموش‌تر می‌شود.\n\nاین روش برای کسانی که مشکل بی‌خوابی یا خواب سبک دارند بسیار مفید است و به کیفیت خواب کمک می‌کند.",
             ],
             [
                 'name' => 'تنفس تجدید انرژی',
                 'inhale' => 2,
                 'exhale' => 4,
                 'breath_hold' => 0,
-                'duration' => 45
+                'duration' => 45,
+                'description' => "این تکنیک با دم کوتاه و بازدم کمی طولانی‌تر، بدن را به سرعت شارژ می‌کند و سطح انرژی را بالا می‌برد. برای شروع روز یا بعد از خستگی توصیه می‌شود.\n\nاجرای آن باعث افزایش هوشیاری ذهنی، بهبود خلق‌وخو و آماده‌سازی بدن برای فعالیت‌های روزانه خواهد شد.",
             ],
         ];