From 4f0792fe67bb2479afe915e8f0df97b07200b36f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vinicius=20Reis=20Gon=C3=A7alves?= <vinireisg@usp.br>
Date: Fri, 27 Mar 2026 14:51:09 -0300
Subject: [PATCH 1/7] =?UTF-8?q?Mudan=C3=A7a=20no=20workspace=20local?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 composer.json | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/composer.json b/composer.json
index c2d50339..3ebbf885 100644
--- a/composer.json
+++ b/composer.json
@@ -22,7 +22,7 @@
     "require": {
         "php": "^8.2",
         "illuminate/support": "^11.0",
-        "uspdev/forms": "^0.6",
+        "uspdev/forms": "*",
         "spatie/laravel-activitylog": "^4.9",
         "spatie/laravel-permission": "^6.15",
         "symfony/workflow": "^7.1",
@@ -36,5 +36,13 @@
                 "Uspdev\\Workflow\\WorkflowServiceProvider"
             ]
         }
-    }
-}
+    },
+    "repositories":
+    [
+        {
+            "type": "path",
+            "url": "../forms",
+            "options": {"symlink": true}
+        }
+    ]
+}
\ No newline at end of file

From 617b77ec5694eb6ace80193227ad33286abf3fd0 Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Fri, 10 Apr 2026 14:04:50 -0300
Subject: [PATCH 2/7] Iniciando o trabalho para gerar e manter backups dos
 workflows
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Começando a mover a lógca de controlador da aplicação para a biblioteca.
Arquivos de route, diretórios de Http, Console, etc. criados
Alguns métodos simples como geração do backup para cada definição e também
	geração de backups globais já foram immplementados (falta testar).
---
 composer.json                                 | 10 +++-
 config/workflow.php                           |  4 +-
 resources/views/show/list-bckps.blade.php     | 54 +++++++++++++++++++
 resources/views/show/list-defs.blade.php      | 47 ++++++++++++++++
 .../views/show/partials/edit-btn.blade.php    |  5 ++
 resources/views/show/partials/tabs.blade.php  |  8 +++
 routes/web.php                                | 11 ++++
 src/Console/Commands/WorfklowSync.php         | 29 ++++++++++
 .../Controllers/WorkflowBackupController.php  | 54 +++++++++++++++++++
 src/WorkflowServiceProvider.php               |  4 ++
 10 files changed, 224 insertions(+), 2 deletions(-)
 create mode 100644 resources/views/show/list-bckps.blade.php
 create mode 100644 resources/views/show/list-defs.blade.php
 create mode 100644 resources/views/show/partials/edit-btn.blade.php
 create mode 100644 resources/views/show/partials/tabs.blade.php
 create mode 100644 routes/web.php
 create mode 100644 src/Console/Commands/WorfklowSync.php
 create mode 100644 src/Http/Controllers/WorkflowBackupController.php

diff --git a/composer.json b/composer.json
index c2d50339..6019ffd7 100644
--- a/composer.json
+++ b/composer.json
@@ -22,7 +22,7 @@
     "require": {
         "php": "^8.2",
         "illuminate/support": "^11.0",
-        "uspdev/forms": "^0.6",
+        "uspdev/forms": "*",
         "spatie/laravel-activitylog": "^4.9",
         "spatie/laravel-permission": "^6.15",
         "symfony/workflow": "^7.1",
@@ -30,6 +30,14 @@
         "graphp/graph": "^1@dev",
         "graphp/graphviz": "1.x-dev"
     },
