Files
ss-tools/specs/014-file-storage-ui/quickstart.md
2026-01-24 16:21:43 +03:00

1.1 KiB

Quickstart: File Storage Management & UI

Usage Guide

  1. Access File Storage: Navigate to the "Tools" > "File Storage" section in the main navigation.
  2. View Files: You will see two tabs: "Backups" and "Repositories". Click on a tab to view files in that category.
  3. Upload File:
    • Click the "Upload" button.
    • Select a file from your computer.
    • Choose the target category (Backup or Repository).
    • Click "Upload" to start the transfer.
  4. Download File: Click the "Download" icon next to any file in the list.
  5. Delete File: Click the "Trash" icon next to any file to delete it permanently.
  6. Configure Storage Path:
    • Go to "Settings".
    • Locate the "File Storage" section.
    • Enter a new absolute path for the storage root.
    • Click "Save". The system will verify write access to the new path.

Development

Backend

  • Plugin: backend/src/plugins/storage.py
  • API Routes: backend/src/api/routes/storage.py
  • Models: backend/src/models/storage.py

Frontend

  • Page: frontend/src/routes/tools/storage/+page.svelte
  • Components: frontend/src/components/storage/*