ServX Logo

Administration

Last updated: November 2025

The Administration module provides system-wide configuration and user management. Administrators can manage users, define roles and permissions, configure modules, and set up global system settings.

Administrator Only

This module is restricted to users with Administrator privileges. Changes made here affect the entire system.

1. User Management

Manage system users, their access credentials, and preferences.

User Information

FieldDescriptionRequired
NameUser's display nameYes
EmailLogin email address (must be unique)Yes
PasswordSecure password (hashed in database)Yes
RolesAssigned roles determining permissionsNo
TimezoneUser's preferred timezoneNo
Email NotificationsEnable/disable email alertsNo (default: On)
Is ActiveEnable/disable user accountNo (default: Active)

How to Create a New User

  1. Navigate to Administration → Users
  2. Click "New User"
  3. Enter the user's name and email address
  4. Set an initial password
  5. Assign one or more roles
  6. Configure timezone and notification preferences
  7. Click "Save"

Reset Password

Reset a user's password if they forget it. A new temporary password will be set.

Deactivate User

Disable a user account to prevent login while preserving their data.

Reactivate User

Re-enable a previously deactivated user account.

2. Role Management

Roles group permissions together for easy assignment to users. A user can have multiple roles, and their effective permissions are the combination of all assigned roles.

Role Configuration

Basic Settings

  • Name - Role identifier (e.g., "Sales Manager")
  • Description - What this role is for
  • Is Active - Enable/disable the role

Assignments

  • Permissions - List of granted permissions
  • Modules - Accessible system modules

Common Role Examples

Administrator

Full system access, all modules and permissions

Sales Representative

Commercial module, view customers, create quotations

Warehouse Staff

Inventory module, stock operations, transfers

Cashier

POS module only, process transactions

Accountant

Financial module, reports, AR/AP access

Purchasing Officer

Procurement module, suppliers, purchase orders

How to Create a New Role

  1. Navigate to Administration → Roles
  2. Click "New Role"
  3. Enter a descriptive name
  4. Add a description of the role's purpose
  5. Select the modules this role can access
  6. Select the permissions to grant
  7. Click "Save"

3. Permission Management

Permissions define specific actions users can perform. They are assigned to roles, which are then assigned to users.

Permission Types

View

Read access

Create

Add new records

Edit

Modify existing

Delete

Remove records

Example Permissions

customer.view - View customers
customer.create - Create customers
order.approve - Approve orders
inventory.transfer - Transfer stock
report.financial - View financial reports
admin.settings - Modify settings

4. Module Configuration

Configure which modules are available in the system and which roles can access them.

Available Modules

Commercial
Inventory
Procurement
Financial
POS
Administration

5. System Settings

Configure global system settings that affect all modules.

Currency Settings

Configure supported currencies and default currency for transactions.

VAT Configuration

Set up tax rates and VAT settings for different regions or product types.

Payment Methods

Configure accepted payment methods (Cash, Card, Digital Wallet, etc.).

Module Settings

Enable or disable modules based on business needs.

Security Best Practices

  • Least Privilege: Only grant permissions users actually need for their role.
  • Regular Review: Periodically review user accounts and deactivate unused ones.
  • Strong Passwords: Enforce strong password policies for all users.
  • Role Separation: Use multiple roles rather than one "super role" with all permissions.
  • Audit Trail: Monitor user activity through system logs.

Module Documentation

Learn about the modules you can configure: