Admin Guide Overview¶

!!! info "TL;DR" The Admin Dashboard gives product teams full control over feedback, surveys, team management, and settings. Triage submissions, push to GitHub, analyze trends, and configure automation—all from one interface.

What Can Product Teams Do?¶

The Admin Dashboard is the command center for managing user feedback and surveys. Admins can:

• Triage Submissions — Review, categorize, and change status of user feedback
• Moderate Content — Detect and remove spam, merge duplicates, handle abuse reports
• Manage Surveys — Create, publish, analyze, and close surveys
• Push to GitHub — Convert feedback into GitHub issues with two-way sync
• Analyze Trends — View metrics, sentiment analysis, and response trends
• Manage Team — Invite members, assign roles, enforce MFA
• Configure Settings — Customize branding, domains, notifications, and integrations

Admin Dashboard Layout¶

Navigate to /admin to access the dashboard. The layout includes:

• Sidebar Navigation — Quick links to dashboard, triage, surveys, settings
• Metrics Summary — Key stats (submissions, votes, active users, survey responses)
• Triage Queue — Unreviewed submissions and flagged content
• Recent Activity — Latest comments, votes, and status changes
• Quick Actions — Bulk approve/reject, create survey, export data

Who Can Access the Admin Dashboard?¶

Access is controlled by the team_members table. Users must be explicitly invited and assigned a role:

MFA (multi-factor authentication) is required for Owner and Admin roles to comply with SOC 2 security controls.

Key Features¶

Triage Queue¶

The triage queue surfaces submissions that need review:

• New Submissions — Recently submitted feedback awaiting initial review
• Flagged Content — User-reported spam or abuse
• High-Vote Items — Popular submissions that may warrant prioritization
• Duplicate Candidates — Submissions similar to existing items

See Triage & Moderation for detailed workflows.

Bulk Actions¶

Select multiple submissions and perform bulk operations:

• Change Status — Move items to Planned, In Progress, Shipped, etc.
• Assign Category — Bulk categorize submissions
• Merge Duplicates — Combine multiple submissions into one
• Delete — Remove spam or inappropriate content

GitHub Integration¶

Convert feedback into GitHub issues with one click:

• Push to GitHub — Create an issue with title, description, and labels
• Two-Way Sync — Status changes in GitHub automatically update Canviq
• Webhook Receiver — Listen for GitHub issue status changes

See GitHub Integration for setup instructions.

Analytics Dashboard¶

View product-level metrics:

• Submission Trends — Daily/weekly/monthly submission volume
• Vote Distribution — Most-voted submissions and voting trends
• Status Breakdown — Count of submissions in each status
• User Engagement — Active users, returning voters, comment activity
• Sentiment Analysis — Aggregate sentiment across all feedback

Filters let you slice data by date range, category, status, or user segment.

Survey Management¶

Create, publish, and analyze surveys from the Admin Dashboard:

• Survey Builder — Drag-and-drop question editor
• Distribution — Configure SDK, email, or link distribution
• Analytics — View response rates, sentiment, and themes
• Export — Download survey data as CSV or JSON

See the Surveys section for detailed survey guides.

Navigation Map¶

Common Workflows¶

Reviewing New Submissions¶

1. Navigate to Admin → Triage Queue
2. Select a submission from the list
3. Review content for spam, duplicates, or inappropriate content
4. Change status (e.g., Open → Under Review)
5. Assign category and tags
6. Optionally post an official comment

Pushing Feedback to GitHub¶

1. Navigate to Admin → Submissions
2. Select a submission
3. Click Push to GitHub
4. Confirm issue title, description, and labels
5. Submit — issue is created and linked

Analyzing Feedback Trends¶

1. Navigate to Admin → Analytics
2. Select date range (e.g., Last 30 Days)
3. Filter by category or status
4. View submission trends, vote distribution, and sentiment breakdown
5. Export data for deeper analysis

Creating a Survey¶

1. Navigate to Admin → Surveys → Create Survey
2. Add questions and configure logic
3. Set distribution channels (SDK, email, link)
4. Publish survey
5. Monitor analytics as responses come in

Security Best Practices¶

• Enable MFA — Enforce two-factor authentication for all Admins and Owners
• Audit Logs — Review the audit log regularly for suspicious activity (Admin → Settings → Audit Log)
• API Key Rotation — Rotate API keys quarterly (Admin → Settings → API Keys)
• Least Privilege — Assign the minimum role required for each team member
• Review Team Access — Remove inactive members promptly

All admin actions are logged to the audit_log table for compliance and forensics.

What's Next¶

• Admin Dashboard — Understand the dashboard layout and metrics
• Triage & Moderation — Review and moderate submissions
• GitHub Integration — Push feedback to GitHub issues
• Team Management — Invite team members and assign roles