Backport improvements (#263)

* Replaces SQLite with MariaDB (tests still running on SQLite for now)
* Uses docker as default to run the infrastructure (still keeping run configurations in PyCharm for easy debugging)
* Add CORS middleware support
* Support a test di_container in FastAPI and SocketIO applications (we'll want a common DI implementation for all applications, not the FastAPI one)

Author: febus982

.gitignore

@@ -284,3 +284,4 @@ dmypy.json
 cython_debug/
 
 credentials.env
+volumes/

.idea/dataSources.xml

@@ -4,13 +4,16 @@ containers:
 	docker compose build --build-arg UID=`id -u`
 
 dev-http:
-	uv run ./src/http_app/dev_server.py
+	docker compose up dev-http
 
 dev-socketio:
-	uv run ./src/socketio_app/dev_server.py
+	docker compose up dev-socketio
 
-run:
-	uv run uvicorn http_app:create_app --host 0.0.0.0 --port 8000 --factory
+migrate:
+	docker compose run --rm migrate
+
+autogenerate-migration:
+	docker compose run --rm autogenerate-migration
 
 test:
 	uv run pytest -n auto --cov
@@ -34,9 +37,6 @@ update-dependencies:
 	uv lock --upgrade
 	uv sync --all-groups --frozen
 
-migrate:
-	uv run alembic upgrade heads
-
 format:
 	uv run ruff format --check .
 
@@ -53,8 +53,5 @@ check: lint format typing test
 docs:
 	uv run mkdocs serve
 
-adr:
-	adr-viewer --serve --adr-path docs/adr
-
 docs-build:
 	uv run mkdocs build

.idea/runConfigurations/Dev_Dependencies.xml

@@ -44,29 +44,31 @@ Create your GitHub repository using this template (The big green `Use this templ
 Optionally tweak name and authors in the `pyproject.toml` file, however the metadata
 are not used when building the application, nor are referenced anywhere in the code.
 
-Before running any commands, install `uv`:
+Before running any commands, install `uv` and `Docker`:
 
-- On Mac (using `brew`): `brew install uv`
+- You can install `uv` on Mac using `brew`: `brew install uv`
+- Download and install Docker: https://www.docker.com/products/docker-desktop/
 
 Using Docker:
 
 * `make containers`: Build containers
-* `docker compose run --rm dev make migrate`: Run database migrations
 * `docker compose up dev-http`: Run HTTP application with hot reload
 * `docker compose up dev-socketio`: Run HTTP application with hot reload
 * `docker compose up dramatiq-worker`: Run the dramatiq worker
 * `docker compose run --rm test`: Run test suite
+* `docker compose run --rm migrate`: Run database migrations
+* `docker compose run --rm autogenerate-migration`: Generate a new migration file
 
-Locally:
+Using Make (you still need Docker for most of them):
 
-* `make migrate`: Run database migrations
 * `make install-dependencies`: Install requirements
 * `make dev-dependencies`: Install dev requirements
 * `make update-dependencies`: Updates requirements
-* `make migrate`: Run database migrations
 * `make dev-http`: Run HTTP application with hot reload
 * `make dev-socketio`: Run HTTP application with hot reload
 * `make test`: Run test suite
+* `make migrate`: Run database migrations
+* `make autogenerate-migration`: Generate a new migration file
 
 ## Other commands for development
 

.idea/runConfigurations/FastAPI_app.xml

@@ -67,3 +67,7 @@ version_path_separator = os  # Use os.pathsep. Default configuration used for ne
 # black.type = console_scripts
 # black.entrypoint = black
 # black.options = -l 79 REVISION_SCRIPT_FILENAME
+hooks = ruff
+ruff.type = exec
+ruff.executable = %(here)s/.venv/bin/ruff
+ruff.options = format REVISION_SCRIPT_FILENAME

.idea/runConfigurations/Socket_io_app.xml

@@ -0,0 +1,3 @@
+GC_USERNAME: <GRAFANA_USERNAME>
+GC_PASSWORD: <GRAFANA_TOKEN>
+GC_ENDPOINT: <GRAFANA_OTLP_ENDPOINT>

Makefile

@@ -4,25 +4,29 @@ services:
       dockerfile: Dockerfile
       context: .
       target: dev
-    env_file: local.env
+    env_file: docker.env
     environment:
-      APP_NAME: "bootstrap-fastapi"
+      APP_NAME: "backend-fastapi"
     ports:
       - '8000:8000'
     working_dir: "/app/src"
     volumes:
       - '.:/app'
     depends_on:
-      - redis
-      - otel-collector
+      redis:
+        condition: service_healthy
+      otel-collector:
+        condition: service_started
+      mariadb:
+        condition: service_healthy
     command:
       - python
       - ./http_app/dev_server.py
 
   dev-socketio:
     <<: *dev
     environment:
-      APP_NAME: "bootstrap-socketio"
+      APP_NAME: "backend-socketio"
     ports:
       - '8001:8001'
     command:
@@ -52,6 +56,7 @@ services:
       - jaeger
     ports:
       - "12345:12345"
+      - "4317:4317"
     volumes:
       - ./config.alloy:/etc/alloy/config.alloy
     command:
@@ -63,11 +68,34 @@ services:
 
   redis:
     image: redis
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  mariadb:
+    image: mariadb:11.4
+    environment:
+      MYSQL_ROOT_PASSWORD: "stanis"
+      MYSQL_DATABASE: "backend"
+      MYSQL_USER: "corinna"
+      MYSQL_PASSWORD: "gioieiiere"
+    volumes:
+      - ./volumes/mariadb:/var/lib/mysql
+    ports:
+      - "3306:3306"
+    healthcheck:
+      test: [ "CMD", "healthcheck.sh", "--su-mysql", "--connect", "--innodb_initialized" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 30s
 
   dramatiq-worker:
     <<: *dev
     environment:
-      APP_NAME: "bootstrap-dramatiq-worker"
+      APP_NAME: "backend-dramatiq-worker"
     ports: []
     command:
       - dramatiq
@@ -151,12 +179,32 @@ services:
   #### One-off commands ####
   ##########################
   test:
-    build:
-      dockerfile: Dockerfile
-      context: .
-      target: dev
-    volumes:
-      - '.:/app'
+    <<: *dev
+    environment:
+      APP_NAME: "backend-test"
+    ports: []
     command:
       - "make"
       - "test"
+
+  migrate:
+    <<: *dev
+    environment:
+      APP_NAME: "backend-migrations"
+    ports: []
+    command:
+      - "alembic"
+      - "upgrade"
+      - "heads"
+
+  autogenerate-migration:
+    <<: *dev
+    environment:
+      APP_NAME: "backend-migration-generator"
+    ports: []
+    command:
+      - "alembic"
+      - "revision"
+      - "--autogenerate"
+      - "-m"
+      - "Description message"