elcrm 1.1.16 → 1.1.18

package/dist/index.js

@@ -3512,7 +3512,7 @@ function copyTemplate(templateName, targetDir, packageName) {
     cpSync(from, to, { recursive: true });
   }
   const name = packageName ?? folderToPackageName(targetDir);
-  if (templateName === "panel") {
+  if (templateName === "panel" || templateName === "orbit") {
     finalizePanelNames(targetDir, name);
     return;
   }
@@ -3542,11 +3542,13 @@ function doneHint(template, cdPath) {
 ` : "";
   if (template === "orbit") {
     console.log(`
-\u0413\u043E\u0442\u043E\u0432\u043E (orbit: \u0432\u0438\u0442\u0440\u0438\u043D\u0430 \u043D\u0430 @elcrm/components).
+\u0413\u043E\u0442\u043E\u0432\u043E (orbit: web + api).
 
 ${prefix}  bun run dev
 
   Web \u2192 http://localhost:5173
+  API \u2192 http://localhost:4545
+  \u0412\u0445\u043E\u0434: admin / admin
 `);
     return;
   }

package/dist/vite/discover-lib.js

@@ -11,8 +11,8 @@ function assignLetters(names, overrides) {
   const used = new Set;
   const letters = {};
   for (const [name, letter] of Object.entries(overrides)) {
-    if (!/^[a-z0-9]$/.test(letter)) {
-      throw new Error(`[discover-lib] override "${name}" → "${letter}" (нужна a-z0-9)`);
+    if (!/^[a-z0-9A-Z]$/.test(letter)) {
+      throw new Error(`[discover-lib] override "${name}" → "${letter}" (нужна a-z0-9A-Z)`);
     }
     if (used.has(letter)) {
       throw new Error(`[discover-lib] дубль буквы "${letter}" в overrides`);
@@ -25,7 +25,7 @@ function assignLetters(names, overrides) {
     if (letters[name])
       continue;
     const base = name.replace(/[^a-zA-Z]/g, "").toLowerCase();
-    let letter = [...base].find((c) => /[a-z]/.test(c) && !used.has(c)) ?? [..."abcdefghijklmnopqrstuvwxyz0123456789"].find((c) => !used.has(c));
+    let letter = [...base].find((c) => /[a-z]/.test(c) && !used.has(c)) ?? [..."abcdefghijklmnopqrstuvwxyz0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"].find((c) => !used.has(c));
     if (!letter) {
       throw new Error(`[discover-lib] нет свободной буквы/цифры для "${name}"`);
     }

package/dist/vite/plugin-css-scoped.d.ts

@@ -1,10 +1,13 @@
 /**
  * Vite helper: короткие unique className для CSS Modules elCRM.
+ * Формат: 3 символа `{prefix}{буква}{класс}`.
  * @see createCssScoped
  */
 export type CssScopedOptions = {
   /** Первая буква пакета (c = components, b = button, …) */
   prefix: string;
+  /** Свой prefix у компонента, если слотов пакета не хватает */
+  prefixOverrides?: Record<string, string>;
   /** Папка компонента → одна буква */
   components: Record<string, string>;
   /** Каталог с папками компонентов (абсолютный путь) */

package/dist/vite/plugin-css-scoped.js

@@ -15,15 +15,22 @@ function listModuleCss(dir) {
 }
 function localClasses(css) {
   const set = new Set;
-  for (const m of css.matchAll(/(?:^|[,{\s>+~])\.([a-z][a-z0-9]*)\b/gi)) {
-    set.add(m[1]);
+  for (const m of css.matchAll(/(?:^|[,{\s>+~])\.([a-z0-9])\b/gi)) {
+    set.add(m[1].toLowerCase());
   }
   return [...set];
 }
+function assertPrefix(value, label) {
+  if (!/^[a-z]$/.test(value)) {
+    throw new Error(`[css-scoped] ${label} должен быть одной буквой a-z, получено: "${value}"`);
+  }
+}
 function createCssScoped(options) {
   const prefix = options.prefix;
-  if (!/^[a-z]$/.test(prefix)) {
-    throw new Error(`[css-scoped] prefix должен быть одной буквой a-z, получено: "${prefix}"`);
+  assertPrefix(prefix, "prefix");
+  const prefixOverrides = options.prefixOverrides ?? {};
+  for (const [name, pfx] of Object.entries(prefixOverrides)) {
+    assertPrefix(pfx, `prefixOverrides["${name}"]`);
   }
   const components = options.components;
   const libDir = options.libDir;
@@ -37,19 +44,25 @@ function createCssScoped(options) {
     }
     return m[1];
   }
+  function prefixFor(component) {
+    return prefixOverrides[component] ?? prefix;
+  }
   function generateScopedName(name, filename) {
-    if (!/^[a-z][a-z0-9]*$/.test(name)) {
-      throw new Error(`[css-scoped] локальный класс должен быть [a-z][a-z0-9]*: ".${name}" (${filename})`);
+    if (!/^[a-z0-9]$/.test(name)) {
+      throw new Error(`[css-scoped] локальный класс — 1 знак [a-z0-9] (scoped = 3 символа): ".${name}" (${filename})`);
     }
     const component = componentFromFilename(filename);
     const letter = components[component];
     if (!letter) {
       throw new Error(`[css-scoped] нет буквы для компонента "${component}". Добавьте в components.`);
     }
-    if (!/^[a-z0-9]$/.test(letter)) {
-      throw new Error(`[css-scoped] ключ компонента "${component}" должен быть a-z0-9: "${letter}"`);
+    if (!/^[a-z0-9A-Z]$/.test(letter)) {
+      throw new Error(`[css-scoped] ключ компонента "${component}" должен быть a-z0-9A-Z: "${letter}"`);
+    }
+    const scoped = `${prefixFor(component)}${letter}${name}`;
+    if (scoped.length !== 3) {
+      throw new Error(`[css-scoped] "${scoped}" ≠ 3 символа (${component}.${name})`);
     }
-    const scoped = `${prefix}${letter}${name}`;
     const owner = `${component}.${name}`;
     const prev = registry.get(scoped);
     if (prev && prev !== owner) {
@@ -72,6 +85,10 @@ function createCssScoped(options) {
     if (missingMap.length) {
       throw new Error(`[css-scoped] нет буквы в components: ${missingMap.join(", ")}`);
     }
+    const unknownOverride = Object.keys(prefixOverrides).filter((n) => !mapped.has(n));
+    if (unknownOverride.length) {
+      throw new Error(`[css-scoped] prefixOverrides без компонента: ${unknownOverride.join(", ")}`);
+    }
     const letters = Object.values(components);
     const dupLetter = [
       ...new Set(letters.filter((l, i) => letters.indexOf(l) !== i))
@@ -79,15 +96,30 @@ function createCssScoped(options) {
     if (dupLetter.length) {
       throw new Error(`[css-scoped] дубли букв компонентов: ${dupLetter.join(", ")}`);
     }
+    const namespaces = Object.entries(components).map(([name, letter]) => `${prefixFor(name)}${letter}`);
+    const dupNs = [
+      ...new Set(namespaces.filter((n, i) => namespaces.indexOf(n) !== i))
+    ];
+    if (dupNs.length) {
+      throw new Error(`[css-scoped] дубли пространства {prefix}{буква}: ${dupNs.join(", ")}`);
+    }
     const files = listModuleCss(libDir);
     for (const file of files) {
       const css = readFileSync(file, "utf8");
+      const long = [
+        ...css.matchAll(/(?:^|[,{\s>+~])\.([a-z][a-z0-9]+)\b/gi)
+      ].map((m) => m[1]);
+      if (long.length) {
+        const component = componentFromFilename(file);
+        throw new Error(`[css-scoped] ${component}: класс длиннее 1 знака (${[...new Set(long)].join(", ")}). Сократи или вынеси в prefixOverrides + 1 знак.`);
+      }
       for (const local of localClasses(css)) {
         generateScopedName(local, file);
       }
     }
     const snap = snapshot();
-    console.log(`[css-scoped] OK: ${files.length} module.css, ${snap.size} классов (prefix=${prefix})`);
+    const extra = Object.entries(prefixOverrides).map(([n, p]) => `${n}=${p}`).join(", ");
+    console.log(`[css-scoped] OK: ${files.length} module.css, ${snap.size} классов (prefix=${prefix}${extra ? `; ${extra}` : ""})`);
     return snap;
   }
   function plugin() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elcrm",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "description": "CLI @elcrm/*: doctor --fix (порядок проекта), update, css, docs, cursor, migrate",
   "type": "module",
   "license": "MIT",

package/templates/elcrm-cursor/rules/elcrm-ui.mdc

@@ -25,7 +25,7 @@ src/modules/Name/
 src/style/theme*.css + elcrm.css
 ```
 
-Orbit: `Layout sidebar={<Sidebar />}` вместо верхней `Header`. Дашборд — `PageShell` + `Stat` / `Card` / `Item`.
+Orbit: `web/` + `api/`. UI: `Layout sidebar={<Sidebar />}` вместо верхней `Header`. Дашборд — `PageShell` + `Stat` / `Card` / `Item`.
 
 - Кнопки: `@elcrm/button` (`onSend`). Иконки: `Icons.Line`. Подсказки: `@elcrm/tooltip`.
 - HTTP: `Api.query("auth/pass", body)`. Роутер: `Router.setRouter` / `mergeRouter`, разные ключи вкладок.

package/templates/elcrm-docs/CLI.elCRM.md

@@ -111,7 +111,7 @@ minifyCssVars({ var: 2 })
 
 Короткие имена **уникальны и подряд**: `--aa`, `--ab`, `--ac`… Занятые слоты пропускаются; `--field` не затирает `--field-border`. Чанки JSZip не минифицируются (декремент `--n`). Если слотов нет — сборка падает.
 
-Также: `elcrm/vite/plugin-css-scoped`, `discover-lib`, `concat-css`, `check-tokens`, `postbuild`.
+Также: `elcrm/vite/plugin-css-scoped` (`prefix` + `prefixOverrides`, scoped = 3 знака), `discover-lib`, `concat-css`, `check-tokens`, `postbuild`.
 
 ### Прочее
 

package/templates/elcrm-docs/COMPONENTS.elCRM.md

@@ -15,10 +15,11 @@ import {
   Layout, Header, Footer, Brand, Avatar, AvatarName, AvatarGroup, Badge,
   Menu, Dropdown, Section, NavSections, TabSections, Breadcrumb, Stack,
   Card, Stat, ActionGroup, TextGroup, ItemColumn, List, Item, PageHead, PageShell, ChatList, ChatMessages, ChatSplit, Sidebar, Popover,
+  Healthmap, PanelInfo,
   Loading, EmptyState, RadioGroup, PricingGroup, PricingTable,
   createLazyResolver,
 } from "@elcrm/components";
-import type { PricingPlan } from "@elcrm/components";
+import type { PricingPlan, HealthmapData } from "@elcrm/components";
 ```
 
 ## Роли layout
@@ -34,6 +35,8 @@ import type { PricingPlan } from "@elcrm/components";
 - **Stack** — ряд/колонка/сетка (`direction="row"|"column"|"grid"`). Не `Block` / `Row` / `Column`. Сетка: `auto-fit` + `--stack-grid-min`, либо `columns={4}` / `columns={["1fr", "100px", "auto"]}`. С `columns` ряды `stretch` (карточки не наезжают); в одну линию — `style={{ alignItems: "center" }}`. Не `height: 100%` у детей сетки.
 - **Card** — курсор: `--card-pointer` (`auto` / `pointer`). Сетка Stack: `--stack-grid-min`.
 - **Stat** — метрика: `label` + `value`, `tone` как у Badge, `labelMuted`. Не собирать из `span` в приложении.
+- **Healthmap** — теплокарта дней (`data.days`). Данные грузит приложение; слоты `brandName` / `brandSub` / `unit` / `hint`. Токены `--healthmap-cell`, `--healthmap-gap`, `--healthmap-l0`…`l4`.
+- **PanelInfo** — выезд справа (шапка / body / footer). На узком экране — оверлей. Слоты: `children`, `footer`, `headerExtra`, `close`. Токены `--panel-info-width`, `--panel-info-width-min`, `--panel-info-overlay-max`, `--panel-info-backdrop`.
 - **ActionGroup** — тулбар: `label` + `items` (узлы) и/или `children`. Кнопки — `@elcrm/button`, не нативный `<button>`.
 - **TextGroup** — две строки: `title` + `description` (без аватара; с аватаром — AvatarName).
 - **Item** — строка списка. `as` button/a/li, `active`. `variant="card"` — рамка и muted-фон (идеи / тикеты / inbox). Не дублировать `.desk-row` в приложении.
@@ -42,8 +45,8 @@ import type { PricingPlan } from "@elcrm/components";
 ## Меню
 
 - **Menu** — inline-навигация в шапке. `items`: `value` + `label` + `badge` (`0` не показываем, иначе `Badge` size s). `variant="line"` — вкладки с чертой снизу (не ломать pill селекторами страницы).
-- **Dropdown** — выпадающее меню по `items`/`groups` (portal).
-- **Popover** — свой попап в portal (якорь + `children`). z-index: `acquireOverlayZIndex` (тот же стек, что у form). Не `@elcrm/overlay` `Menu`.
+- **Dropdown** — выпадающее меню по `items`/`groups` (portal). `placement="auto"|"top"|"bottom"` — куда открывать панель (футер Sidebar — `top`).
+- **Popover** — свой попап в portal (якорь + `children`). z-index: `acquireOverlayZIndex` (тот же стек, что у form). Не `@elcrm/overlay` `Menu`. `placement` как у Dropdown: позиция по **реальной** высоте панели, не по `maxHeight` 420.
 
 ## Avatar
 
@@ -59,6 +62,9 @@ import type { PricingPlan } from "@elcrm/components";
 ## Можно
 
 - `--layout-height` — высота каркаса `Layout` при `fixed` (по умолчанию `100dvh`).
+- `--layout-padding` / `--layout-margin` / `--layout-max-width` — отступы и макс. ширина корня Layout (`0` / `none` = на весь вьюпорт).
+- `--header-border` — рамка Header (shorthand: все стороны и толщина). Только снизу: `none` + линия через `--header-shadow`.
+- `--header-nav-justify` — выравнивание `nav` в шапке (`flex-start` / `center` / `flex-end`).
 - Узкие токены (`--chat-*`, `--sidebar-*`, `--item-column-*`) по умолчанию = `--shell-*`. Переопределяй только отличие.
 - Задать `--shell-color` / `--shell-padding` / `--shell-radius` один раз — большинство компонентов подхватят.
 - `--popup-shadow` общий с `@elcrm/form`.

package/templates/elcrm-docs/MODAL.elCRM.md

@@ -18,7 +18,8 @@ const { Open, Icon } = Modal.Create(EditModal, "edit-modal");
 Open({ id: 123 });
 ```
 
-Файлы модулей: `modules/<Type>/modal/<Name>.tsx` + `Modal.Open("Type", "Name", params)` или `import_modules` у Init.
+Файлы модулей: `modules/<Type>/modal/<Name>.tsx` + `Modal.Open("Type", "Name", params)`.  
+Лоадер — тот же `glob` в `Router.createRouter` (не второй glob и не `importModules`). Свой лоадер — `import_modules` у `Init`.
 
 ## Состав
 
@@ -30,8 +31,26 @@ Open({ id: 123 });
 | `Modal.Close(name?)` | одно или все |
 | `Modal.Shake` | тряска |
 
-`size`: `a` auto · `s` 400 · `m` 500 · `l` 800 · `x` 1000 · `f` full.  
-`escape` закрывает верхнее; клик по оверлею при `shake` (default true) трясёт, не закрывает; крестик закрывает всегда.
+`size`: `a` auto · `s` 400 · `m` 500 · `l` 800 · `x` 1000 · `f` full · `p` page (весь экран поверх страницы).  
+`escape` закрывает верхнее; клик по оверлею при `shake` (default true) трясёт, не закрывает; крестик закрывает всегда. Для `size="p"` обычно `shake={false}`.
+
+## Раскрытие из элемента
+
+`Create` возвращает `Open`, `Icon` и **`Trigger`**. По клику снимается `getBoundingClientRect`, окно анимируется FLIP из этой позиции (и обратно при закрытии).
+
+```tsx
+const Card = Modal.Create(CardView, "card");
+
+// Обёртка (предпочтительно)
+<Card.Trigger params={{ id: 1 }}>
+  <Item as="li" variant="card">…</Item>
+</Card.Trigger>
+
+// Или вручную
+Card.Open({ id: 1 }, { origin: event.currentTarget });
+```
+
+`prefers-reduced-motion: reduce` — без анимации.
 
 ## Нельзя
 

package/templates/elcrm-docs/ROUTER.elCRM.md

@@ -13,22 +13,26 @@ Router.createRouter({
   glob: import.meta.glob("./{pages,modules}/**/*.{tsx,ts}", { eager: false }),
 });
 
-<LoadRoute variant="page" defaultName="Main" resolveLazyPage={resolvePage}>
-  <span aria-hidden />
-</LoadRoute>
+<LoadRoute variant="page" />
 ```
 
+`page` → `pages/{Name}.tsx`. `module` → `modules/{Name}/index.tsx`.  
+Тот же glob: `Modal.Open("Home", "Demo")` → `modules/Home/modal/Demo.tsx`.
+
 ## Можно
 
 - Состояние: `useRouter`, `setRouter`, `mergeRouter`, `getRouter`, `resetRouter`, `matchesRouter`.
-- Типизация: `declare module "@elcrm/router" { interface RouterDataMap { page: "Auth"|"Main"; module: … } }`.
+- Типизация (не обязательна для работы): `declare module "@elcrm/router" { interface RouterDataMap { page: "Auth"|"Main"; module: … } }`.
 - Секции модуля: отдельный ключ (`section` / `listTab` / `accountTab`) — **не один ключ на все вкладки**.
-- `createLazyResolver` + `import(\`./sections/${key}.tsx\`)` (`export default`).
+- `createLazyResolver` + `import(\`./sections/${key}.tsx\`)` — только вкладки внутри модуля (`TabSections`), не страницы.
 - Persist sessionStorage (crypto), `urlTemplate` по желанию.
 - `GuardRoute`, `RouteLoader`, `RouterOutletStack`.
+- `paths` / `resolveLazyPage` — если папки не `pages/` и `modules/`.
 
 ## Нельзя
 
 - `react-router` / `window.location` как основной роутер приложения.
+- Второй `import.meta.glob` + `importModules` для модалок, если glob уже в `createRouter`.
+- `resolveLazyPage` и заглушка `<span aria-hidden />` «чтобы завелось».
 - Смешивать ключи вкладок разных модулей (после смены таба откроется чужая lazy-секция).
 - Нормализовать регистр сегментов самостоятельно, если URL-слой включён — библиотека не нижний регистр.

package/templates/orbit/README.md

@@ -1,12 +1,13 @@
 # Orbit
 
-Шаблон витрины на `@elcrm/components`: `Layout` + `Sidebar` + дашборд Home.
+Витрина: `web/` (React + Vite) и `api/` (Bun + SQLite), как panel.
 
 ```bash
 elcrm create my-shop --template orbit
 bun run dev
 ```
 
-Web: http://localhost:5173
+- Web: http://localhost:5173
+- API: http://localhost:4545 (`/v1/...`)
 
-Демо-вход: любой логин/пароль (локальный store, API не обязателен).
+Демо-вход: `admin` / `admin`

package/templates/orbit/api/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "orbit-api",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "module": "src/index.ts",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts"
+  },
+  "dependencies": {
+    "@elcrm/server": "^0.6.2",
+    "@elcrm/deploy": "^0.0.10"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

package/templates/orbit/api/src/config.ts

@@ -0,0 +1,49 @@
+/** Конфиг panel.api */
+
+const isProd = process.env.NODE_ENV === "production";
+
+/** Не 3535 — часто занят icons.api / другими сервисами elCRM */
+export const PORT = Number(process.env.PORT ?? 4545);
+
+function requireSecret(envName: string, devFallback: string): string {
+  const v = process.env[envName]?.trim();
+  if (v) return v;
+  if (isProd) {
+    console.error(`❌ ${envName} обязателен в production`);
+    process.exit(1);
+  }
+  console.warn(`⚠️  ${envName} не задан — dev-секрет (только локально)`);
+  return devFallback;
+}
+
+/** Секрет AES для ssid (@elcrm/jwt) */
+export const TOKEN = requireSecret("TOKEN", "panel-dev-secret-change-me");
+
+/** SQLite по умолчанию */
+export const DB_PATH =
+  process.env.SQLITE_PATH?.trim() ||
+  process.env.DB_BASE?.trim() ||
+  "./data/panel.db";
+
+/** Секрет hot-upload (@elcrm/deploy), опционально */
+export const UPD = process.env.UPD?.trim() || "";
+
+export function getCorsOrigin(): string | string[] {
+  const raw = process.env.CORS_ORIGINS?.trim();
+  if (!raw || raw === "*") {
+    if (!isProd) {
+      return [
+        "http://localhost:5173",
+        "http://localhost:3000",
+        "http://127.0.0.1:5173",
+        "http://127.0.0.1:3000",
+      ];
+    }
+    return raw === "*" ? ["http://localhost:5173"] : [];
+  }
+  const list = raw
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean);
+  return list.length === 1 ? list[0]! : list;
+}

package/templates/orbit/api/src/index.ts

@@ -0,0 +1,72 @@
+/**
+ * orbit.api — createRouter + createServer; JWT/CORS/cron из конфига.
+ */
+import { createServer, cors as serverCors } from "@elcrm/server";
+import { DB_PATH, getCorsOrigin, PORT, TOKEN } from "./config";
+import { initDatabase } from "./lib/db";
+import { jwt } from "./lib/jwt";
+import "./lib/cron";
+import { registerRoutes } from "./routes/index";
+
+async function start() {
+  // TOKEN в env — createJWT/createServer видят один секрет
+  if (!process.env.TOKEN?.trim()) {
+    process.env.TOKEN = TOKEN;
+  }
+
+  await initDatabase();
+  registerRoutes();
+
+  try {
+    createServer({
+      port: PORT,
+      prefix: "/v1",
+      // alias + password hash — явный jwt; иначе хватило бы omit + TOKEN
+      jwt,
+      // auth в exclude: pass без ssid; me/profile — middleware requireUser (user уже из createServer)
+      jwtAuth: { bearer: false },
+      securityHeaders: true,
+      cron: true,
+      cors: serverCors({
+        origin: getCorsOrigin(),
+        credentials: true,
+        headers: [
+          "Content-Type",
+          "Authorization",
+          "ssid",
+          "user-agent",
+          "X-Request-Id",
+        ],
+        methods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
+      }),
+      onError: (err, ctx) => {
+        console.error(
+          "[orbit.api]",
+          ctx.requestId,
+          ctx.path.join("/"),
+          err instanceof Error ? err.message : err,
+        );
+      },
+    });
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    if (msg.includes("EADDRINUSE") || msg.includes("port")) {
+      console.error(
+        `❌ Порт ${PORT} занят. Освободите его или задайте другой:\n` +
+          `   PORT=4546 bun run dev\n` +
+          `   lsof -iTCP:${PORT} -sTCP:LISTEN`,
+      );
+    }
+    throw e;
+  }
+
+  console.log(`orbit.api: http://localhost:${PORT}`);
+  console.log(`  path-RPC: /v1/{router}/{method}`);
+  console.log(`  db:       ${DB_PATH}`);
+  console.log(`  demo:     admin / admin`);
+}
+
+start().catch((e) => {
+  console.error(e instanceof Error ? e.message : e);
+  process.exit(1);
+});

package/templates/orbit/api/src/lib/cron.ts

@@ -0,0 +1,13 @@
+/**
+ * Минимальный cron — heartbeat. createServer({ cron: true }) / CRON_AUTORUN=1
+ * подхватит cron.run() сам.
+ */
+import { cron } from "@elcrm/server/cron";
+
+cron.use(
+  () => {
+    console.log(`[cron] heartbeat ${new Date().toISOString()}`);
+  },
+  "0 */10 * * * *",
+  "heartbeat",
+);

package/templates/orbit/api/src/lib/db.ts

@@ -0,0 +1,53 @@
+/**
+ * SQLite через @elcrm/server/db + схема users и демо-админ.
+ * Каталог для файла БД создаёт сам openSqlite (ensureDir) — node:fs не нужен.
+ */
+import { db, initDB } from "@elcrm/server/db";
+import { DB_PATH } from "../config";
+import { jwt } from "./jwt";
+
+let ready: Promise<typeof db> | null = null;
+
+export async function initDatabase() {
+  if (!ready) {
+    ready = (async () => {
+      await initDB({ type: "sqlite", database: DB_PATH });
+      const ok = await db.ping();
+      if (!ok) throw new Error(`SQLite недоступна: ${DB_PATH}`);
+      await migrate();
+      console.log(`✅ DB (sqlite): ${DB_PATH}`);
+      return db;
+    })();
+  }
+  return ready;
+}
+
+async function migrate() {
+  await db.run(`
+    CREATE TABLE IF NOT EXISTS users (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      login TEXT NOT NULL UNIQUE,
+      password TEXT NOT NULL,
+      active INTEGER NOT NULL DEFAULT 1,
+      admin INTEGER NOT NULL DEFAULT 0,
+      display_name TEXT DEFAULT '',
+      email TEXT DEFAULT '',
+      avatar TEXT DEFAULT ''
+    )
+  `);
+
+  const count = await db.get<{ n: number }>(
+    "SELECT count(*) AS n FROM users",
+  );
+  if (!count?.n) {
+    const hash = jwt.password("admin");
+    await db.run(
+      `INSERT INTO users (login, password, active, admin, display_name, email)
+       VALUES (?, ?, 1, 1, ?, ?)`,
+      ["admin", hash, "Administrator", "admin@localhost"],
+    );
+    console.log("✅ seed: admin / admin");
+  }
+}
+
+export { db };

package/templates/orbit/api/src/lib/jwt.ts

@@ -0,0 +1,19 @@
+import { createJWT } from "@elcrm/server/jwt";
+import { TOKEN } from "../config";
+
+export const jwt = createJWT({
+  secret: TOKEN,
+  alias: [
+    ["i", "id"],
+    ["a", "admin"],
+  ],
+  validateAgent: true,
+  excludeRoutes: ["auth", "health", "version"],
+});
+
+export type JwtUser = {
+  id: number;
+  admin?: number;
+  agent?: string;
+  [key: string]: unknown;
+};