dbxKiDesignService.class.php

Go to the documentation of this file.

<?php
namespace dbx\dbxKi;

class dbxKiDesignService {
 
   private const SESSION_KEY = 'design_jobs';
   private const RESULT_CONTRACT = 'dbx.design.result.v1';

   private $designService;
   private $texts;
 
   public function __construct() {
      $this->designService = dbx()->get_include_obj('dbxDesignService', 'dbxDesign_admin');
   }
 
   private function h($value): string {
      return htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8');
   }
 
   private function texts() {
      if ($this->texts) {
         return $this->texts;
      }
      dbx()->get_system_obj('dbxForm', 'use');
      $texts = new \dbxForm();
      $texts->init('ki-design-texts');
      $texts->_fd = 'dbxKi|design-briefing';
      $texts->load_fd_messages();
      $texts->set_form_help_enabled(false);
      $this->texts = $texts;
      return $this->texts;
   }
 
   private function message(string $key, array $replacements = array()): string {
      return $replacements
         ? $this->texts()->format_fd_message($key, $replacements)
         : $this->texts()->get_fd_message($key);
   }
 
   private function url(string $run1, array $params = array()): string {
      $url = '?dbx_modul=dbxKi&dbx_run1=' . rawurlencode($run1);
      foreach ($params as $key => $value) {
         if ($value !== '') {
            $url .= '&' . rawurlencode((string)$key) . '=' . rawurlencode((string)$value);
         }
      }
      return $url;
   }
 
   private function designOptions(): array {
      $items = array();
      foreach ($this->designService->listDesigns() as $name => $meta) {
         $items[$name] = $meta['title'] . ' (' . $name . ')';
      }
      return $items;
   }
 
   private function briefingForm(string $template = 'ki-design-briefing') {
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('ki-design-briefing', $template);
      $form->_fd = 'dbxKi|design-briefing';
      $form->load_fd_messages();
      $form->set_form_help_enabled(false);
      $form->_action = $this->url('briefing_design_export');
      $form->_msg_info = '';
      $selected = $this->designService->normalizeName((string)dbx()->get_request_var('design', 'dbxapp', 'parameter'));
      if (!isset($this->designService->listDesigns()[$selected])) {
         $selected = 'dbxapp';
      }
      $mode = strtolower((string)dbx()->get_request_var('mode', 'update', 'parameter')) === 'create' ? 'create' : 'update';
      $form->_data = array_merge($form->_data, array(
         'mode' => $mode,
         'source_design' => $selected,
         'target_design' => $mode === 'update' ? $selected : '',
         'goal' => '',
         'layout_notes' => '',
         'menu_notes' => '',
         'branding_notes' => '',
         'footer_notes' => '',
         'responsive_notes' => '',
         'preserve_behavior' => 1,
      ));
      $texts = $this->texts();
      $form->add_fld('mode', 'select-single-label', label: $texts->get_fd_message('label_mode'), rules: 'parameter', options: array(
         'update' => $texts->get_fd_message('mode_update'),
         'create' => $texts->get_fd_message('mode_create'),
      ), dd: '');
      $form->add_fld('source_design', 'select-single-label', label: $texts->get_fd_message('label_source_design'), rules: 'parameter|max=63', options: $this->designOptions(), dd: '');
      $form->add_fld('target_design', 'text-label', label: $texts->get_fd_message('label_target_design'), rules: 'parameter+_-|min=2|max=63', placeholder: $texts->get_fd_message('placeholder_target_design'), dd: '');
      $form->add_fld('goal', 'textarea-label', label: $texts->get_fd_message('label_goal'), rules: 'varchar|min=10|max=6000', data: 'rows=7', placeholder: $texts->get_fd_message('placeholder_goal'), dd: '');
      $form->add_fld('layout_notes', 'textarea-label', label: $texts->get_fd_message('label_layout_notes'), rules: 'varchar|max=1800', data: 'rows=3', placeholder: $texts->get_fd_message('placeholder_layout'), dd: '');
      $form->add_fld('menu_notes', 'textarea-label', label: $texts->get_fd_message('label_menu_notes'), rules: 'varchar|max=1800', data: 'rows=3', placeholder: $texts->get_fd_message('placeholder_menu'), dd: '');
      $form->add_fld('branding_notes', 'textarea-label', label: $texts->get_fd_message('label_branding_notes'), rules: 'varchar|max=1800', data: 'rows=3', placeholder: $texts->get_fd_message('placeholder_branding'), dd: '');
      $form->add_fld('footer_notes', 'textarea-label', label: $texts->get_fd_message('label_footer_notes'), rules: 'varchar|max=1800', data: 'rows=3', placeholder: $texts->get_fd_message('placeholder_footer'), dd: '');
      $form->add_fld('responsive_notes', 'textarea-label', label: $texts->get_fd_message('label_responsive_notes'), rules: 'varchar|max=1800', data: 'rows=3', placeholder: $texts->get_fd_message('placeholder_responsive'), dd: '');
      $form->add_fld('preserve_behavior', 'checkbox-label', label: $texts->get_fd_message('label_preserve_behavior'), rules: 'int', dd: '');
      return $form;
   }

