Build User and Role Management Interface

[yusuftomilola]

Description

Create an administrative interface for managing users, roles, and permissions with a visual permission matrix and team organization.

Requirements

User Management:

• User list table (Name, Email, Role, Department, Status, Last Active)
• Add/Invite user form (sends invitation email)
• Edit user details and role assignment
• Activate/Deactivate user accounts
• Reset user password (sends reset email)
• View user activity log
• Assign users to departments/teams

Role Management:

• Predefined roles: Super Admin, Admin, Manager, User, Viewer
• Create custom roles
• Visual permission matrix showing all permissions
• Permission categories: Assets (View, Create, Edit, Delete), Departments (Manage), Reports (Generate, Schedule), Users (Manage), Settings (Configure)
• Clone existing role to create new one
• Archive unused roles

Permission Matrix:

• Grid layout showing roles (columns) vs permissions (rows)
• Checkbox for each role-permission combination
• Color-coded cells (green = granted, red = denied)
• Bulk permission updates
• Permission inheritance visualization

Team Organization:

• Create teams/groups
• Assign users to teams
• Set team leaders
• Team-based asset access control
• Team activity dashboard

Technical Specifications

• Use React Table for user list
• Implement role-based access control (RBAC) context
• Add permission checks throughout the app
• Use react-hook-form for user forms
• Implement email validation and duplicate checks
• Add user search and filtering
• Show permission conflicts or inheritance issues
• Implement audit logging for all user/role changes

Acceptance Criteria

• Admins can create, edit, and deactivate users
• Role creation and editing works correctly
• Permission matrix updates correctly
• Users receive invitation emails
• Permission changes take effect immediately
• Cannot delete role that's assigned to users
• User activity logs are accurate
• Interface prevents accidental permission removal for critical roles

API Endpoints

• GET /api/users - List users
• POST /api/users - Create user (send invitation)
• PUT /api/users/:id - Update user
• DELETE /api/users/:id - Deactivate user
• GET /api/roles - List roles
• POST /api/roles - Create role
• PUT /api/roles/:id - Update role
• GET /api/permissions - List all permissions

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Ibinola]

@Ibinola has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hey! I’ve worked on this repo before in a previous open-source project and I’d love to jump on this. Can I take it?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Ibinola to this issue.

[drips-wave]

Congratulations, @Ibinola! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @Ibinola: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

⚠️ Important: When opening a PR, please link it to this issue to ensure it gets tracked accurately.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @Ibinola as part of the Stellar Wave Program's 1st Wave 🥳

😎 @Ibinola: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? If you like, you can reward them with additional points by making a compliment within seven days after the Wave Program's current wave ends.