---
date: 2026-10-18
source_commit: ecac98ba01fa85ce10c4dbc900ffd7b44f0c0623 ("Update", 2026-10-15)
evidence_basis: static code analysis
scope: D:\main\VBMS\frontend\src (React SPA, react-router-dom v6, axios API layer at src/api/axios)
---

# VBMS Frontend — Page / Route Inventory

All facts below were extracted from the code at the commit above. Route generation lives in `frontend/src/App.jsx` (static routes, lines 280–291) and `renderModuleRoutes()` (lines 65–269), driven by module definitions in `frontend/src/config/modules.js` (`appModules`) rendered through `frontend/src/config/menu.js` (`modules`, path = `/modules/<slugify(label)>`). **App.jsx strips the `/modules/` prefix** (`pathSegment = mod.path.replace('/modules/', '')`, App.jsx:295), so real browser URLs are `/mis`, `/job-management`, etc. — not `/modules/...`. Sidebar/HorizontalNav compute links the same way (Sidebar.jsx:151–155).

Guards:
- `ProtectedRoute` (src/routes/ProtectedRoute.jsx:31): authenticated users only, else redirect `/login`.
- `RoleGuard` (src/routes/RoleGuard.jsx:49–110): wraps all module routes; `super_admin` passes; otherwise checks `user.child_permissions` JSON then flat `permissions`, redirecting to `/dashboard` on failure.
  - **Notable risk:** RoleGuard's `getModuleInfo()` builds `modPath = '/' + mod.path` from `appModules` (RoleGuard.jsx:10), but `appModules` entries (except `dashboard`) have **no `path` property** (modules.js:30–175). For all module routes `mod.path` is `undefined`, so `getModuleInfo` returns `null` and the guard **falls through to `<Outlet/>` without module/child permission checks** (RoleGuard.jsx:109). Child-level enforcement then depends entirely on per-page `canDo(...)` UI gating.

---

## Section 1: Route map

| Route path | Component | File | Guard | Type |
|---|---|---|---|---|
| `/` | Landing | src/pages/landing/Landing.jsx | none | public |
| `/login` | Login | src/pages/auth/Login.jsx | none | public |
| `/reset-password` | ResetPassword | src/pages/auth/ResetPassword.jsx | none | public |
| `/feedback/:token` | PublicFeedbackPage | src/pages/feedback/PublicFeedbackPage.jsx | none (publicApi) | public |
| `/access-denied` | AccessDenied | src/pages/common/AccessDenied.jsx | none | public |
| `/dashboard` | Dashboard | src/pages/dashboard/Dashboard.jsx | ProtectedRoute | protected |
| `/profile` | Profile | src/pages/profile/Profile.jsx | ProtectedRoute + MainLayout | protected |
| `/notifications` | Notifications | src/pages/notifications/Notifications.jsx | ProtectedRoute + MainLayout | protected |
| `/calendar` | CalendarPage | src/pages/calendar/CalendarPage.jsx | ProtectedRoute + MainLayout | protected |
| `/mis` (index) | MisSetupDashboard | src/pages/mis/MisSetupDashboard.jsx | ProtectedRoute+RoleGuard | dynamic |
| `/mis/members` | MembersPage | src/pages/mis/MembersPage.jsx | + child perm `employee.view` | dynamic |
| `/mis/documents` | DocumentsPage | src/pages/mis/DocumentsPage.jsx | + child perm `employee.view` | dynamic |
| `/mis/memberLocations` | MemberLocationsPage | src/pages/mis/MemberLocationsPage.jsx | + child perm `employee.view` | dynamic |
| `/job-management` (index) | AllJobsPage | src/pages/jobs/AllJobsPage.jsx | + child perm `job.view` | dynamic |
| `/job-management/dashboard` | JobDashboard | src/pages/jobs/JobDashboard.jsx | + child perm `job.view` | dynamic |
| `/job-management/all` | AllJobsPage | src/pages/jobs/AllJobsPage.jsx | + child perm `job.view` | dynamic |
| `/job-management/all-tickets` | AllTicketsPage | src/pages/jobs/AllTicketsPage.jsx | + child perm `job.view` | dynamic |
| `/job-management/my-assignments` | MyAssignmentsPage | src/pages/jobs/MyAssignmentsPage.jsx | + child perm `job.view` | dynamic |
| `/attendance` (index) | DailyAttendancePage | src/pages/attendance/DailyAttendancePage.jsx | + child perm `attendance.view` | dynamic |
| `/attendance/attendance` | DailyAttendancePage | src/pages/attendance/DailyAttendancePage.jsx | + `attendance.view` | dynamic |
| `/attendance/leaves` | LeaveRequestsPage | src/pages/attendance/LeaveRequestsPage.jsx | + `leave.view` | dynamic |
| `/attendance/capacity` | CapacityPage | src/pages/attendance/CapacityPage.jsx | + `attendance.view` | dynamic |
| `/holiday-calendar` (index) | CalendarsPage | src/pages/holidays/CalendarsPage.jsx | + `holiday.view` | dynamic |
| `/holiday-calendar/calendars` | CalendarsPage | src/pages/holidays/CalendarsPage.jsx | + `holiday.view` | dynamic |
| `/holiday-calendar/overrides` | OverridesPage | src/pages/holidays/OverridesPage.jsx | + `holiday.view` | dynamic |
| `/reviews` (index) | VbmsReviewPage | src/pages/reviews/VbmsReviewPage.jsx | + `review.vbms` | dynamic |
| `/reviews/vbms` | VbmsReviewPage | src/pages/reviews/VbmsReviewPage.jsx | + `review.vbms` | dynamic |
| `/reviews/cub` | CubReviewPage | src/pages/reviews/CubReviewPage.jsx | + `review.cub` | dynamic |
| `/reviews/feedback` | FeedbackPage | src/pages/reviews/FeedbackPage.jsx | + `feedback.view_responses` | dynamic |
| `/reports` (index) | MisDashboard | src/pages/mis/MisDashboard.jsx | + `mis.view` | dynamic |
| `/reports/overview` | MisDashboard | src/pages/mis/MisDashboard.jsx | + `mis.view` | dynamic |
| `/reports/attendance-report` | AttendanceReportPage | src/pages/reports/AttendanceReportPage.jsx | + `reports.view` | dynamic |
| `/reports/job-report` | JobReportPage | src/pages/reports/JobReportPage.jsx | + `reports.view` | dynamic |
| `/reports/ticket-report` | TicketReportPage | src/pages/reports/TicketReportPage.jsx | + `reports.view` | dynamic |
| `/users-roles` (index) | UserManagementPage | src/pages/users/UserManagementPage.jsx | + `user.view` | dynamic |
| `/users-roles/users` | UserManagementPage | src/pages/users/UserManagementPage.jsx | + `user.view` | dynamic |
| `/users-roles/roles` | RolesPage | src/pages/users/RolesPage.jsx | + `user.view` | dynamic |
| `/users-roles/scopes` | AccessControlPage | src/pages/users/AccessControlPage.jsx | + `user.view` | dynamic |
| `/users-roles/login-sessions` | LoginSessionsPage | src/pages/users/LoginSessionsPage.jsx | + `user.view` | dynamic |
| `/logs` (index) | Placeholder | src/pages/common/Placeholder.jsx | + `audit.view` | dynamic |
| `/logs/audit` | AuditLogs | src/pages/audit/AuditLogs.jsx | + `audit.view` | dynamic |
| `/master-setup` (index) | MasterSetupDashboard | src/pages/master/MasterSetupDashboard.jsx | + `state/location/customer.view` | dynamic |
| `/master-setup/states` | StatesPage | src/pages/master/StatesPage.jsx | + `state.view` | dynamic |
| `/master-setup/locations` | LocationsPage | src/pages/master/LocationsPage.jsx | + `location.view` | dynamic |
| `/master-setup/customers` | CustomersPage | src/pages/master/CustomersPage.jsx | + `customer.view` | dynamic |
| `/master-setup/materials` | MaterialsPage | src/pages/master/MaterialsPage.jsx | + `job.view` | dynamic |
| `/master-setup/serviceTypes` | ServiceTypesPage | src/pages/master/ServiceTypesPage.jsx | + `job.view` | dynamic |
| `/master-setup/mailFormats` | MailFormatsPage | src/pages/master/MailFormatsPage.jsx | + `settings.view` | dynamic |
| `/master-setup/feedbackForms` | FeedbackFormPage | src/pages/master/FeedbackFormPage.jsx | + `feedback.view` | dynamic |
| `/settings` (index) | `<Navigate to="general">` | App.jsx:301 | + `settings.view` | dynamic |
| `/settings/general` | Settings | src/pages/settings/Settings.jsx | + `settings.view` | dynamic |
| `/settings/notifications` | Settings (tab=notifications) | src/pages/settings/Settings.jsx | + `settings.view` | dynamic |
| `/settings/personalization` | Preference | src/pages/settings/Preference.jsx | + `settings.personalization` | dynamic |
| `/documentation` (index) | UserDocumentation | src/pages/documentation/UserDocumentation.jsx | + `documentation.view` | dynamic |
| `/documentation/user-docs` | UserDocumentation | src/pages/documentation/UserDocumentation.jsx | + `documentation.view` | dynamic |
| `/documentation/developer-docs` | DeveloperDocumentation | src/pages/documentation/DeveloperDocumentation.jsx | + `documentation.dev` | dynamic |

