Add Home dashboard and usability polish

* New Home tab with overview text, live backend-readiness status,
  and quick-nav buttons to jump into other tabs.
* Main window registers Ctrl+1..5 shortcuts for tab navigation and
  surfaces worker log lines on the status bar.
* JSON editor accepts drag-and-drop of .json files, binds Ctrl+O /
  Ctrl+S / Ctrl+R to load / save / run, and remembers the last
  directory via QSettings.

Author: JE-Chen

automation_file/ui/log_widget.py

@@ -4,13 +4,16 @@
 
 import time
 
+from PySide6.QtCore import Signal
 from PySide6.QtGui import QTextCursor
 from PySide6.QtWidgets import QPlainTextEdit
 
 
 class LogPanel(QPlainTextEdit):
     """Read-only text panel that timestamps and appends log lines."""
 
+    message_appended = Signal(str)
+
     def __init__(self) -> None:
         super().__init__()
         self.setReadOnly(True)
@@ -21,3 +24,4 @@ def append_line(self, message: str) -> None:
         stamp = time.strftime("%H:%M:%S")
         self.appendPlainText(f"[{stamp}] {message}")
         self.moveCursor(QTextCursor.MoveOperation.End)
+        self.message_appended.emit(message)

automation_file/ui/main_window.py

@@ -2,12 +2,14 @@
 
 from __future__ import annotations
 