+    "repositories":
+    [
+        {
+            "type": "path",
+            "url": "../forms",
+            "options":{"symlink": true}
+        }
+    ],
     "extra": {
         "laravel": {
             "providers": [
diff --git a/config/workflow.php b/config/workflow.php
index a508df11..a8b282b5 100644
--- a/config/workflow.php
+++ b/config/workflow.php
@@ -3,5 +3,7 @@
 // Caminho de armazenamento das definições de workflow
 // Pega do .env, na variável WORKFLOW_STORAGE_PATH, mas usa 'storage/app/workflow-definitions' como caminho default
 return [
-    'storagePath' => env('WORKFLOW_STORAGE_PATH', storage_path('app/workflow-definitions')),
+    'storagePath' => env('WORKFLOW_STORAGE_PATH', storage_path('app/workflowsJson')),
+    
+    'prefix' => 'uspdev-workflow',
 ];
diff --git a/resources/views/show/list-bckps.blade.php b/resources/views/show/list-bckps.blade.php
new file mode 100644
index 00000000..0f1fd44f
--- /dev/null
+++ b/resources/views/show/list-bckps.blade.php
@@ -0,0 +1,54 @@
+@extends('uspdev-forms::layouts.app')
+
+@section('header')
+@endsection
+
+@section('content')
+
+<div class="col-2">@include('uspdev-workflow::show.partials.tabs')</div>
+<div class="card">
+    <div class="card-header h4 card-header-sticky d-flex justify-content-between align-items-center">
+      <div>
+        <span class="text-danger">USPdev workflow</span> >
+        Backups
+      </div>
+      <div>
+        @include('uspdev-forms::partials.ajuda-modal')
+      </div>
+    </div>
+    <div class="card-body">
+      <table class="table table-bordered table-hover">
+        <thead>
+          <tr>
+            <th>Nome</th>
+            <th>Descrição</th>
+            <th>Ações</th>
+          </tr>
+        </thead>
+        <tbody>
+          @foreach ($workflowDefinitions as $workflowDefinition)
+            <tr>
+              <td>
+                {{ $workflowDefinition->name }}
+                <span class="badge badge-warning badge-pill" title="Backups existentes">
+                  {{-- 
+                    Verifica se o diretório que guarda os formulários existe.
+                    Caso exista, exibe o número de backups do formulário existem dentro dele.
+                    Senão, mostra 0.
+                  --}}
+                  {{ is_dir(config('uspdev-forms.forms_storage_dir')) ? count(array_filter(scandir(config('uspdev-forms.forms_storage_dir')), fn($filename) => str_contains($filename,$workflowDefinition->name))) : 0 }}
+                </span>
+              </td>
+              <td>
+                {{ $workflowDefinition->description }}
+              </td>
+              <td class="d-flex justify-content-start">
+                @include('uspdev-workflow::show.partials.edit-btn')
+              </td>
+            </tr>
+          @endforeach
+        </tbody>
+      </table>
+    </div>
+  </div>
+@endsection
diff --git a/resources/views/show/list-defs.blade.php b/resources/views/show/list-defs.blade.php
new file mode 100644
index 00000000..1b86a28f
--- /dev/null
+++ b/resources/views/show/list-defs.blade.php
@@ -0,0 +1,47 @@
+@extends('uspdev-forms::layouts.app')
+
+@section('header')
+@endsection
+
+@section('content')
+
+<div class="col-2">@include('uspdev-workflow::show.partials.tabs')</div>
+<div class="card">
+    <div class="card-header h4 card-header-sticky d-flex justify-content-between align-items-center">
+      <div>
+        <span class="text-danger">USPdev workflow</span> >
+        Definições
+        <a href="{{ route('workflows.create-definition') }}" class="btn btn-sm btn-primary">Nova Definição</a>
+      </div>
+      <div>
+        @include('uspdev-forms::partials.ajuda-modal')
+      </div>
+    </div>
+    <div class="card-body">
+      <table class="table table-bordered table-hover">
+        <thead>
+          <tr>
+            <th>Nome</th>
+            <th>Descrição</th>
+            <th>Ações</th>
+          </tr>
+        </thead>
+        <tbody>
+          @foreach ($workflowDefinitions as $workflowDefinition)
+            <tr>
+              <td>
+                {{ $workflowDefinition->name }}
+              </td>
+              <td>
+                {{ $workflowDefinition->description }}
+              </td>
+              <td class="d-flex justify-content-start">
+                @include('uspdev-workflow::show.partials.edit-btn')
+              </td>
+            </tr>
+          @endforeach
+        </tbody>
+      </table>
+    </div>
+  </div>
+@endsection
diff --git a/resources/views/show/partials/edit-btn.blade.php b/resources/views/show/partials/edit-btn.blade.php
new file mode 100644
index 00000000..cbee075f
--- /dev/null
+++ b/resources/views/show/partials/edit-btn.blade.php
@@ -0,0 +1,5 @@
+<div>
+  <a href="{{ route('workflows.editDefinition', $workflowDefinition->name) }}" class="btn btn-sm btn-warning ml-2">
+    Editar
+  </a>
+</div>
\ No newline at end of file
diff --git a/resources/views/show/partials/tabs.blade.php b/resources/views/show/partials/tabs.blade.php
new file mode 100644
index 00000000..06c59dcd
--- /dev/null
+++ b/resources/views/show/partials/tabs.blade.php
@@ -0,0 +1,8 @@
+<ul class="nav nav-tabs">
+  <li class="nav-item">
+    <a class="nav-link {{ $activeTab == 'index' ? 'active':'' }}" href="{{ route('workflows.list-definitions') }}">Definitions</a>
+  </li>
+  <li class="nav-item">
+    <a class="nav-link {{ $activeTab == 'backup' ? 'active':'' }}" href="{{ route('workflows.backups-idx') }}">Backup</a>
+  </li>
+<br>
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
new file mode 100644
index 00000000..24214d6e
--- /dev/null
+++ b/routes/web.php
@@ -0,0 +1,11 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Uspdev\Workflow\Http\Controllers\WorkflowBackupController;
+
+Route::group(['prefix' => config('workflow.prefix'), 'middleware' => ['web']], function () {
+
+    Route::get('/backups', [WorkflowBackupController::class, 'backups_index'])->name('workflows.backups-idx');
+    Route::get('/backups/gen-backups', [WorkflowBackupController::class, 'bckp_gen_all'])->name('workflows.gen-all-backups');
+    Route::get('/backups/{wrkflw_def}/gen-backup', [WorkflowBackupController::class, 'def_bckp_gen'])->name('workflows.gen-backup');
+});
\ No newline at end of file
diff --git a/src/Console/Commands/WorfklowSync.php b/src/Console/Commands/WorfklowSync.php
new file mode 100644
index 00000000..878938f2
--- /dev/null
+++ b/src/Console/Commands/WorfklowSync.php
@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+
+class WorfklowSync extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'workflow:sync';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Command description';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle()
+    {
+    }
+}
diff --git a/src/Http/Controllers/WorkflowBackupController.php b/src/Http/Controllers/WorkflowBackupController.php
new file mode 100644
index 00000000..0ed7ea7a
--- /dev/null
+++ b/src/Http/Controllers/WorkflowBackupController.php
@@ -0,0 +1,54 @@
+<?php
+
+namespace Uspdev\Workflow\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Exception;
+use Uspdev\Workflow\Models\WorkflowDefinition;
+
+class WorkflowBackupController extends Controller
+{
+
+    public function backups_index()
+    {
+        $workflowDefinitions = WorkflowDefinition::all();
+
+        return view('uspdev-workflow::show.list-bckps', ['workflowDefinitions' => $workflowDefinitions, 'activeTab' => 'backup']);
+    }
+
+    public function def_bckp_gen(WorkflowDefinition $wrkflw_def)
+    {
+        $file_dir = config('workflow.storagePath');
+        if(!is_dir($file_dir))
+        {
+            mkdir($file_dir,0777);
+        }
+
+        $file_path = $file_dir . '/' . $wrkflw_def['name'] . '@' . now()->format('d-m-Y_H:i:s') . '.json';
+
+        try
+        {
+            $json_file = fopen($file_path,'w');
+        }
+        catch(Exception $e)
+        {
+            print("Erro ao abrir arquivo: " . $e);
+            return;
+        }
+
+        $json_encoded = json_encode($wrkflw_def->definition,JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+
+        fwrite($json_file,$json_encoded);
+
+        fclose($json_file);
+    }
+
+    public function bckp_gen_all()
+    {
+        $wrkflw_defs = WorkflowDefinition::all();
+        foreach($wrkflw_defs as $wrkflow_def)
+        {
+            $this->def_bckp_gen($wrkflow_def);
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/WorkflowServiceProvider.php b/src/WorkflowServiceProvider.php
index 9178a5c6..908160d4 100644
--- a/src/WorkflowServiceProvider.php
+++ b/src/WorkflowServiceProvider.php
@@ -22,6 +22,10 @@ public function boot()
             __DIR__ . '/../database/migrations/' => database_path('migrations'),
         ], 'workflow-migrations');
 
+        $this->loadViewsFrom(__DIR__ . '/../resources/views','uspdev-workflow');
+
+        $this->loadRoutesFrom(__DIR__.'/../routes/web.php');
+
         // Load migrations
         // $this->loadMigrationsFrom(__DIR__ . '/../database/migrations');
     }

From 027461fe56b60189dedc739651b37e587e683e7d Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Fri, 10 Apr 2026 21:24:48 -0300
Subject: [PATCH 3/7] Arquivos de view adicionados
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Mesma lógica do forms (arquivos copiados diretamente), portanto falta adpatar para
a lógica do workflow.
---
 resources/views/show/list-bckps.blade.php                    | 2 +-
 resources/views/show/partials/bckpgen-btn.blade.php          | 5 +++++
 resources/views/show/partials/bckplist-btn.blade.php         | 3 +++
 resources/views/show/partials/bckpremove-btn.blade.php       | 3 +++
 resources/views/show/partials/bckpremoveall-btn.blade.php    | 3 +++
 resources/views/show/partials/defbckpremoveall-btn.blade.php | 3 +++
 resources/views/show/partials/globalbckp-btn.blade.php       | 3 +++
 resources/views/show/partials/restore-btn.blade.php          | 5 +++++
 8 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 resources/views/show/partials/bckpgen-btn.blade.php
 create mode 100644 resources/views/show/partials/bckplist-btn.blade.php
 create mode 100644 resources/views/show/partials/bckpremove-btn.blade.php
 create mode 100644 resources/views/show/partials/bckpremoveall-btn.blade.php
 create mode 100644 resources/views/show/partials/defbckpremoveall-btn.blade.php
 create mode 100644 resources/views/show/partials/globalbckp-btn.blade.php
 create mode 100644 resources/views/show/partials/restore-btn.blade.php

diff --git a/resources/views/show/list-bckps.blade.php b/resources/views/show/list-bckps.blade.php
index 0f1fd44f..66f0892f 100644
--- a/resources/views/show/list-bckps.blade.php
+++ b/resources/views/show/list-bckps.blade.php
@@ -36,7 +36,7 @@
                     Caso exista, exibe o número de backups do formulário existem dentro dele.
                     Senão, mostra 0.
                   --}}
-                  {{ is_dir(config('uspdev-forms.forms_storage_dir')) ? count(array_filter(scandir(config('uspdev-forms.forms_storage_dir')), fn($filename) => str_contains($filename,$workflowDefinition->name))) : 0 }}
+                  {{ is_dir(config('uspdev-workflow.storagePath')) ? count(array_filter(scandir(config('uspdev-workflow.storagePath')), fn($filename) => str_contains($filename,$workflowDefinition->name))) : 0 }}
                 </span>
               </td>
               <td>
diff --git a/resources/views/show/partials/bckpgen-btn.blade.php b/resources/views/show/partials/bckpgen-btn.blade.php
new file mode 100644
index 00000000..fb572ccc
--- /dev/null
+++ b/resources/views/show/partials/bckpgen-btn.blade.php
@@ -0,0 +1,5 @@
+<div>
+  <a href="{{ route('form-definitions.backup-def',  $formDefinition) }}" class="btn btn-sm btn-info ml-2">
+    Gerar backup
+  </a>
+</div>
\ No newline at end of file
diff --git a/resources/views/show/partials/bckplist-btn.blade.php b/resources/views/show/partials/bckplist-btn.blade.php
new file mode 100644
index 00000000..b15649f2
--- /dev/null
+++ b/resources/views/show/partials/bckplist-btn.blade.php
@@ -0,0 +1,3 @@
+<a href="{{ route('form-definitions.backup-list',$formDefinition) }}" class="btn btn-sm btn-warning ml-2">
+  Listar backups
+</a>
diff --git a/resources/views/show/partials/bckpremove-btn.blade.php b/resources/views/show/partials/bckpremove-btn.blade.php
new file mode 100644
index 00000000..27df3474
--- /dev/null
+++ b/resources/views/show/partials/bckpremove-btn.blade.php
@@ -0,0 +1,3 @@
+<a href="{{ route('form-definitions.def-backup-remove',['formDefinition' => $formDefinition, 'created_time' => $created_time]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza que deseja remover este backup ? ')">
+  Remover backup
+</a>
diff --git a/resources/views/show/partials/bckpremoveall-btn.blade.php b/resources/views/show/partials/bckpremoveall-btn.blade.php
new file mode 100644
index 00000000..49c5edd5
--- /dev/null
+++ b/resources/views/show/partials/bckpremoveall-btn.blade.php
@@ -0,0 +1,3 @@
+<a href="{{ route('form-definitions.backups-remove-all') }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups atuais ? Essa operação é irreversível.')">
+  Remover todos os backups
+</a>
diff --git a/resources/views/show/partials/defbckpremoveall-btn.blade.php b/resources/views/show/partials/defbckpremoveall-btn.blade.php
new file mode 100644
index 00000000..03d31724
--- /dev/null
+++ b/resources/views/show/partials/defbckpremoveall-btn.blade.php
@@ -0,0 +1,3 @@
+<a href="{{ route('form-definitions.def-backup-remove-all',['formDefinition' => $formDefinition]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups de {{ $formDefinition->name }} ?')">
+  Remover todos os backups da definição
+</a>
diff --git a/resources/views/show/partials/globalbckp-btn.blade.php b/resources/views/show/partials/globalbckp-btn.blade.php
new file mode 100644
index 00000000..df72990c
--- /dev/null
+++ b/resources/views/show/partials/globalbckp-btn.blade.php
@@ -0,0 +1,3 @@
+<a href="{{ route('form-definitions.backup-all') }}" class="btn btn-sm btn-info ml-2">
+  Gerar backups de todas as definições
+</a>
diff --git a/resources/views/show/partials/restore-btn.blade.php b/resources/views/show/partials/restore-btn.blade.php
new file mode 100644
index 00000000..196d7f74
--- /dev/null
+++ b/resources/views/show/partials/restore-btn.blade.php
@@ -0,0 +1,5 @@
+<div>
+  <a href="{{ route('form-definitions.def-backup-restore', ['formDefinition' => $formDefinition,'created_time'=> $created_time]) }}" class="btn btn-sm btn-success ml-2" onclick="return confirm('Tem certeza de que quer restaurar o backup de {{ $formDefinition['name'] }} criado em {{ $created_time }} ? ')">
+    Restaurar
+  </a>
+</div>
\ No newline at end of file

From a3bb8d01950a3d29e3592f0f7956be3f992e44ef Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Sat, 11 Apr 2026 11:02:28 -0300
Subject: [PATCH 4/7] Front-end terminado
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adicionados os botões para restauração, listagem e remoção de backups para cada definição,
bem como os botões de remoção e geração global de backups para o workflow.
A lógica segue exatamente a mesma dos formulários, tanto no front-end quanto no que foi
feito no back-end (obviamente levando em consideração as peculiaridades do workflow)
---
 config/{workflow.php => uspdev-workflow.php}  |  0
 resources/views/show/list-bckps.blade.php     | 18 ++++----
 resources/views/show/list-def-bckps.blade.php | 46 +++++++++++++++++++
 resources/views/show/list-defs.blade.php      |  3 --
 .../views/show/partials/bckpgen-btn.blade.php |  2 +-
 .../show/partials/bckplist-btn.blade.php      |  2 +-
 .../show/partials/bckpremove-btn.blade.php    |  2 +-
 .../partials/defbckpremoveall-btn.blade.php   |  2 +-
 .../show/partials/globalbckp-btn.blade.php    |  2 +-
 .../views/show/partials/restore-btn.blade.php |  2 +-
 routes/web.php                                |  5 +-
 .../Controllers/WorkflowBackupController.php  | 38 +++++++++++++--
 src/WorkflowServiceProvider.php               |  4 +-
 13 files changed, 101 insertions(+), 25 deletions(-)
 rename config/{workflow.php => uspdev-workflow.php} (100%)
 create mode 100644 resources/views/show/list-def-bckps.blade.php

diff --git a/config/workflow.php b/config/uspdev-workflow.php
similarity index 100%
rename from config/workflow.php
rename to config/uspdev-workflow.php
diff --git a/resources/views/show/list-bckps.blade.php b/resources/views/show/list-bckps.blade.php
index 66f0892f..41788e08 100644
--- a/resources/views/show/list-bckps.blade.php
+++ b/resources/views/show/list-bckps.blade.php
@@ -12,9 +12,6 @@
         <span class="text-danger">USPdev workflow</span> >
         Backups
       </div>
-      <div>
-        @include('uspdev-forms::partials.ajuda-modal')
-      </div>
     </div>
     <div class="card-body">
       <table class="table table-bordered table-hover">
@@ -27,23 +24,25 @@
         </thead>
         <tbody>
           @foreach ($workflowDefinitions as $workflowDefinition)
+          @php
+            $count = is_dir(config('uspdev-workflow.storagePath')) ? count(array_filter(scandir(config('uspdev-workflow.storagePath')), fn($filename) => str_contains($filename,$workflowDefinition->name))) : 0;
+          @endphp
             <tr>
               <td>
                 {{ $workflowDefinition->name }}
                 <span class="badge badge-warning badge-pill" title="Backups existentes">
                   {{-- 
-                    Verifica se o diretório que guarda os formulários existe.
-                    Caso exista, exibe o número de backups do formulário existem dentro dele.
-                    Senão, mostra 0.
+                    Exibe o número de backups da definição que existem atualmente
                   --}}
-                  {{ is_dir(config('uspdev-workflow.storagePath')) ? count(array_filter(scandir(config('uspdev-workflow.storagePath')), fn($filename) => str_contains($filename,$workflowDefinition->name))) : 0 }}
+                  {{ $count }}
                 </span>
               </td>
               <td>
                 {{ $workflowDefinition->description }}
               </td>
               <td class="d-flex justify-content-start">
-                @include('uspdev-workflow::show.partials.edit-btn')
+                @include('uspdev-workflow::show.partials.bckpgen-btn')
+                @includeWhen($count > 0,'uspdev-workflow::show.partials.bckplist-btn')
               </td>
             </tr>
           @endforeach
@@ -51,4 +50,7 @@
       </table>
     </div>
   </div>
+    <div class="mt-2">
+    @include('uspdev-workflow::show.partials.globalbckp-btn')
+    </div>
 @endsection
diff --git a/resources/views/show/list-def-bckps.blade.php b/resources/views/show/list-def-bckps.blade.php
new file mode 100644
index 00000000..d9302c29
--- /dev/null
+++ b/resources/views/show/list-def-bckps.blade.php
@@ -0,0 +1,46 @@
+@extends('uspdev-forms::layouts.app')
+
+@section('content')
+
+<div class="card">
+    <div class="card-header h4 card-header-sticky d-flex justify-content-between align-items-center">
+      <div>
+        <span class="text-danger">USPdev workflow</span> >
+        Backups > {{ $workflowDefinition->name }} >
+        <a href="{{ route('workflows.backups-idx') }}" class="btn btn-sm btn-outline-secondary ml-2">Voltar</a>
+      </div>
+    </div>
+    <div class="card-body">
+      <div>@include('uspdev-workflow::show.partials.bckpgen-btn')</div>
+      <br>
+      <table class="table table-bordered table-hover">
+        <thead>
+          <tr>
+            <th>Data de criação</th>
+            <th>Última modificação</th>
+            <th>Ações</th>
+          </tr>
+        </thead>
+        <tbody>
+          @foreach ($time_data as $created_time => $updt_time)
+            <tr>
+              <td>
+                {{ str_replace('_',' - ',str_replace('-','/',$created_time)) }}
+              </td>
+              <td>
+                {{ str_replace('_',' - ',str_replace('-','/',$updt_time)) }}
+              </td>
+              <td class="d-flex justify-content-start align-item-centered">
+                @include('uspdev-workflow::show.partials.restore-btn')
+                @include('uspdev-workflow::show.partials.bckpremove-btn')
+              </td>
+            </tr>
+          @endforeach
+        </tbody>
+      </table>
+    </div>
+  </div>
+  <div class="mt-2">
+    @includeWhen(count($time_data) > 0,'uspdev-workflow::show.partials.defbckpremoveall-btn')
+  </div>
+@endsection
diff --git a/resources/views/show/list-defs.blade.php b/resources/views/show/list-defs.blade.php
index 1b86a28f..8a00bbb1 100644
--- a/resources/views/show/list-defs.blade.php
+++ b/resources/views/show/list-defs.blade.php
@@ -13,9 +13,6 @@
         Definições
         <a href="{{ route('workflows.create-definition') }}" class="btn btn-sm btn-primary">Nova Definição</a>
       </div>
-      <div>
-        @include('uspdev-forms::partials.ajuda-modal')
-      </div>
     </div>
     <div class="card-body">
       <table class="table table-bordered table-hover">
diff --git a/resources/views/show/partials/bckpgen-btn.blade.php b/resources/views/show/partials/bckpgen-btn.blade.php
index fb572ccc..5741f5fd 100644
--- a/resources/views/show/partials/bckpgen-btn.blade.php
+++ b/resources/views/show/partials/bckpgen-btn.blade.php
@@ -1,5 +1,5 @@
 <div>
-  <a href="{{ route('form-definitions.backup-def',  $formDefinition) }}" class="btn btn-sm btn-info ml-2">
+  <a href="{{ route('workflows.gen-backup',  $workflowDefinition) }}" class="btn btn-sm btn-info ml-2">
     Gerar backup
   </a>
 </div>
\ No newline at end of file
diff --git a/resources/views/show/partials/bckplist-btn.blade.php b/resources/views/show/partials/bckplist-btn.blade.php
index b15649f2..bf3e66dc 100644
--- a/resources/views/show/partials/bckplist-btn.blade.php
+++ b/resources/views/show/partials/bckplist-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.backup-list',$formDefinition) }}" class="btn btn-sm btn-warning ml-2">
+<a href="{{ route('workflows.def-backup-list',$workflowDefinition) }}" class="btn btn-sm btn-warning ml-2">
   Listar backups
 </a>
diff --git a/resources/views/show/partials/bckpremove-btn.blade.php b/resources/views/show/partials/bckpremove-btn.blade.php
index 27df3474..af84d558 100644
--- a/resources/views/show/partials/bckpremove-btn.blade.php
+++ b/resources/views/show/partials/bckpremove-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.def-backup-remove',['formDefinition' => $formDefinition, 'created_time' => $created_time]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza que deseja remover este backup ? ')">
+<a href="{{ route('form-definitions.def-backup-remove',['formDefinition' => $workflowDefinition, 'created_time' => $created_time]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza que deseja remover este backup ? ')">
   Remover backup
 </a>
