Clarify failover UI messaging and controls

2026-08-21 01:01:34 +03:00
parent 1ee453b3b6
commit 12f2f30212
5 changed files with 109 additions and 101 deletions
@@ -90,53 +90,55 @@ function FailoverNumberSetting({ before, after, value, min, max, step = 10, disa
  const set = (next: number) => onChange(Math.min(max, Math.max(min, next)));
  return <div className="client-failover-number-setting">
    <span>{before}</span>
-    <input
-      className="client-failover-number-input"
-      type="number"
-      min={min}
-      max={max}
-      aria-label={ariaLabel}
-      value={value}
-      style={{ width: `${Math.max(2, String(value).length + 0.6)}ch` }}
-      disabled={disabled}
-      onInput={pulseNumber}
-      onChange={(event) => {
-        const next = Number(event.target.value);
-        if (Number.isFinite(next)) onChange(next);
-      }}
-    />
-    <span>{after}</span>
-    <span className="client-failover-number-steps">
-      <button type="button" aria-label={`${ariaLabel}: уменьшить на ${step}`} disabled={disabled || value <= min} onClick={() => set(value - step)}>−{step}</button>
-      <button type="button" aria-label={`${ariaLabel}: увеличить на ${step}`} disabled={disabled || value >= max} onClick={() => set(value + step)}>+{step}</button>
+    <span className="client-failover-number-control">
+      <input
+        className="client-failover-number-input"
+        type="number"
+        min={min}
+        max={max}
+        aria-label={ariaLabel}
+        value={value}
+        style={{ width: `${Math.max(2, String(value).length + 0.6)}ch` }}
+        disabled={disabled}
+        onInput={pulseNumber}
+        onChange={(event) => {
+          const next = Number(event.target.value);
+          if (Number.isFinite(next)) onChange(next);
+        }}
+      />
+      <span className="client-failover-number-steps">
+        <button type="button" aria-label={`${ariaLabel}: уменьшить на ${step}`} disabled={disabled || value <= min} onClick={() => set(value - step)}>−</button>
+        <button type="button" aria-label={`${ariaLabel}: увеличить на ${step}`} disabled={disabled || value >= max} onClick={() => set(value + step)}>+</button>
+      </span>
    </span>
+    <span>{after}</span>
  </div>;
 }

 const reasonLabel = (reason: string | null) => ({
  'primary-healthy': 'Основной канал работает',
-  'health-unknown': 'Ожидаем результаты проверки',
-  'checking-channels': 'Проверяем основной и резервный каналы',
-  'failure-window': 'Подтверждаем сбой основного канала',
-  'reserve-not-healthy': 'Резервный канал ещё не подтверждён',
+  'health-unknown': 'Ждём первую проверку',
+  'checking-channels': 'Проверяем оба канала',
+  'failure-window': 'Убеждаемся, что основной не работает',
+  'reserve-not-healthy': 'Проверяем резервный канал',
  'both-unhealthy': 'Оба канала недоступны',
-  'primary-not-recovered': 'Основной канал восстанавливается',
-  'recovery-hold': 'Проверяем стабильность основного канала',
-  'activity-unknown': 'Не удалось определить активность',
-  'active-traffic': 'Ждём завершения активной работы',
-  'quiet-window': 'Ждём паузу в передаче данных',
+  'primary-not-recovered': 'Основной ещё не восстановился',
+  'recovery-hold': 'Убеждаемся, что основной работает без сбоев',
+  'activity-unknown': 'Не удалось проверить передачу данных',
+  'active-traffic': 'Ждём паузу в передаче данных',
+  'quiet-window': 'Проверяем, что передача данных остановилась',
  'primary-failed': 'Основной канал недоступен',
  'primary-recovered': 'Основной канал восстановился',
-  'pending-activation': 'Изменения ожидают следующего запуска VPN',
+  'pending-activation': 'Настройка применится при запуске VPN',
  'vpn-stopped': 'VPN выключен',
-  paused: 'Автоматика на паузе',
-  disabled: 'Резерв выключен',
+  paused: 'Автоматическое переключение приостановлено',
+  disabled: 'Резервный канал выключен',
  'switch-failed': 'Не удалось переключить канал',
-  'selector-unknown': 'Не удалось подтвердить текущий канал',
-  'reconcile-failed': 'Настройки сохранены, мониторинг временно недоступен',
-  'revalidation-required': 'Условия переключения проверяются заново',
+  'selector-unknown': 'Не удалось проверить выбранный канал',
+  'reconcile-failed': 'Настройки сохранены. Повторим проверку позже',
+  'revalidation-required': 'Проверяем условия ещё раз',
  'manual-check': 'Оба канала проверены',
-}[reason || ''] || 'Наблюдаем за каналами');
+}[reason || ''] || 'Следим за каналами');

 function targetLabel(profiles: ProfileSnapshot[], target: { profileId: string; serverId: string }) {
  const profile = profiles.find(({ id }) => id === target.profileId);
@@ -446,10 +448,10 @@ export function FailoverPanel({
          }}
        />
      </div>
-      <p>Переключает только новые соединения. Уже открытые соединения Harbor не закрывает.</p>
+      <p>Если основной канал перестанет работать, новые подключения пойдут через резервный. Уже открытые подключения продолжат работать.</p>
      {snapshot.enabled && <div className="client-failover-global-actions">
        <button type="button" disabled={blocked} onClick={() => void onPause(!snapshot.paused)}>{snapshot.paused ? 'Продолжить автоматику' : 'Приостановить автоматику'}</button>
-        <small>{snapshot.paused ? 'VPN продолжает работать через текущий канал.' : 'Harbor сам проверяет оба канала.'}</small>
+        <small>{snapshot.paused ? 'Новые подключения остаются на текущем канале.' : 'Harbor следит, работают ли оба канала.'}</small>
      </div>}
    </header>

@@ -465,18 +467,18 @@ export function FailoverPanel({
          target.profileId === draft[channel].profileId && target.serverId === draft[channel].serverId
        ))?.id || '';
        const healthLabel = missing
-          ? 'Цель недоступна'
+          ? 'Сервер не найден'
          : !draft.enabled
            ? 'Выключен'
            : snapshot.reason === 'vpn-stopped' || snapshot.activation === 'inactive'
              ? 'VPN выключен'
              : snapshot.activation === 'pending'
-                ? 'Ожидает запуска VPN'
+                ? 'Запустится вместе с VPN'
          : channel === 'primary' && snapshot.reason === 'failure-window'
-            ? `Нестабилен · ${seconds(Math.max(0, Date.now() - Date.parse(snapshot.primary.stateSince || new Date().toISOString())))} из ${seconds(draft.failureWindowMs)} с`
+            ? `Проверяем сбой · ${seconds(Math.max(0, Date.now() - Date.parse(snapshot.primary.stateSince || new Date().toISOString())))} из ${seconds(draft.failureWindowMs)} с`
            : channel === 'primary' && snapshot.currentRole === 'reserve' && health === 'healthy' && snapshot.reason === 'recovery-hold'
-              ? 'Восстанавливается'
-              : health === 'healthy' ? 'Работает' : health === 'unhealthy' ? 'Недоступен' : health === 'not-monitoring' ? 'Не проверяется' : 'Ещё не проверен';
+              ? 'Проверяем восстановление'
+              : health === 'healthy' ? 'Работает' : health === 'unhealthy' ? 'Недоступен' : health === 'not-monitoring' ? 'Проверка выключена' : 'Ждёт проверки';
        return <article className="client-failover-channel" data-channel={channel} key={channel}>
          <div className="client-failover-channel-title">
            <h3>{channel === 'primary' ? 'Основной' : 'Резервный'}</h3>
@@ -484,7 +486,7 @@ export function FailoverPanel({
          </div>
          <FailoverPicker
            id={`client-failover-${channel}-options`}
-            label={draft[channel].profileId ? 'Цель недоступна' : 'Выбрать канал'}
+            label={draft[channel].profileId ? 'Сервер не найден' : 'Выбрать канал'}
            value={selectedId}
            options={channelPickerOptions[channel]}
            open={openPicker === channel && !blocked && draft.enabled}
@@ -495,12 +497,12 @@ export function FailoverPanel({
        </article>;
      })}
        <div className="client-failover-checking" role="status" aria-live="polite">
-          {(manualChecking || snapshot.reason === 'checking-channels' ? ['primary', 'reserve'] as const : []).map((checkingRole) => <span key={checkingRole}>Проверяется {checkingRole === 'primary' ? 'основной' : 'резервный'} канал</span>)}
+          {(manualChecking || snapshot.reason === 'checking-channels' ? ['primary', 'reserve'] as const : []).map((checkingRole) => <span key={checkingRole}>Проверяем {checkingRole === 'primary' ? 'основной' : 'резервный'} канал</span>)}
        </div>
      </section>

      <fieldset className="client-failover-services">
-        <legend><span className="client-failover-section-header"><strong>Проверка доступности</strong><small>Harbor открывает эти адреса через оба канала и сравнивает результат.</small></span></legend>
+        <legend><span className="client-failover-section-header"><strong>Что проверять</strong><small>По этим сайтам Harbor понимает, работает канал или нет.</small></span></legend>
        {draft.checks.map((check) => {
          const service = services.find(({ id }) => check.serviceId === id);
          const removing = removingCheckId === check.serviceId;
@@ -513,14 +515,14 @@ export function FailoverPanel({
              if (removing && event.target === event.currentTarget) finishRemoveCheck(check.serviceId);
            }}
          >
-            <span className="client-failover-service-name">{service?.label || 'Сервис недоступен'}</span>
+            <span className="client-failover-service-name">{service?.label || 'Сайт не найден'}</span>
            <FailoverNumberSetting
              before="Ждать ответ не дольше"
              after="секунд"
              min={2}
              max={30}
              step={1}
-              ariaLabel={`Время ожидания ответа: ${service?.label || 'сервис недоступен'}`}
+              ariaLabel={`Время ожидания ответа: ${service?.label || 'сайт не найден'}`}
              value={seconds(check.timeoutMs)}
              disabled={blocked || !draft.enabled}
              onChange={(value) => updateChecks((checks) => checks.map((item) => item.serviceId === check.serviceId
@@ -530,7 +532,7 @@ export function FailoverPanel({
            <button
              className="client-failover-remove-service"
              type="button"
-              aria-label={`Убрать проверку: ${service?.label || 'сервис недоступен'}`}
+              aria-label={`Убрать проверку: ${service?.label || 'сайт не найден'}`}
              disabled={blocked || !draft.enabled || draft.checks.length === 1 || Boolean(removingCheckId)}
              onClick={() => removeCheck(check.serviceId)}
            >
@@ -568,14 +570,14 @@ export function FailoverPanel({

      <section className="client-failover-timing" aria-label="Пороги переключения">
        <header className="client-failover-section-header">
-          <h3>Когда переключать канал</h3>
-          <p>Harbor сначала подтверждает сбой и только затем переводит новые соединения на рабочий канал.</p>
+          <h3>Когда включать резервный</h3>
+          <p>Harbor включит резервный, только если основной не отвечает, а резервный работает.</p>
        </header>
        <FailoverNumberSetting before="Проверять каналы каждые" after="секунд" min={15} max={900} ariaLabel="Интервал проверки каналов" value={seconds(draft.intervalMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ intervalMs: value * 1_000 })} />
-        <FailoverNumberSetting before="Считать основной недоступным после" after="секунд непрерывного сбоя" min={seconds(draft.intervalMs * 2)} max={1800} ariaLabel="Длительность сбоя основного канала" value={seconds(draft.failureWindowMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ failureWindowMs: value * 1_000 })} />
-        <FailoverNumberSetting before="Вернуться на основной после" after="секунд стабильной работы" min={60} max={86400} ariaLabel="Время стабильной работы основного канала" value={seconds(draft.recoveryWindowMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ recoveryWindowMs: value * 1_000 })} />
+        <FailoverNumberSetting before="Считать основной неработающим, если он не отвечает" after="секунд" min={seconds(draft.intervalMs * 2)} max={1800} ariaLabel="Длительность сбоя основного канала" value={seconds(draft.failureWindowMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ failureWindowMs: value * 1_000 })} />
+        <FailoverNumberSetting before="Вернуться на основной после" after="секунд работы без сбоев" min={60} max={86400} ariaLabel="Время стабильной работы основного канала" value={seconds(draft.recoveryWindowMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ recoveryWindowMs: value * 1_000 })} />
        <div className="client-failover-traffic-switch">
-          <span><strong>Не переключать во время активной работы</strong><small>{draft.trafficGuard.enabled ? 'Harbor дождётся снижения трафика, чтобы не мешать новым подключениям.' : 'Новые соединения переключатся сразу после подтверждённого сбоя.'}</small></span>
+          <span><strong>Дождаться паузы в передаче данных</strong><small>{draft.trafficGuard.enabled ? 'Harbor подождёт, пока передача данных почти остановится.' : 'Новые подключения переключатся сразу после подтверждённого сбоя.'}</small></span>
          <HarborSwitch
            checked={draft.trafficGuard.enabled}
            label={draft.trafficGuard.enabled ? 'Разрешить переключение во время активной работы' : 'Не переключать во время активной работы'}
@@ -583,20 +585,20 @@ export function FailoverPanel({
            onChange={(enabled) => update({ trafficGuard: { ...draft.trafficGuard, enabled } })}
          />
        </div>
-        <FailoverNumberSetting before="Переключать после" after="секунд без активной передачи данных" min={5} max={600} ariaLabel="Время без активной передачи данных" value={seconds(draft.trafficGuard.quietWindowMs)} disabled={blocked || !draft.enabled || !draft.trafficGuard.enabled} onChange={(value) => update({ trafficGuard: { ...draft.trafficGuard, quietWindowMs: value * 1_000 } })} />
-        <FailoverNumberSetting before="Считать работу активной при скорости от" after="КБ/с" min={1} max={102400} ariaLabel="Скорость активной работы" value={Math.round(draft.trafficGuard.thresholdBytesPerSecond / 1024)} disabled={blocked || !draft.enabled || !draft.trafficGuard.enabled} onChange={(value) => update({ trafficGuard: { ...draft.trafficGuard, thresholdBytesPerSecond: value * 1024 } })} />
+        <FailoverNumberSetting before="Переключить после" after="секунд без передачи данных" min={5} max={600} ariaLabel="Время без активной передачи данных" value={seconds(draft.trafficGuard.quietWindowMs)} disabled={blocked || !draft.enabled || !draft.trafficGuard.enabled} onChange={(value) => update({ trafficGuard: { ...draft.trafficGuard, quietWindowMs: value * 1_000 } })} />
+        <FailoverNumberSetting before="Считать передачу активной при скорости выше" after="КБ/с" min={1} max={102400} ariaLabel="Скорость активной работы" value={Math.round(draft.trafficGuard.thresholdBytesPerSecond / 1024)} disabled={blocked || !draft.enabled || !draft.trafficGuard.enabled} onChange={(value) => update({ trafficGuard: { ...draft.trafficGuard, thresholdBytesPerSecond: value * 1024 } })} />
      </section>

      <section className="client-failover-protection" aria-labelledby="client-failover-protection-title">
        <header className="client-failover-section-header">
-          <h3 id="client-failover-protection-title">Защита от частых переключений</h3>
-          <p>Если основной канал падает снова, Harbor остаётся на резервном и даёт основному время восстановиться.</p>
+          <h3 id="client-failover-protection-title">Если основной снова не работает</h3>
+          <p>После нескольких повторных сбоев Harbor дольше использует резервный канал.</p>
        </header>
        <div className="client-failover-protection-options">
-          <FailoverNumberSetting before="Оставаться на резервном не меньше" after="секунд" min={60} max={86400} ariaLabel="Минимальное время на резервном канале" value={seconds(draft.minimumReserveMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ minimumReserveMs: value * 1_000 })} />
-          <FailoverNumberSetting before="Отправлять основной в карантин после" after="повторных сбоев" min={2} max={10} step={1} ariaLabel="Количество повторных сбоев" value={draft.flapProtection.count} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, count: value } })} />
-          <FailoverNumberSetting before="Считать повторными сбои за последние" after="часов" min={1} max={72} step={1} ariaLabel="Период повторных сбоев" value={Math.round(draft.flapProtection.windowMs / 3_600_000)} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, windowMs: value * 3_600_000 } })} />
-          <FailoverNumberSetting before="Не возвращаться на основной после карантина" after="минут" min={10} max={10080} ariaLabel="Длительность карантина основного канала" value={Math.round(draft.flapProtection.quarantineMs / 60_000)} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, quarantineMs: value * 60_000 } })} />
+          <FailoverNumberSetting before="Оставаться на резервном минимум" after="секунд" min={60} max={86400} ariaLabel="Минимальное время на резервном канале" value={seconds(draft.minimumReserveMs)} disabled={blocked || !draft.enabled} onChange={(value) => update({ minimumReserveMs: value * 1_000 })} />
+          <FailoverNumberSetting before="Считать основной нестабильным после" after="повторных сбоев" min={2} max={10} step={1} ariaLabel="Количество повторных сбоев" value={draft.flapProtection.count} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, count: value } })} />
+          <FailoverNumberSetting before="Учитывать сбои за последние" after="часов" min={1} max={72} step={1} ariaLabel="Период повторных сбоев" value={Math.round(draft.flapProtection.windowMs / 3_600_000)} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, windowMs: value * 3_600_000 } })} />
+          <FailoverNumberSetting before="После повторных сбоев не возвращаться на основной" after="минут" min={10} max={10080} ariaLabel="Длительность карантина основного канала" value={Math.round(draft.flapProtection.quarantineMs / 60_000)} disabled={blocked || !draft.enabled} onChange={(value) => update({ flapProtection: { ...draft.flapProtection, quarantineMs: value * 60_000 } })} />
        </div>
      </section>

