Repository navigation
Administrator Guide
AutoBot Solutions edited this page May 13, 2026
·
2 revisions
Complete guide for administrators managing the AutoBot Solutions Forum.
- Admin account with
is_admin=True - Created by
init_db.pyscript - Or promoted by existing admin
- Login with admin credentials
- Click "Admin" in navbar
- Access dashboard and management tools
- Total users
- Total posts
- Total comments
- Total repositories
- Total categories
- Total badges
- Last 5 users registered
- Last 5 posts created
- Quick access to management
- Navigate to "Users" in admin panel
- View all users with metadata
- See user statistics
- View user badges
Toggle Admin Status
- Promote or demote users to admin
- Immediate effect on permissions
- Use with caution
Delete User
- Removes user account
- Cascades to all user data
- Posts, comments, votes deleted
- Cannot be undone
Manage Badges
- Add badge to user
- Remove badge from user
- View user's current badges
- Review new users regularly
- Promote trusted users to admin
- Delete spam accounts promptly
- Keep admin count minimal
- Document admin actions
View Posts
- Navigate to "Posts" in admin panel
- View all posts with metadata
- See vote counts
- View author information
Delete Post
- Removes post from forum
- Deletes all comments
- Removes votes
- Cannot be undone
When to Delete Posts
- Spam or promotional content
- Offensive or harmful content
- Duplicate posts
- Off-topic posts
- Violates community guidelines
View Comments
- Navigate to "Comments" in admin panel
- View all comments with metadata
- See parent post
- View vote counts
Delete Comment
- Removes comment
- Removes votes
- Removes notifications
- Cannot be undone
When to Delete Comments
- Spam or trolling
- Offensive language
- Personal attacks
- Off-topic comments
- Violates community guidelines
- Navigate to "Repositories" in admin panel
- View all synced repositories
- See GitHub metadata
- View post counts
- Click "Sync" button
- Fetches from GitHub API
- Updates or creates records
- Updates stars and language
- Rate limited to 5/hour
- Removes repository from database
- Posts become unlinked
- Cannot be undone
- Use with caution
- Sync repositories regularly
- Monitor sync errors
- Keep repository list clean
- Delete unused repositories
- Document repository purposes
- Navigate to "Categories" in admin panel
- View all categories
- See category colors
- View post counts
- Click "Create Category"
- Enter category name
- Add description (optional)
- Choose color (hex)
- Click "Create Category"
- Removes category
- Posts become uncategorized
- Cannot be undone
- Posts need manual re-categorization
- Create meaningful categories
- Use distinct colors
- Keep category count manageable
- Delete unused categories
- Update category descriptions
- Navigate to "Badges" in admin panel
- View all badges
- See badge icons and colors
- View user counts
- Click "Create Badge"
- Enter badge name
- Add description
- Choose icon (emoji)
- Choose color (hex)
- Click "Create Badge"
- Removes badge
- Removes from all users
- Cannot be undone
- Use with caution
- Navigate to user management
- Click "Add Badge"
- Select badge from dropdown
- Badge immediately assigned
- Navigate to user management
- Click "Remove Badge"
- Badge immediately removed
- Can be reassigned later
- Create meaningful badges
- Use distinct icons
- Award badges fairly
- Document badge criteria
- Review badge assignments
- Use strong passwords
- Enable 2FA when available
- Don't share credentials
- Change passwords regularly
- Monitor failed login attempts
- Log out after admin tasks
- Use secure connections
- Don't use public computers
- Clear browser cache
- Monitor session duration
- Log all admin actions
- Track who did what and when
- Review logs regularly
- Export logs for analysis
- Review new user registrations
- Check for spam content
- Monitor rate limit violations
- Review reported content
- Sync repositories
- Update categories and badges
- Monitor database performance
- Check response times
- Monitor disk space
- Review error logs
- Check rate limit usage
- Be fair and consistent
- Document your actions
- Communicate with users
- Follow community guidelines
- Stay updated on features
- Act promptly on reports
- Be objective
- Provide feedback when appropriate
- Consider appeals
- Document decisions
- Promote users carefully
- Document admin promotions
- Review admin activity
- Keep admin count minimal
- Rotate admin passwords
- Verify account has admin flag
- Check authentication status
- Ensure session is valid
- Contact system admin
- Problem: No management options visible on user management page
- Cause: Only one admin user exists in database
- Solution: Create test users to demonstrate functionality
- Note: Template prevents self-management for security
- Fix: Use test user creation script to add sample users
-
Script Location:
create_test_users.pyin project root
- Check CSRF token
- Verify database connection
- Check for JavaScript errors
- Refresh the page
- Try different browser
- Check database queries
- Verify data integrity
- Restart application
- Clear cache
- Check Security-System.md
- Review Architecture-System.md
- Contact system admin for technical issues
- Report bugs via GitHub issues