-from PySide6.QtCore import QThreadPool
+from PySide6.QtCore import Qt, QThreadPool
+from PySide6.QtGui import QKeySequence, QShortcut
 from PySide6.QtWidgets import QMainWindow, QSplitter, QTabWidget, QVBoxLayout, QWidget
 
 from automation_file.logging_config import file_automation_logger
 from automation_file.ui.log_widget import LogPanel
 from automation_file.ui.tabs import (
+    HomeTab,
     JSONEditorTab,
     LocalOpsTab,
     ServerTab,
@@ -16,6 +18,7 @@
 
 _WINDOW_TITLE = "automation_file"
 _DEFAULT_SIZE = (1100, 780)
+_STATUS_DEFAULT = "Ready"
 
 
 class MainWindow(QMainWindow):
@@ -28,17 +31,21 @@ def __init__(self) -> None:
 
         self._pool = QThreadPool.globalInstance()
         self._log = LogPanel()
+        self._log.message_appended.connect(self._on_log_message)
 
-        tabs = QTabWidget()
-        tabs.addTab(LocalOpsTab(self._log, self._pool), "Local")
-        tabs.addTab(TransferTab(self._log, self._pool), "Transfer")
-        tabs.addTab(JSONEditorTab(self._log, self._pool), "JSON actions")
+        self._tabs = QTabWidget()
+        self._home_tab = HomeTab(self._log, self._pool)
+        self._home_tab.navigate_to_tab.connect(self._focus_tab_by_name)
+        self._tabs.addTab(self._home_tab, "Home")
+        self._tabs.addTab(LocalOpsTab(self._log, self._pool), "Local")
+        self._tabs.addTab(TransferTab(self._log, self._pool), "Transfer")
+        self._tabs.addTab(JSONEditorTab(self._log, self._pool), "JSON actions")
         self._server_tab = ServerTab(self._log, self._pool)
-        tabs.addTab(self._server_tab, "Servers")
+        self._tabs.addTab(self._server_tab, "Servers")
 
         splitter = QSplitter()
-        splitter.setOrientation(splitter.orientation().Vertical)
-        splitter.addWidget(tabs)
+        splitter.setOrientation(Qt.Orientation.Vertical)
+        splitter.addWidget(self._tabs)
         splitter.addWidget(self._log)
         splitter.setStretchFactor(0, 4)
         splitter.setStretchFactor(1, 1)
@@ -49,9 +56,24 @@ def __init__(self) -> None:
         layout.addWidget(splitter)
         self.setCentralWidget(container)
 
-        self.statusBar().showMessage("Ready")
+        self._register_shortcuts()
+        self.statusBar().showMessage(_STATUS_DEFAULT)
         file_automation_logger.info("ui: main window constructed")
 
+    def _register_shortcuts(self) -> None:
+        for index in range(self._tabs.count()):
+            shortcut = QShortcut(QKeySequence(f"Ctrl+{index + 1}"), self)
+            shortcut.activated.connect(lambda i=index: self._tabs.setCurrentIndex(i))
+
+    def _focus_tab_by_name(self, name: str) -> None:
+        for index in range(self._tabs.count()):
+            if self._tabs.tabText(index) == name:
+                self._tabs.setCurrentIndex(index)
+                return
+
+    def _on_log_message(self, message: str) -> None:
+        self.statusBar().showMessage(message, 5000)
+
     def closeEvent(self, event) -> None:  # noqa: N802 — Qt override
         self._server_tab.closeEvent(event)
         super().closeEvent(event)

automation_file/ui/tabs/__init__.py

@@ -5,6 +5,7 @@
 from automation_file.ui.tabs.azure_tab import AzureBlobTab
 from automation_file.ui.tabs.drive_tab import GoogleDriveTab
 from automation_file.ui.tabs.dropbox_tab import DropboxTab
+from automation_file.ui.tabs.home_tab import HomeTab
 from automation_file.ui.tabs.http_tab import HTTPDownloadTab
 from automation_file.ui.tabs.json_editor_tab import JSONEditorTab
 from automation_file.ui.tabs.local_tab import LocalOpsTab
@@ -18,6 +19,7 @@
     "DropboxTab",
     "GoogleDriveTab",
     "HTTPDownloadTab",
+    "HomeTab",
     "JSONEditorTab",
     "LocalOpsTab",
     "S3Tab",

automation_file/ui/tabs/home_tab.py

@@ -0,0 +1,116 @@
+"""Landing dashboard — overview, backend readiness, quick actions."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import NamedTuple
+
+from PySide6.QtCore import QThreadPool, QTimer, Signal
+from PySide6.QtWidgets import (
+    QFormLayout,
+    QGroupBox,
+    QHBoxLayout,
+    QLabel,
+    QVBoxLayout,
+)
+
+from automation_file.remote.azure_blob.client import azure_blob_instance
+from automation_file.remote.dropbox_api.client import dropbox_instance
+from automation_file.remote.google_drive.client import driver_instance
+from automation_file.remote.s3.client import s3_instance
+from automation_file.remote.sftp.client import sftp_instance
+from automation_file.ui.log_widget import LogPanel
+from automation_file.ui.tabs.base import BaseTab
+
+_REFRESH_INTERVAL_MS = 2000
+
+
+class _BackendProbe(NamedTuple):
+    label: str
+    is_ready: Callable[[], bool]
+
+
+_BACKENDS: tuple[_BackendProbe, ...] = (
+    _BackendProbe("Google Drive", lambda: driver_instance.service is not None),
+    _BackendProbe("Amazon S3", lambda: s3_instance.client is not None),
+    _BackendProbe("Azure Blob", lambda: azure_blob_instance.service is not None),
+    _BackendProbe("Dropbox", lambda: dropbox_instance.client is not None),
+    _BackendProbe("SFTP", lambda: getattr(sftp_instance, "_sftp", None) is not None),
+)
+
+
+class HomeTab(BaseTab):
+    """Dashboard with overview text, backend status, and quick-nav buttons."""
+
+    navigate_to_tab = Signal(str)
+
+    def __init__(self, log: LogPanel, pool: QThreadPool) -> None:
+        super().__init__(log, pool)
+        self._status_labels: dict[str, QLabel] = {}
+
+        root = QVBoxLayout(self)
+        root.addWidget(self._overview_group())
+        row = QHBoxLayout()
+        row.addWidget(self._status_group(), 1)
+        row.addWidget(self._actions_group(), 1)
+        root.addLayout(row)
+        root.addStretch()
+
+        self._refresh_status()
+        self._timer = QTimer(self)
+        self._timer.setInterval(_REFRESH_INTERVAL_MS)
+        self._timer.timeout.connect(self._refresh_status)
+        self._timer.start()
+
+    def _overview_group(self) -> QGroupBox:
+        box = QGroupBox("automation_file")
+        layout = QVBoxLayout(box)
+        headline = QLabel(
+            "Automate local and remote file work through a shared registry of "
+            "<code>FA_*</code> actions."
+        )
+        headline.setWordWrap(True)
+        layout.addWidget(headline)
+        details = QLabel(
+            "Use <b>Local</b> for direct filesystem / ZIP operations, "
+            "<b>Transfer</b> to move bytes to cloud backends (HTTP, Drive, S3, "
+            "Azure, Dropbox, SFTP), and <b>JSON actions</b> for visual editing "
+            "of reusable action lists. <b>Servers</b> exposes the same registry "
+            "over localhost TCP or HTTP."
+        )
+        details.setWordWrap(True)
+        layout.addWidget(details)
+        return box
+
+    def _status_group(self) -> QGroupBox:
+        box = QGroupBox("Remote backends")
+        form = QFormLayout(box)
+        for probe in _BACKENDS:
+            label = QLabel("—")
+            self._status_labels[probe.label] = label
+            form.addRow(probe.label, label)
+        return box
+
+    def _actions_group(self) -> QGroupBox:
+        box = QGroupBox("Jump to…")
+        layout = QVBoxLayout(box)
+        for tab_name in ("Local", "Transfer", "JSON actions", "Servers"):
+            button = self.make_button(tab_name, self._emit_nav(tab_name))
+            layout.addWidget(button)
+        layout.addStretch()
+        return box
+
+    def _emit_nav(self, tab_name: str) -> Callable[[], None]:
+        return lambda: self.navigate_to_tab.emit(tab_name)
+
+    def _refresh_status(self) -> None:
+        for probe in _BACKENDS:
+            label = self._status_labels.get(probe.label)
+            if label is None:
+                continue
+            try:
+                ready = bool(probe.is_ready())
+            except Exception:  # pylint: disable=broad-except
+                ready = False
+            label.setText("Ready" if ready else "Not initialised")
+            label.setStyleSheet("color: #2f8f3f;" if ready else "color: #888;")

automation_file/ui/tabs/json_editor_tab.py

@@ -11,9 +11,11 @@
 import inspect
 import json
 from collections.abc import Callable
+from pathlib import Path
 from typing import Any
 
-from PySide6.QtCore import Qt
+from PySide6.QtCore import QSettings, Qt
+from PySide6.QtGui import QDragEnterEvent, QDropEvent, QKeySequence, QShortcut
 from PySide6.QtWidgets import (
     QCheckBox,
     QComboBox,
@@ -45,6 +47,9 @@
 
 _PATH_HINT_SUBSTRINGS = ("path", "_dir", "_file", "directory", "filename", "target")
 _SECRET_HINT_SUBSTRINGS = ("password", "secret", "token", "credential")
+_SETTINGS_ORG = "automation_file"
+_SETTINGS_APP = "ui"
+_LAST_JSON_DIR_KEY = "json_editor/last_dir"
 
 
 def _is_path_like(name: str) -> bool:
@@ -237,6 +242,8 @@ def __init__(self, log, pool) -> None:
         self._current_form: _ActionForm | None = None
         self._current_form_row: int = -1
         self._suppress_sync = False
+        self._settings = QSettings(_SETTINGS_ORG, _SETTINGS_APP)
+        self.setAcceptDrops(True)
 
         self._action_list = QListWidget()
         self._action_list.currentRowChanged.connect(self._on_row_changed)
@@ -261,6 +268,8 @@ def __init__(self, log, pool) -> None:
         root.addWidget(splitter)
         root.addWidget(self._build_run_bar())
 
+        self._register_shortcuts()
+
     def _build_toolbar(self) -> QWidget:
         toolbar = QWidget()
         row = QHBoxLayout(toolbar)
@@ -431,9 +440,15 @@ def _unpack_action(action: list[Any]) -> tuple[str, dict[str, Any]]:
         return name, {}
 
     def _on_load(self) -> None:
-        path, _ = QFileDialog.getOpenFileName(self, "Load action JSON", filter="JSON (*.json)")
+        start_dir = str(self._settings.value(_LAST_JSON_DIR_KEY, ""))
+        path, _ = QFileDialog.getOpenFileName(
+            self, "Load action JSON", start_dir, filter="JSON (*.json)"
+        )
         if not path:
             return
+        self._load_path(path)
+
+    def _load_path(self, path: str) -> None:
         try:
             with open(path, encoding="utf-8") as fp:
                 data = json.load(fp)
@@ -444,12 +459,18 @@ def _on_load(self) -> None:
             self._log.append_line("load error: top-level JSON must be an array")
             return
         self._actions = data
+        self._settings.setValue(_LAST_JSON_DIR_KEY, str(Path(path).parent))
+        self._clear_current_form()
         self._refresh_list(select=0 if data else None)
         self._sync_raw_from_model()
+        self._log.append_line(f"loaded {len(data)} actions from {path}")
 
     def _on_save(self) -> None:
         self._commit_current_form()
-        path, _ = QFileDialog.getSaveFileName(self, "Save action JSON", filter="JSON (*.json)")
+        start_dir = str(self._settings.value(_LAST_JSON_DIR_KEY, ""))
+        path, _ = QFileDialog.getSaveFileName(
+            self, "Save action JSON", start_dir, filter="JSON (*.json)"
+        )
         if not path:
             return
         try:
@@ -458,6 +479,7 @@ def _on_save(self) -> None:
         except OSError as error:
             self._log.append_line(f"save error: {error}")
             return
+        self._settings.setValue(_LAST_JSON_DIR_KEY, str(Path(path).parent))
         self._log.append_line(f"saved {len(self._actions)} actions to {path}")
 
     def _on_clear(self) -> None:
@@ -536,3 +558,38 @@ def _on_validate(self) -> None:
             f"validate_action({len(actions)})",
             kwargs={"action_list": actions},
         )
+
+    def _register_shortcuts(self) -> None:
+        for keys, handler in (
+            ("Ctrl+O", self._on_load),
+            ("Ctrl+S", self._on_save),
+            ("Ctrl+R", self._on_run),
+        ):
+            shortcut = QShortcut(QKeySequence(keys), self)
+            shortcut.setContext(Qt.ShortcutContext.WidgetWithChildrenShortcut)
+            shortcut.activated.connect(handler)
+
+    def dragEnterEvent(self, event: QDragEnterEvent) -> None:  # noqa: N802 — Qt override
+        if self._is_json_drop(event):
+            event.acceptProposedAction()
+            return
+        event.ignore()
+
+    def dropEvent(self, event: QDropEvent) -> None:  # noqa: N802 — Qt override
+        if not self._is_json_drop(event):
+            event.ignore()
+            return
+        url = event.mimeData().urls()[0]
+        self._load_path(url.toLocalFile())
+        event.acceptProposedAction()
+
+    @staticmethod
+    def _is_json_drop(event: QDragEnterEvent | QDropEvent) -> bool:
+        mime = event.mimeData()
+        if not mime.hasUrls():
+            return False
+        urls = mime.urls()
+        if not urls:
+            return False
+        local = urls[0].toLocalFile()
+        return bool(local) and local.lower().endswith(".json")

docs/source/api/ui.rst

@@ -38,6 +38,9 @@ Tabs
 .. automodule:: automation_file.ui.tabs.base
    :members:
 
+.. automodule:: automation_file.ui.tabs.home_tab
+   :members:
+
 .. automodule:: automation_file.ui.tabs.local_tab
    :members:
 

tests/test_ui_smoke.py

@@ -54,6 +54,7 @@ def test_main_window_constructs(qt_app) -> None:
         "JSONEditorTab",
         "ServerTab",
         "TransferTab",
+        "HomeTab",
     ],
 )
 def test_each_tab_constructs(qt_app, tab_name: str) -> None: