feat(阶段四): 创建 SOP 模板服务类
- 实现 exportToJson 方法（导出为 JSON） - 实现 importFromJson 方法（从 JSON 导入） - 实现 publish 方法（发布模板） - 实现 createVersion 方法（创建版本快照） - 实现 archive 方法（归档模板） - 实现 duplicate 方法（复制模板） - 导入时验证数据结构和必需字段 - 复制时包含所有步骤和交互任务
This commit is contained in:
222
app/Services/SopTemplateService.php
Normal file
222
app/Services/SopTemplateService.php
Normal file
@@ -0,0 +1,222 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\SopTemplate;
|
||||
use App\Models\SopTemplateVersion;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
class SopTemplateService
|
||||
{
|
||||
/**
|
||||
* 导出模板为 JSON 格式
|
||||
*
|
||||
* @param SopTemplate $template
|
||||
* @return string
|
||||
*/
|
||||
public function exportToJson(SopTemplate $template): string
|
||||
{
|
||||
$data = [
|
||||
'template' => [
|
||||
'name' => $template->name,
|
||||
'description' => $template->description,
|
||||
'category' => $template->category,
|
||||
'tags' => $template->tags,
|
||||
'version' => $template->version,
|
||||
'applicable_departments' => $template->applicable_departments,
|
||||
'applicable_positions' => $template->applicable_positions,
|
||||
],
|
||||
'steps' => $template->steps->map(function ($step) {
|
||||
return [
|
||||
'step_number' => $step->step_number,
|
||||
'title' => $step->title,
|
||||
'content' => $step->content,
|
||||
'sort_order' => $step->sort_order,
|
||||
'is_required' => $step->is_required,
|
||||
'interactive_tasks' => $step->interactiveTasks->map(function ($task) {
|
||||
return [
|
||||
'task_type' => $task->task_type,
|
||||
'task_config' => $task->task_config,
|
||||
'validation_rules' => $task->validation_rules,
|
||||
'timeout_seconds' => $task->timeout_seconds,
|
||||
'is_required' => $task->is_required,
|
||||
];
|
||||
})->toArray(),
|
||||
];
|
||||
})->toArray(),
|
||||
'exported_at' => now()->toIso8601String(),
|
||||
'exported_by' => auth()->user()?->name,
|
||||
];
|
||||
|
||||
return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
|
||||
}
|
||||
|
||||
/**
|
||||
* 从 JSON 导入模板
|
||||
*
|
||||
* @param string $json
|
||||
* @return SopTemplate
|
||||
* @throws ValidationException
|
||||
*/
|
||||
public function importFromJson(string $json): SopTemplate
|
||||
{
|
||||
$data = json_decode($json, true);
|
||||
|
||||
if (json_last_error() !== JSON_ERROR_NONE) {
|
||||
throw ValidationException::withMessages([
|
||||
'file' => ['无效的 JSON 格式'],
|
||||
]);
|
||||
}
|
||||
|
||||
// 验证数据结构
|
||||
$validator = Validator::make($data, [
|
||||
'template' => 'required|array',
|
||||
'template.name' => 'required|string|max:255',
|
||||
'template.version' => 'required|string|max:50',
|
||||
'steps' => 'required|array|min:1',
|
||||
'steps.*.step_number' => 'required|integer',
|
||||
'steps.*.title' => 'required|string|max:255',
|
||||
]);
|
||||
|
||||
if ($validator->fails()) {
|
||||
throw new ValidationException($validator);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($data) {
|
||||
// 创建模板
|
||||
$template = SopTemplate::create([
|
||||
'name' => $data['template']['name'],
|
||||
'description' => $data['template']['description'] ?? null,
|
||||
'category' => $data['template']['category'] ?? null,
|
||||
'tags' => $data['template']['tags'] ?? [],
|
||||
'version' => $data['template']['version'],
|
||||
'status' => 'draft',
|
||||
'applicable_departments' => $data['template']['applicable_departments'] ?? [],
|
||||
'applicable_positions' => $data['template']['applicable_positions'] ?? [],
|
||||
'created_by' => auth()->id(),
|
||||
]);
|
||||
|
||||
// 创建步骤
|
||||
foreach ($data['steps'] as $stepData) {
|
||||
$step = $template->steps()->create([
|
||||
'step_number' => $stepData['step_number'],
|
||||
'title' => $stepData['title'],
|
||||
'content' => $stepData['content'] ?? null,
|
||||
'sort_order' => $stepData['sort_order'] ?? $stepData['step_number'],
|
||||
'is_required' => $stepData['is_required'] ?? true,
|
||||
]);
|
||||
|
||||
// 创建交互任务
|
||||
if (!empty($stepData['interactive_tasks'])) {
|
||||
foreach ($stepData['interactive_tasks'] as $taskData) {
|
||||
$step->interactiveTasks()->create([
|
||||
'task_type' => $taskData['task_type'],
|
||||
'task_config' => $taskData['task_config'] ?? [],
|
||||
'validation_rules' => $taskData['validation_rules'] ?? [],
|
||||
'timeout_seconds' => $taskData['timeout_seconds'] ?? null,
|
||||
'is_required' => $taskData['is_required'] ?? true,
|
||||
]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $template;
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 发布模板
|
||||
*
|
||||
* @param SopTemplate $template
|
||||
* @param string|null $changeLog
|
||||
* @return void
|
||||
*/
|
||||
public function publish(SopTemplate $template, ?string $changeLog = null): void
|
||||
{
|
||||
// 创建版本快照
|
||||
$this->createVersion($template, $changeLog);
|
||||
|
||||
// 更新状态
|
||||
$template->update([
|
||||
'status' => 'published',
|
||||
'published_at' => now(),
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建版本快照
|
||||
*
|
||||
* @param SopTemplate $template
|
||||
* @param string|null $changeLog
|
||||
* @return SopTemplateVersion
|
||||
*/
|
||||
public function createVersion(SopTemplate $template, ?string $changeLog = null): SopTemplateVersion
|
||||
{
|
||||
return SopTemplateVersion::create([
|
||||
'sop_template_id' => $template->id,
|
||||
'version' => $template->version,
|
||||
'change_log' => $changeLog ?? '版本快照',
|
||||
'content_snapshot' => [
|
||||
'template' => $template->toArray(),
|
||||
'steps' => $template->steps->map(function ($step) {
|
||||
return array_merge($step->toArray(), [
|
||||
'interactive_tasks' => $step->interactiveTasks->toArray(),
|
||||
]);
|
||||
})->toArray(),
|
||||
],
|
||||
'created_by' => auth()->id(),
|
||||
'created_at' => now(),
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 归档模板
|
||||
*
|
||||
* @param SopTemplate $template
|
||||
* @return void
|
||||
*/
|
||||
public function archive(SopTemplate $template): void
|
||||
{
|
||||
$template->update([
|
||||
'status' => 'archived',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 复制模板
|
||||
*
|
||||
* @param SopTemplate $template
|
||||
* @param string $newName
|
||||
* @return SopTemplate
|
||||
*/
|
||||
public function duplicate(SopTemplate $template, string $newName): SopTemplate
|
||||
{
|
||||
return DB::transaction(function () use ($template, $newName) {
|
||||
// 复制模板
|
||||
$newTemplate = $template->replicate();
|
||||
$newTemplate->name = $newName;
|
||||
$newTemplate->status = 'draft';
|
||||
$newTemplate->published_at = null;
|
||||
$newTemplate->created_by = auth()->id();
|
||||
$newTemplate->save();
|
||||
|
||||
// 复制步骤
|
||||
foreach ($template->steps as $step) {
|
||||
$newStep = $step->replicate();
|
||||
$newStep->sop_template_id = $newTemplate->id;
|
||||
$newStep->save();
|
||||
|
||||
// 复制交互任务
|
||||
foreach ($step->interactiveTasks as $task) {
|
||||
$newTask = $task->replicate();
|
||||
$newTask->sop_step_id = $newStep->id;
|
||||
$newTask->save();
|
||||
}
|
||||
}
|
||||
|
||||
return $newTemplate;
|
||||
});
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user