[Backoffice] Dashboard / Entry page
Overview
The admin backoffice dashboard is where administrators view and manage all text-to-audio requests. Admins can see pending requests, update statuses, and upload audio files.
Access: Admin login required (separate credentials from users)
Purpose: Central hub for manual request processing
Key Actions:
- View all requests (pending, processing, done)
- Filter and search requests
- Access individual request details
Live Preview
🎙️
MicDots Admin
Request Management System
Request Management
View and process text-to-audio requests
Page 1 of 3
API Endpoints
This page uses the following API endpoints:
Get All Submissions (Admin)
Endpoint: GET /api/v1/text-to-speech
Description: Retrieves all text-to-speech submissions with pagination, filtering, and sorting. Admins see all submissions from all users. Clients automatically see only their own submissions.
Query Parameters:
- page: number, optional. Page number (default: 1)
- size: number, optional. Items per page (default: 10, max: 100)
- status: string, optional. Filter by status: "pending", "processing", "done"
- search: string, optional. Search by request ID, text content, or user email
- sortBy: string, optional. Sort field: "createdAt", "status" (default: "createdAt")
- sortOrder: string, optional. "asc" or "desc" (default: "desc")
Role Required: admin role
Page Elements
Content Header Section
- Page Title: "Request Management"
- Subtitle: Clear purpose statement
- Context: Displayed in main content area
Filters and Search
Filter Options:
- Status Dropdown: Filter by pending/processing/done/all
- Search Bar: Search by request ID, user email, or text content
- Refresh Button: Reload latest data
Requests Table
Columns:
- Request ID: Unique identifier (e.g., REQ-001234)
- User: Email address of requester
- Text Preview: First 20 characters + "..."
- Voice: Selected voice model name
- Status: Badge showing current status
- Created: Time since creation
Status Badges:
- Pending: Orange badge
- Processing: Blue badge
- Done: Green badge
Row Behavior:
- Clickable rows: Click anywhere on row to view details
- Hover effect: Background changes on hover
- Shows most recent requests first
Pagination
Controls:
- Current page indicator (e.g., "Page 1 of 3")
- Previous/Next buttons
- Shows "X of Y requests" count
Admin Actions
Primary Actions
- Click Request Row - View detailed request page
- Filter by Status - Show only specific status types
- Search Requests - Find specific requests
- Refresh Data - Get latest updates
Secondary Actions
- Logout - End admin session
- Navigate Pages - Browse through request pages
User Flow
Entry: Admin logs in at landing page
Dashboard View:
- Admin views request list
- Admin can filter/search as needed
- Admin clicks on a request row
- Admin navigated to Request Details Page
Next Page: Admin Request Details
Access Control
Required: Admin authentication
Permissions:
- View all requests (any user)
- View request details
- Update request status
- Upload audio files
Not Allowed:
- Delete requests (manual database operation only)
- Edit user information
- View user passwords
Success Criteria
- ✅ Admin can view all requests
- ✅ Filters work correctly
- ✅ Pagination works correctly
- ✅ Clicking request rows navigates to details page
- ✅ Hover effects work on table rows
- ✅ Performance is good (< 2 second load)
Related Documentation
- User Flow - Complete workflow
- Admin Request Details - Next page in flow
- Request Management API - Backend API
- Authentication - Admin login