Overview
The Transport Logistics platform provides secure authentication and role-based access control to ensure that users can only access features relevant to their role. The system supports both admin and standard user roles, each with tailored permissions and interface views.Key Features
Email-Based Login
Secure authentication using email and password credentials with validation
Role-Based Access
Automatic role detection with customized dashboards for admins and users
Session Management
Persistent login sessions with automatic security checks
Access Protection
Protected routes ensuring users only access authorized features
Signing In
Navigate to Sign In Page
When you first access the platform, you’ll be directed to the sign-in page automatically. If you’re already logged in, you’ll be redirected to your shipments dashboard.
Enter Your Credentials
Provide your email address and password:
- Email: Your registered email address (format validated automatically)
- Password: Your secure password
Email addresses are automatically converted to lowercase for consistency.
User Roles and Permissions
Admin Role
Administrators have full access to all platform features:Full Data Management
Full Data Management
- Create, edit, and delete all records (shipments, transporters, vehicles, routes, packages, materials)
- View all shipments across all packages
- Access comprehensive analytics and reports
- Manage user accounts and permissions
System Configuration
System Configuration
- Configure routes with billing and vendor rates
- Set up packages and assign users
- Manage transporter and vehicle status (active/inactive)
- Define materials and their availability
Standard User Role
Standard users have limited, focused access:View-Only Access
View-Only Access
- View shipments assigned to their packages only
- See dashboard analytics filtered to their assigned data
- Access read-only views of transporters, vehicles, and routes
Restricted Features
Restricted Features
- Cannot create or edit any records
- Cannot access user management
- Cannot view shipments outside assigned packages
- No access to system configuration settings
Login Validation and Error Handling
The authentication system includes comprehensive validation:Email Validation
- Checks for proper email format before submission
- Validates against pattern:
[email protected] - Displays error if format is invalid
Common Login Errors
| Error Message | Cause | Solution |
|---|---|---|
| ”Invalid email or password” | Incorrect credentials | Verify your email and password are correct |
| ”Please verify your email” | Email not confirmed | Check your inbox for verification email |
| ”Failed to sign in” | Network or server issue | Try again or contact support |
Session Behavior
Persistent Sessions
- Once logged in, your session remains active across page refreshes
- No need to re-authenticate during active sessions
- Session data is securely stored in your browser
Automatic Redirects
The platform automatically redirects you based on your authentication state:
- Already logged in? → Redirected to Shipments page
- Not authenticated? → Redirected to Sign In page
Security Features
Secure Password Handling
Passwords are never stored in plain text and are securely hashed
Protected API Calls
All data requests include authentication tokens
Role Verification
Server-side role checks ensure proper access control
Session Validation
Continuous validation of user sessions for security
Best Practices
Troubleshooting
Can’t Log In?
Verify Credentials
Double-check that your email and password are correct. Remember that email is case-insensitive but password is case-sensitive.
Check Email Verification
If you recently created your account, ensure you’ve verified your email address by clicking the link sent to your inbox.