ideas-generator/README.md

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:

# 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

# 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.