Administration Guide
Manage users, approve content, configure global subreddits, and maintain system settings. This section is for Operators and Admins only.
Access Required: The features in this guide require Operator or Admin role. Creators do not have access to these pages.
Content Approvals
Review and approve media and caption templates submitted by creators.
Approval Tabs
Media Approvals
Review uploaded images. See thumbnails and approve or reject with notes.
Caption Approvals
Review caption templates submitted for approval.
Approval Actions
| Action | Effect |
|---|---|
| Approve | Content can be used in scheduled posts |
| Reject | Content is marked rejected with notes explaining why |
Best Practices
- Review the approval queue daily to avoid backlogs
- Provide clear rejection notes so creators can improve
- Check for quality issues, policy violations, or duplicates
- Prioritize time-sensitive content
Tip: The pending count on the dashboard helps you stay on top of the approval queue. Address items promptly to keep creators productive.
User Management
Create and manage user accounts. Assign roles and reset passwords.
Creating Users
-
Click "New User"
Open the user creation form. -
Enter Email
This will be the login username. -
Set Password
Minimum 8 characters. Share securely with the user. -
Assign Role
Choose Creator, Operator, or Admin. -
Set Display Name
The name shown in the interface. -
Save
A creator profile is automatically created for creator roles.
User Roles
| Role | Capabilities |
|---|---|
| Creator | Upload media, schedule posts, view personal analytics |
| Operator | All Creator + approve content, manage subreddits, view all data |
| Admin | All Operator + manage users, system configuration |
User Actions
- Edit - Update email, display name, or role
- Reset Password - Set a new password for the user
- Delete - Remove the user (use with caution)
Warning: Deleting a user may affect associated content and scheduled posts. Consider deactivating instead if possible.
Global Subreddit Configuration
Configure subreddits that are available to all creators in the system.
Subreddit Settings
| Setting | Description |
|---|---|
| Name | Subreddit name (without r/ prefix) |
| NSFW | Whether NSFW content is allowed |
| Verification Required | If subreddit requires verified posters |
| Links Allowed | Whether external links are permitted |
| Nudity Allowed | Level of explicit content permitted |
| Minimum Karma | Required karma to post |
| Post Frequency | How often posting is allowed |
| Notes | Additional guidelines for creators |
| Active | Whether creators can see and use this subreddit |
Global vs Personal Subreddits
- Global - Configured by admin, visible to all creators
- Personal - Created by individual creators for their own use
Note: Global subreddits should be well-researched. Include accurate posting rules to help creators avoid bans.
Explore Notices
Create dismissible tips and notices shown to users on the Explore page. Use these for onboarding tips, announcements, or feature highlights.
Notice Settings
- Title - Short headline for the notice
- Content - Full message text
- Order - Display priority (lower = shown first)
- Pinned - Whether to highlight the notice
Multi-Creator Management
As an Operator or Admin, you can view and manage data for any creator.
Masquerade Feature
View the system as if you were logged in as a specific creator:
- See their media library
- View their scheduled posts
- Check their analytics
- Review their campaigns
Important: When masquerading, actions you take will affect that creator's account. A banner indicates whose data you're viewing.
Aggregate Views
Some pages offer aggregate views showing data across all creators:
- Analytics - Combined performance metrics
- Photo Analytics - Equipment usage across all photos
- Intelligence - Tag performance across all content
System Maintenance
Background tasks handle system maintenance automatically:
| Task | Schedule | Purpose |
|---|---|---|
| Scheduler Tick | Every 60 seconds | Process pending scheduled posts |
| Metrics Collection | Hourly | Gather post performance data |
| Weekly Reports | Monday 9 AM UTC | Generate weekly reports |
| Token Cleanup | Daily at 2 AM UTC | Remove expired JWT tokens |
Security Best Practices
For Production Deployment
- Change all default credentials (admin@domain.local, etc.)
- Set strong JWT_SECRET in environment variables
- Use HTTPS for all connections
- Regularly audit user accounts
- Review approval queue for policy violations
- Monitor failed login attempts
- Keep dependencies updated
Critical: The default development credentials
(admin@domain.local / admin123) must be changed
before production deployment. Remove the seed_default_users function in production.
Getting Help
If you encounter issues or need assistance:
- Check the system logs in Docker:
docker-compose logs -f backend - Review Celery worker logs:
docker-compose logs -f worker - Check ML service status:
curl localhost:8001/health - Report issues on GitHub
Summary
You've completed the onboarding guide! Here's a quick reference: