1. 機能概要
Mavis は完全な SFTP/FTP ファイル管理機能を提供し、ユーザーがリモートファイルを安全かつ効率的に操作できるようにします。本書は、主要機能、注意点、特殊なシナリオの概要を示します。
1.1 安全性と信頼性：SFTP/FTP プロトコルを使用してファイルを転送、暗号化に対応し、データの安全性を保護。
1.2 クロスプラットフォーム対応：Windows、macOS、Linux および主流の SFTP/FTP サーバーに対応。
1.3 直感的操作：転送進捗バー、状態表示、ログを提供し、操作状況を容易に追跡可能。
1.4 柔軟な管理：単一ファイル、複数ファイル、フォルダの操作をサポート。重複ファイル、名前衝突、特殊ケースを自動処理。
2. 基本機能と操作概念
2.1 アップロードとダウンロード
- 単一ファイルのアップロード：ファイルを選択してアップロード可能。
- 複数ファイルのアップロード：複数のファイルを同時にアップロード可能。
- フォルダアップロード：フォルダ内のすべてのファイルをリスト化してアップロード。
- 重複ファイル処理：
- 単一ファイル：確認モーダル表示、上書きまたはキャンセル選択可能。
- 複数ファイル：上書き、スキップ、停止を選択可能。残りのファイルに適用可。
- システムは自動的に重複ファイルに番号を付与（例：filename(1).txt）。
- ダウンロード：
- 単一ファイル：個別にダウンロード。
- 圧縮ダウンロード：複数ファイルまたはフォルダを選択時、自動的に ZIP ファイル生成。
- ZIP ファイル命名例：SFTP_download_userA_20250821_1030.zip
- 重複ダウンロード時は自動で番号付与：SFTP_download_userA_20250821_1030 (1).zip
- 注意事項：
- 対応形式は一般的なもののみ：zip、dmg、gz、tgz、rar、7z
- 特殊ファイル（例：Postman.app.zip）：macOS では自動解凍や指定フォルダへの配置ができない場合あり。
2.2 フォルダ作成
- 現在閲覧中のリモートディレクトリに単一レベルのフォルダを作成可能。
- 名前付けはバリデーションルールに従う。
- 成功メッセージ：Folder created.
- エラー処理：
- 権限なし：Create directory failed: {server_name}
- 重複名：作成失敗（プラットフォームによってはログに記録）。
2.3 名前変更
- 単一ファイルまたはフォルダの名前変更をサポート。
- 同じディレクトリ内の他アイテムと重複不可、特殊文字不可。
- 成功メッセージ：Rename success.
- エラー処理：
- 権限なし：Permission denied.
- 名前衝突：Name already exists.
- ファイルが存在しない/アクセス不可：Rename failed: {file_name}
- 接続問題：Rename failed: {server_name}
2.4 移動
- 同一フォルダ内のファイルやサブフォルダを別の場所へ移動可能。
- 制限事項：
- 同一ソースフォルダ内のみ選択可能。
- 目的フォルダはユーザー権限内であること。
- タブやセッションを跨いだドラッグ＆ドロップは非対応。
- 操作手順：ファイル/フォルダ選択 → 移動クリック → 目的フォルダ選択
- 衝突処理：
- 目的フォルダに同名ファイルがある場合：上書き。
- 同名フォルダがある場合：移動失敗。
- ステータス表示：Waiting / Processing / Completed / Fail
2.5 削除
- 現在のフォルダ内のファイルやサブフォルダを削除可能。
- 単一・複数選択に対応。
- 再帰削除：選択フォルダ内のすべてのサブフォルダ・ファイルも削除。
- ポップアップモーダル：
- 単一削除または非再帰：表示なし。
- 複数または再帰削除：確認プロンプトを表示。
- 成功時：トースト表示なし。
- エラー処理：
- 権限なし：Permission denied.
- ファイルが存在しない/名前衝突：Delete failed: {file_name}
- 接続問題：Delete failed: {server_name}
3. よくある質問（FAQ）
- フォルダで「ダウンロード」ボタンが使えないのはなぜですか？
- フォルダは「圧縮してダウンロード」を使用してください。単一ファイルは直接ダウンロード可能。
- アップロードやダウンロードの進捗バーが失敗した場合は？
- Retry をクリックして再試行。原因：ネットワーク中断、権限不足、ファイルロックなど。
- ダウンロード時にファイル名は自動変更されますか？
- 重複時は自動で番号付与。ZIP ファイル名にはサーバーアカウントとダウンロード時間が含まれる。
- アップロードやダウンロードできないファイルやフォルダは？
- 特殊圧縮形式や macOS 特殊ファイルは、自動解凍や指定フォルダへの配置ができない場合あり。
- 一度にアップロードや移動できるファイル数は？
- フロントエンドは 4 ファイルまで同時アップロード（非同期）。重複ファイルは先に処理。
- フォルダ移動で上書きされますか？
- ファイル重複は上書き。フォルダ重複は失敗、確認プロンプトが表示。
- フォルダ削除をキャンセルできますか？
- 再帰削除や複数削除は確認後に元に戻せません。単一または非再帰は直接削除可能。
- 操作失敗時にログはありますか？
- Session Log と Access Log にて操作履歴・エラーを追跡可能。
- アップロード時に重複ファイルがあった場合は？
- 単一ファイル：確認モーダル表示（上書き/キャンセル）。
- 複数ファイル：上書き、スキップ、停止を選択可能。残りファイルに適用可。
- 圧縮ダウンロードで対応する形式は？
- zip、dmg、gz、tgz、rar、7z。特殊形式は追加開発が必要。
- ファイル移動で複数フォルダ跨ぎは可能ですか？
- 非対応。異なるソースフォルダ、タブ、セッションを跨いだ操作はできません。
- フォルダ作成で重複名の場合は？
- 作成失敗。一部プラットフォームはログにエラー記録。
- フォルダ削除はサブフォルダ・ファイルも含まれますか？
- 再帰削除で、選択フォルダ内のすべてのサブフォルダ・ファイルを同時に削除。