feat: Enhance Docker setup and documentation for Palmr.

- Added a new `docker-compose-bind-mount-example.yaml` for easier bind mount configuration.
- Updated `.gitignore` to include the `data/` directory for persistent storage.
- Modified `docker-compose.yaml` to clarify volume paths and improve comments.
- Enhanced `Dockerfile` to support flexible UID/GID configuration and ensure proper directory permissions.
- Updated environment variable handling in `server-start.sh` and Prisma configuration for better database management.
- Revised documentation in `quick-start.mdx` and `uid-gid-configuration.mdx` to reflect new features and best practices for deployment.

infra/server-start.sh

@@ -1,22 +1,93 @@
 #!/bin/sh
+set -e
 
-echo "Starting Palmr Server with SQLite..."
+echo "🌴 Starting Palmr Server..."
 
-# Set proper environment
-export HOME=/home/palmr
-export NPM_CONFIG_CACHE=/home/palmr/.npm
-export PNPM_HOME=/home/palmr/.pnpm
+# === UID/GID Runtime Configuration ===
+TARGET_UID=${PALMR_UID:-1001}
+TARGET_GID=${PALMR_GID:-1001}
 
-cd /app/server
+if [ -n "$PALMR_UID" ] || [ -n "$PALMR_GID" ]; then
+    echo "🔧 Runtime UID/GID: $TARGET_UID:$TARGET_GID"
+    
+    # Update ownership of critical directories to match target UID/GID
+    echo "🔐 Updating file ownership..."
+    chown -R $TARGET_UID:$TARGET_GID /app/palmr-app 2>/dev/null || echo "⚠️ Some ownership changes may have failed"
+    chown -R $TARGET_UID:$TARGET_GID /home/palmr 2>/dev/null || echo "⚠️ Some home directory ownership changes may have failed"
+    
+    # Update ownership of data directory if it exists
+    if [ -d "/app/server" ]; then
+        chown -R $TARGET_UID:$TARGET_GID /app/server 2>/dev/null || echo "⚠️ Some data directory ownership changes may have failed"
+    fi
+    
+    echo "✅ UID/GID configuration completed"
+fi
 
-echo "Generating Prisma client..."
-npx prisma generate --schema=./prisma/schema.prisma
+# Ensure we're in the correct directory
+cd /app/palmr-app
 
-echo "Pushing database schema..."
-npx prisma db push --accept-data-loss
+# Set the database URL
+export DATABASE_URL="file:/app/server/prisma/palmr.db"
 
-echo "Running database seeds..."
-node prisma/seed.js || echo "Seeds failed or already exist, continuing..."
+echo "📂 Data directory: /app/server"
+echo "💾 Database: $DATABASE_URL"
 
-echo "Starting server application..."
-exec node dist/server.js 
+# Create all necessary directories
+echo "📁 Creating data directories..."
+mkdir -p /app/server/prisma /app/server/uploads /app/server/temp-chunks /app/server/uploads/logo
+
+# Check if it's a first run (no database file exists)
+if [ ! -f "/app/server/prisma/palmr.db" ]; then
+    echo "🚀 First run detected - setting up database..."
+    
+    # Create database with proper schema path
+    echo "🗄️ Creating database schema..."
+    npx prisma db push --schema=./prisma/schema.prisma --skip-generate
+    
+    # Run seed script from application directory (where node_modules is)
+    echo "🌱 Seeding database..."
+    node ./prisma/seed.js
+    
+    echo "✅ Database setup completed!"
+else
+    echo "♻️ Existing database found"
+    
+    # Always run migrations to ensure schema is up to date
+    echo "🔧 Checking for schema updates..."
+    npx prisma db push --schema=./prisma/schema.prisma --skip-generate
+    
+    # Check if configurations exist
+    echo "🔍 Verifying database configurations..."
+    CONFIG_COUNT=$(node -e "
+        const { PrismaClient } = require('@prisma/client');
+        const prisma = new PrismaClient();
+        prisma.appConfig.count()
+            .then(count => {
+                console.log(count);
+                process.exit(0);
+            })
+            .catch(() => {
+                console.log(0);
+                process.exit(0);
+            });
+    " 2>/dev/null || echo "0")
+    
+    if [ "$CONFIG_COUNT" -eq "0" ]; then
+        echo "🌱 No configurations found, running seed..."
+        # Always run seed from application directory where node_modules is available
+        node ./prisma/seed.js
+    else
+        echo "✅ Found $CONFIG_COUNT configurations"
+    fi
+fi
+
+echo "🚀 Starting Palmr server..."
+
+# Drop privileges using su-exec with specific UID/GID
+if [ "$(id -u)" = "0" ]; then
+    echo "🔽 Dropping privileges to UID:GID $TARGET_UID:$TARGET_GID"
+    exec su-exec $TARGET_UID:$TARGET_GID node dist/server.js
+else
+    # We're already running as non-root
+    exec node dist/server.js
+fi