Ver Fonte

Maintenance: a log of every reset, with a comment, exportable as CSV (#3557) (#3569)

Niklas há 3 dias atrás
pai
commit
8afcb3fbdc
34 ficheiros alterados com 2463 adições e 53 exclusões
  1. 1 1
      CHANGELOG.md
  2. 223 6
      backend/app/api/routes/maintenance.py
  3. 41 0
      backend/app/core/database.py
  4. 11 0
      backend/app/core/sqlite_fk.py
  5. 2 1
      backend/app/models/__init__.py
  6. 36 0
      backend/app/models/maintenance.py
  7. 40 2
      backend/app/schemas/maintenance.py
  8. 47 2
      backend/app/services/export.py
  9. 425 0
      backend/tests/integration/test_maintenance_log.py
  10. 45 0
      backend/tests/unit/test_maintenance_log_actor.py
  11. 125 0
      backend/tests/unit/test_maintenance_log_backfill.py
  12. 36 0
      backend/tests/unit/test_maintenance_log_csv.py
  13. 384 17
      frontend/src/__tests__/pages/MaintenancePageWiring.test.tsx
  14. 62 0
      frontend/src/api/client.ts
  15. 9 4
      frontend/src/components/ConfirmModal.tsx
  16. 59 0
      frontend/src/components/MaintenanceLogCleanupModal.tsx
  17. 257 0
      frontend/src/components/MaintenanceLogModal.tsx
  18. 31 0
      frontend/src/i18n/locales/de.ts
  19. 31 0
      frontend/src/i18n/locales/en.ts
  20. 31 0
      frontend/src/i18n/locales/es.ts
  21. 31 0
      frontend/src/i18n/locales/fr.ts
  22. 31 0
      frontend/src/i18n/locales/it.ts
  23. 31 0
      frontend/src/i18n/locales/ja.ts
  24. 32 1
      frontend/src/i18n/locales/ko.ts
  25. 31 0
      frontend/src/i18n/locales/nl.ts
  26. 31 0
      frontend/src/i18n/locales/pl.ts
  27. 31 0
      frontend/src/i18n/locales/pt-BR.ts
  28. 31 0
      frontend/src/i18n/locales/ru.ts
  29. 31 0
      frontend/src/i18n/locales/sv.ts
  30. 31 0
      frontend/src/i18n/locales/tr.ts
  31. 31 0
      frontend/src/i18n/locales/uk.ts
  32. 31 0
      frontend/src/i18n/locales/zh-CN.ts
  33. 31 0
      frontend/src/i18n/locales/zh-TW.ts
  34. 163 19
      frontend/src/pages/MaintenancePage.tsx

+ 1 - 1
CHANGELOG.md

@@ -8,7 +8,7 @@ All notable changes to Bambuddy will be documented in this file.
 - **The MQTT relay's printer status has the door, extruder, filament and HMS errors, and the broker gets a Last Will (#3401, requested by @Tomat0r; #1850, requested by @DingoPD, contributed by @Keybored02 in #3541)** — Home Assistant had to poll REST for these. `bambuddy/printers/{serial}/status` now carries `door_open`, `active_extruder` (which nozzle prints on a dual-nozzle printer), `tray_now`, `ams`, `vt_tray` (the loaded filaments, with their type and colour) and `hms_errors`, in the shape the REST status has. The relay also tells the broker to publish `{"status": "offline"}` on `bambuddy/status` if the connection drops without a clean disconnect, so a crash or a killed container no longer leaves the retained `online` standing, and a printer dropping is published even when a regular update went out less than a second before.
 - **The profile editor offers the material types of the preferred slicer (#2928, requested by @doncaruana, contributed by @Keybored02 in #3544)** — The **Filament Type** dropdown of a filament profile was one list kept in Bambuddy, with types a slicer does not know (and without ones it does), so a profile could be valid here and not in the slicer. It now offers the types of the slicer chosen under Settings → Slicer: Bambu Studio's or OrcaSlicer's, which differ (Orca has SBS and the PA11/PA12 families, Bambu Studio has TPU-AMS). A profile keeps the type it has, imported or cloud-synced, even if the list does not have it, and changing the preferred slicer changes no existing profile.
 - **The slicer sidecars can be published on one address only (suggested by @pleasantone)** — The sidecar compose file published the slicer ports on every network interface, and the sidecars have no login. The new `SIDECAR_BIND` setting in `slicer-api/.env` limits them to one address: `127.0.0.1` when Bambuddy runs on the same host with its default `network_mode: host`. Left unset, nothing changes, so Bambuddy in bridge mode or on another host still reaches the sidecars
-
+- **A maintenance log for each printer, with a comment on every reset (#3557, requested and contributed by @Alphakilo in #3569)** — Resetting a maintenance task now asks first and takes an optional comment (what was done, parts used, up to 10,000 characters). Every reset is logged with the task, the printer, who did it (when authentication is on) and when, with the print hours at the time. The **Log** button on each printer of the Maintenance page lists its resets, newest first, and **Export CSV** downloads them; **Export log** at the top downloads the log of every printer as one CSV, including printers that have since been deleted. Entries keep the printer, task and user names as they were, so the log outlives a deleted printer, custom task or user. Earlier resets are copied into the log once, on upgrade, without a user, as none was recorded. Entries are kept until deleted: **Clean up** in a printer's log, or **Clean up log** at the top for every printer, deletes the entries older than a chosen number of days (at least one), and a single entry, such as a reset made by mistake, can be deleted from the log (the task stays reset). A deleted entry is gone with its comment, from the task's reset history too. The log is read with the maintenance read permission and cleaned up with the maintenance delete permission, and a user limited to some printers sees and cleans up only theirs. Comments that look like spreadsheet formulas are exported as text.
 ### Changed
 - **The debug log shows what a command the printer reports back contains (#3531)** — The printer reports every command it receives back to Bambuddy, also the ones sent from its own touchscreen, and the debug log kept only their names. It now records their content too, so a support package captures exactly what a touchscreen action sends, such as the H3C's Unload All. Status updates and print starts stay name-only: the first arrives every second, the second may carry a signed download link.
 - **A slice sent again from the slicer adds a print to its archive (#1634, requested by @d3nn3s08, contributed by @Keybored02 in #3508)** — A print from the File Manager or the queue already joined the archive of its file, but a print sent from Bambu Studio or OrcaSlicer, or started on the printer, always got a new archive: the slicer writes a new 3MF each time it sends, so the file never matched, and the archive's print count stayed at one. Bambuddy now also keeps the hash of each archive's G-code, and a print whose G-code matches an archive nobody owns, in no project and not from a File Manager file adds a run to that archive. The archive takes the new 3MF in place of its old one and keeps its photos, timelapses, notes, tags and earlier runs; a name set by hand stays, and a name taken from the file follows the new file. While another print of it is running, the archive keeps its file and only gets the run. A model sliced again with other settings gets an archive of its own. OrcaSlicer writes the slicing time into the G-code, so with it only the same slice sent again matches. Archives made before are read once in the background after the update. Wiki updated.

+ 223 - 6
backend/app/api/routes/maintenance.py

@@ -1,15 +1,19 @@
 """Maintenance tracking API routes."""
 
 import logging
-from datetime import datetime, timezone
+from datetime import datetime, timedelta, timezone
+from typing import cast
 
-from fastapi import APIRouter, Depends, HTTPException
-from sqlalchemy import select
+from fastapi import APIRouter, Depends, HTTPException, Query, Response
+from sqlalchemy import delete, func, select
+from sqlalchemy.engine import CursorResult
 from sqlalchemy.exc import IntegrityError
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 
 from backend.app.core.auth import (
+    ApiKeyActor,
+    RequestActor,
     RequestPrinterScope,
     RequirePermissionIfAuthEnabled,
     RequirePrinterPermissionIfAuthEnabled,
@@ -17,11 +21,18 @@ from backend.app.core.auth import (
 from backend.app.core.database import get_db
 from backend.app.core.permissions import Permission
 from backend.app.core.printer_scope import PrinterScope
-from backend.app.models.maintenance import MaintenanceHistory, MaintenanceType, PrinterMaintenance
+from backend.app.models.maintenance import (
+    MaintenanceHistory,
+    MaintenanceLogEntry,
+    MaintenanceType,
+    PrinterMaintenance,
+)
 from backend.app.models.printer import Printer
 from backend.app.models.user import User
 from backend.app.schemas.maintenance import (
     MaintenanceHistoryResponse,
+    MaintenanceLogEntryResponse,
+    MaintenanceLogPage,
     MaintenanceStatus,
     MaintenanceTypeCreate,
     MaintenanceTypeResponse,
@@ -31,7 +42,10 @@ from backend.app.schemas.maintenance import (
     PrinterMaintenanceResponse,
     PrinterMaintenanceUpdate,
 )
+from backend.app.services.export import ExportService
 from backend.app.services.notification_service import notification_service
+from backend.app.utils.http import build_content_disposition
+from backend.app.utils.local_time import utcnow_naive
 from backend.app.utils.printer_models import get_rod_type, normalize_printer_model_id
 
 logger = logging.getLogger(__name__)
@@ -820,8 +834,9 @@ async def perform_maintenance(
     db: AsyncSession = Depends(get_db, scope="function"),
     _: User | None = RequirePermissionIfAuthEnabled(Permission.MAINTENANCE_UPDATE),
     printer_scope: PrinterScope = RequestPrinterScope,
+    actor: User | ApiKeyActor | None = RequestActor,
 ):
-    """Mark maintenance as performed (reset the counter)."""
+    """Mark maintenance as performed (reset the counter) and log it."""
     result = await db.execute(
         select(PrinterMaintenance)
         .where(PrinterMaintenance.id == item_id)
@@ -838,16 +853,39 @@ async def perform_maintenance(
     # Get current hours
     current_hours = await get_printer_total_hours(db, item.printer_id)
 
+    now_utc = datetime.now(timezone.utc)
+    # Stored naive, as UTC, like every other time in the database.
+    now = now_utc.replace(tzinfo=None)
+
     # Create history entry
     history = MaintenanceHistory(
         printer_maintenance_id=item.id,
+        performed_at=now,
         hours_at_maintenance=current_hours,
         notes=data.notes,
     )
     db.add(history)
+    await db.flush()
+
+    # The audit log entry, which outlives the printer, the task and the user.
+    performed_by_id, performed_by_username = _actor_identity(actor)
+    db.add(
+        MaintenanceLogEntry(
+            printer_id=printer.id,
+            printer_name=printer.name,
+            maintenance_type_id=item.maintenance_type_id,
+            maintenance_type_name=item.maintenance_type.name,
+            hours_at_maintenance=current_hours,
+            notes=data.notes,
+            performed_by_id=performed_by_id,
+            performed_by_username=performed_by_username,
+            performed_at=now,
+            history_id=history.id,
+        )
+    )
 
     # Update item
-    item.last_performed_at = datetime.now(timezone.utc)
+    item.last_performed_at = now_utc
     item.last_performed_hours = current_hours
 
     await db.commit()
@@ -915,6 +953,185 @@ async def get_maintenance_history(
     return result.scalars().all()
 
 
+# ============== Maintenance Log ==============
+
+
+def _actor_identity(actor: User | ApiKeyActor | None) -> tuple[int | None, str | None]:
+    """Who to log a reset as: the user, an API key's owner, or a legacy key by its name.
+
+    Nobody (None, None) when authentication is off. An ``ApiKeyActor`` has its
+    owner's id and username, both None for a key without an owner.
+    """
+    if actor is None:
+        return None, None
+    if isinstance(actor, ApiKeyActor) and actor.username is None:
+        return None, f"API key: {actor.api_key.name}"[:100]
+    return actor.id, actor.username
+
+
+_NEWEST_FIRST = (MaintenanceLogEntry.performed_at.desc(), MaintenanceLogEntry.id.desc())
+
+
+async def _ensure_printer(db: AsyncSession, printer_id: int) -> Printer:
+    printer = await db.get(Printer, printer_id)
+    if printer is None:
+        raise HTTPException(status_code=404, detail="Printer not found")
+    return printer
+
+
+@router.get("/printers/{printer_id}/log", response_model=MaintenanceLogPage)
+async def get_printer_maintenance_log(
+    printer_id: int,
+    limit: int = Query(50, ge=1, le=500),
+    offset: int = Query(0, ge=0),
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePrinterPermissionIfAuthEnabled(Permission.MAINTENANCE_READ),
+):
+    """A printer's maintenance log, newest first."""
+    await _ensure_printer(db, printer_id)
+    where = MaintenanceLogEntry.printer_id == printer_id
+    total = await db.scalar(select(func.count()).select_from(MaintenanceLogEntry).where(where)) or 0
+    result = await db.execute(
+        select(MaintenanceLogEntry).where(where).order_by(*_NEWEST_FIRST).limit(limit).offset(offset)
+    )
+    items = [MaintenanceLogEntryResponse.model_validate(entry) for entry in result.scalars().all()]
+    return MaintenanceLogPage(items=items, total=total)
+
+
+def _csv_response(file_bytes: bytes, filename: str) -> Response:
+    return Response(
+        content=file_bytes,
+        media_type="text/csv; charset=utf-8",
+        headers={"Content-Disposition": build_content_disposition(filename)},
+    )
+
+
+@router.get("/printers/{printer_id}/log/export")
+async def export_printer_maintenance_log(
+    printer_id: int,
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePrinterPermissionIfAuthEnabled(Permission.MAINTENANCE_READ),
+):
+    """A printer's maintenance log as CSV."""
+    printer = await _ensure_printer(db, printer_id)
+    result = await db.execute(
+        select(MaintenanceLogEntry).where(MaintenanceLogEntry.printer_id == printer_id).order_by(*_NEWEST_FIRST)
+    )
+    file_bytes, filename = ExportService.export_maintenance_log(result.scalars().all(), printer.name)
+    return _csv_response(file_bytes, filename)
+
+
+@router.get("/log/export")
+async def export_maintenance_log(
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePermissionIfAuthEnabled(Permission.MAINTENANCE_READ),
+    printer_scope: PrinterScope = RequestPrinterScope,
+):
+    """The maintenance log of every printer the caller may see, as CSV.
+
+    Entries of deleted printers are in it only for callers who see every
+    printer: a printer-scoped caller can't tell whose they were.
+    """
+    query = select(MaintenanceLogEntry).order_by(*_NEWEST_FIRST)
+    if (in_scope := printer_scope.where_strict(MaintenanceLogEntry.printer_id)) is not None:
+        query = query.where(in_scope)
+    result = await db.execute(query)
+    file_bytes, filename = ExportService.export_maintenance_log(result.scalars().all(), "all")
+    return _csv_response(file_bytes, filename)
+
+
+# A cleanup keeps at least the last day: no age can empty the log by accident.
+_OLDER_THAN_DAYS = Query(ge=1, le=36500, description="Delete the entries older than this many days")
+
+
+def _older_than(days: int):
+    # performed_at is naive UTC, like every timestamp the app writes.
+    return MaintenanceLogEntry.performed_at < utcnow_naive() - timedelta(days=days)
+
+
+async def _delete_log_entries(db: AsyncSession, *conditions) -> int:
+    """Delete the log entries matching ``conditions``, and the history rows of the same resets.
+
+    Each reset is written to maintenance_history too, comment included; left
+    there, a deleted entry would still be in the database and its backups.
+    """
+    # Read first: on SQLite the history delete clears the entries' history_id
+    # before it runs (sqlite_fk), and a subquery would then find nothing.
+    copied_from = list(
+        await db.scalars(
+            select(MaintenanceLogEntry.history_id).where(*conditions, MaintenanceLogEntry.history_id.is_not(None))
+        )
+    )
+    # In chunks: a fleet cleanup may match more ids than one statement can bind.
+    for start in range(0, len(copied_from), 500):
+        chunk = copied_from[start : start + 500]
+        await db.execute(delete(MaintenanceHistory).where(MaintenanceHistory.id.in_(chunk)))
+    result = cast(CursorResult, await db.execute(delete(MaintenanceLogEntry).where(*conditions)))
+    await db.commit()
+    return result.rowcount
+
+
+@router.delete("/printers/{printer_id}/log")
+async def clean_up_printer_maintenance_log(
+    printer_id: int,
+    older_than_days: int = _OLDER_THAN_DAYS,
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePrinterPermissionIfAuthEnabled(Permission.MAINTENANCE_DELETE),
+):
+    """Delete a printer's maintenance log entries older than ``older_than_days``."""
+    await _ensure_printer(db, printer_id)
+    deleted = await _delete_log_entries(db, MaintenanceLogEntry.printer_id == printer_id, _older_than(older_than_days))
+    logger.info(
+        "Deleted %d maintenance log entries of printer %d older than %d days", deleted, printer_id, older_than_days
+    )
+    return {"deleted": deleted}
+
+
+@router.delete("/log")
+async def clean_up_maintenance_log(
+    older_than_days: int = _OLDER_THAN_DAYS,
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePermissionIfAuthEnabled(Permission.MAINTENANCE_DELETE),
+    printer_scope: PrinterScope = RequestPrinterScope,
+):
+    """Delete the maintenance log entries older than ``older_than_days`` of every
+    printer the caller may see.
+
+    Entries of deleted printers go too, but only for callers who see every
+    printer, as in the export.
+    """
+    conditions = [_older_than(older_than_days)]
+    if (in_scope := printer_scope.where_strict(MaintenanceLogEntry.printer_id)) is not None:
+        conditions.append(in_scope)
+    deleted = await _delete_log_entries(db, *conditions)
+    logger.info("Deleted %d maintenance log entries older than %d days", deleted, older_than_days)
+    return {"deleted": deleted}
+
+
+@router.delete("/log/{entry_id}")
+async def delete_maintenance_log_entry(
+    entry_id: int,
+    db: AsyncSession = Depends(get_db, scope="function"),
+    _: User | None = RequirePermissionIfAuthEnabled(Permission.MAINTENANCE_DELETE),
+    printer_scope: PrinterScope = RequestPrinterScope,
+):
+    """Delete one maintenance log entry, e.g. of a task reset by mistake.
+
+    The task's last reset stays as it is: deleting the entry does not undo it.
+    """
+    entry = await db.get(MaintenanceLogEntry, entry_id)
+    # An entry of a deleted printer is reachable only by a caller who sees
+    # every printer; ``allows`` alone lets any caller at rows with no printer.
+    out_of_scope = entry is not None and (
+        not printer_scope.allows(entry.printer_id) or (entry.printer_id is None and not printer_scope.is_unrestricted)
+    )
+    if entry is None or out_of_scope:
+        raise HTTPException(status_code=404, detail="Maintenance log entry not found")
+    await _delete_log_entries(db, MaintenanceLogEntry.id == entry_id)
+    logger.info("Maintenance log entry %d deleted", entry_id)
+    return {"status": "deleted", "id": entry_id}
+
+
 @router.get("/summary")
 async def get_maintenance_summary(
     db: AsyncSession = Depends(get_db, scope="function"),

+ 41 - 0
backend/app/core/database.py

@@ -6148,6 +6148,7 @@ async def _run_migrations(conn):
     await _migrate_spool_usage_outlives_its_archive(conn)
     await _migrate_spool_usage_outlives_its_spool(conn)
     await _backfill_pipeline_job_final_status(conn)
+    await _backfill_maintenance_log(conn)
     await _release_stuck_budget_reservations(conn)
     await _release_slots_of_archived_spools(conn)
     await _migrate_pg_column_types(conn)
@@ -6666,6 +6667,46 @@ async def _backfill_pipeline_job_final_status(conn) -> None:
         logger.info("Stored the final status of %d pipeline job(s) from their queue entry", result.rowcount)
 
 
+async def _backfill_maintenance_log(conn) -> None:
+    """Copy maintenance history into the maintenance log.
+
+    The log (maintenance_log_entries) is written with each reset and outlives
+    the printer and its tasks; resets before it existed are only in
+    maintenance_history, which goes with them. Who reset them was never
+    recorded and stays unknown.
+
+    Once only, gated by a settings flag: entries deleted from the log later
+    (cleanup, a mistaken reset) still have their history row, and a second
+    pass would bring them back. Rows the log already has an entry for
+    (``history_id``) are skipped either way.
+    """
+    from sqlalchemy import text
+
+    flag = "_backfill_maintenance_log_done"
+    async with conn.begin_nested():
+        already = (
+            await conn.execute(text('SELECT value FROM settings WHERE "key" = :k'), {"k": flag})
+        ).scalar_one_or_none()
+        if already is not None:
+            return
+        result = await conn.execute(
+            text(
+                "INSERT INTO maintenance_log_entries (printer_id, printer_name, maintenance_type_id, "
+                "maintenance_type_name, hours_at_maintenance, notes, performed_at, history_id) "
+                "SELECT pm.printer_id, p.name, pm.maintenance_type_id, t.name, "
+                "COALESCE(h.hours_at_maintenance, 0), h.notes, h.performed_at, h.id "
+                "FROM maintenance_history h "
+                "JOIN printer_maintenance pm ON pm.id = h.printer_maintenance_id "
+                "JOIN printers p ON p.id = pm.printer_id "
+                "JOIN maintenance_types t ON t.id = pm.maintenance_type_id "
+                "WHERE NOT EXISTS (SELECT 1 FROM maintenance_log_entries l WHERE l.history_id = h.id)"
+            )
+        )
+        await conn.execute(text('INSERT INTO settings ("key", value) VALUES (:k, :v)'), {"k": flag, "v": "true"})
+    if result.rowcount:
+        logger.info("Copied %d maintenance history row(s) into the maintenance log", result.rowcount)
+
+
 async def _release_stuck_budget_reservations(conn) -> None:
     """Release print reservations whose queue entry has finished or is gone.
 

+ 11 - 0
backend/app/core/sqlite_fk.py

@@ -99,10 +99,20 @@ APPLIED: frozenset[tuple[str, str]] = frozenset(
         # A profile default's K profile would select a calibration slot on
         # the next printer given the id (#1326).
         ("filament_profile_default_k_profile", "printer_id"),
+        # The maintenance log outlives its printer; the next printer given the
+        # id would take over its history.
+        ("maintenance_log_entries", "printer_id"),
         # filament_profile_default: the next default given the id would take
         # over its presets and K profiles (#1326).
         ("filament_profile_default_k_profile", "profile_default_id"),
         ("filament_profile_default_preset", "profile_default_id"),
+        # maintenance_types: the log keeps a deleted custom task's entries; the
+        # next task given the id would take them over.
+        ("maintenance_log_entries", "maintenance_type_id"),
+        # maintenance_history goes with its printer task; the next reset given
+        # the id, maybe on another printer, would have its history deleted
+        # with this entry.
+        ("maintenance_log_entries", "history_id"),
         # external_links: the next link given the id would show the count an
         # app reported for the deleted one.
         ("external_link_badges", "link_id"),
@@ -123,6 +133,7 @@ APPLIED: frozenset[tuple[str, str]] = frozenset(
         ("library_files", "created_by_id"),
         ("library_folders", "created_by_id"),
         ("long_lived_tokens", "user_id"),
+        ("maintenance_log_entries", "performed_by_id"),
         ("pipeline_runs", "created_by"),
         ("print_archives", "created_by_id"),
         ("print_batches", "created_by_id"),

+ 2 - 1
backend/app/models/__init__.py

@@ -22,7 +22,7 @@ from backend.app.models.local_preset import LocalPreset
 from backend.app.models.location import Location
 from backend.app.models.location_ha_sensor import LocationHASensor
 from backend.app.models.long_lived_token import LongLivedToken
-from backend.app.models.maintenance import MaintenanceHistory, MaintenanceType, PrinterMaintenance
+from backend.app.models.maintenance import MaintenanceHistory, MaintenanceLogEntry, MaintenanceType, PrinterMaintenance
 from backend.app.models.notification import NotificationLog
 from backend.app.models.notification_live_activity import NotificationLiveActivity
 from backend.app.models.notification_lock_screen_widget import NotificationLockScreenWidget
@@ -68,6 +68,7 @@ __all__ = [
     "MaintenanceType",
     "PrinterMaintenance",
     "MaintenanceHistory",
+    "MaintenanceLogEntry",
     "KProfileNote",
     "NotificationTemplate",
     "NotificationLog",

+ 36 - 0
backend/app/models/maintenance.py

@@ -78,5 +78,41 @@ class MaintenanceHistory(Base):
     printer_maintenance: Mapped["PrinterMaintenance"] = relationship(back_populates="history")
 
 
+class MaintenanceLogEntry(Base):
+    """One maintenance reset, kept as the audit log of a printer.
+
+    Unlike ``maintenance_history`` (which goes with its printer task), an entry
+    outlives the printer, the task and the user: their names are stored as
+    they were at the reset, and the links to them are SET NULL on delete. An
+    entry whose printer is gone is still in the fleet-wide export.
+    """
+
+    __tablename__ = "maintenance_log_entries"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    printer_id: Mapped[int | None] = mapped_column(
+        ForeignKey("printers.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+    printer_name: Mapped[str] = mapped_column(String(255))
+    maintenance_type_id: Mapped[int | None] = mapped_column(
+        ForeignKey("maintenance_types.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+    maintenance_type_name: Mapped[str] = mapped_column(String(100))
+    hours_at_maintenance: Mapped[float] = mapped_column(Float, default=0.0)
+    notes: Mapped[str | None] = mapped_column(Text, nullable=True)
+    performed_by_id: Mapped[int | None] = mapped_column(ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
+    # NULL when authentication is off.
+    performed_by_username: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    performed_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now(), index=True)
+    # The maintenance_history row written with it. That row goes with its
+    # printer task, so the link is SET NULL: left dangling, SQLite would give
+    # its id to the next reset, possibly another printer's, and deleting this
+    # entry would delete that reset's history. The upgrade copies history rows
+    # not yet here.
+    history_id: Mapped[int | None] = mapped_column(
+        ForeignKey("maintenance_history.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+
+
 # Import at end to avoid circular imports
 from backend.app.models.printer import Printer  # noqa: E402

+ 40 - 2
backend/app/schemas/maintenance.py

@@ -2,7 +2,7 @@
 
 from datetime import datetime
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 from backend.app.schemas.not_null import IgnoresNullForRequiredColumns
 
@@ -128,7 +128,45 @@ class PrinterMaintenanceOverview(BaseModel):
     warning_count: int
 
 
+# Generous: the endpoint took notes of any length before the maintenance log,
+# and automations (Home Assistant) post whole reports; this only bounds a row.
+MAINTENANCE_NOTES_MAX_LENGTH = 10000
+
+
 class PerformMaintenanceRequest(BaseModel):
     """Request to mark maintenance as performed."""
 
-    notes: str | None = None
+    # The optional comment logged with the reset.
+    notes: str | None = Field(default=None, max_length=MAINTENANCE_NOTES_MAX_LENGTH)
+
+    @field_validator("notes", mode="before")
+    @classmethod
+    def _trim_notes(cls, value: object) -> object:
+        """Trimmed before the length check, so surrounding whitespace never
+        counts against the limit; blank is no comment."""
+        if isinstance(value, str):
+            return value.strip() or None
+        return value
+
+
+class MaintenanceLogEntryResponse(BaseModel):
+    """One reset in a printer's maintenance log."""
+
+    id: int
+    printer_id: int | None  # None once the printer is deleted
+    printer_name: str
+    maintenance_type_id: int | None  # None once the custom task is deleted
+    maintenance_type_name: str
+    hours_at_maintenance: float
+    notes: str | None
+    performed_by_id: int | None
+    performed_by_username: str | None  # None when authentication was off
+    performed_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class MaintenanceLogPage(BaseModel):
+    items: list[MaintenanceLogEntryResponse]
+    total: int

+ 47 - 2
backend/app/services/export.py

@@ -1,7 +1,9 @@
 import csv
 import io
-from datetime import datetime
-from typing import Any
+import re
+from collections.abc import Sequence
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, Any
 
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
@@ -11,6 +13,9 @@ from backend.app.core.printer_scope import PrinterScope
 from backend.app.models.archive import PrintArchive
 from backend.app.models.print_log import INCLUDE_OPEN_RUNS, PrintLogEntry
 
+if TYPE_CHECKING:
+    from backend.app.models.maintenance import MaintenanceLogEntry
+
 # A cell starting with one of these is read as a formula by spreadsheet apps,
 # including the full-width forms (= + - @) some normalise to ASCII.
 _FORMULA_PREFIXES = ("=", "+", "-", "@", "=", "+", "-", "@")
@@ -62,6 +67,15 @@ _PER_PRINT_FIELDS = frozenset(
 )
 
 
+def _utc_iso(value: datetime | None) -> str:
+    """A stored (naive UTC) time as ISO 8601 with its zone."""
+    if value is None:
+        return ""
+    if value.tzinfo is not None:
+        value = value.astimezone(timezone.utc).replace(tzinfo=None)
+    return value.replace(microsecond=0).isoformat() + "Z"
+
+
 class ExportService:
     """Service for exporting archive data to CSV/Excel formats."""
 
@@ -390,6 +404,37 @@ class ExportService:
             row.append(value)
         return row
 
+    MAINTENANCE_LOG_HEADERS = ["Performed at (UTC)", "Printer", "Task", "Performed by", "Print hours", "Comment"]
+
+    @classmethod
+    def export_maintenance_log(cls, entries: Sequence["MaintenanceLogEntry"], scope_label: str) -> tuple[bytes, str]:
+        """The maintenance log as CSV, and its file name.
+
+        ``scope_label`` names what the file holds (a printer's name, or
+        "all") in the file name. Text that people typed is written so that a
+        spreadsheet shows it as text, never runs it as a formula; the BOM makes
+        Excel read the file as UTF-8.
+        """
+        rows = [
+            [
+                _utc_iso(entry.performed_at),
+                _spreadsheet_text(entry.printer_name),
+                _spreadsheet_text(entry.maintenance_type_name),
+                _spreadsheet_text(entry.performed_by_username),
+                round(entry.hours_at_maintenance or 0.0, 1),
+                _spreadsheet_text(entry.notes),
+            ]
+            for entry in entries
+        ]
+        output = io.StringIO()
+        output.write("\ufeff")
+        writer = csv.writer(output)
+        writer.writerow(cls.MAINTENANCE_LOG_HEADERS)
+        writer.writerows(rows)
+        slug = re.sub(r"[^\w-]+", "_", scope_label, flags=re.UNICODE).strip("_") or "printer"
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        return output.getvalue().encode("utf-8"), f"maintenance_log_{slug}_{timestamp}.csv"
+
     def _generate_csv(self, headers: list[str], rows: list[list]) -> bytes:
         """Generate CSV file content."""
         output = io.StringIO()

+ 425 - 0
backend/tests/integration/test_maintenance_log.py

@@ -0,0 +1,425 @@
+"""The maintenance log: every reset with its comment, who did it, on which printer and when.
+
+Entries outlive the printer, the custom task and the user (their names are
+kept as they were), so the log stays an audit trail. It is read per printer
+and exported as CSV per printer or for the whole fleet; a printer-scoped
+caller sees only their printers, and not the entries of deleted ones.
+Entries can be deleted, by age or one at a time, with the history row of the
+same reset, so a deleted comment is gone from the database.
+"""
+
+from __future__ import annotations
+
+import csv
+import io
+from datetime import datetime, timedelta, timezone
+
+import pytest
+from httpx import AsyncClient
+
+from backend.app.models.maintenance import MaintenanceHistory, MaintenanceLogEntry
+from backend.tests.integration.test_archives_last_per_printer import _admin_token, _auth, _user
+
+pytestmark = [pytest.mark.asyncio, pytest.mark.integration]
+
+BASE = "/api/v1/maintenance"
+
+
+async def _first_item(async_client: AsyncClient, printer_id: int) -> dict:
+    overview = (await async_client.get(f"{BASE}/printers/{printer_id}")).json()
+    return overview["maintenance_items"][0]
+
+
+async def _perform(async_client: AsyncClient, item_id: int, notes: str | None = None, headers=None):
+    body = {} if notes is None else {"notes": notes}
+    return await async_client.post(f"{BASE}/items/{item_id}/perform", json=body, headers=headers)
+
+
+async def _log(async_client: AsyncClient, printer_id: int, headers=None, **params) -> dict:
+    response = await async_client.get(f"{BASE}/printers/{printer_id}/log", params=params, headers=headers)
+    assert response.status_code == 200, response.text
+    return response.json()
+
+
+def _csv_rows(response) -> list[list[str]]:
+    assert response.status_code == 200, response.text
+    assert response.headers["content-type"].startswith("text/csv")
+    assert "attachment" in response.headers["content-disposition"]
+    text = response.content.decode("utf-8")
+    assert text.startswith(""), "Excel needs the BOM to read UTF-8"
+    return list(csv.reader(io.StringIO(text[1:])))
+
+
+async def _entry(db_session, entry_id: int) -> MaintenanceLogEntry:
+    db_session.expire_all()
+    entry = await db_session.get(MaintenanceLogEntry, entry_id)
+    assert entry is not None
+    return entry
+
+
+async def _age(db_session, entry_id: int, days: int) -> int:
+    """Move an entry ``days`` into the past; returns its history row's id."""
+    entry = await _entry(db_session, entry_id)
+    entry.performed_at = datetime.now(timezone.utc).replace(tzinfo=None) - timedelta(days=days)
+    history_id = entry.history_id
+    await db_session.commit()
+    assert history_id is not None
+    return history_id
+
+
+async def _history_exists(db_session, history_id: int) -> bool:
+    db_session.expire_all()
+    return await db_session.get(MaintenanceHistory, history_id) is not None
+
+
+async def _logged(async_client, printer_factory, name: str, *notes: str) -> tuple[int, list[int]]:
+    """A printer with one reset per note; returns its id and the entry ids, oldest first."""
+    printer_id = (await printer_factory(name=name)).id
+    item = await _first_item(async_client, printer_id)
+    for note in notes:
+        await _perform(async_client, item["id"], note)
+    entries = (await _log(async_client, printer_id))["items"]
+    return printer_id, [e["id"] for e in reversed(entries)]
+
+
+class TestLogging:
+    async def test_a_reset_logs_the_task_the_printer_and_the_comment(self, async_client, printer_factory):
+        printer = await printer_factory(name="Log Printer")
+        item = await _first_item(async_client, printer.id)
+
+        response = await _perform(async_client, item["id"], "  Rails cleaned, new grease  ")
+
+        assert response.status_code == 200, response.text
+        log = await _log(async_client, printer.id)
+        assert log["total"] == 1
+        entry = log["items"][0]
+        assert entry["printer_id"] == printer.id
+        assert entry["printer_name"] == "Log Printer"
+        assert entry["maintenance_type_id"] == item["maintenance_type_id"]
+        assert entry["maintenance_type_name"] == item["maintenance_type_name"]
+        assert entry["notes"] == "Rails cleaned, new grease"
+        assert entry["performed_at"] is not None
+        # Authentication is off: nobody to name.
+        assert entry["performed_by_id"] is None
+        assert entry["performed_by_username"] is None
+
+    async def test_the_comment_is_optional_and_blank_is_none(self, async_client, printer_factory):
+        printer = await printer_factory(name="No Comment Printer")
+        item = await _first_item(async_client, printer.id)
+
+        assert (await _perform(async_client, item["id"])).status_code == 200
+        assert (await _perform(async_client, item["id"], "   ")).status_code == 200
+
+        notes = [e["notes"] for e in (await _log(async_client, printer.id))["items"]]
+        assert notes == [None, None]
+
+    async def test_a_comment_over_the_limit_is_refused(self, async_client, printer_factory):
+        printer = await printer_factory(name="Long Comment Printer")
+        item = await _first_item(async_client, printer.id)
+
+        response = await _perform(async_client, item["id"], "x" * 10001)
+
+        assert response.status_code == 422
+        assert (await _log(async_client, printer.id))["total"] == 0
+
+    async def test_a_long_report_fits(self, async_client, printer_factory):
+        """Automations post whole reports; the endpoint took any length before."""
+        printer = await printer_factory(name="Report Printer")
+        item = await _first_item(async_client, printer.id)
+
+        response = await _perform(async_client, item["id"], "x" * 10000)
+
+        assert response.status_code == 200, response.text
+        assert len((await _log(async_client, printer.id))["items"][0]["notes"]) == 10000
+
+    async def test_surrounding_whitespace_does_not_count_against_the_limit(self, async_client, printer_factory):
+        printer = await printer_factory(name="Padded Printer")
+        item = await _first_item(async_client, printer.id)
+
+        response = await _perform(async_client, item["id"], "x" * 9995 + " " * 20 + "\n")
+
+        assert response.status_code == 200, response.text
+        assert (await _log(async_client, printer.id))["items"][0]["notes"] == "x" * 9995
+
+    async def test_the_log_is_newest_first_and_paged(self, async_client, printer_factory):
+        printer = await printer_factory(name="Paged Printer")
+        item = await _first_item(async_client, printer.id)
+        for n in range(3):
+            await _perform(async_client, item["id"], f"reset {n}")
+
+        first = await _log(async_client, printer.id, limit=2)
+        rest = await _log(async_client, printer.id, limit=2, offset=2)
+
+        assert first["total"] == rest["total"] == 3
+        assert [e["notes"] for e in first["items"]] == ["reset 2", "reset 1"]
+        assert [e["notes"] for e in rest["items"]] == ["reset 0"]
+
+    async def test_another_printer_s_resets_are_not_in_its_log(self, async_client, printer_factory):
+        mine, other = await printer_factory(name="Mine"), await printer_factory(name="Other")
+        await _perform(async_client, (await _first_item(async_client, other.id))["id"], "other's")
+
+        assert (await _log(async_client, mine.id))["total"] == 0
+
+    async def test_the_log_of_an_unknown_printer_is_not_found(self, async_client):
+        response = await async_client.get(f"{BASE}/printers/999999/log")
+
+        assert response.status_code == 404
+
+
+class TestOutlivingDeletes:
+    async def test_entries_outlive_their_printer(self, async_client, printer_factory, db_session):
+        printer = await printer_factory(name="Doomed Printer")
+        await _perform(async_client, (await _first_item(async_client, printer.id))["id"], "before the end")
+        entry_id = (await _log(async_client, printer.id))["items"][0]["id"]
+
+        deleted = await async_client.delete(f"/api/v1/printers/{printer.id}")
+
+        assert deleted.status_code == 200, deleted.text
+        entry = await _entry(db_session, entry_id)
+        assert entry.printer_id is None
+        assert entry.printer_name == "Doomed Printer"
+        assert entry.notes == "before the end"
+        rows = _csv_rows(await async_client.get(f"{BASE}/log/export"))
+        assert ["Doomed Printer", "before the end"] in [[r[1], r[5]] for r in rows[1:]]
+
+    async def test_entries_outlive_a_deleted_custom_task(self, async_client, printer_factory, db_session):
+        printer_id = (await printer_factory(name="Custom Task Printer")).id
+        task = (
+            await async_client.post(
+                f"{BASE}/types",
+                json={"name": "Replace Hotend", "default_interval_hours": 500, "interval_type": "hours"},
+            )
+        ).json()
+        item = (await async_client.post(f"{BASE}/printers/{printer_id}/assign/{task['id']}")).json()
+        await _perform(async_client, item["id"], "0.4 mm hardened")
+        entry_id = (await _log(async_client, printer_id))["items"][0]["id"]
+
+        assert (await async_client.delete(f"{BASE}/types/{task['id']}")).status_code == 200
+
+        entry = await _entry(db_session, entry_id)
+        assert entry.maintenance_type_id is None
+        assert entry.maintenance_type_name == "Replace Hotend"
+        assert (await _log(async_client, printer_id))["total"] == 1
+
+
+class TestExport:
+    async def test_a_printer_s_log_exports_as_csv(self, async_client, printer_factory):
+        printer = await printer_factory(name="Drucker Übung")
+        item = await _first_item(async_client, printer.id)
+        await _perform(async_client, item["id"], "Düse gewechselt")
+
+        response = await async_client.get(f"{BASE}/printers/{printer.id}/log/export")
+
+        rows = _csv_rows(response)
+        assert rows[0] == ["Performed at (UTC)", "Printer", "Task", "Performed by", "Print hours", "Comment"]
+        assert len(rows) == 2
+        performed_at, name, task, by, hours, comment = rows[1]
+        assert performed_at.endswith("Z")
+        assert (name, task, by, comment) == ("Drucker Übung", item["maintenance_type_name"], "", "Düse gewechselt")
+        assert float(hours) == pytest.approx(0.0)
+        assert "maintenance_log_Drucker" in response.headers["content-disposition"]
+
+    async def test_a_formula_in_a_comment_stays_text(self, async_client, printer_factory):
+        printer = await printer_factory(name="Formula Printer")
+        await _perform(async_client, (await _first_item(async_client, printer.id))["id"], '=HYPERLINK("x")')
+
+        rows = _csv_rows(await async_client.get(f"{BASE}/printers/{printer.id}/log/export"))
+
+        assert rows[1][5] == '\'=HYPERLINK("x")'
+
+    async def test_the_fleet_export_has_every_printer(self, async_client, printer_factory):
+        a, b = await printer_factory(name="Fleet A"), await printer_factory(name="Fleet B")
+        for printer in (a, b):
+            await _perform(async_client, (await _first_item(async_client, printer.id))["id"], printer.name)
+
+        rows = _csv_rows(await async_client.get(f"{BASE}/log/export"))
+
+        assert {r[1] for r in rows[1:]} >= {"Fleet A", "Fleet B"}
+
+
+class TestCleanup:
+    async def test_a_printer_s_old_entries_go_with_their_history(self, async_client, printer_factory, db_session):
+        printer_id, (old, recent, _today) = await _logged(
+            async_client, printer_factory, "Cleanup", "old", "recent", "today"
+        )
+        other_id, (other_old,) = await _logged(async_client, printer_factory, "Cleanup Other", "other old")
+        old_history = await _age(db_session, old, 400)
+        recent_history = await _age(db_session, recent, 10)
+        other_history = await _age(db_session, other_old, 400)
+
+        response = await async_client.delete(f"{BASE}/printers/{printer_id}/log", params={"older_than_days": 30})
+
+        assert response.status_code == 200, response.text
+        assert response.json() == {"deleted": 1}
+        assert [e["notes"] for e in (await _log(async_client, printer_id))["items"]] == ["today", "recent"]
+        assert not await _history_exists(db_session, old_history)
+        assert await _history_exists(db_session, recent_history)
+        # Another printer's entries are not touched.
+        assert (await _log(async_client, other_id))["total"] == 1
+        assert await _history_exists(db_session, other_history)
+
+    async def test_the_age_must_be_given_and_at_least_a_day(self, async_client, printer_factory):
+        printer_id, _ = await _logged(async_client, printer_factory, "Cleanup Age", "kept")
+
+        for params in ({}, {"older_than_days": 0}, {"older_than_days": -5}):
+            assert (await async_client.delete(f"{BASE}/printers/{printer_id}/log", params=params)).status_code == 422
+            assert (await async_client.delete(f"{BASE}/log", params=params)).status_code == 422
+        assert (await _log(async_client, printer_id))["total"] == 1
+
+    async def test_cleaning_up_an_unknown_printer_is_not_found(self, async_client):
+        response = await async_client.delete(f"{BASE}/printers/999999/log", params={"older_than_days": 1})
+
+        assert response.status_code == 404
+
+    async def test_the_fleet_cleanup_covers_every_printer_and_deleted_ones(
+        self, async_client, printer_factory, db_session
+    ):
+        a_id, (a_old, a_new) = await _logged(async_client, printer_factory, "Fleet Clean A", "a old", "a new")
+        b_id, (b_old,) = await _logged(async_client, printer_factory, "Fleet Clean B", "b old")
+        gone_id, (gone_old,) = await _logged(async_client, printer_factory, "Fleet Clean Gone", "gone old")
+        for entry_id in (a_old, b_old, gone_old):
+            await _age(db_session, entry_id, 100)
+        assert (await async_client.delete(f"/api/v1/printers/{gone_id}")).status_code == 200
+
+        response = await async_client.delete(f"{BASE}/log", params={"older_than_days": 30})
+
+        assert response.status_code == 200, response.text
+        assert response.json() == {"deleted": 3}
+        assert [e["id"] for e in (await _log(async_client, a_id))["items"]] == [a_new]
+        assert (await _log(async_client, b_id))["total"] == 0
+        db_session.expire_all()
+        assert await db_session.get(MaintenanceLogEntry, gone_old) is None
+
+    async def test_one_entry_goes_with_its_history_and_the_reset_stays(self, async_client, printer_factory, db_session):
+        printer_id, (kept, mistaken) = await _logged(async_client, printer_factory, "Mistake", "kept", "by mistake")
+        history_id = (await _entry(db_session, mistaken)).history_id
+        before = await _first_item(async_client, printer_id)
+
+        response = await async_client.delete(f"{BASE}/log/{mistaken}")
+
+        assert response.status_code == 200, response.text
+        assert [e["id"] for e in (await _log(async_client, printer_id))["items"]] == [kept]
+        assert history_id is not None
+        assert not await _history_exists(db_session, history_id)
+        # Deleting the entry does not undo the reset.
+        assert (await _first_item(async_client, printer_id))["last_performed_at"] == before["last_performed_at"]
+
+    async def test_an_entry_whose_history_is_gone_leaves_a_later_reset_s_history_alone(
+        self, async_client, printer_factory, db_session
+    ):
+        # The deleted printer's history row had the highest id, so on SQLite the
+        # next reset is given it. Deleting the old entry must not take that
+        # reset's history with it.
+        doomed = (await printer_factory(name="Doomed")).id
+        await _perform(async_client, (await _first_item(async_client, doomed))["id"], "before the end")
+        old_entry = (await _log(async_client, doomed))["items"][0]["id"]
+        old_history = (await _entry(db_session, old_entry)).history_id
+        assert (await async_client.delete(f"/api/v1/printers/{doomed}")).status_code == 200
+        assert (await _entry(db_session, old_entry)).history_id is None
+
+        survivor_id, (new_entry,) = await _logged(async_client, printer_factory, "Survivor", "after")
+        new_history = (await _entry(db_session, new_entry)).history_id
+        assert new_history is not None
+
+        assert (await async_client.delete(f"{BASE}/log/{old_entry}")).status_code == 200
+
+        assert await _history_exists(db_session, new_history)
+        assert (await _log(async_client, survivor_id))["total"] == 1
+        if db_session.bind.dialect.name == "sqlite":
+            # The case this is about: SQLite gave the later reset the freed id.
+            # PostgreSQL never reuses one, so there it can only pass.
+            assert new_history == old_history
+
+    async def test_deleting_an_unknown_entry_is_not_found(self, async_client):
+        assert (await async_client.delete(f"{BASE}/log/999999")).status_code == 404
+
+
+class TestWithAuthentication:
+    PERMISSIONS = ["maintenance:read", "maintenance:update", "printers:read"]
+
+    async def test_the_log_names_who_reset(self, async_client, printer_factory):
+        printer = await printer_factory(name="Auth Printer")
+        admin = await _admin_token(async_client)
+        jwt, user_id = await _user(async_client, admin, "mechanic", self.PERMISSIONS)
+        overview = (await async_client.get(f"{BASE}/printers/{printer.id}", headers=_auth(jwt))).json()
+        item = overview["maintenance_items"][0]
+
+        response = await _perform(async_client, item["id"], "done", headers=_auth(jwt))
+
+        assert response.status_code == 200, response.text
+        entry = (await _log(async_client, printer.id, headers=_auth(jwt)))["items"][0]
+        assert (entry["performed_by_id"], entry["performed_by_username"]) == (user_id, "mechanic")
+        rows = _csv_rows(await async_client.get(f"{BASE}/printers/{printer.id}/log/export", headers=_auth(jwt)))
+        assert rows[1][3] == "mechanic"
+
+    async def test_a_scoped_user_exports_only_their_printers(self, async_client, printer_factory):
+        mine, theirs, gone = (
+            await printer_factory(name="Scoped Mine"),
+            await printer_factory(name="Scoped Theirs"),
+            await printer_factory(name="Scoped Gone"),
+        )
+        for printer in (mine, theirs, gone):
+            await _perform(async_client, (await _first_item(async_client, printer.id))["id"], printer.name)
+        assert (await async_client.delete(f"/api/v1/printers/{gone.id}")).status_code == 200
+        admin = await _admin_token(async_client)
+        jwt, _ = await _user(async_client, admin, "scoped", self.PERMISSIONS, printer_ids=[mine.id])
+
+        rows = _csv_rows(await async_client.get(f"{BASE}/log/export", headers=_auth(jwt)))
+        admin_rows = _csv_rows(await async_client.get(f"{BASE}/log/export", headers=_auth(admin)))
+
+        assert [r[1] for r in rows[1:]] == ["Scoped Mine"]
+        assert {"Scoped Mine", "Scoped Theirs", "Scoped Gone"} <= {r[1] for r in admin_rows[1:]}
+
+    async def test_a_scoped_user_cannot_read_another_printer_s_log(self, async_client, printer_factory):
+        mine, theirs = await printer_factory(name="Scope A"), await printer_factory(name="Scope B")
+        admin = await _admin_token(async_client)
+        jwt, _ = await _user(async_client, admin, "scoped_reader", self.PERMISSIONS, printer_ids=[mine.id])
+
+        log = await async_client.get(f"{BASE}/printers/{theirs.id}/log", headers=_auth(jwt))
+        export = await async_client.get(f"{BASE}/printers/{theirs.id}/log/export", headers=_auth(jwt))
+
+        assert log.status_code in (403, 404)
+        assert export.status_code in (403, 404)
+
+    async def test_cleanup_needs_the_delete_permission(self, async_client, printer_factory):
+        printer_id, (entry_id,) = await _logged(async_client, printer_factory, "No Delete", "kept")
+        admin = await _admin_token(async_client)
+        jwt, _ = await _user(async_client, admin, "no_delete", self.PERMISSIONS)
+
+        for path, params in (
+            (f"{BASE}/printers/{printer_id}/log", {"older_than_days": 1}),
+            (f"{BASE}/log", {"older_than_days": 1}),
+            (f"{BASE}/log/{entry_id}", {}),
+        ):
+            response = await async_client.delete(path, params=params, headers=_auth(jwt))
+            assert response.status_code == 403, (path, response.text)
+        assert (await _log(async_client, printer_id, headers=_auth(admin)))["total"] == 1
+
+    async def test_a_scoped_user_cleans_up_only_their_printers(self, async_client, printer_factory, db_session):
+        mine, (mine_old,) = await _logged(async_client, printer_factory, "Clean Mine", "mine")
+        theirs, (theirs_old,) = await _logged(async_client, printer_factory, "Clean Theirs", "theirs")
+        gone, (gone_old,) = await _logged(async_client, printer_factory, "Clean Gone", "gone")
+        for entry_id in (mine_old, theirs_old, gone_old):
+            await _age(db_session, entry_id, 100)
+        assert (await async_client.delete(f"/api/v1/printers/{gone}")).status_code == 200
+        admin = await _admin_token(async_client)
+        jwt, _ = await _user(
+            async_client, admin, "scoped_cleaner", [*self.PERMISSIONS, "maintenance:delete"], printer_ids=[mine]
+        )
+
+        fleet = await async_client.delete(f"{BASE}/log", params={"older_than_days": 30}, headers=_auth(jwt))
+        other_printer = await async_client.delete(
+            f"{BASE}/printers/{theirs}/log", params={"older_than_days": 30}, headers=_auth(jwt)
+        )
+        other_entry = await async_client.delete(f"{BASE}/log/{theirs_old}", headers=_auth(jwt))
+        deleted_printer_entry = await async_client.delete(f"{BASE}/log/{gone_old}", headers=_auth(jwt))
+
+        assert fleet.status_code == 200, fleet.text
+        assert fleet.json() == {"deleted": 1}
+        assert other_printer.status_code in (403, 404)
+        assert other_entry.status_code == 404
+        assert deleted_printer_entry.status_code == 404
+        db_session.expire_all()
+        assert await db_session.get(MaintenanceLogEntry, mine_old) is None
+        assert await db_session.get(MaintenanceLogEntry, theirs_old) is not None
+        assert await db_session.get(MaintenanceLogEntry, gone_old) is not None

+ 45 - 0
backend/tests/unit/test_maintenance_log_actor.py

@@ -0,0 +1,45 @@
+"""Who a maintenance reset is logged as (#3557).
+
+The user, an API key's owner, or, for a legacy key without an owner, the key
+by its name. Nobody when authentication is off.
+"""
+
+from __future__ import annotations
+
+from types import SimpleNamespace
+
+from backend.app.api.routes.maintenance import _actor_identity
+from backend.app.core.auth import ApiKeyActor
+
+
+def _key_actor(name: str, owner: SimpleNamespace | None) -> ApiKeyActor:
+    actor = ApiKeyActor.__new__(ApiKeyActor)
+    actor.api_key = SimpleNamespace(name=name)
+    actor.owner = owner
+    actor.id = owner.id if owner else None
+    actor.username = owner.username if owner else None
+    return actor
+
+
+def test_auth_off_logs_nobody():
+    assert _actor_identity(None) == (None, None)
+
+
+def test_a_user_is_logged_by_id_and_name():
+    assert _actor_identity(SimpleNamespace(id=7, username="mechanic")) == (7, "mechanic")
+
+
+def test_a_key_is_logged_as_its_owner():
+    owner = SimpleNamespace(id=3, username="farm-admin")
+
+    assert _actor_identity(_key_actor("Home Assistant", owner)) == (3, "farm-admin")
+
+
+def test_a_legacy_key_without_an_owner_is_logged_by_its_name():
+    assert _actor_identity(_key_actor("Home Assistant", None)) == (None, "API key: Home Assistant")
+
+
+def test_a_long_key_name_fits_the_column():
+    _, name = _actor_identity(_key_actor("x" * 200, None))
+
+    assert name is not None and len(name) == 100

+ 125 - 0
backend/tests/unit/test_maintenance_log_backfill.py

@@ -0,0 +1,125 @@
+"""Resets from before the maintenance log are copied into it once, on upgrade.
+
+They are only in maintenance_history, which goes with its printer task. The
+copy takes the printer's and the task's names as they are now; who reset them
+was never recorded. A second start copies nothing again, not even entries
+deleted from the log since.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+import pytest
+from sqlalchemy import text
+from sqlalchemy.ext.asyncio import create_async_engine
+
+from backend.app.core.database import _backfill_maintenance_log
+from backend.app.models.maintenance import MaintenanceLogEntry
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.fixture
+async def engine():
+    """In-memory SQLite with the tables the copy reads, as an upgrade finds them,
+    and the log as create_all builds it from the model."""
+    engine = create_async_engine("sqlite+aiosqlite:///:memory:", echo=False)
+    async with engine.begin() as conn:
+        for ddl in (
+            'CREATE TABLE settings (id INTEGER PRIMARY KEY, "key" VARCHAR(100) NOT NULL UNIQUE, value TEXT)',
+            "CREATE TABLE printers (id INTEGER PRIMARY KEY, name VARCHAR(100) NOT NULL)",
+            "CREATE TABLE maintenance_types (id INTEGER PRIMARY KEY, name VARCHAR(100) NOT NULL)",
+            "CREATE TABLE printer_maintenance (id INTEGER PRIMARY KEY, printer_id INTEGER NOT NULL, "
+            "maintenance_type_id INTEGER NOT NULL)",
+            "CREATE TABLE maintenance_history (id INTEGER PRIMARY KEY, printer_maintenance_id INTEGER NOT NULL, "
+            "performed_at DATETIME, hours_at_maintenance FLOAT, notes TEXT)",
+        ):
+            await conn.execute(text(ddl))
+        await conn.run_sync(lambda sync: MaintenanceLogEntry.__table__.create(sync))
+        await conn.execute(text("INSERT INTO printers (id, name) VALUES (1, 'X1C')"))
+        await conn.execute(text("INSERT INTO maintenance_types (id, name) VALUES (7, 'Clean Nozzle')"))
+        await conn.execute(
+            text("INSERT INTO printer_maintenance (id, printer_id, maintenance_type_id) VALUES (3, 1, 7)")
+        )
+        for history_id, at, hours, notes in (
+            (10, datetime(2026, 1, 2, 3, 4), 12.5, "old note"),
+            (11, datetime(2026, 2, 1), 40.0, None),
+        ):
+            await conn.execute(
+                text(
+                    "INSERT INTO maintenance_history (id, printer_maintenance_id, performed_at, hours_at_maintenance, notes) "
+                    "VALUES (:id, 3, :at, :hours, :notes)"
+                ),
+                {"id": history_id, "at": at, "hours": hours, "notes": notes},
+            )
+    try:
+        yield engine
+    finally:
+        await engine.dispose()
+
+
+async def _entries(conn) -> list[tuple]:
+    result = await conn.execute(
+        text(
+            "SELECT history_id, printer_id, printer_name, maintenance_type_id, maintenance_type_name, "
+            "hours_at_maintenance, notes, performed_by_id, performed_by_username "
+            "FROM maintenance_log_entries ORDER BY history_id"
+        )
+    )
+    return [tuple(row) for row in result]
+
+
+async def test_old_resets_are_copied_with_their_printer_and_task(engine):
+    async with engine.begin() as conn:
+        await _backfill_maintenance_log(conn)
+        entries = await _entries(conn)
+
+    assert entries == [
+        (10, 1, "X1C", 7, "Clean Nozzle", 12.5, "old note", None, None),
+        (11, 1, "X1C", 7, "Clean Nozzle", 40.0, None, None, None),
+    ]
+
+
+async def test_the_copy_keeps_when_they_were_done(engine):
+    async with engine.begin() as conn:
+        await _backfill_maintenance_log(conn)
+        performed = (
+            await conn.execute(text("SELECT performed_at FROM maintenance_log_entries WHERE history_id = 10"))
+        ).scalar_one()
+
+    assert str(performed).startswith("2026-01-02 03:04")
+
+
+async def test_a_second_start_copies_nothing_again(engine):
+    async with engine.begin() as conn:
+        await _backfill_maintenance_log(conn)
+        await _backfill_maintenance_log(conn)
+        entries = await _entries(conn)
+
+    assert [e[0] for e in entries] == [10, 11]
+
+
+async def test_resets_already_logged_are_not_copied(engine):
+    async with engine.begin() as conn:
+        await conn.execute(
+            text(
+                "INSERT INTO maintenance_log_entries (printer_id, printer_name, maintenance_type_id, "
+                "maintenance_type_name, hours_at_maintenance, performed_by_username, history_id) "
+                "VALUES (1, 'X1C', 7, 'Clean Nozzle', 12.5, 'mechanic', 10)"
+            )
+        )
+        await _backfill_maintenance_log(conn)
+        entries = await _entries(conn)
+
+    assert [(e[0], e[-1]) for e in entries] == [(10, "mechanic"), (11, None)]
+
+
+async def test_entries_deleted_from_the_log_stay_deleted(engine):
+    async with engine.begin() as conn:
+        await _backfill_maintenance_log(conn)
+        await conn.execute(text("DELETE FROM maintenance_log_entries WHERE history_id = 10"))
+        await _backfill_maintenance_log(conn)
+        entries = await _entries(conn)
+
+    assert [e[0] for e in entries] == [11]

+ 36 - 0
backend/tests/unit/test_maintenance_log_csv.py

@@ -0,0 +1,36 @@
+"""Free text in the maintenance log CSV stays text in a spreadsheet.
+
+Comments, printer, task and user names are typed by people and may be opened
+in Excel or LibreOffice by someone else; a cell a spreadsheet would run as a
+formula gets a leading quote. Old comments copied in on upgrade were never
+trimmed, so leading whitespace and line breaks are looked past too.
+"""
+
+from __future__ import annotations
+
+import pytest
+
+from backend.app.services.export import _spreadsheet_text
+
+
+@pytest.mark.parametrize(
+    ("value", "expected"),
+    [
+        ("plain note", "plain note"),
+        ("a = b", "a = b"),
+        ("=1+1", "'=1+1"),
+        ("+49 123", "'+49 123"),
+        ("-0.2 mm offset", "'-0.2 mm offset"),
+        ("@SUM(A1)", "'@SUM(A1)"),
+        ("  =1+1", "'  =1+1"),
+        ("\n=1+1", "'\n=1+1"),
+        ("\r\nnote", "'\r\nnote"),
+        ("\tnote", "'\tnote"),
+        ("=HYPERLINK(1)", "'=HYPERLINK(1)"),
+        ("@SUM(A1)", "'@SUM(A1)"),
+        ("", ""),
+        (None, None),  # written as an empty cell by the csv writer
+    ],
+)
+def test_a_formula_like_cell_gets_a_leading_quote(value, expected):
+    assert _spreadsheet_text(value) == expected

+ 384 - 17
frontend/src/__tests__/pages/MaintenancePageWiring.test.tsx

@@ -113,6 +113,24 @@ afterEach(() => {
   vi.restoreAllMocks();
 });
 
+function signInWith(permissions: string[]) {
+  setAuthToken('test-token-1', 'session');
+  server.use(
+    http.get('*/api/v1/auth/status', () => HttpResponse.json({ auth_enabled: true, requires_setup: false })),
+    http.get('*/api/v1/auth/me', () =>
+      HttpResponse.json({
+        id: 9,
+        username: 'viewer',
+        is_active: true,
+        is_admin: false,
+        groups: [],
+        permissions,
+        created_at: '2026-01-01T00:00:00Z',
+      }),
+    ),
+  );
+}
+
 /** The printer card whose heading is `name`. */
 async function printerCard(name: string): Promise<HTMLElement> {
   const heading = await screen.findByRole('heading', { name });
@@ -130,8 +148,14 @@ function typeTile(name: string): HTMLElement {
   return screen.getByText(name).closest('.rounded-xl') as HTMLElement;
 }
 
+/** The reset dialog, opened by a task's Reset button. */
+async function resetDialog(task: string): Promise<HTMLElement> {
+  const heading = await screen.findByRole('heading', { name: `Reset "${task}"?` });
+  return heading.closest('div.fixed') as HTMLElement;
+}
+
 describe('MaintenancePage wiring: status tab', () => {
-  it('Reset on a task sends performMaintenance for that printer\'s item only', async () => {
+  it('Reset asks first, then sends performMaintenance with the comment for that printer\'s item only', async () => {
     const user = userEvent.setup();
     render(<MaintenancePage />);
 
@@ -139,9 +163,89 @@ describe('MaintenancePage wiring: status tab', () => {
     await user.click(within(beta).getByRole('button', { name: /expand/i }));
     await user.click(await within(beta).findByRole('button', { name: 'Reset' }));
 
+    const dialog = await resetDialog('Nozzle Task');
+    expect(within(dialog).getByText(/on Beta Printer/)).toBeInTheDocument();
+    expect(writes()).toEqual([]);
+    await user.type(within(dialog).getByLabelText('Comment (optional)'), '  Nozzle swapped to 0.6  ');
+    await user.click(within(dialog).getByRole('button', { name: 'Reset' }));
+
     await waitFor(() => expect(writes()).toHaveLength(1));
-    expect(writes()[0]).toMatchObject({ method: 'POST', path: '/api/v1/maintenance/items/21/perform' });
+    expect(writes()[0]).toMatchObject({
+      method: 'POST',
+      path: '/api/v1/maintenance/items/21/perform',
+      body: { notes: 'Nozzle swapped to 0.6' },
+    });
     expect(await screen.findByText('Maintenance marked as complete')).toBeInTheDocument();
+    await waitFor(() => expect(screen.queryByRole('heading', { name: 'Reset "Nozzle Task"?' })).not.toBeInTheDocument());
+  });
+
+  it('a reset without a comment sends no notes', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    const alpha = await printerCard('Alpha Printer');
+    await user.click(within(alpha).getByRole('button', { name: /expand/i }));
+    await user.click(await within(alpha).findByRole('button', { name: 'Reset' }));
+    await user.click(within(await resetDialog('Nozzle Task')).getByRole('button', { name: 'Reset' }));
+
+    await waitFor(() => expect(writes()).toHaveLength(1));
+    expect(writes()[0]).toEqual({ method: 'POST', path: '/api/v1/maintenance/items/11/perform', search: '', body: {} });
+  });
+
+  it('Escape keeps the reset dialog open while a comment is typed, and closes it when empty', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    const beta = await printerCard('Beta Printer');
+    await user.click(within(beta).getByRole('button', { name: /expand/i }));
+    await user.click(await within(beta).findByRole('button', { name: 'Reset' }));
+    const dialog = await resetDialog('Nozzle Task');
+    const comment = within(dialog).getByLabelText('Comment (optional)');
+    await user.type(comment, 'Half-written note');
+    await user.keyboard('{Escape}');
+
+    expect(screen.getByRole('heading', { name: 'Reset "Nozzle Task"?' })).toBeInTheDocument();
+    expect(comment).toHaveValue('Half-written note');
+
+    await user.clear(comment);
+    await user.keyboard('{Escape}');
+    await waitFor(() => expect(screen.queryByRole('heading', { name: 'Reset "Nozzle Task"?' })).not.toBeInTheDocument());
+    expect(writes()).toEqual([]);
+  });
+
+  it('a click beside the reset dialog keeps it open while a comment is typed, and closes it when empty', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    const beta = await printerCard('Beta Printer');
+    await user.click(within(beta).getByRole('button', { name: /expand/i }));
+    await user.click(await within(beta).findByRole('button', { name: 'Reset' }));
+    const dialog = await resetDialog('Nozzle Task');
+    const comment = within(dialog).getByLabelText('Comment (optional)');
+    const backdrop = screen.getByRole('heading', { name: 'Reset "Nozzle Task"?' }).closest('.fixed') as HTMLElement;
+    await user.type(comment, 'Half-written note');
+    await user.click(backdrop);
+
+    expect(screen.getByRole('heading', { name: 'Reset "Nozzle Task"?' })).toBeInTheDocument();
+    expect(comment).toHaveValue('Half-written note');
+
+    await user.clear(comment);
+    await user.click(backdrop);
+    await waitFor(() => expect(screen.queryByRole('heading', { name: 'Reset "Nozzle Task"?' })).not.toBeInTheDocument());
+    expect(writes()).toEqual([]);
+  });
+
+  it('cancelling the reset dialog sends nothing', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    const beta = await printerCard('Beta Printer');
+    await user.click(within(beta).getByRole('button', { name: /expand/i }));
+    await user.click(await within(beta).findByRole('button', { name: 'Reset' }));
+    await user.click(within(await resetDialog('Nozzle Task')).getByRole('button', { name: 'Cancel' }));
+
+    await waitFor(() => expect(screen.queryByRole('heading', { name: 'Reset "Nozzle Task"?' })).not.toBeInTheDocument());
+    expect(writes()).toEqual([]);
   });
 
   it('the item toggle PATCHes { enabled } for that item', async () => {
@@ -249,25 +353,288 @@ describe('MaintenancePage wiring: settings tab', () => {
   });
 });
 
-describe('MaintenancePage wiring: permissions', () => {
-  function signInWith(permissions: string[]) {
-    setAuthToken('test-token-1', 'session');
+describe('MaintenancePage wiring: maintenance log', () => {
+  const LOG_ENTRY = {
+    id: 5,
+    printer_id: 2,
+    printer_name: 'Beta Printer',
+    maintenance_type_id: 1,
+    maintenance_type_name: 'Clean Nozzle',
+    hours_at_maintenance: 248.04,
+    notes: 'Swapped to hardened 0.4',
+    performed_by_id: 9,
+    performed_by_username: 'mechanic',
+    performed_at: '2026-11-01T10:30:00',
+  };
+
+  function stubDownloads() {
+    const createObjectURL = vi.fn(() => 'blob:maintenance-log');
+    // A subclass, not a copy: requests still build URLs with `new URL()`.
+    class DownloadURL extends URL {
+      static createObjectURL = createObjectURL;
+      static revokeObjectURL = vi.fn();
+    }
+    vi.stubGlobal('URL', DownloadURL);
+    vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => {});
+    return createObjectURL;
+  }
+
+  beforeEach(() => {
     server.use(
-      http.get('*/api/v1/auth/status', () => HttpResponse.json({ auth_enabled: true, requires_setup: false })),
-      http.get('*/api/v1/auth/me', () =>
-        HttpResponse.json({
-          id: 9,
-          username: 'viewer',
-          is_active: true,
-          is_admin: false,
-          groups: [],
-          permissions,
-          created_at: '2026-01-01T00:00:00Z',
-        }),
-      ),
+      http.get('*/api/v1/maintenance/printers/:id/log', async ({ request, params }) => {
+        await record(request);
+        const items = params.id === '2' ? [LOG_ENTRY] : [];
+        return HttpResponse.json({ items, total: items.length });
+      }),
+      http.get('*/api/v1/maintenance/printers/:id/log/export', async ({ request }) => {
+        await record(request);
+        return new HttpResponse('csv', {
+          headers: { 'Content-Type': 'text/csv', 'Content-Disposition': 'attachment; filename="maintenance_log_Beta.csv"' },
+        });
+      }),
+      http.get('*/api/v1/maintenance/log/export', async ({ request }) => {
+        await record(request);
+        return new HttpResponse('csv', {
+          headers: { 'Content-Type': 'text/csv', 'Content-Disposition': 'attachment; filename="maintenance_log_all.csv"' },
+        });
+      }),
+      http.delete('*/api/v1/maintenance/log/:entryId', async ({ request, params }) => {
+        await record(request);
+        return HttpResponse.json({ status: 'deleted', id: Number(params.entryId) });
+      }),
+      http.delete('*/api/v1/maintenance/log', async ({ request }) => {
+        await record(request);
+        return HttpResponse.json({ deleted: 4 });
+      }),
+      http.delete('*/api/v1/maintenance/printers/:id/log', async ({ request }) => {
+        await record(request);
+        return HttpResponse.json({ deleted: 1 });
+      }),
     );
+  });
+
+  async function openBetaLog(user: ReturnType<typeof userEvent.setup>): Promise<HTMLElement> {
+    await user.click(within(await printerCard('Beta Printer')).getByRole('button', { name: 'Log' }));
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Beta Printer' });
+    await within(dialog).findByText('Clean Nozzle');
+    return dialog;
   }
 
+  /** A confirmation on top of the page, found by its heading. */
+  async function confirmation(title: string): Promise<HTMLElement> {
+    return (await screen.findByRole('heading', { name: title })).closest('div.fixed') as HTMLElement;
+  }
+
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it('a printer\'s Log lists its resets with task, user, hours and comment', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    const beta = await printerCard('Beta Printer');
+    await user.click(within(beta).getByRole('button', { name: 'Log' }));
+
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Beta Printer' });
+    expect(await within(dialog).findByText('Clean Nozzle')).toBeInTheDocument();
+    expect(within(dialog).getByText('by mechanic')).toBeInTheDocument();
+    expect(within(dialog).getByText('at 248.0 h')).toBeInTheDocument();
+    expect(within(dialog).getByText('Swapped to hardened 0.4')).toBeInTheDocument();
+    expect(within(dialog).getByText('Showing 1 of 1')).toBeInTheDocument();
+    expect(sent.some((s) => s.path === '/api/v1/maintenance/printers/2/log')).toBe(true);
+  });
+
+  it('a printer without resets shows the empty log and cannot export', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(within(await printerCard('Alpha Printer')).getByRole('button', { name: 'Log' }));
+
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Alpha Printer' });
+    expect(await within(dialog).findByText('No maintenance has been logged for this printer yet.')).toBeInTheDocument();
+    expect(within(dialog).getByRole('button', { name: 'Export CSV' })).toBeDisabled();
+  });
+
+  it('Load more fetches the next page by offset, each row once', async () => {
+    const all = Array.from({ length: 75 }, (_, n) => ({ ...LOG_ENTRY, id: 1000 - n, notes: `reset ${n}` }));
+    server.use(
+      http.get('*/api/v1/maintenance/printers/:id/log', async ({ request }) => {
+        await record(request);
+        const url = new URL(request.url);
+        const limit = Number(url.searchParams.get('limit'));
+        const offset = Number(url.searchParams.get('offset'));
+        return HttpResponse.json({ items: all.slice(offset, offset + limit), total: all.length });
+      }),
+    );
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(within(await printerCard('Beta Printer')).getByRole('button', { name: 'Log' }));
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Beta Printer' });
+    expect(await within(dialog).findByText('Showing 50 of 75')).toBeInTheDocument();
+    await user.click(within(dialog).getByRole('button', { name: 'Load more' }));
+
+    expect(await within(dialog).findByText('Showing 75 of 75')).toBeInTheDocument();
+    expect(within(dialog).getByText('reset 74')).toBeInTheDocument();
+    expect(within(dialog).queryByRole('button', { name: 'Load more' })).not.toBeInTheDocument();
+    const logReads = sent.filter((s) => s.path === '/api/v1/maintenance/printers/2/log').map((s) => s.search);
+    expect(logReads).toEqual(['?limit=50&offset=0', '?limit=50&offset=50']);
+  });
+
+  it('a log that fails to load says so, offers a retry and still allows the export', async () => {
+    server.use(
+      http.get('*/api/v1/maintenance/printers/:id/log', () =>
+        HttpResponse.json({ detail: 'Database is locked' }, { status: 500 }),
+      ),
+    );
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(within(await printerCard('Beta Printer')).getByRole('button', { name: 'Log' }));
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Beta Printer' });
+
+    expect(
+      await within(dialog).findByText('Could not load the maintenance log: Database is locked', {}, { timeout: 5000 }),
+    ).toBeInTheDocument();
+    expect(within(dialog).queryByText('No maintenance has been logged for this printer yet.')).not.toBeInTheDocument();
+    expect(within(dialog).getByRole('button', { name: 'Retry' })).toBeInTheDocument();
+    expect(within(dialog).getByRole('button', { name: 'Export CSV' })).not.toBeDisabled();
+  });
+
+  it('Export CSV downloads that printer\'s log', async () => {
+    const createObjectURL = stubDownloads();
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(within(await printerCard('Beta Printer')).getByRole('button', { name: 'Log' }));
+    const dialog = await screen.findByRole('dialog', { name: 'Maintenance log: Beta Printer' });
+    await within(dialog).findByText('Clean Nozzle');
+    await user.click(within(dialog).getByRole('button', { name: 'Export CSV' }));
+
+    await waitFor(() => expect(createObjectURL).toHaveBeenCalledTimes(1));
+    expect(sent.some((s) => s.path === '/api/v1/maintenance/printers/2/log/export')).toBe(true);
+  });
+
+  it('Export log in the header downloads the whole fleet\'s log', async () => {
+    const createObjectURL = stubDownloads();
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(await screen.findByRole('button', { name: 'Export log' }));
+
+    await waitFor(() => expect(createObjectURL).toHaveBeenCalledTimes(1));
+    expect(sent.some((s) => s.path === '/api/v1/maintenance/log/export')).toBe(true);
+  });
+
+  it('deleting an entry asks first, then deletes that entry and reloads the log', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+    const dialog = await openBetaLog(user);
+
+    await user.click(within(dialog).getByRole('button', { name: 'Delete entry' }));
+    const confirm = await confirmation('Delete this log entry?');
+    expect(within(confirm).getByText(/"Clean Nozzle" from .* is permanently removed/)).toBeInTheDocument();
+    expect(writes()).toEqual([]);
+    await user.click(within(confirm).getByRole('button', { name: 'Delete' }));
+
+    await waitFor(() =>
+      expect(writes()).toEqual([{ method: 'DELETE', path: '/api/v1/maintenance/log/5', search: '', body: null }]),
+    );
+    expect(await screen.findByText('Log entry deleted')).toBeInTheDocument();
+    await waitFor(() =>
+      expect(sent.filter((s) => s.method === 'GET' && s.path === '/api/v1/maintenance/printers/2/log')).toHaveLength(2),
+    );
+    expect(screen.queryByRole('heading', { name: 'Delete this log entry?' })).not.toBeInTheDocument();
+  });
+
+  it('Escape cancels the entry delete and leaves the log open', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+    const dialog = await openBetaLog(user);
+
+    await user.click(within(dialog).getByRole('button', { name: 'Delete entry' }));
+    await confirmation('Delete this log entry?');
+    await user.keyboard('{Escape}');
+
+    await waitFor(() => expect(screen.queryByRole('heading', { name: 'Delete this log entry?' })).not.toBeInTheDocument());
+    expect(screen.getByRole('dialog', { name: 'Maintenance log: Beta Printer' })).toBeInTheDocument();
+    expect(writes()).toEqual([]);
+  });
+
+  it('Clean up in a printer\'s log deletes its entries older than the chosen days', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+    const dialog = await openBetaLog(user);
+
+    await user.click(within(dialog).getByRole('button', { name: 'Clean up' }));
+    const confirm = await confirmation('Delete old log entries?');
+    expect(within(confirm).getByText(/maintenance log of Beta Printer/)).toBeInTheDocument();
+    const days = within(confirm).getByLabelText('Delete entries older than (days)');
+    expect(days).toHaveValue(365);
+    await user.clear(days);
+    await user.type(days, '90');
+    await user.click(within(confirm).getByRole('button', { name: 'Delete' }));
+
+    await waitFor(() =>
+      expect(writes()).toEqual([
+        { method: 'DELETE', path: '/api/v1/maintenance/printers/2/log', search: '?older_than_days=90', body: null },
+      ]),
+    );
+    expect(await screen.findByText('Log entries deleted: 1')).toBeInTheDocument();
+  });
+
+  it('the cleanup cannot be confirmed without an age of at least one day', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+    const dialog = await openBetaLog(user);
+
+    await user.click(within(dialog).getByRole('button', { name: 'Clean up' }));
+    const confirm = await confirmation('Delete old log entries?');
+    const days = within(confirm).getByLabelText('Delete entries older than (days)');
+    const deleteButton = within(confirm).getByRole('button', { name: 'Delete' });
+
+    await user.clear(days);
+    expect(deleteButton).toBeDisabled();
+    await user.type(days, '0');
+    expect(deleteButton).toBeDisabled();
+    await user.clear(days);
+    await user.type(days, '1.5');
+    expect(deleteButton).toBeDisabled();
+    expect(writes()).toEqual([]);
+  });
+
+  it('Clean up log in the header cleans up the whole fleet', async () => {
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    await user.click(await screen.findByRole('button', { name: 'Clean up log' }));
+    const confirm = await confirmation('Delete old log entries?');
+    expect(within(confirm).getByText(/for all printers you can see/)).toBeInTheDocument();
+    await user.click(within(confirm).getByRole('button', { name: 'Delete' }));
+
+    await waitFor(() =>
+      expect(writes()).toEqual([
+        { method: 'DELETE', path: '/api/v1/maintenance/log', search: '?older_than_days=365', body: null },
+      ]),
+    );
+    expect(await screen.findByText('Log entries deleted: 4')).toBeInTheDocument();
+  });
+
+  it('without maintenance:delete there is no cleanup and no entry delete', async () => {
+    signInWith(['maintenance:read']);
+    const user = userEvent.setup();
+    render(<MaintenancePage />);
+
+    expect(await screen.findByRole('button', { name: 'Export log' })).toBeInTheDocument();
+    await waitFor(() => expect(screen.queryByRole('button', { name: 'Clean up log' })).not.toBeInTheDocument());
+    const dialog = await openBetaLog(user);
+    expect(within(dialog).queryByRole('button', { name: 'Clean up' })).not.toBeInTheDocument();
+    expect(within(dialog).queryByRole('button', { name: 'Delete entry' })).not.toBeInTheDocument();
+  });
+});
+
+describe('MaintenancePage wiring: permissions', () => {
   it('a read-only user gets disabled controls and nothing is sent', async () => {
     signInWith(['maintenance:read']);
     const user = userEvent.setup();

+ 62 - 0
frontend/src/api/client.ts

@@ -4518,6 +4518,29 @@ export interface PrinterMaintenanceOverview {
   warning_count: number;
 }
 
+// One reset in a printer's maintenance log. The names are as they were at the
+// reset; the ids are null once the printer or custom task is deleted.
+export interface MaintenanceLogEntry {
+  id: number;
+  printer_id: number | null;
+  printer_name: string;
+  maintenance_type_id: number | null;
+  maintenance_type_name: string;
+  hours_at_maintenance: number;
+  notes: string | null;
+  performed_by_id: number | null;
+  performed_by_username: string | null;  // null when authentication was off
+  performed_at: string;
+}
+
+export interface MaintenanceLogPage {
+  items: MaintenanceLogEntry[];
+  total: number;
+}
+
+// Must match MAINTENANCE_NOTES_MAX_LENGTH in backend/app/schemas/maintenance.py.
+export const MAINTENANCE_NOTES_MAX_LENGTH = 10000;
+
 // External Links (sidebar)
 export interface ExternalLink {
   id: number;
@@ -7718,6 +7741,45 @@ export const api = {
       method: 'POST',
       body: JSON.stringify({ notes }),
     }),
+  getMaintenanceLog: (printerId: number, options?: { limit?: number; offset?: number }) => {
+    const params = new URLSearchParams();
+    if (options?.limit !== undefined) params.set('limit', String(options.limit));
+    if (options?.offset !== undefined) params.set('offset', String(options.offset));
+    const query = params.toString();
+    return request<MaintenanceLogPage>(`/maintenance/printers/${printerId}/log${query ? `?${query}` : ''}`);
+  },
+  // One printer's log, or with no printer the whole fleet's (deleted printers included).
+  downloadMaintenanceLog: async (printerId?: number): Promise<void> => {
+    const headers: Record<string, string> = {};
+    if (authToken) {
+      headers['Authorization'] = `Bearer ${authToken}`;
+    }
+    const path = printerId === undefined ? '/maintenance/log/export' : `/maintenance/printers/${printerId}/log/export`;
+    const response = await fetch(`${API_BASE}${path}`, { headers });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new Error(error.detail || `HTTP ${response.status}`);
+    }
+    const disposition = response.headers.get('Content-Disposition');
+    const filename = parseContentDispositionFilename(disposition) || 'maintenance_log.csv';
+    const blob = await response.blob();
+    const url = window.URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    window.URL.revokeObjectURL(url);
+  },
+  // Deletes the entries older than the given days: one printer's, or with no
+  // printer the whole fleet's (deleted printers included for an unscoped caller).
+  cleanUpMaintenanceLog: (olderThanDays: number, printerId?: number) => {
+    const path = printerId === undefined ? '/maintenance/log' : `/maintenance/printers/${printerId}/log`;
+    return request<{ deleted: number }>(`${path}?older_than_days=${olderThanDays}`, { method: 'DELETE' });
+  },
+  deleteMaintenanceLogEntry: (entryId: number) =>
+    request<{ status: string; id: number }>(`/maintenance/log/${entryId}`, { method: 'DELETE' }),
   setPrinterHours: (printerId: number, totalHours: number) =>
     request<{ printer_id: number; total_hours: number; archive_hours: number; offset_hours: number }>(
       `/maintenance/printers/${printerId}/hours?total_hours=${totalHours}`,

+ 9 - 4
frontend/src/components/ConfirmModal.tsx

@@ -28,6 +28,10 @@ interface ConfirmModalProps {
   // used for opt-in checkboxes (e.g. the "Also remove from statistics"
   // toggle in the archive delete confirmation, #1343).
   children?: ReactNode;
+  // When false, a click on the backdrop and Escape do nothing; only the
+  // buttons close it. For a dialog holding typed input (the maintenance
+  // reset comment) that a stray click would otherwise throw away.
+  dismissible?: boolean;
   onConfirm: () => void;
   onCancel: () => void;
 }
@@ -45,6 +49,7 @@ export function ConfirmModal({
   loadingText,
   confirmDisabled = false,
   children,
+  dismissible = true,
   onConfirm,
   onCancel,
 }: ConfirmModalProps) {
@@ -52,14 +57,14 @@ export function ConfirmModal({
   const resolvedConfirmText = confirmText ?? t('common.confirm');
   const resolvedCancelText = cancelText ?? t('common.cancel');
   const resolvedLoadingText = loadingText ?? t('common.loading');
-  // Close on Escape key (but not while loading)
+  // Close on Escape key (but not while loading, nor when not dismissible)
   useEffect(() => {
     const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === 'Escape' && !isLoading) onCancel();
+      if (e.key === 'Escape' && !isLoading && dismissible) onCancel();
     };
     window.addEventListener('keydown', handleKeyDown);
     return () => window.removeEventListener('keydown', handleKeyDown);
-  }, [onCancel, isLoading]);
+  }, [onCancel, isLoading, dismissible]);
 
   const variantStyles = {
     danger: {
@@ -81,7 +86,7 @@ export function ConfirmModal({
   return (
     <div
       className={`fixed inset-0 bg-black/50 flex items-center justify-center p-4 ${overlayZIndex ?? 'z-50'}`}
-      onClick={isLoading ? undefined : onCancel}
+      onClick={isLoading || !dismissible ? undefined : onCancel}
     >
       <Card
         className={`w-full max-w-md ${cardClassName ?? ''}`}

+ 59 - 0
frontend/src/components/MaintenanceLogCleanupModal.tsx

@@ -0,0 +1,59 @@
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ConfirmModal } from './ConfirmModal';
+
+// Must match the bounds of older_than_days in backend/app/api/routes/maintenance.py.
+const MIN_DAYS = 1;
+const MAX_DAYS = 36500;
+
+interface MaintenanceLogCleanupModalProps {
+  /** The printer whose log is cleaned up; none for every printer the user can see. */
+  printerName?: string;
+  isLoading: boolean;
+  onConfirm: (olderThanDays: number) => void;
+  onCancel: () => void;
+}
+
+/** Asks how old maintenance log entries must be to be deleted, and confirms it. */
+export function MaintenanceLogCleanupModal({ printerName, isLoading, onConfirm, onCancel }: MaintenanceLogCleanupModalProps) {
+  const { t } = useTranslation();
+  const [days, setDays] = useState('365');
+  const parsed = Number(days);
+  const valid = days.trim() !== '' && Number.isInteger(parsed) && parsed >= MIN_DAYS && parsed <= MAX_DAYS;
+
+  return (
+    <ConfirmModal
+      title={t('maintenance.cleanUpTitle')}
+      message={
+        printerName === undefined
+          ? t('maintenance.cleanUpMessageAll')
+          : t('maintenance.cleanUpMessage', { printer: printerName })
+      }
+      confirmText={t('common.delete')}
+      variant="danger"
+      overlayZIndex="z-[60]"
+      isLoading={isLoading}
+      confirmDisabled={!valid}
+      onConfirm={() => {
+        if (valid) onConfirm(parsed);
+      }}
+      onCancel={onCancel}
+    >
+      <label htmlFor="maintenance-cleanup-days" className="block text-sm text-bambu-gray mb-1">
+        {t('maintenance.cleanUpOlderThan')}
+      </label>
+      <input
+        id="maintenance-cleanup-days"
+        type="number"
+        inputMode="numeric"
+        min={MIN_DAYS}
+        max={MAX_DAYS}
+        step={1}
+        value={days}
+        onChange={(e) => setDays(e.target.value)}
+        className="w-32 px-3 py-2 bg-bambu-dark border border-bambu-dark-tertiary rounded-lg text-white text-sm focus:border-bambu-green focus:outline-none"
+        autoFocus
+      />
+    </ConfirmModal>
+  );
+}

+ 257 - 0
frontend/src/components/MaintenanceLogModal.tsx

@@ -0,0 +1,257 @@
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { useInfiniteQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { AlertTriangle, Download, History, Loader2, Trash2, X } from 'lucide-react';
+import { api } from '../api/client';
+import type { MaintenanceLogEntry } from '../api/client';
+import { formatDateTime, type TimeFormat } from '../utils/date';
+import { Button } from './Button';
+import { ConfirmModal } from './ConfirmModal';
+import { MaintenanceLogCleanupModal } from './MaintenanceLogCleanupModal';
+import { useToast } from '../contexts/ToastContext';
+import { useAuth } from '../contexts/AuthContext';
+import { useUiSettings } from '../hooks/useUiSettings';
+
+const PAGE_SIZE = 50;
+
+interface MaintenanceLogModalProps {
+  printerId: number;
+  printerName: string;
+  onClose: () => void;
+}
+
+/** A printer's maintenance log, newest first, with its CSV export and cleanup. */
+export function MaintenanceLogModal({ printerId, printerName, onClose }: MaintenanceLogModalProps) {
+  const { t } = useTranslation();
+  const { showToast } = useToast();
+  const { hasPermission } = useAuth();
+  const queryClient = useQueryClient();
+  const { data: settings } = useUiSettings();
+  const timeFormat: TimeFormat = settings?.time_format || 'system';
+  const canDelete = hasPermission('maintenance:delete');
+  const [exporting, setExporting] = useState(false);
+  const [cleanupOpen, setCleanupOpen] = useState(false);
+  const [pendingDelete, setPendingDelete] = useState<MaintenanceLogEntry | null>(null);
+  // Escape closes the confirmation on top first, not the log under it too.
+  const confirming = cleanupOpen || pendingDelete !== null;
+
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape' && !confirming) onClose();
+    };
+    window.addEventListener('keydown', handleKeyDown);
+    return () => window.removeEventListener('keydown', handleKeyDown);
+  }, [onClose, confirming]);
+
+  // One page per request, each fetched once: "Load more" asks for the next
+  // offset instead of a bigger first page (the API caps a page at 500).
+  const { data, isLoading, isError, error, refetch, fetchNextPage, hasNextPage, isFetchingNextPage } = useInfiniteQuery({
+    queryKey: ['maintenanceLog', printerId],
+    queryFn: ({ pageParam }) => api.getMaintenanceLog(printerId, { limit: PAGE_SIZE, offset: pageParam }),
+    initialPageParam: 0,
+    getNextPageParam: (lastPage, pages) => {
+      const loaded = pages.reduce((sum, page) => sum + page.items.length, 0);
+      return lastPage.items.length > 0 && loaded < lastPage.total ? loaded : undefined;
+    },
+  });
+
+  const entries = data?.pages.flatMap((page) => page.items) ?? [];
+  const total = data?.pages.at(-1)?.total ?? 0;
+  // Only an empty log has nothing to export or clean up; when the list failed
+  // to load, both may still work.
+  const logEmpty = !isError && total === 0;
+
+  const onDeleteError = (err: Error) => showToast(t('maintenance.deleteFailed', { error: err.message }), 'error');
+
+  const cleanupMutation = useMutation({
+    mutationFn: (olderThanDays: number) => api.cleanUpMaintenanceLog(olderThanDays, printerId),
+    onSuccess: (result) => {
+      queryClient.invalidateQueries({ queryKey: ['maintenanceLog'] });
+      setCleanupOpen(false);
+      showToast(t('maintenance.cleanUpDone', { deleted: result.deleted }));
+    },
+    onError: onDeleteError,
+  });
+
+  const deleteEntryMutation = useMutation({
+    mutationFn: (entryId: number) => api.deleteMaintenanceLogEntry(entryId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['maintenanceLog'] });
+      setPendingDelete(null);
+      showToast(t('maintenance.entryDeleted'));
+    },
+    onError: onDeleteError,
+  });
+
+  const handleExport = async () => {
+    setExporting(true);
+    try {
+      await api.downloadMaintenanceLog(printerId);
+    } catch (err) {
+      showToast(t('maintenance.exportFailed', { error: (err as Error).message }), 'error');
+    } finally {
+      setExporting(false);
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 bg-black/50 flex items-center justify-center z-50 p-4" onClick={confirming ? undefined : onClose}>
+      <div
+        role="dialog"
+        aria-modal="true"
+        aria-labelledby="maintenance-log-title"
+        className="bg-bambu-dark-secondary border border-bambu-dark-tertiary rounded-lg w-full max-w-3xl max-h-[85vh] flex flex-col"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* Header */}
+        <div className="p-4 border-b border-bambu-dark-tertiary flex items-center justify-between gap-3">
+          <div className="flex items-center gap-3 min-w-0">
+            <History className="w-5 h-5 text-bambu-green shrink-0" />
+            <h2 id="maintenance-log-title" className="text-lg font-semibold text-white truncate">
+              {t('maintenance.logTitle', { printer: printerName })}
+            </h2>
+          </div>
+          <div className="flex items-center gap-2 shrink-0 flex-wrap justify-end">
+            {canDelete && (
+              <Button size="sm" variant="secondary" onClick={() => setCleanupOpen(true)} disabled={logEmpty}>
+                <Trash2 className="w-3.5 h-3.5" />
+                {t('maintenance.cleanUp')}
+              </Button>
+            )}
+            <Button size="sm" variant="secondary" onClick={handleExport} disabled={exporting || logEmpty}>
+              {exporting ? <Loader2 className="w-3.5 h-3.5 animate-spin" /> : <Download className="w-3.5 h-3.5" />}
+              {t('maintenance.exportCsv')}
+            </Button>
+            <button
+              onClick={onClose}
+              className="p-1 text-bambu-gray hover:text-white transition-colors"
+              aria-label={t('common.close')}
+            >
+              <X className="w-5 h-5" />
+            </button>
+          </div>
+        </div>
+
+        {/* Entries */}
+        <div className="flex-1 overflow-y-auto p-4">
+          {isLoading ? (
+            <div className="flex justify-center py-12">
+              <Loader2 className="w-6 h-6 text-bambu-green animate-spin" />
+            </div>
+          ) : isError && entries.length === 0 ? (
+            <div role="alert" className="flex flex-col items-center gap-3 py-12 text-center">
+              <p className="flex items-center gap-2 text-red-700 dark:text-red-400">
+                <AlertTriangle className="w-4 h-4 shrink-0" />
+                {t('maintenance.logLoadFailed', { error: (error as Error).message })}
+              </p>
+              <Button size="sm" variant="secondary" onClick={() => refetch()}>
+                {t('common.retry')}
+              </Button>
+            </div>
+          ) : entries.length === 0 ? (
+            <p className="text-center text-bambu-gray py-12">{t('maintenance.logEmpty')}</p>
+          ) : (
+            <ul className="space-y-2">
+              {entries.map((entry) => (
+                <LogEntryRow
+                  key={entry.id}
+                  entry={entry}
+                  timeFormat={timeFormat}
+                  onDelete={canDelete ? () => setPendingDelete(entry) : undefined}
+                />
+              ))}
+            </ul>
+          )}
+        </div>
+
+        {/* Footer */}
+        {total > 0 && (
+          <div className="px-4 py-3 border-t border-bambu-dark-tertiary flex items-center justify-between gap-3 text-sm">
+            <span className="text-bambu-gray">
+              {t('maintenance.logShowing', { shown: entries.length, total })}
+            </span>
+            {isError && entries.length > 0 ? (
+              <span role="alert" className="flex items-center gap-2 text-red-700 dark:text-red-400">
+                <AlertTriangle className="w-4 h-4 shrink-0" />
+                {t('maintenance.logLoadFailed', { error: (error as Error).message })}
+                <Button size="sm" variant="secondary" onClick={() => fetchNextPage()}>
+                  {t('common.retry')}
+                </Button>
+              </span>
+            ) : (
+              hasNextPage && (
+                <Button size="sm" variant="secondary" onClick={() => fetchNextPage()} disabled={isFetchingNextPage}>
+                  {isFetchingNextPage && <Loader2 className="w-3.5 h-3.5 animate-spin" />}
+                  {t('maintenance.loadMore')}
+                </Button>
+              )
+            )}
+          </div>
+        )}
+
+        {cleanupOpen && (
+          <MaintenanceLogCleanupModal
+            printerName={printerName}
+            isLoading={cleanupMutation.isPending}
+            onConfirm={(days) => cleanupMutation.mutate(days)}
+            onCancel={() => setCleanupOpen(false)}
+          />
+        )}
+
+        {pendingDelete && (
+          <ConfirmModal
+            title={t('maintenance.deleteEntryTitle')}
+            message={t('maintenance.deleteEntryMessage', {
+              task: pendingDelete.maintenance_type_name,
+              date: formatDateTime(pendingDelete.performed_at, timeFormat),
+            })}
+            confirmText={t('common.delete')}
+            variant="danger"
+            overlayZIndex="z-[60]"
+            isLoading={deleteEntryMutation.isPending}
+            onConfirm={() => deleteEntryMutation.mutate(pendingDelete.id)}
+            onCancel={() => setPendingDelete(null)}
+          />
+        )}
+      </div>
+    </div>
+  );
+}
+
+interface LogEntryRowProps {
+  entry: MaintenanceLogEntry;
+  timeFormat: TimeFormat;
+  /** Shown only to users who may delete entries. */
+  onDelete?: () => void;
+}
+
+function LogEntryRow({ entry, timeFormat, onDelete }: LogEntryRowProps) {
+  const { t } = useTranslation();
+  return (
+    <li className="rounded-lg border border-bambu-dark-tertiary bg-bambu-dark/30 px-3 py-2">
+      <div className="flex flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
+        <span className="font-medium text-white">{entry.maintenance_type_name}</span>
+        <span className="flex items-center gap-2">
+          <time dateTime={entry.performed_at} className="text-xs text-bambu-gray">
+            {formatDateTime(entry.performed_at, timeFormat)}
+          </time>
+          {onDelete && (
+            <button
+              onClick={onDelete}
+              className="p-1 -my-1 rounded text-bambu-gray hover:text-red-600 dark:hover:text-red-400 transition-colors self-center"
+              aria-label={t('maintenance.deleteEntry')}
+              title={t('maintenance.deleteEntry')}
+            >
+              <Trash2 className="w-3.5 h-3.5" />
+            </button>
+          )}
+        </span>
+      </div>
+      <div className="mt-0.5 flex flex-wrap gap-x-3 text-xs text-bambu-gray">
+        {entry.performed_by_username && <span>{t('maintenance.performedBy', { user: entry.performed_by_username })}</span>}
+        <span>{t('maintenance.atPrintHours', { hours: entry.hours_at_maintenance.toFixed(1) })}</span>
+      </div>
+      {entry.notes && <p className="mt-1.5 text-sm text-white/90 whitespace-pre-wrap break-words">{entry.notes}</p>}
+    </li>
+  );
+}

+ 31 - 0
frontend/src/i18n/locales/de.ts

@@ -2036,6 +2036,37 @@ export default {
     noPermissionEditIntervals: 'Sie haben keine Berechtigung, Intervalle zu bearbeiten',
     // Configure link
     configureSettings: 'Wartungstypen und Intervalle konfigurieren',
+    // Maintenance log
+    resetDialogTitle: '„{{task}}“ zurücksetzen?',
+    resetDialogMessage: 'Markiert diese Aufgabe auf {{printer}} als erledigt und startet ihr Intervall neu. Das Zurücksetzen wird im Wartungsprotokoll des Druckers festgehalten.',
+    commentLabel: 'Kommentar (optional)',
+    commentPlaceholder: 'Was gemacht wurde, verwendete Teile, Auffälligkeiten…',
+    log: 'Protokoll',
+    viewLog: 'Wartungsprotokoll anzeigen',
+    logTitle: 'Wartungsprotokoll: {{printer}}',
+    logEmpty: 'Für diesen Drucker wurde noch keine Wartung protokolliert.',
+    logShowing: '{{shown}} von {{total}} angezeigt',
+    loadMore: 'Mehr laden',
+    exportCsv: 'CSV exportieren',
+    exportAll: 'Protokoll exportieren',
+    exportAllHint: 'Wartungsprotokoll aller für Sie sichtbaren Drucker als CSV herunterladen – gelöschte Drucker inklusive, wenn Sie alle Drucker sehen',
+    performedBy: 'von {{user}}',
+    atPrintHours: 'bei {{hours}} h',
+    exportFailed: 'Export fehlgeschlagen: {{error}}',
+    logLoadFailed: 'Wartungsprotokoll konnte nicht geladen werden: {{error}}',
+    cleanUp: 'Bereinigen',
+    cleanUpLog: 'Protokoll bereinigen',
+    cleanUpHint: 'Alte Einträge im Wartungsprotokoll aller für Sie sichtbaren Drucker löschen',
+    cleanUpTitle: 'Alte Protokolleinträge löschen?',
+    cleanUpMessage: 'Löscht endgültig die Einträge im Wartungsprotokoll von {{printer}}, die älter als die unten angegebene Anzahl Tage sind. Exportieren Sie das Protokoll vorher, um eine Kopie zu behalten.',
+    cleanUpMessageAll: 'Löscht endgültig die Einträge im Wartungsprotokoll, die älter als die unten angegebene Anzahl Tage sind, für alle für Sie sichtbaren Drucker – gelöschte Drucker inklusive, wenn Sie alle Drucker sehen. Exportieren Sie das Protokoll vorher, um eine Kopie zu behalten.',
+    cleanUpOlderThan: 'Einträge löschen, die älter sind als (Tage)',
+    cleanUpDone: 'Gelöschte Protokolleinträge: {{deleted}}',
+    deleteEntry: 'Eintrag löschen',
+    deleteEntryTitle: 'Diesen Protokolleintrag löschen?',
+    deleteEntryMessage: '„{{task}}“ vom {{date}} wird endgültig aus dem Wartungsprotokoll entfernt. Das letzte Zurücksetzen der Aufgabe bleibt bestehen.',
+    entryDeleted: 'Protokolleintrag gelöscht',
+    deleteFailed: 'Löschen fehlgeschlagen: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/en.ts

@@ -2056,6 +2056,37 @@ export default {
     noPermissionEditIntervals: 'You do not have permission to edit intervals',
     // Configure link
     configureSettings: 'Configure maintenance types and intervals',
+    // Maintenance log
+    resetDialogTitle: 'Reset "{{task}}"?',
+    resetDialogMessage: 'Marks this task as done on {{printer}} and starts its interval again. The reset is added to the printer\'s maintenance log.',
+    commentLabel: 'Comment (optional)',
+    commentPlaceholder: 'What was done, parts used, anything noticed…',
+    log: 'Log',
+    viewLog: 'View maintenance log',
+    logTitle: 'Maintenance log: {{printer}}',
+    logEmpty: 'No maintenance has been logged for this printer yet.',
+    logShowing: 'Showing {{shown}} of {{total}}',
+    loadMore: 'Load more',
+    exportCsv: 'Export CSV',
+    exportAll: 'Export log',
+    exportAllHint: 'Download the maintenance log of all printers you can see as CSV, including printers that were deleted if you can see every printer',
+    performedBy: 'by {{user}}',
+    atPrintHours: 'at {{hours}} h',
+    exportFailed: 'Export failed: {{error}}',
+    logLoadFailed: 'Could not load the maintenance log: {{error}}',
+    cleanUp: 'Clean up',
+    cleanUpLog: 'Clean up log',
+    cleanUpHint: 'Delete old maintenance log entries of all printers you can see',
+    cleanUpTitle: 'Delete old log entries?',
+    cleanUpMessage: 'Permanently deletes the entries in the maintenance log of {{printer}} that are older than the number of days below. Export the log first to keep a copy.',
+    cleanUpMessageAll: 'Permanently deletes the maintenance log entries older than the number of days below, for all printers you can see, including printers that were deleted if you can see every printer. Export the log first to keep a copy.',
+    cleanUpOlderThan: 'Delete entries older than (days)',
+    cleanUpDone: 'Log entries deleted: {{deleted}}',
+    deleteEntry: 'Delete entry',
+    deleteEntryTitle: 'Delete this log entry?',
+    deleteEntryMessage: '"{{task}}" from {{date}} is permanently removed from the maintenance log. The task\'s last reset stays as it is.',
+    entryDeleted: 'Log entry deleted',
+    deleteFailed: 'Delete failed: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/es.ts

@@ -2037,6 +2037,37 @@ export default {
     noPermissionEditIntervals: 'No tiene permiso para editar intervalos',
     // Configure link
     configureSettings: 'Configurar tipos e intervalos de mantenimiento',
+    // Maintenance log
+    resetDialogTitle: '¿Restablecer «{{task}}»?',
+    resetDialogMessage: 'Marca esta tarea como hecha en {{printer}} y reinicia su intervalo. El restablecimiento se añade al registro de mantenimiento de la impresora.',
+    commentLabel: 'Comentario (opcional)',
+    commentPlaceholder: 'Qué se hizo, piezas usadas, algo que llamó la atención…',
+    log: 'Registro',
+    viewLog: 'Ver registro de mantenimiento',
+    logTitle: 'Registro de mantenimiento: {{printer}}',
+    logEmpty: 'Todavía no se ha registrado mantenimiento para esta impresora.',
+    logShowing: 'Mostrando {{shown}} de {{total}}',
+    loadMore: 'Cargar más',
+    exportCsv: 'Exportar CSV',
+    exportAll: 'Exportar registro',
+    exportAllHint: 'Descargar como CSV el registro de mantenimiento de todas las impresoras visibles, incluidas las eliminadas si tiene acceso a todas las impresoras',
+    performedBy: 'por {{user}}',
+    atPrintHours: 'a las {{hours}} h de impresión',
+    exportFailed: 'Error al exportar: {{error}}',
+    logLoadFailed: 'No se pudo cargar el registro de mantenimiento: {{error}}',
+    cleanUp: 'Limpiar',
+    cleanUpLog: 'Limpiar registro',
+    cleanUpHint: 'Eliminar las entradas antiguas del registro de mantenimiento de todas las impresoras visibles',
+    cleanUpTitle: '¿Eliminar entradas antiguas del registro?',
+    cleanUpMessage: 'Elimina definitivamente las entradas del registro de mantenimiento de {{printer}} con más antigüedad que el número de días indicado abajo. Exporte antes el registro si desea conservar una copia.',
+    cleanUpMessageAll: 'Elimina definitivamente las entradas del registro de mantenimiento con más antigüedad que el número de días indicado abajo, de todas las impresoras visibles, incluidas las eliminadas si tiene acceso a todas las impresoras. Exporte antes el registro si desea conservar una copia.',
+    cleanUpOlderThan: 'Eliminar entradas con más de (días)',
+    cleanUpDone: 'Entradas del registro eliminadas: {{deleted}}',
+    deleteEntry: 'Eliminar entrada',
+    deleteEntryTitle: '¿Eliminar esta entrada del registro?',
+    deleteEntryMessage: '«{{task}}» del {{date}} se elimina definitivamente del registro de mantenimiento. El último restablecimiento de la tarea no cambia.',
+    entryDeleted: 'Entrada del registro eliminada',
+    deleteFailed: 'Error al eliminar: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/fr.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: 'Pas d\'autorisation modification intervalles',
     // Configure link
     configureSettings: 'Configurer types et intervalles',
+    // Maintenance log
+    resetDialogTitle: 'Réinitialiser « {{task}} » ?',
+    resetDialogMessage: 'Marque cette tâche comme effectuée sur {{printer}} et redémarre son intervalle. La réinitialisation est ajoutée au journal de maintenance de l\'imprimante.',
+    commentLabel: 'Commentaire (facultatif)',
+    commentPlaceholder: 'Ce qui a été fait, pièces utilisées, remarques…',
+    log: 'Journal',
+    viewLog: 'Voir le journal de maintenance',
+    logTitle: 'Journal de maintenance : {{printer}}',
+    logEmpty: 'Aucune maintenance n\'a encore été enregistrée pour cette imprimante.',
+    logShowing: '{{shown}} sur {{total}} affichés',
+    loadMore: 'Charger plus',
+    exportCsv: 'Exporter en CSV',
+    exportAll: 'Exporter le journal',
+    exportAllHint: 'Télécharger en CSV le journal de maintenance de toutes les imprimantes visibles, y compris les imprimantes supprimées si vous voyez toutes les imprimantes',
+    performedBy: 'par {{user}}',
+    atPrintHours: 'à {{hours}} h d\'impression',
+    exportFailed: 'Échec de l\'export : {{error}}',
+    logLoadFailed: 'Impossible de charger le journal de maintenance : {{error}}',
+    cleanUp: 'Nettoyer',
+    cleanUpLog: 'Nettoyer le journal',
+    cleanUpHint: 'Supprimer les anciennes entrées du journal de maintenance de toutes les imprimantes visibles',
+    cleanUpTitle: 'Supprimer les anciennes entrées du journal ?',
+    cleanUpMessage: 'Supprime définitivement les entrées du journal de maintenance de {{printer}} plus anciennes que le nombre de jours ci-dessous. Exportez d\'abord le journal pour en garder une copie.',
+    cleanUpMessageAll: 'Supprime définitivement les entrées du journal de maintenance plus anciennes que le nombre de jours ci-dessous, pour toutes les imprimantes visibles, y compris les imprimantes supprimées si vous voyez toutes les imprimantes. Exportez d\'abord le journal pour en garder une copie.',
+    cleanUpOlderThan: 'Supprimer les entrées de plus de (jours)',
+    cleanUpDone: 'Entrées du journal supprimées : {{deleted}}',
+    deleteEntry: 'Supprimer l\'entrée',
+    deleteEntryTitle: 'Supprimer cette entrée du journal ?',
+    deleteEntryMessage: '« {{task}} » du {{date}} est définitivement retiré du journal de maintenance. La dernière réinitialisation de la tâche reste inchangée.',
+    entryDeleted: 'Entrée du journal supprimée',
+    deleteFailed: 'Échec de la suppression : {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/it.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: 'Non hai il permesso di modificare intervalli',
     // Configure link
     configureSettings: 'Configura tipi e intervalli manutenzione',
+    // Maintenance log
+    resetDialogTitle: 'Reimpostare «{{task}}»?',
+    resetDialogMessage: 'Segna questa attività come completata su {{printer}} e ne riavvia l\'intervallo. Il ripristino viene aggiunto al registro di manutenzione della stampante.',
+    commentLabel: 'Commento (facoltativo)',
+    commentPlaceholder: 'Cosa è stato fatto, ricambi usati, osservazioni…',
+    log: 'Registro',
+    viewLog: 'Visualizza registro di manutenzione',
+    logTitle: 'Registro di manutenzione: {{printer}}',
+    logEmpty: 'Nessuna manutenzione ancora registrata per questa stampante.',
+    logShowing: '{{shown}} di {{total}} mostrati',
+    loadMore: 'Carica altro',
+    exportCsv: 'Esporta CSV',
+    exportAll: 'Esporta registro',
+    exportAllHint: 'Scarica in CSV il registro di manutenzione di tutte le stampanti visibili, comprese quelle eliminate se sono visibili tutte le stampanti',
+    performedBy: 'da {{user}}',
+    atPrintHours: 'a {{hours}} h di stampa',
+    exportFailed: 'Esportazione non riuscita: {{error}}',
+    logLoadFailed: 'Impossibile caricare il registro di manutenzione: {{error}}',
+    cleanUp: 'Pulisci',
+    cleanUpLog: 'Pulisci registro',
+    cleanUpHint: 'Elimina le voci vecchie del registro di manutenzione di tutte le stampanti visibili',
+    cleanUpTitle: 'Eliminare le voci vecchie del registro?',
+    cleanUpMessage: 'Elimina definitivamente le voci del registro di manutenzione di {{printer}} più vecchie del numero di giorni indicato sotto. Per conservarne una copia, esportare prima il registro.',
+    cleanUpMessageAll: 'Elimina definitivamente le voci del registro di manutenzione più vecchie del numero di giorni indicato sotto, per tutte le stampanti visibili, comprese quelle eliminate se sono visibili tutte le stampanti. Per conservarne una copia, esportare prima il registro.',
+    cleanUpOlderThan: 'Elimina le voci più vecchie di (giorni)',
+    cleanUpDone: 'Voci del registro eliminate: {{deleted}}',
+    deleteEntry: 'Elimina voce',
+    deleteEntryTitle: 'Eliminare questa voce del registro?',
+    deleteEntryMessage: '«{{task}}» del {{date}} viene rimosso definitivamente dal registro di manutenzione. L\'ultimo ripristino dell\'attività resta invariato.',
+    entryDeleted: 'Voce del registro eliminata',
+    deleteFailed: 'Eliminazione non riuscita: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/ja.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: 'メンテナンス間隔を編集する権限がありません',
     // Configure link
     configureSettings: 'メンテナンスタイプと間隔を設定',
+    // Maintenance log
+    resetDialogTitle: '「{{task}}」をリセットしますか?',
+    resetDialogMessage: '{{printer}} でこのタスクを完了済みにし、間隔を再開します。リセットはプリンターのメンテナンスログに記録されます。',
+    commentLabel: 'コメント(任意)',
+    commentPlaceholder: '実施内容、使用部品、気づいた点など…',
+    log: 'ログ',
+    viewLog: 'メンテナンスログを表示',
+    logTitle: 'メンテナンスログ: {{printer}}',
+    logEmpty: 'このプリンターのメンテナンス記録はまだありません。',
+    logShowing: '{{total}} 件中 {{shown}} 件を表示',
+    loadMore: 'さらに読み込む',
+    exportCsv: 'CSV をエクスポート',
+    exportAll: 'ログをエクスポート',
+    exportAllHint: '表示できるすべてのプリンターのメンテナンスログを CSV でダウンロード(すべてのプリンターを表示できる場合は削除済みのプリンターも含む)',
+    performedBy: '実施者: {{user}}',
+    atPrintHours: '印刷時間 {{hours}} h 時点',
+    exportFailed: 'エクスポートに失敗しました: {{error}}',
+    logLoadFailed: 'メンテナンスログを読み込めませんでした: {{error}}',
+    cleanUp: '整理',
+    cleanUpLog: 'ログを整理',
+    cleanUpHint: '表示できるすべてのプリンターの古いメンテナンスログを削除',
+    cleanUpTitle: '古いログを削除しますか?',
+    cleanUpMessage: '{{printer}} のメンテナンスログのうち、下で指定した日数より古いエントリーを完全に削除します。コピーを残すには、先にログをエクスポートしてください。',
+    cleanUpMessageAll: '表示できるすべてのプリンターについて、下で指定した日数より古いメンテナンスログのエントリーを完全に削除します(すべてのプリンターを表示できる場合は削除済みのプリンターも含む)。コピーを残すには、先にログをエクスポートしてください。',
+    cleanUpOlderThan: '次の日数より古いエントリーを削除(日)',
+    cleanUpDone: '削除したログエントリー: {{deleted}}',
+    deleteEntry: 'エントリーを削除',
+    deleteEntryTitle: 'このログエントリーを削除しますか?',
+    deleteEntryMessage: '{{date}} の「{{task}}」をメンテナンスログから完全に削除します。タスクの最終リセットはそのまま残ります。',
+    entryDeleted: 'ログエントリーを削除しました',
+    deleteFailed: '削除に失敗しました: {{error}}',
   },
 
   // Settings page

+ 32 - 1
frontend/src/i18n/locales/ko.ts

@@ -1950,7 +1950,38 @@ export default {
     noPermissionRemovePrinter: '프린터 할당을 제거할 권한이 없습니다',
     noPermissionAssignPrinter: '프린터를 할당할 권한이 없습니다',
     noPermissionEditIntervals: '간격을 편집할 권한이 없습니다',
-    configureSettings: '유지보수 유형 및 간격 설정'
+    configureSettings: '유지보수 유형 및 간격 설정',
+    // Maintenance log
+    resetDialogTitle: '"{{task}}"을(를) 초기화할까요?',
+    resetDialogMessage: '{{printer}}에서 이 작업을 완료로 표시하고 주기를 다시 시작합니다. 초기화는 프린터의 유지보수 로그에 기록됩니다.',
+    commentLabel: '메모 (선택 사항)',
+    commentPlaceholder: '수행한 작업, 사용한 부품, 특이 사항 등…',
+    log: '로그',
+    viewLog: '유지보수 로그 보기',
+    logTitle: '유지보수 로그: {{printer}}',
+    logEmpty: '이 프린터에 기록된 유지보수가 아직 없습니다.',
+    logShowing: '{{total}}개 중 {{shown}}개 표시',
+    loadMore: '더 불러오기',
+    exportCsv: 'CSV 내보내기',
+    exportAll: '로그 내보내기',
+    exportAllHint: '볼 수 있는 모든 프린터의 유지보수 로그를 CSV로 다운로드 (모든 프린터를 볼 수 있으면 삭제된 프린터 포함)',
+    performedBy: '작업자: {{user}}',
+    atPrintHours: '출력 {{hours}}시간 시점',
+    exportFailed: '내보내기 실패: {{error}}',
+    logLoadFailed: '유지보수 로그를 불러오지 못했습니다: {{error}}',
+    cleanUp: '정리',
+    cleanUpLog: '로그 정리',
+    cleanUpHint: '볼 수 있는 모든 프린터의 오래된 유지보수 로그 항목 삭제',
+    cleanUpTitle: '오래된 로그 항목을 삭제할까요?',
+    cleanUpMessage: '{{printer}}의 유지보수 로그에서 아래에 지정한 일수보다 오래된 항목을 영구적으로 삭제합니다. 사본을 남기려면 먼저 로그를 내보내세요.',
+    cleanUpMessageAll: '볼 수 있는 모든 프린터에서 아래에 지정한 일수보다 오래된 유지보수 로그 항목을 영구적으로 삭제합니다 (모든 프린터를 볼 수 있으면 삭제된 프린터 포함). 사본을 남기려면 먼저 로그를 내보내세요.',
+    cleanUpOlderThan: '다음 일수보다 오래된 항목 삭제 (일)',
+    cleanUpDone: '삭제된 로그 항목: {{deleted}}',
+    deleteEntry: '항목 삭제',
+    deleteEntryTitle: '이 로그 항목을 삭제할까요?',
+    deleteEntryMessage: '{{date}}의 "{{task}}" 항목이 유지보수 로그에서 영구적으로 삭제됩니다. 작업의 마지막 초기화는 그대로 유지됩니다.',
+    entryDeleted: '로그 항목이 삭제되었습니다',
+    deleteFailed: '삭제 실패: {{error}}',
   },
   wled: {
     connectionSection: '연결', mappingSection: '상태 매핑', testConnection: '연결 테스트', notTested: '테스트하지 않음', connected: 'WLED에 연결됨{{name}}{{version}}', notReachable: 'WLED에 연결할 수 없습니다.', testPreset: '테스트', presetTested: '프리셋이 활성화되었습니다', presetTestFailed: '프리셋을 활성화할 수 없습니다', mappingSummary: '설정된 상태: {{configured}} · 비활성 상태: {{disabled}}',

+ 31 - 0
frontend/src/i18n/locales/nl.ts

@@ -2054,6 +2054,37 @@ export default {
     noPermissionEditIntervals: 'Je hebt geen toestemming om intervallen te bewerken',
     // Configure link
     configureSettings: 'Onderhoudstypen en intervallen configureren',
+    // Maintenance log
+    resetDialogTitle: '“{{task}}” resetten?',
+    resetDialogMessage: 'Markeert deze taak als uitgevoerd op {{printer}} en start het interval opnieuw. De reset wordt toegevoegd aan het onderhoudslogboek van de printer.',
+    commentLabel: 'Opmerking (optioneel)',
+    commentPlaceholder: 'Wat er is gedaan, gebruikte onderdelen, opvallende zaken…',
+    log: 'Logboek',
+    viewLog: 'Onderhoudslogboek bekijken',
+    logTitle: 'Onderhoudslogboek: {{printer}}',
+    logEmpty: 'Voor deze printer is nog geen onderhoud vastgelegd.',
+    logShowing: '{{shown}} van {{total}} getoond',
+    loadMore: 'Meer laden',
+    exportCsv: 'CSV exporteren',
+    exportAll: 'Logboek exporteren',
+    exportAllHint: 'Het onderhoudslogboek van alle printers die je kunt zien als CSV downloaden, inclusief verwijderde printers als je alle printers kunt zien',
+    performedBy: 'door {{user}}',
+    atPrintHours: 'bij {{hours}} u',
+    exportFailed: 'Exporteren mislukt: {{error}}',
+    logLoadFailed: 'Het onderhoudslogboek kon niet worden geladen: {{error}}',
+    cleanUp: 'Opschonen',
+    cleanUpLog: 'Logboek opschonen',
+    cleanUpHint: 'Oude items uit het onderhoudslogboek van alle printers die je kunt zien verwijderen',
+    cleanUpTitle: 'Oude logboekitems verwijderen?',
+    cleanUpMessage: 'Verwijdert definitief de items in het onderhoudslogboek van {{printer}} die ouder zijn dan het aantal dagen hieronder. Exporteer het logboek eerst als je een kopie wilt bewaren.',
+    cleanUpMessageAll: 'Verwijdert definitief de items in het onderhoudslogboek die ouder zijn dan het aantal dagen hieronder, voor alle printers die je kunt zien, inclusief verwijderde printers als je alle printers kunt zien. Exporteer het logboek eerst als je een kopie wilt bewaren.',
+    cleanUpOlderThan: 'Items verwijderen ouder dan (dagen)',
+    cleanUpDone: 'Verwijderde logboekitems: {{deleted}}',
+    deleteEntry: 'Item verwijderen',
+    deleteEntryTitle: 'Dit logboekitem verwijderen?',
+    deleteEntryMessage: '“{{task}}” van {{date}} wordt definitief uit het onderhoudslogboek verwijderd. De laatste reset van de taak blijft staan.',
+    entryDeleted: 'Logboekitem verwijderd',
+    deleteFailed: 'Verwijderen mislukt: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/pl.ts

@@ -2056,6 +2056,37 @@ export default {
     noPermissionEditIntervals: 'Nie masz uprawnień do edytowania interwałów',
     // Configure link
     configureSettings: 'Skonfiguruj typy i interwały konserwacji',
+    // Maintenance log
+    resetDialogTitle: 'Zresetować „{{task}}”?',
+    resetDialogMessage: 'Oznacza to zadanie jako wykonane na {{printer}} i rozpoczyna jego interwał od nowa. Reset zostanie dodany do dziennika konserwacji drukarki.',
+    commentLabel: 'Komentarz (opcjonalnie)',
+    commentPlaceholder: 'Co zrobiono, użyte części, zauważone problemy…',
+    log: 'Dziennik',
+    viewLog: 'Pokaż dziennik konserwacji',
+    logTitle: 'Dziennik konserwacji: {{printer}}',
+    logEmpty: 'Dla tej drukarki nie zapisano jeszcze żadnej konserwacji.',
+    logShowing: 'Wyświetlono {{shown}} z {{total}}',
+    loadMore: 'Wczytaj więcej',
+    exportCsv: 'Eksportuj CSV',
+    exportAll: 'Eksportuj dziennik',
+    exportAllHint: 'Pobierz jako CSV dziennik konserwacji wszystkich widocznych drukarek, także usuniętych, jeśli widzisz wszystkie drukarki',
+    performedBy: 'wykonał(a): {{user}}',
+    atPrintHours: 'przy {{hours}} h',
+    exportFailed: 'Eksport nie powiódł się: {{error}}',
+    logLoadFailed: 'Nie udało się wczytać dziennika konserwacji: {{error}}',
+    cleanUp: 'Wyczyść',
+    cleanUpLog: 'Wyczyść dziennik',
+    cleanUpHint: 'Usuń stare wpisy dziennika konserwacji wszystkich widocznych drukarek',
+    cleanUpTitle: 'Usunąć stare wpisy dziennika?',
+    cleanUpMessage: 'Trwale usuwa wpisy dziennika konserwacji drukarki {{printer}} starsze niż podana niżej liczba dni. Aby zachować kopię, najpierw wyeksportuj dziennik.',
+    cleanUpMessageAll: 'Trwale usuwa wpisy dziennika konserwacji starsze niż podana niżej liczba dni, dla wszystkich widocznych drukarek, także usuniętych, jeśli widzisz wszystkie drukarki. Aby zachować kopię, najpierw wyeksportuj dziennik.',
+    cleanUpOlderThan: 'Usuń wpisy starsze niż (dni)',
+    cleanUpDone: 'Usunięte wpisy dziennika: {{deleted}}',
+    deleteEntry: 'Usuń wpis',
+    deleteEntryTitle: 'Usunąć ten wpis dziennika?',
+    deleteEntryMessage: '„{{task}}” z {{date}} zostanie trwale usunięty z dziennika konserwacji. Ostatni reset zadania pozostaje bez zmian.',
+    entryDeleted: 'Wpis dziennika usunięty',
+    deleteFailed: 'Usuwanie nie powiodło się: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/pt-BR.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: 'Você não tem permissão para editar intervalos',
     // Configure link
     configureSettings: 'Configure tipos de manutenção e intervalos',
+    // Maintenance log
+    resetDialogTitle: 'Redefinir “{{task}}”?',
+    resetDialogMessage: 'Marca esta tarefa como concluída em {{printer}} e reinicia seu intervalo. A redefinição é adicionada ao registro de manutenção da impressora.',
+    commentLabel: 'Comentário (opcional)',
+    commentPlaceholder: 'O que foi feito, peças usadas, observações…',
+    log: 'Registro',
+    viewLog: 'Ver registro de manutenção',
+    logTitle: 'Registro de manutenção: {{printer}}',
+    logEmpty: 'Nenhuma manutenção foi registrada para esta impressora ainda.',
+    logShowing: 'Mostrando {{shown}} de {{total}}',
+    loadMore: 'Carregar mais',
+    exportCsv: 'Exportar CSV',
+    exportAll: 'Exportar registro',
+    exportAllHint: 'Baixar em CSV o registro de manutenção de todas as impressoras que você pode ver, incluindo as excluídas se você puder ver todas as impressoras',
+    performedBy: 'por {{user}}',
+    atPrintHours: 'com {{hours}} h de impressão',
+    exportFailed: 'Falha na exportação: {{error}}',
+    logLoadFailed: 'Não foi possível carregar o registro de manutenção: {{error}}',
+    cleanUp: 'Limpar',
+    cleanUpLog: 'Limpar registro',
+    cleanUpHint: 'Excluir entradas antigas do registro de manutenção de todas as impressoras que você pode ver',
+    cleanUpTitle: 'Excluir entradas antigas do registro?',
+    cleanUpMessage: 'Exclui permanentemente as entradas do registro de manutenção de {{printer}} mais antigas que o número de dias abaixo. Exporte o registro antes para guardar uma cópia.',
+    cleanUpMessageAll: 'Exclui permanentemente as entradas do registro de manutenção mais antigas que o número de dias abaixo, de todas as impressoras que você pode ver, incluindo as excluídas se você puder ver todas as impressoras. Exporte o registro antes para guardar uma cópia.',
+    cleanUpOlderThan: 'Excluir entradas com mais de (dias)',
+    cleanUpDone: 'Entradas do registro excluídas: {{deleted}}',
+    deleteEntry: 'Excluir entrada',
+    deleteEntryTitle: 'Excluir esta entrada do registro?',
+    deleteEntryMessage: '“{{task}}” de {{date}} será removido permanentemente do registro de manutenção. A última redefinição da tarefa permanece como está.',
+    entryDeleted: 'Entrada do registro excluída',
+    deleteFailed: 'Falha ao excluir: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/ru.ts

@@ -1948,6 +1948,37 @@ export default {
     noPermissionAssignPrinter: "У вас нет разрешения назначать принтеры",
     noPermissionEditIntervals: "У вас нет разрешения изменять интервалы",
     configureSettings: "Настроить виды обслуживания и интервалы",
+    // Maintenance log
+    resetDialogTitle: 'Сбросить «{{task}}»?',
+    resetDialogMessage: 'Отмечает эту задачу как выполненную на {{printer}} и запускает её интервал заново. Сброс добавляется в журнал обслуживания принтера.',
+    commentLabel: 'Комментарий (необязательно)',
+    commentPlaceholder: 'Что сделано, какие детали использованы, замечания…',
+    log: 'Журнал',
+    viewLog: 'Открыть журнал обслуживания',
+    logTitle: 'Журнал обслуживания: {{printer}}',
+    logEmpty: 'Для этого принтера ещё не записано ни одного обслуживания.',
+    logShowing: 'Показано {{shown}} из {{total}}',
+    loadMore: 'Загрузить ещё',
+    exportCsv: 'Экспорт в CSV',
+    exportAll: 'Экспорт журнала',
+    exportAllHint: 'Скачать в формате CSV журнал обслуживания всех доступных вам принтеров, включая удалённые, если вам доступны все принтеры',
+    performedBy: 'выполнил(а): {{user}}',
+    atPrintHours: 'при {{hours}} ч',
+    exportFailed: 'Ошибка экспорта: {{error}}',
+    logLoadFailed: 'Не удалось загрузить журнал обслуживания: {{error}}',
+    cleanUp: 'Очистить',
+    cleanUpLog: 'Очистить журнал',
+    cleanUpHint: 'Удалить старые записи журнала обслуживания всех доступных вам принтеров',
+    cleanUpTitle: 'Удалить старые записи журнала?',
+    cleanUpMessage: 'Безвозвратно удаляет записи журнала обслуживания принтера {{printer}} старше указанного ниже числа дней. Чтобы сохранить копию, сначала экспортируйте журнал.',
+    cleanUpMessageAll: 'Безвозвратно удаляет записи журнала обслуживания старше указанного ниже числа дней для всех доступных вам принтеров, включая удалённые, если вам доступны все принтеры. Чтобы сохранить копию, сначала экспортируйте журнал.',
+    cleanUpOlderThan: 'Удалить записи старше (дней)',
+    cleanUpDone: 'Удалено записей журнала: {{deleted}}',
+    deleteEntry: 'Удалить запись',
+    deleteEntryTitle: 'Удалить эту запись журнала?',
+    deleteEntryMessage: '«{{task}}» от {{date}} будет безвозвратно удалено из журнала обслуживания. Последний сброс задачи останется без изменений.',
+    entryDeleted: 'Запись журнала удалена',
+    deleteFailed: 'Не удалось удалить: {{error}}',
   },
   wled: {
     connectionSection: 'Подключение', mappingSection: 'Сопоставление состояний', testConnection: 'Проверить подключение', notTested: 'Не проверено', connected: 'Подключено к WLED{{name}}{{version}}', notReachable: 'Не удалось подключиться к WLED.', testPreset: 'Тест', presetTested: 'Пресет активирован', presetTestFailed: 'Не удалось активировать пресет', mappingSummary: 'Настроено состояний: {{configured}} · Отключено состояний: {{disabled}}',

+ 31 - 0
frontend/src/i18n/locales/sv.ts

@@ -2053,6 +2053,37 @@ export default {
     noPermissionEditIntervals: 'Du har inte behörighet att redigera intervall',
     // Configure link
     configureSettings: 'Konfigurera underhållstyper och intervall',
+    // Maintenance log
+    resetDialogTitle: 'Återställ ”{{task}}”?',
+    resetDialogMessage: 'Markerar uppgiften som utförd på {{printer}} och startar om dess intervall. Återställningen läggs till i skrivarens underhållslogg.',
+    commentLabel: 'Kommentar (valfritt)',
+    commentPlaceholder: 'Vad som gjordes, delar som användes, iakttagelser…',
+    log: 'Logg',
+    viewLog: 'Visa underhållslogg',
+    logTitle: 'Underhållslogg: {{printer}}',
+    logEmpty: 'Inget underhåll har loggats för den här skrivaren än.',
+    logShowing: 'Visar {{shown}} av {{total}}',
+    loadMore: 'Läs in fler',
+    exportCsv: 'Exportera CSV',
+    exportAll: 'Exportera logg',
+    exportAllHint: 'Ladda ner underhållsloggen för alla skrivare du kan se som CSV, inklusive borttagna skrivare om du kan se alla skrivare',
+    performedBy: 'av {{user}}',
+    atPrintHours: 'vid {{hours}} h',
+    exportFailed: 'Exporten misslyckades: {{error}}',
+    logLoadFailed: 'Underhållsloggen kunde inte läsas in: {{error}}',
+    cleanUp: 'Rensa',
+    cleanUpLog: 'Rensa logg',
+    cleanUpHint: 'Ta bort gamla poster i underhållsloggen för alla skrivare du kan se',
+    cleanUpTitle: 'Ta bort gamla loggposter?',
+    cleanUpMessage: 'Tar permanent bort posterna i underhållsloggen för {{printer}} som är äldre än antalet dagar nedan. Exportera loggen först om du vill behålla en kopia.',
+    cleanUpMessageAll: 'Tar permanent bort posterna i underhållsloggen som är äldre än antalet dagar nedan, för alla skrivare du kan se, inklusive borttagna skrivare om du kan se alla skrivare. Exportera loggen först om du vill behålla en kopia.',
+    cleanUpOlderThan: 'Ta bort poster äldre än (dagar)',
+    cleanUpDone: 'Borttagna loggposter: {{deleted}}',
+    deleteEntry: 'Ta bort post',
+    deleteEntryTitle: 'Ta bort den här loggposten?',
+    deleteEntryMessage: '”{{task}}” från {{date}} tas bort permanent ur underhållsloggen. Uppgiftens senaste återställning ändras inte.',
+    entryDeleted: 'Loggposten har tagits bort',
+    deleteFailed: 'Borttagningen misslyckades: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/tr.ts

@@ -2037,6 +2037,37 @@ export default {
     noPermissionEditIntervals: 'Aralıkları düzenleme izniniz yok',
     // Yapılandırma bağlantısı
     configureSettings: 'Bakım türlerini ve aralıklarını yapılandır',
+    // Maintenance log
+    resetDialogTitle: '“{{task}}” sıfırlansın mı?',
+    resetDialogMessage: 'Bu görevi {{printer}} üzerinde yapıldı olarak işaretler ve aralığını yeniden başlatır. Sıfırlama, yazıcının bakım günlüğüne eklenir.',
+    commentLabel: 'Yorum (isteğe bağlı)',
+    commentPlaceholder: 'Yapılanlar, kullanılan parçalar, fark edilenler…',
+    log: 'Günlük',
+    viewLog: 'Bakım günlüğünü görüntüle',
+    logTitle: 'Bakım günlüğü: {{printer}}',
+    logEmpty: 'Bu yazıcı için henüz bakım kaydedilmedi.',
+    logShowing: '{{total}} kayıttan {{shown}} tanesi gösteriliyor',
+    loadMore: 'Daha fazla yükle',
+    exportCsv: 'CSV dışa aktar',
+    exportAll: 'Günlüğü dışa aktar',
+    exportAllHint: 'Görebildiğiniz tüm yazıcıların bakım günlüğünü CSV olarak indirin; tüm yazıcıları görebiliyorsanız silinen yazıcılar da dahil',
+    performedBy: 'yapan: {{user}}',
+    atPrintHours: '{{hours}} saatte',
+    exportFailed: 'Dışa aktarma başarısız: {{error}}',
+    logLoadFailed: 'Bakım günlüğü yüklenemedi: {{error}}',
+    cleanUp: 'Temizle',
+    cleanUpLog: 'Günlüğü temizle',
+    cleanUpHint: 'Görebildiğiniz tüm yazıcıların bakım günlüğündeki eski kayıtları silin',
+    cleanUpTitle: 'Eski günlük kayıtları silinsin mi?',
+    cleanUpMessage: '{{printer}} bakım günlüğünde aşağıdaki gün sayısından eski kayıtları kalıcı olarak siler. Bir kopyasını saklamak için önce günlüğü dışa aktarın.',
+    cleanUpMessageAll: 'Görebildiğiniz tüm yazıcılar için aşağıdaki gün sayısından eski bakım günlüğü kayıtlarını kalıcı olarak siler; tüm yazıcıları görebiliyorsanız silinen yazıcılar da dahil. Bir kopyasını saklamak için önce günlüğü dışa aktarın.',
+    cleanUpOlderThan: 'Şundan eski kayıtları sil (gün)',
+    cleanUpDone: 'Silinen günlük kayıtları: {{deleted}}',
+    deleteEntry: 'Kaydı sil',
+    deleteEntryTitle: 'Bu günlük kaydı silinsin mi?',
+    deleteEntryMessage: '{{date}} tarihli “{{task}}” bakım günlüğünden kalıcı olarak kaldırılır. Görevin son sıfırlaması olduğu gibi kalır.',
+    entryDeleted: 'Günlük kaydı silindi',
+    deleteFailed: 'Silme başarısız: {{error}}',
   },
 
   // Ayarlar sayfası

+ 31 - 0
frontend/src/i18n/locales/uk.ts

@@ -2052,6 +2052,37 @@ export default {
     noPermissionEditIntervals: "Ви не маєте дозволу редагувати інтервали",
     // Configure link
     configureSettings: "Налаштувати типи та інтервали технічного обслуговування",
+    // Maintenance log
+    resetDialogTitle: 'Скинути «{{task}}»?',
+    resetDialogMessage: 'Позначає це завдання виконаним на {{printer}} і запускає його інтервал заново. Скидання додається до журналу обслуговування принтера.',
+    commentLabel: 'Коментар (необов\'язково)',
+    commentPlaceholder: 'Що зроблено, які деталі використано, зауваження…',
+    log: 'Журнал',
+    viewLog: 'Відкрити журнал обслуговування',
+    logTitle: 'Журнал обслуговування: {{printer}}',
+    logEmpty: 'Для цього принтера ще не записано жодного обслуговування.',
+    logShowing: 'Показано {{shown}} з {{total}}',
+    loadMore: 'Завантажити ще',
+    exportCsv: 'Експорт у CSV',
+    exportAll: 'Експорт журналу',
+    exportAllHint: 'Завантажити у форматі CSV журнал обслуговування всіх доступних вам принтерів, включно з видаленими, якщо вам доступні всі принтери',
+    performedBy: 'виконав(ла): {{user}}',
+    atPrintHours: 'при {{hours}} год',
+    exportFailed: 'Помилка експорту: {{error}}',
+    logLoadFailed: 'Не вдалося завантажити журнал обслуговування: {{error}}',
+    cleanUp: 'Очистити',
+    cleanUpLog: 'Очистити журнал',
+    cleanUpHint: 'Видалити старі записи журналу обслуговування всіх доступних вам принтерів',
+    cleanUpTitle: 'Видалити старі записи журналу?',
+    cleanUpMessage: 'Безповоротно видаляє записи журналу обслуговування принтера {{printer}}, старші за вказану нижче кількість днів. Щоб зберегти копію, спочатку експортуйте журнал.',
+    cleanUpMessageAll: 'Безповоротно видаляє записи журналу обслуговування, старші за вказану нижче кількість днів, для всіх доступних вам принтерів, включно з видаленими, якщо вам доступні всі принтери. Щоб зберегти копію, спочатку експортуйте журнал.',
+    cleanUpOlderThan: 'Видалити записи, старші за (днів)',
+    cleanUpDone: 'Видалено записів журналу: {{deleted}}',
+    deleteEntry: 'Видалити запис',
+    deleteEntryTitle: 'Видалити цей запис журналу?',
+    deleteEntryMessage: '«{{task}}» від {{date}} буде безповоротно видалено з журналу обслуговування. Останнє скидання завдання залишиться без змін.',
+    entryDeleted: 'Запис журналу видалено',
+    deleteFailed: 'Не вдалося видалити: {{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/zh-CN.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: '您没有编辑间隔的权限',
     // Configure link
     configureSettings: '配置维护类型和间隔',
+    // Maintenance log
+    resetDialogTitle: '重置“{{task}}”?',
+    resetDialogMessage: '将此任务在 {{printer}} 上标记为已完成,并重新开始计算间隔。此次重置会记录到打印机的维护日志中。',
+    commentLabel: '备注(可选)',
+    commentPlaceholder: '做了什么、使用的零件、发现的问题……',
+    log: '日志',
+    viewLog: '查看维护日志',
+    logTitle: '维护日志:{{printer}}',
+    logEmpty: '此打印机尚无维护记录。',
+    logShowing: '显示 {{shown}} / {{total}}',
+    loadMore: '加载更多',
+    exportCsv: '导出 CSV',
+    exportAll: '导出日志',
+    exportAllHint: '将你可见的所有打印机的维护日志下载为 CSV(若你可见全部打印机,则包括已删除的打印机)',
+    performedBy: '执行人:{{user}}',
+    atPrintHours: '打印 {{hours}} 小时时',
+    exportFailed: '导出失败:{{error}}',
+    logLoadFailed: '无法加载维护日志:{{error}}',
+    cleanUp: '清理',
+    cleanUpLog: '清理日志',
+    cleanUpHint: '删除你可见的所有打印机的旧维护日志条目',
+    cleanUpTitle: '删除旧日志条目?',
+    cleanUpMessage: '永久删除 {{printer}} 维护日志中早于下方天数的条目。如需保留副本,请先导出日志。',
+    cleanUpMessageAll: '永久删除你可见的所有打印机中早于下方天数的维护日志条目(若你可见全部打印机,则包括已删除的打印机)。如需保留副本,请先导出日志。',
+    cleanUpOlderThan: '删除早于以下天数的条目(天)',
+    cleanUpDone: '已删除的日志条目:{{deleted}}',
+    deleteEntry: '删除条目',
+    deleteEntryTitle: '删除此日志条目?',
+    deleteEntryMessage: '{{date}} 的“{{task}}”将从维护日志中永久删除。该任务的上次重置保持不变。',
+    entryDeleted: '日志条目已删除',
+    deleteFailed: '删除失败:{{error}}',
   },
 
   // Settings page

+ 31 - 0
frontend/src/i18n/locales/zh-TW.ts

@@ -2035,6 +2035,37 @@ export default {
     noPermissionEditIntervals: '您沒有編輯間隔的權限',
     // Configure link
     configureSettings: '設定維護類型和間隔',
+    // Maintenance log
+    resetDialogTitle: '重設「{{task}}」?',
+    resetDialogMessage: '將此任務在 {{printer}} 上標記為已完成,並重新開始計算間隔。此次重設會記錄到印表機的維護日誌中。',
+    commentLabel: '備註(選填)',
+    commentPlaceholder: '做了什麼、使用的零件、發現的問題……',
+    log: '日誌',
+    viewLog: '檢視維護日誌',
+    logTitle: '維護日誌:{{printer}}',
+    logEmpty: '此印表機尚無維護紀錄。',
+    logShowing: '顯示 {{shown}} / {{total}}',
+    loadMore: '載入更多',
+    exportCsv: '匯出 CSV',
+    exportAll: '匯出日誌',
+    exportAllHint: '將你可見的所有印表機的維護日誌下載為 CSV(若你可見全部印表機,則包括已刪除的印表機)',
+    performedBy: '執行者:{{user}}',
+    atPrintHours: '列印 {{hours}} 小時時',
+    exportFailed: '匯出失敗:{{error}}',
+    logLoadFailed: '無法載入維護日誌:{{error}}',
+    cleanUp: '清理',
+    cleanUpLog: '清理日誌',
+    cleanUpHint: '刪除你可見的所有印表機的舊維護日誌項目',
+    cleanUpTitle: '刪除舊日誌項目?',
+    cleanUpMessage: '永久刪除 {{printer}} 維護日誌中早於下方天數的項目。如需保留副本,請先匯出日誌。',
+    cleanUpMessageAll: '永久刪除你可見的所有印表機中早於下方天數的維護日誌項目(若你可見全部印表機,則包括已刪除的印表機)。如需保留副本,請先匯出日誌。',
+    cleanUpOlderThan: '刪除早於以下天數的項目(天)',
+    cleanUpDone: '已刪除的日誌項目:{{deleted}}',
+    deleteEntry: '刪除項目',
+    deleteEntryTitle: '刪除此日誌項目?',
+    deleteEntryMessage: '{{date}} 的「{{task}}」將從維護日誌中永久刪除。該任務的上次重設保持不變。',
+    entryDeleted: '日誌項目已刪除',
+    deleteFailed: '刪除失敗:{{error}}',
   },
 
   // Settings page

+ 163 - 19
frontend/src/pages/MaintenancePage.tsx

@@ -35,14 +35,18 @@ import {
   CircleDot,
   Printer,
   ExternalLink,
+  History,
+  Download,
 } from 'lucide-react';
-import { api } from '../api/client';
+import { api, MAINTENANCE_NOTES_MAX_LENGTH } from '../api/client';
 import type { MaintenanceStatus, PrinterMaintenanceOverview, MaintenanceType, Permission } from '../api/client';
 import { getMaintenanceWikiUrl } from '../utils/maintenanceWikiUrls';
 import { Card, CardContent } from '../components/Card';
 import { Button } from '../components/Button';
 import { Toggle } from '../components/Toggle';
 import { ConfirmModal } from '../components/ConfirmModal';
+import { MaintenanceLogModal } from '../components/MaintenanceLogModal';
+import { MaintenanceLogCleanupModal } from '../components/MaintenanceLogCleanupModal';
 import { useToast } from '../contexts/ToastContext';
 import { useAuth } from '../contexts/AuthContext';
 
@@ -136,7 +140,7 @@ function MaintenanceCard({
   t,
 }: {
   item: MaintenanceStatus;
-  onPerform: (id: number) => void;
+  onPerform: (item: MaintenanceStatus) => void;
   onToggle: (id: number, enabled: boolean) => void;
   hasPermission: (permission: Permission) => boolean;
   t: TFunction;
@@ -271,7 +275,7 @@ function MaintenanceCard({
           <Button
             size="sm"
             variant={item.is_due ? 'primary' : 'secondary'}
-            onClick={() => onPerform(item.id)}
+            onClick={() => onPerform(item)}
             disabled={!item.enabled || !hasPermission('maintenance:update')}
             title={!hasPermission('maintenance:update') ? t('maintenance.noPermissionPerform') : undefined}
             className="!px-3"
@@ -295,13 +299,14 @@ function PrinterSection({
   t,
 }: {
   overview: PrinterMaintenanceOverview;
-  onPerform: (id: number) => void;
+  onPerform: (item: MaintenanceStatus) => void;
   onToggle: (id: number, enabled: boolean) => void;
   onSetHours: (printerId: number, hours: number) => void;
   hasPermission: (permission: Permission) => boolean;
   t: TFunction;
 }) {
   const [expanded, setExpanded] = useState(false);
+  const [showLog, setShowLog] = useState(false);
   const [editingHours, setEditingHours] = useState(false);
   const [hoursInput, setHoursInput] = useState(overview.total_print_hours.toFixed(1));
 
@@ -328,7 +333,7 @@ function PrinterSection({
     <Card className="overflow-hidden">
       {/* Header */}
       <div className="p-5">
-        <div className="flex items-center justify-between">
+        <div className="flex items-center justify-between gap-2 flex-wrap">
           <div className="flex items-center gap-4">
             <h2 className="text-xl font-semibold text-white">{overview.printer_name}</h2>
             <div className="flex items-center gap-2">
@@ -352,13 +357,25 @@ function PrinterSection({
               )}
             </div>
           </div>
-          <button
-            onClick={() => setExpanded(!expanded)}
-            className="flex items-center gap-1.5 px-3 py-1.5 text-sm text-bambu-gray hover:text-white hover:bg-bambu-dark rounded-lg transition-colors"
-          >
-            {expanded ? <ChevronUp className="w-4 h-4" /> : <ChevronDown className="w-4 h-4" />}
-            {expanded ? t('common.collapse') : t('common.expand')}
-          </button>
+          <div className="flex items-center gap-1">
+            {hasPermission('maintenance:read') && (
+              <button
+                onClick={() => setShowLog(true)}
+                className="flex items-center gap-1.5 px-3 py-1.5 text-sm text-bambu-gray hover:text-white hover:bg-bambu-dark rounded-lg transition-colors"
+                title={t('maintenance.viewLog')}
+              >
+                <History className="w-4 h-4" />
+                {t('maintenance.log')}
+              </button>
+            )}
+            <button
+              onClick={() => setExpanded(!expanded)}
+              className="flex items-center gap-1.5 px-3 py-1.5 text-sm text-bambu-gray hover:text-white hover:bg-bambu-dark rounded-lg transition-colors"
+            >
+              {expanded ? <ChevronUp className="w-4 h-4" /> : <ChevronDown className="w-4 h-4" />}
+              {expanded ? t('common.collapse') : t('common.expand')}
+            </button>
+          </div>
         </div>
 
         {/* Quick stats row */}
@@ -450,10 +467,64 @@ function PrinterSection({
           </div>
         </CardContent>
       )}
+
+      {showLog && (
+        <MaintenanceLogModal
+          printerId={overview.printer_id}
+          printerName={overview.printer_name}
+          onClose={() => setShowLog(false)}
+        />
+      )}
     </Card>
   );
 }
 
+// Asks for an optional comment before a reset, which goes into the maintenance log.
+function ResetMaintenanceModal({
+  item,
+  isLoading,
+  onConfirm,
+  onCancel,
+  t,
+}: {
+  item: MaintenanceStatus;
+  isLoading: boolean;
+  onConfirm: (notes: string) => void;
+  onCancel: () => void;
+  t: TFunction;
+}) {
+  const [notes, setNotes] = useState('');
+  return (
+    <ConfirmModal
+      title={t('maintenance.resetDialogTitle', { task: item.maintenance_type_name })}
+      message={t('maintenance.resetDialogMessage', { printer: item.printer_name })}
+      confirmText={t('common.reset')}
+      isLoading={isLoading}
+      // A stray click outside or Escape must not throw a typed comment away.
+      dismissible={notes.trim() === ''}
+      onConfirm={() => onConfirm(notes)}
+      onCancel={onCancel}
+    >
+      <label htmlFor="maintenance-reset-comment" className="block text-sm text-bambu-gray mb-1.5">
+        {t('maintenance.commentLabel')}
+      </label>
+      <textarea
+        id="maintenance-reset-comment"
+        value={notes}
+        onChange={(e) => setNotes(e.target.value)}
+        maxLength={MAINTENANCE_NOTES_MAX_LENGTH}
+        rows={3}
+        placeholder={t('maintenance.commentPlaceholder')}
+        className="w-full px-3 py-2 bg-bambu-dark border border-bambu-dark-tertiary rounded-lg text-white text-sm placeholder-bambu-gray/60 focus:outline-none focus:border-bambu-green resize-y"
+        autoFocus
+      />
+      <div className="text-right text-xs text-bambu-gray mt-1">
+        {notes.length}/{MAINTENANCE_NOTES_MAX_LENGTH}
+      </div>
+    </ConfirmModal>
+  );
+}
+
 // Settings section - maintenance types configuration
 function SettingsSection({
   overview,
@@ -1089,6 +1160,9 @@ export function MaintenancePage() {
   const { showToast } = useToast();
   const { hasPermission } = useAuth();
   const [activeTab, setActiveTab] = useState<TabType>('status');
+  const [resetItem, setResetItem] = useState<MaintenanceStatus | null>(null);
+  const [exportingLog, setExportingLog] = useState(false);
+  const [cleanupLogOpen, setCleanupLogOpen] = useState(false);
 
   const { data: overview, isLoading } = useQuery({
     queryKey: ['maintenanceOverview'],
@@ -1103,9 +1177,11 @@ export function MaintenancePage() {
   const performMutation = useMutation({
     mutationFn: ({ id, notes }: { id: number; notes?: string }) =>
       api.performMaintenance(id, notes),
-    onSuccess: () => {
+    onSuccess: (data) => {
       queryClient.invalidateQueries({ queryKey: ['maintenanceOverview'] });
       queryClient.invalidateQueries({ queryKey: ['maintenanceSummary'] });
+      queryClient.invalidateQueries({ queryKey: ['maintenanceLog', data.printer_id] });
+      setResetItem(null);
       showToast(t('maintenance.maintenanceComplete'));
     },
     onError: (error: Error) => {
@@ -1204,8 +1280,31 @@ export function MaintenancePage() {
     },
   });
 
-  const handlePerform = (id: number) => {
-    performMutation.mutate({ id });
+  const cleanupLogMutation = useMutation({
+    mutationFn: (olderThanDays: number) => api.cleanUpMaintenanceLog(olderThanDays),
+    onSuccess: (result) => {
+      queryClient.invalidateQueries({ queryKey: ['maintenanceLog'] });
+      setCleanupLogOpen(false);
+      showToast(t('maintenance.cleanUpDone', { deleted: result.deleted }));
+    },
+    onError: (error: Error) => {
+      showToast(t('maintenance.deleteFailed', { error: error.message }), 'error');
+    },
+  });
+
+  const handlePerform = (item: MaintenanceStatus) => {
+    setResetItem(item);
+  };
+
+  const handleExportAllLogs = async () => {
+    setExportingLog(true);
+    try {
+      await api.downloadMaintenanceLog();
+    } catch (error) {
+      showToast(t('maintenance.exportFailed', { error: (error as Error).message }), 'error');
+    } finally {
+      setExportingLog(false);
+    }
   };
 
   const handleToggle = (id: number, enabled: boolean) => {
@@ -1231,10 +1330,37 @@ export function MaintenancePage() {
     <div className="p-4 md:p-8">
       {/* Header */}
       <div className="mb-6">
-        <h1 className="text-2xl font-bold text-white flex items-center gap-3">
-          <Wrench className="w-7 h-7 text-bambu-green" />
-          {t('maintenance.title')}
-        </h1>
+        <div className="flex items-center justify-between gap-3 flex-wrap">
+          <h1 className="text-2xl font-bold text-white flex items-center gap-3">
+            <Wrench className="w-7 h-7 text-bambu-green" />
+            {t('maintenance.title')}
+          </h1>
+          {activeTab === 'status' && hasPermission('maintenance:read') && (
+            <div className="flex items-center gap-2 flex-wrap">
+              {hasPermission('maintenance:delete') && (
+                <Button
+                  size="sm"
+                  variant="secondary"
+                  onClick={() => setCleanupLogOpen(true)}
+                  title={t('maintenance.cleanUpHint')}
+                >
+                  <Trash2 className="w-3.5 h-3.5" />
+                  {t('maintenance.cleanUpLog')}
+                </Button>
+              )}
+              <Button
+                size="sm"
+                variant="secondary"
+                onClick={handleExportAllLogs}
+                disabled={exportingLog}
+                title={t('maintenance.exportAllHint')}
+              >
+                {exportingLog ? <Loader2 className="w-3.5 h-3.5 animate-spin" /> : <Download className="w-3.5 h-3.5" />}
+                {t('maintenance.exportAll')}
+              </Button>
+            </div>
+          )}
+        </div>
         <p className="text-bambu-gray mt-1">
           {activeTab === 'status' ? (
             <>
@@ -1332,6 +1458,24 @@ export function MaintenancePage() {
           t={t}
         />
       )}
+
+      {resetItem && (
+        <ResetMaintenanceModal
+          item={resetItem}
+          isLoading={performMutation.isPending}
+          onConfirm={(notes) => performMutation.mutate({ id: resetItem.id, notes: notes.trim() || undefined })}
+          onCancel={() => setResetItem(null)}
+          t={t}
+        />
+      )}
+
+      {cleanupLogOpen && (
+        <MaintenanceLogCleanupModal
+          isLoading={cleanupLogMutation.isPending}
+          onConfirm={(days) => cleanupLogMutation.mutate(days)}
+          onCancel={() => setCleanupLogOpen(false)}
+        />
+      )}
     </div>
   );
 }