Add dockerized Magnit API service

.dockerignore

@@ -1,5 +1,6 @@
 # Secrets and local runtime state
 magnit_session.json
+data/
 .env
 .env.*
 *.log

.gitignore

@@ -1,5 +1,7 @@
 # Secrets and local runtime state
 magnit_session.json
+data/*
+!data/.gitkeep
 .env
 .env.*
 

Dockerfile

@@ -13,4 +13,4 @@ COPY README.md /app/README.md
 
 EXPOSE 8080
 
-CMD ["python3", "magnit_api.py", "--session-file", "/app/magnit_session.json", "serve", "--host", "0.0.0.0", "--port", "8080"]
+CMD ["python3", "magnit_api.py", "--session-file", "/data/magnit_session.json", "serve", "--host", "0.0.0.0", "--port", "8080"]

README.md

@@ -25,6 +25,7 @@ docker compose up -d --build
 ```
 
 По умолчанию сервис публикуется только в loopback на `127.0.0.1:18080`.
+Docker хранит session-файл в `./data/magnit_session.json`, а не в корне проекта.
 
 Проверка:
 
@@ -140,3 +141,5 @@ curl -X POST "http://127.0.0.1:18080/session/bootstrap" \
   -H "Content-Type: application/json" \
   -d @payload.json
 ```
+
+При Docker session сохранится в `./data/magnit_session.json`.

data/.gitkeep

@@ -0,0 +1 @@
+

docker-compose.yml

@@ -8,7 +8,7 @@ services:
     ports:
       - "127.0.0.1:${MAGNIT_API_PORT:-18080}:8080"
     volumes:
-      - ./magnit_session.json:/app/magnit_session.json:rw
+      - ./data:/data
     healthcheck:
       test:
         [

magnit_api.py

@@ -54,15 +54,30 @@ class SessionConfig:
                 f"Файл сессии не найден: {path}. "
                 "Создайте его через POST /session/bootstrap или команду bootstrap."
             )
+        if path.is_dir():
+            raise MagnitError(
+                f"Ожидался JSON-файл сессии, но путь является директорией: {path}. "
+                "Проверьте docker volume mount."
+            )
         return cls(**json.loads(path.read_text(encoding="utf-8")))
 
     @classmethod
     def load_or_default(cls, path: Path) -> "SessionConfig":
         if not path.exists():
             return cls()
+        if path.is_dir():
+            raise MagnitError(
+                f"Ожидался JSON-файл сессии, но путь является директорией: {path}. "
+                "Проверьте docker volume mount."
+            )
         return cls.load(path)
 
     def save(self, path: Path) -> None:
+        if path.exists() and path.is_dir():
+            raise MagnitError(
+                f"Невозможно сохранить сессию: путь является директорией, а не файлом: {path}."
+            )
+        path.parent.mkdir(parents=True, exist_ok=True)
         path.write_text(
             json.dumps(asdict(self), ensure_ascii=False, indent=2) + "\n",
             encoding="utf-8",
@@ -193,7 +208,7 @@ class MagnitClient:
     def __init__(self, session_path: Path = SESSION_FILE, timeout_seconds: int = DEFAULT_TIMEOUT_SECONDS):
         self.session_path = session_path
         self.timeout_seconds = timeout_seconds
-        self.session_config = SessionConfig.load(session_path)
+        self.session_config = SessionConfig.load_or_default(session_path)
         self.http = requests.Session()
         self._sync_cookies()