diff --git a/web/app/Controllers/Admin/UserCopyController.php b/web/app/Controllers/Admin/UserCopyController.php new file mode 100644 index 00000000..670d698a --- /dev/null +++ b/web/app/Controllers/Admin/UserCopyController.php @@ -0,0 +1,208 @@ +service()->workspace( + $request->getQueryParams() + ); + } catch (\Throwable $exception) { + error_log('User copy administrator page failed: ' + . get_class($exception)); + $error = '用户界面译文暂时无法读取,请稍后重试。'; + $status = 503; + } + + $bootstrap = json_encode( + $workspace, + JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT + | JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE + | JSON_THROW_ON_ERROR + ); + $smarty = $this->view()->assign([ + 'user_copy_workspace' => $workspace, + 'user_copy_error' => $error, + 'user_copy_bootstrap_json' => $bootstrap, + 'user_copy_can_manage' => AdminPermission::isSuperAdmin(), + ]); + $response->getBody()->write( + $smarty->fetch('admin/user_copy.tpl') + ); + return $response->withStatus($status) + ->withHeader('Cache-Control', 'private, no-store'); + } + + public function entries($request, $response, $args) + { + try { + $workspace = $this->service()->workspace( + $request->getQueryParams() + ); + return $this->json($response, ['workspace' => $workspace]); + } catch (UserCopyAdminException $exception) { + return $this->failure( + $response, + $exception->getMessage(), + $exception->httpStatus + ); + } catch (UserCopyCatalogException $exception) { + return $this->failure($response, $exception->getMessage(), 422); + } catch (\Throwable $exception) { + error_log('User copy entries failed: ' . get_class($exception)); + return $this->failure( + $response, + '用户界面译文暂时无法读取,请稍后重试。', + 503 + ); + } + } + + public function history($request, $response, $args) + { + try { + $history = $this->service()->history( + (string) ($request->getQueryParams()['locale'] ?? '') + ); + return $this->json($response, ['history' => $history]); + } catch (UserCopyAdminException $exception) { + return $this->failure( + $response, + $exception->getMessage(), + $exception->httpStatus + ); + } catch (UserCopyCatalogException $exception) { + return $this->failure($response, $exception->getMessage(), 422); + } catch (\Throwable $exception) { + error_log('User copy history failed: ' . get_class($exception)); + return $this->failure($response, '发布历史暂时无法读取。', 503); + } + } + + public function draft($request, $response, $args) + { + return $this->write($request, $response, $args, 'draft'); + } + + public function publish($request, $response, $args) + { + return $this->write($request, $response, $args, 'publish'); + } + + public function rollback($request, $response, $args) + { + return $this->write($request, $response, $args, 'rollback'); + } + + private function write($request, $response, array $args, string $action) + { + if (!AdminPermission::isSuperAdmin()) { + return $this->failure($response, '只有超级管理员可以修改译文。', 403); + } + $input = $request->getParsedBody(); + if (!is_array($input)) { + return $this->failure($response, '请求格式不正确。', 400); + } + + try { + $actor = $this->actor(); + $service = $this->service(); + if ($action === 'draft') { + $result = $service->saveDraft( + $actor, + (string) ($args['copy_key'] ?? ''), + (string) ($input['locale'] ?? ''), + (string) ($input['text'] ?? ''), + ($input['hidden'] ?? false) === true + ? 'hidden' : 'visible', + (int) ($input['draft_version'] ?? 0) + ); + } elseif ($action === 'publish') { + $idempotencyKey = trim((string) $request->getHeaderLine( + 'Idempotency-Key' + )); + if ($idempotencyKey === '') { + return $this->failure( + $response, + '发布请求缺少幂等标识,请刷新页面后重试。', + 400 + ); + } + $result = $service->publish( + $actor, + (string) ($input['locale'] ?? ''), + hash('sha256', $idempotencyKey) + ); + } else { + $result = $service->rollback( + $actor, + (string) ($input['locale'] ?? ''), + (string) ($args['publication_key'] ?? '') + ); + } + return $this->json($response, ['entry' => $result]); + } catch (UserCopyAdminException $exception) { + return $this->failure( + $response, + $exception->getMessage(), + $exception->httpStatus + ); + } catch (UserCopyCatalogException $exception) { + return $this->failure($response, $exception->getMessage(), 409); + } catch (\Throwable $exception) { + error_log('User copy write failed: ' . get_class($exception)); + return $this->failure( + $response, + '译文操作失败,请刷新页面核对后再试。', + 503 + ); + } + } + + private function json($response, array $payload, int $status = 200) + { + return $response->withJson(['ret' => 1] + $payload, $status) + ->withHeader('Cache-Control', 'private, no-store'); + } + + private function failure($response, string $message, int $status) + { + return $response->withJson([ + 'ret' => 0, + 'msg' => $message, + ], $status)->withHeader('Cache-Control', 'private, no-store'); + } + + private function service(): UserCopyAdminService + { + return UserCopyAdminService::fromApplication(); + } + + /** @return array{user_id:int,is_admin:bool,is_super_admin:bool,can_manage:bool} */ + private function actor(): array + { + $user = Auth::getUser(); + $super = AdminPermission::isSuperAdmin(); + return [ + 'user_id' => is_object($user) && isset($user->id) + ? (int) $user->id : 0, + 'is_admin' => is_object($user) && method_exists($user, 'isAdmin') + ? (bool) $user->isAdmin() : false, + 'is_super_admin' => $super, + 'can_manage' => $super, + ]; + } +} diff --git a/web/config/routes.php b/web/config/routes.php index 9781ac61..99296adf 100644 --- a/web/config/routes.php +++ b/web/config/routes.php @@ -331,6 +331,26 @@ $app->group('/admin', function () { $this->post('/legal/{slug:terms|privacy}/publish', 'App\Controllers\Admin\LegalController:publish')->add(new SuperAdmin()); $this->post('/legal/{slug:terms|privacy}/preview', 'App\Controllers\Admin\LegalController:preview'); + // Source-owned Chinese copy with administrator-managed target locales. + $this->get('/user-copy', + 'App\Controllers\Admin\UserCopyController:index') + ->add(new SuperAdmin()); + $this->get('/user-copy/entries', + 'App\Controllers\Admin\UserCopyController:entries') + ->add(new SuperAdmin()); + $this->get('/user-copy/publications', + 'App\Controllers\Admin\UserCopyController:history') + ->add(new SuperAdmin()); + $this->put('/user-copy/entries/{copy_key:[a-z0-9._-]+}/draft', + 'App\Controllers\Admin\UserCopyController:draft') + ->add(new SuperAdmin()); + $this->post('/user-copy/publications', + 'App\Controllers\Admin\UserCopyController:publish') + ->add(new SuperAdmin()); + $this->post('/user-copy/publications/{publication_key:[a-f0-9]{32}}/rollback', + 'App\Controllers\Admin\UserCopyController:rollback') + ->add(new SuperAdmin()); + })->add(new Admin()); // API diff --git a/web/public/cloud/admin-user-copy.css b/web/public/cloud/admin-user-copy.css new file mode 100644 index 00000000..258af282 --- /dev/null +++ b/web/public/cloud/admin-user-copy.css @@ -0,0 +1,81 @@ +.user-copy-admin { --copy-ink: #17364a; --copy-muted: #718795; --copy-line: #dce6ea; --copy-soft: #f5f8f9; --copy-teal: #159fa6; } +.user-copy-page-actions { display: flex; justify-content: flex-end; align-items: center; gap: 9px; flex-wrap: wrap; } +.user-copy-toolbar { margin-bottom: 16px; padding: 18px; border: 1px solid var(--copy-line); border-radius: 14px; background: #fff; display: grid; grid-template-columns: minmax(220px, .8fr) minmax(180px, .55fr) minmax(320px, 1.4fr); gap: 16px; align-items: end; } +.user-copy-toolbar label > span { margin-bottom: 7px; display: block; color: var(--copy-muted); font-size: 12px; font-weight: 700; } +.user-copy-toolbar-note { min-height: 48px; padding: 10px 13px; border-radius: 10px; color: #3d6874; background: #edf8f7; display: flex; align-items: center; gap: 10px; font-size: 12px; line-height: 1.55; } +.user-copy-toolbar-note i { color: var(--copy-teal); font-size: 20px; } +.user-copy-coverage { margin-bottom: 16px; display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 12px; } +.user-copy-coverage article { padding: 17px 18px; border: 1px solid var(--copy-line); border-radius: 13px; background: #fff; } +.user-copy-coverage article span { display: block; color: var(--copy-muted); font-size: 12px; } +.user-copy-coverage article strong { margin-top: 5px; display: block; color: var(--copy-ink); font-size: 23px; } +.user-copy-progress { height: 7px; border-radius: 999px; background: #e8eef0; grid-column: 1 / -2; overflow: hidden; } +.user-copy-progress span { width: 0; height: 100%; border-radius: inherit; background: linear-gradient(90deg, #21b7ad, #108c9d); display: block; transition: width .25s ease; } +.user-copy-coverage > p { margin: -8px 0 0; color: var(--copy-muted); display: flex; justify-content: flex-end; align-items: baseline; gap: 7px; font-size: 11px; } +.user-copy-coverage > p strong { color: var(--copy-ink); font-size: 18px; } +.user-copy-catalog { border-color: var(--copy-line); border-radius: 14px; overflow: hidden; } +.user-copy-catalog-head { display: flex; justify-content: space-between; align-items: end; gap: 20px; } +.user-copy-filters { display: flex; align-items: center; justify-content: flex-end; gap: 10px; flex-wrap: wrap; } +.user-copy-search { min-width: 270px; height: 38px; padding: 0 11px; border: 1px solid var(--copy-line); border-radius: 9px; background: #fff; display: flex; align-items: center; gap: 8px; } +.user-copy-search i { color: #8da0aa; font-size: 18px; } +.user-copy-search input { width: 100%; border: 0; outline: 0; color: var(--copy-ink); background: transparent; font-size: 13px; } +.user-copy-filters .form-select { min-width: 142px; } +.user-copy-toast-filter { min-height: 38px; padding: 0 11px; border: 1px solid var(--copy-line); border-radius: 9px; display: inline-flex; align-items: center; gap: 7px; color: #526d7a; font-size: 12px; font-weight: 700; cursor: pointer; } +.user-copy-list { display: grid; gap: 12px; } +.user-copy-entry { padding: 18px; border: 1px solid var(--copy-line); border-radius: 12px; background: #fff; } +.user-copy-entry-meta { margin-bottom: 14px; display: flex; align-items: center; gap: 8px; flex-wrap: wrap; } +.user-copy-entry-meta code { color: #1b5368; font-size: 12px; font-weight: 700; } +.user-copy-entry-meta > span { padding: 4px 8px; border-radius: 999px; font-size: 10px; font-weight: 750; } +.user-copy-kind { color: #687f8b; background: #edf2f4; } +.user-copy-state.is-published { color: #168058; background: #e5f7ef; } +.user-copy-state.is-draft { color: #8b6717; background: #fff4d7; } +.user-copy-state.is-missing { color: #7b6b75; background: #f2edef; } +.user-copy-state.is-hidden { color: #a04450; background: #fdecef; } +.user-copy-state.is-invalid { color: #a04450; background: #fdecef; } +.user-copy-critical { color: #aa3e49; background: #fde9ec; } +.user-copy-entry-columns { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.2fr); gap: 14px; } +.user-copy-source,.user-copy-target { min-width: 0; } +.user-copy-field-label { margin-bottom: 7px; color: var(--copy-muted); display: block; font-size: 11px; font-weight: 750; } +.user-copy-source-text { min-height: 78px; padding: 12px 13px; border: 1px solid #e4ebee; border-radius: 9px; color: #3f5967; background: var(--copy-soft); white-space: pre-wrap; overflow-wrap: anywhere; } +.user-copy-target-head { display: flex; justify-content: space-between; align-items: center; gap: 10px; } +.user-copy-hide { margin-bottom: 7px; display: inline-flex; align-items: center; gap: 6px; color: #6f8490; font-size: 11px; } +.user-copy-target textarea { min-height: 78px; resize: vertical; } +.user-copy-parameters { margin: 7px 0 0; color: #8a6c25; font: 11px/1.55 ui-monospace, SFMono-Regular, Menlo, monospace; } +.user-copy-validation-error { margin: 7px 0 0; color: #a04450; font-size: 11px; line-height: 1.55; } +.user-copy-entry-actions { margin-top: 13px; display: flex; justify-content: flex-end; gap: 8px; flex-wrap: wrap; } +.user-copy-empty { margin: 0; padding: 48px 12px; color: var(--copy-muted); text-align: center; } +.user-copy-preview,.user-copy-history { width: min(520px, 100vw); height: 100vh; padding: 22px; position: fixed; z-index: 1061; top: 0; right: 0; background: #fff; box-shadow: -18px 0 50px rgba(22, 49, 64, .16); overflow-y: auto; } +.user-copy-preview[hidden],.user-copy-history[hidden],.user-copy-backdrop[hidden] { display: none; } +.user-copy-preview > header,.user-copy-history > header { margin-bottom: 18px; padding-bottom: 15px; border-bottom: 1px solid var(--copy-line); display: flex; justify-content: space-between; align-items: center; gap: 16px; } +.user-copy-preview header span,.user-copy-history header span { color: var(--copy-teal); font-size: 9px; font-weight: 800; letter-spacing: .14em; text-transform: uppercase; } +.user-copy-preview h2,.user-copy-history h2 { margin: 4px 0 0; color: var(--copy-ink); font-size: 20px; } +.user-copy-preview header button,.user-copy-history header button { width: 38px; height: 38px; border: 0; border-radius: 50%; color: #617986; background: transparent; font-size: 21px; } +.user-copy-preview > p { color: var(--copy-muted); font-size: 12px; line-height: 1.7; } +.user-copy-preview iframe { width: 100%; min-height: 360px; border: 1px solid var(--copy-line); border-radius: 11px; background: #f4f7f9; } +.user-copy-backdrop { padding: 0; border: 0; position: fixed; z-index: 1060; inset: 0; background: rgba(14, 35, 47, .34); } +body.user-copy-drawer-open { overflow: hidden; } +.user-copy-history-empty { padding: 42px 12px; color: var(--copy-muted); text-align: center; } +.user-copy-history-item { padding: 15px 0; border-bottom: 1px solid var(--copy-line); } +.user-copy-history-item > div { display: flex; justify-content: space-between; gap: 12px; } +.user-copy-history-item time { color: var(--copy-muted); font-size: 11px; } +.user-copy-history-item p { margin: 10px 0; color: #4e6875; white-space: pre-wrap; } + +@media (max-width: 991.98px) { + .user-copy-toolbar { grid-template-columns: 1fr 1fr; } + .user-copy-toolbar-note { grid-column: 1 / -1; } + .user-copy-catalog-head { align-items: stretch; flex-direction: column; } + .user-copy-filters { justify-content: flex-start; } + .user-copy-entry-columns { grid-template-columns: 1fr; } +} +@media (max-width: 575.98px) { + .user-copy-page-actions,.user-copy-page-actions .btn { width: 100%; } + .user-copy-page-actions .admin-config-status { width: 100%; text-align: center; } + .user-copy-toolbar { padding: 14px; grid-template-columns: 1fr; } + .user-copy-toolbar-note { grid-column: auto; } + .user-copy-coverage { grid-template-columns: repeat(2, minmax(0, 1fr)); } + .user-copy-progress { grid-column: 1 / -1; } + .user-copy-coverage > p { margin-top: 0; grid-column: 1 / -1; } + .user-copy-filters,.user-copy-search,.user-copy-filters label,.user-copy-filters .form-select { width: 100%; min-width: 0; } + .user-copy-entry { padding: 14px; } + .user-copy-entry-actions > .btn { flex: 1 1 calc(50% - 8px); } + .user-copy-preview,.user-copy-history { padding: 17px; } +} diff --git a/web/public/cloud/admin-user-copy.js b/web/public/cloud/admin-user-copy.js new file mode 100644 index 00000000..646f0df4 --- /dev/null +++ b/web/public/cloud/admin-user-copy.js @@ -0,0 +1,401 @@ +(function () { + 'use strict'; + + var root = document.querySelector('[data-user-copy-admin]'); + var bootstrapNode = document.getElementById('user-copy-bootstrap'); + if (!root || !bootstrapNode) return; + + var workspace; + try { workspace = JSON.parse(bootstrapNode.textContent || '{}'); } + catch (error) { workspace = null; } + if (!workspace || workspace.schema !== 1) return; + + var canManage = root.dataset.canManage === '1'; + var transport = window.VenixAdminRequestRuntime + ? window.VenixAdminRequestRuntime.create() : null; + var feedback = document.getElementById('user-copy-feedback'); + var pageSelect = document.getElementById('user-copy-page'); + var localeSelect = document.getElementById('user-copy-locale'); + var search = document.getElementById('user-copy-search'); + var stateFilter = document.getElementById('user-copy-state'); + var toastOnly = document.getElementById('user-copy-toast-only'); + var list = document.getElementById('user-copy-list'); + var empty = document.getElementById('user-copy-empty'); + var preview = document.getElementById('user-copy-preview'); + var previewFrame = document.getElementById('user-copy-preview-frame'); + var history = document.getElementById('user-copy-history'); + var historyList = document.getElementById('user-copy-history-list'); + var backdrop = document.getElementById('user-copy-backdrop'); + var publishLocaleButton = document.getElementById('user-copy-publish'); + var historyOpenButton = document.getElementById('user-copy-history-open'); + var uncertain = false; + + function element(tag, className, text) { + var node = document.createElement(tag); + if (className) node.className = className; + if (text !== undefined) node.textContent = text; + return node; + } + + function inform(message, state) { + feedback.textContent = String(message || ''); + feedback.className = 'admin-config-status' + (state ? ' is-' + state : ''); + } + + function stateLabel(entry) { + if (entry.hidden) return '已隐藏'; + if (entry.draft && entry.draft.validation_state !== 'valid') return '无效草稿'; + if (entry.state === 'published') return '已发布'; + if (entry.state === 'draft') return '仅有草稿'; + return '待翻译'; + } + + function stateClass(entry) { + if (entry.hidden) return 'is-hidden'; + if (entry.draft && entry.draft.validation_state !== 'valid') return 'is-invalid'; + return entry.state === 'published' ? 'is-published' + : entry.state === 'draft' ? 'is-draft' : 'is-missing'; + } + + function textFor(entry) { + if (entry.draft && typeof entry.draft.text === 'string') return entry.draft.text; + if (entry.published && typeof entry.published.text === 'string') return entry.published.text; + return ''; + } + + function isToast(entry) { + return entry.kind === 'toast_title' || entry.kind === 'toast_body'; + } + + function fillSelect(select, options, selected) { + select.replaceChildren(); + (options || []).forEach(function (option) { + var node = element('option', '', option.label || option.id); + node.value = option.id; + node.selected = option.id === selected; + select.append(node); + }); + } + + function renderCoverage(coverage) { + coverage = coverage || {}; + document.getElementById('user-copy-total').textContent = String(coverage.total || 0); + document.getElementById('user-copy-published').textContent = String(coverage.published || 0); + document.getElementById('user-copy-draft').textContent = String(coverage.draft || 0); + document.getElementById('user-copy-missing').textContent = String(coverage.missing || 0); + var percent = Math.max(0, Math.min(100, Number(coverage.percent) || 0)); + document.getElementById('user-copy-percent').textContent = percent.toFixed(0) + '%'; + document.getElementById('user-copy-progress-bar').style.width = percent + '%'; + } + + function visibleEntries() { + var term = search.value.trim().toLowerCase(); + var state = stateFilter.value; + return (workspace.entries || []).filter(function (entry) { + if (toastOnly.checked && !isToast(entry)) return false; + if (state && (entry.hidden ? 'hidden' : entry.state) !== state) return false; + if (!term) return true; + return String(entry.key).toLowerCase().indexOf(term) !== -1 + || String(entry.source).toLowerCase().indexOf(term) !== -1; + }); + } + + function meta(entry) { + var row = element('div', 'user-copy-entry-meta'); + row.append(element('code', '', entry.key)); + row.append(element('span', 'user-copy-kind', entry.kind)); + var status = element('span', 'user-copy-state ' + stateClass(entry), stateLabel(entry)); + row.append(status); + if (entry.criticality !== 'normal') { + row.append(element('span', 'user-copy-critical', entry.criticality === 'critical' ? '关键文案' : '必需文案')); + } + return row; + } + + function renderEntry(entry) { + var card = element('article', 'user-copy-entry'); + card.dataset.copyKey = entry.key; + card.append(meta(entry)); + + var columns = element('div', 'user-copy-entry-columns'); + var source = element('section', 'user-copy-source'); + source.append(element('span', 'user-copy-field-label', '中文源文案(只读)')); + source.append(element('div', 'user-copy-source-text', entry.source)); + + var target = element('section', 'user-copy-target'); + var targetHead = element('div', 'user-copy-target-head'); + targetHead.append(element('label', 'user-copy-field-label', '目标语言草稿')); + if (entry.allow_hide) { + var hideLabel = element('label', 'user-copy-hide'); + var hide = element('input'); + hide.type = 'checkbox'; + hide.checked = entry.hidden === true; + hide.disabled = !canManage || !workspace.write_ready || uncertain; + hideLabel.append(hide, element('span', '', '发布时隐藏')); + targetHead.append(hideLabel); + } + var textarea = element('textarea', 'form-control'); + textarea.rows = 3; + textarea.maxLength = Number(entry.max_length) || 4000; + textarea.value = textFor(entry); + var localeOption = localeSelect.options[localeSelect.selectedIndex]; + textarea.placeholder = '输入 ' + (localeOption ? localeOption.text : '目标语言') + '译文'; + textarea.readOnly = !canManage || !workspace.write_ready || uncertain; + textarea.setAttribute('aria-label', entry.key + ' 的目标语言草稿'); + target.append(targetHead, textarea); + if ((entry.parameters || []).length) { + target.append(element('p', 'user-copy-parameters', '必须保留参数:' + entry.parameters.join('、'))); + } + if (entry.draft && entry.draft.validation_state !== 'valid') { + var errors = Array.isArray(entry.draft.validation_errors) + ? entry.draft.validation_errors : []; + target.append(element( + 'p', + 'user-copy-validation-error', + '草稿校验未通过' + (errors.length ? ':' + errors.join(';') : '。') + )); + } + columns.append(source, target); + card.append(columns); + + var actions = element('div', 'user-copy-entry-actions'); + var previewButton = element('button', 'btn btn-light btn-sm', isToast(entry) ? '预览 Toast' : '安全预览'); + previewButton.type = 'button'; + previewButton.addEventListener('click', function () { + previewEntry(entry, textarea.value); + }); + var save = element('button', 'btn btn-outline-primary btn-sm', '保存草稿'); + save.type = 'button'; + save.disabled = !canManage || !workspace.write_ready || uncertain; + save.addEventListener('click', function () { + writeEntry(entry, textarea.value, card.querySelector('.user-copy-hide input')); + }); + actions.append(previewButton, save); + card.append(actions); + return card; + } + + function renderEntries() { + var entries = visibleEntries(); + list.replaceChildren(); + entries.forEach(function (entry) { list.append(renderEntry(entry)); }); + empty.hidden = entries.length !== 0; + if (publishLocaleButton) { + var invalidDraft = (workspace.entries || []).some(function (entry) { + return entry.draft && entry.draft.validation_state !== 'valid'; + }); + publishLocaleButton.disabled = !canManage || !workspace.write_ready + || uncertain || invalidDraft; + publishLocaleButton.title = invalidDraft + ? '当前页面存在无效或过期草稿,请先修正。' : ''; + } + if (historyOpenButton) historyOpenButton.disabled = !localeSelect.value; + } + + function escapeHtml(value) { + return String(value).replace(/[&<>"']/g, function (character) { + return { '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[character]; + }); + } + + function previewDocument(entry, translation) { + var source = escapeHtml(entry.source); + var target = escapeHtml(translation || '尚未填写目标语言草稿'); + var tone = ['success', 'warning', 'error'].indexOf(entry.severity) !== -1 + ? entry.severity : 'info'; + var content = isToast(entry) + ? '
' + + (entry.kind === 'toast_title' ? target : '标题预览') + + '

' + (entry.kind === 'toast_body' ? target : '正文预览') + '

' + : '
中文源文案

' + source + + '

目标语言预览

' + target + '

'; + return '' + + '' + content + ''; + } + + function previewEntry(entry, translation) { + closeDrawers(); + previewFrame.srcdoc = previewDocument(entry, translation); + preview.hidden = false; + backdrop.hidden = false; + document.body.classList.add('user-copy-drawer-open'); + } + + function closeDrawers() { + preview.hidden = true; + history.hidden = true; + backdrop.hidden = true; + document.body.classList.remove('user-copy-drawer-open'); + } + + async function openHistory() { + closeDrawers(); + historyList.replaceChildren(element('p', 'text-muted', '正在读取发布历史…')); + history.hidden = false; + backdrop.hidden = false; + document.body.classList.add('user-copy-drawer-open'); + if (!transport) return; + try { + var result = await transport.read('/admin/user-copy/publications?locale=' + + encodeURIComponent(localeSelect.value)); + renderHistory(result && result.history ? result.history.revisions : []); + } catch (error) { + historyList.replaceChildren(element('p', 'alert alert-danger', error.message || '发布历史读取失败。')); + } + } + + function renderHistory(revisions) { + historyList.replaceChildren(); + if (!Array.isArray(revisions) || revisions.length === 0) { + historyList.append(element('p', 'user-copy-history-empty', '该语言尚无已发布目录版本。')); + return; + } + revisions.forEach(function (revision) { + var item = element('article', 'user-copy-history-item'); + var head = element('div'); + head.append(element('strong', '', 'v' + String(revision.version || revision.id)), + element('time', '', String(revision.published_at || ''))); + item.append(head, element('p', '', revision.text + ? String(revision.text) + : '目录包含 ' + String(revision.entry_count || 0) + ' 个词条')); + var rollback = element('button', 'btn btn-light btn-sm', '设为当前版本'); + rollback.type = 'button'; + rollback.disabled = !canManage || !workspace.write_ready || uncertain; + rollback.addEventListener('click', function () { + rollbackEntry(revision.publication_key || revision.id); + }); + item.append(rollback); + historyList.append(item); + }); + } + + async function writeEntry(entry, text, hideInput) { + if (!transport || !canManage || !workspace.write_ready || uncertain) return; + if (!text.trim() && !(hideInput && hideInput.checked)) { + inform('目标语言草稿不能为空。', 'error'); + return; + } + var endpoint = '/admin/user-copy/entries/' + encodeURIComponent(entry.key) + + '/draft'; + try { + inform('正在保存草稿…'); + var result = await transport.mutate(endpoint, { + method: 'PUT', + body: { + page: pageSelect.value, + locale: localeSelect.value, + text: text, + hidden: Boolean(hideInput && hideInput.checked), + draft_version: Number(entry.draft_version) || 0, + }, + }); + await loadWorkspace(); + var saved = result && result.entry ? result.entry : null; + if (saved && saved.validation_state !== 'valid') { + var errors = Array.isArray(saved.validation_errors) + ? saved.validation_errors : []; + inform('草稿已保存,但校验未通过' + + (errors.length ? ':' + errors.join(';') : '。'), 'error'); + } else { + inform('草稿已保存。', 'success'); + } + } catch (error) { + handleMutationError(error); + } + } + + async function publishLocale() { + if (!transport || !canManage || !workspace.write_ready || uncertain) return; + if (!window.confirm('确认发布当前目标语言的全部有效草稿?用户页面会切换到新的不可变目录版本。')) return; + try { + inform('正在编译并发布目标语言目录…'); + await transport.mutate('/admin/user-copy/publications', { + method: 'POST', + body: { locale: localeSelect.value }, + }); + inform('目标语言目录已发布。', 'success'); + await loadWorkspace(); + } catch (error) { + handleMutationError(error); + } + } + + async function rollbackEntry(publicationKey) { + if (!transport || !canManage || !workspace.write_ready || uncertain) return; + if (!publicationKey || !window.confirm('确认把该历史目录重新设为当前公开版本?')) return; + try { + inform('正在切换到历史公开版本…'); + await transport.mutate('/admin/user-copy/publications/' + + encodeURIComponent(publicationKey) + '/rollback', { + method: 'POST', + body: { locale: localeSelect.value }, + }); + closeDrawers(); + inform('历史目录已设为当前公开版本。', 'success'); + await loadWorkspace(); + } catch (error) { + handleMutationError(error); + } + } + + function handleMutationError(error) { + if (error && error.mutationMayHaveApplied) { + uncertain = true; + inform('请求结果无法确认,请刷新页面核对后再操作,不要重复提交。', 'error'); + renderEntries(); + return; + } + inform(error && error.message ? error.message : '译文操作失败。', 'error'); + } + + async function loadWorkspace() { + if (!transport) return; + inform('正在读取译文目录…'); + try { + var result = await transport.read('/admin/user-copy/entries?page=' + + encodeURIComponent(pageSelect.value) + '&locale=' + encodeURIComponent(localeSelect.value)); + if (!result || !result.workspace || result.workspace.schema !== 1) { + throw new Error('译文目录响应无效。'); + } + workspace = result.workspace; + updateUrl(); + renderCoverage(workspace.coverage); + renderEntries(); + inform(workspace.write_ready ? '译文目录已更新。' + : workspace.write_block_reason, workspace.write_ready ? 'success' : ''); + } catch (error) { + inform(error.message || '译文目录读取失败。', 'error'); + } + } + + function updateUrl() { + if (!window.history || !window.history.replaceState) return; + var query = new URLSearchParams(window.location.search); + query.set('page', pageSelect.value); + query.set('locale', localeSelect.value); + window.history.replaceState(window.history.state, '', window.location.pathname + '?' + query.toString()); + } + + fillSelect(pageSelect, workspace.pages, workspace.selected.page); + fillSelect(localeSelect, workspace.locales, workspace.selected.locale); + renderCoverage(workspace.coverage); + renderEntries(); + [search, stateFilter, toastOnly].forEach(function (control) { + control.addEventListener(control === search ? 'input' : 'change', renderEntries); + }); + pageSelect.addEventListener('change', loadWorkspace); + localeSelect.addEventListener('change', loadWorkspace); + document.getElementById('user-copy-preview-close').addEventListener('click', closeDrawers); + document.getElementById('user-copy-history-close').addEventListener('click', closeDrawers); + if (historyOpenButton) historyOpenButton.addEventListener('click', openHistory); + if (publishLocaleButton) publishLocaleButton.addEventListener('click', publishLocale); + backdrop.addEventListener('click', closeDrawers); + document.addEventListener('keydown', function (event) { + if (event.key === 'Escape') closeDrawers(); + }); +}()); diff --git a/web/resources/views/venix/admin/static_header.tpl b/web/resources/views/venix/admin/static_header.tpl index 53af30f3..19db1f8c 100644 --- a/web/resources/views/venix/admin/static_header.tpl +++ b/web/resources/views/venix/admin/static_header.tpl @@ -158,6 +158,7 @@
  • 工单系统
  • 站点设置
  • 法律页面
  • +
  • 用户界面译文
  • diff --git a/web/resources/views/venix/admin/user_copy.tpl b/web/resources/views/venix/admin/user_copy.tpl new file mode 100644 index 00000000..eb47261f --- /dev/null +++ b/web/resources/views/venix/admin/user_copy.tpl @@ -0,0 +1,81 @@ +{assign var=admin_title value='用户界面译文'} +{assign var=admin_active value='user-copy'} +{include file='admin/static_header.tpl'} + +
    +
    +
    +

    Interface copy

    +

    用户界面译文

    +

    中文源文案由代码定义且只读;目标语言先保存草稿,发布后才会进入用户页面。

    +
    +
    + + {if $user_copy_error|default:''}{$user_copy_error|escape}{elseif !$user_copy_can_manage|default:false}只读模式{elseif !$user_copy_workspace.write_ready|default:false}{$user_copy_workspace.write_block_reason|default:'译文存储未就绪'|escape}{else}管理目录已读取{/if} + + {if !$user_copy_error|default:''} + + + {/if} +
    +
    + + {if $user_copy_error|default:''} + + {else} +
    + + +
    + + 预览只在隔离区域渲染纯文本,不会载入用户页面脚本,也不会触发实例、账单或账户操作。 +
    +
    + +
    +
    页面词条0
    +
    已发布0
    +
    仅有草稿0
    +
    待翻译0
    +
    +

    0%已发布覆盖率

    +
    + +
    +
    +

    词条目录

    按稳定键管理译文;修改中文内容需要回到源码 Manifest。

    +
    + + + +
    +
    +
    +
    + +
    +
    + + + + + + + + + {/if} +
    +{include file='admin/static_footer.tpl'} diff --git a/web/tests/UserCopyAdminUiContractTest.php b/web/tests/UserCopyAdminUiContractTest.php new file mode 100644 index 00000000..b19d4759 --- /dev/null +++ b/web/tests/UserCopyAdminUiContractTest.php @@ -0,0 +1,105 @@ +add\(new SuperAdmin\(\)\)#"; + $assert(preg_match($pattern, $routes) === 1, + 'User-copy route is not protected by SuperAdmin: ' . $action); +} + +$assert(str_contains($controller, 'UserCopyAdminService::fromApplication()') + && str_contains($controller, 'AdminPermission::isSuperAdmin()') + && str_contains($controller, "'private, no-store'"), + 'Controller lost its service seam, write guard or private caching contract.'); +$assert(!str_contains($controller, 'UserCopyPublicationStore') + && !str_contains($controller, 'Capsule::') + && !str_contains($controller, 'DB::'), + 'Administrator controller bypasses the UserCopyAdminService seam.'); + +foreach (['workspace', 'history', 'saveDraft', 'publish', 'rollback'] as $method) { + $assert(str_contains($service, 'function ' . $method . '('), + 'UserCopyAdminService contract is missing: ' . $method); +} +$assert(!str_contains($manifest, "'translations' =>") + && !str_contains($manifest, "'target' =>") + && str_contains($manifest, 'target-locale translation are maintained by') + && str_contains($manifest, 'must never be committed to this source manifest'), + 'Target-locale translations were stored in the source manifest.'); + +$assert(str_contains($sidebar, 'href="/admin/user-copy"') + && str_contains($sidebar, '用户界面译文'), + 'Administrator navigation does not expose user-copy management.'); +foreach ([ + 'id="user-copy-page"', + 'id="user-copy-locale"', + 'id="user-copy-progress-bar"', + '发布历史', + 'id="user-copy-toast-only"', + 'sandbox=""', +] as $contract) { + $assert(str_contains($template, $contract), + 'Administrator user-copy template is missing: ' . $contract); +} +$assert(str_contains($template . $javascript, '中文源文案(只读)') + && str_contains($template . $javascript, '目标语言草稿'), + 'Source copy is not read-only or target drafts are missing.'); +$assert(str_contains($template, 'data-can-manage=') + && str_contains($template, 'write_block_reason'), + 'The template does not expose read-only or unavailable-write state.'); + +$assert(str_contains($javascript, 'function previewEntry(') + && str_contains($javascript, 'previewFrame.srcdoc = previewDocument(') + && str_contains($javascript, "entry.kind === 'toast_title'") + && str_contains($javascript, "entry.kind === 'toast_body'"), + 'Local safe preview or Toast preview/filtering is missing.'); +$previewStart = strpos($javascript, 'function previewEntry('); +$previewEnd = strpos($javascript, 'function closeDrawers(', $previewStart); +$previewBody = substr($javascript, $previewStart, $previewEnd - $previewStart); +$assert(!str_contains($previewBody, 'transport.') + && !str_contains($previewBody, 'fetch('), + 'Safe preview performs a network operation.'); +foreach (['/api/v1/vms', '/api/v1/orders', '/api/v1/invoices'] as $businessPath) { + $assert(!str_contains($javascript, $businessPath), + 'Translation management references a business mutation endpoint.'); +} +$assert(str_contains($javascript, "'/admin/user-copy/entries/'") + && str_contains($javascript, "'/admin/user-copy/publications'") + && str_contains($javascript, "'/admin/user-copy/publications/'") + && str_contains($javascript, 'mutationMayHaveApplied'), + 'Draft, publish, rollback or uncertain mutation handling is incomplete.'); +$assert(str_contains($javascript, 'validation_state') + && str_contains($javascript, 'user-copy-validation-error') + && str_contains($javascript, '存在无效或过期草稿'), + 'Invalid or stale drafts are not visible before locale publication.'); +$assert(str_contains($css, '@media (max-width: 575.98px)') + && str_contains($css, '.user-copy-entry-columns'), + 'Administrator user-copy page lacks responsive layout contracts.'); + +echo "User copy administrator UI contracts passed.\n";