How nurulislam17/fin_admin works
This is a React frontend for an office-management dashboard: users sign in, enter protected dashboard routes, and manage users, customers, roles, permissions, and profiles. Pages call service modules, which use a shared Axios client to communicate with an API server; authentication state is held in context and persisted in local storage. The README describes only a Vite template, so product capabilities are inferred from the source tree and sampled references. Some links to unsampled pages and services are therefore omitted.
Main entry points: AppRoutes.jsx Route table · api.js HTTP client · UserList.jsx Office users · AuthContext.jsx Auth context
Components 27
Application shell
- React app
src/App.jsx - Route table
src/routes/AppRoutes.jsx - Dashboard layout
src/components/layout/DashboardLayout.jsx
Identity and access
- Protected route
src/components/auth/ProtectedRoute.jsx - Auth context
src/context/AuthContext.jsx - Auth hook
src/hooks/useAuth.js - Login page
src/pages/auth/Login.jsx - Profile page
src/pages/profile/ProfileView.jsx
Office operations
- Dashboard
src/pages/dashboard/Dashboard.jsx - Customer list
src/pages/customers/CustomerList.jsx - Customer form
src/components/customer/AddModal.jsx - Account list
src/pages/accounts/AccountList.jsx - Office users
src/pages/user/UserList.jsx - User editor
src/components/user/OfficeUserAdd.jsx - User details
src/components/user/OfficeUserDetailsModal.jsx
Administration
- Roles page
src/pages/roles/Roles.jsx - Permissions page
src/pages/permissions/Permissions.jsx - Role permissions
src/pages/permissions/ManageRoles.jsx
API services
- Auth service
src/services/authService.js - User service
src/services/userService.js - Customer service
src/services/customerService.js - Role service
src/services/roleService.js - Permission service
src/services/permissionService.js - Activity service
src/services/activitylogService.js - HTTP client
src/services/api.js
Other components
- Dashboard user
- API server
Connections 37
- Dashboard user → React app: opens
- React app → Route table: renders
src/App.jsx - React app → Auth context: provides auth
src/App.jsx - Route table → Login page: routes to
src/routes/AppRoutes.jsx - Route table → Protected route: guards routes
src/routes/AppRoutes.jsx - Route table → Dashboard layout: wraps pages
src/routes/AppRoutes.jsx - Route table → Dashboard: routes to
src/routes/AppRoutes.jsx - Route table → Roles page: routes to
src/routes/AppRoutes.jsx - Route table → Permissions page: routes to
src/routes/AppRoutes.jsx - Route table → Role permissions: routes to
src/routes/AppRoutes.jsx - Route table → Office users: routes to
src/routes/AppRoutes.jsx - Route table → Profile page: routes to
src/routes/AppRoutes.jsx - Route table → Customer list: routes to
src/routes/AppRoutes.jsx - Route table → Account list: routes to
src/routes/AppRoutes.jsx - Protected route → Auth hook: reads auth
src/components/auth/ProtectedRoute.jsx - Auth hook → Auth context: reads context
src/hooks/useAuth.js - Login page → Auth hook: uses auth
src/pages/auth/Login.jsx - Auth context → Auth service: requests login
src/context/AuthContext.jsx - Profile page → Auth context: reads profile state
src/pages/profile/ProfileView.jsx - Dashboard → Activity service: loads activity
src/pages/dashboard/Dashboard.jsx - Customer list → Customer form: renders form
src/pages/customers/CustomerList.jsx - Customer list → Customer service: loads customers
src/pages/customers/CustomerList.jsx - Customer form → Customer service: creates customer
src/components/customer/AddModal.jsx - Office users → User service: manages users
src/pages/user/UserList.jsx - Office users → Role service: loads roles
src/pages/user/UserList.jsx - Office users → User editor: renders editor
src/pages/user/UserList.jsx - Office users → User details: renders details
src/pages/user/UserList.jsx - User editor → User service: creates user
src/components/user/OfficeUserAdd.jsx - Role permissions → Role service: loads roles
src/pages/permissions/ManageRoles.jsx - Role permissions → Permission service: loads and saves grants
src/pages/permissions/ManageRoles.jsx - Auth service → HTTP client: sends requests
src/services/authService.js - User service → HTTP client: sends requests
src/services/userService.js - Customer service → HTTP client: sends requests
src/services/customerService.js - Role service → HTTP client: sends requests
src/services/roleService.js - Permission service → HTTP client: sends requests
src/services/permissionService.js - Activity service → HTTP client: sends requests
src/services/activitylogService.js - HTTP client → API server: HTTP requests
src/services/api.js