diff --git a/resources/views/show/partials/defbckpremoveall-btn.blade.php b/resources/views/show/partials/defbckpremoveall-btn.blade.php
index 03d31724..c83fec75 100644
--- a/resources/views/show/partials/defbckpremoveall-btn.blade.php
+++ b/resources/views/show/partials/defbckpremoveall-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.def-backup-remove-all',['formDefinition' => $formDefinition]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups de {{ $formDefinition->name }} ?')">
+<a href="{{ route('form-definitions.def-backup-remove-all',['formDefinition' => $workflowDefinition]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups de {{ $workflowDefinition->name }} ?')">
   Remover todos os backups da definição
 </a>
diff --git a/resources/views/show/partials/globalbckp-btn.blade.php b/resources/views/show/partials/globalbckp-btn.blade.php
index df72990c..eb8603ee 100644
--- a/resources/views/show/partials/globalbckp-btn.blade.php
+++ b/resources/views/show/partials/globalbckp-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.backup-all') }}" class="btn btn-sm btn-info ml-2">
+<a href="{{ route('workflows.gen-all-backups') }}" class="btn btn-sm btn-info ml-2">
   Gerar backups de todas as definições
 </a>
diff --git a/resources/views/show/partials/restore-btn.blade.php b/resources/views/show/partials/restore-btn.blade.php
index 196d7f74..8e90a524 100644
--- a/resources/views/show/partials/restore-btn.blade.php
+++ b/resources/views/show/partials/restore-btn.blade.php
@@ -1,5 +1,5 @@
 <div>
