Bkash-Nagad-Tracker

Log bKash, Nagad, Rocket, and cash transactions conversationally in Bengali or English. Get weekly spending digests every Sunday. Built for Bangladesh.

bKash / Nagad Transaction Tracker 🇧🇩

Track your daily spending across bKash, Nagad, Rocket, and cash — in Bengali or English — and get an automatic weekly digest every Sunday morning.

---

When to activate this skill

Activate when the user says anything that contains:

Transaction logging signals:

• Any amount in taka, tk, ৳, or BDT
• Words: bKash, Nagad, Rocket, cash, paid, bought, sent, spent, খরচ, পাঠালাম, কিনলাম, দিলাম
• "log", "track", "record" + any amount
• Bengali amounts: "পাঁচশো টাকা", "এক হাজার"

Summary signals:

• "summary", "digest", "report", "weekly"
• "এই সপ্তাহে কত খরচ", "spending this week"
• "show my transactions", "কত টাকা গেলো"

Delete/edit signals:

• "delete last", "undo", "শেষেরটা মুছো"
• "edit transaction", "correct last entry"

---

How to log a transaction

Step 1 — Parse the message

Call the parser to extract structured data:

python3 {baseDir}/parser.py "{user_message}"

This returns JSON:

{
  "amount": 500,
  "method": "bkash",
  "category": "food",
  "note": "lunch",
  "confidence": "high"
}

If amount is null → ask the user: "কত টাকা? / How much?"

If confidence is "low" → confirm before saving: "Did you mean: 500৳ for food via bKash? (yes/no)"

Step 2 — Save the transaction

python3 {baseDir}/logger.py log \
  --amount {amount} \
  --method {method} \
  --category {category} \
  --note "{note}"

Step 3 — Confirm to user

Reply in the same language the user wrote in:

English: "✅ Logged: {amount}৳ — {category} ({method_emoji})"

Bengali: "✅ লগ হয়েছে: {amount}৳ — {category} ({method_emoji})"

Method emojis:

• bKash → 🔴
• Nagad → 🟠
• Rocket → 🟣
• Cash → 💵

---

How to generate a summary

On-demand summary

When user asks for summary/digest:

python3 {baseDir}/summarizer.py weekly

Format the output as a clean digest message and send.

Automatic weekly digest (Heartbeat)

Every Sunday at 9:00 AM local time:

1. Run python3 {baseDir}/summarizer.py weekly
2. Send digest to user automatically
3. No user prompt needed

---

How to delete/undo last transaction

python3 {baseDir}/logger.py undo

Reply: "✅ Last transaction deleted."

---

How to show recent transactions

When user asks "what did I log today" or "recent":

python3 {baseDir}/logger.py recent --n 5

Format as a simple numbered list.

---

Category mapping reference

Use this to classify ambiguous messages:

Keywords	Category
food, lunch, dinner, breakfast, restaurant, খাবার, রেস্তোরাঁ	food
rickshaw, CNG, Uber, bus, train, ভাড়া, যাতায়াত	transport
rent, বাড়িভাড়া	rent
electricity, gas, water, internet, bill, বিল	utilities
mum, dad, family, bhai, apa, মা, বাবা, ভাই, আপা, sent to	remittance
medicine, doctor, hospital, ডাক্তার	medical
school, tuition, books, পড়াশোনা	education
clothes, shoes, shopping, কেনাকাটা	shopping
everything else	other

---

Example conversations

English input:

User:  "bkash 450 lunch"
Agent: ✅ Logged: 450৳ — Food 🔴

User:  "sent 5000 to mum nagad"
Agent: ✅ Logged: 5000৳ — Remittance 🟠

User:  "show my spending this week"
Agent: [weekly digest]

Bengali input:

User:  "৳৮৫০ বিকাশে বাজার করলাম"
Agent: ✅ লগ হয়েছে: 850৳ — Shopping 🔴

User:  "রিকশায় ৮০ টাকা নগদ"
Agent: ✅ লগ হয়েছে: 80৳ — Transport 💵

User:  "এই সপ্তাহে কত খরচ হলো"
Agent: [সাপ্তাহিক সারসংক্ষেপ]

Mixed input:

User:  "electricity bill 1200 bkash dilam"
Agent: ✅ Logged: 1200৳ — Utilities 🔴

---

Error handling

• Python not found: Tell user to install Python 3.10+
• Parse fails: Ask user to rephrase: "Could you say that again with the amount? e.g. '500 taka food bKash'"
• Storage error: Log error, tell user to try again
• No transactions this week: Reply "No transactions logged yet this week. Start by sending me your first expense!"