Feature/improve summary

.env.example

@@ -1,8 +1,10 @@
-LLM_API="http://localhost:9000/v1"
-WHISPER_API="http://localhost:50001/v1"
-API_KEY="your api token here"
+LLM_API_PORT=8001
+LLM_BASE_URL=http://localhost:${LLM_API_PORT}/v1
+API_KEY='none'
+WHISPER_URL="http://localhost:50001/v1"
 HMAC_SECRET="YOUR HMAC SECRET" # Used to pseudonymize user id. Create with openssl rand 32 | base64
 HF_AUTH_TOKEN=""
+CLIENT_PORT=3000
+CLIENT_URL=http://localhost:${CLIENT_PORT}
 PORT=""
-LLM_HEALTH_CHECK="http://localhost:9000/health"
-WHISPER_HEALTH_CHECK="http://localhost:50001/healthz"
+IS_PROD=False

.github/workflows/docker-publish.yml

@@ -1,26 +1,17 @@
 name: Build and Publish Docker Image
 on:
   workflow_dispatch:
-    inputs:
-      version_bump:
-        description: Version bump type
-        required: true
-        default: patch
-        type: choice
-        options: [major, minor, patch]
 
 permissions:
-  contents: write
+  contents: read
   packages: write
 
 jobs:
   publish:
-    uses: DCC-BS/ci-workflows/.github/workflows/publish-docker.yml@v4
+    uses: DCC-BS/ci-workflows/.github/workflows/publish-docker.yml@v7
     secrets: inherit
     with:
-      release_type: ${{ inputs.version_bump }} # major|minor|patch
       version_project_type: "python" # or "node"
-      version_uv_version: "0.9.14"
       registry: ghcr.io
       image_name: ghcr.io/${{ github.repository }}
       context: .

.github/workflows/main.yml

@@ -10,7 +10,7 @@ on:
 
 jobs:
   backend-ci:
-    uses: DCC-BS/ci-workflows/.github/workflows/python-backend-ci.yml@v4
+    uses: DCC-BS/ci-workflows/.github/workflows/python-backend-ci.yml@v7
     with:
       python_versions: '["3.10","3.11","3.12","3.13"]'
       quality_python_version: "3.12"

Dockerfile

@@ -1,6 +1,6 @@
 # Stage 1: Builder
-FROM python:3.14-alpine AS builder
-COPY --from=ghcr.io/astral-sh/uv:0.9.14 /uv /uvx /bin/
+FROM python:3.13-alpine AS builder
+COPY --from=ghcr.io/astral-sh/uv:0.9.25 /uv /uvx /bin/
 
 ENV UV_COMPILE_BYTECODE=1
 ENV UV_LINK_MODE=copy
@@ -28,7 +28,7 @@ RUN --mount=type=cache,target=/root/.cache/uv \
     uv sync --locked --no-dev
 
 # Stage 2: Runtime
-FROM python:3.14-alpine
+FROM python:3.13-alpine
 
 ENV PYTHONDONTWRITEBYTECODE=1
 ENV PYTHONUNBUFFERED=1

Makefile

@@ -10,8 +10,8 @@ check: ## Run code quality tools.
 	@uv lock --locked
 	@echo "🚀 Linting code: Running pre-commit"
 	@uv run pre-commit run -a
-	@echo "🚀 Static type checking: Running pyrefly"
-	@uv run pyrefly check ./src/transcribo_backend
+	@echo "🚀 Static type checking: Running ty"
+	@uv run ty check
 
 .PHONY: test
 test: ## Test the code with pytest
@@ -36,7 +36,7 @@ run: ## Run the application
 .PHONY: dev
 dev: ## Run the application in development mode
 	@echo "🚀 Running the application in development mode"
-	@uv run fastapi dev ./src/transcribo_backend/app.py --port 8000
+	@uv run --env-file .env fastapi dev ./src/transcribo_backend/app.py --port 8000
 
 .PHONY: build
 build: clean-build ## Build wheel file

pyproject.toml

@@ -2,10 +2,10 @@
 name = "transcribo-backend"
 version = "0.5.8"
 description = "The backend of the transcribo app"
-authors = [{name = "Data Competence Center Basel-Stadt", email = "dcc@bs.ch" },{ name = "Tobias Bollinger", email = "tobias.bollinger@gmail.com" }]
+authors = [{name = "Data Competence Center Basel-Stadt", email = "dcc@bs.ch" },{ name = "Tobias Bollinger", email = "tobias.bollinger@bs.ch" }, { name = "Yanick Schraner", email = "yanick.schraner@bs.ch" }]
 readme = "README.md"
 keywords = ['python']
