Admin & Role Management

Role Required: SUPER_ADMIN / TNCHS_ADMIN
Navigation: Sidebar → Users
Last Updated: March 2026 | Portal Version: 1.0

Overview

You manage all admin roles across the platform. This includes assigning users as Society Admins, Regional Admins, State Admins, and Accountants. Each role is scoped to a specific entity (society, region, or platform-wide).

Role Reference

Role	Scope	What They Can Do
SUPER_ADMIN	Platform-wide	Everything — full platform control
TNCHS_ADMIN	Platform-wide	Same as Super Admin (TNCHS designation)
STATE_ADMIN	State-wide	View all regions, cross-region reports and analytics
REGIONAL_ADMIN	One region	Oversee societies in their region, regional reports
SOCIETY_ADMIN	One society	Manage layouts, plots, bookings, members, payments
ACCOUNTANT	One society	Financial operations within their assigned society
CITIZEN	Self	Book plots, make payments, view their own data

Viewing All Users

1. Navigate to Users
2. The list shows all platform users

User List Columns

Column	Description
Name	Full name
Email	Email address
Phone	Mobile number
Roles	All assigned roles (may have multiple)
Status	ACTIVE / PENDING / BLOCKED
Last Login	Last login timestamp
Created	Registration date

Filters

Filter	Options
Search	Name, email, or phone
Role	Filter by specific role
Status	Active / Pending / Blocked / All

Assigning a Role to a User

1. Navigate to Users → [Select the user]
2. Open their Role Assignments section
3. Click Add Role
4. Select the role:

Role-Specific Assignment

Role	Additional Field	Required
SOCIETY_ADMIN	Select the Society	✅
REGIONAL_ADMIN	Select the Region	✅
STATE_ADMIN	— (state-wide)	—
ACCOUNTANT	Select the Society	✅

5. Click Assign

What Happens After Assignment

• The user immediately gains access to the role's features
• Their sidebar navigation updates to show role-appropriate sections
• They can switch between roles if they have multiple
• The assignment is logged in the audit trail

User Role Details

Each role assignment shows:

Field	Description
Role Code	SOCIETY_ADMIN, REGIONAL_ADMIN, etc.
Role Name	Display name
Society	(For society-scoped roles) Assigned society name
Region	(For region-scoped roles) Assigned region name
Is Primary	Whether this is the user's primary role
Assigned At	When the role was assigned

Removing a Role

1. Navigate to the user's detail
2. Find the role assignment to remove
3. Click Remove Role
4. Confirm the action
5. The user immediately loses access to that role's features

Managing User Status

1. Navigate to Users → [Select user]
2. Click Change Status:

Action	New Status	Effect
Activate	ACTIVE	User can log in and operate
Block	BLOCKED	User cannot log in — all sessions terminated

Blocking an Admin

Blocking a Society Admin means the society has no one to process bookings, payments, or approvals. Ensure a replacement admin is assigned before blocking.

Creating a New Admin User

You can create admin users directly from the platform:

1. Navigate to Users → Create Admin User
2. Fill in the required details:
   • Full name, email, phone number
   • Select the role (SOCIETY_ADMIN, REGIONAL_ADMIN, STATE_ADMIN, ACCOUNTANT)
   • For society-scoped roles: select the society
   • For regional-scoped roles: select the region
3. Click Create
4. The system creates the user account with a generated password
5. The new admin receives an email with their login credentials
6. They can change their password on first login

tip

Alternatively, if the person already has an HOCO RCS (H) account (e.g., they registered as a citizen), you can find them in Users by searching their email or phone and assign the admin role directly.

Multi-Role Users

A user can hold multiple roles simultaneously:

• e.g., SOCIETY_ADMIN for Society A + SOCIETY_ADMIN for Society B
• e.g., REGIONAL_ADMIN for Region X + SOCIETY_ADMIN for Society within Region X

The user can switch between roles in the portal to access different dashboards and features.

Common Scenarios

"A Society Admin is on leave — how do I assign a temporary replacement?"

1. Find or register the replacement user
2. Assign them the SOCIETY_ADMIN role for the same society
3. Both admins can now operate on the society
4. When the original admin returns, remove the temporary assignment

"I need to promote a Society Admin to Regional Admin"

1. Navigate to the user's detail
2. Add the REGIONAL_ADMIN role with the target Region
3. Optionally remove their SOCIETY_ADMIN role if they're moving up
4. They now see the Regional Admin dashboard

"A user was registered with the wrong email"

User email changes are handled through the user management interface or support tools. Navigate to the user detail and update their email if the interface allows, or use the database management tools for corrections.

"How many admins can a society have?"

There is no hard limit. You can assign multiple SOCIETY_ADMIN users to the same society. This is useful for:

• Larger societies with multiple staff
• Enabling Maker-Checker workflows (different admins for recording and verifying)
• Backup coverage during absences

Related Pages

• Society Management — Creating societies and assigning initial admins
• User Management — Broader user management operations
• Region Management — Creating regions for regional admin assignment