-  <a href="{{ route('form-definitions.def-backup-restore', ['formDefinition' => $formDefinition,'created_time'=> $created_time]) }}" class="btn btn-sm btn-success ml-2" onclick="return confirm('Tem certeza de que quer restaurar o backup de {{ $formDefinition['name'] }} criado em {{ $created_time }} ? ')">
+  <a href="{{ route('form-definitions.def-backup-restore', ['formDefinition' => $workflowDefinition,'created_time'=> $created_time]) }}" class="btn btn-sm btn-success ml-2" onclick="return confirm('Tem certeza de que quer restaurar o backup de {{ $workflowDefinition['name'] }} criado em {{ $created_time }} ? ')">
     Restaurar
   </a>
 </div>
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index 24214d6e..5a40a90b 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -3,9 +3,10 @@
 use Illuminate\Support\Facades\Route;
 use Uspdev\Workflow\Http\Controllers\WorkflowBackupController;
 
-Route::group(['prefix' => config('workflow.prefix'), 'middleware' => ['web']], function () {
+Route::group(['prefix' => config('uspdev-workflow.prefix'), 'middleware' => ['web']], function () {
 
     Route::get('/backups', [WorkflowBackupController::class, 'backups_index'])->name('workflows.backups-idx');
     Route::get('/backups/gen-backups', [WorkflowBackupController::class, 'bckp_gen_all'])->name('workflows.gen-all-backups');
-    Route::get('/backups/{wrkflw_def}/gen-backup', [WorkflowBackupController::class, 'def_bckp_gen'])->name('workflows.gen-backup');
+    Route::get('/backups/{workflowDefinition}/gen-backup', [WorkflowBackupController::class, 'def_bckp_gen'])->name('workflows.gen-backup');
+    Route::get('/backups/{workflowDefinition}/list',[WorkflowBackupController::class, 'def_bckp_list'])->name('workflows.def-backup-list');
 });
\ No newline at end of file
diff --git a/src/Http/Controllers/WorkflowBackupController.php b/src/Http/Controllers/WorkflowBackupController.php
index 0ed7ea7a..0159443a 100644
--- a/src/Http/Controllers/WorkflowBackupController.php
+++ b/src/Http/Controllers/WorkflowBackupController.php
@@ -16,15 +16,15 @@ public function backups_index()
         return view('uspdev-workflow::show.list-bckps', ['workflowDefinitions' => $workflowDefinitions, 'activeTab' => 'backup']);
     }
 
-    public function def_bckp_gen(WorkflowDefinition $wrkflw_def)
+    public function def_bckp_gen(WorkflowDefinition $workflowDefinition)
     {
-        $file_dir = config('workflow.storagePath');
+        $file_dir = config('uspdev-workflow.storagePath');
         if(!is_dir($file_dir))
         {
             mkdir($file_dir,0777);
         }
 
-        $file_path = $file_dir . '/' . $wrkflw_def['name'] . '@' . now()->format('d-m-Y_H:i:s') . '.json';
+        $file_path = $file_dir . '/' . $workflowDefinition['name'] . '@' . now()->format('d-m-Y_H:i:s') . '.json';
 
         try
         {
@@ -36,11 +36,13 @@ public function def_bckp_gen(WorkflowDefinition $wrkflw_def)
             return;
         }
 
-        $json_encoded = json_encode($wrkflw_def->definition,JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+        $json_encoded = json_encode($workflowDefinition->definition,JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
 
         fwrite($json_file,$json_encoded);
 
         fclose($json_file);
+
+        return redirect()->back()->with('alert-success','Backup de ' . $workflowDefinition->name . ' gerado com sucesso.');
     }
 
     public function bckp_gen_all()
@@ -50,5 +52,33 @@ public function bckp_gen_all()
         {
             $this->def_bckp_gen($wrkflow_def);
         }
+
+        return redirect()->back()->with('alert-success','Backups de todas as definições gerados com sucesso.');
+    }
+
+    public function def_bckp_list(WorkflowDefinition $workflowDefinition)
+    {
+        $file_dir = config('uspdev-workflow.storagePath');
+
+        $files = scandir($file_dir);
+        $files = array_filter($files, function($filename) use ($workflowDefinition)
+        {
+            return str_contains($filename,$workflowDefinition->name);
+        });
+
+        $time_data = [];
+
+        foreach($files as $filename)
+        {
+            $created_time = explode('@',$filename)[1];
+            $created_time = explode('.',$created_time)[0];
+            
+            $last_mod_time = date('d-m-Y_H:i:s', filemtime($file_dir .'/'. $filename));
+
+            // Grava no formato: tempo_criado => tempo_ultima_mod
+            $time_data[$created_time] = $last_mod_time;
+        }
+
+        return view('uspdev-workflow::show.list-def-bckps', ['workflowDefinition' => $workflowDefinition, 'time_data' => $time_data]);
     }
 }
\ No newline at end of file
diff --git a/src/WorkflowServiceProvider.php b/src/WorkflowServiceProvider.php
index 908160d4..561e3853 100644
--- a/src/WorkflowServiceProvider.php
+++ b/src/WorkflowServiceProvider.php
@@ -14,7 +14,7 @@ public function boot()
     {
         // Publish config file
         $this->publishes([
-            __DIR__.'/../config/workflow.php' => config_path('workflow.php'),
+            __DIR__.'/../config/workflow.php' => config_path('uspdev-workflow.php'),
         ], 'workflow-config');
 
         // Publish migrations
@@ -38,7 +38,7 @@ public function boot()
     public function register()
     {
         $this->mergeConfigFrom(
-            __DIR__ . '/../config/workflow.php', 'uspdev-workflow'
+            __DIR__ . '/../config/uspdev-workflow.php', 'uspdev-workflow'
         );
     }
 }

From 0fd0e47297cf5b880e3fefdd7603e2c2affefec4 Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Sat, 11 Apr 2026 11:28:55 -0300
Subject: [PATCH 5/7] =?UTF-8?q?L=C3=B3gica=20de=20cria=C3=A7=C3=A3o/remo?=
 =?UTF-8?q?=C3=A7=C3=A3o=20terminada?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Agora é possível criar e remover os backups das definições de workflow.
Possível criar backups individualmente e de maneira generalizada (gerar
backups para todas as definições persistidas de uma vez.
Análogamente, é possível remover cada backup indiviudalmente, remover todos
os backups de uma defnição específica de uma vez ou até mesmo remover todos
os backups existentes de todas as definições.
---
 .../show/partials/bckpremove-btn.blade.php    |  2 +-
 .../show/partials/bckpremoveall-btn.blade.php |  2 +-
 .../partials/defbckpremoveall-btn.blade.php   |  2 +-
 routes/web.php                                |  3 +
 .../Controllers/WorkflowBackupController.php  | 74 +++++++++++++++++++
 5 files changed, 80 insertions(+), 3 deletions(-)

diff --git a/resources/views/show/partials/bckpremove-btn.blade.php b/resources/views/show/partials/bckpremove-btn.blade.php
index af84d558..52b1f100 100644
--- a/resources/views/show/partials/bckpremove-btn.blade.php
+++ b/resources/views/show/partials/bckpremove-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.def-backup-remove',['formDefinition' => $workflowDefinition, 'created_time' => $created_time]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza que deseja remover este backup ? ')">
+<a href="{{ route('workflows.def-remove-bckp',['workflowDefinition' => $workflowDefinition, 'created_time' => $created_time]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza que deseja remover este backup ? ')">
   Remover backup
 </a>
diff --git a/resources/views/show/partials/bckpremoveall-btn.blade.php b/resources/views/show/partials/bckpremoveall-btn.blade.php
index 49c5edd5..d3511fe5 100644
--- a/resources/views/show/partials/bckpremoveall-btn.blade.php
+++ b/resources/views/show/partials/bckpremoveall-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.backups-remove-all') }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups atuais ? Essa operação é irreversível.')">
+<a href="{{ route('workflows.rmv-bckps') }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups atuais ? Essa operação é irreversível.')">
   Remover todos os backups
 </a>
