# 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