From ca30919f642990916e94ccb94725e888f9f315c1 Mon Sep 17 00:00:00 2001
From: Amirmahdi Nourkazemi <nourkazemi80@gmail.com>
Date: Sun, 14 Sep 2025 12:12:52 +0330
Subject: [PATCH] feat: add description to breathing template

---
 .../BreathingExerciseController.php           |   5 +-
 app/Models/BreathingTemplate.php              |   2 +-
 ...ate_breathing_template_add_description.php |  28 +++++
 database/seeders/BreathingTemplateSeeder.php  | 114 ++++++++++--------
 4 files changed, 96 insertions(+), 53 deletions(-)
 create mode 100644 database/migrations/2025_09_14_081020_update_breathing_template_add_description.php

diff --git a/app/Http/Controllers/BreathingExerciseController.php b/app/Http/Controllers/BreathingExerciseController.php
index eb45810..f9dfdc4 100644
--- a/app/Http/Controllers/BreathingExerciseController.php
+++ b/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);
diff --git a/app/Models/BreathingTemplate.php b/app/Models/BreathingTemplate.php
index 4cdd1dd..bc2c578 100644
--- a/app/Models/BreathingTemplate.php
+++ b/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()
     {
diff --git a/database/migrations/2025_09_14_081020_update_breathing_template_add_description.php b/database/migrations/2025_09_14_081020_update_breathing_template_add_description.php
new file mode 100644
index 0000000..30a1327
--- /dev/null
+++ b/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');
+        });
+    }
+};
diff --git a/database/seeders/BreathingTemplateSeeder.php b/database/seeders/BreathingTemplateSeeder.php
index 7fa5cf9..6a1ef5a 100644
--- a/database/seeders/BreathingTemplateSeeder.php
+++ b/database/seeders/BreathingTemplateSeeder.php
@@ -4,7 +4,8 @@
 
 use Illuminate\Database\Seeder;
 use App\Models\BreathingTemplate;
