@icomponents/shell 0.0.0-stage → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +337 -0
- package/hooks/session-rules.test.ts +68 -0
- package/hooks/session-rules.ts +95 -0
- package/package.json +49 -4
- package/src/cabinet-scroll.test.ts +17 -0
- package/src/dashboard-shell.test.tsx +89 -0
- package/src/dashboard-shell.tsx +384 -0
- package/src/nav.test.ts +202 -0
- package/src/nav.ts +297 -0
- package/src/organization.test.tsx +61 -0
- package/src/organization.ts +25 -0
- package/src/package-contract.test.ts +19 -0
- package/src/palette-switch.test.tsx +53 -0
- package/src/platform-header.tsx +84 -0
- package/src/platform-modules.test.tsx +110 -0
- package/src/platform-modules.ts +99 -0
- package/src/session-control.tsx +83 -0
- package/src/use-platform-modules.ts +40 -0
- package/README.md +0 -3
package/src/nav.ts
ADDED
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* РЕЕСТР МОДУЛЕЙ ПЛАТФОРМЫ — единственный ответ на вопрос «из чего состоит кабинет».
|
|
3
|
+
*
|
|
4
|
+
* Модуль здесь — самостоятельный продукт со своим деплоем, своим API и своим префиксом пути
|
|
5
|
+
* (`/italent`, `/calendar`), а не раздел одного приложения. Поэтому переход между пунктами — это
|
|
6
|
+
* обычная навигация браузера, а не клиентский роутинг: соседний модуль живёт в другом бандле.
|
|
7
|
+
*
|
|
8
|
+
* Почему список общий, а не свой у каждого приложения: иначе новый модуль появляется в меню там, где
|
|
9
|
+
* про него вспомнили, и кабинет показывает разный состав в зависимости от того, на какой странице
|
|
10
|
+
* человек находится. Это выглядит как сломанное меню, а не как несогласованные константы.
|
|
11
|
+
*
|
|
12
|
+
* ВИДИМОСТЬ — ПО РОЛЯМ ПРОЕКТА, а не по правам. Проект в Zitadel соответствует модулю, и роль в нём
|
|
13
|
+
* означает «этому человеку выдан доступ к продукту». Право (`jobs:read`) отвечает на другой вопрос —
|
|
14
|
+
* «что он может внутри» — и остаётся делом самого модуля. Смешивать их нельзя: меню, построенное по
|
|
15
|
+
* правам, требует от кабинета знать правовую модель каждого соседа.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
import { parseProjectRole, type ProjectRole } from "@icomponents/auth/project-role";
|
|
19
|
+
import type { ComponentType } from "react";
|
|
20
|
+
|
|
21
|
+
export { parseProjectRole, type ProjectRole };
|
|
22
|
+
|
|
23
|
+
export interface PlatformModule {
|
|
24
|
+
/** Стабильный ключ: по нему подсвечивается активный пункт и берётся перевод. */
|
|
25
|
+
id: string;
|
|
26
|
+
/** Ключ перевода в неймспейсе `nav` (плитки хаба). Сайдбар берёт `title`. */
|
|
27
|
+
titleKey: string;
|
|
28
|
+
/**
|
|
29
|
+
* Подпись модуля — ОДНА на платформу, в реестре, а не в словаре каждого модуля: иначе один и тот
|
|
30
|
+
* же пункт назывался по-разному в зависимости от того, в каком модуле открыт сайдбар.
|
|
31
|
+
*/
|
|
32
|
+
title: { ru: string; en: string };
|
|
33
|
+
/** Внешний путь модуля от корня домена. Все модули живут на ОДНОМ домене, разными префиксами. */
|
|
34
|
+
href: string;
|
|
35
|
+
/** Проект в Zitadel, к которому относится модуль. Обычно совпадает с `id`. */
|
|
36
|
+
project: string;
|
|
37
|
+
/**
|
|
38
|
+
* Роли, любая из которых открывает пункт. Не задано — достаточно ЛЮБОЙ роли в проекте: наличие
|
|
39
|
+
* роли и есть факт выдачи доступа к продукту. Задавать имеет смысл для пунктов, которые видит не
|
|
40
|
+
* каждый, кому выдан модуль (например, административный раздел).
|
|
41
|
+
*/
|
|
42
|
+
roles?: readonly string[];
|
|
43
|
+
/** Группа в сайдбаре (ключ перевода). Группа без видимых пунктов не рисуется. */
|
|
44
|
+
groupKey: string;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Состав платформы. Новый модуль добавляется ОДНОЙ строкой — и появляется в меню всех приложений,
|
|
49
|
+
* которые обновят версию пакета.
|
|
50
|
+
*
|
|
51
|
+
* Порядок здесь — это порядок в сайдбаре, и он не алфавитный намеренно: сверху то, чем пользуются
|
|
52
|
+
* каждый день.
|
|
53
|
+
*/
|
|
54
|
+
export const PLATFORM_MODULES: readonly PlatformModule[] = [
|
|
55
|
+
// `iadmin` (Управление) снят с меню 24.09.2026: модуль не работает, пункт вёл в пустоту. Вернуть —
|
|
56
|
+
// строкой здесь, когда он поднимется.
|
|
57
|
+
{
|
|
58
|
+
id: "italent",
|
|
59
|
+
titleKey: "italent",
|
|
60
|
+
title: { ru: "Таланты", en: "Talents" },
|
|
61
|
+
href: "/italent",
|
|
62
|
+
project: "italent",
|
|
63
|
+
groupKey: "groupHiring",
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
/*
|
|
67
|
+
РАСЧЁТЫ С ИСПОЛНИТЕЛЯМИ. Модуль на том же хосте, префикс `/ipayment`.
|
|
68
|
+
|
|
69
|
+
`project` — имя проекта в ZITADEL, и по нему же отбирается видимость (`visibleModules`).
|
|
70
|
+
Совпадение с `id` здесь не случайность и не может быть нарушено: роль приезжает в токене как
|
|
71
|
+
`<проект>:<роль>`, и разъехавшееся имя означало бы пункт, невидимый ВСЕМ, — при выданной роли
|
|
72
|
+
и без единой ошибки.
|
|
73
|
+
*/
|
|
74
|
+
id: "ipayment",
|
|
75
|
+
titleKey: "ipayment",
|
|
76
|
+
title: { ru: "Расчёты", en: "Payments" },
|
|
77
|
+
href: "/ipayment",
|
|
78
|
+
project: "ipayment",
|
|
79
|
+
groupKey: "groupWork",
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
// Досье документов по заявкам и клиентам — рабочее место операторов.
|
|
83
|
+
id: "idossier",
|
|
84
|
+
titleKey: "idossier",
|
|
85
|
+
title: { ru: "Досье", en: "Dossier" },
|
|
86
|
+
href: "/idossier",
|
|
87
|
+
project: "idossier",
|
|
88
|
+
groupKey: "groupWork",
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
// Сессии агентов omp по пространствам (роль пространства = роль проекта iomp). Пункт — только людям
|
|
92
|
+
// с `iomp:user` или `iomp:admin`: у служебной учётки iagent тоже есть роль проекта, кабинет ей не нужен.
|
|
93
|
+
id: "iomp",
|
|
94
|
+
titleKey: "iomp",
|
|
95
|
+
title: { ru: "Сессии агентов", en: "Agent sessions" },
|
|
96
|
+
href: "/iomp",
|
|
97
|
+
project: "iomp",
|
|
98
|
+
roles: ["user", "admin"],
|
|
99
|
+
groupKey: "groupWork",
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
// Вход и учётные записи. Проект — `iprofile`: замер живого ZITADEL 02.09.2026 отдаёт гранты
|
|
103
|
+
// `iprofile:user` и `italent:specialist`. Стояло `ilogin` — это имя прежнего ПРИЛОЖЕНИЯ
|
|
104
|
+
// (`ilogin/iprofile-app`), а не проекта, и с ним пункт не показался бы никому.
|
|
105
|
+
id: "iprofile",
|
|
106
|
+
titleKey: "iprofile",
|
|
107
|
+
title: { ru: "Профиль", en: "Profile" },
|
|
108
|
+
href: "/iprofile",
|
|
109
|
+
project: "iprofile",
|
|
110
|
+
groupKey: "groupPlatform",
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
// Кабинет агентов. Ключи ролей проекта iagent сами несут префикс (`iagent:owner`), поэтому грант
|
|
114
|
+
// приходит как `iagent:iagent:owner`; служебные роли sender/reader/db пункт не открывают.
|
|
115
|
+
id: "iagent",
|
|
116
|
+
titleKey: "iagent",
|
|
117
|
+
title: { ru: "Агенты", en: "Agents" },
|
|
118
|
+
href: "/iagent",
|
|
119
|
+
project: "iagent",
|
|
120
|
+
roles: ["iagent:platform-admin", "iagent:owner"],
|
|
121
|
+
groupKey: "groupPlatform",
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
id: "interviews",
|
|
125
|
+
titleKey: "interviews",
|
|
126
|
+
title: { ru: "Собеседования", en: "Interviews" },
|
|
127
|
+
href: "/interviews",
|
|
128
|
+
project: "interviews",
|
|
129
|
+
groupKey: "groupHiring",
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
// Голосовой скрининг кандидата по вакансии; кабинет — только чтение для `iscreening:recruiter`.
|
|
133
|
+
id: "iscreening",
|
|
134
|
+
titleKey: "iscreening",
|
|
135
|
+
title: { ru: "Скрининг", en: "Screening" },
|
|
136
|
+
href: "/iscreening",
|
|
137
|
+
project: "iscreening",
|
|
138
|
+
groupKey: "groupHiring",
|
|
139
|
+
},
|
|
140
|
+
{
|
|
141
|
+
id: "calendar",
|
|
142
|
+
titleKey: "calendar",
|
|
143
|
+
title: { ru: "Календарь", en: "Calendar" },
|
|
144
|
+
href: "/calendar",
|
|
145
|
+
project: "calendar",
|
|
146
|
+
groupKey: "groupWork",
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
id: "tasks",
|
|
150
|
+
titleKey: "tasks",
|
|
151
|
+
title: { ru: "Задачи", en: "Tasks" },
|
|
152
|
+
href: "/tasks",
|
|
153
|
+
project: "tasks",
|
|
154
|
+
groupKey: "groupWork",
|
|
155
|
+
},
|
|
156
|
+
];
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* Отбор модулей по ролям пользователя.
|
|
160
|
+
*
|
|
161
|
+
* `null` (роли ещё грузятся) даёт пустой список — deny-default, как на сервере: лучше пустой сайдбар
|
|
162
|
+
* на долю секунды, чем мелькнувший пункт, которого человеку не положено видеть.
|
|
163
|
+
*/
|
|
164
|
+
export function visibleModules(
|
|
165
|
+
roles: readonly ProjectRole[] | null,
|
|
166
|
+
modules: readonly PlatformModule[] = PLATFORM_MODULES
|
|
167
|
+
): PlatformModule[] {
|
|
168
|
+
if (!roles) return [];
|
|
169
|
+
|
|
170
|
+
const byProject = new Map<string, Set<string>>();
|
|
171
|
+
for (const raw of roles) {
|
|
172
|
+
const parsed = parseProjectRole(raw);
|
|
173
|
+
if (!parsed) continue;
|
|
174
|
+
const set = byProject.get(parsed.project) ?? new Set<string>();
|
|
175
|
+
set.add(parsed.role);
|
|
176
|
+
byProject.set(parsed.project, set);
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
return modules.filter((module) => {
|
|
180
|
+
const held = byProject.get(module.project);
|
|
181
|
+
if (!held || held.size === 0) return false;
|
|
182
|
+
return module.roles ? module.roles.some((role) => held.has(role)) : true;
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* Активен тот модуль, чей префикс совпадает с началом пути. Сравнение по СЕГМЕНТУ, а не простой
|
|
188
|
+
* `startsWith`: иначе `/tasks` подсветился бы на `/tasks-archive`, и человек видел бы себя не там,
|
|
189
|
+
* где он есть.
|
|
190
|
+
*/
|
|
191
|
+
export function activeModuleId(
|
|
192
|
+
pathname: string,
|
|
193
|
+
modules: readonly PlatformModule[] = PLATFORM_MODULES
|
|
194
|
+
): string | undefined {
|
|
195
|
+
return modules.find((m) => pathname === m.href || pathname.startsWith(`${m.href}/`))?.id;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* РАЗДЕЛ ВНУТРИ МОДУЛЯ — второй уровень меню, и он принципиально не то же самое, что модуль.
|
|
200
|
+
*
|
|
201
|
+
* Модуль — соседнее приложение в своём бандле, переход к нему — навигация браузера. Раздел живёт в
|
|
202
|
+
* ТОМ ЖЕ бандле, что и текущая страница, и переход между разделами — клиентский роутинг: полная
|
|
203
|
+
* перезагрузка теряла бы состояние приложения на ровном месте. Поэтому ссылку раздела рисует сам
|
|
204
|
+
* модуль (`renderSectionLink`), а оболочка ни про какой роутер не знает.
|
|
205
|
+
*
|
|
206
|
+
* Состав разделов НЕ общий: он определяется тем, какие экраны конкретный модуль подключил, и в
|
|
207
|
+
* реестре платформы ему делать нечего. Общей остаётся ФОРМА — та же группа, те же кнопки, та же
|
|
208
|
+
* подсветка, что у модулей.
|
|
209
|
+
*/
|
|
210
|
+
export interface ModuleSection {
|
|
211
|
+
/** Стабильный ключ: подсветка активного и `data-testid`. Не выводится из пути — путь может смениться. */
|
|
212
|
+
key: string;
|
|
213
|
+
/** Путь ОТ КОРНЯ ДОМЕНА (`/italent/jobs`), а не от префикса модуля: сравнивается с `pathname` целиком. */
|
|
214
|
+
href: string;
|
|
215
|
+
/** Готовая подпись. Переводит модуль: ключи его разделов оболочке неизвестны. */
|
|
216
|
+
title: string;
|
|
217
|
+
icon?: ComponentType<{ className?: string }>;
|
|
218
|
+
/**
|
|
219
|
+
* Совпадать ТОЛЬКО точным путём. Нужно корню модуля («Обзор» на `/italent`): его префикс
|
|
220
|
+
* покрывает вообще все страницы модуля, и без этого флага «Обзор» горел бы на каждой из них —
|
|
221
|
+
* в том числе на тех, которых ни один раздел не объявлял.
|
|
222
|
+
*/
|
|
223
|
+
exact?: boolean;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/**
|
|
227
|
+
* Активный раздел. Правило то же, что у модулей (совпадение по границе сегмента), плюс ВЫБОР
|
|
228
|
+
* САМОГО ДЛИННОГО совпадения: разделы вкладываются друг в друга (`/italent` ⊃ `/italent/jobs`),
|
|
229
|
+
* и первое подошедшее — не то же самое, что самое точное.
|
|
230
|
+
*/
|
|
231
|
+
/**
|
|
232
|
+
* Группа СВОИХ разделов модуля.
|
|
233
|
+
*
|
|
234
|
+
* Появилась 04.09.2026 ради модулей, у которых меню не плоское: у платежей оператор видит шесть
|
|
235
|
+
* именованных групп (платежи, справочники, офферы, сервис, настройки, бухгалтерия), и один список
|
|
236
|
+
* в тридцать строк — заметное ухудшение для того, кто работает там каждый день. Оболочка при этом
|
|
237
|
+
* остаётся одна: группы приходят ДАННЫМИ, а не второй разметкой на стороне модуля.
|
|
238
|
+
*/
|
|
239
|
+
export interface SectionGroup {
|
|
240
|
+
/** Ключ перевода заголовка группы. Пусто — группа без подписи. */
|
|
241
|
+
groupKey?: string;
|
|
242
|
+
sections: readonly ModuleSection[];
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* Свести обе формы объявления разделов к одной — списку групп.
|
|
247
|
+
*
|
|
248
|
+
* Форм две, потому что плоская была первой и ею пользуются модули, у которых разделов два-три:
|
|
249
|
+
* заставлять их оборачивать список в группу значило бы сломать всех ради одного. Обе формы сразу —
|
|
250
|
+
* ошибка вызывающего, и она разрешается в пользу групп молча, но предсказуемо: смешение означало
|
|
251
|
+
* бы два ответа на вопрос «из чего состоит меню модуля».
|
|
252
|
+
*/
|
|
253
|
+
export function ownSectionGroups(input: {
|
|
254
|
+
sections?: readonly ModuleSection[];
|
|
255
|
+
sectionsGroupKey?: string;
|
|
256
|
+
sectionGroups?: readonly SectionGroup[];
|
|
257
|
+
}): readonly SectionGroup[] {
|
|
258
|
+
const grouped = (input.sectionGroups ?? []).filter((group) => group.sections.length > 0);
|
|
259
|
+
if (grouped.length > 0) return grouped;
|
|
260
|
+
return input.sections?.length
|
|
261
|
+
? [{ groupKey: input.sectionsGroupKey, sections: input.sections }]
|
|
262
|
+
: [];
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/** Все разделы модуля одним списком — для подсветки активного, которой группы безразличны. */
|
|
266
|
+
export function allSections(groups: readonly SectionGroup[]): readonly ModuleSection[] {
|
|
267
|
+
return groups.flatMap((group) => group.sections);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
export function activeSectionKey(
|
|
271
|
+
pathname: string,
|
|
272
|
+
sections: readonly ModuleSection[]
|
|
273
|
+
): string | undefined {
|
|
274
|
+
let best: ModuleSection | undefined;
|
|
275
|
+
for (const section of sections) {
|
|
276
|
+
const hit = section.exact
|
|
277
|
+
? pathname === section.href
|
|
278
|
+
: pathname === section.href || pathname.startsWith(`${section.href}/`);
|
|
279
|
+
if (!hit) continue;
|
|
280
|
+
if (!best || section.href.length > best.href.length) best = section;
|
|
281
|
+
}
|
|
282
|
+
return best?.key;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/** Группировка для сайдбара, в порядке первого появления группы в реестре. */
|
|
286
|
+
export function groupModules(modules: readonly PlatformModule[]): {
|
|
287
|
+
groupKey: string;
|
|
288
|
+
items: PlatformModule[];
|
|
289
|
+
}[] {
|
|
290
|
+
const groups: { groupKey: string; items: PlatformModule[] }[] = [];
|
|
291
|
+
for (const module of modules) {
|
|
292
|
+
const group = groups.find((g) => g.groupKey === module.groupKey);
|
|
293
|
+
if (group) group.items.push(module);
|
|
294
|
+
else groups.push({ groupKey: module.groupKey, items: [module] });
|
|
295
|
+
}
|
|
296
|
+
return groups;
|
|
297
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
|
|
3
|
+
import { renderToStaticMarkup } from "react-dom/server";
|
|
4
|
+
|
|
5
|
+
import { DashboardShell } from "./dashboard-shell";
|
|
6
|
+
import { organizationInitials } from "./organization";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Угол сайдбара — организация, от лица которой работает человек, одна во всех модулях. Раньше
|
|
10
|
+
* каждый модуль рисовал угол сам (`brandSlot`), и они разъехались: «im italent» против
|
|
11
|
+
* «ip ООО "ПРОСТО"». Тесты модулей цепляются за `brand-home` и `brand-organization`, поэтому эти
|
|
12
|
+
* testid — контракт, а не деталь вёрстки.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
const render = (organization?: { name: string; href?: string } | null) =>
|
|
16
|
+
renderToStaticMarkup(
|
|
17
|
+
<DashboardShell
|
|
18
|
+
pathname="/italent/jobs"
|
|
19
|
+
roles={["italent:customers"]}
|
|
20
|
+
t={(key) => key}
|
|
21
|
+
brandTitle="Платформа"
|
|
22
|
+
organization={organization}
|
|
23
|
+
/>
|
|
24
|
+
);
|
|
25
|
+
|
|
26
|
+
describe("угол сайдбара — организация", () => {
|
|
27
|
+
test("задана со ссылкой — название, плашка с инициалами и ссылка brand-home", () => {
|
|
28
|
+
const html = render({ name: 'ООО "ПРОСТО"', href: "/iprofile/organization" });
|
|
29
|
+
expect(html).toContain('data-testid="brand-home"');
|
|
30
|
+
expect(html).toContain('href="/iprofile/organization"');
|
|
31
|
+
expect(html).toMatch(/data-testid="brand-organization"[^>]*>ООО "ПРОСТО"</);
|
|
32
|
+
expect(html).toContain(">ПР<");
|
|
33
|
+
expect(html).not.toContain(">Платформа<");
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
test("без ссылки — угол без brand-home, название на месте", () => {
|
|
37
|
+
const html = render({ name: 'ООО "ПРОСТО"' });
|
|
38
|
+
expect(html).not.toContain('data-testid="brand-home"');
|
|
39
|
+
expect(html).toContain('data-testid="brand-organization"');
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
test("null или не задана — прежний угол brandTitle", () => {
|
|
43
|
+
for (const organization of [null, undefined]) {
|
|
44
|
+
const html = render(organization);
|
|
45
|
+
expect(html).toContain(">Платформа<");
|
|
46
|
+
expect(html).not.toContain('data-testid="brand-organization"');
|
|
47
|
+
}
|
|
48
|
+
});
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
describe("инициалы организации", () => {
|
|
52
|
+
test.each([
|
|
53
|
+
['ООО "ПРОСТО"', "ПР"],
|
|
54
|
+
["АО «Рога и Копыта»", "РК"],
|
|
55
|
+
["Iconicompany", "IC"],
|
|
56
|
+
["ИП Иванов Пётр", "ИП"],
|
|
57
|
+
[" ", "?"],
|
|
58
|
+
])("%s → %s", (name, initials) => {
|
|
59
|
+
expect(organizationInitials(name)).toBe(initials);
|
|
60
|
+
});
|
|
61
|
+
});
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Организация в углу сайдбара — от её лица человек работает во всех модулях CRM.
|
|
3
|
+
*
|
|
4
|
+
* Данные — ответ модуля `/api/platform/me` (`organization: { id, name } | null`) — тот же ответ,
|
|
5
|
+
* из которого приходят роли, второго запроса нет.
|
|
6
|
+
*/
|
|
7
|
+
export interface ShellOrganization {
|
|
8
|
+
name: string;
|
|
9
|
+
/** Ссылка угла: страница организации. Не задана — угол без ссылки. */
|
|
10
|
+
href?: string;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/** Организационно-правовая форма — не имя: у «ООО "ПРОСТО"» инициалы «ПР», а не «ОП». */
|
|
14
|
+
const LEGAL_FORMS = new Set(["ооо", "оао", "зао", "пао", "ао", "ип", "нко", "llc", "inc", "ltd"]);
|
|
15
|
+
|
|
16
|
+
/** Две буквы для плашки: первые буквы двух слов названия или две первые буквы одного. */
|
|
17
|
+
export function organizationInitials(name: string): string {
|
|
18
|
+
const words = name
|
|
19
|
+
.replace(/["«»„“”']/g, " ")
|
|
20
|
+
.split(/\s+/)
|
|
21
|
+
.filter((word) => word.length > 1 && !LEGAL_FORMS.has(word.toLowerCase()));
|
|
22
|
+
if (words.length === 0) return "?";
|
|
23
|
+
const letters = words.length === 1 ? words[0]!.slice(0, 2) : words[0]![0]! + words[1]![0]!;
|
|
24
|
+
return letters.toUpperCase();
|
|
25
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
|
|
3
|
+
/** Кит и React — только пиры: своей копией пакет ставил вторую, два React-контекста (italent, 30.09.2026). */
|
|
4
|
+
const manifest = (await Bun.file(new URL("../package.json", import.meta.url)).json()) as {
|
|
5
|
+
dependencies?: Record<string, string>;
|
|
6
|
+
peerDependencies?: Record<string, string>;
|
|
7
|
+
};
|
|
8
|
+
|
|
9
|
+
describe("зависимости пакета", () => {
|
|
10
|
+
test("@icomponents/* и React — только пиры", () => {
|
|
11
|
+
const own = Object.keys(manifest.dependencies ?? {});
|
|
12
|
+
expect(
|
|
13
|
+
own.filter((name) => name.startsWith("@icomponents/") || name.startsWith("react"))
|
|
14
|
+
).toEqual([]);
|
|
15
|
+
for (const name of Object.keys(manifest.peerDependencies ?? {}))
|
|
16
|
+
expect(manifest.dependencies?.[name]).toBeUndefined();
|
|
17
|
+
expect(manifest.peerDependencies?.react).toBeDefined();
|
|
18
|
+
});
|
|
19
|
+
});
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
|
|
3
|
+
import { BRAND_THEMES } from "@icomponents/theme/themes";
|
|
4
|
+
import { renderToStaticMarkup } from "react-dom/server";
|
|
5
|
+
|
|
6
|
+
import { DashboardShell } from "./dashboard-shell";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Две вещи, которые ломаются молча.
|
|
10
|
+
*
|
|
11
|
+
* 1. СЕРВЕРНЫЙ РЕНДЕР. Выбор палитры трогает `document` и `localStorage`; сделай это при рендере,
|
|
12
|
+
* а не в эффекте — и витрина, которая рендерится на сервере, упадёт на `window is not defined`.
|
|
13
|
+
* Проверяется рендером, а не рассуждением: ровно так же проверяли `ThemeSwitch` кита.
|
|
14
|
+
* 2. НАСТРОЙКА ВИДИМОСТИ. Смысл `controls` — выключить элемент без выпуска пакета. Проп, который
|
|
15
|
+
* молча ничего не делает, выглядит как работающий ровно до того момента, когда он понадобится.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
const SESSION = {
|
|
19
|
+
user: { name: "Пётр", email: "p@example.com" },
|
|
20
|
+
onSignIn: () => {},
|
|
21
|
+
onSignOut: () => {},
|
|
22
|
+
labels: { signIn: "Войти", signOut: "Выйти" },
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
const render = (controls?: { palette?: boolean }) =>
|
|
26
|
+
renderToStaticMarkup(
|
|
27
|
+
<DashboardShell
|
|
28
|
+
pathname="/italent/jobs"
|
|
29
|
+
roles={["italent:customers"]}
|
|
30
|
+
t={(key) => key}
|
|
31
|
+
brandTitle="Платформа"
|
|
32
|
+
session={SESSION}
|
|
33
|
+
controls={controls}
|
|
34
|
+
/>
|
|
35
|
+
);
|
|
36
|
+
|
|
37
|
+
describe("выбор палитры в общей шапке", () => {
|
|
38
|
+
test("рисуется без обращения к window — полоса переживает серверный рендер", () => {
|
|
39
|
+
expect(render()).toContain('data-testid="color-theme-switch"');
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
test("controls.palette=false убирает его из разметки", () => {
|
|
43
|
+
expect(render({ palette: false })).not.toContain('data-testid="color-theme-switch"');
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
test("controls без палитры оставляет умолчание — элемент виден", () => {
|
|
47
|
+
expect(render({})).toContain('data-testid="color-theme-switch"');
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
test("в реестре больше одной темы: список из одного пункта — не выбор", () => {
|
|
51
|
+
expect(BRAND_THEMES.length).toBeGreaterThan(1);
|
|
52
|
+
});
|
|
53
|
+
});
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { SessionControl, type SessionControlProps } from "./session-control";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* ПОЛОСА ПЛАТФОРМЫ — верх, одинаковый у витрины (`/`), подбора (`/italent`), админки (`/iadmin`)
|
|
5
|
+
* и всякого следующего модуля.
|
|
6
|
+
*
|
|
7
|
+
* Зачем компонент, если оболочка кабинета уже общая. Оболочка отдавала правый угол шапки модулю
|
|
8
|
+
* (`headerSlot?: React.ReactNode` — «профиль, переключатели темы и языка: их владеет приложение»),
|
|
9
|
+
* и с четырьмя модулями это дало четыре разных правых угла. Свободный слот — не отступление от
|
|
10
|
+
* замысла общей оболочки, а дыра в нём: договорённость «кладите одно и то же» никем не
|
|
11
|
+
* проверяется, и шестой модуль соберёт угол по-своему, ничего не нарушив.
|
|
12
|
+
*
|
|
13
|
+
* Поэтому здесь порядок правого угла ЗАДАН, а не предложен: действия модуля → язык → тема →
|
|
14
|
+
* сессия. Модуль отдаёт сессию ДАННЫМИ (`SessionControlProps`), а не узлом, и своей кнопки входа
|
|
15
|
+
* нарисовать не может — для неё нет места в контракте.
|
|
16
|
+
*
|
|
17
|
+
* Что осталось модулю: `leading` (кнопка сайдбара в кабинете, ничего на витрине), `center` (поиск
|
|
18
|
+
* подбора, меню витрины) и `actions` — УЗКИЙ слот под то, что действительно принадлежит одному
|
|
19
|
+
* модулю: диагностика подбора, палитра. Узкий он намеренно: `headerSlot` был широким, и именно
|
|
20
|
+
* поэтому в него уехала сессия.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
export interface PlatformHeaderProps {
|
|
24
|
+
/** Левый край: у кабинета — кнопка сворачивания сайдбара, у витрины — логотип. */
|
|
25
|
+
leading?: React.ReactNode;
|
|
26
|
+
/** Середина: меню витрины, поиск модуля. Занимает свободное место. */
|
|
27
|
+
center?: React.ReactNode;
|
|
28
|
+
/**
|
|
29
|
+
* Действия САМОГО модуля. Всё, что есть у всех, живёт не здесь, а в самой полосе: иначе оно
|
|
30
|
+
* снова окажется в каждом модуле своим.
|
|
31
|
+
*/
|
|
32
|
+
actions?: React.ReactNode;
|
|
33
|
+
/** Переключатель языка — не у всех модулей есть локали, поэтому по запросу. */
|
|
34
|
+
languageSlot?: React.ReactNode;
|
|
35
|
+
/**
|
|
36
|
+
* Переключатель темы — УЗЛОМ, хотя он и есть у всех.
|
|
37
|
+
*
|
|
38
|
+
* Хотелось нарисовать его прямо здесь, чтобы модуль не мог поставить свой. Нельзя: `ThemeSwitch`
|
|
39
|
+
* кита читает `ThemeProvider`, а тот в первом же `useMemo` трогает `window.matchMedia`. Полоса с
|
|
40
|
+
* ним внутри становится client-only — и витрина, которая рендерится НА СЕРВЕРЕ (`apps/web/src/ssr.tsx`),
|
|
41
|
+
* падала бы на `ReferenceError: window is not defined`. Проверено рендером, а не рассуждением.
|
|
42
|
+
*
|
|
43
|
+
* Единообразие кабинетов это не теряет: узел подставляет `DashboardShell`, а не каждый модуль
|
|
44
|
+
* (см. там же). Свобода остаётся ровно у того, кто рендерит полосу в обход оболочки, — у витрины.
|
|
45
|
+
*/
|
|
46
|
+
themeSlot?: React.ReactNode;
|
|
47
|
+
/**
|
|
48
|
+
* Выбор палитры — тоже узлом и по той же причине, что `themeSlot`: компонент трогает `document`
|
|
49
|
+
* и `localStorage`, а полоса рендерится и на сервере. Узел подставляет `DashboardShell`, и там
|
|
50
|
+
* же живёт настройка видимости — витрина о палитрах не спрашивает.
|
|
51
|
+
*/
|
|
52
|
+
paletteSlot?: React.ReactNode;
|
|
53
|
+
/** Сессия — данными. Модуль отдаёт «кто вошёл» и обработчики, вёрстку держит платформа. */
|
|
54
|
+
session: SessionControlProps;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export function PlatformHeader({
|
|
58
|
+
leading,
|
|
59
|
+
center,
|
|
60
|
+
actions,
|
|
61
|
+
languageSlot,
|
|
62
|
+
themeSlot,
|
|
63
|
+
paletteSlot,
|
|
64
|
+
session,
|
|
65
|
+
}: PlatformHeaderProps) {
|
|
66
|
+
return (
|
|
67
|
+
<header
|
|
68
|
+
data-testid="platform-header"
|
|
69
|
+
className="bg-background/80 sticky top-0 z-40 flex h-14 items-center gap-2 border-b px-4 backdrop-blur-lg"
|
|
70
|
+
>
|
|
71
|
+
{leading}
|
|
72
|
+
{center ? <div className="flex min-w-0 flex-1 items-center gap-2">{center}</div> : null}
|
|
73
|
+
{/* `ms-auto` держит правый угол у края и когда середины нет вовсе — иначе на модуле без
|
|
74
|
+
поиска сессия уезжала бы к логотипу и полоса читалась бы как чужая. */}
|
|
75
|
+
<div className={`flex items-center gap-2 ${center ? "" : "ms-auto"}`}>
|
|
76
|
+
{actions}
|
|
77
|
+
{languageSlot}
|
|
78
|
+
{paletteSlot}
|
|
79
|
+
{themeSlot}
|
|
80
|
+
<SessionControl {...session} />
|
|
81
|
+
</div>
|
|
82
|
+
</header>
|
|
83
|
+
);
|
|
84
|
+
}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
|
|
3
|
+
import { renderToStaticMarkup } from "react-dom/server";
|
|
4
|
+
|
|
5
|
+
import { DashboardShell } from "./dashboard-shell";
|
|
6
|
+
import { PLATFORM_MODULES, type PlatformModule } from "./nav";
|
|
7
|
+
import {
|
|
8
|
+
loadPlatformModules,
|
|
9
|
+
MODULES_CACHE_SECONDS,
|
|
10
|
+
MODULES_FORMAT,
|
|
11
|
+
MODULES_PATH,
|
|
12
|
+
modulesDocument,
|
|
13
|
+
parseModulesDocument,
|
|
14
|
+
} from "./platform-modules";
|
|
15
|
+
import { pickModules } from "./use-platform-modules";
|
|
16
|
+
|
|
17
|
+
const REMOTE: PlatformModule[] = [
|
|
18
|
+
{
|
|
19
|
+
id: "inew",
|
|
20
|
+
titleKey: "inew",
|
|
21
|
+
title: { ru: "Новый", en: "New" },
|
|
22
|
+
href: "/inew",
|
|
23
|
+
project: "inew",
|
|
24
|
+
groupKey: "groupWork",
|
|
25
|
+
},
|
|
26
|
+
];
|
|
27
|
+
|
|
28
|
+
const respond = (body: unknown, status = 200): typeof fetch =>
|
|
29
|
+
(async () =>
|
|
30
|
+
new Response(typeof body === "string" ? body : JSON.stringify(body), { status })) as never;
|
|
31
|
+
|
|
32
|
+
describe("документ меню", () => {
|
|
33
|
+
test("AC-MNU-01.1 — документ ilanding: ровно PLATFORM_MODULES, номер формата, кэш 5 минут", () => {
|
|
34
|
+
const doc = modulesDocument();
|
|
35
|
+
expect(doc.format).toBe(MODULES_FORMAT);
|
|
36
|
+
expect(doc.modules).toEqual(PLATFORM_MODULES);
|
|
37
|
+
expect(MODULES_PATH).toBe("/platform/modules.json");
|
|
38
|
+
expect(MODULES_CACHE_SECONDS).toBe(300);
|
|
39
|
+
// Документ переживает сериализацию без потерь: его отдают по сети.
|
|
40
|
+
expect(parseModulesDocument(JSON.parse(JSON.stringify(doc)))).toEqual(PLATFORM_MODULES);
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
test("AC-MNU-01.2 — пришедший список заменяет вшитый", async () => {
|
|
44
|
+
const loaded = await loadPlatformModules(respond({ format: MODULES_FORMAT, modules: REMOTE }));
|
|
45
|
+
expect(loaded).toEqual(REMOTE);
|
|
46
|
+
expect(pickModules(undefined, loaded)).toEqual(REMOTE);
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
test("AC-MNU-01.3 — сбой, 404, чужой формат или битый пункт — остаётся вшитый", async () => {
|
|
50
|
+
const failing = (async () => {
|
|
51
|
+
throw new Error("сеть");
|
|
52
|
+
}) as never;
|
|
53
|
+
expect(await loadPlatformModules(failing)).toBeNull();
|
|
54
|
+
expect(await loadPlatformModules(respond("не найдено", 404))).toBeNull();
|
|
55
|
+
expect(await loadPlatformModules(respond("{битый"))).toBeNull();
|
|
56
|
+
expect(parseModulesDocument({ format: 2, modules: REMOTE })).toBeNull();
|
|
57
|
+
expect(parseModulesDocument({ format: MODULES_FORMAT, modules: [] })).toBeNull();
|
|
58
|
+
expect(
|
|
59
|
+
parseModulesDocument({ format: MODULES_FORMAT, modules: [...REMOTE, { id: "без-адреса" }] })
|
|
60
|
+
).toBeNull();
|
|
61
|
+
expect(
|
|
62
|
+
parseModulesDocument({ format: MODULES_FORMAT, modules: [{ ...REMOTE[0], href: "inew" }] })
|
|
63
|
+
).toBeNull();
|
|
64
|
+
// `//host` — ссылка на чужой сайт, `roles: []` — пункт, невидимый всем.
|
|
65
|
+
expect(
|
|
66
|
+
parseModulesDocument({
|
|
67
|
+
format: MODULES_FORMAT,
|
|
68
|
+
modules: [{ ...REMOTE[0], href: "//evil.example" }],
|
|
69
|
+
})
|
|
70
|
+
).toBeNull();
|
|
71
|
+
expect(
|
|
72
|
+
parseModulesDocument({
|
|
73
|
+
format: MODULES_FORMAT,
|
|
74
|
+
modules: [{ ...REMOTE[0], href: "/\\evil.example" }],
|
|
75
|
+
})
|
|
76
|
+
).toBeNull();
|
|
77
|
+
expect(
|
|
78
|
+
parseModulesDocument({ format: MODULES_FORMAT, modules: [{ ...REMOTE[0], roles: [] }] })
|
|
79
|
+
).toBeNull();
|
|
80
|
+
expect(pickModules(undefined, null)).toBe(PLATFORM_MODULES);
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
test("AC-MNU-01.4 — первый кадр: вшитый список, без запроса в сеть", () => {
|
|
84
|
+
const calls: string[] = [];
|
|
85
|
+
const original = globalThis.fetch;
|
|
86
|
+
globalThis.fetch = (async (input: string) => {
|
|
87
|
+
calls.push(String(input));
|
|
88
|
+
return new Response("{}");
|
|
89
|
+
}) as never;
|
|
90
|
+
try {
|
|
91
|
+
const html = renderToStaticMarkup(
|
|
92
|
+
<DashboardShell
|
|
93
|
+
pathname="/italent/jobs"
|
|
94
|
+
roles={["italent:customer"]}
|
|
95
|
+
t={(key) => key}
|
|
96
|
+
brandTitle="Платформа"
|
|
97
|
+
/>
|
|
98
|
+
);
|
|
99
|
+
expect(html).toContain('data-testid="nav-item-italent"');
|
|
100
|
+
expect(calls).toEqual([]);
|
|
101
|
+
} finally {
|
|
102
|
+
globalThis.fetch = original;
|
|
103
|
+
}
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
test("AC-MNU-01.5 — свой список модуля побеждает документ", () => {
|
|
107
|
+
const own = [PLATFORM_MODULES[0]!];
|
|
108
|
+
expect(pickModules(own, REMOTE)).toBe(own);
|
|
109
|
+
});
|
|
110
|
+
});
|