diff --git a/resources/views/show/partials/defbckpremoveall-btn.blade.php b/resources/views/show/partials/defbckpremoveall-btn.blade.php
index c83fec75..2dcf593e 100644
--- a/resources/views/show/partials/defbckpremoveall-btn.blade.php
+++ b/resources/views/show/partials/defbckpremoveall-btn.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ route('form-definitions.def-backup-remove-all',['formDefinition' => $workflowDefinition]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups de {{ $workflowDefinition->name }} ?')">
+<a href="{{ route('workflows.def-rmv-bckps',['workflowDefinition' => $workflowDefinition]) }}" class="btn btn-sm btn-danger ml-2" onclick="return confirm('Tem certeza de que quer remover todos os backups de {{ $workflowDefinition->name }} ?')">
   Remover todos os backups da definição
 </a>
diff --git a/routes/web.php b/routes/web.php
index 5a40a90b..ea736f41 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -9,4 +9,7 @@
     Route::get('/backups/gen-backups', [WorkflowBackupController::class, 'bckp_gen_all'])->name('workflows.gen-all-backups');
     Route::get('/backups/{workflowDefinition}/gen-backup', [WorkflowBackupController::class, 'def_bckp_gen'])->name('workflows.gen-backup');
     Route::get('/backups/{workflowDefinition}/list',[WorkflowBackupController::class, 'def_bckp_list'])->name('workflows.def-backup-list');
+    Route::get('/backups/{workflowDefinition}/remove/{created_time}', [WorkflowBackupController::class, 'remove_bckp'])->name('workflows.def-remove-bckp');
+    Route::get('/backups/{workflowDefinition}/remove-all', [WorkflowBackupController::class, 'remove_def_bckps'])->name('workflows.def-rmv-bckps');
+    Route::get('/backups/remove-all', [WorkflowBackupController::class, 'remove_all_bckps'])->name('workflows.rmv-bckps');
 });
\ No newline at end of file
diff --git a/src/Http/Controllers/WorkflowBackupController.php b/src/Http/Controllers/WorkflowBackupController.php
index 0159443a..eafa2c74 100644
--- a/src/Http/Controllers/WorkflowBackupController.php
+++ b/src/Http/Controllers/WorkflowBackupController.php
@@ -5,6 +5,7 @@
 use App\Http\Controllers\Controller;
 use Exception;
 use Uspdev\Workflow\Models\WorkflowDefinition;
+use File;
 
 class WorkflowBackupController extends Controller
 {
@@ -81,4 +82,77 @@ public function def_bckp_list(WorkflowDefinition $workflowDefinition)
 
         return view('uspdev-workflow::show.list-def-bckps', ['workflowDefinition' => $workflowDefinition, 'time_data' => $time_data]);
     }
