# Burmddit Web Admin Guide

**Created:** 2026-02-26  
**Admin Dashboard:** https://burmddit.com/admin  
**Password:** Set in `.env` as `ADMIN_PASSWORD`

---

## 🎯 Quick Access

### Method 1: Admin Dashboard (Recommended)

1. Go to **https://burmddit.com/admin**
2. Enter admin password (default: `burmddit2026`)
3. View all articles in a table
4. Click buttons to Unpublish/Publish/Delete

### Method 2: On-Article Admin Panel (Hidden)

1. **View any article** on burmddit.com
2. Press **Alt + Shift + A** (keyboard shortcut)
3. Admin panel appears in bottom-right corner
4. Enter password once, then use buttons to:
   - 🚫 **Unpublish** - Hide article from site
   - 🗑️ **Delete** - Remove permanently

---

## 📊 Admin Dashboard Features

### Main Table View

| Column | Description |
|--------|-------------|
| **ID** | Article number |
| **Title** | Article title in Burmese (clickable to view) |
| **Status** | published (green) or draft (gray) |
| **Translation** | Quality % (EN → Burmese length ratio) |
| **Views** | Page view count |
| **Actions** | View, Unpublish/Publish, Delete buttons |

### Translation Quality Colors

- 🟢 **Green (40%+)** - Good translation
- 🟡 **Yellow (20-40%)** - Check manually, might be okay
- 🔴 **Red (<20%)** - Poor/incomplete translation

### Filters

- **Published** - Show only live articles
- **Draft** - Show hidden/unpublished articles

---

## 🔧 Common Actions

### Flag & Unpublish Bad Article

**From Dashboard:**
1. Go to https://burmddit.com/admin
2. Log in with password
3. Find article (look for red <20% translation)
4. Click **Unpublish** button
5. Article is hidden immediately

**From Article Page:**
1. View article on site
2. Press **Alt + Shift + A**
3. Enter password
4. Click **🚫 Unpublish (Hide)**
5. Page reloads, article is hidden

### Republish Fixed Article

1. Go to admin dashboard
2. Change filter to **Draft**
3. Find the article you fixed
4. Click **Publish** button
5. Article is live again

### Delete Article Permanently

⚠️ **Warning:** This cannot be undone!

1. Go to admin dashboard
2. Find the article
3. Click **Delete** button
4. Confirm deletion
5. Article is permanently removed

---

## 🔐 Security

### Password Setup

Set admin password in frontend `.env` file:

```bash
# /home/ubuntu/.openclaw/workspace/burmddit/frontend/.env
ADMIN_PASSWORD=your_secure_password_here
```

**Default password:** `burmddit2026`  
**Change it immediately for production!**

### Session Management

- Password stored in browser `sessionStorage` (temporary)
- Expires when browser tab closes
- Click **Logout** to clear manually
- No cookies or persistent storage

### Access Control

- Only works with correct password
- No public API endpoints without auth
- Failed auth returns 401 Unauthorized
- Password checked on every request

---

## 📱 Mobile Support

Admin panel works on mobile too:

- **Dashboard:** Responsive table (scroll horizontally)
- **On-article panel:** Touch-friendly buttons
- **Alt+Shift+A shortcut:** May not work on mobile keyboards
  - Alternative: Use dashboard at /admin

---

## 🎨 UI Details

### Admin Dashboard
- Clean table layout
- Color-coded status badges
- One-click actions
- Real-time filtering
- View counts and stats

### On-Article Panel
- Bottom-right floating panel
- Hidden by default (Alt+Shift+A to show)
- Red background (admin warning color)
- Quick unlock with password
- Instant actions with reload

---

## 🔥 Workflows

### Daily Quality Check

1. Go to https://burmddit.com/admin
2. Sort by Translation % (look for red ones)
3. Click article titles to review
4. Unpublish any with broken translations
5. Fix them using CLI tools (see ADMIN-GUIDE.md)
6. Republish when fixed

### Emergency Takedown

