Set up docker environment and improve spider plot rendering

Author: sankalpgambhir

.dockerignore

@@ -5,3 +5,14 @@ dist
 .DS_Store
 npm-debug.log*
 coverage
+.venv
+__pycache__
+.pytest_cache
+data
+milestone1
+milestone2
+scripts
+Milestone 3.pdf
+README.md
+NOTES.md
+dataset-sources.md

Dockerfile.python

@@ -0,0 +1,19 @@
+FROM python:3.12-slim
+
+WORKDIR /workspace
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV PIP_NO_CACHE_DIR=1
+
+RUN useradd --create-home --shell /bin/bash appuser
+
+COPY requirements.txt ./
+RUN pip install --upgrade pip && pip install -r requirements.txt
+
+RUN chown -R appuser:appuser /workspace /home/appuser
+USER appuser
+
+EXPOSE 8888
+
+CMD ["jupyter", "lab", "--ip", "0.0.0.0", "--port", "8888", "--no-browser", "--IdentityProvider.token="]

README.md

@@ -10,6 +10,35 @@
 
 [Webpage (WIP)](https://com-480-data-visualization.github.io/special-operations/)
 
+## Docker setup
+
+Use Docker Compose to run both the frontend and the Python project environment:
+
+```bash
+docker compose up --build
+```
+
+Services:
+
+- `web`: Vite dev server on `http://localhost:5173`
+- `notebook`: JupyterLab on `http://localhost:8888`
+
+Useful commands:
+
+```bash
+# Start only the frontend
+docker compose up --build web
+
+# Start only JupyterLab / Python environment
+docker compose up --build notebook
+
+# Run the preprocessing script inside Docker
+docker compose run --rm notebook python milestone2/preprocess.py
+
+# Rebuild treemap data inside Docker
+docker compose run --rm notebook python scripts/build_treemap_data.py
+```
+
 ## Milestone 1 (20th March, 5pm)
 
 **10% of the final grade**
@@ -58,4 +87,3 @@ Please, fill the following sections about your project.
 
 - < 24h: 80% of the grade for the milestone
 - < 48h: 70% of the grade for the milestone
-

docker-compose.yml

@@ -1,16 +1,29 @@
-# Runs the local Vite development server in Docker while keeping dependencies
-# inside an isolated container volume.
+# Runs the frontend dev server and a separate Python/Jupyter workspace in Docker
+# so the project can be developed without installing Node or Python locally.
 services:
   web:
     build:
       context: .
-    command: sh -c "npm install --no-audit --no-fund && npm run dev -- --host 0.0.0.0"
+      dockerfile: Dockerfile
+    command: npm run dev -- --host 0.0.0.0
     user: node
     ports:
       - "5173:5173"
     volumes:
       - .:/app
       - node_modules:/app/node_modules
 
+  notebook:
+    build:
+      context: .
+      dockerfile: Dockerfile.python
+    command: jupyter lab --ip 0.0.0.0 --port 8888 --no-browser --IdentityProvider.token=
+    ports:
+      - "8888:8888"
+    volumes:
+      - .:/workspace
+      - pip_cache:/home/appuser/.cache/pip
+
 volumes:
   node_modules:
+  pip_cache: