gabanich / locash

Finance accounting Telegram Bot

locash

@locash_bot

Locash is free and open-source Telegram bot that solve one problem - keeps track of your money ;)

Motivation

There a lot of apps that do the same. They might be paid, contains ads, they store your data and doesn't allow you to download it until you paid. The project exist in order to provide freely ability to track expensives and incomes.

Features

• track your income/spents
• daily/weekly/monthly/yearly/all/past_seven_days statistics

Examples

How Locash works

Architecture in future 😏

Instalation

1. nvm use
2. npm install
3. create telegram bot in @BotFather and set WebHook
4. Copy message-handler/credentials.example.json into message-handler/credentials.json
5. Run docker run -d -p 8000:8000 amazon/dynamodb-local
6. Run aws dynamodb create-table --cli-input-json file://transactions.json --endpoint-url http://<local-dynamodb>:8000

Example

Run project

./start.bash $(date +%s) [chat_id] [count]

1. sam build
2. sam local start-api --env-vars env.json
3. curl -X POST -H "Content-Type: application/json" -d '{"message":{"chat": {"id": 31}, "text": "-20 coffee", "date": 1601022097 }}' http://127.0.0.1:3000/message/\?token\=<token>

Or

1. sam build
2. sam local invoke -e events/message2.json MessageHandlerFunction --env-vars env.json

Echo current date

echo $(date +%s)

Generate transactions

node generate-transactions/index.js $(date +%s) [chat_id] [count] > data.json

Import transactions

aws dynamodb batch-write-item --request-items file://import-transactions.json --endpoint-url http://127.17.0.2:8000

locash's Issues

Add charts for week, past seven day

{
   "type":"bar",
   "data":{
      "labels":["Jan 2020", "Nov 2020"],
      "datasets":[
         {
            "label":"Transactions",
            "data":[
               {
                  "x":"2020-5-25",
                  "y":20
               },
               {
                  "x":"2020-2-26",
                  "y":-10
               }
            ]
         }
      ]
   },
   "options":{
      "scales":{
         "xAxes":[
            {
               "type":"time",
               "time":{
                  "unit":"month"
               }
            }
         ]
      }
   }
}