1. 機能概要

CentralOne は完全な 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.
  • エラー処理：
    • 権限なし：許可が拒否されました
    • 名前衝突：名前はすでに存在します。.
    • ファイルが存在しない/アクセス不可：名前の変更に失敗しました: {file_name}
    • 接続問題：Rename failed: {server_name} 

2.4 移動

  • 同一フォルダ内のファイルやサブフォルダを別の場所へ移動可能。
  • 制限事項：
    • 同一ソースフォルダ内のみ選択可能。
    • 目的フォルダはユーザー権限内であること。
    • タブやセッションを跨いだドラッグ＆ドロップは非対応。
  • 操作手順：ファイル/フォルダ選択 → 移動クリック → 目的フォルダ選択
  • 衝突処理：
    • 目的フォルダに同名ファイルがある場合：上書き。
    • 同名フォルダがある場合：移動失敗。
  • ステータス表示：Waiting / Processing / Completed / Fail

2.5 削除

  • 現在のフォルダ内のファイルやサブフォルダを削除可能。
  • 単一・複数選択に対応。
  • 再帰削除：選択フォルダ内のすべてのサブフォルダ・ファイルも削除。
  • ポップアップモーダル：
    • 単一削除または非再帰：表示なし。
    • 複数または再帰削除：確認プロンプトを表示。
  • 成功時：トースト表示なし。
  • エラー処理：
    • 権限なし：許可が拒否されました
    • ファイルが存在しない/名前衝突：削除に失敗しました: {file_name}
    • 接続問題：Delete failed: {server_name} 

3. よくある質問（FAQ）

  1. フォルダで「ダウンロード」ボタンが使えないのはなぜですか？
    • フォルダは「圧縮してダウンロード」を使用してください。単一ファイルは直接ダウンロード可能。
  2. アップロードやダウンロードの進捗バーが失敗した場合は？
    • Retry をクリックして再試行。原因：ネットワーク中断、権限不足、ファイルロックなど。
  3. ダウンロード時にファイル名は自動変更されますか？
    • 重複時は自動で番号付与。ZIP ファイル名にはサーバーアカウントとダウンロード時間が含まれる。
  4. アップロードやダウンロードできないファイルやフォルダは？
    • 特殊圧縮形式や macOS 特殊ファイルは、自動解凍や指定フォルダへの配置ができない場合あり。
  5. 一度にアップロードや移動できるファイル数は？
    • フロントエンドは 4 ファイルまで同時アップロード（非同期）。重複ファイルは先に処理。
  6. フォルダ移動で上書きされますか？
    • ファイル重複は上書き。フォルダ重複は失敗、確認プロンプトが表示。
  7. フォルダ削除をキャンセルできますか？
    • 再帰削除や複数削除は確認後に元に戻せません。単一または非再帰は直接削除可能。
  8. 操作失敗時にログはありますか？
    • Session Log と Access Log にて操作履歴・エラーを追跡可能。
  9. アップロード時に重複ファイルがあった場合は？
    • 単一ファイル：確認モーダル表示（上書き/キャンセル）。
    • 複数ファイル：上書き、スキップ、停止を選択可能。残りファイルに適用可。
  10. 圧縮ダウンロードで対応する形式は？
    • zip、dmg、gz、tgz、rar、7z。特殊形式は追加開発が必要。
  11. ファイル移動で複数フォルダ跨ぎは可能ですか？
    • 非対応。異なるソースフォルダ、タブ、セッションを跨いだ操作はできません。
  12. フォルダ作成で重複名の場合は？
    • 作成失敗。一部プラットフォームはログにエラー記録。
  13. フォルダ削除はサブフォルダ・ファイルも含まれますか？
    • 再帰削除で、選択フォルダ内のすべてのサブフォルダ・ファイルを同時に削除。