-requires-python = ">=3.12,<4.0"
+requires-python = ">=3.12,<3.14"
 license = "MIT"
 license-files = ["LICEN[CS]E*"]
 classifiers = [
@@ -19,11 +19,12 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-    "aiohttp>=3.11.13",
-    "fastapi[standard]>=0.123.5",
-    "structlog>=25.1.0",
     "audioop-lts; python_version >= '3.13'",
-    "openai>=1.97.1",
+    "cachetools>=6.2.4",
+    "dcc-backend-common[fastapi]>=0.0.2",
+    "dependency-injector>=4.48.3",
+    "fastapi[standard]>=0.128.0",
+    "returns>=0.26.0",
 ]
 
 [project.urls]
@@ -38,14 +39,12 @@ dev = [
     "pre-commit>=2.20.0",
     "tox-uv>=1.11.3",
     "deptry>=0.22.0",
-    "basedpyright>=1.27.1",
     "pytest-cov>=6.0.0",
     "ruff>=0.9.2",
     "mkdocs>=1.4.2",
     "mkdocs-material>=8.5.10",
     "mkdocstrings[python]>=0.26.1",
-    "mypy>=1.15.0",
-    "pyrefly>=0.43.1",
+    "ty>=0.0.12",
 ]
 
 [build-system]
@@ -100,11 +99,6 @@ ignore = [
     "E731",
 ]
 
-[tool.pyrefly]
-project-includes = [
-    "src/**.py*",
-]
-
 [tool.ruff.lint.per-file-ignores]
 "tests/*" = ["S101"]
 

run.sh

@@ -1,43 +1,52 @@
 #!/bin/sh
 set -e
 
-if [ -f .env ]; then
-    # Load environment variables from .env file
-    . .env
-fi
-
-# Ensure PORT has a value (in case .env sets it to empty)
-PORT="${PORT:-8000}"
+# Default values (allow env overrides)
+DEV_MODE=${DEV_MODE:-false}
+PORT=${PORT:-8000}
 
 # Function to display help information
 show_help() {
     echo "Usage: $0 [options]"
     echo ""
     echo "Options:"
+    echo "  --dev              Run in development mode using 'fastapi dev'"
     echo "  --port NUMBER      Specify the port number (default: 8000)"
     echo "  --help             Display this help message"
     echo ""
     echo "Examples:"
     echo "  $0                 # Run in production mode on port 8000"
+    echo "  $0 --dev           # Run in development mode on port 8000"
     echo "  $0 --port 9000     # Run in production mode on port 9000"
+    echo "  $0 --dev --port 5000  # Run in development mode on port 5000"
     echo ""
 }
 
 # Parse command line arguments
 while [ "$#" -gt 0 ]; do
-    case $1 in
+    case "$1" in
+        --dev) DEV_MODE=true; shift ;;
         --port)
-            if [ -z "$2" ] || echo "$2" | grep -q "^-"; then
+            if [ -z "${2:-}" ]; then
                 echo "Error: --port requires a numeric argument"
                 show_help
                 exit 1
             fi
-            if ! echo "$2" | grep -Eq "^[0-9]+$"; then
+            case "$2" in
+                ''|*[!0-9]*)
+                    echo "Error: port must be a valid number"
+                    show_help
+                    exit 1
+                    ;;
+            esac
+            if [ "$2" -lt 1 ] || [ "$2" -gt 65535 ]; then
                 echo "Error: port must be a valid number"
                 show_help
                 exit 1
             fi
-        PORT="$2"; shift 2 ;;
+            PORT="$2"
+            shift 2
+            ;;
         --help)
             show_help
             exit 0
@@ -50,5 +59,11 @@ while [ "$#" -gt 0 ]; do
     esac
 done
 
-echo "Starting in production mode on port $PORT"
-fastapi run ./src/transcribo_backend/app.py --port "$PORT"
+# Choose command based on dev mode
+if [ "$DEV_MODE" = true ]; then
+    echo "Starting in development mode on port $PORT"
+    fastapi dev ./src/transcribo_backend/app.py --port "$PORT"
+else
+    echo "Starting in production mode on port $PORT"
+    fastapi run ./src/transcribo_backend/app.py --port "$PORT"
+fi