How saadshahz/fyp works
This is a role-based maintenance-services marketplace/ERP for consumers, service providers, and administrators. The intended consumer flow covers equipment and inventory management, service requests, provider quotes, contracts, and invoices; providers manage requests, clients, and billing, while administrators oversee users, reports, and support. Sampled imports confirm the dashboard shell, authentication, chatbot, and selected page-to-component links. Many domain pages are present in the tree but were not sampled, so their internal connections are not inferred.
Main entry points: DashboardLayout.jsx Dashboard shell · useAuth.js Authentication · dashboard.js Consumer dashboard · index.js Inventory management
Components 26
Application Shell
- Authentication
src/hooks/useAuth.js - Dashboard shell
src/layouts/DashboardLayout.jsx - Navigation
src/components/Sidebar.jsx - User navigation
src/components/Navbar.jsx - Help chatbot
src/chatbot/ChatbotWidget.jsx - Shared UI components
src/components/ui - User data
src/data/users.js
Consumer Services
- Consumer dashboard
src/pages/consumer/dashboard.js - Inventory management
src/pages/consumer/inventory/index.js - Inventory forms
src/components/inventory/InventoryModals.jsx - Service marketplace
src/pages/consumer/marketplace.js - Service requests
src/pages/consumer/service-requests/index.js - Request details
src/pages/consumer/service-requests/[id].js - Contracts
src/pages/consumer/contracts.js - Consumer invoices
src/pages/consumer/invoices.js - Consumer reports
src/pages/consumer/reports.js
Provider Operations
- Provider requests
src/pages/provider/requests/index.js - Request fulfillment
src/pages/provider/requests/[id].js - Client management
src/pages/provider/clients.js - Client details
src/components/clients/ClientDetailModal.jsx - Invoice generation
src/pages/provider/generate-invoice.js
Administration
- Admin dashboard
src/pages/admin/dashboard.js - User administration
src/pages/admin/providers.js - Support tickets
src/pages/admin/support-tickets.js - Report data
src/data/reports.js
Other components
- Platform user
Connections 26
- Platform user → Authentication: signs in
src/hooks/useAuth.js - Authentication → Dashboard shell: guards access
src/layouts/DashboardLayout.jsx - Authentication → User data: checks accounts
src/hooks/useAuth.js - Dashboard shell → Navigation: renders
src/layouts/DashboardLayout.jsx - Dashboard shell → User navigation: renders
src/layouts/DashboardLayout.jsx - Dashboard shell → Help chatbot: renders
src/layouts/DashboardLayout.jsx - Platform user → Consumer dashboard: uses
- Consumer dashboard → Dashboard shell: renders in
src/pages/consumer/dashboard.js - Consumer dashboard → Inventory management: links to
- Inventory management → Dashboard shell: renders in
src/pages/consumer/inventory/index.js - Inventory management → Inventory forms: uses forms
src/pages/consumer/inventory/index.js - Platform user → Service marketplace: requests services
- Platform user → Service requests: tracks requests
- Service requests → Request details: opens details
- Platform user → Contracts: reviews contracts
- Platform user → Consumer invoices: reviews invoices
- Platform user → Consumer reports: views reports
- Platform user → Provider requests: manages requests
- Provider requests → Request fulfillment: opens details
- Client management → Dashboard shell: renders in
src/pages/provider/clients.js - Client management → Client details: opens details
src/pages/provider/clients.js - Platform user → Invoice generation: creates invoices
- Platform user → Admin dashboard: oversees platform
- Platform user → User administration: manages providers
- Platform user → Support tickets: handles tickets
- Admin dashboard → Report data: uses reports