+
+    public function remove_bckp(WorkflowDefinition $workflowDefinition, string $created_time)
+    {
+        $created_time = str_replace(' - ','_',$created_time);
+        $created_time = str_replace('/','-',$created_time);
+
+        // Remonta o nome do arquivo
+        $filename = $workflowDefinition->name . '@' . $created_time . '.json';
+        
+        // Remonta o caminho completo do arquivo
+        $filepath = config('uspdev-workflow.storagePath') . '/' . $filename;
+
+        // Caso o arquivo exista no caminho remontado anteriormente, o remove
+        if(File::exists($filepath))
+        {    
+            File::delete($filepath);
+            return redirect()->back()->with('alert-warning','Backup ' . $filename . ' removido com sucesso.' );
+        }
+
+        // Caso contrário, exibe uma mensagem de erro.
+        else
+        {
+            return redirect()->back()->with('alert-danger', 'Impossível remover ' . $filename .' => arquivo não existe.');
+        }
+    }
+
+    public function remove_def_bckps(WorkflowDefinition $workflowDefinition)
+    {
+        // Recupera o diretório em que os backups são salvos
+        $file_dir = config('uspdev-workflow.storagePath');
+
+        // Filtra os arquivos pelos nomes que contém o nome da definição
+        $files = array_filter(scandir($file_dir),function($filename) use ($workflowDefinition){return str_contains($filename,$workflowDefinition->name);});
+
+        // Percorre todos os arquivos
+        foreach($files as $filename)
+        {
+            // Reconstrói o caminho dos arquivo
+            $filepath = $file_dir . '/' . $filename;
+
+            // Verifica a existência e deleta em caso afirmativo
+            if(File::exists($filepath));
+            {
+                File::delete($filepath);
+            }
+        }
+
+        return redirect()->back()->with('alert-warning', 'Backups de ' . $workflowDefinition->name . ' removidos com sucesso.');
+    }
+
+    public function remove_all_bckps()
+    {
+        // Recupera o diretório em que os arquivos são salvos
+        $file_dir = config('uspdev-workflow.storagePath');
+
+        // Filtra para obter apenas os arquivos .json(evita '.' e '..', além de possível lixo)
+        $files = array_filter(scandir($file_dir), function($file) { return str_contains($file,'.json'); });
+
+        // Percorre todos os arquivos do diretório
+        foreach($files as $filename)
+        {
+            // Reconstrói o caminho do arquivo
+            $filepath = $file_dir . '/' . $filename;
+
+            // Verifica se o mesmo existe, e o deleta em caso afirmativo
+            if(File::exists($filepath))
+            {
+                File::delete($filepath);
+            }
+        }
+
+        return redirect()->back()->with('alert-warning', 'Backups removidos com sucesso.');
+    }
 }
\ No newline at end of file

From cfae54a6c779b6a98c2dbe08b593420506338d9e Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Sun, 12 Apr 2026 11:31:33 -0300
Subject: [PATCH 6/7] =?UTF-8?q?L=C3=B3gica=20de=20restaura=C3=A7=C3=A3o=20?=
 =?UTF-8?q?e=20gera=C3=A7=C3=A3o=20de=20backups=20finalizada?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Agora é possível gerar, excluir e restarurar backups de workflow.
Os backups são gerados em arquivos .json no formato 'nomedadef@horario.json'

A restauração dos workflows funciona baseada no comando WorkflowSync

	O comando recebe a opção --path, onde o usuário pode especí-
	ficar o caminho do arquivo/diretório à ser sincronizado.

	No caso de ser um arquivo, o comando sobe a definição de work-
	flow (contida no arquivo .json) para o banco de dados.

	No caso de diretório, ele sincroniza baseado nos arquivos modi-
	ficados mais recentemente (para cada definição persistida no ban-
	co de dados).

	Caso o --path não seja informado, por padrão o comando usa o dire-
	tório específicado no arquivo de configuração uspdev-workflow.php,
	no campo storagePath.

Tanto a lógica dos backups quanto a lógica do comando foram transferidas da
aplicação à biblioteca para maior partabilidade e usabilidade.
---
 .../views/show/partials/restore-btn.blade.php |  2 +-
 routes/web.php                                |  1 +
 src/Console/Commands/WorfklowSync.php         | 29 --------
 src/Console/Commands/WorkflowSync.php         | 34 +++++++++
 .../Controllers/WorkflowBackupController.php  | 12 ++++
 src/Services/WorkflowSyncService.php          | 70 +++++++++++++++++++
 src/WorkflowServiceProvider.php               |  7 +-
 7 files changed, 123 insertions(+), 32 deletions(-)
 delete mode 100644 src/Console/Commands/WorfklowSync.php
 create mode 100644 src/Console/Commands/WorkflowSync.php
 create mode 100644 src/Services/WorkflowSyncService.php

diff --git a/resources/views/show/partials/restore-btn.blade.php b/resources/views/show/partials/restore-btn.blade.php
index 8e90a524..a6f22f1d 100644
--- a/resources/views/show/partials/restore-btn.blade.php
+++ b/resources/views/show/partials/restore-btn.blade.php
@@ -1,5 +1,5 @@
 <div>
-  <a href="{{ route('form-definitions.def-backup-restore', ['formDefinition' => $workflowDefinition,'created_time'=> $created_time]) }}" class="btn btn-sm btn-success ml-2" onclick="return confirm('Tem certeza de que quer restaurar o backup de {{ $workflowDefinition['name'] }} criado em {{ $created_time }} ? ')">
+  <a href="{{ route('workflows.restore-bckp', ['workflowDefinition' => $workflowDefinition,'created_time'=> $created_time]) }}" class="btn btn-sm btn-success ml-2" onclick="return confirm('Tem certeza de que quer restaurar o backup de {{ $workflowDefinition['name'] }} criado em {{ $created_time }} ? ')">
     Restaurar
   </a>
 </div>
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index ea736f41..ef9beb64 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -12,4 +12,5 @@
     Route::get('/backups/{workflowDefinition}/remove/{created_time}', [WorkflowBackupController::class, 'remove_bckp'])->name('workflows.def-remove-bckp');
     Route::get('/backups/{workflowDefinition}/remove-all', [WorkflowBackupController::class, 'remove_def_bckps'])->name('workflows.def-rmv-bckps');
     Route::get('/backups/remove-all', [WorkflowBackupController::class, 'remove_all_bckps'])->name('workflows.rmv-bckps');
+    Route::get('/backups/{workflowDefinition}/restore/{created_time}', [WorkflowBackupController::class,'restore_backup'])->name('workflows.restore-bckp');
 });
\ No newline at end of file
diff --git a/src/Console/Commands/WorfklowSync.php b/src/Console/Commands/WorfklowSync.php
deleted file mode 100644
index 878938f2..00000000
--- a/src/Console/Commands/WorfklowSync.php
+++ /dev/null
@@ -1,29 +0,0 @@
-<?php
-
-namespace App\Console\Commands;
-
-use Illuminate\Console\Command;
-
-class WorfklowSync extends Command
-{
-    /**
-     * The name and signature of the console command.
-     *
-     * @var string
-     */
-    protected $signature = 'workflow:sync';
-
-    /**
-     * The console command description.
-     *
-     * @var string
-     */
-    protected $description = 'Command description';
-
-    /**
-     * Execute the console command.
-     */
-    public function handle()
-    {
-    }
-}
diff --git a/src/Console/Commands/WorkflowSync.php b/src/Console/Commands/WorkflowSync.php
new file mode 100644
index 00000000..a11a91a7
--- /dev/null
+++ b/src/Console/Commands/WorkflowSync.php
@@ -0,0 +1,34 @@
+<?php
+
+namespace Uspdev\Workflow\Console\Commands   ;
+
+use Illuminate\Console\Command;
+use Uspdev\Workflow\Services\WorkflowSyncService;
+
+class WorkflowSync extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'workflow:sync {--path=}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Syncronizes the workflow backup on the specified path with de database';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle()
+    {
+        $path = $this->option('path') ?: config('uspdev-workflow.storagePath');
+        $this->info('Sicnronizando workflows do caminho: ' . $path);
+
+        app(WorkflowSyncService::class)->workflow_sync($path);
+    }
+}
diff --git a/src/Http/Controllers/WorkflowBackupController.php b/src/Http/Controllers/WorkflowBackupController.php
index eafa2c74..49cd5a42 100644
--- a/src/Http/Controllers/WorkflowBackupController.php
+++ b/src/Http/Controllers/WorkflowBackupController.php
@@ -4,6 +4,7 @@
 
 use App\Http\Controllers\Controller;
 use Exception;
