Новый сервис pcp-tgu-ui-service: ТГУ-фронт на headless-auth nstart + платформенный CI/деплой

services/pcp-tgu-ui-service/src/utils/dataVolume.ts

@@ -0,0 +1,16 @@
+/**
+ * Форматирование объёма данных режима (съёмка/сброс). Бэк отдаёт объём в мегабайтах
+ * (см. ModeDataRates в pcp-types-lib: накопление съёмки 120 Мбайт/с, сброс — канал 1200 Мбит/с ÷ 8).
+ */
+
+/** До 1000 — в МБ, дальше — в ГБ (1 ГБ = 1000 МБ). Тут МБ = мегабайт. «—», если значения нет. */
+export function formatVolume(mb?: number | null): string {
+  if (mb == null || !Number.isFinite(mb) || mb <= 0) {
+    return "—";
+  }
+  if (mb >= 1000) {
+    const gb = mb / 1000;
+    return `${gb >= 100 ? Math.round(gb) : gb.toFixed(1)} ГБ`;
+  }
+  return `${Math.round(mb)} МБ`;
+}

services/pcp-tgu-ui-service/src/utils/localTime.ts

@@ -0,0 +1,57 @@
+/**
+ * Единый разбор и форматирование времени в локальной зоне.
+ *
+ * Бэкенд (Kotlin `LocalDateTime`) отдаёт время как ISO-строку без зоны
+ * (например `"2026-05-29T01:00:00"`) — это настенные часы локальной зоны, в которой
+ * работают все сервисы, без UTC-семантики. Браузер по умолчанию трактует такую naive-строку
+ * как локальное время — это нам и нужно: разбор, показ и ввод идут в зоне браузера, а
+ * сериализация назад отдаёт те же настенные часы naive-строкой без зоны.
+ *
+ * Строки с явной зоной (`...Z`/офсет, напр. валидность платформ из НСИ) парсятся как
+ * абсолютный момент и показываются в локальной зоне.
+ */
+
+function pad(n: number): string {
+  return String(n).padStart(2, "0");
+}
+
+/** Разбирает ISO-строку в эпоху-мс: naive — как локальное время, зонированную — как её момент. */
+export function parseLocal(value: string): number {
+  return Date.parse(value);
+}
+
+/** Дата-время в локальной зоне, формат ru-RU. */
+export function formatLocalDateTime(ms: number): string {
+  return new Date(ms).toLocaleString("ru-RU", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+
+/** Дата (дд.мм) в локальной зоне. */
+export function formatLocalDate(ms: number): string {
+  return new Date(ms).toLocaleDateString("ru-RU", { day: "2-digit", month: "2-digit" });
+}
+
+/** Время (чч:мм) в локальной зоне. */
+export function formatLocalTime(ms: number): string {
+  return new Date(ms).toLocaleTimeString("ru-RU", { hour: "2-digit", minute: "2-digit" });
+}
+
+/** Значение для пикеров (`YYYY-MM-DDTHH:mm`) из локальных компонент. */
+export function toLocalInputValue(ms: number): string {
+  const d = new Date(ms);
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+
+/**
+ * naive `LocalDateTime` без зоны (`YYYY-MM-DDTHH:mm:ss`) из локальных компонент эпохи-мс.
+ * Все бэкенды ожидают `LocalDateTime` без зоны — настенные часы локальной зоны.
+ */
+export function toLocalIso(ms: number): string {
+  const d = new Date(ms);
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}

services/pcp-tgu-ui-service/src/utils/uuid.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from "vitest";
+import { generateUuid, uuidV4Fallback } from "./uuid";
+
+const UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+describe("generateUuid", () => {
+  it("возвращает валидный UUID v4", () => {
+    expect(generateUuid()).toMatch(UUID_V4);
+  });
+});
+
+describe("uuidV4Fallback (insecure context)", () => {
+  it("даёт валидный UUID v4 без crypto.randomUUID", () => {
+    expect(uuidV4Fallback()).toMatch(UUID_V4);
+  });
+
+  it("генерирует разные значения", () => {
+    expect(uuidV4Fallback()).not.toBe(uuidV4Fallback());
+  });
+});

services/pcp-tgu-ui-service/src/utils/uuid.ts

@@ -0,0 +1,35 @@
+/**
+ * Генерация UUID v4.
+ *
+ * `crypto.randomUUID()` доступен только в secure context (https или localhost),
+ * поэтому при открытии фронта по сетевому адресу (http://<ip>:5174) он отсутствует
+ * и падает с «crypto.randomUUID is not a function». `crypto.getRandomValues`, наоборот,
+ * доступен и в insecure context — используем его как фолбэк (RFC 4122 v4).
+ */
+export function generateUuid(): string {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return uuidV4Fallback();
+}
+
+/** RFC 4122 v4 на основе crypto.getRandomValues (работает в insecure context). */
+export function uuidV4Fallback(): string {
+  const bytes = new Uint8Array(16);
+  crypto.getRandomValues(bytes);
+  bytes[6] = (bytes[6] & 0x0f) | 0x40; // версия 4
+  bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10xx
+
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
+  return (
+    hex.slice(0, 4).join("") +
+    "-" +
+    hex.slice(4, 6).join("") +
+    "-" +
+    hex.slice(6, 8).join("") +
+    "-" +
+    hex.slice(8, 10).join("") +
+    "-" +
+    hex.slice(10, 16).join("")
+  );
+}