Page Management
API ENDPOINT
/pages
Overview
The Page Management module is used to create, manage, and control application pages and their routes.
This module allows administrators to define pages, assign routes, associate them with modules, and control whether pages are active or inactive in the system.
⚠️ Access Restriction:
This page is only accessible to Super Admin users.
Purpose of Page Management
Page Management helps the system:
- Maintain a centralized list of all application pages
- Define routing paths for frontend navigation
- Control page availability using active/inactive status
- Support role-based access and permission mapping
- Ensure structured and secure page configuration
Access Control
- Allowed Role: Super Admin only
- Other users (Admin, HR, Employee) cannot access this page
- Used primarily for system configuration and permission setup
Page Layout
The Page Management screen consists of two main sections:
- Page Creation Form
- Page Listing Table
Page Creation Form
This section allows Super Admins to create new application pages.
Fields Description
Page Name
- Name of the page displayed in the system
- Example: Employee Search
Page Route
- URL route path for the page
- Must be unique
- Used for navigation and permission mapping
- Example: /employee/search
Module
- Indicates which module the page belongs to
- Helps in organizing pages logically
- Example: Employee / Payroll / Reports
Description
- Short explanation of the page purpose
- Optional but recommended
- Helps administrators understand page usage
Active Status
- Checkbox to control page availability
- Checked: Page is active and accessible
- Unchecked: Page is inactive and hidden from access
Add Page Button
- Saves the page configuration
- Creates a new page entry in the system
- Automatically available for role assignment
Page Listing Table
The table displays all existing pages created in the system.
Table Columns
| Column | Description |
|---|---|
| # | Serial number |
| Name | Page name |
| Route | Page URL route |
| Module | Associated module |
| Status | Active or Inactive |
| Actions | Edit, View, Delete |
Actions Available
✏️ Edit Page
- Modify page name, route, module, description, or status
- Used when routes or page details change
👁 View Page
- Displays page details in read-only mode
- Useful for quick reference
🗑 Delete Page
- Removes the page from the system
- Should be used cautiously
- Recommended only if the page is no longer required
🔄 Activate / Deactivate Page
- Activate: Page becomes accessible in the system
- Deactivate: Page becomes unavailable without deletion
- Useful for temporary access control
Status Indicator
- Active (Green): Page is enabled
- Inactive: Page is disabled and not accessible
Use Cases
Example 1: Adding a New Page
- Enter Page Name
- Define Page Route
- Select Module
- Add description
- Enable Active status
- Click Add Page
Example 2: Disabling a Page Temporarily
- Locate the page in the table
- Click Edit
- Uncheck Active
- Save changes
Best Practices
- Use clear and consistent route naming
- Avoid deleting pages that are already mapped to roles
- Deactivate pages instead of deleting when unsure
- Keep descriptions meaningful for future reference
Security Notes
- Only Super Admins can manage pages
- Prevents unauthorized route creation
- Ensures structured permission management
- Supports system audit and control
Summary
- Page Management controls what pages exist in the system
- Defines routes, modules, and access status
- Supports role and permission configuration
- Critical for system structure and security