+use Illuminate\Support\Facades\Artisan;
 use Uspdev\Workflow\Models\WorkflowDefinition;
 use File;
 
@@ -155,4 +156,15 @@ public function remove_all_bckps()
 
         return redirect()->back()->with('alert-warning', 'Backups removidos com sucesso.');
     }
+
+    public function restore_backup(WorkflowDefinition $workflowDefinition, string $created_time)
+    {
+        $file_dir = config('uspdev-workflow.storagePath');
+        $filename = $workflowDefinition->name . '@' . $created_time;
+        $filepath = $file_dir . '/' . $filename . '.json';
+
+        Artisan::call('workflow:sync', ['--path' => $filepath]);
+
+        return redirect()->back()->with('alert-success','Backup ' . $filename . ' restaurado com sucesso');
+    }
 }
\ No newline at end of file
diff --git a/src/Services/WorkflowSyncService.php b/src/Services/WorkflowSyncService.php
new file mode 100644
index 00000000..0580bce6
--- /dev/null
+++ b/src/Services/WorkflowSyncService.php
@@ -0,0 +1,70 @@
+<?php
+
+namespace Uspdev\Workflow\Services;
+
+use Uspdev\Workflow\Models\WorkflowDefinition;
+
+class WorkflowSyncService
+{
+    private function sync_file(string $filepath)
+    {   
+        $json_encoded = file_get_contents($filepath);
+
+        $decoded_json = json_decode($json_encoded, true);
+
+        // dd($decoded_json);
+        $workflowDefintion = WorkflowDefinition::updateOrCreate(
+            ['name' => $decoded_json['name']], 
+            [
+                'definition' => $decoded_json,
+                'description' => $decoded_json['description'],
+            ]);
+    }
+
+    private function sync_dir(string $dir_path)
+    {
+        $all_files = scandir($dir_path);
+
+        $most_recent_updt = [];
+        foreach($all_files as  $filename)
+        {
+            if(str_contains($filename,'.json'))
+            {
+                
+                $curr_def = explode('@',$filename)[0];
+                $filepath = $dir_path . '/' . $filename;
+
+                if(!array_key_exists($curr_def,$most_recent_updt))
+                {
+                    $most_recent_updt[$curr_def] = $filepath;
+                }
+
+                elseif(filemtime($most_recent_updt[$curr_def]) < filemtime($filepath))
+                {
+                    $most_recent_updt[$curr_def] = $filepath;
+                }
+            }
+        }
+
+        foreach($most_recent_updt as $to_restore)
+        {
+            $this->sync_file($to_restore);
+        }
+    }
+
+    public function workflow_sync(string $path)
+    {
+        if(is_dir($path))
+        {
+            $this->sync_dir($path);
+        }
+        elseif(is_file($path))
+        {
+            $this->sync_file($path);
+        }
+        else
+        {
+            return redirect()->back()->with('alert-danger','O caminho indicado: ' . $path . ' não representa um diretório nem um arquivo existente.');
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/WorkflowServiceProvider.php b/src/WorkflowServiceProvider.php
index 561e3853..77499371 100644
--- a/src/WorkflowServiceProvider.php
+++ b/src/WorkflowServiceProvider.php
@@ -1,6 +1,7 @@
 <?php
 namespace Uspdev\Workflow;
 
+use Uspdev\Workflow\Console\Commands\WorkflowSync;
 use Illuminate\Support\ServiceProvider;
 
 class WorkflowServiceProvider extends ServiceProvider
@@ -26,8 +27,10 @@ public function boot()
 
         $this->loadRoutesFrom(__DIR__.'/../routes/web.php');
 
-        // Load migrations
-        // $this->loadMigrationsFrom(__DIR__ . '/../database/migrations');
+        // Publica o comando de WorkflowSync
+        $this->commands([
+            WorkflowSync::class,
+        ]);
     }
 
     /**

From 71ed2538fcf259b05198cdb36ef14128d581f60b Mon Sep 17 00:00:00 2001
From: ViniReiwz <vinireisg@usp.br>
Date: Sun, 12 Apr 2026 12:53:59 -0300
Subject: [PATCH 7/7] =?UTF-8?q?Documenta=C3=A7=C3=A3o=20finalizada?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Código comentado basicamente, explictando as funcionalidades e algumas partes
da lógica.
---
 src/Console/Commands/WorkflowSync.php         |  3 +
 .../Controllers/WorkflowBackupController.php  | 65 ++++++++++++++++++-
 src/Services/WorkflowSyncService.php          | 44 +++++++++++--
 3 files changed, 105 insertions(+), 7 deletions(-)

diff --git a/src/Console/Commands/WorkflowSync.php b/src/Console/Commands/WorkflowSync.php
index a11a91a7..ad1c0cf6 100644
--- a/src/Console/Commands/WorkflowSync.php
+++ b/src/Console/Commands/WorkflowSync.php
@@ -26,9 +26,12 @@ class WorkflowSync extends Command
      */
     public function handle()
     {
+        // Pega o arquivo passado na option --path.
+        // Caso não esteja definido, pega o diretório padrão de armazenamento em uspdev-workflow.php
         $path = $this->option('path') ?: config('uspdev-workflow.storagePath');
         $this->info('Sicnronizando workflows do caminho: ' . $path);
 
+        // Chama o serviço de sincronizar no caminho especificado
         app(WorkflowSyncService::class)->workflow_sync($path);
     }
 }
diff --git a/src/Http/Controllers/WorkflowBackupController.php b/src/Http/Controllers/WorkflowBackupController.php
index 49cd5a42..7523b0d4 100644
--- a/src/Http/Controllers/WorkflowBackupController.php
+++ b/src/Http/Controllers/WorkflowBackupController.php
@@ -11,6 +11,10 @@
 class WorkflowBackupController extends Controller
 {
 
+    /**
+     * Lista as definições de workflow com as informações sobre os backups
+     * @return \Illuminate\Contracts\View\View
+     */
     public function backups_index()
     {
         $workflowDefinitions = WorkflowDefinition::all();
@@ -18,16 +22,26 @@ public function backups_index()
         return view('uspdev-workflow::show.list-bckps', ['workflowDefinitions' => $workflowDefinitions, 'activeTab' => 'backup']);
     }
 
+    /**
+     * Gera o backup de uma definição de workflow
+     * @param WorkflowDefinition $workflowDefinition
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function def_bckp_gen(WorkflowDefinition $workflowDefinition)
     {
+        // Recupera o diretório para armazenar os backups do workflow
         $file_dir = config('uspdev-workflow.storagePath');
+
+        // Cria o diretório caso ele não exista
         if(!is_dir($file_dir))
         {
             mkdir($file_dir,0777);
         }
 
+        // Forma o caominho do arquivo na forma defname@horariocriado.json
         $file_path = $file_dir . '/' . $workflowDefinition['name'] . '@' . now()->format('d-m-Y_H:i:s') . '.json';
 
+        // Cria o arquivo para escrita
         try
         {
             $json_file = fopen($file_path,'w');
@@ -38,31 +52,51 @@ public function def_bckp_gen(WorkflowDefinition $workflowDefinition)
             return;
         }
 
+        // Gera o json a partir da definição do workflow
         $json_encoded = json_encode($workflowDefinition->definition,JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
 
+        // Escreve o json da definição no arquivo
         fwrite($json_file,$json_encoded);
 
         fclose($json_file);
 
+        // Redireciona e retorna com uma mensagem de sucesso
         return redirect()->back()->with('alert-success','Backup de ' . $workflowDefinition->name . ' gerado com sucesso.');
     }
 
+    /**
+     * Gera o backup de todas as definições persistidas no banco de dados
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function bckp_gen_all()
     {
+        // Recupera todas as definições do banco de dados
         $wrkflw_defs = WorkflowDefinition::all();
+
+        // Gera um backup para cada definição
         foreach($wrkflw_defs as $wrkflow_def)
         {
             $this->def_bckp_gen($wrkflow_def);
         }
 
+        // Retorna a mensagem de sucesso
         return redirect()->back()->with('alert-success','Backups de todas as definições gerados com sucesso.');
     }
 
+    /**
+     * Lista todos os backups de uma definição
+     * @param WorkflowDefinition $workflowDefinition
+     * @return \Illuminate\Contracts\View\View
+     */
     public function def_bckp_list(WorkflowDefinition $workflowDefinition)
     {
+        // Recupera o diretório de armazenamento dos backups
         $file_dir = config('uspdev-workflow.storagePath');
 
+        // Captura todos os arquivos em um array associativo
         $files = scandir($file_dir);
+
+        // Filtra pelo nome da definição
         $files = array_filter($files, function($filename) use ($workflowDefinition)
         {
             return str_contains($filename,$workflowDefinition->name);
@@ -70,6 +104,7 @@ public function def_bckp_list(WorkflowDefinition $workflowDefinition)
 
         $time_data = [];
 
+        // Percorre todos os arquivos e extrai informações - data de criação e data da ultima modificação
         foreach($files as $filename)
         {
             $created_time = explode('@',$filename)[1];
@@ -83,9 +118,16 @@ public function def_bckp_list(WorkflowDefinition $workflowDefinition)
 
         return view('uspdev-workflow::show.list-def-bckps', ['workflowDefinition' => $workflowDefinition, 'time_data' => $time_data]);
     }
-
+    
+    /**
+     * Remove um backup da definição, remontando o nome através do nome da definição e do tempo de criação do backup
+     * @param WorkflowDefinition $workflowDefinition
+     * @param string $created_time
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function remove_bckp(WorkflowDefinition $workflowDefinition, string $created_time)
     {
+        // Remonta o tempo de criação para voltar ao formato Y-m-d_H:i:s
         $created_time = str_replace(' - ','_',$created_time);
         $created_time = str_replace('/','-',$created_time);
 
@@ -109,6 +151,11 @@ public function remove_bckp(WorkflowDefinition $workflowDefinition, string $crea
         }
     }
 
+    /**
+     * Remove todos os backups existentes de uma definição
+     * @param WorkflowDefinition $workflowDefinition
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function remove_def_bckps(WorkflowDefinition $workflowDefinition)
     {
         // Recupera o diretório em que os backups são salvos
@@ -132,7 +179,10 @@ public function remove_def_bckps(WorkflowDefinition $workflowDefinition)
 
         return redirect()->back()->with('alert-warning', 'Backups de ' . $workflowDefinition->name . ' removidos com sucesso.');
     }
-
+    /**
+     * Remove todos os backups existentes, de todas as definições
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function remove_all_bckps()
     {
         // Recupera o diretório em que os arquivos são salvos
@@ -157,14 +207,23 @@ public function remove_all_bckps()
         return redirect()->back()->with('alert-warning', 'Backups removidos com sucesso.');
     }
 
+    /**
+     * Restaura um backup (persiste no banco de dados)
+     * @param WorkflowDefinition $workflowDefinition
+     * @param string $created_time
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function restore_backup(WorkflowDefinition $workflowDefinition, string $created_time)
     {
+        // Remonta o caminho completo do arquivo
         $file_dir = config('uspdev-workflow.storagePath');
         $filename = $workflowDefinition->name . '@' . $created_time;
         $filepath = $file_dir . '/' . $filename . '.json';
-
+    
+        // Chama o comando 'workflow:sync', passando o caminho desejado como option {--path}
         Artisan::call('workflow:sync', ['--path' => $filepath]);
 
+        // Retorna uma mensagem de sucesso.
         return redirect()->back()->with('alert-success','Backup ' . $filename . ' restaurado com sucesso');
     }
 }
\ No newline at end of file
diff --git a/src/Services/WorkflowSyncService.php b/src/Services/WorkflowSyncService.php
index 0580bce6..94b0b8af 100644
--- a/src/Services/WorkflowSyncService.php
+++ b/src/Services/WorkflowSyncService.php
@@ -6,39 +6,64 @@
 
 class WorkflowSyncService
 {
+
+    /**
+     * Sincroniza um arquivo de backup (Persiste a definição no banco de dados)
+     * @param string $filepath
+     * @return void
+     */
     private function sync_file(string $filepath)
     {   
+        // Recupera a definição do workflow salva no backup (em formato .json)
         $json_encoded = file_get_contents($filepath);
 
+        // Decodifica par aum array associativo
         $decoded_json = json_decode($json_encoded, true);
 
-        // dd($decoded_json);
-        $workflowDefintion = WorkflowDefinition::updateOrCreate(
+        // Busca a definição eplo nome e atualiza caso exita.
+        // Se não, cria uma nova definição com as informações do arquivo
+        WorkflowDefinition::updateOrCreate(
             ['name' => $decoded_json['name']], 
             [
-                'definition' => $decoded_json,
+                'name' => $decoded_json['name'],
                 'description' => $decoded_json['description'],
+                'definition' => $decoded_json,
             ]);
     }
 
+    /**
+     * Sincroniza todo um diretório de backup
+     * @param string $dir_path
+     * @return void
+     */
     private function sync_dir(string $dir_path)
     {
+        // Recupera todos os backups existentes no diretório especificado
         $all_files = scandir($dir_path);
 
+        // Vetor auxiliar para recuperar o backup mais recentemente modificado
         $most_recent_updt = [];
+
+        // Percorre todos os arquivos existentes no diretório
         foreach($all_files as  $filename)
         {
             if(str_contains($filename,'.json'))
             {
                 
+                // Recupera o nome da definição do backup
                 $curr_def = explode('@',$filename)[0];
+
+                // Remonta o caminho completo do arquivo
                 $filepath = $dir_path . '/' . $filename;
 
+                // Se ainda não existe a chave, cria e associa ao caminho atual
                 if(!array_key_exists($curr_def,$most_recent_updt))
                 {
                     $most_recent_updt[$curr_def] = $filepath;
                 }
 
+                // Se existe, e o tempo de modificação do elemento contido no vetor for menor que o do arquivo atual
+                //(significa que a última modificação do contido foi anterior à do arquivo atual), faz a substituição
                 elseif(filemtime($most_recent_updt[$curr_def]) < filemtime($filepath))
                 {
                     $most_recent_updt[$curr_def] = $filepath;
@@ -46,22 +71,33 @@ private function sync_dir(string $dir_path)
             }
         }
 
+        // Para cada elemento dentro do vetor de 'mais recentemente atualizado', sincroniza o arquivo de backup
         foreach($most_recent_updt as $to_restore)
         {
             $this->sync_file($to_restore);
         }
     }
 
+    /**
+     * Sincroniza o arquivo/diretório no arquivo passado.
+     * @param string $path
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function workflow_sync(string $path)
-    {
+    {   
+        // Caso seja um diretório
         if(is_dir($path))
         {
             $this->sync_dir($path);
         }
+        
+        // Caso seja arquivo
         elseif(is_file($path))
         {
             $this->sync_file($path);
         }
+
+        // Mensagem de erro
         else
         {
             return redirect()->back()->with('alert-danger','O caminho indicado: ' . $path . ' não representa um diretório nem um arquivo existente.');