-use  Illuminate\Support\Facades\DB;
+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
+                'name' => '۴-۷-۸ تنفس آرام',
+                'inhale' => 4,
+                'exhale' => 8,
+                'breath_hold' => 7,
+                'duration' => 60,
+                'description' => "این روش تنفس یکی از معروف‌ترین تکنیک‌ها برای آرام‌سازی ذهن و بدن است. شما با چهار ثانیه دم، هفت ثانیه حبس نفس و هشت ثانیه بازدم، ریتم طبیعی بدن را به حالت تعادل بازمی‌گردانید.\n\nتمرین ۴-۷-۸ معمولاً برای کاهش استرس و آماده‌سازی برای خواب عمیق توصیه می‌شود. اجرای منظم آن به مرور سیستم عصبی را آرام می‌کند و کیفیت خواب را افزایش می‌دهد.",
             ],
             [
-                'name' => 'تنفس جعبه‌ای (Box Breathing)', 
-                'inhale' => 4, 
-                'exhale' => 4, 
-                'breath_hold' => 4, 
-                'duration' => 60
+                'name' => 'تنفس جعبه‌ای (Box Breathing)',
+                'inhale' => 4,
+                'exhale' => 4,
+                'breath_hold' => 4,
+                'duration' => 60,
+                'description' => "تنفس جعبه‌ای با الگوی چهار ثانیه دم، چهار ثانیه حبس، چهار ثانیه بازدم و چهار ثانیه مکث شناخته می‌شود. این روش معمولاً توسط ورزشکاران و نیروهای نظامی برای حفظ تمرکز استفاده می‌شود.\n\nاجرای این تمرین باعث افزایش اکسیژن‌رسانی، بهبود تمرکز ذهنی و کاهش اضطراب در شرایط پراسترس می‌شود.",
             ],
             [
-                'name' => 'تنفس هماهنگ (Coherent Breathing)', 
-                'inhale' => 5, 
-                'exhale' => 5, 
-                'breath_hold' => 0, 
-                'duration' => 60
+                'name' => 'تنفس هماهنگ (Coherent Breathing)',
+                'inhale' => 5,
+                'exhale' => 5,
+                'breath_hold' => 0,
+                'duration' => 60,
+                'description' => "در این تکنیک، دم و بازدم هر دو پنج ثانیه طول می‌کشد و ریتم تنفس با ضربان قلب هماهنگ می‌شود. این هماهنگی، آرامش عمیقی در بدن ایجاد می‌کند.\n\nتمرین تنفس هماهنگ به بهبود ضربان قلب، کاهش استرس و افزایش احساس آرامش عمومی کمک می‌کند.",
             ],
             [
-                'name' => 'تنفس آرام عمیق', 
-                'inhale' => 6, 
-                'exhale' => 6, 
-                'breath_hold' => 0, 
-                'duration' => 90
+                'name' => 'تنفس آرام عمیق',
+                'inhale' => 6,
+                'exhale' => 6,
+                'breath_hold' => 0,
+                'duration' => 90,
+                'description' => "تنفس عمیق با دم و بازدم طولانی به بدن کمک می‌کند اکسیژن بیشتری دریافت کند و سموم بیشتری دفع کند. این روش به ویژه برای آرام‌سازی قبل از خواب مناسب است.\n\nاجرای مداوم این تمرین باعث بهبود عملکرد ریه‌ها، آرامش ذهن و کاهش فشار خون می‌شود.",
             ],
             [
-                'name' => 'تنفس تمرکزی ساده', 
-                'inhale' => 4, 
-                'exhale' => 4, 
-                'breath_hold' => 0, 
-                'duration' => 60
+                'name' => 'تنفس تمرکزی ساده',
+                'inhale' => 4,
+                'exhale' => 4,
+                'breath_hold' => 0,
+                'duration' => 60,
+                'description' => "این تمرین ساده با دم و بازدم مساوی طراحی شده تا تمرکز ذهنی را افزایش دهد. برای شروع تمرین‌های مدیتیشن یا یوگا بسیار مناسب است.\n\nبا انجام مداوم، ذهن شما کمتر به افکار مزاحم مشغول می‌شود و توانایی تمرکزتان به مرور زمان تقویت خواهد شد.",
             ],
             [
-                'name' => 'تنفس برای کاهش استرس', 
-                'inhale' => 5, 
-                'exhale' => 7, 
-                'breath_hold' => 0, 
-                'duration' => 120
+                'name' => 'تنفس برای کاهش استرس',
+                'inhale' => 5,
+                'exhale' => 7,
+                'breath_hold' => 0,
+                'duration' => 120,
+                'description' => "این تکنیک با بازدم طولانی‌تر نسبت به دم طراحی شده است تا سیستم عصبی پاراسمپاتیک فعال شود. همین موضوع باعث آرامش و کاهش اضطراب می‌شود.\n\nتنفس کاهش استرس برای مواقعی که در شرایط پراسترس یا عصبی قرار دارید بسیار کاربردی و موثر است.",
             ],
             [
-                'name' => 'تنفس پاکسازی', 
-                'inhale' => 3, 
-                'exhale' => 5, 
-                'breath_hold' => 0, 
-                'duration' => 60
+                'name' => 'تنفس پاکسازی',
+                'inhale' => 3,
+                'exhale' => 5,
+                'breath_hold' => 0,
+                'duration' => 60,
+                'description' => "در این تمرین، بازدم طولانی‌تر از دم است تا بدن بتواند دی‌اکسیدکربن و سموم بیشتری دفع کند. این روش به‌خصوص بعد از فعالیت‌های سنگین بدنی مفید است.\n\nبا ادامه‌ی تمرین، حس سبکی و شادابی در بدن ایجاد می‌شود و انرژی تازه‌ای به شما بازمی‌گردد.",
             ],
             [
-                'name' => 'تنفس ذهنی کوتاه', 
-                'inhale' => 4, 
-                'exhale' => 4, 
-                'breath_hold' => 0, 
-                'duration' => 30
+                'name' => 'تنفس ذهنی کوتاه',
+                'inhale' => 4,
+                'exhale' => 4,
+                'breath_hold' => 0,
+                'duration' => 30,
+                'description' => "این تکنیک کوتاه برای مواقعی طراحی شده که زمان کافی ندارید اما نیاز به آرامش سریع دارید. دم و بازدم مساوی ذهن شما را در لحظه حال نگه می‌دارد.\n\nتمرین مداوم حتی در بازه‌های کوتاه به شما کمک می‌کند تمرکز بیشتری داشته باشید و استرس روزانه را کاهش دهید.",
             ],
             [
-                'name' => 'تنفس خواب‌آور ۴-۷-۸', 
-                'inhale' => 4, 
-                'exhale' => 8, 
-                'breath_hold' => 7, 
-                'duration' => 120
+                'name' => 'تنفس خواب‌آور ۴-۷-۸',
+                'inhale' => 4,
+                'exhale' => 8,
+                'breath_hold' => 7,
+                'duration' => 120,
+                'description' => "نسخه خواب‌آور تکنیک ۴-۷-۸ برای آماده‌سازی بدن قبل از خواب استفاده می‌شود. با طولانی‌تر شدن مدت زمان تمرین، بدن آرام‌تر و ذهن خاموش‌تر می‌شود.\n\nاین روش برای کسانی که مشکل بی‌خوابی یا خواب سبک دارند بسیار مفید است و به کیفیت خواب کمک می‌کند.",
             ],
             [
-                'name' => 'تنفس تجدید انرژی', 
-                'inhale' => 2, 
-                'exhale' => 4, 
-                'breath_hold' => 0, 
-                'duration' => 45
+                'name' => 'تنفس تجدید انرژی',
+                'inhale' => 2,
+                'exhale' => 4,
+                'breath_hold' => 0,
+                'duration' => 45,
+                'description' => "این تکنیک با دم کوتاه و بازدم کمی طولانی‌تر، بدن را به سرعت شارژ می‌کند و سطح انرژی را بالا می‌برد. برای شروع روز یا بعد از خستگی توصیه می‌شود.\n\nاجرای آن باعث افزایش هوشیاری ذهنی، بهبود خلق‌وخو و آماده‌سازی بدن برای فعالیت‌های روزانه خواهد شد.",
             ],
         ];