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:

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!"