Skip to main content

Overview

As an administrator, you can manage all user accounts in Quality Hub GINEZ, including creating new users, assigning roles, and managing access levels. User management is centralized in the Configuration module.

Accessing User Management

1

Navigate to Configuration

Click on Configuración in the sidebar menu
2

Go to Users Tab

Click on the Usuarios tab or navigate to /configuracion/usuarios

User Roles

Quality Hub GINEZ has 8 predefined roles with specific permissions based on access levels (AC=Complete, AP=Partial, AR=Restricted):

1. Administrador (Administrator)

Full system access - System Administrators, IT, General Managers
  • ✅ Full access to all modules (AC level)
  • ✅ Can create, edit, and delete all records
  • ✅ Can manage users and permissions
  • ✅ Can export data from all modules
  • ✅ Access to all filters including branch (sucursal) filter
  • ✅ Access to audit logs and all configuration tabs

2. Preparador (Preparer)

Product preparation and batch logging - Product Preparers, Mixing Personnel, Formulation Technicians
  • ✅ View and download catalog (AC level)
  • ✅ Create and edit bitácora entries (AC level)
  • ✅ View quality control (AP level - partial, view only)
  • ✅ View quality control reports (AP level)
  • ❌ No access to commercial analysis reports
  • ❌ No branch (sucursal) filter access
  • ❌ Cannot delete any records

3. Gerente de Calidad (Quality Manager)

Quality control and development - Quality Managers, R&D Directors, Laboratory Managers
  • ✅ View and download catalog
  • Full quality control access (AC level - can edit and delete)
  • ✅ Access to branch filter in Quality Control module
  • ✅ Can manage quality parameters across all branches
  • ❌ No access to bitácora module (AR level)
  • ❌ Cannot view commercial analysis reports

4. Gerente de Sucursal (Branch Manager)

Branch-level management and oversight - Branch Managers, Regional Supervisors
  • ✅ View and download catalog
  • ✅ View quality control (AP level - view only)
  • ✅ View quality control reports
  • ❌ No access to bitácora module (AR level)
  • ❌ No branch filter (sees only their data)
  • ❌ Cannot edit or delete quality records

5. Director de Operaciones (Operations Director)

Operations oversight and quality monitoring - Operations Directors, Production Managers
  • ✅ View and download catalog
  • ✅ View quality control (AP level - view only)
  • ✅ View quality control reports
  • ❌ No access to bitácora module (AR level)
  • ❌ Cannot edit or delete quality records

6. Mostrador (Counter Staff)

Catalog access only - Counter Personnel, Front Desk Staff
  • ✅ View and download catalog only
  • ✅ Access to profile settings
  • ❌ No access to any other modules (AR level for all except catalog)

7. Cajera (Cashier)

Catalog access only - Cashier Personnel
  • ✅ View and download catalog only
  • ✅ Access to profile settings
  • ❌ No access to any other modules (AR level for all except catalog)

8. Director de Compras (Purchasing Director)

Catalog and limited reporting - Purchasing Directors, Procurement Managers
  • ✅ View and download catalog
  • ✅ View reports (commercial analysis tab)
  • ✅ Access to profile settings
  • ❌ No access to bitácora or quality control modules

Managing User Accounts

Viewing All Users

The Users page displays a table with:
  • User name
  • Role assignment
  • Branch (sucursal)
  • Approval status
  • Last updated date
Search and Filter:
  • Use the search bar to find users by name
  • Filter by pending approvals using the toggle

Creating New Users

Users typically register themselves through the login page. As an administrator, you then:
1

Review Pending Users

Check for users with “Pending” approval status
2

Assign Role and Branch

Click Edit on the user’s row and select:
  • Appropriate role from the dropdown
  • Branch (sucursal) assignment
3

Approve Access

Toggle the Approved checkbox to grant system access
4

Save Changes

Click Save to apply the configuration

Editing User Information

1

Locate the User

Find the user in the Users table using search or scrolling
2

Click Edit

Click the Edit icon (pencil) next to the user’s name
3

Modify Details

Update any of the following:
  • Full name
  • Position/title
  • Department area
  • Branch assignment
  • Role
  • Admin status (elevate to administrator)
4

Save Changes

Click Save to update the user profile
Changes take effect immediately. Users may need to refresh their browser to see updated permissions.

Deleting User Accounts

Deleting a user removes their profile and access, but preserves historical records for audit trail purposes. This action cannot be easily undone.
1

Click Delete Icon

Click the Trash icon next to the user you want to remove
2

Confirm Deletion

Read the warning message carefully and confirm the action
What happens when you delete a user:
  • ✅ User profile information is removed
  • ✅ User loses system access
  • ✅ Historical records (bitácora, quality control) are preserved
  • ✅ Auth account may remain in the system for security

Best Practices

Principle of Least Privilege

  • Assign only the permissions necessary for the user’s job function
  • Example: A preparer doesn’t need access to reports or quality validation

Separation of Duties

  • The person who prepares products should not be the same person who validates quality
  • Prevents conflicts of interest and ensures checks and balances

Regular Review

  • Review user permissions every 3-6 months
  • Revoke access for inactive users
  • Update roles when employees change positions

Documentation

  • Maintain a record of who has what permissions
  • Document significant changes (promotions, role changes)
  • Keep notes on why specific permissions were granted

Workflow Example

Scenario: Onboarding a New Preparer

1

User Self-Registration

New employee registers through the login page with their company email
2

Admin Reviews Request

You receive notification of pending user approval
3

Verify Identity

Confirm with HR or manager that this is a legitimate new employee
4

Assign Preparer Role

  • Set role to “Preparador”
  • Assign to their work branch (e.g., “Tlalnepantla”)
  • Set their area (e.g., “Producción”)
5

Approve and Notify

Toggle approved status and save. Inform the user they can now log in

Troubleshooting

User Cannot Access a Module

  1. Verify their role includes permissions for that module
  2. Ask user to refresh the page (F5)
  3. Check that their account is approved
  4. Review role permissions in the system

Changes Not Reflected

  1. User must reload the page to see permission changes
  2. Verify changes were saved successfully
  3. Check browser console (F12) for errors
  4. Clear browser cache if necessary

Cannot See User Management

  • Only administrators can access user management
  • Verify your account has is_admin = true
  • Check that you’re in the “Usuarios” tab of Configuration

Build docs developers (and LLMs) love