MyVault

✕

MyVault – User Guide

အောက်ကအတိုင်း MyVault app ကို သင့်ကိုယ်ပိုင် ကာကွယ်ထားတဲ့ vault လို အသုံးပြုနိုင်ပါတယ်။

1. ပထမဆုံး အသုံးပြုတဲ့အခါ

1. Sign in with Google – ခလုတ်ကိုနှိပ်ပြီး Google popup ထဲမှာ Drive access ကို Allow လုပ်ပါ။
2. Vault Password သတ်မှတ်ရန် – Vault password ကို ထည့်ထားရပါမယ်။ ဒီ password သာလျှင် ဖိုင်တွေကို decrypt လုပ်ဖို့လိုပါတယ်။ မေ့သွားရင် ဖိုင်ဟောင်းတွေကို ဖြေဖို့မရတော့ပါ။

2. Encrypt & Upload လုပ်နည်း

1. Form ဖြည့်ရန် – Title, Category, Date, Album (Photos အတွက်), Tags ကိုလိုသလိုဖြည့်နိုင်ပါတယ်။
2. Choose Files – PDF, Image, DOCX စတဲ့ ဖိုင်တွေကို တစ်ခါတည်း အများကြီးရွေးနိုင်ပါတယ်။
3. Encrypt & Upload – ခလုတ်ကိုနှိပ်လိုက်ရင်:
   • Browser ထဲမှာ AES-GCM နဲ့ encrypt လုပ်မယ်
   • Encrypted blob ကို Google Drive MyVault folder ထဲ upload လုပ်မယ်
   • vault_meta.json ထဲမှာ metadata (id / title / category / tags / iv / salt …) သိမ်းမယ်

3. Files ကို ပြန်ရှာပြီး ကြည့်နည်း

• Dashboard – Category card တွေ (Tax, IDs, Business…) သတ်မှတ်ထားတဲ့ count ကိုမြင်ရမယ်။
• Search & Filter – လူကြိုက်အဖြာ title / tag / category နဲ့ filter လုပ်နိုင်ပါတယ်။
• Preview – Row မှာ Preview ကိုနှိပ်ရင် Vault password နဲ့ decrypt လုပ်ပြီး PDF / Image ကို app အတွင်း မှန်ကန်တဲ့ viewer နဲ့ ပြပေးမယ်။
• Download – Download ကိုနှိပ်ရင် decrypt လုပ်ပြီး original file type နဲ့ ချက်ချင်း download လုပ်ပေးမယ်။

4. Photos & Albums

• Category ကို Photos လို့ရွေးထားတဲ့ ဖိုင်တွေမှာ Album field ကို သတ်မှတ်နိုင်ပါတယ်။
• Photos tab / Category modal ထဲက album အလိုက် gallery (grid) နဲ့လည်း ပြပေးနိုင်ပါတယ် (upgrade မိတယ်ဆိုရင်).

5. Vault Password ပြန်ပြောင်းချင်ရင်

• Settings ထဲက Change Vault Password UI မှာ Old + New password ထည့်ပြီး confirm လုပ်ပါ။
• App က metadata entry တစ်ခုချင်းစီအတွက်
  1. Old password နဲ့ decrypt
  2. New password နဲ့ re-encrypt
  3. Drive ထဲရှိ encrypted file content ကို media upload နဲ့ PATCH လုပ်မယ်
  4. iv / salt ကို metadata ထဲ update & save လုပ်မယ်

---

Developer Notes (Admin အတွက်)

Architecture

• Frontend only – HTML + CSS + vanilla JS သာသုံး, backend server မလို
• Auth – Google Identity Services (GIS) နဲ့ OAuth2 access token ရယူ
• Storage – Google Drive API v3 တြင်
  • Encrypted file data (.enc) → MyVault folder
  • vault_meta.json → metadata array
  • localStorage["myvault_meta_cache"] → UI cache (refresh-safe)

Metadata Structure

{
              id: "drive-file-id",
              title: "2024 Tax Return",
              category: "tax",
              tags: ["tax", "2024", "irs"],
              album: "2024",
              date: "2024-04-15",
              originalName: "2024_tax_return.pdf",
              size: 123456,
              mimeType: "application/pdf",
              iv: "base64-iv",
              salt: "base64-salt",
              createdAt: "2024-04-16T12:34:56.789Z",
              logs: [
                { type: "upload", ts: "2024-04-16T12:34:56.789Z" },
                { type: "rekey",  ts: "2025-01-01T09:00:00.000Z" }
              ]
            }

Category အသစ်ထည့်နည်း (short)

1. app.js / CATEGORY_CONFIG ထဲက object ထဲကို key အသစ်ထည့်ပါ (ဥပမာ medical):

const CATEGORY_CONFIG = {
                tax:     { label: "Tax Returns",     icon: "📄", color: "#38bdf8" },
                ...
                medical: { label: "Medical Records", icon: "🩺", color: "#10b981" },
                other:   { label: "Other",           icon: "📁", color: "#9ca3af" },
              };

2. index.html ထဲက <select id="file-category">, filter-category, edit-category တွင် <option value="medical">Medical Records</option> ထပ်ထည့်ပါ။
3. Upload handler ထဲမှာ category = getCategoryConf(category).key; နဲ့ normalize လုပ်ထားသလောက်၊ unknown values들은 other ကို default သတ်မယ်။

✕

Vault Data Tools (Admin)

Export your vault metadata as JSON (backup) or import it on another device.

✕

Developer Panel (Admin Only)

ဒီခန်းက ကိုယ်တိုင်သုံးဖို့အတော်ပဲနော် – metadata / cache / debug ကိုစစ်ကြည့်ဖို့အတွက်။

metadata[] (live in memory)

localStorage["myvault_meta_cache"]

✕

Settings

Change Vault Password

Old password နဲ့ decrypt → New password နဲ့ re-encrypt → Drive ထဲကို update ပြန်တင်သွားမယ်။

Change Password