# pitarchalexandre/syncroid_sftp architecture

> Architecture diagram of the GitHub repository pitarchalexandre/syncroid_sftp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pitarchalexandre/syncroid_sftp
- Repository: https://github.com/pitarchalexandre/syncroid_sftp

## Overview

Syncroid SFTP is an Android app for saving SFTP server configurations, testing connections, and uploading user-selected files. The main workflow starts in MainActivity: users manage server entries, passwords are encrypted for storage and decrypted for connection or upload, and the activity dispatches SFTP operations. Server records flow through the ViewModel and repository into Room. The README also describes fingerprint authentication and scheduled sync as future work, so they are not represented as implemented components. Some MainActivity setup and upload details are omitted from the excerpt; uncertain links are left dashed.

Main entry points: [`app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt) (Main activity), [`app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt`](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt) (Server ViewModel), [`app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt`](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt) (Server DAO), [`app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt`](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt) (SFTP service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_main_activity["Main activity<br/>[MainActivity.kt]"]
  node_server_adapter["Server list"]
end

subgraph group_server_management["Server management"]
  node_view_model["Server ViewModel"]
  node_viewmodel_factory["ViewModel factory"]
  node_repository["Server repository"]
  node_server_record["Server record<br/>[ServerStorage.kt]"]
  node_server_dao["Server DAO"]
  node_room_database[("Room database<br/>[Database.kt]")]
end

subgraph group_security["Credential security"]
  node_crypto["Password crypto<br/>[CryptoService.kt]"]
  node_android_keystore[("Android Keystore")]
end

subgraph group_sftp_operations["SFTP operations"]
  node_sftp_service["SFTP service"]
  node_sftp_server(("SFTP server"))
  node_file_picker(("File picker"))
end

node_user(("User"))

node_user -->|"manages servers"| node_main_activity
node_main_activity -->|"configures list"| node_server_adapter
node_server_adapter -->|"dispatches actions"| node_main_activity
node_main_activity -.->|"creates ViewModel"| node_viewmodel_factory
node_viewmodel_factory -->|"constructs"| node_view_model
node_main_activity -->|"manages records"| node_view_model
node_view_model -->|"delegates CRUD"| node_repository
node_repository -->|"calls queries"| node_server_dao
node_server_dao -->|"queries records"| node_server_record
node_room_database -->|"provides DAO"| node_server_dao
node_room_database -->|"stores entity"| node_server_record
node_main_activity -->|"encrypts passwords"| node_crypto
node_crypto -->|"uses key"| node_android_keystore
node_main_activity -->|"tests connection"| node_sftp_service
node_main_activity -.->|"dispatches uploads"| node_sftp_service
node_sftp_service -->|"connects and uploads"| node_sftp_server
node_user -->|"selects files"| node_file_picker
node_file_picker -->|"returns URIs"| node_main_activity

click node_main_activity "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt"
click node_server_adapter "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/ui/adapter/ServerStorageAdapter.kt"
click node_view_model "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt"
click node_viewmodel_factory "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModelFactory.kt"
click node_repository "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/repository/ServerStorageRepository.kt"
click node_server_record "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorage.kt"
click node_server_dao "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt"
click node_room_database "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/db/Database.kt"
click node_crypto "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/service/CryptoService.kt"
click node_sftp_service "https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main_activity,node_server_adapter,node_user toneBlue
class node_view_model,node_viewmodel_factory,node_repository,node_server_record,node_server_dao,node_room_database toneAmber
class node_crypto,node_android_keystore toneMint
class node_sftp_service,node_sftp_server,node_file_picker toneRose
```

## Components

### Presentation

- [Main activity](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt): `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`
- [Server list](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/ui/adapter/ServerStorageAdapter.kt): `app/src/main/java/com/sync/syncroid_sftp/ui/adapter/ServerStorageAdapter.kt`

### Server management

- [Server ViewModel](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt): `app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt`
- [ViewModel factory](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModelFactory.kt): `app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModelFactory.kt`
- [Server repository](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/repository/ServerStorageRepository.kt): `app/src/main/java/com/sync/syncroid_sftp/repository/ServerStorageRepository.kt`
- [Server record](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorage.kt): `app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorage.kt`
- [Server DAO](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt): `app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt`
- [Room database](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/db/Database.kt): `app/src/main/java/com/sync/syncroid_sftp/db/Database.kt`

### Credential security

- [Password crypto](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/service/CryptoService.kt): `app/src/main/java/com/sync/syncroid_sftp/service/CryptoService.kt`
- **Android Keystore**

### SFTP operations

- [SFTP service](https://github.com/pitarchalexandre/syncroid_sftp/blob/main/app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt): `app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt`
- **SFTP server**
- **File picker**

### Other components

- **User**

## Connections

- User → Main activity: manages servers (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- Main activity → Server list: configures list (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- Server list → Main activity: dispatches actions (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/adapter/ServerStorageAdapter.kt`)
- Main activity → ViewModel factory: creates ViewModel (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- ViewModel factory → Server ViewModel: constructs (evidence: `app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModelFactory.kt`)
- Main activity → Server ViewModel: manages records (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- Server ViewModel → Server repository: delegates CRUD (evidence: `app/src/main/java/com/sync/syncroid_sftp/viewmodel/serverstorage/ServerStorageViewModel.kt`)
- Server repository → Server DAO: calls queries (evidence: `app/src/main/java/com/sync/syncroid_sftp/repository/ServerStorageRepository.kt`)
- Server DAO → Server record: queries records (evidence: `app/src/main/java/com/sync/syncroid_sftp/data/serverstorage/ServerStorageDao.kt`)
- Room database → Server DAO: provides DAO (evidence: `app/src/main/java/com/sync/syncroid_sftp/db/Database.kt`)
- Room database → Server record: stores entity (evidence: `app/src/main/java/com/sync/syncroid_sftp/db/Database.kt`)
- Main activity → Password crypto: encrypts passwords (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- Password crypto → Android Keystore: uses key (evidence: `app/src/main/java/com/sync/syncroid_sftp/service/CryptoService.kt`)
- Main activity → SFTP service: tests connection (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- Main activity → SFTP service: dispatches uploads (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
- SFTP service → SFTP server: connects and uploads (evidence: `app/src/main/java/com/sync/syncroid_sftp/service/ServerStorageService.kt`)
- User → File picker: selects files
- File picker → Main activity: returns URIs (evidence: `app/src/main/java/com/sync/syncroid_sftp/ui/MainActivity.kt`)
