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。特殊形式は追加開発が必要。
- ファイル移動で複数フォルダ跨ぎは可能ですか?
- 非対応。異なるソースフォルダ、タブ、セッションを跨いだ操作はできません。
- フォルダ作成で重複名の場合は?
- 作成失敗。一部プラットフォームはログにエラー記録。
- フォルダ削除はサブフォルダ・ファイルも含まれますか?
- 再帰削除で、選択フォルダ内のすべてのサブフォルダ・ファイルを同時に削除。