Add production requirements, deployment docs, and Docker improvements

Copilot · xploitoverload · Copilot · commit 060d8d8c9d6b · 2026-02-08T14:46:32.000Z
Co-authored-by: xploitoverload &lt;184857390+xploitoverload@users.noreply.github.com&gt;
diff --git a/Dockerfile b/Dockerfile
@@ -11,15 +11,14 @@ WORKDIR /app
 RUN apt-get update && apt-get install -y --no-install-recommends \
     gcc \
     g++ \
-    cmake \
     libpq-dev \
     && rm -rf /var/lib/apt/lists/*
 
-# Copy requirements first for better caching
-COPY requirements.txt .
+# Copy production requirements first for better caching
+COPY requirements-prod.txt .
 
 # Install Python dependencies
-RUN pip install --no-cache-dir --user -r requirements.txt
+RUN pip install --no-cache-dir --user -r requirements-prod.txt
 
 # Stage 2: Runtime stage
 FROM python:3.11-slim
@@ -41,6 +40,7 @@ WORKDIR /app
 # Install runtime dependencies only
 RUN apt-get update && apt-get install -y --no-install-recommends \
     libpq5 \
+    curl \
     && rm -rf /var/lib/apt/lists/*
 
 # Copy Python dependencies from builder
@@ -60,7 +60,7 @@ EXPOSE 8000
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
-    CMD python -c "import requests; requests.get('http://localhost:8000/health', timeout=5)" || exit 1
+    CMD curl -f http://localhost:8000/health || exit 1
 
 # Run the application using gunicorn
 CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "4", "--threads", "2", "--timeout", "120", "--access-logfile", "-", "--error-logfile", "-", "run:app"]
diff --git a/QUICK_DEPLOY.md b/QUICK_DEPLOY.md
@@ -0,0 +1,111 @@
+# 🚀 Quick Deployment Guide
+
+This project is now configured for easy deployment to multiple platforms!
+
+## ✅ What's Been Added
+
+### 1. Docker Support
+- **Dockerfile** - Multi-stage production-ready Docker image
+- **docker-compose.yml** - Complete stack with Redis
+- **.dockerignore** - Optimized build context
+- **requirements-prod.txt** - Streamlined production dependencies
+
+### 2. Platform Configurations
+- **Procfile** - Heroku deployment configuration
+- **render.yaml** - Render.com Blueprint
+- **runtime.txt** - Python version specification
+
+### 3. CI/CD Workflows
+- **.github/workflows/ci-cd.yml** - Automated testing, security scanning, and deployment
+- **.github/workflows/docker-publish.yml** - Docker image building and publishing
+
+### 4. Documentation
+- **DEPLOYMENT.md** - Comprehensive deployment guide for all platforms
+- **CONTRIBUTING.md** - Guidelines for contributors
+- **Updated README.md** - Public project information and badges
+
+## 🎯 Deployment Options
+
+### Option 1: Render.com (Easiest - Free Tier)
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy)
+
+1. Click the button above
+2. Connect your GitHub repository
+3. Render automatically uses `render.yaml`
+4. Your app will be live in ~5 minutes!
+
+### Option 2: Heroku (Free Dyno Hours)
+```bash
+heroku create your-app-name
+git push heroku main
+```
+
+### Option 3: Docker (Self-Hosted)
+```bash
+docker-compose up -d
+# Access at http://localhost:8000
+```
+
+### Option 4: Railway.app
+```bash
+railway init
+railway up
+```
+
+## 📝 Environment Variables Required
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `SECRET_KEY` | Yes | - | Generate with `python -c "import secrets; print(secrets.token_hex(32))"` |
+| `DATABASE_URL` | No | `sqlite:///instance/app.db` | Database connection string |
+| `FLASK_ENV` | No | `production` | Environment mode |
+| `REDIS_URL` | No | - | Redis connection (optional, for caching) |
+
+## 🔒 Security Notes
+
+1. **Always set a secure SECRET_KEY** in production
+2. Use HTTPS (automatic on Render, Heroku, Railway)
+3. Change default admin credentials on first login
+4. Enable Redis for rate limiting in production
+
+## 📊 CI/CD Pipeline
+
+The project includes automated workflows that:
+- ✅ Run tests on Python 3.9, 3.10, and 3.11
+- ✅ Perform security scans (Bandit, Safety)
+- ✅ Lint code with flake8
+- ✅ Build and test Docker images
+- ✅ Deploy automatically on merge to main
+
+## 🌐 Making Your Deployment Public
+
+Once deployed:
+1. The repository is public at: https://github.com/xploitoverload/project-management
+2. Anyone can fork and deploy their own instance
+3. Contributions are welcome via Pull Requests
+4. Issues can be reported on GitHub
+
+## 🚀 Next Steps
+
+1. **Deploy**: Choose a platform and deploy
+2. **Configure**: Set environment variables
+3. **Initialize**: Create admin account
+4. **Use**: Start managing projects!
+
+## 🛠️ Troubleshooting
+
+If deployment fails:
+1. Check environment variables are set correctly
+2. Review platform logs for specific errors
+3. Ensure all required dependencies are in requirements-prod.txt
+4. See DEPLOYMENT.md for detailed troubleshooting
+
+## 📚 Learn More
+
+- [Full Deployment Guide](DEPLOYMENT.md) - Detailed instructions for each platform
+- [Contributing Guide](CONTRIBUTING.md) - How to contribute to the project
+- [Project README](README.md) - Complete project documentation
+
+---
+
+**Ready to deploy?** Pick a platform above and get started! 🎉
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -13,9 +13,10 @@ services:
     environment:
       - FLASK_ENV=production
       - SECRET_KEY=${SECRET_KEY:-change-this-secret-key-in-production}
-      - DATABASE_URL=${DATABASE_URL:-sqlite:///instance/app.db}
+      - DATABASE_URL=${DATABASE_URL:-sqlite:////app/instance/app.db}
       - REDIS_URL=redis://redis:6379/0
       - PORT=8000
+      - FLASK_APP=run.py
     volumes:
       - ./instance:/app/instance
       - ./uploads:/app/uploads
@@ -25,7 +26,7 @@ services:
     networks:
       - app-network
     healthcheck:
-      test: ["CMD", "python", "-c", "import requests; requests.get('http://localhost:8000/health', timeout=5)"]
+      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
       interval: 30s
       timeout: 10s
       retries: 3
diff --git a/requirements-prod.txt b/requirements-prod.txt
@@ -0,0 +1,56 @@
+# Production Requirements (Core Dependencies Only)
+# For full development dependencies, see requirements.txt
+
+# Core Framework
+Flask==3.0.0
+Flask-SQLAlchemy==3.1.1
+Werkzeug==3.1.5
+SQLAlchemy==2.0.23
+
+# Security
+cryptography==44.0.1
+bleach==6.1.0
+argon2-cffi==23.1.0
+Flask-WTF==1.2.1
+Flask-Talisman==1.1.0
+Flask-Login==0.6.3
+Flask-Limiter==3.5.0
+
+# Performance & Utilities
+Flask-Compress==1.14
+python-dotenv==1.0.0
+psutil==5.9.8
+
+# Two-Factor Authentication & QR Codes
+pyotp==2.9.0
+qrcode==8.2
+pillow==12.1.0
+
+# Database Migrations
+Flask-Migrate==4.0.5
+alembic==1.13.1
+
+# Caching
+Flask-Caching==2.3.0
+redis==5.0.1
+
+# API Documentation
+Flask-CORS==4.0.0
+
+# Email & Notifications
+Flask-Mail==0.9.1
+python-slugify==8.0.1
+
+# Production Server
+gunicorn==22.0.0
+
+# Monitoring & Logging
+python-json-logger==2.0.7
+
+# API Request Validation
+marshmallow==3.20.1
+marshmallow-sqlalchemy==0.29.0
+
+# Data Export
+openpyxl==3.1.2
+reportlab==4.0.7
diff --git a/requirements.txt b/requirements.txt
@@ -24,7 +24,7 @@ qrcode==8.2
 pillow==12.1.0
 
 # Facial Recognition (optional)
-face-recognition==1.3.5
+face-recognition==1.3.0
 numpy==1.26.3
 opencv-python==4.8.1.78
 
@@ -46,7 +46,7 @@ flask-socketio==5.3.5
 python-socketio==5.9.0
 python-engineio==4.8.0
 graphene==3.3
-graphene-sqlalchemy==3.0.0
+graphene-sqlalchemy==3.0.0rc2
 
 # Email & Notifications
 Flask-Mail==0.9.1