**Total routes: 56** (5 public, 4 protected top-level, 11 module index routes incl. `/settings` redirect and `/logs` placeholder, 36 child routes).

### Module → route derivation (modules.js → menu.js → App.jsx)

| Module key | Label | URL prefix | Children (slugs) |
|---|---|---|---|
| employee | MIS | `/mis` | members, documents, memberLocations |
| job | Job Management | `/job-management` | dashboard, all, all-tickets, my-assignments |
| attendance | Attendance | `/attendance` | attendance, leaves, capacity |
| holiday | Holiday Calendar | `/holiday-calendar` | calendars, overrides |
| review | Reviews | `/reviews` | vbms, cub, feedback |
| reports | Reports | `/reports` | overview, attendance-report, job-report, ticket-report |
| user | Users & Roles | `/users-roles` | users, roles, scopes, login-sessions |
| audit | Logs | `/logs` | audit |
| master | Master Setup | `/master-setup` | states, locations, customers, materials, serviceTypes, mailFormats, feedbackForms |
| settings | Settings | `/settings` | general, notifications, personalization |
| documentation | Documentation | `/documentation` | user-docs, developer-docs |
| dashboard | Dashboard | (not a module route) | — rendered at `/dashboard` |

---

## Section 2: Per-page detail

### Landing — `/` — src/pages/landing/Landing.jsx
- **Purpose:** Public marketing/overview page (hero, features, workflow, values, CTA) for Voltech Smart Facility Management.
- **Gating:** None. Renders regardless of auth.
- **Inputs/actions:** None (no forms). Buttons are `<Link to="/login">` ("Get Started", "Sign in", lines 259, 271, 381) and external links to voltechbliss.com / software.voltechgroup.com.
- **Tables/modals/APIs:** None.
- **Navigation:** → `/login`.

### Login — `/login` — src/pages/auth/Login.jsx
- **Purpose:** Username/password sign-in with lockout handling, language switch, dark-mode toggle, animated info carousel.
- **Gating:** None (public). Redirects authenticated users via `navigate(redirectTarget)` or `/dashboard` (lines 276–278).
- **Inputs:** `username` (text, required), `password` (text/toggle show, required), `rememberMe` (checkbox, line 150).
- **Actions:** Submit → `useAuth().login(username, password)` (line 269) → AuthContext posts `POST /auth/login` (AuthContext.jsx:23). "Forgot password" opens `ForgotPasswordModal` → `POST /auth/forgot-password` with `{email}` (ForgotPasswordModal.jsx:26). Session bootstrap `GET /auth/me` (AuthContext.jsx:13); logout `POST /auth/logout`.
- **States:** error banner, lockout countdown (`isLocked`, `lockoutCountdown`), welcome-back animation, loading spinner on submit.
- **Navigation:** → redirect target or `/dashboard`.

### ResetPassword — `/reset-password` — src/pages/auth/ResetPassword.jsx
- **Purpose:** Token-based password reset (from email link; reads `?token=`).
- **Gating:** None (public).
- **Inputs:** `newPassword`, `confirmPassword` (both password inputs; validated client-side).
- **APIs:** `GET /auth/reset-password/:token` to validate token (line 29; tokenState valid|invalid|expired|already_used); `POST /auth/reset-password` with `{token, newPassword}` (line 69).
- **Buttons:** Submit; "Back to login" → `navigate('/login')` (lines 169, 251, 428).
- **States:** invalid/expired/already-used screens; success screen.

