mirror of
https://github.com/ProtonMail/proton-bridge.git
synced 2025-12-10 20:56:51 +00:00
Import/Export backend prep
This commit is contained in:
135
doc/importexport.md
Normal file
135
doc/importexport.md
Normal file
@ -0,0 +1,135 @@
|
||||
# Import/Export
|
||||
|
||||
## Main blocks
|
||||
|
||||
This is basic overview of the main import/export blocks.
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
S[ProtonMail server]
|
||||
U[User]
|
||||
|
||||
subgraph "Import/Export app"
|
||||
Users
|
||||
Frontend["Qt / CLI"]
|
||||
ImportExport
|
||||
Transfer
|
||||
|
||||
Frontend --> ImportExport
|
||||
Frontend --> Transfer
|
||||
ImportExport --> Users
|
||||
ImportExport --> Transfer
|
||||
end
|
||||
|
||||
EML --> Transfer
|
||||
MBOX --> Transfer
|
||||
IMAP --> Transfer
|
||||
S --> Transfer
|
||||
|
||||
Transfer --> EML
|
||||
Transfer --> MBOX
|
||||
Transfer --> S
|
||||
|
||||
U --> Frontend
|
||||
```
|
||||
|
||||
## Code structure
|
||||
|
||||
More detailed graph of main types used in Import/Export app and connection between them.
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
PM[ProtonMail Server]
|
||||
EML[EML]
|
||||
MBOX[MBOX]
|
||||
IMAP[IMAP]
|
||||
|
||||
subgraph "Import/Export app"
|
||||
subgraph PkgUsers
|
||||
subgraph PkgCredentials
|
||||
CredStore[Store]
|
||||
Creds[Credentials]
|
||||
|
||||
CredStore --> Creds
|
||||
end
|
||||
|
||||
US[Users]
|
||||
U[User]
|
||||
|
||||
US --> U
|
||||
end
|
||||
|
||||
subgraph PkgFrontend
|
||||
CLI
|
||||
Qt
|
||||
end
|
||||
|
||||
subgraph PkgImportExport
|
||||
IE[ImportExport]
|
||||
end
|
||||
|
||||
subgraph PkgTransfer
|
||||
Transfer
|
||||
Rules
|
||||
Progress
|
||||
|
||||
Provider
|
||||
LocalProvider
|
||||
EMLProvider
|
||||
MBOXProvider
|
||||
IMAPProvider
|
||||
PMAPIProvider
|
||||
|
||||
Mailbox
|
||||
Message
|
||||
|
||||
Transfer --> |source|Provider
|
||||
Transfer --> |target|Provider
|
||||
Transfer --> Rules
|
||||
Transfer --> Progress
|
||||
|
||||
Provider --> LocalProvider
|
||||
Provider --> EMLProvider
|
||||
Provider --> MBOXProvider
|
||||
Provider --> IMAPProvider
|
||||
Provider --> PMAPIProvider
|
||||
|
||||
LocalProvider --> EMLProvider
|
||||
LocalProvider --> MBOXProvider
|
||||
|
||||
Provider --> Mailbox
|
||||
Provider --> Message
|
||||
|
||||
end
|
||||
|
||||
subgraph PMAPI
|
||||
APIM[ClientManager]
|
||||
APIC[Client]
|
||||
|
||||
APIM --> APIC
|
||||
end
|
||||
end
|
||||
|
||||
CLI --> IE
|
||||
CLI --> Transfer
|
||||
CLI --> Progress
|
||||
Qt --> IE
|
||||
Qt --> Transfer
|
||||
Qt --> Progress
|
||||
|
||||
U --> CredStore
|
||||
U --> Creds
|
||||
|
||||
US --> APIM
|
||||
U --> APIM
|
||||
|
||||
PMAPIProvider --> APIM
|
||||
EMLProvider --> EML
|
||||
MBOXProvider --> MBOX
|
||||
IMAPProvider --> IMAP
|
||||
|
||||
IE --> US
|
||||
IE --> Transfer
|
||||
|
||||
APIC --> PM
|
||||
```
|
||||
@ -2,8 +2,13 @@
|
||||
|
||||
Documentation pages in order to read for a novice:
|
||||
|
||||
* [Development cycle](development.md)
|
||||
## Bridge
|
||||
|
||||
* [Bridge code](bridge.md)
|
||||
* [Internal Bridge database](database.md)
|
||||
* [Communication between Bridge, Client and Server](communication.md)
|
||||
* [Encryption](encryption.md)
|
||||
|
||||
## Import/Export
|
||||
|
||||
* [Import/Export code](importexport.md)
|
||||
|
||||
Reference in New Issue
Block a user