Settings

The Settings module is the administrative control panel for Femina OS. It covers user management, roles and permissions, tags, and data migrations.

Overview

Settings is accessible only to Root users. It is divided into four sections: User Management, Role and Permissions, Tags Management, and Migrations Management.

Key Concepts

• User Management — add, edit, and deactivate system users
• Role and Permissions — create roles and assign per-resource permissions
• Tags Management — create program and award tags for clubs and clubbers
• Migrations Management — trigger class-level clubber migrations across clubs

User Roles & Permissions

Role	Settings Access
Root	Full access to all settings sections
All other roles	—

Features

User Management

A list of all system users with their name, email, role, and status. From here you can:

• Add new users and send invitation emails
• Edit an existing user's details or role
• Deactivate a user to revoke their access

Role and Permissions

A list of all roles in the system. Each role can be expanded to see its permissions. From here you can:

• Create custom roles with a name, key, and description
• Add or remove individual permissions per resource
• Edit built-in role permissions

Tags Management

Create and manage tags that can be applied to clubs and clubbers for program categorisation and award tracking.

Migrations Management

Trigger bulk class-level migrations for clubbers across all clubs or for a specific club. Migration history is shown in a table.

Workflows

Adding a New User

1. Go to Settings → User Management.
2. Click + Add User.
3. Fill in the user's name, email, phone number, sex, and role.
4. Click Save. The user receives an invitation email to set their password.

Deactivating a User

1. Go to Settings → User Management.
2. Find the user and click their row.
3. Click Deactivate (or toggle the active status).
4. Confirm the action. The user can no longer log in.

Creating a Custom Role

1. Go to Settings → Role and Permissions.
2. Click + to add a new role.
3. Enter a role name, key (lowercase, underscores), and description.
4. Add permissions for each resource the role needs.
5. Click Save.

Editing Role Permissions

1. Go to Settings → Role and Permissions.
2. Find the role and click its row to expand it.
3. Click Edit and adjust the permissions.
4. Click Save.

Creating a Tag

1. Go to Settings → Tags Management.
2. Click + Add Tag.
3. Enter the tag name and type.
4. Click Save.

Running a Club Migration

1. Go to Settings → Migrations Management.
2. Click Migrate all clubs and select the migration type (e.g. end-of-year class promotion).
3. Confirm the action. The migration job runs and appears in the history table once complete.