### PublicFeedbackPage — `/feedback/:token` — src/pages/feedback/PublicFeedbackPage.jsx
- **Purpose:** Anonymous/authenticated customer feedback survey reached via emailed token link.
- **Gating:** None route-level. Uses separate `publicApi` axios instance (line 4). Supports `?auth=` redirect-to-login flow (`navigate('/login?redirect=...&auth=...')`, line 136).
- **Inputs:** respondent `name*`, `email*`, `designation` (optional; pre-filled & readonly when logged in); per-question 1–5 rating buttons (required questions enforced, line 159–160); comment textareas `strengths`, `improvements`, `suggestions`; `SignaturePad` (required, line 158).
- **APIs:** `GET /feedback/public/:token` (line 95); `POST /feedback/public/:token/submit` with answers, comments, rating label, respondent identity, signature (line 166).
- **States:** loading, error, already-submitted screen (`res.data.already_submitted`, line 96), thank-you screen.
- **Actions:** "Submit Feedback" (disabled while submitting).

### AccessDenied — `/access-denied` — src/pages/common/AccessDenied.jsx
- **Purpose:** Static "no permission" screen. **No code navigates to it** (RoleGuard redirects to `/dashboard` instead) — likely dead route.
- **Button:** "Go to Dashboard" → `navigate('/dashboard')` (line 39). No APIs.

### Dashboard — `/dashboard` — src/pages/dashboard/Dashboard.jsx
- **Purpose:** Role-aware KPI dashboard with customizable widget grid + infolets.
- **Gating:** `usePermission()` at line 567 (`hasPermission`); widgets adapt by role.
- **APIs:** `GET /dashboard/stats` with query params (dateFilter/from/to/status) (line 612); auto-refresh every 60s (line 622).
- **Controls:** Filters popover (date range presets incl. custom From/To DatePickers, status select, Apply/Reset, lines 863–907); widget edit mode (drag-drop reorder, AddWidgetModal add/remove/reset).
- **Actions:** Retry fetch on error (line 759); widget clicks `navigate(...)` into modules (e.g. `/job-management/all-tickets`, `/reviews/vbms`, `/attendance/leaves` — lines 408–737).
- **States:** loading skeleton, error panel with Retry.

### Profile — `/profile` — src/pages/profile/Profile.jsx
- **Purpose:** Self-service account view: overview, edit, photo, activity log, sessions & devices.
- **Gating:** Any authenticated user (own data only).
- **Tabs:** overview/edit | activity | sessions (URL-synced `?tab=`, line 101).
- **APIs:** `GET /profile` (137); `POST /profile/record-session` (141); `GET /profile/sessions` (142); `GET /profile/devices` (143); `GET /profile/activity?limit=15` (147); `PUT /profile` `{name,email,phone}` (160); `DELETE /profile/sessions/:id` (170); `DELETE /profile/sessions` (revoke all, 183); `DELETE /profile/devices/:id` (192); `POST /auth/change-password` `{currentPassword,newPassword}` (203); `POST /profile/photo` multipart (263).
- **Modals:** confirm revoke-all-sessions (line 648).
- **Navigation:** Topbar links here; ChangePassword.jsx (orphan) is not used.

### Notifications — `/notifications` — src/pages/notifications/Notifications.jsx
- **Purpose:** Notification inbox grouped by type (all/job/attendance/system/gps tabs).
- **APIs:** `GET /notifications?limit=200` (145); `PUT /notifications/read-all` (171); `PUT /notifications/:id/read` (180); `PUT /notifications/:id/unread` (188); `DELETE /notifications/:id` (196, 494).
- **Controls:** tabs w/ counts, Mark All Read button (line 341), per-item read/unread/delete, severity KPI cards, donut of unread/total.
- **States:** loading spinner, `EmptyState` when no items (line 387), delete confirm dialog.

### Calendar — `/calendar` — src/pages/calendar/CalendarPage.jsx
- **Purpose:** Month-view calendar of daily-task tickets with per-day drill-down.
- **APIs:** `GET /jobs/daily-tasks?limit=1000` (line 84).
- **Filters:** status, member, customer-text (lines 76–78, filter card 239–285) with active-filter tags; month/day KPIs; side panel lists selected-day tickets and member day summaries.
- **States:** loading spinner (line 378), empty "select a date" state (line 542).

### MIS index — `/mis` — src/pages/mis/MisSetupDashboard.jsx
- **Purpose:** MIS hub with KPI cards linking to members/documents/memberLocations.
- **APIs:** `GET /members`, `GET /members/all-documents`, `GET /members/all-member-locations` (lines 58–60).
- **Navigation:** cards → `/mis/members`, `/mis/documents`, `/mis/memberLocations` (lines 18, 30, 42).

### Members — `/mis/members` — src/pages/mis/MembersPage.jsx
- **Purpose:** CRUD field-member master with documents, photo, locations, login provisioning.
- **Gating:** `canDo(user,'employee','view|create|edit|delete','members')` (lines 316–319).
- **APIs:** list `GET /members`, `/states`, `/service-types`, `/locations`, `/customers`, `/users/roles/all` (335–342); view detail `GET /members/:id/documents|locations`, `/jobs/by-member/:id`, `/mis/members/:id/reviews` (359–362); save `PUT/POST /members` (1197–1198); reactivate `PUT /members/:id {employment_status:'active'}` (425); delete `DELETE /members/:id` (405); photo `POST /members/:id/photo` multipart (1226); documents `POST/PUT/DELETE /members/:id/documents[...]` (208, 217, 1263, 1284); locations sync `POST/DELETE /members/:id/locations` (1177–1178); username check `GET /auth/check-username/:username` (1084); state-filtered locations `GET /locations?state_id=...` (1095).
- **Table columns:** #, Emp ID, Name, Mobile, Email, State, Availability, Login, Status, actions (487–507).
- **Filters:** status, availability (line 310). Search/sort/pagination via DataTable.
- **Modals:** add/edit member (big form incl. login username/password/role, location, documents), view detail w/ tabs, delete confirm.