**Scenario:** Found article with errors, need to hide immediately

1. On article page, press **Alt + Shift + A**
2. Enter password (if not already)
3. Click **🚫 Unpublish (Hide)**
4. Article disappears in <1 second

### Bulk Management

1. Go to admin dashboard
2. Review list of published articles
3. Open each problem article in new tab (Ctrl+Click)
4. Use Alt+Shift+A on each tab
5. Unpublish quickly from each

---

## 🐛 Troubleshooting

### "Unauthorized" Error
- Check password is correct
- Check ADMIN_PASSWORD in .env matches
- Try logging out and back in
- Clear browser cache

### Admin panel won't show (Alt+Shift+A)
- Make sure you're on an article page
- Try different keyboard (some laptops need Fn key)
- Use admin dashboard instead: /admin
- Check browser console for errors

### Changes not appearing on site
- Changes are instant (no cache)
- Try hard refresh: Ctrl+Shift+R
- Check article status in dashboard
- Verify database updated (use CLI tools)

### Can't access /admin page
- Check Next.js is running
- Check no firewall blocking
- Try incognito/private browsing
- Check browser console for errors

---

## 📊 Statistics

### What Gets Tracked

- **View count** - Increments on each page view
- **Status** - published or draft
- **Translation ratio** - Burmese/English length %
- **Last updated** - Timestamp of last change

### What Gets Logged

Backend logs all admin actions:
- Unpublish: Article ID + reason
- Publish: Article ID
- Delete: Article ID + title

Check logs at:
```bash
# Backend logs (if deployed)
railway logs

# Or check database updated_at timestamp
```

---

## 🎓 Tips & Best Practices

### Keyboard Shortcuts

- **Alt + Shift + A** - Toggle admin panel (on article pages)
- **Escape** - Close admin panel
- **Enter** - Submit password (in login box)

### Translation Quality Guidelines

When reviewing articles:

- **40%+** ✅ - Approve, publish
- **30-40%** ⚠️ - Read manually, may be technical content (okay)
- **20-30%** ⚠️ - Check for missing chunks
- **<20%** ❌ - Unpublish, translation broken

### Workflow Integration

Add to your daily routine:

1. **Morning:** Check dashboard for new articles
2. **Review:** Look for red (<20%) translations
3. **Fix:** Unpublish bad ones immediately
4. **Re-translate:** Use CLI fix script
5. **Republish:** When translation is good

---

## 🚀 Deployment

### Environment Variables

Required in `.env`:

```bash
# Database (already set)
DATABASE_URL=postgresql://...

# Admin password (NEW - add this!)
ADMIN_PASSWORD=burmddit2026
```

### Build & Deploy

```bash
cd /home/ubuntu/.openclaw/workspace/burmddit/frontend

# Install dependencies (if pg not installed)
npm install pg

# Build
npm run build

# Deploy
vercel --prod
```

Or deploy automatically via Git push if connected to Vercel.

---

## 📞 Support

### Common Questions

**Q: Can multiple admins use this?**  
A: Yes, anyone with the password. Consider unique passwords per admin in future.

**Q: Is there an audit log?**  
A: Currently basic logging. Can add detailed audit trail if needed.

**Q: Can I customize the admin UI?**  
A: Yes! Edit `/frontend/app/admin/page.tsx` and `/frontend/components/AdminButton.tsx`

**Q: Mobile app admin?**  
A: Works in mobile browser. For native app, would need API + mobile UI.

---

## 🔮 Future Enhancements

Possible improvements:

- [ ] Multiple admin users with different permissions
- [ ] Detailed audit log of all changes
- [ ] Batch operations (unpublish multiple at once)
- [ ] Article editing from admin panel
- [ ] Re-translate button directly in admin
- [ ] Email notifications for quality issues
- [ ] Analytics dashboard (views over time)

---

**Created:** 2026-02-26 09:15 UTC  
**Last Updated:** 2026-02-26 09:15 UTC  
**Status:** ✅ Ready to use

Access at: https://burmddit.com/admin