Ender
5ec4438bce
- 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
133 lines
2.6 KiB
Markdown
133 lines
2.6 KiB
Markdown
# 🧪 Testing VoxBlog - Super Quick Guide
|
|
|
|
## One-Command Test
|
|
|
|
```bash
|
|
./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)
|
|
|
|
```bash
|
|
# 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! 📸)
|
|
1. Go to any post → Assets step
|
|
2. Click "Upload Images" button
|
|
3. Select photos from your computer/phone
|
|
4. ✅ Photos upload and appear in grid
|
|
|
|
**On phone**: Tap "Upload Images" → Choose camera or gallery
|
|
|
|
### 2. Content Statistics (NEW! 📊)
|
|
1. Go to Generate step
|
|
2. Write a prompt: "Write a 500-word article about meditation"
|
|
3. Click "Generate Draft"
|
|
4. ✅ Watch live stats update during generation
|
|
5. ✅ See detailed stats after completion
|
|
|
|
### 3. Mobile Responsiveness (NEW! 📱)
|
|
1. Resize browser to 375px width (or use phone)
|
|
2. ✅ Everything should work and look good
|
|
3. ✅ Buttons wrap, sidebar stacks, stepper scrolls
|
|
|
|
## Test on Your Phone
|
|
|
|
1. **Find your computer's IP**:
|
|
```bash
|
|
ifconfig | grep "inet " | grep -v 127.0.0.1
|
|
```
|
|
Example output: `192.168.1.100`
|
|
|
|
2. **Connect phone to same WiFi**
|
|
|
|
3. **Open on phone**: `http://192.168.1.100:3300`
|
|
|
|
4. **Test mobile features**:
|
|
- Upload photos from camera
|
|
- Generate content
|
|
- View statistics
|
|
- Navigate all steps
|
|
|
|
## Quick Commands
|
|
|
|
```bash
|
|
# 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
|
|
|
|
- **Admin**: http://localhost:3300
|
|
- **API**: http://localhost:3000
|
|
- **Mobile**: http://YOUR_IP:3300
|
|
|
|
## Login
|
|
|
|
Password: `P!JfChRiaA2Gdnm6iIo8`
|
|
|
|
## Troubleshooting
|
|
|
|
**Can't access localhost:3300?**
|
|
```bash
|
|
docker-compose logs admin
|
|
docker-compose restart admin
|
|
```
|
|
|
|
**Images won't upload?**
|
|
```bash
|
|
docker-compose logs api
|
|
# Check S3 credentials in .env
|
|
```
|
|
|
|
**AI generation fails?**
|
|
```bash
|
|
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! 🚀**
|