update docs

2026-05-30 19:33:15 +05:00
parent a5124096d7
commit 86e1e66a20
25 changed files with 1646 additions and 18 deletions
@@ -0,0 +1,59 @@
+# Settings — Storage
+
+Manages locally cached data and profile images.
+
+---
+
+## Fragment — `SettingsStorageFragment`
+
+Displays an overview of locally stored data categories with clear actions for each.
+
+---
+
+## Stored Data Categories
+
+| Category | Location | Description |
+|---|---|---|
+| Profile images | `filesDir/profile_images/` | BML and Fahipay profile photos stored by `ProfileImageStore` |
+| Contact images | `filesDir/profile_images/` | Contact avatar photos |
+| Transaction image cache | In-memory / HTTP cache | Merchant logos loaded in account history |
+| Camera temp file | `cacheDir/profile_photo_tmp.jpg` | Temp file from camera capture; automatically overwritten on next camera use |
+| Transfer receipts | Local database | Completed transfer records shown in Activities |
+
+---
+
+## Clear Actions
+
+### Clear Profile Images
+
+Deletes all files in `filesDir/profile_images/` for BML and Fahipay profiles. MIB profile images are stored server-side and are not affected. After clearing, avatars fall back to the initials placeholder.
+
+### Clear Contact Images
+
+Deletes all contact profile images. Contact records are preserved.
+
+### Clear All Caches
+
+Clears:
+- `cacheDir` contents (including camera temp file and HTTP response cache)
+- In-memory image caches
+
+Does **not** clear credentials, sessions, or transfer records.
+
+### Clear Transfer History
+
+Deletes all locally stored transfer receipt records from the database. This action is irreversible and requires a confirmation dialog.
+
+---
+
+## Storage Usage
+
+The screen may show an approximate size for each category (calculated by summing file sizes in the respective directories).
+
+---
+
+&nbsp;
+
+---
+
+[← Settings — Appearance](16-settings-appearance.md)