   public function renderBriefing(): string {
      // dbxForm ist ein Request-Singleton. Den kompakten Importblock zuerst
      // vollständig rendern und erst danach das eigentliche Briefing
      // initialisieren, damit beide Formulare getrennte IDs und Token behalten.
      $importPanel = $this->renderImportPanel();
      $form = $this->briefingForm();
      $form->add_rep('design_list_url', $this->h('?dbx_modul=dbxDesign_admin&dbx_run1=list'));
      $form->add_rep('import_panel', $importPanel);
      $form->add_rep('bar_title', $this->message('bar_title'));
      $form->add_rep('bar_subtitle', $this->message('bar_subtitle'));
      $form->add_rep('bar_icon', 'bi-stars');
      $form->add_rep('bar_actions', '<a class="btn btn-outline-secondary btn-sm" href="' . $this->h('?dbx_modul=dbxDesign_admin&dbx_run1=list') . '"><i class="bi bi-palette"></i> ' . $this->h($this->message('action_design_studio')) . '</a>');
      foreach ($this->barDefaults() as $key => $value) {
         $form->add_rep($key, $value);
      }
      return $form->run();
   }

   public function handleExport(): void {
      $form = $this->briefingForm();
      if (!$form->submit()) {
         throw new \RuntimeException($this->message('token_error'));
      }
      $in = $this->collectBriefing($form);
      $sourceDir = $this->designService->designDir($in['source_design']);
      if (!is_dir($sourceDir)) {
         throw new \RuntimeException($this->message('source_not_found'));
      }
      if ($in['mode'] === 'update') {
         $in['target_design'] = $in['source_design'];
      } elseif (!$this->designService->isValidName($in['target_design'])) {
         throw new \InvalidArgumentException($this->message('target_required'));
      } elseif (isset($this->designService->listDesigns()[$in['target_design']])) {
         throw new \InvalidArgumentException($this->message('target_exists'));
      }
      if (trim($in['goal']) === '') {
         throw new \InvalidArgumentException($this->message('goal_required'));
      }
      if (!class_exists('ZipArchive')) {
         throw new \RuntimeException($this->message('zip_unavailable'));
      }
 
      $tmp = tempnam(sys_get_temp_dir(), 'dbx-design-briefing-');
      $zip = new \ZipArchive();
      if ($tmp === false || $zip->open($tmp, \ZipArchive::CREATE | \ZipArchive::OVERWRITE) !== true) {
         throw new \RuntimeException($this->message('briefing_zip_error'));
      }
      $manifest = array(
         'contract' => 'dbx.design.briefing.v1',
         'result_contract' => self::RESULT_CONTRACT,
         'mode' => $in['mode'],
         'source_design' => $in['source_design'],
         'target_design' => $in['target_design'],
         'created_at' => date(DATE_ATOM),
         'required_result_root' => 'result/design/',
      );
      $context = array(
         'design' => $this->designService->readMetadata($in['source_design']),
         'validation' => $this->designService->validateDesignDirectory($sourceDir, false),
         'files' => array_keys($this->designService->relativeFiles($sourceDir)),
         'runtime' => array(
            'content_slot' => '[dbx:content]',
            'design_slots' => array('[dbx:logo]', '[dbx:branding]', '[dbx:footer]'),
            'template_engine' => 'dbxTPL',
            'admin_module' => 'dbxDesign_admin',
         ),
      );
      $zip->addFromString('00-START.md', $this->startInstructions($in));
      $zip->addFromString('manifest.json', json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
      $zip->addFromString('briefing.json', json_encode($in, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
      $zip->addFromString('context.json', json_encode($context, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
      $zip->addFromString('KI-AUFTRAG.md', $this->aiInstructions($in));
      $zip->addFromString('RESULT-FORMAT.md', $this->resultFormat());
      foreach ($this->designService->relativeFiles($sourceDir) as $relative => $absolute) {
         $zip->addFile($absolute, 'source-design/' . $in['source_design'] . '/' . $relative);
      }
      $zip->close();
      $name = 'dbxki-design-' . $in['mode'] . '-' . $in['target_design'] . '.zip';
      header('Content-Type: application/zip');
      header('Content-Disposition: attachment; filename="' . $name . '"');
      header('Content-Length: ' . filesize($tmp));
      readfile($tmp);
      @unlink($tmp);
      exit;
   }
 
   private function collectBriefing($form): array {
      $rules = array(
         'mode' => 'parameter',
         'source_design' => 'parameter|max=63',
         'target_design' => 'parameter+_-|max=63',
         'goal' => 'varchar|max=6000',
         'layout_notes' => 'varchar|max=1800',
         'menu_notes' => 'varchar|max=1800',
         'branding_notes' => 'varchar|max=1800',
         'footer_notes' => 'varchar|max=1800',
         'responsive_notes' => 'varchar|max=1800',
         'preserve_behavior' => 'int',
      );
      $out = array();
      foreach ($rules as $name => $rule) {
         $out[$name] = $form->get_fld_value($name, '', $rule);
      }
      $out['mode'] = $out['mode'] === 'create' ? 'create' : 'update';
      $out['source_design'] = $this->designService->normalizeName($out['source_design']);
      $out['target_design'] = $this->designService->normalizeName($out['target_design']);
      return $out;
   }
 
   private function startInstructions(array $in): string {
      return "# dbxKi Design-Auftrag\n\n"
         . "1. Lies `KI-AUFTRAG.md`, `briefing.json`, `context.json` und das komplette Ausgangsdesign.\n"
         . "2. Bearbeite ausschließlich Design-Dateien. Keine Fachlogik, Datenbank, Rechte oder Module ändern.\n"
         . "3. Lege nur neue/geänderte Dateien unter `result/design/` ab.\n"
         . "4. Erzeuge `manifest.json` im Antwort-ZIP nach `RESULT-FORMAT.md`.\n"
         . "5. Ergebnis als ZIP zurückgeben. Ziel: `" . $in['target_design'] . "`.\n";
   }
 
   private function aiInstructions(array $in): string {
      return "# Verbindlicher Design-Auftrag\n\n"
         . "## Ziel\n\n" . $in['goal'] . "\n\n"
         . "## Aufteilung\n\n" . ($in['layout_notes'] ?: '(aus dem Ziel ableiten)') . "\n\n"
         . "## Menü\n\n" . ($in['menu_notes'] ?: '(bestehende Navigation kompatibel weiterverwenden)') . "\n\n"
         . "## Branding\n\n" . ($in['branding_notes'] ?: '(bestehendes Branding behutsam weiterentwickeln)') . "\n\n"
         . "## Footer\n\n" . ($in['footer_notes'] ?: '(Fenster-Dock und Rechtelinks funktionsfähig erhalten)') . "\n\n"
         . "## Mobil / Barrierefreiheit\n\n" . ($in['responsive_notes'] ?: 'Responsive, tastaturbedienbar und kontrastreich umsetzen.') . "\n\n"
         . "## Nicht verhandelbar\n\n"
         . "- `[dbx:content]` genau einmal erhalten.\n"
         . "- `{dbx:title}`, `{dbx:design}`, `{dbx:skin_css}`, `{dbx:skin_class}` und `core.js?design={dbx:design}` erhalten.\n"
         . "- dbxMenu-Aufrufe, Admin-Menü, Ajax, openWin, Fenster-Dock, dbxForm und dbxReport bleiben funktionsfähig.\n"
         . "- Optionale Bereiche über `[dbx:logo]`, `[dbx:branding]`, `[dbx:footer]` und die gleichnamigen Dateien unter `htm/` strukturieren.\n"
         . "- Keine PHP-Dateien, keine Datenbank, keine DD/FD, keine Module und keine externen Build-Abhängigkeiten liefern.\n"
         . "- Das Paket bleibt eigenständig; keine privaten Dateien eines anderen Designs referenzieren.\n";
   }
 
   private function resultFormat(): string {
      return "# Antwort-ZIP\n\n"
         . "```text\nmanifest.json\nresult/design/htm/default.htm\nresult/design/css/design-custom.css\n...\n```\n\n"
         . "`manifest.json`:\n\n"
         . "```json\n{\n  \"contract\": \"" . self::RESULT_CONTRACT . "\",\n"
         . "  \"mode\": \"create|update\",\n  \"source_design\": \"dbxapp\",\n  \"target_design\": \"zielname\",\n"
         . "  \"summary\": \"Kurze Beschreibung\"\n}\n```\n\n"
         . "Bei `update` nur neue/geänderte Dateien liefern. Bei `create` darf ebenfalls ein Delta zum mitgelieferten Ausgangsdesign geliefert werden. dbxapp baut daraus im Staging ein vollständiges Paket und prüft es vor der Freigabe.\n";
   }
 
   private function importForm() {
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('ki-design-result-import', 'ki-design-import');
      $form->_fd = 'dbxKi|design-briefing';
      $form->load_fd_messages();
      $form->set_form_help_enabled(false);
      $form->_action = $this->url('design_bundle_import');
      $form->_msg_info = '';
      return $form;
   }

   public function renderImportPanel(): string {
      return $this->importForm()->run();
   }

   public function handleImport(): string {
      $form = $this->importForm();
      try {
         if (!$form->submit()) {
            throw new \RuntimeException($this->message('token_error'));
         }
         $upload = is_array($_FILES['design_zip'] ?? null) ? $_FILES['design_zip'] : array();
         $state = $this->extractResult($upload);
         $token = bin2hex(random_bytes(12));
         if (!isset($_SESSION['dbx']['dbxKi'][self::SESSION_KEY]) || !is_array($_SESSION['dbx']['dbxKi'][self::SESSION_KEY])) {
            $_SESSION['dbx']['dbxKi'][self::SESSION_KEY] = array();
         }
         $_SESSION['dbx']['dbxKi'][self::SESSION_KEY][$token] = $state;
         return $this->renderPreview($token, $state);
      } catch (\Throwable $e) {
         return dbx()->get_system_obj('dbxTPL')->get_tpl('dbxKi|ki-design-result', array(
            'result_class' => 'alert-danger',
            'result_title' => $this->message('import_failed_title'),
            'result_message' => $this->h($e->getMessage()),
            'result_actions' => '<a class="btn btn-outline-secondary" href="' . $this->h($this->url('briefing_design')) . '">' . $this->h($this->message('action_back')) . '</a>',
         ));
      }
   }
 
   private function extractResult(array $file): array {
      if (($file['error'] ?? UPLOAD_ERR_NO_FILE) !== UPLOAD_ERR_OK) {
         throw new \InvalidArgumentException($this->message('zip_select'));
      }
      $tmp = (string)($file['tmp_name'] ?? '');
      if ($tmp === '' || !is_uploaded_file($tmp)) {
         throw new \InvalidArgumentException($this->message('zip_upload_invalid'));
      }
      $maxBytes = max(1, (int)dbx()->get_config('dbxKi', 'max_bundle_bytes', 52428800));
      if ((int)($file['size'] ?? 0) > $maxBytes) {
         throw new \InvalidArgumentException($this->message('zip_too_large'));
      }
      if (!class_exists('ZipArchive')) {
         throw new \RuntimeException($this->message('zip_unavailable'));
      }
      $work = dbx()->os_path(rtrim(dbx()->get_file_dir(), '/\\') . '/tmp/ki-design/' . bin2hex(random_bytes(10)));
      if (!mkdir($work, 0777, true) && !is_dir($work)) {
         throw new \RuntimeException($this->message('staging_error'));
      }
      try {
         $zip = new \ZipArchive();
         if ($zip->open($tmp) !== true) {
            throw new \InvalidArgumentException($this->message('zip_open_error'));
         }
         $total = 0;
         $maxFiles = max(50, (int)dbx()->get_config('dbxKi', 'max_bundle_files', 50));
         if ($zip->numFiles > $maxFiles) {
            $zip->close();
            throw new \InvalidArgumentException($this->message('zip_too_many_files'));
         }
         for ($i = 0; $i < $zip->numFiles; $i++) {
            $name = str_replace('\\', '/', (string)$zip->getNameIndex($i));
            $stat = $zip->statIndex($i);
            $total += (int)($stat['size'] ?? 0);
            if ($name === '' || $name[0] === '/' || strpos($name, '..') !== false || strpos($name, ':') !== false || strpos($name, "\0") !== false) {
               $zip->close();
               throw new \InvalidArgumentException($this->message('zip_path_invalid', array('path' => $name)));
            }
            if ($total > $maxBytes) {
               $zip->close();
               throw new \InvalidArgumentException($this->message('zip_unpacked_too_large'));
            }
         }
         if (!$zip->extractTo($work)) {
            $zip->close();
            throw new \RuntimeException($this->message('zip_extract_error'));
         }
         $zip->close();
         $root = $this->findResultRoot($work);
         $manifestFile = $root . DIRECTORY_SEPARATOR . 'manifest.json';
         $resultDir = $root . DIRECTORY_SEPARATOR . 'result' . DIRECTORY_SEPARATOR . 'design';
         $manifest = is_file($manifestFile) ? json_decode((string)file_get_contents($manifestFile), true) : null;
         if (!is_array($manifest) || ($manifest['contract'] ?? '') !== self::RESULT_CONTRACT) {
            throw new \InvalidArgumentException($this->message('manifest_contract_error', array('contract' => self::RESULT_CONTRACT)));
         }
         if (!is_dir($resultDir)) {
            throw new \InvalidArgumentException($this->message('result_directory_missing'));
         }
         $rawMode = strtolower(trim((string)($manifest['mode'] ?? '')));
         if (!in_array($rawMode, array('create', 'update'), true)) {
            throw new \InvalidArgumentException($this->message('manifest_mode_error'));
         }
         $mode = $rawMode;
         $source = $this->designService->normalizeName((string)($manifest['source_design'] ?? ''));
         $target = $this->designService->normalizeName((string)($manifest['target_design'] ?? ''));
         if (!$this->designService->isValidName($source) || !$this->designService->isValidName($target)) {
            throw new \InvalidArgumentException($this->message('manifest_design_error'));
         }
         $designs = $this->designService->listDesigns();
         if (!isset($designs[$source])) {
            throw new \InvalidArgumentException($this->message('manifest_source_missing'));
         }
         if ($mode === 'create' && isset($designs[$target])) {
            throw new \InvalidArgumentException($this->message('manifest_target_exists'));
         }
         if ($mode === 'update' && !isset($designs[$target])) {
            throw new \InvalidArgumentException($this->message('manifest_target_missing'));
         }
         $files = $this->designService->relativeFiles($resultDir);
         if (!$files) {
            throw new \InvalidArgumentException($this->message('result_empty'));
         }
         foreach ($files as $relative => $absolute) {
            $fileError = $this->designService->validateResultFile($relative, $absolute);
            if ($fileError !== '') {
               throw new \InvalidArgumentException($this->message('result_file_invalid', array('file' => $relative)));
            }
         }
      } catch (\Throwable $e) {
         $this->removeWorkDir($work);
         throw $e;
      }
      return array(
         'work_dir' => $work,
         'result_dir' => $resultDir,
         'manifest' => $manifest,
         'mode' => $mode,
         'source_design' => $source,
         'target_design' => $target,
         'files' => array_keys($files),
      );
   }
 
   private function findResultRoot(string $work): string {
      if (is_file($work . '/manifest.json')) {
         return $work;
      }
      $children = glob($work . '/*', GLOB_ONLYDIR) ?: array();
      if (count($children) === 1 && is_file($children[0] . '/manifest.json')) {
         return $children[0];
      }
      return $work;
   }
 
   private function renderPreview(string $token, array $state): string {
      $targetBase = is_dir($this->designService->designDir($state['target_design']))
         ? $this->designService->designDir($state['target_design'])
         : $this->designService->designDir($state['source_design']);
      $rows = '';
      foreach ($state['files'] as $relative) {
         $new = $state['result_dir'] . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $relative);
         $old = $targetBase . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $relative);
         $statusKey = !is_file($old) ? 'new' : (hash_file('sha256', $old) === hash_file('sha256', $new) ? 'unchanged' : 'changed');
         $class = $statusKey === 'new' ? 'text-bg-success' : ($statusKey === 'changed' ? 'text-bg-warning' : 'text-bg-secondary');
         $rows .= '<tr><td><code>' . $this->h($relative) . '</code></td><td><span class="badge ' . $class . '">' . $this->h($this->message('status_' . $statusKey)) . '</span></td><td class="text-end">' . number_format((int)filesize($new), 0, ',', '.') . ' B</td></tr>';
      }
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('ki-design-result-apply', 'ki-design-preview');
      $form->_fd = 'dbxKi|design-briefing';
      $form->load_fd_messages();
      $form->set_form_help_enabled(false);
      $form->_action = $this->url('design_bundle_apply');
      $form->_msg_info = '';
      $form->_data['job_token'] = $token;
      $form->add_fld('job_token', 'dbx|hidden', rules: 'parameter', dd: '');
      $form->add_rep('mode', $this->h($state['mode']));
      $form->add_rep('source_design', $this->h($state['source_design']));
      $form->add_rep('target_design', $this->h($state['target_design']));
      $form->add_rep('summary', $this->h((string)($state['manifest']['summary'] ?? '')));
      $form->add_rep('file_count', count($state['files']));
      $form->add_rep('file_rows', $rows);
      $form->add_rep('back_url', $this->h($this->url('briefing_design')));
      $form->add_rep('bar_title', $this->message('preview_title'));
      $form->add_rep('bar_subtitle', $this->h($state['mode'] . ': ' . $state['source_design'] . ' → ' . $state['target_design']));
      $form->add_rep('bar_icon', 'bi-search');
      $form->add_rep('bar_actions', '');
      foreach ($this->barDefaults() as $key => $value) {
         $form->add_rep($key, $value);
      }
      return $form->run();
   }
 
   private function barDefaults(): array {
      return array(
         'bar_class' => 'dbx-module-bar',
         'bar_title_class' => 'dbx-module-bar-titleblock',
         'bar_title_pre' => '',
         'bar_title_heading_attrs' => '',
         'bar_middle' => '',
         'bar_extra' => '',
         'bar_actions_class' => 'dbx-module-bar-actions',
      );
   }

   public function handleApply(): string {
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('ki-design-result-apply', 'ki-design-preview');
      $form->_fd = 'dbxKi|design-briefing';
      $form->load_fd_messages();
      $form->set_form_help_enabled(false);
      $form->_action = $this->url('design_bundle_apply');
      $form->_msg_info = '';
      $form->add_fld('job_token', 'dbx|hidden', rules: 'parameter', dd: '');
      try {
         if (!$form->submit()) {
            throw new \RuntimeException($this->message('token_error'));
         }
         $token = (string)$form->get_fld_value('job_token', '', 'parameter');
         $state = $_SESSION['dbx']['dbxKi'][self::SESSION_KEY][$token] ?? null;
         if (!is_array($state)) {
            throw new \RuntimeException($this->message('preview_expired'));
         }
         $result = $this->designService->applyResult(
            $state['source_design'],
            $state['target_design'],
            $state['result_dir'],
            $state['mode']
         );
         $this->removeWorkDir((string)($state['work_dir'] ?? ''));
         unset($_SESSION['dbx']['dbxKi'][self::SESSION_KEY][$token]);
         $backup = (string)($result['backup'] ?? '');
         $message = $this->message('apply_message', array('name' => $result['name']));
         if ($backup !== '') {
            $message .= ' ' . $this->message('backup_message', array('backup' => basename($backup)));
         }
         return dbx()->get_system_obj('dbxTPL')->get_tpl('dbxKi|ki-design-result', array(
            'result_class' => 'alert-success',
            'result_title' => $this->message('apply_success_title'),
            'result_message' => $this->h($message),
            'result_actions' => '<a class="btn btn-primary" target="_blank" href="' . $this->h('?dbx_design=' . rawurlencode($result['name'])) . '"><i class="bi bi-eye"></i> ' . $this->h($this->message('action_view_design')) . '</a> '
               . '<a class="btn btn-outline-secondary" href="' . $this->h('?dbx_modul=dbxDesign_admin&dbx_run1=list') . '">' . $this->h($this->message('action_design_studio')) . '</a>',
         ));
      } catch (\Throwable $e) {
         return dbx()->get_system_obj('dbxTPL')->get_tpl('dbxKi|ki-design-result', array(
            'result_class' => 'alert-danger',
            'result_title' => $this->message('apply_error_title'),
            'result_message' => $this->h($e->getMessage()),
            'result_actions' => '<a class="btn btn-outline-secondary" href="' . $this->h($this->url('briefing_design')) . '">' . $this->h($this->message('action_back')) . '</a>',
         ));
      }
   }
 
   private function removeWorkDir(string $dir): void {
      if ($dir === '' || !is_dir($dir)) {
         return;
      }
      $root = rtrim(str_replace('\\', '/', dbx()->os_path(rtrim(dbx()->get_file_dir(), '/\\') . '/tmp/ki-design')), '/');
      $normalized = rtrim(str_replace('\\', '/', dbx()->os_path($dir)), '/');
      if ($normalized === $root || strpos($normalized, $root . '/') !== 0) {
         return;
      }
      $it = new \RecursiveIteratorIterator(
         new \RecursiveDirectoryIterator($dir, \FilesystemIterator::SKIP_DOTS),
         \RecursiveIteratorIterator::CHILD_FIRST
      );
      foreach ($it as $file) {
         if ($file->isDir()) {
            @rmdir($file->getPathname());
         } else {
            @unlink($file->getPathname());
         }
      }
      @rmdir($dir);
   }
}
?>