ZMB Webui: Complete Project – Rebrand & Initial Clean Commit

ARCHITECTURE
============
Backend: FastAPI + uvicorn (port 8000)
  - JWT authentication with PAM system users
  - ZFS CLI wrapper with caching (30-60s TTL)
  - WebSocket pool status broadcaster (30s interval)
  - Services: auth, zfs_runner, file_manager, shares, identities, system_info
  - Routers: pools, datasets, snapshots, shares, identities, navigator, system

Frontend: Next.js 15 + TypeScript (static export)
  - Incremental Static Regeneration (ISR) for weak hardware
  - Type-safe API client (lib/api.ts)
  - Dark mode + custom Tailwind theme
  - Pages: Dashboard, Login, Snapshots, Datasets, Shares, etc.

DEPLOYMENT
==========
Test Target: 192.168.1.179:8090 (Debian LXC)
Production: 10.66.120.3:9090 (Raspberry Pi 4GB ARM64)
Updater: Automated Gitea-based deployment (update-test.sh, update-pi.sh)

FEATURES COMPLETED
==================
Phase 3a: Dashboard Quick Stats (System, CPU, Memory, Storage)
  - Real-time stats with color-coded progress bars
  - Responsive grid layout (mobile: 1, tablet: 2, desktop: 4 columns)
  - ISR-optimized for fast loads on weak hardware

REBRANDING
==========
Renamed throughout:
  - Project: 'ZFS Manager' → 'ZMB Webui'
  - Services: 'zfs-manager' → 'zmb-webui'
  - Systemd units: zfs-manager-backend → zmb-webui-backend
  - Configuration files and documentation

Co-Authored-By: Patrick <patrick@perlbach24.de>

backend/models/__init__.py

@@ -0,0 +1,6 @@
+from .pool import Pool, PoolStatus, PoolHealth, Vdev
+from .dataset import Dataset, DatasetType
+from .snapshot import Snapshot
+from .auth import Token, TokenData, User
+
+__all__ = ["Pool", "PoolStatus", "PoolHealth", "Vdev", "Dataset", "DatasetType", "Snapshot", "Token", "TokenData", "User"]

backend/models/auth.py

@@ -0,0 +1,16 @@
+from pydantic import BaseModel
+from typing import Optional
+
+
+class User(BaseModel):
+    username: str
+    disabled: Optional[bool] = None
+
+
+class Token(BaseModel):
+    access_token: str
+    token_type: str
+
+
+class TokenData(BaseModel):
+    username: Optional[str] = None

backend/models/dataset.py

@@ -0,0 +1,36 @@
+from pydantic import BaseModel
+from typing import Optional
+from enum import Enum
+
+
+class DatasetType(str, Enum):
+    FILESYSTEM = "filesystem"
+    VOLUME = "volume"
+    SNAPSHOT = "snapshot"
+
+
+class Dataset(BaseModel):
+    name: str
+    type: DatasetType
+    used: int  # bytes
+    avail: int  # bytes
+    refer: int  # bytes (how much data is actually in dataset)
+    mountpoint: Optional[str] = None
+    compression: Optional[str] = None
+    quota: Optional[int] = None
+    reservation: Optional[int] = None
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "name": "tank/share",
+                "type": "filesystem",
+                "used": 2040109465,
+                "avail": 1825361511,
+                "refer": 1900000000,
+                "mountpoint": "/tank/share",
+                "compression": "lz4",
+                "quota": None,
+                "reservation": None
+            }
+        }

backend/models/pool.py

@@ -0,0 +1,96 @@
+from pydantic import BaseModel
+from typing import Optional, List
+from enum import Enum
+
+
+class PoolHealth(str, Enum):
+    ONLINE = "ONLINE"
+    DEGRADED = "DEGRADED"
+    FAULTED = "FAULTED"
+    OFFLINE = "OFFLINE"
+    UNAVAIL = "UNAVAIL"
+
+
+class Vdev(BaseModel):
+    name: str
+    state: str
+    read: int = 0  # Read error count
+    write: int = 0  # Write error count
+    cksum: int = 0  # Checksum error count
+    children: List["Vdev"] = []
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "name": "mirror-0",
+                "state": "ONLINE",
+                "read": 0,
+                "write": 0,
+                "cksum": 0,
+                "children": [
+                    {"name": "sda", "state": "ONLINE", "read": 0, "write": 0, "cksum": 0},
+                    {"name": "sdb", "state": "ONLINE", "read": 0, "write": 0, "cksum": 0}
+                ]
+            }
+        }
+
+
+# Update forward reference for recursive type
+Vdev.model_rebuild()
+
+
+class Pool(BaseModel):
+    name: str
+    size: int  # bytes
+    alloc: int  # bytes
+    free: int  # bytes
+    fragmentation: str  # percentage
+    capacity: str  # percentage
+    health: PoolHealth
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "name": "tank",
+                "size": 3865470976,
+                "alloc": 2040109465,
+                "free": 1825361511,
+                "fragmentation": "0%",
+                "capacity": "52%",
+                "health": "ONLINE"
+            }
+        }
+
+
+class PoolStatus(BaseModel):
+    name: str
+    state: Optional[str] = None
+    health: PoolHealth
+    scan: Optional[str] = None
+    errors: Optional[str] = None
+    last_scrub: Optional[str] = None
+    vdevs: List[Vdev] = []
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "name": "tank",
+                "state": "ONLINE",
+                "health": "ONLINE",
+                "scan": "scrub in progress since Sat Apr 14 10:30:00 2026",
+                "errors": "No known data errors",
+                "vdevs": [
+                    {
+                        "name": "mirror-0",
+                        "state": "ONLINE",
+                        "read": 0,
+                        "write": 0,
+                        "cksum": 0,
+                        "children": [
+                            {"name": "sda", "state": "ONLINE", "read": 0, "write": 0, "cksum": 0},
+                            {"name": "sdb", "state": "ONLINE", "read": 0, "write": 0, "cksum": 0}
+                        ]
+                    }
+                ]
+            }
+        }

backend/models/snapshot.py

@@ -0,0 +1,24 @@
+from pydantic import BaseModel
+from typing import Optional
+from datetime import datetime
+
+
+class Snapshot(BaseModel):
+    name: str
+    dataset: str  # parent dataset
+    created: int  # Unix timestamp
+    used: int  # bytes
+    referenced: int  # bytes
+    creation_datetime: Optional[str] = None  # ISO format for API
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "name": "tank/share@2026-04-14-120000",
+                "dataset": "tank/share",
+                "created": 1713089400,
+                "used": 0,
+                "referenced": 1900000000,
+                "creation_datetime": "2026-04-14T12:00:00Z"
+            }
+        }