Frontend Structure
Current Stack
- the active frontend target is
web, running onvite+react-router-dom web_pro_backuppreserves the previous frontend backupold_webremains in-repo as a feature-behavior reference after the reset- UI shell and page primitives use native
antd,@ant-design/icons, and the custom soha layout/theme system - Tailwind CSS 4 is kept as a utility layer for layout and spacing
web/src/styles/globals.cssdefines shared soha shell/page styling under the Vite app shell- route-driven pages consume TanStack Query server state and Zustand preference or scope state
web/src/
App.tsx
main.tsx
layouts/
app-layout.tsx
routes/
index.tsx
meta.ts
features/
access/
access-pages.tsx
auth/
auth-api.ts
login-page.tsx
oidc-callback-page.tsx
copilot/
chat-page.tsx
delivery/
delivery-pages.tsx
docs/
docs-page.tsx
observability/
monitoring-pages.tsx
platform/
cluster-detail-page.tsx
clusters-page.tsx
extensions-pages.tsx
network-storage-pages.tsx
overview-page.tsx
workloads-pages.tsx
settings/
settings-pages.tsx
system/
system-pages.tsx
services/
api-client.ts
stores/
auth-store.ts
platform-scope-store.ts
preferences-store.ts
styles/
globals.css
components/
admin-table.tsx
page-header.tsx
platform-scope-toolbar.tsx
stat-grid.tsx
status-tag.tsx
types/
index.ts
utils/
table-columns.ts
time.ts
theme/
app-theme.ts
vite-env.d.tsFrontend Rules
web/src/routes/index.tsxis the active route surface for the Vite shellweb/src/layouts/app-layout.tsxowns the shared console shell, sidebar, header, breadcrumb, and theme-aware chrome- page entry modules should stay thin and delegate business logic to
web/src/features/** web_pro_backupandold_webare both reference-only and must not be treated as active shell structure- HTTP access goes through soha auth helpers and same-origin
/api/v1 - persisted client state lives under
web/src/stores;preferences-store.tspersists theme and sidebar preferences, while server state stays in TanStack Query components/contains shared antd primitives and heavier reusable widgetsutils/time.tscentralizes table-friendly date and relative-time formattingutils/table-columns.tscentralizes common table-column width and alignment presetshooks/is still intentionally absent today; only add it when reuse is concrete- when adding a new active page, update
web/src/routes/index.tsxandweb/src/routes/meta.tstogether - page code consumes aggregated DTOs only
Last updated on