Replace the ad-hoc "workspace" abstraction with a focused, URL-driven
"sidebar view" registry that implements the modern Vercel / Cloudflare
drill-in pattern: clicking a top-level entry (e.g. System Settings)
swaps the sidebar to a contextual workspace, with a `← Back to
Dashboard` affordance, instead of stacking sub-navigation in the root.
Architecture
------------
- types.ts
+ SidebarView — declarative nested view config
(id, pathPattern, parent, getNavGroups)
+ SidebarViewParent — back-navigation descriptor
+ ResolvedSidebarView — { key, view, navGroups } returned by hook
+ SidebarData — slimmed to { navGroups } only
- Workspace — removed (logo/plan never rendered)
- lib/sidebar-view-registry.ts (new, replaces workspace-registry.ts)
+ SIDEBAR_VIEWS array — single source of truth for nested views
+ resolveSidebarView(pathname)
+ getNavGroupsForPath(pathname, t) — back-compat helper for the
command palette
- config/system-settings.config.ts
Refactored to export a single SYSTEM_SETTINGS_VIEW (SidebarView)
with parent `/dashboard/overview` + label `Back to Dashboard`.
- components/sidebar-view-header.tsx (new)
Renders only the back affordance (chevron + label). Uses the
default SidebarMenuButton size so its typography matches the
nav items below; collapses gracefully into icon mode via the
existing tooltip behavior. The redundant "title + icon" row was
removed — workspace context is already carried by the nav groups.
- hooks/use-sidebar-view.ts (new)
Encapsulates view resolution and root-nav filtering:
· matched view → returns its nav groups verbatim (route-level
beforeLoad guards already enforce access);
· no match → returns root nav groups, narrowed by user
role (admin gate) and useSidebarConfig
(admin × user sidebar_modules overlay).
- components/app-sidebar.tsx
Now a thin presentation layer: reads { key, view, navGroups }
from useSidebarView() and orchestrates the view transition via
AnimatePresence + MOTION_VARIANTS.sidebarSlide (respects
prefers-reduced-motion). No logic, no role checks, no path
matching — those live in the hook.
- components/command-menu.tsx
Switched to the new getNavGroupsForPath() API; behavior preserved.
Cleanup
-------
- Deleted layout/context/workspace-context.tsx (zero consumers).
- Deleted layout/lib/workspace-registry.ts and its
workspace-registry.example.ts companion (over-abstracted: name/id
metadata, isInWorkspace / getAllWorkspaces / WORKSPACE_IDS were
registered but never read).
- Removed `workspaces` field from useSidebarData (never consumed
after the top-switcher was dropped).
- Dropped WorkspaceProvider from authenticated-layout.tsx.
- Trimmed dead `Manage and configure` translation key from all six
locale files and from static-keys.ts.
i18n
----
Added the `Back to Dashboard` key to en, zh, fr, ja, ru, vi, and
registered it in static-keys.ts under "Sidebar views".
Verification
------------
- bun run typecheck: passes
- Lint: no new warnings/errors on the touched files
- Adding a new drill-in workspace now only requires registering a
SidebarView in SIDEBAR_VIEWS — no changes to AppSidebar required.
315 lines
10 KiB
TypeScript
Vendored
315 lines
10 KiB
TypeScript
Vendored
/*
|
|
Copyright (C) 2023-2026 QuantumNous
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
For commercial licensing, please contact support@quantumnous.com
|
|
*/
|
|
import { useState, useCallback, useMemo, lazy, Suspense } from 'react'
|
|
import { getRouteApi, useNavigate } from '@tanstack/react-router'
|
|
import { useTranslation } from 'react-i18next'
|
|
import { useAuthStore } from '@/stores/auth-store'
|
|
import { ROLE } from '@/lib/roles'
|
|
import { Skeleton } from '@/components/ui/skeleton'
|
|
import { Tabs, TabsList, TabsTrigger } from '@/components/ui/tabs'
|
|
import { SectionPageLayout } from '@/components/layout'
|
|
import { FadeIn } from '@/components/page-transition'
|
|
import { ModelsChartPreferences } from './components/models/models-chart-preferences'
|
|
import { ModelsFilter } from './components/models/models-filter-dialog'
|
|
import { OverviewDashboard } from './components/overview/overview-dashboard'
|
|
import { DEFAULT_TIME_GRANULARITY } from './constants'
|
|
import {
|
|
buildDefaultDashboardFilters,
|
|
getSavedChartPreferences,
|
|
saveChartPreferences,
|
|
} from './lib'
|
|
import {
|
|
type DashboardSectionId,
|
|
DASHBOARD_DEFAULT_SECTION,
|
|
DASHBOARD_SECTION_IDS,
|
|
} from './section-registry'
|
|
import {
|
|
type DashboardChartPreferences,
|
|
type DashboardFilters,
|
|
type QuotaDataItem,
|
|
} from './types'
|
|
|
|
const route = getRouteApi('/_authenticated/dashboard/$section')
|
|
|
|
const LazyLogStatCards = lazy(() =>
|
|
import('./components/models/log-stat-cards').then((m) => ({
|
|
default: m.LogStatCards,
|
|
}))
|
|
)
|
|
|
|
const LazyModelCharts = lazy(() =>
|
|
import('./components/models/model-charts').then((m) => ({
|
|
default: m.ModelCharts,
|
|
}))
|
|
)
|
|
|
|
const LazyConsumptionDistributionChart = lazy(() =>
|
|
import('./components/models/consumption-distribution-chart').then((m) => ({
|
|
default: m.ConsumptionDistributionChart,
|
|
}))
|
|
)
|
|
|
|
const LazyPerformanceOverview = lazy(() =>
|
|
import('./components/models/performance-overview').then((m) => ({
|
|
default: m.PerformanceOverview,
|
|
}))
|
|
)
|
|
|
|
const LazyUserCharts = lazy(() =>
|
|
import('./components/users/user-charts').then((m) => ({
|
|
default: m.UserCharts,
|
|
}))
|
|
)
|
|
|
|
function LogStatCardsFallback() {
|
|
return (
|
|
<div className='overflow-hidden rounded-lg border'>
|
|
<div className='divide-border/60 grid grid-cols-2 divide-x sm:grid-cols-3 lg:grid-cols-5'>
|
|
{Array.from({ length: 5 }).map((_, i) => (
|
|
<div key={i} className='px-4 py-3.5 sm:px-5 sm:py-4'>
|
|
<Skeleton className='h-3.5 w-16' />
|
|
<Skeleton className='mt-2 h-7 w-20' />
|
|
<Skeleton className='mt-1.5 h-3.5 w-28' />
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|
|
|
|
function ModelChartsFallback() {
|
|
return (
|
|
<div className='overflow-hidden rounded-lg border'>
|
|
<div className='flex items-center justify-between border-b px-4 py-3 sm:px-5'>
|
|
<Skeleton className='h-5 w-32' />
|
|
<Skeleton className='h-8 w-72' />
|
|
</div>
|
|
<div className='h-96 p-2'>
|
|
<Skeleton className='h-full w-full' />
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|
|
|
|
function PerformanceOverviewFallback() {
|
|
return (
|
|
<div className='overflow-hidden rounded-lg border'>
|
|
<div className='flex flex-wrap items-center gap-x-6 gap-y-2 px-4 py-3 sm:px-5'>
|
|
<div className='flex items-center gap-2'>
|
|
<Skeleton className='h-4 w-24' />
|
|
</div>
|
|
{Array.from({ length: 3 }).map((_, i) => (
|
|
<div key={i} className='flex items-center gap-1.5'>
|
|
<Skeleton className='h-3 w-14' />
|
|
<Skeleton className='h-4 w-16' />
|
|
</div>
|
|
))}
|
|
<div className='ml-auto flex items-center gap-2'>
|
|
{Array.from({ length: 2 }).map((_, i) => (
|
|
<Skeleton key={i} className='h-5 w-28 rounded-full' />
|
|
))}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|
|
|
|
const SECTION_META: Record<
|
|
DashboardSectionId,
|
|
{ titleKey: string; descriptionKey: string }
|
|
> = {
|
|
overview: {
|
|
titleKey: 'Overview',
|
|
descriptionKey: 'View dashboard overview and statistics',
|
|
},
|
|
models: {
|
|
titleKey: 'Model Call Analytics',
|
|
descriptionKey: 'View model call count analytics and charts',
|
|
},
|
|
users: {
|
|
titleKey: 'User Analytics',
|
|
descriptionKey: 'View user consumption statistics and charts',
|
|
},
|
|
}
|
|
|
|
export function Dashboard() {
|
|
const { t } = useTranslation()
|
|
const navigate = useNavigate()
|
|
const params = route.useParams()
|
|
const userRole = useAuthStore((state) => state.auth.user?.role)
|
|
const activeSection = (params.section ??
|
|
DASHBOARD_DEFAULT_SECTION) as DashboardSectionId
|
|
|
|
const [modelData, setModelData] = useState<QuotaDataItem[]>([])
|
|
const [dataLoading, setDataLoading] = useState(false)
|
|
const [chartPreferences, setChartPreferences] =
|
|
useState<DashboardChartPreferences>(() => getSavedChartPreferences())
|
|
const [modelFilters, setModelFilters] = useState<DashboardFilters>(() =>
|
|
buildDefaultDashboardFilters(getSavedChartPreferences())
|
|
)
|
|
|
|
const handleFilterChange = useCallback((filters: DashboardFilters) => {
|
|
setModelFilters(filters)
|
|
}, [])
|
|
|
|
const handleResetFilters = useCallback(() => {
|
|
setModelFilters(buildDefaultDashboardFilters(chartPreferences))
|
|
}, [chartPreferences])
|
|
|
|
const handleDataUpdate = useCallback(
|
|
(data: QuotaDataItem[], loading: boolean) => {
|
|
setModelData(data)
|
|
setDataLoading(loading)
|
|
},
|
|
[]
|
|
)
|
|
|
|
const handleChartPreferencesChange = useCallback(
|
|
(preferences: DashboardChartPreferences) => {
|
|
setChartPreferences(preferences)
|
|
setModelFilters(buildDefaultDashboardFilters(preferences))
|
|
saveChartPreferences(preferences)
|
|
},
|
|
[]
|
|
)
|
|
|
|
const meta = SECTION_META[activeSection] ?? SECTION_META.overview
|
|
const isAdmin = Boolean(userRole && userRole >= ROLE.ADMIN)
|
|
const visibleSections = useMemo(
|
|
() =>
|
|
DASHBOARD_SECTION_IDS.filter(
|
|
(section) => section !== 'overview' && (section !== 'users' || isAdmin)
|
|
),
|
|
[isAdmin]
|
|
)
|
|
const handleSectionChange = useCallback(
|
|
(section: string) => {
|
|
void navigate({
|
|
to: '/dashboard/$section',
|
|
params: { section: section as DashboardSectionId },
|
|
})
|
|
},
|
|
[navigate]
|
|
)
|
|
const showSectionTabs =
|
|
activeSection !== 'overview' && visibleSections.length > 1
|
|
const modelActions =
|
|
activeSection === 'models' ? (
|
|
<>
|
|
<ModelsChartPreferences
|
|
preferences={chartPreferences}
|
|
onPreferencesChange={handleChartPreferencesChange}
|
|
/>
|
|
<ModelsFilter
|
|
preferences={chartPreferences}
|
|
onFilterChange={handleFilterChange}
|
|
onReset={handleResetFilters}
|
|
/>
|
|
</>
|
|
) : null
|
|
|
|
return (
|
|
<SectionPageLayout>
|
|
<SectionPageLayout.Title>{t(meta.titleKey)}</SectionPageLayout.Title>
|
|
<SectionPageLayout.Description>
|
|
{t(meta.descriptionKey)}
|
|
</SectionPageLayout.Description>
|
|
<SectionPageLayout.Content>
|
|
<div className='space-y-3 sm:space-y-4'>
|
|
{activeSection !== 'overview' && (
|
|
<div className='flex flex-wrap items-center justify-between gap-1.5 sm:gap-2'>
|
|
{showSectionTabs ? (
|
|
<Tabs value={activeSection} onValueChange={handleSectionChange}>
|
|
<TabsList className='max-w-full flex-wrap justify-start group-data-horizontal/tabs:h-auto'>
|
|
{visibleSections.map((section) => (
|
|
<TabsTrigger key={section} value={section}>
|
|
{t(SECTION_META[section].titleKey)}
|
|
</TabsTrigger>
|
|
))}
|
|
</TabsList>
|
|
</Tabs>
|
|
) : (
|
|
<div />
|
|
)}
|
|
{modelActions != null && (
|
|
<div className='flex shrink-0 flex-wrap items-center gap-1.5 sm:gap-2'>
|
|
{modelActions}
|
|
</div>
|
|
)}
|
|
</div>
|
|
)}
|
|
{activeSection === 'overview' && <OverviewDashboard />}
|
|
{activeSection === 'models' && (
|
|
<>
|
|
<FadeIn>
|
|
<Suspense fallback={<LogStatCardsFallback />}>
|
|
<LazyLogStatCards
|
|
filters={modelFilters}
|
|
onDataUpdate={handleDataUpdate}
|
|
/>
|
|
</Suspense>
|
|
</FadeIn>
|
|
{isAdmin && (
|
|
<FadeIn delay={0.05}>
|
|
<Suspense fallback={<PerformanceOverviewFallback />}>
|
|
<LazyPerformanceOverview />
|
|
</Suspense>
|
|
</FadeIn>
|
|
)}
|
|
<FadeIn delay={0.1}>
|
|
<Suspense fallback={<ModelChartsFallback />}>
|
|
<LazyConsumptionDistributionChart
|
|
data={modelData}
|
|
loading={dataLoading}
|
|
defaultChartType={
|
|
chartPreferences.consumptionDistributionChart
|
|
}
|
|
timeGranularity={
|
|
modelFilters.time_granularity || DEFAULT_TIME_GRANULARITY
|
|
}
|
|
/>
|
|
</Suspense>
|
|
</FadeIn>
|
|
<FadeIn delay={0.15}>
|
|
<Suspense fallback={<ModelChartsFallback />}>
|
|
<LazyModelCharts
|
|
data={modelData}
|
|
loading={dataLoading}
|
|
defaultChartTab={chartPreferences.modelAnalyticsChart}
|
|
timeGranularity={
|
|
modelFilters.time_granularity || DEFAULT_TIME_GRANULARITY
|
|
}
|
|
/>
|
|
</Suspense>
|
|
</FadeIn>
|
|
</>
|
|
)}
|
|
{activeSection === 'users' && (
|
|
<FadeIn>
|
|
<Suspense fallback={<ModelChartsFallback />}>
|
|
<LazyUserCharts />
|
|
</Suspense>
|
|
</FadeIn>
|
|
)}
|
|
</div>
|
|
</SectionPageLayout.Content>
|
|
</SectionPageLayout>
|
|
)
|
|
}
|