### Documents — `/mis/documents` — src/pages/mis/DocumentsPage.jsx
- **Purpose:** Cross-member compliance/identity document registry.
- **Gating:** `canDo(user,'employee',...,'documents')` (165–168).
- **APIs:** `GET /members?limit=100000` (178); `GET /members/all-documents` (183); `DELETE /members/:memberId/documents/:id` (202); create/edit `POST/PUT /members/:memberId/documents` multipart (729–730).
- **Columns:** #, Member, Document, Number, Type, Issue Date, Updated, actions (270–289).
- **Filters:** member, status, docType, from/to (line 156). CSV export (`documents-*.csv`, line 265). DonutChart by type, QuickInsights, RecentDocuments aside.
- **Modals:** add/edit document modal; delete confirm.

### Member Locations — `/mis/memberLocations` — src/pages/mis/MemberLocationsPage.jsx
- **Purpose:** Manage which locations each member is assigned to.
- **Gating:** `canDo(user,'employee','view|create|delete','memberLocations')` (147–149).
- **APIs:** `GET /members`, `GET /locations` (160); `GET /members/all-member-locations` (168); `POST /members/:id/locations {location_id}` (585); `DELETE /members/:memberId/locations/:locationId` (184).
- **Columns:** #, Member, Location, actions (250–263). Filters: member, location, status (138).

### Job Management index & All Jobs — `/job-management`, `/job-management/all` — src/pages/jobs/AllJobsPage.jsx
- **Purpose:** Full job list with create/edit/assign/auto-assign/submit/delete, ticket generation, and job detail drawer.
- **Gating:** `canDo(user,'job','view','all')` (110); edit/delete via `canDo(...'edit'/'delete','all')` (line 110 area; page uses canEdit/canDelete).
- **APIs:** `GET /jobs` (125); `GET /customers`, `/service-types`, `/members?limit=200` (135–137); detail `GET /jobs/:id` (161); feedback `GET /feedback/requests/job/:id` (174); redo history `GET /jobs/ticket/:id/redo-history` (153); assign `POST /jobs/:id/assign {member_id}` (218); auto-assign `POST /jobs/auto-assign {job_id}` (219); submit `POST /jobs/:id/submit` (220); delete `DELETE /jobs/:id` (221); generate tickets `POST /jobs/:id/generate-daily-tasks` (310); task save `PUT /jobs/:id/daily-tasks/:tid` or `POST /jobs/:id/daily-tasks/manual` (311, 317); task delete `DELETE /jobs/:id/daily-tasks/:tid` (331); cascade lookups `GET /customers/:id/branches` (1026), `GET /jobs/branch-locations?branch_id` (1027); job form create/update `POST /jobs` / `PUT /jobs/:id` (+assign member_ids) (967–968 in JobManagement.jsx pattern; AllJobsPage has equivalents).
- **Columns:** #, Job No, From, To, Customer, Branch, Service Type, Duration, Priority, Member, Status, actions (232–254).
- **Controls:** search, sortable columns, filters (status/priority/service/from/to; URL-seeded `?status= &priority= &date_filter=`), CSV export (203), view modes (grid/card via ViewSwitcher), pagination.
- **Modals:** view job (tabs: overview/assignments/tickets/activity/location/feedback), ticket view + RedoModal, edit ticket form (date, member, check-in/out times + GPS lat/lng, before/after photos, notes; leave-clash warning via `GET /jobs/check-leave`, `GET /jobs/members-by-location`), manual ticket add, delete confirms.

### Job Dashboard — `/job-management/dashboard` — src/pages/jobs/JobDashboard.jsx
- **Purpose:** Operational jobs KPI dashboard with alert list, engineer performance table, filters, export.
- **APIs:** `GET /dashboard/stats` + `GET /jobs?limit=1000` (231–232).
- **Controls:** date range filter (today/this_week/this_month/custom + from/to), status filter, Apply/Reset (549–582), Export CSV (464, 537), alert cards navigate with query strings (327–332).
- **Columns (engineer table):** Engineer Name, Assigned, Closed, Open, SLA Compliance, Avg Resolution Time, First-Time Fix Rate, CSAT Score (620–627).

### All Tickets — `/job-management/all-tickets` — src/pages/jobs/AllTicketsPage.jsx
- **Purpose:** All daily-task tickets across jobs; edit tickets, redo, delete pending tickets.
- **Gating:** `canDo(user,'job','view|edit|delete','all-tickets')` (317 area: canView/canEdit/canDelete).
- **APIs:** `GET /jobs/daily-tasks?...` (385); `GET /jobs/:jobId` (85); `GET /jobs/members-by-location` (91); `GET /jobs/check-leave` (118); `GET /members` (372); `PUT /jobs/:jobId/daily-tasks/:id` (408); `DELETE /jobs/:jobId/daily-tasks/:id` (438); RedoModal → `POST /jobs/ticket/:id/redo {reason}` (RedoModal.jsx:29).
- **Columns:** #, Job No, Date, Member, Customer, Service, Check-in, Check-out, Status, Job Status, actions (489–529).
- **Controls:** search, filters (status incl. URL `?status=`, date filter presets + custom from/to, 679–693), CSV export (563), view modes, pagination.
- **Modals:** view ticket (with Redo), edit ticket (same fields as jobs ticket form), delete-ticket ConfirmDialog (line 747 area).

### My Assignments — `/job-management/my-assignments` — src/pages/jobs/MyAssignmentsPage.jsx
- **Purpose:** Jobs assigned to the logged-in member: view, work tickets, submit.
- **Gating:** `canDo(user,'job','view|edit|delete','my-assignments')` (54 area).
- **APIs:** `GET /jobs` with assigned-member params (89); `GET /members` (90); detail `GET /jobs/:id` (106); feedback `GET /feedback/requests/job/:id` (119); submit `POST /jobs/:id/submit` (173); task update `PUT /jobs/:id/daily-tasks/:tid` (186); ticket delete `DELETE .../daily-tasks/:tid` (192); check-leave / members-by-location (820, 830); RedoModal.
- **Columns:** #, Job No, From, To, Customer, Branch, Service Type, Duration, Priority, Status, actions (205–222).
- **Filters:** status, priority, from/to (68). Submit action only when `status==='in_progress'` (225, 465).

### Attendance index & Daily Attendance — `/attendance`, `/attendance/attendance` — src/pages/attendance/DailyAttendancePage.jsx
- **Purpose:** Per-date attendance register with summary donut and manual refresh.
- **Gating:** `canDo(user,'attendance','view|edit','attendance')` (107–108).
- **APIs:** `GET /attendance/daily-attendance?date` + `GET /attendance/daily-summary?date` (115–116); `POST /attendance/refresh-attendance {date}` (127).
- **Columns:** #, Emp ID, Member, First In, Last Out, Work Hrs, Capacity, Jobs, Status, actions (181–204).
- **Controls:** date picker (filterDate), status filter (104), search, refresh button, DonutChart present/leave/absent.

