burmddit/WEB-ADMIN-GUIDE.md

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:

# /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:

# 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:

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

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

Build & Deploy

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