Enable containerization for simplified deployment and scaling of the app

Adds Dockerfile, docker-compose files, and deployment scripts for containerizing the React/Express app. Replit-Commit-Author: Agent Replit-Commit-Session-Id: 3a22ac80-cd1d-4441-9e36-f24fc2f4c3de Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/3478f7c3-db8c-4fca-9165-3adbdf1b5829/e8da43e7-d99c-4328-9fdc-485bdeecffc1.jpg
2025-07-10 00:35:23 +00:00
parent ed0391011d
commit ec2ab0e9f4
10 changed files with 807 additions and 0 deletions
@@ -0,0 +1,159 @@
+# DJ Management System
+
+A comprehensive web-based DJ management and event scheduling system built with React, Express.js, and PostgreSQL.
+
+## Features
+
+- **User Management**: DJ profiles with social media links, bio, and contact information
+- **Event Management**: Create, schedule, and manage DJ events with multiple event types
+- **Availability System**: Calendar-based availability management for DJs
+- **Admin Dashboard**: Complete administrative controls for user and event management
+- **Assignment Tool**: Automated DJ assignment with rotation algorithms
+- **WordPress Integration**: API endpoints for displaying events on WordPress sites
+- **Authentication**: Secure authentication using Replit Auth (OpenID Connect)
+
+## Quick Start with Docker
+
+### Prerequisites
+- Docker and Docker Compose installed on your system
+
+### Environment Setup
+
+1. Create a `.env` file in the root directory:
+```bash
+# Database Configuration
+DATABASE_URL=postgresql://postgres:postgres@db:5432/dj_management
+
+# Authentication
+SESSION_SECRET=your-super-secret-session-key-here-minimum-32-chars
+REPLIT_DOMAINS=localhost,yourdomain.com
+REPL_ID=your-repl-id
+ISSUER_URL=https://replit.com/oidc
+
+# Application
+NODE_ENV=production
+PORT=5000
+```
+
+### Running with Docker Compose
+
+```bash
+# Build and start the application
+docker-compose up --build
+
+# Run in detached mode
+docker-compose up -d --build
+
+# Stop the application
+docker-compose down
+
+# View logs
+docker-compose logs -f app
+```
+
+The application will be available at `http://localhost:5000`
+
+### Building Docker Image Manually
+
+```bash
+# Build the Docker image
+docker build -t dj-management .
+
+# Run the container
+docker run -p 5000:5000 \
+  -e DATABASE_URL="your-database-url" \
+  -e SESSION_SECRET="your-session-secret" \
+  -e REPLIT_DOMAINS="localhost" \
+  dj-management
+```
+
+## Development Setup
+
+### Prerequisites
+- Node.js 18+
+- PostgreSQL database
+- npm or yarn
+
+### Local Development
+
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Set up environment variables:
+```bash
+cp .env.example .env
+# Edit .env with your configuration
+```
+
+3. Set up the database:
+```bash
+npm run db:push
+```
+
+4. Start the development server:
+```bash
+npm run dev
+```
+
+## API Endpoints
+
+### Authentication
+- `GET /api/login` - Initiate login flow
+- `GET /api/logout` - Logout user
+- `GET /api/auth/user` - Get current user
+
+### Events
+- `GET /api/events` - Get all events
+- `POST /api/events` - Create new event
+- `GET /api/events/upcoming` - Get upcoming events
+- `GET /api/events/public` - Public events (for WordPress integration)
+
+### Admin
+- `GET /api/users` - Get all users (admin only)
+- `GET /api/stats/admin` - Admin dashboard statistics
+- `POST /api/invitations` - Send DJ invitation
+
+## WordPress Integration
+
+The system provides public API endpoints for WordPress integration:
+
+```javascript
+// Fetch upcoming events for WordPress widget
+fetch('https://your-domain.com/api/events/public')
+  .then(response => response.json())
+  .then(events => {
+    // Display events in WordPress
+  });
+```
+
+## Production Deployment
+
+### Docker Deployment
+
+1. Update the `docker-compose.yml` with your production settings
+2. Set up proper SSL/TLS certificates
+3. Configure your reverse proxy (nginx/Apache)
+4. Set up proper backup for PostgreSQL data
+
+### Environment Variables
+
+Required environment variables for production:
+- `DATABASE_URL`: PostgreSQL connection string
+- `SESSION_SECRET`: Secure session encryption key
+- `REPLIT_DOMAINS`: Comma-separated list of allowed domains
+- `REPL_ID`: Your Replit application ID
+- `NODE_ENV`: Set to "production"
+
+## Architecture
+
+- **Frontend**: React 18 with TypeScript, Vite, TailwindCSS
+- **Backend**: Express.js with TypeScript, Drizzle ORM
+- **Database**: PostgreSQL with session storage
+- **Authentication**: OpenID Connect (Replit Auth)
+- **UI Components**: Radix UI primitives with shadcn/ui
+
+## License
+
+MIT License - see LICENSE file for details