### Leave Requests — `/attendance/leaves` — src/pages/attendance/LeaveRequestsPage.jsx
- **Purpose:** CRUD leave requests with approve/reject workflow.
- **Gating:** `canDo(user,'leave','approve|edit|create','leaves')` (118–120).
- **APIs:** `GET /attendance/leaves` (125); status change `PUT /attendance/leaves/:id {status}` (147); create/edit `POST /attendance/leaves` / `PUT /attendance/leaves/:id` (191–192).
- **Columns:** #, Emp ID, Member, From, To, Reason, Status, actions (252–264).
- **Filters:** status, from, to (111). Search, view modes.

### Capacity — `/attendance/capacity` — src/pages/attendance/CapacityPage.jsx
- **Purpose:** Member workload/capacity analytics (expected vs actual hours).
- **Gating:** `canDo(user,'attendance','view|edit','capacity')` (93–94).
- **APIs:** `GET /attendance/capacity`, `GET /attendance/capacity-summary` (121–122); `GET /customers` (153); set capacity `POST /attendance/capacity {...}` (173).
- **Columns:** #, Emp ID, Member, Days, Jobs, Customers, Expected, Actual, Capacity %, actions (242–265).
- **Filters:** capacity band All/high/medium/low (113).

### Holiday index & Calendars — `/holiday-calendar`, `/holiday-calendar/calendars` — src/pages/holidays/CalendarsPage.jsx
- **Purpose:** Manage holiday calendars (voltech/customer/state/location scope) with holiday dates and rules.
- **Gating:** `canDo(user,'holiday','view|create|edit|delete','calendars')` (197–200).
- **APIs:** `GET /holidays`, `/customers`, `/locations`, `/states` (206); detail `GET /holidays/:id` (229); delete `DELETE /holidays/:id` (246); save calendar `POST /holidays` / `PUT /holidays/:id` (792–794); add/remove dates `POST/DELETE /holidays/:calId/holidays[...]` (808, 816); rules `GET/POST/PUT/DELETE /holidays/:calId/rules[...]` (714, 829, 832, 836); add holiday modal `POST /holidays/:calendarId/holidays` (1041); bulk add `POST /holidays/bulk` (1197).
- **Columns:** #, Calendar Name, Year, Type, Customer, Location, State, Holidays, Status, actions (313–327).
- **Filters:** status, type (189). View detail modal loads rules (538).

### Holiday Overrides — `/holiday-calendar/overrides` — src/pages/holidays/OverridesPage.jsx
- **Purpose:** Date-level overrides (working/holiday) scoped globally, by customer/location/state/company.
- **Gating:** `canDo(user,'holiday','view|create|edit|delete','overrides')` (180–183).
- **APIs:** `GET /holidays/overrides`, `/customers`, `/locations`, `/states`, `/companies` (190–194); `DELETE /holidays/overrides/:id` (223); `POST /holidays/overrides` / `PUT /holidays/overrides/:id` (617).
- **Columns:** #, Date, Scope, Applies To, Working?, Reason, actions (312–318). Filters: status, from, to (175).

### Reviews index & VBMS Review — `/reviews`, `/reviews/vbms` — src/pages/reviews/VbmsReviewPage.jsx
- **Purpose:** VBMS-side ticket review queue: approve (internal sign-off), rework, super_admin comment.
- **Gating:** `canDo(user,'review','view|edit','vbms')` (98–99); comment only for super_admin (311).
- **APIs:** `GET /reviews/pending?...` (146); `GET /reviews/ticket/:id` (248); `GET /customers` (135); actions `POST /reviews/vbms/ticket/:id/approve|rework` and `POST /reviews/cub/ticket/:id/comment` with `{remarks}` (267–272). Remarks required for non-approve (254, 258).
- **Columns:** #, Ticket Date, Job No, Customer, Member, Photos, Status, actions (284–311). Tabs pending/completed; DonutChart; customer & date filters (118).

### CUB Review — `/reviews/cub` — src/pages/reviews/CubReviewPage.jsx
- **Purpose:** Customer-union/Business final review: approve (final sign-off), comment; rework only super_admin.
- **Gating:** `canDo(user,'review','view|edit','cub')` (94–95).
- **APIs:** `GET /reviews/pending?...` (142); `GET /reviews/ticket/:id` (158); `POST /reviews/cub/ticket/:id/approve|comment` (+ rework for super) with `{remarks}` (263–268).
- **Columns:** #, Ticket Date, Job No, Customer, Member, Photos, Status, actions (280–299).

### Feedback queue — `/reviews/feedback` — src/pages/reviews/FeedbackPage.jsx
- **Purpose:** Thin wrapper rendering shared `CustomerFeedbackTab` (allCustomers mode) for customer feedback requests.
- **APIs (in CustomerFeedbackTab.jsx):** `GET` feedback requests list (588, URL built with filters), `GET /customers/:cid` (829/883), `GET /feedback/templates/active` (859), `GET /customers` (863); send `POST /feedback/requests` (925); `DELETE /feedback/requests/:id` (1050); `PUT /feedback/recipients/:id/reactivate` (1068). Export CSV (1042).
- **Note:** the older combined `ReviewsPage.jsx` is imported in App.jsx but shadowed (see Orphans).

### Reports index & MIS Overview — `/reports`, `/reports/overview` — src/pages/mis/MisDashboard.jsx
- **Purpose:** Reports dashboard: jobs/members/attendance aggregates, widget editing.
- **Gating:** `canDo(user,'employee','edit') || canDo(user,'reports','edit')` for widget edit (166).
- **APIs:** `GET /jobs?limit=500`, `/members?limit=500`, `/attendance?limit=500` (64–66).
- **Table:** ID, Customer, Type, Assigned, Pri, Status, Date (line 249).

### Attendance Report — `/reports/attendance-report` — src/pages/reports/AttendanceReportPage.jsx
- **Purpose:** Attendance record report with KPIs and CSV export; customer logins get pre-filtered current month (line 56–58).
- **APIs:** `GET /attendance?limit=500`, `GET /members?limit=500` (90–91).
- **Columns:** Member, Date, Status, Check-in, Check-out, Hours (282).
- **Filters:** member, status, from/to; search. Export → `attendance-report.csv` (178–185). All filtering is client-side.

