feat(store): схемы/модели/ошибки слоя хранения (#20)

backend/awg_api/store/errors.py

@@ -0,0 +1,33 @@
+"""Иерархия ошибок хранилища awg-dash."""
+
+from __future__ import annotations
+
+
+class StorageError(RuntimeError):
+    """Базовая ошибка слоя хранения состояния."""
+
+
+class SchemaError(StorageError):
+    """Схема БД не соответствует ожидаемой версии (или требует отката)."""
+
+
+class ValidationError(StorageError):
+    """Данные не прошли валидацию до применения (стадия validate)."""
+
+    def __init__(self, field: str, message: str) -> None:
+        super().__init__(f"{field}: {message}")
+        self.field = field
+        self.message = message
+
+
+class ApplyError(StorageError):
+    """Ошибка применения конфигурации.
+
+    ``restored`` — предыдущее состояние подтверждённо восстановлено,
+    ``audit_id`` — id записи в audit_log, статус ``failed``.
+    """
+
+    def __init__(self, message: str, *, restored: bool, audit_id: int | None) -> None:
+        super().__init__(message)
+        self.restored = restored
+        self.audit_id = audit_id