ideas-generator/README.md
DJP 29021e39b1 Complete README.md overhaul for Docker deployment
- Replace outdated 2024 architecture with modern Docker setup
- Lead with 5-minute Quick Start guide
- Focus on production-ready Docker deployment
- Clear installation instructions at top level
- Remove old Make.com/webhook references
- Add admin features, security info, and management commands
- Professional, enterprise-focused presentation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-10 16:24:17 -04:00

143 lines
No EOL
4.1 KiB
Markdown

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