feat: Add new scripts and update project structure for database management and user authentication

This commit introduces several new scripts for managing database operations, including user creation, permission grants, and data migrations. It also adds new documentation files to guide users through the setup and configuration processes. Additionally, the project structure is updated to enhance organization and maintainability, ensuring a smoother development experience for contributors. These changes support the ongoing transition to a web-based architecture and improve overall project functionality.

viewer-frontend/.env.example

@@ -0,0 +1,19 @@
+# Database Configuration
+# Read-only database connection (for reading photos, faces, people, tags)
+DATABASE_URL="postgresql://viewer_readonly:password@localhost:5432/punimtag"
+
+# Write-capable database connection (for user registration, pending identifications)
+# If not set, will fall back to DATABASE_URL
+# Option 1: Use the same user (after granting write permissions)
+# DATABASE_URL_WRITE="postgresql://viewer_readonly:password@localhost:5432/punimtag"
+# Option 2: Use a separate write user (recommended)
+DATABASE_URL_WRITE="postgresql://viewer_write:password@localhost:5432/punimtag"
+
+# NextAuth Configuration
+# Generate a secure secret using: openssl rand -base64 32
+NEXTAUTH_SECRET="your-secret-key-here-generate-with-openssl-rand-base64-32"
+NEXTAUTH_URL="http://localhost:3001"
+
+# Site Configuration
+NEXT_PUBLIC_SITE_NAME="PunimTag Photo Viewer"
+NEXT_PUBLIC_SITE_DESCRIPTION="Family Photo Gallery"