Users Management

In Mint Condition, users can be managed in two main locations:

1. From a Property’s Detail Page: Under the “Users” tab (if you have rights to edit a property, and you open it, you’ll see a list of users for that specific property).
2. From the main “Users Management” Page: A global view allowing you to manage multiple users (and their roles across multiple properties) at once.

Below is an overview of each approach and how you can invite, edit, and remove users, as well as manage their property roles and company associations.

---

1. Manage Users from a Property

When viewing or editing a specific property, there is typically a “Users” tab that displays all users assigned to that property. This view offers:

• Existing Users List: A table showing each user’s first name, last name, email, and the role they have on this property.
• Invite / Resend Invite: If a user has never logged in (meaning they were invited but haven’t activated their account), you can resend an invite.
• Delete User from Property: Removes the user’s role(s) for this property.
• Add New User: If you have permission (you are a property manager), you can add a brand-new user, with any role, and immediately assign them a role for this property. If you are a service provider, you can only add a crew member to the property. The crew members that you add will be automatically associated with your company.

No Bulk Actions Here

When managing users within a property, the interface is focused on that property alone:

• No checkboxes for selecting multiple users.
• Roles: You can update a user’s role directly in their form (if permitted).
• User Fields: When adding a users, you can associate him with an existing or new company. You can also populate his first and last name. After a user has been invited, onlt the user himself will be allowed to update his contact information or company.

The “Users” Tab Table (Property Context)

Column	Description
First Name / Last Name / Email	Basic user info. Clicking a row usually opens the User Form.
Roles	Shows the user’s current role(s) for this property (e.g., Manager, Cleaner, etc.).
Invite	If a user has never logged in, you’ll see a “Resend Invite” button to prompt them again to activate their account.
Delete	Removes the user’s association with this property (and any roles they have on it).

Below the table, there is usually a button labeled Add New User, allowing you to create a new user and assign them to the property right away.

---

2. Manage Users from the Main “Users Management” Page

Access this page via the main menu or a dedicated “Users” link. You’ll see two tabs (though the second one only appears if you have a company):

1. Users Property Roles
2. Company Employees (only visible if you belong to a company)

A. Users Property Roles Tab

This tab displays a table of all users you have permission to view, regardless of property. Key features:

Column	Description
Select	Checkboxes allow you to select multiple users for bulk actions.
First Name / Last Name / Email	Basic user info. No single-click editing here, but you can still open a form if provided in your setup.
Active	Indicates if the user has activated their account (logged in at least once).
Roles	Shows a comma-separated list of roles across properties for that user.
Properties	If a user has roles in multiple properties, this column shows which properties they’re associated with.

Bulk Actions

At the bottom of this table, you’ll find buttons for:

• Add Roles: Assign a specified role(s) to all selected users (across specific properties you choose).
• Remove Roles: Remove selected roles from all chosen users.
• Resend Invite: For users who haven’t activated their accounts yet, you can re-send the invite email in bulk.
• Delete: Removes selected users’ roles from all properties (and potentially deletes the user entirely, depending on your system’s logic).

These bulk actions simplify large-scale user management, such as onboarding a batch of new employees or removing a group of users from certain roles.

B. Company Employees Tab

This second tab is visible only if your user profile (the user currently logged in) has an associated company. Here you can:

• View all employees in your company (each employee is also a user in the system).
• Invite new users to join your company. This might be separate from property roles.
• Remove employees from your company (they might still remain in the system if they have roles in other properties, but they’ll no longer be tied to your company).

Note: The company you see listed in the tab name (e.g., “XYZ Cleaning Co. Employees”) is derived from your own user profile. If you don’t have a company, this tab remains disabled.

---

The User Form

Both the property-level and main “Users Management” views make use of a User Form (often loaded dynamically via HTMX). Depending on the context, this form may include:

1. First Name / Last Name / Email

   • Basic user info. Required to invite or update a user.

2. Roles (if in a property context)

   • A dropdown or multi-select that lets you assign roles specific to that property.
   • If the form is loaded without a property, you may see a roles section that manages global or multi-property roles, depending on your setup.

3. Company

   • If editing an existing user, and your system supports company affiliations, you’ll see a dropdown to select or create a new company.
   • Selecting “New” can open a separate form to register a new company and tie the user to it.

4. Buttons: Save / Cancel

   • Save: Commits your changes. If you’re adding a new user, it will send them an invitation email (unless configured otherwise).
   • Cancel: Closes the form without saving.

In a property context, you’ll typically see a simplified roles field (e.g., a single select if your logic only allows one role per property). In the main user management context, you might see no roles field at all, relying instead on the bulk actions or a specialized roles form to assign them.

---

Inviting Users

• Automatic Invitation: When you create a brand-new user (via “Add New User”), the system usually sends an invite email with a link to set their password.
• Resend Invite: For users who have never logged in, you can click Resend Invite. This will trigger another email with a fresh activation link.
• Never Logged In Indicator: Often, the system checks if a user has an activated status. If not, it displays an action to resend.

---

Summary of Workflows

1. Add a User to a Property

   • Go to the property’s “Users” tab.
   • Click Add New User, fill out the form (name, email, role, etc.).
   • Save to send an invitation.

2. Bulk Manage Roles (multiple users, multiple properties)

   • Go to the Users Management page → Users Property Roles tab.
   • Select users with the checkboxes.
   • Click Add Roles or Remove Roles, choose the appropriate roles/properties.
   • Save to apply changes in bulk.

3. Resend Invites in Bulk

   • Go to the Users Property Roles tab.
   • Check all users who haven’t logged in.
   • Click Resend Invite.

4. Remove a User from a Property

   • From the property’s “Users” tab, click Delete next to the user, or
   • From the Users Management page (bulk remove roles).

5. Manage Company Employees

   • If you have a company, open Users Management → Company Employees tab.
   • Invite new employees or remove existing ones.
   • This manages their company relationship, which may be separate from their property roles.

---

Where to Go Next

• To manage property details (including user roles, tasks, etc.), see the Property Management documentation.