### Job Report — `/reports/job-report` — src/pages/reports/JobReportPage.jsx
- **Purpose:** Jobs report with distribution charts and export.
- **APIs:** `GET /jobs?limit=500`, `/customers`, `/service-types`, `/members?limit=200` (168–171).
- **Columns:** Job No, Customer, Category, Member, Pri, Status, Date (424).

### Ticket Report — `/reports/ticket-report` — src/pages/reports/TicketReportPage.jsx
- **Purpose:** Ticket-level report (daily-tasks), heavy multi-filter, segment charts.
- **APIs:** `GET /jobs/daily-tasks?limit=1000` (189).
- **Columns:** Job No, Customer, Service Type, Member, Pri, Status, Job Status, Ticket Date (475).
- **Filters:** customer, category, member, branch, status, job_status, priority, date_filter/from/to (147–148), URL-synced. Customer-scoped default `this_month` (170).

### Users index & User Management — `/users-roles`, `/users-roles/users` — src/pages/users/UserManagementPage.jsx
- **Purpose:** Admin user CRUD (create/edit/deactivate) with role assignment.
- **Gating:** `canDo(user,'user','view|create|edit|delete','users')` (171–174).
- **APIs:** `GET /users`, `/users/roles/all`, `/users/scopes/all` (205); `DELETE /users/:id` (deactivate, 547); `POST /users` / `PUT /users/:id` with `{name,username,email,phone,role,status[,password]}` (606–607).
- **Validation:** name required; username required, ≥3 chars, `[a-zA-Z0-9_]`; email required; password required on create, ≥6 (590–596).
- **Columns:** #, User Name, Type, Role, Status, Created, actions (281–303). Filters: role, status, user_type (189).
- **Modals:** UserModal (fields: name*, username*, email*, phone, password*, role*, status; lines 640–676), view/edit, delete confirm.

### Roles & Permissions — `/users-roles/roles` — src/pages/users/RolesPage.jsx
- **Purpose:** Role CRUD with granular per-module/sub-module (`child_permissions`) permission matrix editor.
- **Gating:** `canDo(user,'user','view|create|edit|delete','roles')` (394–397).
- **APIs:** `GET /users/roles/all`, `/users`, `/users/permissions/all` (428); role detail `GET /users/roles/:name` (757, 936); delete `DELETE /users/roles/:name` (711); create `POST /users/roles {name, description, child_permissions}` (846); update `PUT /users/roles/:name` + `PUT /users/roles/:name/permissions {permission_ids, child_permissions}` (843–848).
- **Columns:** #, Role, Permissions (child-perm count), Users, Status, actions (519–537). Search filter (412). Modal: role details tab + module permission matrix (tabs per module, action checkboxes view/create/edit/delete per child slug).

### Access Control — `/users-roles/scopes` — src/pages/users/AccessControlPage.jsx
- **Purpose:** Assign data scopes (state/location/customer/branch) to users.
- **Gating:** module perm `user.view` (route) — page loads scopes/users + masters.
- **APIs:** `GET /users/scopes/all`, `/users`, `/customers`, `/states`, `/locations`, `/customers/branches/all` (198–202); `DELETE /users/scopes/:id` (497); `PUT /users/scopes/:id {scope_type, scope_id}` (559); `POST /users/scopes {user_id, scope_type, scope_id}` (561).
- **Form:** user*, scope_type*, scope* (549–550, 593–608). View modal; delete confirm.

### Login Sessions — `/users-roles/login-sessions` — src/pages/users/LoginSessionsPage.jsx
- **Purpose:** Admin view of user login sessions with revoke.
- **Gating:** `canDo(user,'user','edit','users')` for revoke (37); route perm `user.view`.
- **APIs:** `GET /users/login-sessions?limit=1000` (55); `GET /users`, `/users/roles/all` (66–67); revoke `DELETE /users/login-sessions/:id` (139).
- **Columns:** #, User, Role, Device, Type, IP Address, Status, Last Active, Signed In, actions (197–234).
- **Filters:** user, role, status, device, dateFrom/dateTo (44, 332–352).

### Logs index — `/logs` — src/pages/common/Placeholder.jsx
- **Purpose:** Generic "under development" placeholder (App.jsx:300 renders for modules without own index). Back to Dashboard link (Placeholder.jsx:24).

### Audit Logs — `/logs/audit` — src/pages/audit/AuditLogs.jsx
- **Purpose:** Read-only audit trail with diff view.
- **APIs:** `GET /audit?entity&action&from_date&to_date...` (180).
- **Columns:** #, Time, User, Action, Entity, ID, Old Data, New Data (243–257). Filters: entity, action, from/to dates (154). Search, view switcher, pageSize 12, refresh, presetId (363).

### Master Setup index — `/master-setup` — src/pages/master/MasterSetupDashboard.jsx
- **Purpose:** Master-data hub (states/locations/customers KPI cards → child pages).
- **APIs:** `GET /states`, `/locations`, `/customers`, `/companies`, `/service-types`, `/materials` (29–30). Entity table: Entity, Total, Active, Inactive, Status (105–109).

### States — `/master-setup/states` — src/pages/master/StatesPage.jsx
- **Purpose:** CRUD states (with map search). Gating `canDo(user,'state',...)` (241–244).
- **APIs:** `GET /states?limit=500`, `/locations?limit=2000` (278–279); `GET /states/:id` (293); `DELETE /states/:id` (811); `PUT /states/:id` (diff) / `POST /states` (876–877).
- **Columns:** #, State Name, Locations, Status, Created By, Updated, actions (354–374). Form: name* (+map search), status (edit). Filters: status, from/to (255).

### Locations — `/master-setup/locations` — src/pages/master/LocationsPage.jsx
- **Purpose:** CRUD locations under states, with geocoding (PlaceSearch/MapPicker).
- **Gating:** `canDo(user,'location',...)` (155–158).
- **APIs:** `GET /locations`, `/states` (185); `GET /locations/:id` (189); `DELETE /locations/:id` (461); `PUT /locations/:id` / `POST /locations` (513); reverse geocode via `fetch` Nominatim (502).
- **Columns:** #, Location Name, State, Coordinates, Status, Created By, Updated, actions (210–219). Form: name*, state*, lat/lng (auto), map pick. Filters: status, from/to (169).

