Your computer, connected.
Cliente responsável por conectar seu computador ao ecossistema DirectFile e sincronizar arquivos automaticamente.
YOUR COMPUTER. YOUR FILES. ANYWHERE.
Made by Diogo Teodoro Dias Lamas
|
O DirectFile.Client é o aplicativo responsável por rodar no computador do usuário. Ele se conecta ao DirectFile.Server, autentica o usuário e mantém uma conexão em tempo real utilizando SignalR. Sempre que um arquivo é enviado para a conta do usuário, o cliente conectado pode recebê-lo automaticamente. |
🌐 INTERNET
│
▼
┌─────────────────────────┐
│ │
│ DIRECTFILE.SERVER │
│ │
└────────────┬────────────┘
│
│
SIGNALR
│
▼
┌─────────────────────────┐
│ │
│ DIRECTFILE.CLIENT │
│ │
│ YOUR COMPUTER │
│ │
└────────────┬────────────┘
│
▼
📁 D:\DirectFile
O fluxo de funcionamento do cliente acontece automaticamente.
|
CLIENT STARTS |
O DirectFile.Client é iniciado no computador do usuário. Ele carrega as configurações presentes no arquivo:
|
|
LOGIN |
O cliente envia as credenciais para o servidor:
O servidor retorna um token JWT utilizado nas próximas requisições. |
|
SYNC FILES |
Antes de conectar ao sistema em tempo real, o cliente verifica se existem arquivos pendentes no servidor. Arquivos ainda não sincronizados são baixados automaticamente. |
|
CONNECT SIGNALR |
O cliente estabelece uma conexão persistente com:
O nome do computador também é enviado durante a conexão. |
|
WAIT FOR FILES |
Depois de conectado, o cliente permanece aguardando novos arquivos. Quando o servidor envia um evento |
|
O cliente utiliza as credenciais configuradas em:
Após o login, recebe um token JWT utilizado para acessar a API e o SignalR Hub. |
O cliente mantém uma conexão utilizando SignalR. Server │ ▼ SignalR │ ▼ Client │ ▼ Download |
|
Quando o cliente inicia, ele consulta os arquivos disponíveis no servidor. Arquivos que ainda não foram sincronizados são baixados automaticamente. |
Os arquivos são baixados para a pasta configurada pelo usuário. Exemplo: D:\DirectFile |
|
Caso um arquivo com o mesmo nome já exista, o DirectFile evita sobrescrever o arquivo. arquivo.pdf arquivo (1).pdf arquivo (2).pdf |
Caso a conexão seja perdida, o cliente tenta se conectar novamente. Após reconectar, ele executa uma nova sincronização para buscar possíveis arquivos pendentes. |
┌──────────────────────────────────────────────┐ │ │ │ DIRECTFILE.CLIENT │ │ │ ├──────────────────────────────────────────────┤ │ │ │ Program.cs │ │ │ ├──────────────────────────────────────────────┤ │ │ │ LoginAsync() │ │ │ │ POST /api/auth/login │ │ │ ├──────────────────────────────────────────────┤ │ │ │ SyncMissingFilesAsync() │ │ │ │ GET /api/files │ │ │ ├──────────────────────────────────────────────┤ │ │ │ SignalR Connection │ │ │ │ /hubs/sync │ │ │ ├──────────────────────────────────────────────┤ │ │ │ FileReceived Event │ │ │ │ DownloadFileAsync() │ │ │ ├──────────────────────────────────────────────┤ │ │ │ Local Storage │ │ │ │ synced-files.json │ │ │ └──────────────────────────────────────────────┘
DirectFile.Client
│
├── Program.cs
│
├── ClientConfig.cs
│
├── client-config.json
│
├── synced-files.json
│
└── DirectFile.Client.csproj
O cliente utiliza um arquivo chamado: client-config.json
Exemplo:
{
"ServerUrl": "https://localhost:7078",
"Email": "seu@email.com",
"Password": "sua-senha",
"DownloadFolder": "D:\\DirectFile"
}| ServerUrl |
Define o endereço do DirectFile.Server. Exemplo local: https://localhost:7078Exemplo em produção: https://seu-servidor.com |
| E-mail utilizado para autenticação no servidor. | |
| Password | Senha utilizada para autenticação. |
| DownloadFolder |
Define a pasta onde os arquivos recebidos serão salvos.D:\DirectFile |
1. Clone o repositório
git clone https://github.com/TheTekig/DirectFile.Client.git2. Entre na pasta
cd DirectFile.Client3. Restaure as dependências
dotnet restore4. Configure o cliente
Edite o arquivo client-config.json para configurar o endereço do servidor, e-mail, senha e pasta de download.
5. Execute
dotnet runResultado esperado:
=== Direct File - Cliente ===
Login ok.
Pasta de destino:
D:\DirectFile
[i] Sincronizando arquivos pendentes...
Conectado!
Esperando arquivos...
O DirectFile.Client mantém um arquivo local chamado synced-files.json.
Esse arquivo armazena os IDs dos arquivos que já foram sincronizados naquele computador.
Exemplo:
[
1,
2,
5,
8
]Exemplo de sincronização
| Servidor | Cliente | Pendentes |
|---|---|---|
|
1 2 3 4 5 |
1 2 5 |
3 4 |
Quando o cliente inicia, ele compara os arquivos disponíveis no servidor com os IDs presentes em synced-files.json.
Os arquivos pendentes são baixados automaticamente.
O cliente se conecta ao Hub: /hubs/sync
Durante a conexão são enviados:
JWT Token + Device Name
Exemplo conceitual:
/hubs/sync?deviceName=DESKTOP-DIOGO&access_token=JWT_TOKEN
Isso permite que o servidor identifique:
- O usuário conectado
- O computador conectado
- O momento da conexão
O cliente utiliza o método .WithAutomaticReconnect().
Caso a conexão seja perdida:
┌──────────────────────┐
│ │
│ CONNECTION LOST │
│ │
└───────────┬──────────┘
│
▼
┌──────────────────────┐
│ │
│ RECONNECTING... │
│ │
└───────────┬──────────┘
│
▼
┌──────────────────────┐
│ │
│ CONNECTED AGAIN │
│ │
└───────────┬──────────┘
│
▼
┌──────────────────────┐
│ │
│ SYNC MISSING FILES │
│ │
└──────────────────────┘
Isso garante que, caso arquivos sejam enviados enquanto o computador estiver desconectado, eles possam ser sincronizados quando o cliente voltar a ficar online.
|
|
|
Responsável pelo núcleo do ecossistema DirectFile. Principais responsabilidades:
|
