1e9e8712f9
- Fix search API to include bookId, verseId, and bookKey in response for proper navigation - Update Bible reader to handle both book ID and bookKey matching for robust navigation - Replace deprecated ListItem button prop with ListItemButton for Material-UI v5+ compatibility - Add fallback logic in search result navigation to handle missing book identifiers - Ensure "Go to" button takes users to exact verse with proper highlighting and scrolling 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
347 lines
8.1 KiB
Markdown
347 lines
8.1 KiB
Markdown
# BiblicalGuide Admin Dashboard - MVP Features
|
|
|
|
## 1. Dashboard Overview (Home)
|
|
|
|
### Key Metrics Cards
|
|
- **Total Users** (number + % change from last week)
|
|
- **Daily Active Users** (DAU - real-time count)
|
|
- **AI Conversations Today** (count + cost estimate)
|
|
- **Active Now** (users currently online)
|
|
|
|
### Quick Stats
|
|
- **New signups** (last 24 hours)
|
|
- **Total bookmarks created** (all-time)
|
|
- **Prayer requests** (last 24 hours)
|
|
- **Server status** (API health, response time)
|
|
|
|
### Activity Feed (Live)
|
|
- New user registrations
|
|
- Prayer wall posts
|
|
- High-engagement AI conversations
|
|
- Error alerts
|
|
- System notifications
|
|
|
|
## 2. User Management
|
|
|
|
### User List View
|
|
```
|
|
Search: [_________] Filter: [All Users ▼]
|
|
|
|
| Email | Name | Joined | Last Active | AI Chats | Status | Actions |
|
|
|-------|------|--------|-------------|----------|--------|---------|
|
|
| user@example.com | John D. | 2024-01-15 | 2 hrs ago | 45 | Active | [View] [Ban] |
|
|
```
|
|
|
|
### User Actions
|
|
- **View Profile** (see detailed user activity)
|
|
- **Send Email** (direct communication)
|
|
- **Reset Password** (force password reset)
|
|
- **Suspend/Ban** (temporary or permanent)
|
|
- **Delete Account** (GDPR compliance)
|
|
|
|
### User Details Modal
|
|
- Registration date and method
|
|
- Total AI conversations
|
|
- Bookmarks count
|
|
- Last 10 chat topics
|
|
- Prayer requests posted
|
|
- Account status history
|
|
|
|
## 3. AI Chat Monitoring
|
|
|
|
### Conversations Overview
|
|
- **Total conversations** (today/week/month)
|
|
- **Average response time** (target: <5 seconds)
|
|
- **Error rate** (failed responses %)
|
|
- **Cost tracking** (OpenAI API spend)
|
|
|
|
### Live Chat Monitor
|
|
```
|
|
Recent Conversations (Auto-refresh every 30s)
|
|
|
|
User: "What does the Bible say about forgiveness?"
|
|
AI: "The Bible speaks extensively about forgiveness..."
|
|
[View Full] [Flag] [Quality: ⭐⭐⭐⭐⭐]
|
|
|
|
User: "Help me understand Romans 8"
|
|
AI: "Romans 8 is one of the most powerful chapters..."
|
|
[View Full] [Flag] [Quality: ⭐⭐⭐⭐⭐]
|
|
```
|
|
|
|
### Quality Control
|
|
- **Flag inappropriate requests**
|
|
- **Review AI responses** for theological accuracy
|
|
- **Common questions** (FAQ generation)
|
|
- **Failed responses** log
|
|
- **Response ratings** (if users rate them)
|
|
|
|
### Cost Management
|
|
- Daily API usage ($X.XX)
|
|
- Projection for current month
|
|
- Per-user average cost
|
|
- High-usage user alerts
|
|
|
|
## 4. Content Moderation
|
|
|
|
### Prayer Wall Moderation
|
|
```
|
|
Pending Review (3)
|
|
|
|
"Please pray for my family..."
|
|
[Approve] [Edit] [Reject] [Ban User]
|
|
|
|
"Spam content here..."
|
|
[Approve] [Edit] [Reject] [Ban User]
|
|
```
|
|
|
|
### Moderation Queue
|
|
- **Prayer requests** (pending approval)
|
|
- **Reported content** (user flags)
|
|
- **AI conversation flags** (inappropriate)
|
|
- **Bulk actions** (approve/reject all)
|
|
|
|
### Auto-Moderation Settings
|
|
- Profanity filter (on/off)
|
|
- Spam detection threshold
|
|
- Auto-approve trusted users
|
|
- Keyword blacklist management
|
|
|
|
## 5. Analytics Dashboard
|
|
|
|
### User Analytics
|
|
- **Growth Chart** (daily new users - line graph)
|
|
- **Retention Funnel**
|
|
- Day 1: 100%
|
|
- Day 7: 45%
|
|
- Day 30: 30%
|
|
- **User Segments**
|
|
- Power users (>10 chats/week)
|
|
- Regular (3-10 chats/week)
|
|
- Casual (<3 chats/week)
|
|
- Dormant (no activity 7+ days)
|
|
|
|
### Engagement Metrics
|
|
- **Most Read Bible Books** (top 10 bar chart)
|
|
- **Popular Chat Topics** (word cloud)
|
|
- **Peak Usage Hours** (heatmap)
|
|
- **Feature Usage** (bookmarks vs chat vs prayer wall)
|
|
|
|
### Simple Conversion Tracking
|
|
- Sign-up to first chat
|
|
- First chat to bookmark
|
|
- Single to returning user
|
|
- Free to premium (when implemented)
|
|
|
|
## 6. System Administration
|
|
|
|
### Quick Actions
|
|
- **Broadcast Message** (banner to all users)
|
|
- **Maintenance Mode** (on/off toggle)
|
|
- **Clear Cache** (Redis flush)
|
|
- **Backup Database** (manual trigger)
|
|
|
|
### API Management
|
|
- **OpenAI API Status**
|
|
- Current balance
|
|
- Rate limit status
|
|
- Error rate
|
|
- Switch API keys
|
|
- **Bible API Status**
|
|
- Response time
|
|
- Cache hit rate
|
|
- Error logs
|
|
|
|
### Error Monitoring
|
|
```
|
|
Recent Errors (Last 24 hours)
|
|
|
|
Type | Count | Last Occurred | Status
|
|
-----|-------|---------------|--------
|
|
API Timeout | 12 | 10 min ago | [View] [Resolve]
|
|
Login Failed | 45 | 2 min ago | [View] [Ignore]
|
|
DB Connection | 0 | - | OK
|
|
```
|
|
|
|
### Server Health
|
|
- CPU usage (%)
|
|
- Memory usage (%)
|
|
- Database connections
|
|
- API response times
|
|
- Disk space remaining
|
|
|
|
## 7. Communications
|
|
|
|
### Email Templates (Basic)
|
|
- Welcome email
|
|
- Password reset
|
|
- Daily verse (if enabled)
|
|
- Account suspended
|
|
- System announcements
|
|
|
|
### Bulk Email
|
|
- **Send to**: All users / Active last 7 days / Segment
|
|
- **Subject**: [_________]
|
|
- **Message**: [Rich text editor]
|
|
- **Schedule**: Now / Later
|
|
- [Send Test] [Schedule] [Send Now]
|
|
|
|
### In-App Notifications
|
|
- Create announcement banner
|
|
- Target specific user segments
|
|
- Set expiration time
|
|
- Track dismissal rate
|
|
|
|
## 8. Settings & Configuration
|
|
|
|
### App Settings
|
|
- **Site name**: BiblicalGuide
|
|
- **Support email**: support@biblical-guide.com
|
|
- **Daily verse**: Enabled/Disabled
|
|
- **Prayer wall**: Public/Moderated/Disabled
|
|
- **AI model**: GPT-4/GPT-3.5
|
|
- **Rate limits**: X chats per user per day
|
|
|
|
### Feature Toggles
|
|
- [ ] AI Chat enabled
|
|
- [ ] Prayer Wall enabled
|
|
- [ ] User registration open
|
|
- [ ] Daily verse emails
|
|
- [ ] Social sharing
|
|
- [ ] Maintenance mode
|
|
|
|
### Admin Users
|
|
```
|
|
Admin Users (3)
|
|
|
|
Email | Role | Last Login | Actions
|
|
------|------|------------|--------
|
|
admin@site.com | Super Admin | 1 hr ago | [Edit] [Remove]
|
|
support@site.com | Moderator | 2 days ago | [Edit] [Remove]
|
|
[+ Add Admin]
|
|
```
|
|
|
|
## 9. Simple Reporting
|
|
|
|
### Daily Report Email
|
|
- New users count
|
|
- Total AI conversations
|
|
- API costs
|
|
- Error summary
|
|
- Top chat topics
|
|
- System health status
|
|
|
|
### Export Data
|
|
- **User list** (CSV)
|
|
- **Chat logs** (last 30 days)
|
|
- **Prayer requests** (CSV)
|
|
- **Analytics summary** (PDF)
|
|
|
|
## 10. Security Section
|
|
|
|
### Security Log
|
|
```
|
|
Recent Security Events
|
|
|
|
Time | User | Event | IP Address | Action
|
|
-----|------|-------|------------|--------
|
|
10:23 AM | john@... | Failed login (3x) | 192.168.1.1 | [Block IP]
|
|
09:45 AM | Admin login | Success | 10.0.0.1 | -
|
|
```
|
|
|
|
### Security Actions
|
|
- View failed login attempts
|
|
- IP blocking/allowlisting
|
|
- Force logout all users
|
|
- Require password reset (bulk)
|
|
- 2FA enforcement settings
|
|
|
|
## Implementation Priority
|
|
|
|
### Phase 1 - Critical (Week 1)
|
|
1. **Login/Authentication** for admins
|
|
2. **Dashboard overview** (basic metrics)
|
|
3. **User list** with basic actions
|
|
4. **AI conversation monitoring** (view only)
|
|
|
|
### Phase 2 - Essential (Week 2)
|
|
1. **Prayer wall moderation**
|
|
2. **User management** (suspend/ban)
|
|
3. **Basic analytics** (users, engagement)
|
|
4. **Error monitoring**
|
|
|
|
### Phase 3 - Important (Week 3)
|
|
1. **Email communications**
|
|
2. **System settings**
|
|
3. **Export functionality**
|
|
4. **Cost tracking**
|
|
|
|
## Tech Stack for Admin
|
|
|
|
### Frontend
|
|
- **React** with **Recharts** for graphs
|
|
- **Tailwind CSS** with **shadcn/ui** components
|
|
- **React Table** for data tables
|
|
- **React Query** for data fetching
|
|
|
|
### Backend Additions
|
|
- **Admin authentication** (separate from users)
|
|
- **Role-based access** (admin, moderator)
|
|
- **Audit logging** (track all admin actions)
|
|
- **Scheduled jobs** (daily reports)
|
|
|
|
### Database Schema Additions
|
|
```sql
|
|
-- Admin users table
|
|
admin_users (
|
|
id, email, password_hash, role,
|
|
last_login, created_at
|
|
)
|
|
|
|
-- Audit log table
|
|
audit_logs (
|
|
id, admin_id, action, target_user_id,
|
|
details, ip_address, timestamp
|
|
)
|
|
|
|
-- System settings table
|
|
settings (
|
|
key, value, updated_at, updated_by
|
|
)
|
|
```
|
|
|
|
## Access Control Levels
|
|
|
|
### Super Admin
|
|
- Full access to everything
|
|
- Can manage other admins
|
|
- System configuration
|
|
- Database operations
|
|
|
|
### Moderator
|
|
- Content moderation
|
|
- User management (not deletion)
|
|
- View analytics
|
|
- Cannot change system settings
|
|
|
|
### Support
|
|
- View user details
|
|
- Reset passwords
|
|
- View chat logs
|
|
- Cannot ban/delete users
|
|
|
|
## Security Considerations
|
|
|
|
1. **Separate admin authentication** (not regular user accounts)
|
|
2. **IP allowlisting** for admin access
|
|
3. **Audit log** all admin actions
|
|
4. **Session timeout** after 30 min inactive
|
|
5. **2FA required** for all admin accounts
|
|
6. **Read-only mode** for most views (explicit edit mode)
|
|
|
|
## Success Metrics for Admin
|
|
|
|
- **Response time** to user issues < 1 hour
|
|
- **Moderation queue** cleared daily
|
|
- **System uptime** > 99.9%
|
|
- **API costs** within budget
|
|
- **User complaints** resolved < 24 hours |