@@ -608,12 +610,12 @@ export function FailoverPanel({
            ? `При запуске VPN: ${targetLabel(profiles, draft.primary)}`
            : `После перезапуска VPN: ${targetLabel(profiles, draft.primary)}`}</span>
        {snapshot.nextDecisionAt && <span>Следующее решение не раньше чем через {seconds(Math.max(0, Date.parse(snapshot.nextDecisionAt) - Date.now()))} с</span>}
-        {activity && <span>{activity.state === 'active' ? `Активный трафик · ${Math.round(activity.totalBytesPerSecond / 1024)} КБ/с · соединений: ${activity.transmittingConnections}` : activity.state === 'quiet' ? `Без активной передачи данных · ${Math.min(seconds(quietElapsed), seconds(draft.trafficGuard.quietWindowMs))} из ${seconds(draft.trafficGuard.quietWindowMs)} с` : 'Не удалось определить активность · автоматическое переключение остановлено'}</span>}
+        {activity && <span>{activity.state === 'active' ? `Идёт передача данных · ${Math.round(activity.totalBytesPerSecond / 1024)} КБ/с · подключений: ${activity.transmittingConnections}` : activity.state === 'quiet' ? `Передачи данных нет · ${Math.min(seconds(quietElapsed), seconds(draft.trafficGuard.quietWindowMs))} из ${seconds(draft.trafficGuard.quietWindowMs)} с` : 'Не удалось проверить передачу данных · автоматическое переключение остановлено'}</span>}
        {activity?.blockers.slice(0, 2).map((blocker) => <small key={`${blocker.device}:${blocker.service}`}>{blocker.device} · {blocker.service} · {Math.round((blocker.uploadBytesPerSecond + blocker.downloadBytesPerSecond) / 1024)} КБ/с</small>)}
        {activity && activity.blockers.length > 2 && <small>Ещё {activity.blockers.length - 2}</small>}
      </div>

-      {!draftValid && <p className="client-failover-validation">Выберите два разных сервера и хотя бы одну проверку.</p>}
+      {!draftValid && <p className="client-failover-validation">Выберите разные основной и резервный серверы и хотя бы один сайт для проверки.</p>}
      {confirmDiscard && <div className="client-failover-discard" role="alert">
        <span>Отменить несохранённые изменения?</span>
        <button type="button" onClick={() => { setDraft(snapshot.policy); setDirty(false); setConfirmDiscard(false); feature.beforeCloseRef.current = () => true; feature.close(); }}>Отменить изменения</button>
@@ -624,9 +626,9 @@ export function FailoverPanel({
        <button type="button" disabled={blocked || manualChecking || !snapshot.enabled || snapshot.activation !== 'active'} onClick={() => {
          setManualChecking(true);
          void onCheck().finally(() => setManualChecking(false));
-        }}>Проверить основной и резервный</button>
+        }}>Проверить оба канала</button>
        <button type="submit" disabled={blocked || !dirty || !draftValid}>Сохранить</button>
-        {switchRole && snapshot.enabled && snapshot.activation === 'active' && <button type="button" disabled={blocked} onClick={() => void onSwitch(switchRole)}>Переключить новые соединения на {switchRole === 'reserve' ? 'резервный' : 'основной'}</button>}
+        {switchRole && snapshot.enabled && snapshot.activation === 'active' && <button type="button" disabled={blocked} onClick={() => void onSwitch(switchRole)}>Направить новые подключения через {switchRole === 'reserve' ? 'резервный' : 'основной'}</button>}
        {(snapshot.currentRole === 'primary' || snapshot.currentRole === 'reserve') && <small>Открытые соединения продолжат работать через прежний канал.</small>}
      </div>
    </form>