Ender 5ec4438bce docs: add comprehensive database and testing documentation

- Created DATABASE_SETUP.md with detailed MySQL setup, troubleshooting, and maintenance guides
- Added QUICK_TEST_GUIDE.md with step-by-step testing procedures for mobile responsiveness, image uploads, content statistics, and full workflow
- Included troubleshooting sections in both guides with common issues and solutions
- Added environment variable documentation and database schema details
- Documented backup/restore procedures and verification steps for

2025-10-26 23:21:34 +01:00

2.6 KiB

Raw Blame History

🧪 Testing VoxBlog - Super Quick Guide

One-Command Test

./test.sh

This script will:

✅ Check Docker is running
✅ Stop old containers
✅ Build and start everything
✅ Show you the URLs to access
✅ Offer to open browser automatically

Manual Test (3 commands)

# 1. Start everything
docker-compose up -d --build

# 2. Open browser
open http://localhost:3300  # Mac
# or visit http://localhost:3300 manually

# 3. Login with password
# P!JfChRiaA2Gdnm6iIo8

What to Test

1. Mobile Upload Feature (NEW! 📸)

Go to any post → Assets step
Click "Upload Images" button
Select photos from your computer/phone
✅ Photos upload and appear in grid

On phone: Tap "Upload Images" → Choose camera or gallery

2. Content Statistics (NEW! 📊)

Go to Generate step
Write a prompt: "Write a 500-word article about meditation"
Click "Generate Draft"
✅ Watch live stats update during generation
✅ See detailed stats after completion

3. Mobile Responsiveness (NEW! 📱)

Resize browser to 375px width (or use phone)
✅ Everything should work and look good
✅ Buttons wrap, sidebar stacks, stepper scrolls

Test on Your Phone

Find your computer's IP:
```
ifconfig | grep "inet " | grep -v 127.0.0.1
```
Example output: 192.168.1.100
Connect phone to same WiFi
Open on phone: http://192.168.1.100:3300
Test mobile features:
- Upload photos from camera
- Generate content
- View statistics
- Navigate all steps

Quick Commands

# Start
docker-compose up -d

# Stop
docker-compose down

# View logs
docker-compose logs -f

# Restart admin only
docker-compose restart admin

# Rebuild admin only
docker-compose up -d --build admin

# Reset everything (deletes data!)
docker-compose down -v
docker-compose up -d --build

URLs

Password: P!JfChRiaA2Gdnm6iIo8

Troubleshooting

Can't access localhost:3300?

docker-compose logs admin
docker-compose restart admin

Images won't upload?

docker-compose logs api
# Check S3 credentials in .env

AI generation fails?

docker-compose logs api
# Check OPENAI_API_KEY in .env

Full Documentation

📖 QUICK_TEST_GUIDE.md - Detailed testing guide
📱 MOBILE_COMPATIBILITY.md - Mobile features
📊 CONTENT_STATISTICS_SUMMARY.md - Statistics feature
🚀 DEPLOYMENT_GUIDE.md - Production deployment

That's it! Start with ./test.sh and you're ready to go! 🚀

2.6 KiB Raw Blame History