# Ideas Generator 2025

**Enterprise-grade AI chat platform with multiple specialized AI assistants for business ideation and support.**

## 🚀 Quick Start - Docker Deployment

**Get up and running in under 5 minutes:**

```bash
# 1. Clone the repository
git clone git@bitbucket.org:zlalani/ideas-generator.git
cd ideas-generator
git checkout docker-deployment
cd docker

# 2. Run the automated setup
chmod +x simple-setup.sh
./simple-setup.sh

# 3. Access your application
# URL: http://localhost:8083 (or your chosen port)
# Login: admin@oliver.agency / admin123
```

**That's it!** The setup script will:
- ✅ Configure environment variables
- ✅ Build and start all Docker containers  
- ✅ Initialize PostgreSQL database
- ✅ Create admin user automatically
- ✅ Seed all AI agents and assistants
- ✅ Set up authentication system

## 🎯 What You Get

**Multi-Agent AI Platform:**
- 20+ specialized AI agents (Push Tech Boundaries, Game Creation, Viral Marketing, etc.)
- Persistent conversation history
- File upload support (images, PDFs, documents)
- Real-time streaming responses

**Enterprise Authentication:**
- Azure AD SSO integration (primary)
- Password authentication fallback (admin configurable)
- Role-based access control (Admin/User)
- User management and agent assignment

**Production-Ready Architecture:**
- Docker containerization
- PostgreSQL database with persistence
- Nginx reverse proxy
- Health checks and monitoring
- Scalable multi-service design

## 🏗️ Architecture

```
Frontend (Vue.js + Nginx)
    ↓
Backend API (Node.js + Express)
    ↓
Database (PostgreSQL)
```

**Services:**
- **Frontend**: Vue.js 3 application with modern UI
- **Backend**: Node.js API with authentication and chat routing
- **Database**: PostgreSQL with persistent storage
- **Proxy**: Nginx with security headers and SSL support

## 🔧 Admin Features

Login as admin to access:
- **User Management**: Create users, assign roles, manage permissions
- **Agent Assignment**: Control which users can access which AI agents
- **Authentication Control**: Toggle password auth on/off
- **System Analytics**: Monitor usage and performance
- **Configuration**: Manage OpenAI keys and system settings

## 📋 Requirements

- **Docker & Docker Compose** installed
- **OpenAI API key** (you'll be prompted during setup)
- **Available ports** (default: 8083, customizable)

## 🛠️ Management Commands

```bash
# View status
docker compose ps

# View logs
docker compose logs -f

# Stop services
docker compose down

# Restart services
docker compose restart

# Update deployment
git pull origin docker-deployment
docker compose up -d --build

# Reset everything
docker compose down --volumes
./simple-setup.sh
```

## 🔒 Security Features

- **Enterprise Authentication**: Azure AD integration with Oliver Agency tenant
- **JWT Token Security**: Secure session management
- **Input Sanitization**: Protection against malicious inputs
- **Rate Limiting**: API abuse prevention
- **CORS Protection**: Configured for your domain
- **Data Privacy**: Conversations stored securely with user isolation

## 🚀 Production Deployment

For production environments:

1. **Use a proper domain** (not localhost)
2. **Set up SSL certificates** in the `/certs` directory
3. **Change default admin password** after first login
4. **Configure proper CORS** settings for your domain
5. **Set up database backups** for the PostgreSQL volume
6. **Monitor logs** and set up alerting

## 📞 Support

- **Documentation**: See `/docker/README.md` for detailed Docker setup info
- **Troubleshooting**: Check logs with `docker compose logs -f`
- **Issues**: Report problems via your project management system

## 🔄 Version History

- **2025.1**: Docker deployment with complete authentication system
- **2024**: Original cloud-based architecture
- **Migration**: Transitioned from Make.com webhooks to native Node.js API

---

**Built for Oliver Agency** with enterprise-grade security and scalability in mind.