Admin Guide

# Invite a user to a tenant
curl -X POST http://localhost:8201/api/auth/invite \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "role": "editor",
    "tenant_id": "your-tenant-uuid"
  }'

curl -X PATCH http://localhost:8201/api/auth/users/{user_id}/role \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

curl -X POST http://localhost:8201/api/auth/users/{user_id}/deactivate \
  -H "Authorization: Bearer $ADMIN_TOKEN"

curl -X POST http://localhost:8201/api/tenants \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Games Studio",
    "slug": "acme-games",
    "plan": "indie",
    "max_users": 5,
    "brainbits_monthly": 500
  }'

curl -X PATCH http://localhost:8201/api/tenants/{tenant_id}/features \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "features": {
      "web_access": true,
      "google_drive_sync": true,
      "custom_templates": true,
      "brainbits_monthly_override": 1000
    }
  }'

PLAN_FEATURES = {
    "free": {
        "web_access": False,
        "cloud_sync": False,
        "google_drive": False,
        "mobile_access": False,
        "sso": False,
        "custom_templates": True,
        "ai_generation": True,
        "brainbits_monthly": 100,
    },
    "indie": {
        "web_access": True,
        "cloud_sync": True,
        "google_drive": True,
        "mobile_access": False,
        "sso": False,
        "custom_templates": True,
        "ai_generation": True,
        "brainbits_monthly": 500,
    },
    # ... team, enterprise
}

const { hasFeature, plan } = useFeatureGate();
 
if (!hasFeature('cloud_sync')) {
  return <UpgradePrompt feature="Cloud Sync" requiredPlan="indie" />;
}

curl http://localhost:8201/health

{
  "status": "healthy",
  "entity_count": 236,
  "entity_types": ["character", "location", "brand", "district", "faction", "item", "job"]
}

curl http://localhost:8201/api/services/health

{
  "backend": "healthy",
  "database": "connected",
  "ai_service": "healthy",
  "storage": "accessible",
  "redis": "connected",
  "qdrant": "connected"
}

curl http://your-gpu-host:8202/health

{
  "status": "healthy",
  "cloud_mode": false,
  "gpu_available": true
}

# Simple cron-based monitoring (add to crontab)
*/5 * * * * curl -sf http://localhost:8201/health > /dev/null || \
  echo "StudioBrain backend unhealthy" | mail -s "Alert" admin@example.com

# Get recent backend logs (last 100 lines)
curl "http://localhost:8201/api/services/logs/backend-api?lines=100"
 
# Get logs filtered by level
curl "http://localhost:8201/api/services/logs/backend-api?level=ERROR"
 
# Search logs
curl "http://localhost:8201/api/services/logs/backend-api?search=sync+failed"
 
# Clear a log file
curl -X POST "http://localhost:8201/api/services/logs/backend-api/clear"
 
# List available log files
curl "http://localhost:8201/api/services/logs/list"

# Follow all container logs
docker compose logs -f
 
# Follow a specific container
docker logs -f studiobrain-backend
 
# Last 200 lines
docker logs --tail 200 studiobrain-backend

# File copy (stop backend first for consistency)
docker compose stop backend
cp /path/to/db/city_brains.db /path/to/backups/city_brains_$(date +%Y%m%d).db
docker compose start backend
 
# Or use SQLite backup command (no downtime)
docker exec studiobrain-backend \
  sqlite3 /data/db/city_brains.db ".backup '/data/db/backup_$(date +%Y%m%d).db'"

# Auth database (contains PII -- store securely)
pg_dump -h 10.0.0.100 -U studiobrain_auth -d studiobrain_auth \
  -F c -f auth_backup_$(date +%Y%m%d).dump
 
# Content database
pg_dump -h 10.0.0.101 -U studiobrain_app -d studiobrain_content \
  -F c -f content_backup_$(date +%Y%m%d).dump
 
# Restore from backup
pg_restore -h 10.0.0.100 -U studiobrain_auth -d studiobrain_auth \
  -c auth_backup_20260224.dump

# postgresql.conf
wal_level = replica
archive_mode = on
archive_command = 'cp %p /backups/wal/%f'

# Create a snapshot of all collections
curl -X POST "http://10.0.0.102:6333/snapshots"
 
# List snapshots
curl "http://10.0.0.102:6333/snapshots"
 
# Download a snapshot
curl "http://10.0.0.102:6333/snapshots/{snapshot_name}" -o qdrant_backup.snapshot

# Trigger an immediate snapshot
redis-cli -h 10.0.0.103 -a your_password BGSAVE
 
# Copy the RDB file
cp /var/lib/redis/dump.rdb /path/to/backups/redis_$(date +%Y%m%d).rdb

# Rsync content directory
rsync -av /path/to/content/ /path/to/backups/content_$(date +%Y%m%d)/
 
# If using NFS from a NAS with ZFS, leverage ZFS snapshots
zfs snapshot tank/studiobrain/content@$(date +%Y%m%d)

# 1. Back up before upgrading
docker exec studiobrain-backend \
  sqlite3 /data/db/city_brains.db ".backup '/data/db/pre_upgrade_backup.db'"
 
# 2. Pull latest code
cd /path/to/studiobrain
git pull origin main
 
# 3. Rebuild and restart
cd docker
docker compose down
docker compose build
docker compose up -d
 
# 4. Verify health
curl http://localhost:8201/health

cd /path/to/studiobrain
git pull origin main
cd docker
docker compose build backend
docker compose up -d backend

cd /opt/studiobrain-ai/app
git pull origin main
 
# Restart to pick up code changes
docker restart studiobrain-ai
 
# If requirements changed, do a full restart
docker compose restart studiobrain-ai

_Templates/Standard/VEHICLE_TEMPLATE.md

---
entity_id: ""
entity_name: ""
vehicle_type: ""
manufacturer: ""
top_speed: 0
fuel_type: ""
associated_characters: []
---
 
# Vehicle Template
 
Template for defining vehicles in the game world.

docker compose restart backend

docker compose build frontend
docker compose up -d frontend

curl http://localhost:8201/api/templates

# Restart all services
docker compose restart
 
# Restart individual service
docker compose restart backend
docker compose restart frontend
 
# Full stop and start (for configuration changes)
docker compose down
docker compose up -d

# Container status
docker compose ps
 
# Resource usage
docker stats studiobrain-backend studiobrain-frontend studiobrain-caddy

# Backend container
docker exec -it studiobrain-backend bash
 
# Frontend container
docker exec -it studiobrain-frontend sh