Signed-off-by: Matt Bruce <mbrucedogs@gmail.com>

This commit is contained in:
Matt Bruce 2026-01-14 17:56:38 -06:00
parent 08aa488eec
commit 9f2fb7ec48

View File

@ -16,63 +16,51 @@ StorageRouter (main entry point)
```
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'fontSize': '16px', 'primaryColor': '#ffffff', 'lineColor': '#000000', 'textColor': '#000000', 'mainBkg': '#ffffff', 'nodeBorder': '#000000' }}}%%
flowchart TD
%% Main Architecture Stack
App(["📱 <b>APP / FEATURE LAYER</b>"])
%% Vertical Flow
App(("📱 <b>APP / FEATURE</b>"))
subgraph Config ["⚙️ GLOBAL CONFIGURATION"]
direction LR
SC["StorageConfig"]
EC["EncryptionConfig"]
FC["FileStorageConfig"]
SYC["SyncConfig"]
end
SR["🔀 <b>STORAGE ROUTER</b><br/>(The Central Engine)"]
SR["🔀 <b>STORAGE ROUTER</b><br/>(Migration & Orchestration Engine)"]
subgraph Config ["⚙️ GLOBAL CONFIGURATION"]
direction TB
C1["Encryption & Sync Config"]
C2["App Group & File Config"]
end
subgraph Helpers ["🛠️ INTERNAL HELPER ACTORS"]
direction TB
subgraph Logic ["Core Logic"]
direction LR
KH["KeychainHelper"]
FH["FileHelper"]
UH["UserDefaultsHelper"]
end
EH["🔐 EncryptionHelper"]
SH["🔄 SyncHelper"]
H1["Keychain & File Storage Helpers"]
H2["UserDefaults & Sync Helpers"]
H3["🔐 Encryption Service"]
end
subgraph Storage ["💾 HARDWARE STORAGE"]
subgraph Storage ["💾 HARDWARE STORAGE LAYER"]
direction LR
KC[("🗝️ Keychain")]
FS[("📁 File System")]
UD[("⚙️ UserDefaults")]
WatchOS["⌚ Apple Watch"]
S1[("🗝️ Keychain")]
S2[("📁 File System")]
S3[("⚙️ UserDefaults")]
end
%% Flow Relationships
%% Relationships
App -->|StorageKey| SR
SR -.->|Resolves| Config
SR ==>|1. Orchestrate| Helpers
Helpers ==>|2. Persist| Storage
SR ==>|1. Routing Logic| Helpers
KH --> KC
FH --> FS
UH --> UD
SH -->|WatchConnectivity| WatchOS
KH --- EH
FH --- EH
%% Migration Loop
Storage -.->|<b>3. AUTOMATIC MIGRATION</b>| SR
%% Migration Logic
Storage -.->|<b>2. AUTOMATIC MIGRATION</b>| SR
%% Styling
style App fill:#fff,stroke:#333,stroke-width:2px
style Config fill:#f9f9f9,stroke:#999,stroke-dasharray: 5 5
style SR fill:#e1f5fe,stroke:#01579b,stroke-width:3px
style Storage fill:#f0f7ff,stroke:#0052cc,stroke-width:2px
style Helpers fill:#fff,stroke:#666
%% Explicit Styling for High Contrast
style App fill:#ffffff,stroke:#000,stroke-width:3px
style SR fill:#e1f5fe,stroke:#000,stroke-width:4px
style Config fill:#fffde7,stroke:#000,stroke-dasharray: 5 5
style Helpers fill:#f5f5f5,stroke:#000,stroke-width:2px
style Storage fill:#e8f5e9,stroke:#000,stroke-width:3px
%% Link Styling
linkStyle default stroke:#000,stroke-width:2px,color:#000
```
## What Ships in the Package