Docker & Nginx

Author: WinterWollf

.dockerignore

@@ -0,0 +1,16 @@
+.git
+.gitignore
+.github
+.vscode
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.log
+tests/
+docs/
+.env
+.env.*
+Dockerfile.*
+docker-compose.yml
+db/

Dockerfile.api

@@ -0,0 +1,32 @@
+FROM python:3.12-slim-bookworm AS base
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    build-essential \
+    libpq-dev \
+    gcc \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    DEBIAN_FRONTEND=noninteractive
+
+WORKDIR /app
+
+COPY requirements.txt /app/requirements.txt
+RUN pip install --upgrade pip && pip install -r /app/requirements.txt
+
+COPY . /app
+
+ENV PYTHONPATH=/app
+
+EXPOSE 5000
+
+HEALTHCHECK --interval=10s --timeout=3s --retries=5 CMD curl -fsS http://localhost:5000/api/health || exit 1
+
+ENV GUNICORN_WORKERS=1
+ENV GUNICORN_THREADS=1
+
+CMD ["sh", "-c", "gunicorn -w ${GUNICORN_WORKERS} -k gthread --threads ${GUNICORN_THREADS} -b 0.0.0.0:5000 web.api.app:app"]

Dockerfile.nginx

@@ -0,0 +1,9 @@
+FROM nginx:1.27-alpine
+
+COPY nginx/default.conf /etc/nginx/conf.d/default.conf
+
+COPY web/ /usr/share/nginx/html/
+
+EXPOSE 80
+
+HEALTHCHECK --interval=10s --timeout=3s --retries=5 CMD wget -qO- http://localhost/ || exit 1

config.py

@@ -18,8 +18,7 @@ class Settings(BaseSettings):
     OUTPUT_XLSX: str = r"data_real/defense_schedule.xlsx"
 
     # --- PostgreSQL ---
-    # DB_URL: str = "postgresql+psycopg://user:pass@host/db"
-    DB_URL: str = "postgresql://postgres:1234567890@localhost/thesis_planner"
+    DB_URL: str = "postgresql://admin:rhAJPj3N6o7Ln6toR@db:5432/thesis_planner"
     RUN_ID: str = str(uuid.uuid4())
 
     # --- Planning / parsing ---

db/init/00_init.sql

@@ -0,0 +1,91 @@
+CREATE TABLE IF NOT EXISTS academic_staff (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  first_name TEXT NOT NULL,
+  last_name  TEXT NOT NULL,
+  academic_rank TEXT,
+  committee_time INT CHECK (committee_time IS NULL OR committee_time >= 0),
+  UNIQUE (first_name, last_name, academic_rank)
+);
+
+CREATE TABLE IF NOT EXISTS staff_availability (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  staff_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE CASCADE,
+  availability_date DATE NOT NULL,
+  start_time TIME NOT NULL,
+  end_time   TIME NOT NULL,
+  CHECK (end_time > start_time)
+);
+
+CREATE TABLE IF NOT EXISTS soft_constraints (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  staff_id    BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE CASCADE,
+  colleague_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE CASCADE,
+  likes BOOLEAN NOT NULL,
+  CHECK (staff_id <> colleague_id),
+  UNIQUE (staff_id, colleague_id)
+);
+
+CREATE TABLE IF NOT EXISTS theses (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  student_first_name TEXT NOT NULL,
+  student_last_name  TEXT NOT NULL,
+  reviewer_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE RESTRICT,
+  supervisor_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE RESTRICT,
+  field_of_study TEXT NOT NULL,
+  thesis_title TEXT NOT NULL,
+  CHECK (reviewer_id <> supervisor_id)
+);
+
+CREATE TABLE IF NOT EXISTS defense_schedule (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  defense_date DATE NOT NULL,
+  chairman_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE RESTRICT,
+  member2_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE RESTRICT,
+  member3_id BIGINT NOT NULL REFERENCES academic_staff(id) ON DELETE RESTRICT,
+  start_time TIME NOT NULL,
+  end_time TIME NOT NULL,
+  thesis_count INT NOT NULL CHECK (thesis_count >= 0),
+  CHECK (end_time > start_time),
+  CHECK (chairman_id <> member2_id
+    AND chairman_id <> member3_id
+    AND member2_id <> member3_id)
+);
+
+CREATE TABLE IF NOT EXISTS committee_thesis_assignment (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  defense_schedule_id BIGINT NOT NULL REFERENCES defense_schedule(id) ON DELETE CASCADE,
+  thesis_id BIGINT NOT NULL REFERENCES theses(id) ON DELETE CASCADE,
+  assignment_order INT NOT NULL,
+  UNIQUE (thesis_id),
+  UNIQUE (defense_schedule_id, assignment_order)
+);
+
+CREATE INDEX IF NOT EXISTS idx_staff_availability_staff_time
+  ON staff_availability (staff_id, availability_date, start_time, end_time);
+
+CREATE INDEX IF NOT EXISTS idx_soft_constraints_colleague
+  ON soft_constraints (colleague_id);
+
+CREATE INDEX IF NOT EXISTS idx_theses_reviewer
+  ON theses (reviewer_id);
+
+CREATE INDEX IF NOT EXISTS idx_theses_supervisor 
+  ON theses (supervisor_id);
+
+CREATE INDEX IF NOT EXISTS idx_defsch_chairman 
+  ON defense_schedule (chairman_id);
+
+CREATE INDEX IF NOT EXISTS idx_defsch_member2
+  ON defense_schedule (member2_id);
+
+CREATE INDEX IF NOT EXISTS idx_defsch_member3
+  ON defense_schedule (member3_id);
+
+CREATE INDEX IF NOT EXISTS idx_defsch_start_time
+  ON defense_schedule (start_time);
+
+CREATE INDEX IF NOT EXISTS idx_committee_thesis_defense
+  ON committee_thesis_assignment (defense_schedule_id);
+
+CREATE INDEX IF NOT EXISTS idx_committee_thesis_thesis
+  ON committee_thesis_assignment (thesis_id);

docker-compose.yml

@@ -0,0 +1,56 @@
+services:
+  db:
+    restart: unless-stopped
+    image: postgres:17
+    container_name: thesis-db
+    environment:
+      POSTGRES_DB: ${POSTGRES_DB:-thesis}
+      POSTGRES_USER: ${POSTGRES_USER:-thesis_user}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-thesis_pass}
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+      - ./db/init:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB -h localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    networks:
+      - app-net
+
+  api:
+    restart: unless-stopped
+    build:
+      context: .
+      dockerfile: Dockerfile.api
+    container_name: thesis-api
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      DATABASE_URL: ${DATABASE_URL:-postgresql+psycopg://thesis_user:thesis_pass@db:5432/thesis}
+      PYTHONUNBUFFERED: "1"
+    expose:
+      - "5000"
+    networks:
+      - app-net
+
+  nginx:
+    restart: unless-stopped
+    build:
+      context: .
+      dockerfile: Dockerfile.nginx
+    container_name: thesis-nginx
+    depends_on:
+      - api
+    ports:
+      - "80:80"
+    networks:
+      - app-net
+
+volumes:
+  pgdata:
+
+networks:
+  app-net:
+    driver: bridge