Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -3,7 +3,8 @@ import * as path from "node:path";
import { describe, it, expect, vi } from "vitest";
import { AdminSidebar } from "./AdminSidebar";
import type { SideBarItem } from "./SidebarItem";
import { canonicalAdminRouteSlugs, disabledPluginRouteSlugs } from "~/utils/app/PublicRouteSegments";
import { UI_NAV_IDS } from "~/application/ui/uiRegistry";
import { canonicalAdminRouteExactPaths, canonicalAdminRouteSlugs, disabledPluginRouteSlugs } from "~/utils/app/PublicRouteSegments";
import { resolveRepoPath } from "~/utils/testing/repoPaths";
function flattenSidebarItems(items: SideBarItem[]): SideBarItem[] {
@@ -84,15 +85,14 @@ describe("AdminSidebar", () => {
expect(serialized).toContain("/accounts");
expect(serialized).toContain("/audit-trails");
expect(serialized).toContain("/notifications/messages");
expect(serialized).toContain("/feature-flags/flags");
expect(serialized).toContain("/settings/profile");
expect(serialized).not.toContain("/feature-flags");
expect(serialized).toContain("/settings/security");
expect(serialized).not.toContain("/settings/profile");
expect(serialized).not.toContain("/metrics");
expect(sidebar).toEqual(
expect.arrayContaining([
expect.objectContaining({
items: expect.arrayContaining([
expect.objectContaining({ id: "ui.nav.admin.dashboard", path: "/dashboard" }),
]),
items: expect.arrayContaining([expect.objectContaining({ id: "ui.nav.admin.dashboard", path: "/dashboard" })]),
}),
])
);
@@ -113,12 +113,15 @@ describe("AdminSidebar", () => {
expect(serialized).not.toContain("/portals");
expect(serialized).not.toContain("/prompts");
expect(serialized).not.toContain("/workflow-engine");
expect(serialized).not.toContain("\"path\":\"/crm\"");
expect(serialized).not.toContain('"path":"/crm"');
expect(serialized).not.toContain("ui.nav.admin.crm");
expect(allPaths.map((path) => path.split("/").filter(Boolean)[0])).not.toEqual(expect.arrayContaining([...disabledPluginRouteSlugs]));
expect(allPaths.map((path) => path.split("/").filter(Boolean)[0])).toEqual(expect.arrayContaining(["dashboard", "accounts", "settings"]));
allPaths.forEach((path) => {
expect(canonicalAdminRouteSlugs).toContain(path.split("/").filter(Boolean)[0] as any);
const firstSlug = path.split("/").filter(Boolean)[0] ?? "";
const isCanonicalSlug = (canonicalAdminRouteSlugs as readonly string[]).includes(firstSlug);
const isCanonicalExactPath = (canonicalAdminRouteExactPaths as readonly string[]).includes(path);
expect(isCanonicalSlug || isCanonicalExactPath, path).toBe(true);
});
sidebar.forEach((item) => {
@@ -136,6 +139,155 @@ describe("AdminSidebar", () => {
});
});
it("consolidates platform operations and support without exposing feature flags", () => {
const sidebar = AdminSidebar({ t, appConfiguration: null });
const platform = sidebar.find((item) => item.id === "ui.nav.admin.platform");
const platformItems = platform?.items ?? [];
const operations = platformItems.find((item) => item.id === "ui.nav.admin.platform.operations");
const support = platformItems.find((item) => item.id === "ui.nav.admin.platform.support");
expect(platformItems.map((item) => item.id)).toEqual(["ui.nav.admin.platform.operations", "ui.nav.admin.platform.support", UI_NAV_IDS.adminApi]);
expect(operations).toMatchObject({
title: "admin.platformNavigation.operations",
path: "/system",
isCollapsible: false,
activePaths: ["/system", "/system/health", "/system/deploys", "/system/jobs", "/system/webhooks", "/system/billing"],
anyPermissions: ["admin.metrics.view", "admin.events.view", "admin.account.subscription"],
});
expect(operations?.items?.map((item) => item.path)).toEqual([
"/system",
"/system/health",
"/system/deploys",
"/system/jobs",
"/system/webhooks",
"/system/billing",
]);
const accounts = flattenSidebarItems(sidebar).find((item) => item.id === UI_NAV_IDS.adminAccounts);
const audit = flattenSidebarItems(sidebar).find((item) => item.id === UI_NAV_IDS.adminAudit);
expect(accounts?.items?.map((item) => item.path)).not.toContain("/accounts/billing");
expect(accounts?.excludePaths).toContain("/accounts/billing");
expect(audit?.items?.map((item) => item.path)).not.toContain("/webhooks");
expect(support).toMatchObject({
title: "admin.platformNavigation.support",
path: "/support",
anyPermissions: ["admin_identity.impersonation.start", "admin.metrics.view"],
isCollapsible: false,
activePaths: ["/support", "/support/kwp-contracts"],
});
expect(support?.items?.map((item) => item.path)).toEqual(["/support", "/support/kwp-contracts"]);
expect(platformItems.at(-1)).toMatchObject({
id: UI_NAV_IDS.adminApi,
title: "admin.platformNavigation.apiAccess",
path: "/api",
});
expect(flattenSidebarItems(sidebar).map((item) => item.id)).not.toContain(UI_NAV_IDS.adminFeatureFlags);
});
it("gates platform leads only by the sales CRM read permission", () => {
const leadInbox = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null })).find((item) => item.id === "ui.nav.admin.platformLeads");
expect(leadInbox).toMatchObject({
permission: "admin_sales.crm.read",
});
});
it("keeps sales work and communication separate while nesting configuration under settings", () => {
const sidebar = AdminSidebar({ t, appConfiguration: null });
const salesGroups = sidebar.filter((item) => ["ui.nav.admin.sales", "ui.nav.admin.salesCommunication"].includes(item.id ?? ""));
const settings = flattenSidebarItems(sidebar).find((item) => item.id === UI_NAV_IDS.adminSettings);
expect(salesGroups.map((group) => group.id)).toEqual(["ui.nav.admin.sales", "ui.nav.admin.salesCommunication"]);
expect(salesGroups.map((group) => group.title)).toEqual(["admin.sales.navigation.title", "admin.sales.navigation.communicationSection"]);
expect(salesGroups[0]?.items?.map((item) => item.id)).toEqual([
"ui.nav.admin.sales.today",
"ui.nav.admin.platformLeads",
"ui.nav.admin.sales.deals",
"ui.nav.admin.sales.contacts",
"ui.nav.admin.sales.companies",
UI_NAV_IDS.adminSalesImportExport,
]);
expect(salesGroups[1]?.items?.map((item) => item.id)).toEqual(["ui.nav.admin.sales.email", "ui.nav.admin.sales.calls", "ui.nav.admin.sales.bookings"]);
expect(salesGroups.flatMap((group) => group.items ?? []).every((item) => item.icon)).toBe(true);
expect(settings?.items?.slice(-4).map((item) => item.id)).toEqual([
UI_NAV_IDS.adminSalesPipelineSettings,
UI_NAV_IDS.adminSalesLeadSettings,
UI_NAV_IDS.adminSalesFieldsTags,
UI_NAV_IDS.adminSalesTelephonySettings,
]);
expect(settings).toMatchObject({
isCollapsible: false,
activePaths: ["/settings"],
anyPermissions: expect.arrayContaining(["admin_identity.sessions.read", "admin.settings.general.view", "admin.settings.danger.reset"]),
});
expect(settings?.items?.slice(0, 3).map((item) => item.id)).toEqual([
"ui.nav.admin.settings.profile",
"ui.nav.admin.settings.adminUsers",
"ui.nav.admin.settings.adminRoles",
]);
expect(flattenSidebarItems(sidebar).map((item) => item.id)).not.toContain("ui.nav.admin.adminUsers");
expect(flattenSidebarItems(sidebar).map((item) => item.id)).not.toContain("ui.nav.admin.salesConfiguration");
});
it("gates lead automation settings with the smallest assignment permission", () => {
const settings = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null })).find((item) => item.id === "ui.nav.admin.sales.leadSettings");
expect(settings).toMatchObject({
path: "/settings/leads",
permission: "admin_sales.crm.assign",
});
});
it("exposes the personal today list with CRM read permission", () => {
const today = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null })).find((item) => item.id === "ui.nav.admin.sales.today");
expect(today).toMatchObject({
path: "/sales/tasks/today",
permission: "admin_sales.crm.read",
});
});
it("exposes telephony workspace and settings with their smallest permissions", () => {
const items = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null }));
expect(items.find((item) => item.id === "ui.nav.admin.sales.calls")).toMatchObject({
path: "/sales/calls",
permission: "admin_sales.phone.call",
});
expect(items.find((item) => item.id === "ui.nav.admin.sales.telephonySettings")).toMatchObject({
path: "/settings/telephony",
permission: "admin_sales.integrations.manage",
});
});
it("exposes tenantless platform contacts with CRM read permission", () => {
const contacts = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null })).find((item) => item.id === "ui.nav.admin.sales.contacts");
expect(contacts).toMatchObject({
path: "/sales/contacts",
permission: "admin_sales.crm.read",
});
});
it("exposes every VA-P28b data screen through its smallest permission", () => {
const items = flattenSidebarItems(AdminSidebar({ t, appConfiguration: null }));
expect(items.find((item) => item.id === "ui.nav.admin.sales.companies")).toMatchObject({
path: "/sales/companies",
permission: "admin_sales.crm.read",
});
expect(items.find((item) => item.id === "ui.nav.admin.sales.pipelineSettings")).toMatchObject({
path: "/settings/pipelines",
permission: "admin_sales.crm.write",
});
expect(items.find((item) => item.id === "ui.nav.admin.sales.fieldsTags")).toMatchObject({
path: "/settings/fields-tags",
permission: "admin_sales.crm.read",
});
expect(items.find((item) => item.id === "ui.nav.admin.sales.importExport")).toMatchObject({
path: "/sales/import-export",
permission: "admin_sales.crm.read",
});
});
it("only emits canonical admin sidebar paths backed by route files", () => {
const routePaths = collectAdminRoutePaths();
const sidebar = AdminSidebar({
@@ -1,4 +1,15 @@
import { SideBarItem } from "./SidebarItem";
import {
FeatherBuilding2,
FeatherCalendarDays,
FeatherDatabase,
FeatherKanbanSquare,
FeatherListTodo,
FeatherMail,
FeatherPhone,
FeatherTarget,
FeatherUsers,
} from "@subframe/core";
import { TFunction } from "i18next";
import IconDashboard from "~/components/layouts/icons/IconDashboard";
import MembershipCardIcon from "~/components/ui/icons/MembershipCardIcon";
@@ -7,17 +18,15 @@ import IconSettings from "~/components/layouts/icons/IconSettings";
import IconApp from "~/components/layouts/icons/IconApp";
import IconKeys from "~/components/layouts/icons/IconKeys";
import IconAnalytics from "~/components/layouts/icons/IconAnalytics";
import IconDocs from "~/components/layouts/icons/IconDocs";
import IconEmails from "~/components/layouts/icons/IconEmails";
import IconEvents from "~/components/layouts/icons/IconEvents";
import IconFeatureFlags from "~/components/layouts/icons/IconFeatureFlags";
import IconHelpDesk from "~/components/layouts/icons/IconHelpDesk";
import IconMetrics from "~/components/layouts/icons/IconMetrics";
import IconNotifications from "~/components/layouts/icons/IconNotifications";
import { UI_NAV_IDS } from "~/application/ui/uiRegistry";
import { adminPath } from "~/utils/app/CanonicalUrlUtils";
import type { PublicDomainRoutingConfig } from "~/utils/app/CrossHostUrls";
import { disabledPluginRouteSlugs } from "~/utils/app/PublicRouteSegments";
import { ADMIN_AREA_ACCESS } from "~/services/admin/admin-access-contract";
const adminSidebarPath = (path?: string) => adminPath(path, { mode: "host-aware" });
const disabledAdminRouteSlugs = new Set<string>(disabledPluginRouteSlugs);
@@ -36,6 +45,23 @@ type Props = {
routing?: PublicDomainRoutingConfig;
};
function consolidatedPlatformItem(input: {
id: string;
title: string;
path: string;
icon: SideBarItem["icon"];
permission?: SideBarItem["permission"];
anyPermissions?: SideBarItem["anyPermissions"];
contextItems: SideBarItem[];
}): SideBarItem {
return {
...input,
activePaths: input.contextItems.map((item) => item.path),
isCollapsible: false,
items: input.contextItems,
};
}
export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
{
id: "ui.nav.admin.primary",
@@ -47,6 +73,7 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
title: t("app.sidebar.dashboard"),
path: adminSidebarPath("dashboard"),
icon: <IconDashboard />,
permission: ADMIN_AREA_ACCESS.dashboard,
},
],
},
@@ -86,13 +113,6 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
items: [],
permission: "admin.accounts.view",
},
{
id: "ui.nav.admin.accounts.billing",
title: t("admin.billing.title"),
path: adminSidebarPath("accounts/billing"),
items: [],
permission: "admin.account.subscription",
},
{
id: "ui.nav.admin.accounts.rolesAndPermissions",
title: t("app.sidebar.rolesAndPermissions"),
@@ -116,6 +136,7 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
},
],
permission: "admin.accounts.view",
excludePaths: [adminSidebarPath("accounts/billing")],
},
{
id: UI_NAV_IDS.adminAudit,
@@ -124,11 +145,16 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
icon: <IconEvents />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.audit.viewer", title: t("app.sidebar.audit"), path: adminSidebarPath("audit"), permission: "admin.auditTrails.view" },
{ id: "ui.nav.admin.audit.trails", title: t("app.sidebar.auditTrails"), path: adminSidebarPath("audit-trails"), permission: "admin.auditTrails.view" },
{ id: "ui.nav.admin.audit.viewer", title: t("app.sidebar.audit"), path: adminSidebarPath("audit"), permission: "admin_identity.audit.read" },
{
id: "ui.nav.admin.audit.trails",
title: t("app.sidebar.auditTrails"),
path: adminSidebarPath("audit-trails"),
permission: "admin.auditTrails.view",
},
{ id: "ui.nav.admin.audit.events", title: t("models.event.plural"), path: adminSidebarPath("events"), permission: "admin.events.view" },
],
permission: "admin.auditTrails.view",
anyPermissions: ["admin.auditTrails.view", "admin_identity.audit.read"],
},
{
id: UI_NAV_IDS.adminNotifications,
@@ -137,9 +163,24 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
icon: <IconNotifications />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.notifications.messages", title: t("app.sidebar.messages"), path: adminSidebarPath("notifications/messages"), permission: "admin.notifications.view" },
{ id: "ui.nav.admin.notifications.channels", title: t("app.sidebar.channels"), path: adminSidebarPath("notifications/channels"), permission: "admin.notifications.view" },
{ id: "ui.nav.admin.notifications.subscribers", title: t("app.sidebar.subscribers"), path: adminSidebarPath("notifications/subscribers"), permission: "admin.notifications.view" },
{
id: "ui.nav.admin.notifications.messages",
title: t("app.sidebar.messages"),
path: adminSidebarPath("notifications/messages"),
permission: "admin.notifications.view",
},
{
id: "ui.nav.admin.notifications.channels",
title: t("app.sidebar.channels"),
path: adminSidebarPath("notifications/channels"),
permission: "admin.notifications.view",
},
{
id: "ui.nav.admin.notifications.subscribers",
title: t("app.sidebar.subscribers"),
path: adminSidebarPath("notifications/subscribers"),
permission: "admin.notifications.view",
},
],
permission: "admin.notifications.view",
},
@@ -150,33 +191,175 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
title: t("segments.platform"),
path: "",
items: [
consolidatedPlatformItem({
id: "ui.nav.admin.platform.operations",
title: t("admin.platformNavigation.operations"),
path: adminSidebarPath("system"),
icon: <IconMetrics />,
anyPermissions: [ADMIN_AREA_ACCESS.health, "admin.events.view", "admin.account.subscription"],
contextItems: [
{
id: "ui.nav.admin.health",
title: t("admin.health.title"),
path: adminSidebarPath("system"),
permission: ADMIN_AREA_ACCESS.health,
},
{
id: "ui.nav.admin.system",
title: t("admin.system.title"),
path: adminSidebarPath("system/health"),
permission: ADMIN_AREA_ACCESS.system,
},
{
id: "ui.nav.admin.deploys",
title: t("admin.deploys.title"),
path: adminSidebarPath("system/deploys"),
permission: ADMIN_AREA_ACCESS.deploys,
},
{
id: "ui.nav.admin.jobs",
title: t("admin.jobs.title"),
path: adminSidebarPath("system/jobs"),
permission: ADMIN_AREA_ACCESS.jobs,
},
{
id: "ui.nav.admin.webhooks",
title: t("admin.webhooks.title"),
path: adminSidebarPath("system/webhooks"),
permission: "admin.events.view",
},
{
id: "ui.nav.admin.billingSync",
title: t("admin.health.subsystems.billing.label"),
path: adminSidebarPath("system/billing"),
permission: "admin.account.subscription",
},
],
}),
consolidatedPlatformItem({
id: "ui.nav.admin.platform.support",
title: t("admin.platformNavigation.support"),
path: adminSidebarPath("support"),
icon: <IconEmails />,
anyPermissions: [ADMIN_AREA_ACCESS.support, "admin.metrics.view"],
contextItems: [
{
id: UI_NAV_IDS.adminHelpDesk,
title: t("admin.supportInbox.title"),
path: adminSidebarPath("support"),
permission: ADMIN_AREA_ACCESS.support,
},
{
id: "ui.nav.admin.kwpContracts",
title: t("admin.kwpContracts.title"),
path: adminSidebarPath("support/kwp-contracts"),
permission: "admin.metrics.view",
},
],
}),
{
id: UI_NAV_IDS.adminApi,
title: t("settings.api.title"),
title: t("admin.platformNavigation.apiAccess"),
path: adminSidebarPath("api"),
icon: <IconKeys />,
permission: "admin.apiKeys.view",
hidden: !appConfiguration?.app.features.tenantApiKeys,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.api.overview", title: t("shared.overview"), path: adminSidebarPath("api"), permission: "admin.apiKeys.view" },
{ id: "ui.nav.admin.api.keys", title: t("app.sidebar.apiKeys"), path: adminSidebarPath("api/keys"), permission: "admin.apiKeys.view" },
{ id: "ui.nav.admin.api.logs", title: t("app.sidebar.logs"), path: adminSidebarPath("api/logs"), permission: "admin.apiKeys.view" },
{ id: "ui.nav.admin.api.clients", title: t("admin.apiAdmin.tabs.clients"), path: adminSidebarPath("api/clients"), permission: "admin.apiKeys.view" },
{
id: "ui.nav.admin.api.inbound",
title: t("admin.apiAdmin.tabs.inbound"),
path: adminSidebarPath("api/inbound-registrations"),
permission: "admin.apiKeys.view",
},
],
},
{
id: UI_NAV_IDS.adminFeatureFlags,
title: t("app.sidebar.featureFlags"),
path: adminSidebarPath("feature-flags"),
icon: <IconFeatureFlags />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.featureFlags.flags", title: t("app.sidebar.flags"), path: adminSidebarPath("feature-flags/flags"), permission: "admin.featureFlags.view" },
{ id: "ui.nav.admin.featureFlags.settings", title: t("app.sidebar.settings"), path: adminSidebarPath("feature-flags/settings"), permission: "admin.featureFlags.view" },
],
permission: "admin.featureFlags.view",
},
],
},
{
id: UI_NAV_IDS.adminSales,
title: t("admin.sales.navigation.title"),
path: adminSidebarPath("sales/tasks/today"),
icon: <IconAnalytics />,
items: [
{
id: UI_NAV_IDS.adminSalesToday,
title: t("admin.sales.navigation.today"),
path: adminSidebarPath("sales/tasks/today"),
icon: <FeatherListTodo />,
permission: ADMIN_AREA_ACCESS.sales,
},
{
id: UI_NAV_IDS.adminPlatformLeads,
title: t("admin.sales.navigation.leads"),
path: adminSidebarPath("leads"),
icon: <FeatherTarget />,
permission: "admin_sales.crm.read",
},
{
id: UI_NAV_IDS.adminSalesDeals,
title: t("admin.sales.navigation.deals"),
path: adminSidebarPath("sales/deals"),
icon: <FeatherKanbanSquare />,
permission: "admin_sales.crm.read",
},
{
id: UI_NAV_IDS.adminSalesContacts,
title: t("admin.sales.navigation.contacts"),
path: adminSidebarPath("sales/contacts"),
icon: <FeatherUsers />,
permission: "admin_sales.crm.read",
},
{
id: UI_NAV_IDS.adminSalesCompanies,
title: t("admin.sales.navigation.companies"),
path: adminSidebarPath("sales/companies"),
icon: <FeatherBuilding2 />,
permission: "admin_sales.crm.read",
},
{
id: UI_NAV_IDS.adminSalesImportExport,
title: t("admin.sales.navigation.importExport"),
path: adminSidebarPath("sales/import-export"),
icon: <FeatherDatabase />,
permission: "admin_sales.crm.read",
},
],
anyPermissions: [ADMIN_AREA_ACCESS.sales],
},
{
id: UI_NAV_IDS.adminSalesCommunication,
title: t("admin.sales.navigation.communicationSection"),
path: adminSidebarPath("sales/email/inbox"),
items: [
{
id: UI_NAV_IDS.adminSalesEmail,
title: t("admin.sales.navigation.email"),
path: adminSidebarPath("sales/email/inbox"),
icon: <FeatherMail />,
permission: "admin_sales.email.send",
},
{
id: UI_NAV_IDS.adminSalesCalls,
title: t("admin.sales.navigation.calls"),
path: adminSidebarPath("sales/calls"),
icon: <FeatherPhone />,
permission: "admin_sales.phone.call",
},
{
id: UI_NAV_IDS.adminSalesBookings,
title: t("admin.sales.navigation.bookings"),
path: adminSidebarPath("sales/bookings"),
icon: <FeatherCalendarDays />,
permission: "admin_sales.booking.manage",
},
],
anyPermissions: ["admin_sales.email.send", "admin_sales.phone.call", "admin_sales.booking.manage"],
},
{
id: "ui.nav.admin.market",
title: t("segments.market"),
@@ -189,48 +372,49 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
icon: <IconEmails />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.emailMarketing.campaigns", title: t("app.sidebar.campaigns"), path: adminSidebarPath("email-marketing/campaigns"), permission: "admin.emails.view" },
{ id: "ui.nav.admin.emailMarketing.senders", title: t("app.sidebar.senders"), path: adminSidebarPath("email-marketing/senders"), permission: "admin.emails.view" },
{ id: "ui.nav.admin.emailMarketing.activity", title: t("app.sidebar.activity"), path: adminSidebarPath("email-marketing/activity"), permission: "admin.emails.view" },
{
id: "ui.nav.admin.emailMarketing.campaigns",
title: t("app.sidebar.campaigns"),
path: adminSidebarPath("email-marketing/campaigns"),
permission: "admin.emails.view",
},
{
id: "ui.nav.admin.emailMarketing.senders",
title: t("app.sidebar.senders"),
path: adminSidebarPath("email-marketing/senders"),
permission: "admin.emails.view",
},
{
id: "ui.nav.admin.emailMarketing.activity",
title: t("app.sidebar.activity"),
path: adminSidebarPath("email-marketing/activity"),
permission: "admin.emails.view",
},
],
permission: "admin.emails.view",
}),
{
id: UI_NAV_IDS.adminMarketing,
title: t("app.sidebar.marketing"),
path: adminSidebarPath("marketing-leads"),
path: adminSidebarPath("marketing-integrations"),
icon: <IconAnalytics />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.marketing.leads", title: t("app.sidebar.leads"), path: adminSidebarPath("marketing-leads"), permission: "admin.marketing.leads.view" },
{ id: "ui.nav.admin.marketing.funnels", title: t("app.sidebar.funnels"), path: adminSidebarPath("marketing-funnels"), permission: "admin.marketing.funnels.view" },
{ id: "ui.nav.admin.marketing.integrations", title: t("app.sidebar.integrations"), path: adminSidebarPath("marketing-integrations"), permission: "admin.marketing.integrations.view" },
{ id: "ui.nav.admin.marketing.emailSequences", title: t("app.sidebar.emailSequences"), path: adminSidebarPath("email-sequences"), permission: "admin.marketing.leads.view" },
{
id: "ui.nav.admin.marketing.integrations",
title: t("app.sidebar.integrations"),
path: adminSidebarPath("marketing-integrations"),
permission: "admin.marketing.integrations.view",
},
{
id: "ui.nav.admin.marketing.emailSequences",
title: t("app.sidebar.emailSequences"),
path: adminSidebarPath("email-sequences"),
permission: "admin.marketing.leads.view",
},
],
permission: "admin.marketing.leads.view",
},
...enabledAdminRouteItem("knowledge-base", {
id: UI_NAV_IDS.adminKnowledgeBase,
title: t("app.sidebar.knowledgeBase"),
path: adminSidebarPath("knowledge-base"),
icon: <IconDocs className="size-4" />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.knowledgeBase.bases", title: t("app.sidebar.bases"), path: adminSidebarPath("knowledge-base/bases"), permission: "admin.kb.view" },
{ id: "ui.nav.admin.knowledgeBase.articles", title: t("app.sidebar.articles"), path: adminSidebarPath("knowledge-base/articles"), permission: "admin.kb.view" },
],
permission: "admin.kb.view",
}),
...enabledAdminRouteItem("help-desk", {
id: UI_NAV_IDS.adminHelpDesk,
title: t("app.sidebar.helpDesk"),
path: adminSidebarPath("help-desk"),
icon: <IconHelpDesk className="size-4" />,
isCollapsible: true,
items: [
{ id: "ui.nav.admin.helpDesk.feedback", title: t("app.sidebar.feedback"), path: adminSidebarPath("help-desk/feedback") },
],
}),
],
},
{
@@ -244,11 +428,53 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
title: t("app.sidebar.settings"),
icon: <IconSettings />,
path: adminSidebarPath("settings"),
isCollapsible: true,
anyPermissions: [
"admin_identity.sessions.read",
"admin_identity.users.read",
"admin_identity.roles.read",
"admin.settings.general.view",
"admin.pricing.view",
"admin.settings.authentication.view",
"admin.emails.view",
"admin_sales.crm.write",
"admin_sales.crm.assign",
"admin_sales.crm.read",
"admin_sales.integrations.manage",
"admin.settings.danger.reset",
],
isCollapsible: false,
activePaths: [adminSidebarPath("settings")],
items: [
{ id: "ui.nav.admin.settings.profile", title: t("settings.admin.profile.title"), path: adminSidebarPath("settings/profile") },
{ id: "ui.nav.admin.settings.general", title: t("settings.admin.general.title"), path: adminSidebarPath("settings/general"), permission: "admin.settings.general.view" },
{ id: "ui.nav.admin.settings.pricing", title: t("settings.admin.pricing.title"), path: adminSidebarPath("settings/pricing"), permission: "admin.pricing.view" },
{
id: "ui.nav.admin.settings.profile",
title: t("admin.sales.security.title"),
path: adminSidebarPath("settings/security"),
permission: "admin_identity.sessions.read",
},
{
id: "ui.nav.admin.settings.adminUsers",
title: t("admin.sales.adminUsers.title"),
path: adminSidebarPath("settings/admin-users"),
permission: ADMIN_AREA_ACCESS.employees,
},
{
id: "ui.nav.admin.settings.adminRoles",
title: t("admin.sales.adminRoles.title"),
path: adminSidebarPath("settings/admin-roles"),
permission: ADMIN_AREA_ACCESS.roles,
},
{
id: "ui.nav.admin.settings.general",
title: t("settings.admin.general.title"),
path: adminSidebarPath("settings/general"),
permission: "admin.settings.general.view",
},
{
id: "ui.nav.admin.settings.pricing",
title: t("settings.admin.pricing.title"),
path: adminSidebarPath("settings/pricing"),
permission: "admin.pricing.view",
},
{
id: "ui.nav.admin.settings.authentication",
title: t("settings.admin.authentication.title"),
@@ -261,9 +487,30 @@ export const AdminSidebar = ({ t, appConfiguration }: Props): SideBarItem[] => [
path: adminSidebarPath("settings/transactional-emails"),
permission: "admin.emails.view",
},
{ id: "ui.nav.admin.settings.accountTypes", title: t("settings.admin.tenants.types.title"), path: adminSidebarPath("settings/accounts/types"), permission: "admin.accountTypes.view" },
{ id: "ui.nav.admin.settings.cookies", title: t("settings.admin.cookies.title"), path: adminSidebarPath("settings/cookies"), permission: "admin.settings.cookies.view" },
{ id: "ui.nav.admin.settings.cache", title: t("settings.admin.cache.title"), path: adminSidebarPath("settings/cache"), permission: "admin.settings.general.update" },
{
id: UI_NAV_IDS.adminSalesPipelineSettings,
title: t("admin.sales.navigation.pipelineSettings"),
path: adminSidebarPath("settings/pipelines"),
permission: "admin_sales.crm.write",
},
{
id: UI_NAV_IDS.adminSalesLeadSettings,
title: t("admin.sales.navigation.leadSettings"),
path: adminSidebarPath("settings/leads"),
permission: "admin_sales.crm.assign",
},
{
id: UI_NAV_IDS.adminSalesFieldsTags,
title: t("admin.sales.navigation.fieldsTags"),
path: adminSidebarPath("settings/fields-tags"),
permission: "admin_sales.crm.read",
},
{
id: UI_NAV_IDS.adminSalesTelephonySettings,
title: t("admin.sales.navigation.telephonySettings"),
path: adminSidebarPath("settings/telephony"),
permission: "admin_sales.integrations.manage",
},
],
},
{
@@ -41,6 +41,17 @@ describe("AppSidebar", () => {
"workflow-engine": { allowed: true },
"ai-credits": { allowed: true },
};
const fullProductAccess = {
...businessProductAccess,
leads: { allowed: true },
tasks: { allowed: true },
files: { allowed: true },
hr: { allowed: true },
forms: { allowed: true },
booking: { allowed: true },
integrations: { allowed: true },
chat: { allowed: true },
};
it("returns the expected static sidebar items", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
@@ -48,7 +59,9 @@ describe("AppSidebar", () => {
const result = AppSidebar({ t, i18n, tenantId: "test-user", appConfiguration: null });
const serialized = JSON.stringify(result);
const secondary = result.find((group) => group.isSecondary);
expect(result).toEqual(expect.arrayContaining([expect.objectContaining({ id: "ui.nav.app.overview", title: "" })]));
expect(result[0].items).toEqual(
expect.arrayContaining([
expect.objectContaining({
@@ -56,14 +69,9 @@ describe("AppSidebar", () => {
title: "app.sidebar.dashboard",
path: "/test-user/dashboard",
}),
expect.objectContaining({
id: UI_NAV_IDS.appNotifications,
title: "app.sidebar.notifications",
path: "/test-user/notifications",
}),
])
);
expect(result[1]).toMatchObject({
expect(secondary).toMatchObject({
title: "",
path: "",
isSecondary: true,
@@ -88,6 +96,8 @@ describe("AppSidebar", () => {
expect(serialized).not.toContain("/admin/");
expect(serialized).not.toContain("/blog");
expect(serialized).not.toContain("/pricing");
expect(serialized).not.toContain("/search");
expect(serialized).not.toContain("/notifications");
expect(serialized).not.toContain("/email-marketing");
expect(serialized).not.toContain("/workflow-engine");
expect(serialized).not.toContain("/widgets");
@@ -95,13 +105,48 @@ describe("AppSidebar", () => {
expect(serialized).not.toContain("/sites/");
});
it("groups plan-backed product links into clear app navigation sections", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const result = AppSidebar({ t, i18n, tenantId: "business", appConfiguration: null, productAccess: businessProductAccess });
expect(result).toEqual(
expect.arrayContaining([
expect.objectContaining({ id: "ui.nav.app.overview", title: "" }),
expect.objectContaining({ id: "ui.nav.app.customers", title: "app.sidebar.sections.customers" }),
expect.objectContaining({ id: "ui.nav.app.projects", title: "app.sidebar.sections.projects" }),
expect.objectContaining({ id: "ui.nav.app.communication", title: "app.sidebar.sections.communication" }),
expect.objectContaining({ id: "ui.nav.app.automationPlatform", title: "app.sidebar.sections.automationPlatform" }),
])
);
expect(result.find((group) => group.id === "ui.nav.app.overview")?.items?.map((item) => item.id)).toEqual([UI_NAV_IDS.appDashboard]);
expect(result.find((group) => group.id === "ui.nav.app.customers")?.items?.map((item) => item.id)).toEqual([UI_NAV_IDS.appCrm]);
expect(result.find((group) => group.id === "ui.nav.app.projects")?.items?.map((item) => item.id)).toEqual([
UI_NAV_IDS.appProjects,
UI_NAV_IDS.appPlantafel,
]);
expect(result.find((group) => group.id === "ui.nav.app.communication")?.items?.map((item) => item.id)).toEqual([
UI_NAV_IDS.appEmails,
UI_NAV_IDS.appEmailMarketing,
]);
expect(result.find((group) => group.id === "ui.nav.app.automationPlatform")?.items?.map((item) => item.id)).toEqual([UI_NAV_IDS.appAutomation]);
expect(result.find((group) => group.id === "ui.nav.app.apiDeveloper")).toBeUndefined();
});
it("renders plan-backed core feature links from product access decisions", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const starter = JSON.stringify(AppSidebar({ t, i18n, tenantId: "starter", appConfiguration: null, productAccess: starterProductAccess }));
const pro = JSON.stringify(AppSidebar({ t, i18n, tenantId: "pro", appConfiguration: null, productAccess: proProductAccess }));
const business = JSON.stringify(AppSidebar({ t, i18n, tenantId: "business", appConfiguration: null, productAccess: businessProductAccess }));
const starterResult = AppSidebar({ t, i18n, tenantId: "starter", appConfiguration: null, productAccess: starterProductAccess });
const proResult = AppSidebar({ t, i18n, tenantId: "pro", appConfiguration: null, productAccess: proProductAccess });
const businessResult = AppSidebar({ t, i18n, tenantId: "business", appConfiguration: null, productAccess: businessProductAccess });
const starter = JSON.stringify(starterResult);
const pro = JSON.stringify(proResult);
const business = JSON.stringify(businessResult);
const primaryPaths = (groups: ReturnType<typeof AppSidebar>) =>
groups.filter((group) => !group.isSecondary).flatMap((group) => group.items?.map((item) => item.path) ?? []);
expect(starter).toContain("/starter/contacts");
expect(starter).toContain("/starter/projects");
@@ -109,7 +154,7 @@ describe("AppSidebar", () => {
expect(starter).not.toContain("/starter/email-marketing");
expect(starter).not.toContain("/starter/emails");
expect(starter).not.toContain("/starter/automations");
expect(starter).not.toContain("/starter/settings/api");
expect(primaryPaths(starterResult)).not.toContain("/starter/api");
expect(starter).not.toContain("/starter/workflow-engine");
expect(pro).toContain("/pro/contacts");
@@ -117,15 +162,122 @@ describe("AppSidebar", () => {
expect(pro).toContain("/pro/email-marketing");
expect(pro).toContain("/pro/emails");
expect(pro).not.toContain("/pro/automations");
expect(pro).toContain("/pro/settings/api");
expect(primaryPaths(proResult)).not.toContain("/pro/api");
expect(pro).not.toContain("/pro/workflow-engine");
expect(business).toContain("/business/contacts");
expect(business).toContain("/business/projects");
expect(business).toContain("/business/email-marketing");
expect(business).toContain("/business/automations");
expect(business).toContain("/business/settings/api");
expect(business).toContain("/business/workflow-engine");
expect(primaryPaths(businessResult)).not.toContain("/business/api");
expect(business).not.toContain("/business/workflow-engine");
});
it("shows telephony only with product access and carries the read permission gate", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const withoutTelephony = AppSidebar({ t, i18n, tenantId: "acme", appConfiguration: null, productAccess: businessProductAccess });
const withTelephony = AppSidebar({
t,
i18n,
tenantId: "acme",
appConfiguration: null,
productAccess: { ...businessProductAccess, telephony: { allowed: true } },
});
expect(JSON.stringify(withoutTelephony)).not.toContain("/acme/calls");
expect(withTelephony.flatMap((group) => group.items ?? [])).toEqual(
expect.arrayContaining([
expect.objectContaining({
id: UI_NAV_IDS.appTelephony,
title: "telephony.nav.title",
path: "/acme/calls",
permission: "telephony.read_own",
}),
])
);
});
it("shows team chat only with product access and carries the member read gate", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const withoutChat = AppSidebar({ t, i18n, tenantId: "acme", appConfiguration: null, productAccess: businessProductAccess });
const withChat = AppSidebar({
t,
i18n,
tenantId: "acme",
appConfiguration: null,
productAccess: { ...businessProductAccess, chat: { allowed: true } },
});
expect(JSON.stringify(withoutChat)).not.toContain("/acme/chat");
expect(withChat.flatMap((group) => group.items ?? [])).toEqual(
expect.arrayContaining([
expect.objectContaining({
id: UI_NAV_IDS.appChat,
title: "chat.nav.title",
path: "/acme/chat",
permission: "chat.read_own_channels",
}),
])
);
});
it("keeps balanced global destinations while consolidating the appointment area", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const result = AppSidebar({ t, i18n, tenantId: "full", appConfiguration: null, productAccess: fullProductAccess });
const globalItems = result.filter((group) => !group.isSecondary).flatMap((group) => group.items ?? []);
expect(globalItems.map((item) => item.id)).toEqual([
UI_NAV_IDS.appDashboard,
"ui.nav.app.tasks",
UI_NAV_IDS.appCrm,
UI_NAV_IDS.appLeads,
UI_NAV_IDS.appProjects,
UI_NAV_IDS.appPlantafel,
"ui.nav.app.files",
UI_NAV_IDS.appEmails,
UI_NAV_IDS.appEmailMarketing,
UI_NAV_IDS.appForms,
"ui.nav.app.appointments",
UI_NAV_IDS.appChat,
"ui.nav.app.hr",
UI_NAV_IDS.appPasswordSafe,
UI_NAV_IDS.appAutomation,
]);
// WF-P8 S00: boards start page is the consolidated module entry, so the
// projects group is back to at most three entries.
expect(result.find((group) => group.id === "ui.nav.app.projects")?.items).toHaveLength(3);
expect(globalItems.find((item) => item.id === "ui.nav.app.appointments")?.contextItems).toHaveLength(3);
expect(globalItems.find((item) => item.id === UI_NAV_IDS.appPasswordSafe)).toMatchObject({
path: "/full/passwords",
anyPermissions: ["hr.passwordsafe.use", "hr.passwordsafe.admin"],
});
});
it("reaches the lead statistics through the leads sub-sidenav, not through the inbox screen", () => {
const t = vi.fn().mockImplementation((v: string) => v) as any;
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const result = AppSidebar({ t, i18n, tenantId: "acme", appConfiguration: null, productAccess: fullProductAccess });
const leads = result.flatMap((group) => group.items ?? []).find((item) => item.id === UI_NAV_IDS.appLeads);
expect(leads?.contextItems?.map((item) => item.path)).toEqual([
"/acme/leads",
"/acme/leads-statistics",
"/acme/admin/lead-sources",
"/acme/admin/lead-anti-spam",
]);
// Same permission as the inbox: everyone who sees leads sees their statistics.
expect(leads?.contextItems?.find((item) => item.id === "ui.nav.app.leads.statistics")).toMatchObject({
title: "leads.statistics.title",
permission: "leads.read_own",
});
// The statistics path must stay highlighted as part of the leads workspace —
// that is also what puts "Leads" in front of the breadcrumb.
expect(leads?.activePaths).toContain("/acme/leads-statistics");
expect(existsSync(resolveRepoPath("apps/web/app/routes/app.$tenant/leads-statistics.tsx"))).toBe(true);
});
it("keeps static tenant sidebar targets backed by registered route files", () => {
@@ -133,15 +285,16 @@ describe("AppSidebar", () => {
const i18n = { exists: vi.fn().mockReturnValue(false) } as any;
const result = AppSidebar({ t, i18n, tenantId: "acme", appConfiguration: null, productAccess: businessProductAccess });
const serialized = JSON.stringify(result);
const primaryPaths = result.filter((group) => !group.isSecondary).flatMap((group) => group.items?.map((item) => item.path) ?? []);
expect(serialized).toContain("/acme/dashboard");
expect(serialized).toContain("/acme/notifications");
expect(serialized).not.toContain("/acme/notifications");
expect(serialized).toContain("/acme/contacts");
expect(serialized).toContain("/acme/projects");
expect(serialized).toContain("/acme/automations");
expect(serialized).toContain("/acme/email-marketing");
expect(serialized).toContain("/acme/workflow-engine");
expect(serialized).toContain("/acme/settings/api");
expect(serialized).not.toContain("/acme/workflow-engine");
expect(primaryPaths).not.toContain("/acme/api");
expect(serialized).not.toContain("/acme/settings/credits");
expect(serialized).toContain("/acme/settings");
expect(serialized).toContain("/acme/settings/profile");
@@ -150,15 +303,12 @@ describe("AppSidebar", () => {
[
"apps/web/app/routes/app.$tenant/dashboard.tsx",
"apps/web/app/routes/app.$tenant/notifications.tsx",
"apps/web/app/routes/app.$tenant/contacts._index.tsx",
"apps/web/app/routes/app.$tenant/projects._index.tsx",
"apps/web/app/routes/app.$tenant/automations._index.tsx",
"apps/web/app/routes/app.$tenant/automations.$id.edit.tsx",
"apps/web/app/routes/app.$tenant/automations.templates._index.tsx",
"apps/web/app/routes/app.$tenant/email-marketing.tsx",
"apps/web/app/routes/app.$tenant/__workflows/workflow-engine.tsx",
"apps/web/app/routes/app.$tenant/settings/api/index.tsx",
"apps/web/app/routes/app.$tenant/settings.tsx",
"apps/web/app/routes/app.$tenant/settings/profile.tsx",
].forEach((routeFile) => {
@@ -4,20 +4,26 @@ import { AppConfiguration } from "~/utils/db/appConfiguration.db.server";
import IconSettings from "~/components/layouts/icons/IconSettings";
import IconDashboard from "~/components/layouts/icons/IconDashboard";
import IconAdmin from "~/components/layouts/icons/IconAdmin";
import IconNotifications from "~/components/layouts/icons/IconNotifications";
import IconEmails from "~/components/layouts/icons/IconEmails";
import IconKeys from "~/components/layouts/icons/IconKeys";
import IconWorkflows from "~/components/layouts/icons/IconWorkflows";
import AddressBookIcon from "~/components/ui/icons/crm/AddressBookIcon";
import IconDocs from "~/components/layouts/icons/IconDocs";
import ViewListIcon from "~/components/ui/icons/ViewListIcon";
import CalendarIcon from "~/components/ui/icons/CalendarIcon";
import CalendarCheckIcon from "~/components/ui/icons/CalendarCheckIcon";
import CalendarClockIcon from "~/components/ui/icons/CalendarClockIcon";
import CalendarDaysIcon from "~/components/ui/icons/CalendarDaysIcon";
import CalendarRangeIcon from "~/components/ui/icons/CalendarRangeIcon";
import InboxIcon from "~/components/ui/icons/emails/InboxIcon";
import MegaphoneIcon from "~/components/ui/icons/emails/MegaphoneIcon";
import { UI_NAV_IDS } from "~/application/ui/uiRegistry";
import { appPath } from "~/utils/app/CanonicalUrlUtils";
import { absoluteAdminPath, type PublicDomainRoutingConfig } from "~/utils/app/CrossHostUrls";
import { resolveConnectorNavState } from "~/utils/connector/connectorNavState";
import { WALKING_SKELETON_MODULE_KEY } from "~/modules/walkingSkeleton/constants";
import { SearchIcon } from "~/components/ui/icons/vendor";
import { ClipboardIcon, FileTextIcon, LockIcon, PhoneIcon, ShieldCheckIcon, TrendingUpIcon, UserIcon } from "~/components/ui/icons/vendor";
import BoardIcon from "~/components/ui/icons/BoardIcon";
import ComboChartIcon from "~/components/ui/icons/ComboChartIcon";
import DataSourceIcon from "~/components/ui/icons/DataSourceIcon";
import TableIcon from "~/components/ui/icons/TableIcon";
import ChatAltIcon from "~/components/ui/icons/ChatAltIcon";
type Props = {
t: TFunction;
@@ -36,35 +42,27 @@ export const AppSidebar = ({ t, tenantId, routing, productAccess }: Props): Side
const walkingSkeletonDecision = productAccess?.[WALKING_SKELETON_MODULE_KEY];
const walkingSkeletonState = walkingSkeletonDecision ? resolveConnectorNavState(walkingSkeletonDecision) : "hidden";
const productCoreItems: SideBarItem[] = [
...(hasFeatureAccess("search")
const overviewItems: SideBarItem[] = [
...(hasDashboardAccess
? [
{
id: UI_NAV_IDS.appSearch,
title: t("search.nav.title"),
path: tenantPath("search"),
icon: <SearchIcon />,
permission: "search.use" as const,
},
]
: []),
...(hasFeatureAccess("automation")
? [
{
id: UI_NAV_IDS.appAutomation,
title: t("automation.nav.title"),
path: tenantPath("automations"),
icon: <IconWorkflows />,
permission: "automation.read" as const,
id: UI_NAV_IDS.appDashboard,
title: t("app.sidebar.dashboard"),
path: tenantPath("dashboard"),
icon: <IconDashboard />,
permission: "dashboard.read" as const,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN, TenantUserType.MEMBER],
},
]
: []),
];
const crmContextItems: SideBarItem[] = [
...(hasFeatureAccess("crm-basic")
? [
{
id: UI_NAV_IDS.appCrm,
title: t("crm:title"),
// R-P6: typed CRM contacts replace the entity-builder CRM (/crm → /contacts).
id: "ui.nav.app.crm.contacts",
title: t("crm.contacts.title"),
path: tenantPath("contacts"),
icon: <AddressBookIcon />,
permission: "crm.read_own" as const,
@@ -77,143 +75,280 @@ export const AppSidebar = ({ t, tenantId, routing, productAccess }: Props): Side
id: UI_NAV_IDS.appLeads,
title: t("leads.nav.title"),
path: tenantPath("leads"),
icon: <ViewListIcon />,
icon: <TrendingUpIcon />,
permission: "leads.read_own" as const,
// Leads is a workspace area: inbox/board plus the two admin screens
// share an inner sub-sidenav (rendered by app.$tenant when >1 item
// is visible — non-admins only see the inbox, so no rail for them).
activePaths: [tenantPath("leads"), tenantPath("leads-statistics"), tenantPath("admin/lead-sources"), tenantPath("admin/lead-anti-spam")],
contextItems: [
{
id: "ui.nav.app.leads.inbox",
title: t("leads.list.title"),
path: tenantPath("leads"),
icon: <InboxIcon />,
permission: "leads.read_own" as const,
},
{
id: "ui.nav.app.leads.statistics",
title: t("leads.statistics.title"),
path: tenantPath("leads-statistics"),
icon: <ComboChartIcon />,
permission: "leads.read_own" as const,
},
{
id: "ui.nav.app.leads.sources",
title: t("leads.sources.title"),
path: tenantPath("admin/lead-sources"),
icon: <DataSourceIcon />,
permission: "leads.admin" as const,
},
{
id: "ui.nav.app.leads.antiSpam",
title: t("leads.antiSpam.title"),
path: tenantPath("admin/lead-anti-spam"),
icon: <ShieldCheckIcon />,
permission: "leads.admin" as const,
},
],
},
]
: []),
];
const projectContextItems: SideBarItem[] = [
...(hasFeatureAccess("projects")
? [
{
id: UI_NAV_IDS.appProjects,
title: t("projects.nav.title"),
path: tenantPath("projects"),
icon: <ViewListIcon />,
// WF-P8 S00 (Subframe 2026-07-15): the boards start page is the
// module entry; the kanban/list/detail routes under /projects keep
// this consolidated entry highlighted via activePaths.
id: "ui.nav.app.projects.boards",
title: t("projects.boards.nav"),
path: tenantPath("projects/boards"),
icon: <BoardIcon />,
permission: "projects.read_own" as const,
activePaths: [tenantPath("projects")],
// Plantafel is its own sidebar entry but lives under /projects.
excludePaths: [tenantPath("projects/plantafel")],
},
]
: []),
...(hasFeatureAccess("files")
? [
{
id: "ui.nav.app.files",
title: t("files.nav.title"),
path: tenantPath("files"),
icon: <IconDocs />,
permission: "files.read_own" as const,
},
]
: []),
...(hasFeatureAccess("tasks")
? [
{
id: "ui.nav.app.tasks",
title: t("tasks.nav.title"),
path: tenantPath("tasks"),
icon: <ViewListIcon />,
permission: "tasks.read_own" as const,
},
]
: []),
...(hasFeatureAccess("hr")
? [
{
id: "ui.nav.app.hr",
title: t("hr.nav.title"),
path: tenantPath("hr"),
icon: <AddressBookIcon />,
permission: "hr.read_own" as const,
},
]
: []),
...(hasFeatureAccess("integrations")
? [
{
id: "ui.nav.app.integrations",
title: t("integrations.nav.title"),
path: tenantPath("integrations"),
icon: <IconWorkflows />,
permission: "integrations.read" as const,
},
]
: []),
...(hasFeatureAccess("integrations")
? [
{
// AK-P16a · calendar reuses the integrations feature gate (it is an
// Apps-Engine integration); the entry is gated by calendar.connect_own.
id: UI_NAV_IDS.appCalendar,
title: t("calendar.nav.title"),
path: tenantPath("calendar"),
icon: <CalendarIcon />,
permission: "calendar.connect_own" as const,
id: UI_NAV_IDS.appPlantafel,
title: t("projects.nav.plantafel"),
path: tenantPath("projects/plantafel"),
icon: <CalendarRangeIcon />,
permission: "plantafel.read_own" as const,
},
]
: []),
];
const communicationContextItems: SideBarItem[] = [
...(hasFeatureAccess("email-inbox")
? [
{
// VA-P23 · mailbox sync inbox — own `email-inbox` feature gate; the
// entry is gated by email.read_own (own-mailbox visibility, M09 I).
id: UI_NAV_IDS.appEmails,
title: t("emailInbox.nav.title"),
path: tenantPath("emails"),
icon: <IconEmails className="h-5 w-5" />,
icon: <IconEmails />,
permission: "email.read_own" as const,
},
]
: []),
...(hasFeatureAccess("booking")
? [
{
// AK-P16b · Booking module — own `booking` feature gate; the entry is
// gated by bookings.read_own (every provider can see their own bookings).
id: UI_NAV_IDS.appBookings,
title: t("bookings.nav.title"),
path: tenantPath("bookings"),
icon: <CalendarIcon />,
permission: "bookings.read_own" as const,
},
]
: []),
...(hasFeatureAccess("forms")
? [
{
id: UI_NAV_IDS.appForms,
title: t("settings.forms.admin.title"),
path: tenantPath("forms"),
icon: <ViewListIcon />,
permission: "forms.basic" as const,
},
]
: []),
...(hasFeatureAccess("email-marketing")
? [
{
id: UI_NAV_IDS.appEmailMarketing,
title: t("emailMarketing:title"),
path: tenantPath("email-marketing"),
icon: <IconEmails />,
icon: <MegaphoneIcon />,
permission: "emailMarketing.view" as const,
},
]
: []),
...(hasFeatureAccess("workflow-engine")
...(hasFeatureAccess("forms")
? [
{
id: UI_NAV_IDS.appWorkflowEngine,
title: t("workflows.title"),
path: tenantPath("workflow-engine"),
id: UI_NAV_IDS.appForms,
title: t("settings.forms.admin.title"),
path: tenantPath("forms"),
icon: <TableIcon />,
permission: "forms.basic" as const,
},
]
: []),
...(hasFeatureAccess("telephony")
? [
{
id: UI_NAV_IDS.appTelephony,
title: t("telephony.nav.title"),
path: tenantPath("calls"),
icon: <PhoneIcon />,
permission: "telephony.read_own" as const,
},
]
: []),
];
const appointmentContextItems: SideBarItem[] = [
...(hasFeatureAccess("integrations")
? [
{
id: UI_NAV_IDS.appCalendar,
title: t("calendar.nav.title"),
path: tenantPath("calendar"),
icon: <CalendarDaysIcon />,
permission: "calendar.connect_own" as const,
},
]
: []),
...(hasFeatureAccess("booking")
? [
{
id: UI_NAV_IDS.appBookings,
title: t("bookings.nav.title"),
path: tenantPath("bookings"),
icon: <CalendarCheckIcon />,
permission: "bookings.read_own" as const,
},
{
id: UI_NAV_IDS.appAvailability,
title: t("bookings.availability.title"),
path: tenantPath("availability"),
icon: <CalendarClockIcon />,
permission: "bookings.read_own" as const,
},
]
: []),
];
const workspaceArea = ({
id,
title,
icon,
contextItems,
}: {
id: string;
title: string;
icon: SideBarItem["icon"];
contextItems: SideBarItem[];
}): SideBarItem | null => {
const firstItem = contextItems[0];
if (!firstItem) return null;
return {
id,
title,
path: firstItem.path,
icon,
activePaths: contextItems.map((item) => item.path),
contextItems,
};
};
const appointmentsArea = workspaceArea({
id: "ui.nav.app.appointments",
title: t("app.sidebar.areas.appointments"),
icon: <CalendarDaysIcon />,
contextItems: appointmentContextItems,
});
const taskItems: SideBarItem[] = [
...(hasFeatureAccess("tasks")
? [
{
id: "ui.nav.app.tasks",
title: t("tasks.nav.title"),
path: tenantPath("tasks"),
icon: <ClipboardIcon />,
permission: "tasks.read_own" as const,
},
]
: []),
];
const fileItems: SideBarItem[] = [
...(hasFeatureAccess("files")
? [
{
id: "ui.nav.app.files",
title: t("files.nav.title"),
path: tenantPath("files"),
icon: <FileTextIcon />,
permission: "files.read_own" as const,
},
]
: []),
];
const hrItems: SideBarItem[] = [
...(hasFeatureAccess("hr")
? [
{
id: UI_NAV_IDS.appHr,
title: t("hr.nav.title"),
path: tenantPath("hr"),
icon: <UserIcon />,
permission: "hr.read_own" as const,
},
]
: []),
];
const passwordSafeItems: SideBarItem[] = [
...(hasFeatureAccess("hr")
? [
{
id: UI_NAV_IDS.appPasswordSafe,
title: t("hr.passwordSafe.title"),
path: tenantPath("passwords"),
icon: <LockIcon />,
anyPermissions: ["hr.passwordsafe.use" as const, "hr.passwordsafe.admin" as const],
activePaths: [tenantPath("passwords")],
contextItems: [
{
id: "ui.nav.app.passwordSafe.vaults",
title: t("hr.passwordSafe.nav.vaults"),
path: tenantPath("passwords"),
icon: <LockIcon />,
permission: "hr.passwordsafe.use" as const,
exact: true,
},
{
id: "ui.nav.app.passwordSafe.admin",
title: t("hr.passwordSafe.nav.admin"),
path: tenantPath("passwords/admin"),
icon: <ShieldCheckIcon />,
permission: "hr.passwordsafe.admin" as const,
},
],
},
]
: []),
];
const chatItems: SideBarItem[] = [
...(hasFeatureAccess("chat")
? [
{
id: UI_NAV_IDS.appChat,
title: t("chat.nav.title"),
path: tenantPath("chat"),
icon: <ChatAltIcon />,
permission: "chat.read_own_channels" as const,
},
]
: []),
];
const automationItems: SideBarItem[] = [
...(hasFeatureAccess("automation")
? [
{
id: UI_NAV_IDS.appAutomation,
title: t("automation.nav.title"),
path: tenantPath("automations"),
icon: <IconWorkflows />,
},
]
: []),
...(hasFeatureAccess("api")
? [
{
id: UI_NAV_IDS.appApi,
title: t("models.apiKey.plural"),
path: tenantPath("settings/api"),
icon: <IconKeys />,
permission: "automation.read" as const,
},
]
: []),
@@ -230,70 +365,81 @@ export const AppSidebar = ({ t, tenantId, routing, productAccess }: Props): Side
: []),
];
const appItem: SideBarItem = {
id: "ui.nav.app.primary",
const startItems = [...overviewItems, ...taskItems];
const customerItems = crmContextItems.map((item, index) => (index === 0 ? { ...item, id: UI_NAV_IDS.appCrm, title: t("crm:title") } : item));
const projectItems = [...projectContextItems.map((item, index) => (index === 0 ? { ...item, id: UI_NAV_IDS.appProjects } : item)), ...fileItems];
const organizationItems = [...(appointmentsArea ? [appointmentsArea] : []), ...chatItems, ...hrItems, ...passwordSafeItems];
const navigationGroups: SideBarItem[] = [
{
id: "ui.nav.app.overview",
title: "",
path: "",
items: startItems,
},
{
id: "ui.nav.app.customers",
title: t("app.sidebar.sections.customers"),
path: "",
items: customerItems,
},
{
id: "ui.nav.app.projects",
title: t("app.sidebar.sections.projects"),
path: "",
items: projectItems,
},
{
id: "ui.nav.app.communication",
title: t("app.sidebar.sections.communication"),
path: "",
items: communicationContextItems,
},
{
id: "ui.nav.app.organization",
title: t("app.sidebar.sections.organization"),
path: "",
items: organizationItems,
},
{
id: "ui.nav.app.automationPlatform",
title: t("app.sidebar.sections.automationPlatform"),
path: "",
items: automationItems,
},
].filter((group) => (group.items?.length ?? 0) > 0);
const secondaryItem: SideBarItem = {
id: "ui.nav.app.secondary",
title: "",
path: "",
isSecondary: true,
items: [
...(hasDashboardAccess
? [
{
id: UI_NAV_IDS.appDashboard,
title: t("app.sidebar.dashboard"),
path: tenantPath("dashboard"),
icon: <IconDashboard />,
permission: "dashboard.read" as const,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN, TenantUserType.MEMBER],
},
]
: []),
{
id: UI_NAV_IDS.appNotifications,
title: t("app.sidebar.notifications"),
path: tenantPath("notifications"),
icon: <IconNotifications />,
id: UI_NAV_IDS.appSettings,
title: t("app.sidebar.settings"),
icon: <IconSettings />,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN],
path: tenantPath("settings"),
redirectTo: tenantPath("settings/profile"),
},
...productCoreItems,
// {
// title: t("models.email.plural"),
// path: `${currentTenantUrl}/emails`,
// icon: SvgIcon.EMAILS,
// title: t("app.sidebar.logs"),
// icon: SvgIcon.LOGS,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN],
// path: `${currentTenantUrl}/logs`,
// },
{
id: UI_NAV_IDS.appSwitchToAdmin,
title: t("admin.switchToAdmin"),
path: absoluteAdminPath(routing, "dashboard"),
icon: <IconAdmin />,
adminOnly: true,
},
],
};
return [
appItem,
{
id: "ui.nav.app.secondary",
title: "",
path: "",
isSecondary: true,
items: [
{
id: UI_NAV_IDS.appSettings,
title: t("app.sidebar.settings"),
icon: <IconSettings />,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN],
path: tenantPath("settings"),
redirectTo: tenantPath("settings/profile"),
},
// {
// title: t("app.sidebar.logs"),
// icon: SvgIcon.LOGS,
// tenantUserTypes: [TenantUserType.OWNER, TenantUserType.ADMIN],
// path: `${currentTenantUrl}/logs`,
// },
{
id: UI_NAV_IDS.appSwitchToAdmin,
title: t("admin.switchToAdmin"),
path: absoluteAdminPath(routing, "dashboard"),
icon: <IconAdmin />,
adminOnly: true,
},
],
},
];
return [...navigationGroups, secondaryItem];
};
// function SideText({ text }: { text: string }) {
@@ -1,5 +1,5 @@
import { SideBarItem } from "./SidebarItem";
import { t as i18nT } from "i18next";
import { requestScopedT as i18nT } from "~/locale/request-scoped-t";
import { UI_ID_PATTERNS, UI_NAV_IDS, uiIdSegment } from "~/application/ui/uiRegistry";
function withDocsSidebarIds(items: SideBarItem[], seenIds = new Map<string, number>()): SideBarItem[] {
@@ -274,26 +274,6 @@ export const DocsSidebar = (): SideBarItem[] => {
title: i18nT("docs.sidebar.supportLanguageI18n"),
path: "/docs/learning-center/guides/localization/support-a-language",
},
{
title: i18nT("docs.sidebar.createCustomEntity"),
path: "/docs/learning-center/guides/entities/create-a-custom-entity",
},
{
title: i18nT("docs.sidebar.useCustomEntityApi"),
path: "/docs/learning-center/guides/entities/use-the-custom-entity-api",
},
{
title: i18nT("docs.sidebar.sharedEntityRows"),
path: "/docs/learning-center/guides/entities/shared-entity-rows",
},
{
title: i18nT("docs.sidebar.planEntityLimits"),
path: "/docs/learning-center/guides/entities/plan-entity-limits",
},
{
title: i18nT("docs.sidebar.extendExistingModels"),
path: "/docs/learning-center/guides/entities/extend-existing-models",
},
{
title: i18nT("docs.sidebar.singleSignOn"),
path: "/docs/learning-center/guides/sso/",
@@ -47,6 +47,14 @@ describe("sidebar UI IDs", () => {
expectStaticItemsHaveIds(sidebar);
expect(ids).toContain(UI_NAV_IDS.adminDashboard);
expect(ids).toContain(UI_NAV_IDS.adminSettings);
expect(ids).toContain(UI_NAV_IDS.adminSalesCommunication);
expect(ids).toContain(UI_NAV_IDS.adminSalesLeadSettings);
expect(ids).toContain(UI_NAV_IDS.adminSalesToday);
expect(ids).toContain(UI_NAV_IDS.adminSalesEmail);
expect(ids).toContain(UI_NAV_IDS.adminSalesContacts);
expect(ids).toContain(UI_NAV_IDS.adminSalesCompanies);
expect(ids).toContain(UI_NAV_IDS.adminSalesFieldsTags);
expect(ids).toContain(UI_NAV_IDS.adminSalesImportExport);
});
it("assigns unique IDs to app sidebar static items", () => {
@@ -14,7 +14,15 @@ export interface SideBarItem {
adminOnly?: boolean;
tenantUserTypes?: TenantUserType[];
permission?: DefaultPermission;
/** Item is visible when at least one permission is granted. */
anyPermissions?: DefaultPermission[];
items?: SideBarItem[];
/** Alternate route roots that keep a consolidated navigation entry active. */
activePaths?: string[];
/** Route roots that must NOT activate this entry (sibling entries' subroutes under a broad activePaths prefix). */
excludePaths?: string[];
/** Links shown inside the workspace area instead of permanently in the global sidebar. */
contextItems?: SideBarItem[];
side?: ReactNode;
exact?: boolean;
redirectTo?: string;