https://github.com/hu553in/cash-bot

Very simple Node.js Telegram bot to track cash incomes and outcomes
https://github.com/hu553in/cash-bot

javascript money-tracking nodejs telegram telegram-bot

Last synced: 5 months ago
JSON representation

Very simple Node.js Telegram bot to track cash incomes and outcomes

• Host: GitHub
• URL: https://github.com/hu553in/cash-bot
• Owner: hu553in
• Created: 2025-01-22T15:58:22.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-01-10T22:29:02.000Z (6 months ago)
• Last Synced: 2026-01-11T05:10:58.958Z (6 months ago)
• Topics: javascript, money-tracking, nodejs, telegram, telegram-bot
• Language: JavaScript
• Homepage: https://t.me/hu553in_cash_bot
• Size: 165 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# Cash bot

[![CI](https://github.com/hu553in/cash-bot/actions/workflows/ci.yml/badge.svg)](https://github.com/hu553in/cash-bot/actions/workflows/ci.yml)

A minimal Node.js Telegram bot for tracking personal cash balance.

The bot keeps a simple running total per Telegram user and is designed to be lightweight, fast,

and easy to reason about.

## Features

- Each Telegram user has an independent balance starting from `0`.

- Sending `+50000` increases the current balance by `50000`.

- Sending `-40000` decreases the current balance by `40000`.

- Only two values are stored per user in SQLite:

  - the current balance

  - the previous balance

- **Undo** button restores the previous balance (single-step undo).

- **Show sum** button displays the current balance.

- **Reset to 0** button resets the balance back to zero.

## Notes

- No transaction history is stored — only the current and previous values.

- Designed for personal use and simplicity rather than accounting precision.

- Stateless interaction model with minimal persistence.