Admin Guide

Welcome to the BookWish Admin Guide. This documentation is intended for platform administrators who manage the BookWish ecosystem.

Overview

As a BookWish administrator, you have elevated permissions to moderate content, manage users, and maintain the platform's health and safety. Admin access is granted through the admin user tier, which provides access to specialized admin-only API endpoints and tools.

What You Can Do

Content Moderation

• Review and action user reports for inappropriate content
• Hide or unhide lines and reviews
• Monitor community guidelines compliance
• Track moderation metrics and trends

User Management

• View and manage user accounts across all tiers
• Handle user suspensions and account issues
• Manage user roles and permissions
• Monitor user activity and engagement

Platform Health

• Monitor system metrics and performance
• Review platform usage statistics
• Track user growth and retention
• Identify and address platform issues

Access Requirements

Admin functionality requires:

• User account with tier: 'admin' in the database
• Valid authentication token
• Routes protected by requireAdmin middleware

All admin routes are prefixed with /admin/ and require both authentication and admin tier verification.

Key Capabilities

Area	Capabilities
Content	Hide/unhide lines and reviews, review reported content
Users	View all users, manage accounts, handle reports
Reports	List all reports, filter by status, review and action reports
Moderation	Set content moderation status, manage community safety

Getting Started

1. Dashboard - Access metrics, alerts, and recent activity
2. Moderation - Review reports and manage content
3. Users - Search and manage user accounts
4. System - Access support tools and platform settings

API Authentication

Admin endpoints require the standard Bearer token authentication with an admin-tier user:

Authorization: Bearer <admin_user_token>

The requireAdmin middleware verifies:

1. Valid authentication token
2. User tier equals 'admin'

Non-admin users receive a 403 Forbidden response when attempting to access admin routes.

Report Types

Administrators can review reports for:

• Lines - User-shared book quotes/passages
• Reviews - Book reviews
• Users - User profile/behavior reports

Report Reasons

Users can report content for:

• spam - Unwanted promotional or repetitive content
• harassment - Bullying or targeted harassment
• hate_speech - Hateful or discriminatory content
• misinformation - False or misleading information
• inappropriate - Content violating community guidelines
• other - Issues not covered by other categories

Report Statuses

• pending - New report awaiting review
• reviewed - Report reviewed, no action needed
• action_taken - Report reviewed, action taken (content hidden, user warned, etc.)
• dismissed - Report reviewed and dismissed as invalid

User Tiers

BookWish uses a tier system for user permissions:

• guest - Anonymous/temporary users
• free - Basic registered users
• premium - Paid subscribers with enhanced features
• bookstore - Store owner accounts
• admin - Platform administrators

Only admin tier users can access admin endpoints.