### Customers — `/master-setup/customers` — src/pages/master/CustomersPage.jsx (largest page, ~170KB)
- **Purpose:** Customer master with branches → locations → contacts tree, login-role contacts, materials orders, feedback tab.
- **Gating:** `canDo(user,'customer','view|create|edit|delete')` + `canDo(user,'feedback','view_responses')` (238–242).
- **APIs:** `GET /customers`, `/companies`, `/states` (284); detail `GET /customers/:id` (300); materials `GET /materials/grouped?customer_id=` (306); feedback `GET /feedback/requests/customer/:id` (313); group `GET /materials/group/:key` (329); `GET /users/roles/all` (42); save customer `POST /customers` / `PUT /customers/:id` (1345–1353); contacts `PUT /customers/:cid/contacts` (1379), nested branch/location/contact CRUD `POST/PUT/DELETE /customers/:cid/branches[...]`, `.../locations[...]`, `.../contacts[...]` (1410–1412, 1765, 1886–1893, 2047–2048); holidays `GET /holidays?status=active` (1287).
- **Columns (orders/materials tabs):** Order No, Branch, Month/Year, Mode, Items, Qty, Amount (953–960); materials item table with CGST/SGST/CESS (1120–1129). Main customer list uses name/code/status pattern.
- **Modals:** customer form, branch/location/contact forms (with Nominatim reverse-geocode `fetch`, 1848), calendar picker, view detail with tabs.

### Materials — `/master-setup/materials` — src/pages/master/MaterialsPage.jsx
- **Purpose:** Monthly material-purchase orders per customer branch with line items (GST fields), documents.
- **Gating:** `canDo(user,'job','view|create|edit|delete','materials')` (175–178).
- **APIs:** `GET /materials/grouped`, `/materials`, `/companies`, `/customers`, `/customers/branches/all`, `/material-types` (216–221); group `GET /materials/group/:key` (241); detail `GET /materials/:id` (256); delete single/bulk `DELETE /materials/:id` or `DELETE /materials {ids}` (725–730); add type `POST /material-types {name}` (876); save `PUT /materials/:id` / `POST /materials` (955–974); document `POST /materials/:id/document` multipart (1000).
- **Columns:** #, Order No, Customer, Branch, Month/Year, Mode, Items, Qty, Amount, actions (329–343). Item editor columns: Type, Material Name, Qty, CGST %, SGST %, CESS %, Add. Cost, Price, Total (1116–1124). Filters: from/to, customer, branch (195).

### Service Types — `/master-setup/serviceTypes` — src/pages/master/ServiceTypesPage.jsx
- **Purpose:** CRUD service-type catalog with default durations.
- **Gating:** `canDo(user,'job',...,'serviceTypes')` (240–243).
- **APIs:** `GET /service-types` (275); `GET /service-types/:id` (287); `DELETE /service-types/:id` (731); `PUT /service-types/:id` / `POST /service-types` (796–797).
- **Columns:** #, Service Type Name, Duration, Status, Created By, Updated, actions (338–358). Form: name*, default_duration select. Filters: status, from/to (253).

### Mail Formats — `/master-setup/mailFormats` — src/pages/master/MailFormatsPage.jsx
- **Purpose:** CRUD email template formats (subject + body with placeholders).
- **Gating:** `canDo(user,'settings','view|create|edit|delete','mailFormats')` (222–225).
- **APIs:** `GET /mail-formats?...` (259); `DELETE /mail-formats/:id` (271); status toggle `PUT /mail-formats/:id {status}` (281); save `PUT /mail-formats/:id` / `POST /mail-formats` (837–838).
- **Columns:** #, Email Name, Subject, Status, Updated, actions (322–336). Form: email_name* (disabled on edit), subject*, body editor, status. Filters: status (238).

### Feedback Forms — `/master-setup/feedbackForms` — src/pages/master/FeedbackFormPage.jsx
- **Purpose:** CRUD feedback survey templates (questions list, optional service-type link) + per-template request history.
- **Gating:** `canDo(user,'feedback','view|create|edit|delete','feedbackForms')` (206–209).
- **APIs:** `GET /feedback/templates` (264); requests `GET /feedback/templates/:id/requests` (227); save `PUT/POST /feedback/templates` (335–338); `DELETE /feedback/templates/:id` (351); status toggle `PUT /feedback/templates/:id {status}` (362).
- **Columns:** #, Template Name, Service Type, Questions, Status, Created By, Updated, actions (386–410). Form: name*, description, service_type select, dynamic question rows (all questions need text, 323–324). Filters: status, serviceType, from/to (241).

### Settings — `/settings/general`, `/settings/notifications` — src/pages/settings/Settings.jsx
- **Purpose:** System settings tabs: General, Notifications, SLA, Security, Integrations (QR download).
- **Gating:** `settings.view` (route). 
- **APIs:** `GET /settings` (118); `PUT /settings {...}` (177); integrations `GET /integrations/email` (223), `POST /integrations/email` (235).
- **Tab sync:** `?tab=` via useTabState (52); `/settings/notifications` opens Settings (routeMap in App.jsx maps both general and notifications children to Settings).
- **Controls:** Switch/Input/Select fields per tab; email integration form.

### Personalization — `/settings/personalization` — src/pages/settings/Preference.jsx
- **Purpose:** User UI preferences (theme, appearance, font, navigation) — client-side via PreferenceContext.
- **Gating:** `settings.personalization` (route child perm).
- **APIs:** none direct; PreferenceContext does `GET /preferences`, `PUT /preferences` (PreferenceContext.jsx:312, 328, 356, 386).
- **Tabs:** personalization, appearance, font, navigation (15–18).

### User Documentation — `/documentation`, `/documentation/user-docs` — src/pages/documentation/UserDocumentation.jsx
- **Purpose:** Static user guides rendered by DocumentationShell from `userDocContent.js`; export filename `vbms-user-documentation`.
- **APIs:** none (docExport.js does file export client-side).

### Developer Documentation — `/documentation/developer-docs` — src/pages/documentation/DeveloperDocumentation.jsx
- **Purpose:** Static developer docs (architecture, DB, API, deployment…) from `developerDocContent.js`.
- **APIs:** none.

---

## Cross-cutting UI components (not routes)

