How kunzzgroups/aiosnova works
AIOS Auth Frontend is a React application for sign-in, session management, and core identity administration, with mock APIs used for frontend development. The main workflow is browser navigation through guest/protected routes, authentication and optional MFA, then authenticated identity management through API services. Session state and shared request handling form the internal layer. The README documents mock OAuth, password recovery, and the token/cookie model; some routes and pages are represented at their existing source paths because their implementation was not sampled.
Main entry points: main.tsx App bootstrap · authService.ts Auth service · router.tsx Route dispatch · AppShell.tsx App shell
Components 17
Application entry
- App bootstrap
src/main.tsx - Route dispatch
src/routes/router.tsx - App shell
src/layouts/AppShell.tsx - Navigation sidebar
src/components/navigation/Sidebar.tsx
Authentication
- Auth pages
src/modules/core/auth/pages - Auth service
src/modules/core/auth/services/authService.ts - Session hook
src/modules/core/auth/hooks/useSession.ts
Identity administration
- Identity pages
src/modules/core/identity/pages - Identity service
src/modules/core/identity/services/identityService.ts
Shared application services
- Auth state
src/stores/authStore.ts - HTTP client
src/services/httpClient.ts - Company state
src/stores/companyStore.ts - Language preference
src/stores/localeStore.ts - Theme preference
src/stores/themeStore.ts - Toast notifications
src/components/ui/Toast.tsx
Other components
- User browser
- Mock API
Connections 22
- User browser → App bootstrap: opens app
src/main.tsx - App bootstrap → Auth service: hydrates session
src/main.tsx - App bootstrap → Route dispatch: renders app
- Route dispatch → Auth pages: routes auth
src/routes/router.tsx - Route dispatch → App shell: routes protected
src/routes/router.tsx - App shell → Navigation sidebar: renders navigation
src/layouts/AppShell.tsx - Route dispatch → Identity pages: routes identity
src/routes/router.tsx - Auth pages → Auth service: invokes auth
src/modules/core/auth/pages/OAuthCallbackPage.tsx - Auth service → HTTP client: sends requests
src/modules/core/auth/services/authService.ts - Auth service → Auth state: updates session
src/modules/core/auth/services/authService.ts - HTTP client → Auth state: refreshes session
src/services/httpClient.ts - HTTP client → Mock API: requests API
- Session hook → Auth state: reads session
src/modules/core/auth/hooks/useSession.ts - Navigation sidebar → Auth service: logs out
src/components/navigation/Sidebar.tsx - Navigation sidebar → Identity service: loads companies
src/components/navigation/Sidebar.tsx - Identity pages → Identity service: manages records
src/modules/core/identity/pages/UserDetailPage.tsx - Identity service → HTTP client: sends requests
src/modules/core/identity/services/identityService.ts - Navigation sidebar → Company state: reads and updates
src/components/navigation/Sidebar.tsx - App shell → Theme preference: shows theme control
src/layouts/AppShell.tsx - App shell → Language preference: shows language control
src/layouts/AppShell.tsx - App bootstrap → Theme preference: applies theme
src/main.tsx - App bootstrap → Toast notifications: renders notifications