fresh dockerized set up of the app

Author: FionaDmello

.dockerignore

@@ -0,0 +1,82 @@
+# .dockerignore - Excludes files from Docker build context
+# Reduces build time, image size, and prevents leaking sensitive data
+
+# Version control
+.git/
+.gitignore
+.github/
+
+# Python cache and compiled files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.pytest_cache/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+.poetry/
+
+# Environment variables (SECURITY: never include secrets in images)
+.env
+.env.*
+
+# Documentation
+# Keep README.md for Poetry package installation
+# *.md  # Commented out to allow README.md
+docs/
+LICENSE
+
+# Development and testing
+.pre-commit-config.yaml
+.ropeproject/
+tests/
+test_*.py
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Docker files (don't need these inside the image)
+Dockerfile
+Dockerfile.*
+docker-compose.yml
+docker-compose.*.yml
+.dockerignore
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Logs
+*.log
+logs/
+
+# OS files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+temp/
+
+# Coverage reports
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+.hypothesis/

.env.example

@@ -0,0 +1,58 @@
+# Environment Variables Template for Survey Dashboard
+# Copy this file to .env and update with your actual values
+# Command: cp .env.example .env
+
+# ============================================================================
+# Docker Compose Configuration
+# ============================================================================
+
+# Project name - used as prefix for container names
+# Example: survey-dashboard_nginx_1, survey-dashboard_dashboard_1
+COMPOSE_PROJECT_NAME=survey-dashboard
+
+# ============================================================================
+# Application Configuration
+# ============================================================================
+
+# Port the Panel application runs on inside the container
+# Default: 5006 (Panel's default port)
+APP_PORT=5006
+
+# ============================================================================
+# Nginx Configuration
+# ============================================================================
+
+# Port nginx exposes on the host machine
+# Default: 80 (standard HTTP port)
+# Change to 8080 or another port if 80 is already in use
+NGINX_PORT=80
+
+# Your domain name
+# In development: Use 'localhost' or your IP address
+# In production: Use your actual domain (e.g., survey.example.com)
+# This is used in nginx server_name directive
+HOST=localhost
+
+# ============================================================================
+# Optional: SSL/HTTPS Configuration (for future use)
+# ============================================================================
+
+# Uncomment and configure these if you want to enable HTTPS
+# ENABLE_SSL=false
+# SSL_CERT_PATH=/path/to/cert.pem
+# SSL_KEY_PATH=/path/to/key.pem
+
+# ============================================================================
+# Python Configuration
+# ============================================================================
+
+# Keep Python output unbuffered for better logging
+PYTHONUNBUFFERED=1
+
+# ============================================================================
+# NOTES
+# ============================================================================
+# - Never commit the .env file to version control
+# - .env is listed in .gitignore to prevent accidental commits
+# - Update .env.example when adding new environment variables
+# - In production, consider using Docker secrets or a secrets manager

Dockerfile

@@ -0,0 +1,43 @@
+# Multi-stage build for survey dashboard
+# Stage 1: Builder - installs dependencies
+FROM python:3.12-slim as builder
+
+# Install poetry
+RUN pip install --no-cache-dir poetry==1.8.2
+
+WORKDIR /app
+
+# Copy dependency files first (for Docker layer caching)
+COPY pyproject.toml poetry.lock README.md ./
+
+# Configure poetry to not create virtual environment (we're in a container)
+RUN poetry config virtualenvs.create false
+
+# Install dependencies (excluding dev dependencies)
+# --no-root: Don't install the project itself, only dependencies
+RUN poetry install --only main --no-root --no-interaction --no-ansi
+
+# Stage 2: Final runtime image
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Copy installed packages from builder stage
+COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+
+# Copy application code
+COPY survey_dashboard/ ./survey_dashboard/
+COPY pyproject.toml ./
+
+# Create a non-root user for security
+RUN useradd -m -u 1000 appuser && \
+    chown -R appuser:appuser /app
+
+USER appuser
+
+# Expose the application port
+EXPOSE 5006
+
+# Run the application in production mode using the updated script
+CMD ["survey-dashboard", "--production", "--host", "0.0.0.0", "--port", "5006"]

docker-compose.yml

@@ -0,0 +1,61 @@
+# Docker Compose configuration for Survey Dashboard
+# Orchestrates nginx reverse proxy and Panel application containers
+
+version: '3.8'
+
+services:
+  # Panel application container
+  dashboard:
+    build: .
+    # Builds from Dockerfile in current directory
+    # Uses multi-stage build to create optimized production image
+
+    expose:
+      - "5006"
+    # Exposes port 5006 to other containers (not to host machine)
+    # Only accessible within Docker network - nginx can reach it
+
+    restart: unless-stopped
+    # Automatically restart if container crashes
+    # Persists across system reboots unless manually stopped
+
+    environment:
+      - PYTHONUNBUFFERED=1
+      # Ensures Python output is sent directly to logs (not buffered)
+      # Makes 'docker-compose logs' show real-time output
+
+    # Uncomment to mount local code for development
+    # volumes:
+    #   - ./survey_dashboard:/app/survey_dashboard
+
+  # Nginx reverse proxy container
+  nginx:
+    image: nginx:latest
+    # Uses official nginx image from Docker Hub
+    # No custom build needed - just mount our config
+
+    ports:
+      - "80:80"
+      # Maps host port 80 to container port 80
+      # This is the ONLY port exposed to the internet
+      # Users access dashboard via http://yourdomain.com (port 80)
+
+    volumes:
+      - ./nginx/conf.d:/etc/nginx/conf.d:ro
+      # Mounts our nginx config into the container
+      # :ro = read-only (nginx cannot modify our files)
+      # Changes to config files are reflected immediately
+
+    depends_on:
+      - dashboard
+      # Ensures dashboard container starts before nginx
+      # Nginx needs dashboard to be available for proxying
+
+    restart: unless-stopped
+    # Same restart policy as dashboard
+
+networks:
+  default:
+    # Docker Compose automatically creates a default network
+    # Both containers join this network and can communicate
+    # Service names (dashboard, nginx) work as DNS hostnames