- **MainLayout** (src/layouts/MainLayout.jsx): shell = Sidebar + Topbar + content `<Outlet/>`. Layout files make **no direct API calls** (grep over src/layouts found none).
- **Sidebar** (src/layouts/Sidebar.jsx): derives links as `/' + mod.path.replace('/modules/','') + '/' + child.slug` (151–155); permission-hides items via `canAccessChild`/`hasAnyAccessibleChild` from menu.js; quick links `navigate('/job-management/all?date_filter=today')` (328) and `/job-management/all-tickets?status=in_progress&date_filter=today` (338); brand/home → `/dashboard`.
- **Topbar** (src/layouts/Topbar.jsx): logo → `/dashboard` (133); pending-tickets button → `/job-management/all-tickets?status=pending&date_filter=today` (179); links `/calendar` (256), `/notifications` (265), `/profile` (357), `/settings/personalization?tab=personalization` (366); change-password shortcut `navigate('/profile?tab=security')` (380); logout `navigate('/login?logout=1')` (120) after AuthContext `POST /auth/logout`.
- **HorizontalNav** (src/layouts/HorizontalNav.jsx): same path derivation as Sidebar (22–26).
- **CommandPalette** (src/components/CommandPalette.jsx): debounced `GET /search?q=...` (62); results navigate `navigate(item.path)` (79); static link fallback when query < 2 chars.
- **DataTable** (src/components/DataTable.jsx): shared table with search, column sort, column filters, pagination (pageSize selector), skeleton loading rows (516–517), empty message, optional refresh button, CSV-friendly columns, row selection; used by nearly all list pages.
- **Shared modals:** DeleteConfirm, ConfirmDialog, Modal, DetailViewModal, RedoModal (`POST /jobs/ticket/:id/redo`), ForgotPasswordModal (`POST /auth/forgot-password`), SignaturePad (public feedback), MapPicker/PlaceSearch (Nominatim `fetch` calls in Locations/Customers/MasterSetup pages), TaskPhotoField, TicketReviewActions (`POST` via meta.endpoint), ReviewHistoryCard, JobTrailMap (`GET /jobs/:id/location-pings`).

---

## Section 3: Orphan / unrouted pages

Present in `src/pages` but **not referenced by any route** (verified via App.jsx imports/routes and repo-wide import grep):

| File(s) | Evidence |
|---|---|
| src/pages/gps/GpsTracking.jsx, LiveTracking.jsx, VehicleDetail.jsx (3 files) | No imports outside gps tree (GpsTracking imports VehicleDetail only). No route. |
| src/pages/service/ServiceRequests.jsx, CreateServiceRequest.jsx, ServiceDetail.jsx (3 files) | No imports anywhere; no route. |
| src/pages/master/MasterSetup.jsx | Not imported; superseded by MasterSetupDashboard + per-entity pages. |
| src/pages/members/MemberManagement.jsx (+ .bak copy) | Not imported; superseded by mis/MembersPage. |
| src/pages/mis/Reports.jsx | Not imported; superseded by reports/* pages. |
| src/pages/users/UserManagement.jsx | Not imported; superseded by users/UserManagementPage.jsx. |
| src/pages/auth/ChangePassword.jsx | Not in any route; Profile handles password change inline. |
| src/pages/holidays/HolidayCalendar.jsx | **Imported in App.jsx:45 but never rendered** — holiday branch uses CalendarsPage/OverridesPage (App.jsx:101–117). Dead import. |
| src/pages/jobs/JobManagement.jsx | **Imported (App.jsx:36) and in routeMap (line 69) but unreachable** — the `modSlug === 'job-management'` branch (157–175) returns before the generic Component mapping. Dead code path. |
| src/pages/reviews/ReviewsPage.jsx | **Imported (App.jsx:41), routeMap 'reviews' (line 70) unreachable** — reviews branch (177–194) returns first. Dead code path. |
| src/pages/pages/ — **legacy duplicate tree, 23 .jsx files** | Mirrors old structure (audit, auth, calendar, common, dashboard, gps, holidays, jobs, master, members, mis, profile, reviews, service, settings, users). Not imported by App.jsx. Left untouched; noted only. |

---

## Section 4: Cross-cutting UI state patterns

1. **Auth/loading:** `AuthContext` bootstraps with `GET /auth/me`; App shows `AppLoader` while `loading` (App.jsx:275). ProtectedRoute shows inline spinner while loading.
2. **Permission model:** three layers — (a) route guards (ProtectedRoute, RoleGuard), (b) page-level `canDo(user, moduleKey, action, childSlug)` from utils/canDo (child_permissions JSON first, flat perms fallback), (c) `usePermission`/`PermissionGate` (only Dashboard uses usePermission among pages; PermissionGate component exists but is unused by pages). `super_admin` bypasses everywhere.
3. **List pages follow one template:** PageHeader/breadcrumb → KPI cards → Filters popover + active-filter chips → DataTable (search/sort/page/pageSize, skeleton rows, emptyMessage+icon, onRefresh) → ViewSwitcher (grid/card) persisted in localStorage per page (`*_view_mode` keys) → view-detail modal (tabbed) → form modal (EntityFormShell-style rail) → DeleteConfirm. CSV export via Blob (`exportCsv` helper) on most list pages.
4. **Diff-based saves:** master CRUD pages compute `diffPayload(editItem, payload)` and PUT only changed fields; "No changes to save" toast when empty.
5. **Toasts:** `useToast`/sweetalert2 for success/error; i18n `t()` with defaultValue everywhere (English fallbacks).
6. **Error handling:** `.catch(() => null)` on secondary fetches; primary fetch failures show toast or inline error + Retry (Dashboard). Most pages swallow errors silently in nested lookups.
7. **Pagination:** client-side only (DataTable slice); several pages fetch `limit=500`–`100000` and filter in browser — no server-side paging observed.
8. **URL state:** AllJobs/AllTickets/Reports/Settings/Profile sync filters or tabs to query params (`?status=`, `?date_filter=`, `?tab=`); deep links from Topbar/Sidebar/Dashboard use this.
9. **External calls:** Nominatim OpenStreetMap reverse/search `fetch` (Locations, Customers, MasterSetup, LiveTracking orphans); Leaflet map rendering in JobTrailMap/MapPicker.
10. **Auto-refresh:** Dashboard polls `/dashboard/stats` every 60s; other pages manual refresh only.

---

*Generated 2026-10-18 from static analysis of commit ecac98ba. No application source files were modified.*
