Administrator Role Overview
As a Master Administrator, you have complete control over the Cabina platform. Your dashboard provides oversight and management of:- 🤝 Partners (resellers/agencies)
- 👤 End Users (B2C customers)
- ✨ AI Style Management
- 📊 Platform Analytics
- 🔧 System Settings
- 📖 Activity Logs
Accessing the Admin Dashboard
Dashboard Navigation
Main View Tabs
- Overview
- Partners
- B2C
- Styles
- Logs
- Settings
Purpose: Platform health and key metricsKey Elements:
- System Pulse: Real-time system status indicator (pulsing green circle)
- Platform Stats: Total partners, users, generations, revenue
- Recent Activity: Latest logs and events
- Quick Actions: Create partner, add user, manage styles
Overview Section Breakdown
System Pulse Indicator
Located at the top of the overview:- Green Pulsing Circle: System operational
- Yellow: Warning state (check logs)
- Red: Critical issue (immediate action needed)
- API response times
- Database connection status
- Storage availability
- AI service status
Platform Statistics
Four main stat cards display:- Total Partners
- Total Events (Network)
- Credits in Channels
- Consumption Ratio
- Number: Count of active partners
- Icon: Handshake
- Purpose: Track reseller network growth
- Action: Click to go to Partners tab
B2C Statistics (if B2C is enabled)
- Total B2C Users: End user count
- Active Users (30d): Users with generations in last 30 days
- Revenue This Month: Credit purchases from end users
- Avg Credits Per User: Spending patterns
Recent Activity Logs
Scrollable list of recent platform events:- User Creation: New accounts
- Credit Purchases: Payment transactions
- Partner Approvals: New partner activations
- Generation Milestones: High-volume events
- System Errors: Failed operations
- Timestamp (relative, e.g., “5 minutes ago”)
- Action type (color-coded badge)
- Actor (user/partner email)
- Description
Quick Actions
From the Overview, you can:- “New Reseller” Button: Open partner creation modal
- “Add User” Button: Manually create B2C user
- “Manage Styles” Button: Jump to Styles tab
- “View All Logs” Button: Navigate to Logs tab
Common Administrator Tasks
Daily Operations
Morning Check:- View Overview tab
- Check System Pulse (green?)
- Review overnight activity logs
- Respond to any errors or warnings
- Approve pending partner applications (Partners tab)
- Handle support tickets (credit adjustments, account issues)
- Monitor generation volume (Analytics section)
- Review daily stats
- Check for failed payments or errors
- Plan partner outreach based on usage patterns
Weekly Operations
- Review Partner Performance: Identify high/low performers
- Analyze Style Popularity: Adjust style availability
- Credit Reconciliation: Ensure financial accuracy
- User Growth Analysis: Track B2C adoption
Monthly Operations
- Revenue Reporting: Export transaction logs
- Partner Check-ins: Reach out to partners
- Style Catalog Review: Add new styles, retire underperformers
- System Maintenance: Updates, backups, security patches
Dashboard Customization
Future Feature: Dashboard widgets and custom views are planned. Currently, the layout is fixed.
Keyboard Shortcuts
No specific shortcuts configured, but standard browser shortcuts work:- Ctrl/Cmd + R: Refresh dashboard
- Ctrl/Cmd + F: Search within tables
- Esc: Close modals
Performance Monitoring
Key Metrics to Watch
Engagement:- Generations per day (trending up?)
- Active partners/users ratio
- Average generations per event
- Credits sold vs. consumed
- Revenue growth month-over-month
- Partner churn rate
- API response times (System Pulse)
- Error rates in logs
- Storage usage
Setting Up Alerts
Contact Support: To configure email/SMS alerts for critical events (system down, low storage, high error rates), contact platform support or development team.
Troubleshooting Common Issues
System Pulse shows yellow/red
System Pulse shows yellow/red
Immediate Actions:
- Click SystemPulse for details
- Check Logs tab for errors
- Verify database connectivity
- Check AI service status (Replicate API)
- If persistent, contact development team
Stats not updating
Stats not updating
Solutions:
- Refresh browser (Ctrl+R)
- Clear cache and reload
- Check if background jobs are running (contact dev)
- Verify database queries (check logs)
Can't access certain sections
Can't access certain sections
Verify:
- Your account has
is_master: truein profiles table - Database permissions are correct
- Browser has no extensions blocking content
- Try incognito mode to rule out cache issues
Logs showing unusual activity
Logs showing unusual activity
Investigate:
- Filter logs by actor (user email)
- Look for patterns (time, action type)
- Check for automated bot activity
- Review partner account for compromise
- Change passwords if suspicious
Security Best Practices
Account Security
- 🔒 Use strong, unique password
- 🔒 Enable 2FA (if available)
- 🔒 Don’t share admin credentials
- 🔒 Log out when not in use
- 🔒 Use separate admin account (not personal)
Operational Security
- ⚠️ Always verify before deleting partners/users
- ⚠️ Document major changes in external log
- ⚠️ Double-check credit adjustments
- ⚠️ Test style changes in staging if possible
- ⚠️ Backup critical data before bulk operations
Audit Compliance
- 📝 Regularly review activity logs
- 📝 Export logs monthly for archival
- 📝 Investigate anomalies promptly
- 📝 Maintain documentation of admin actions
Best Practices Summary
Do:
- ✅ Check System Pulse daily
- ✅ Respond to partner applications within 24 hours
- ✅ Monitor logs for errors
- ✅ Keep style catalog up-to-date
- ✅ Communicate with partners proactively
- ✅ Document configuration changes
Don’t:
- ❌ Delete data without confirmation
- ❌ Ignore yellow/red system status
- ❌ Make bulk changes without testing
- ❌ Share admin credentials
- ❌ Skip log reviews
- ❌ Change settings without understanding impact
Next Steps
Manage Partners
Approve, edit, and oversee partner accounts
Platform Analytics
Deep-dive into usage metrics
Style Management
Create and manage AI identities