Chameleon

User Management

Manage user accounts and credits in the admin system

User Management

The user management system allows administrators to view, search, and manage all registered users in the Chameleon AI SaaS platform.

Overview

The user management interface provides comprehensive tools for administrators to monitor user activity, manage user credits, and maintain user accounts. This feature is essential for customer support, account management, and system administration.

Key Features

User List View

The user management page displays all registered users with:

  • User Avatar: Profile picture or default avatar
  • User Information: Nickname, email address, and UUID
  • Current Credits: Real-time credit balance display
  • Registration Date: When the user joined the system
  • Actions: Credit management options

Search and Filter

  • Search Functionality: Search by email, nickname, or UUID
  • Real-time Filtering: Instant results as you type
  • Comprehensive Search: Covers all user identification fields

Credit Management

  • Credit Overview: View user's current credit balance
  • Credit Adjustment: Add or subtract credits from user accounts
  • Credit History: Track credit transactions and usage
  • Bulk Operations: Manage multiple users efficiently

User Information Display

User Details

Each user entry shows:

  • Avatar: User's profile picture or placeholder
  • Nickname: Display name (shows "未设置昵称" if not set)
  • Email: Primary email address
  • UUID: Unique user identifier (truncated for display)
  • Credit Balance: Current available credits
  • Registration Date: Account creation timestamp

Status Indicators

  • Active Users: All registered users are displayed
  • Credit Status: Real-time credit balance updates
  • Account Status: User account state and permissions

Credit Management Features

Credit Overview Component

  • Compact Display: Shows credit balance in user list
  • Real-time Updates: Automatically refreshes credit information
  • Visual Indicators: Clear credit status representation

Credit Manager

  • Add Credits: Increase user's credit balance
  • Subtract Credits: Decrease user's credit balance
  • Credit History: View all credit transactions
  • Transaction Logging: Track all credit modifications

Common Tasks

View All Users

  1. Navigate to /admin/users
  2. View the complete user list
  3. Use search to find specific users
  4. Check user registration trends

Search for a User

  1. Use the search box at the top
  2. Enter email, nickname, or UUID
  3. View filtered results instantly
  4. Clear search to see all users again

Manage User Credits

  1. Find the user in the list
  2. Click "积分管理" (Credit Management) button
  3. View current credit balance
  4. Add or subtract credits as needed
  5. Save changes and confirm

Monitor User Activity

  1. Check registration dates
  2. Review credit usage patterns
  3. Identify active vs inactive users
  4. Track user engagement metrics

User Data Management

User Information

  • Email Address: Primary contact and login identifier
  • Nickname: User's display name
  • Avatar: Profile picture URL
  • UUID: Unique system identifier
  • Registration Date: Account creation timestamp

Credit Information

  • Current Balance: Available credits for AI generation
  • Total Credits: Lifetime credit accumulation
  • Expired Credits: Credits that have expired
  • Transaction History: All credit-related activities

Security and Access

Admin Permissions

  • View Access: All admin users can view user list
  • Credit Management: Full access to credit operations
  • User Data: Complete user information access
  • Search Capabilities: Full search functionality

Data Protection

  • Secure Display: Sensitive information is protected
  • Access Logging: All admin actions are tracked
  • Permission Checks: Real-time verification of admin status

Troubleshooting

Users Not Loading

Problem: User list shows loading state or is empty

Solution:

  1. Check internet connection
  2. Refresh the page
  3. Verify admin permissions
  4. Check database connection

Search Not Working

Problem: Search functionality not returning results

Solution:

  1. Clear search terms and try again
  2. Check for typos in search query
  3. Try different search terms
  4. Refresh the page if needed

Credit Management Issues

Problem: Cannot modify user credits

Solution:

  1. Verify admin permissions
  2. Check if user exists in system
  3. Ensure valid credit amounts
  4. Try refreshing the page

Best Practices

User Support

  • Quick Search: Use search to quickly find user accounts
  • Credit Adjustments: Document reasons for credit changes
  • Regular Monitoring: Check user activity regularly
  • Responsive Support: Address user issues promptly

Data Management

  • Regular Backups: Ensure user data is backed up
  • Privacy Protection: Handle user data responsibly
  • Access Control: Limit admin access appropriately
  • Audit Trail: Keep records of all admin actions

Next Steps