keremkoseoglu / kifu

Time tracker

Kifu

Kifu is my home-made personal time tracking & invoicing application; written in Python.

It is highly custom-tailored, so you may not find all the features useful. However; if you are a freelancer issuing time based invoices, you can still benefit from this app. Or; if you are a Python developer, you may fork this application and change according to your own needs. Better than starting from the scratch.

Preparation

You will find a sample dataset under the folder sample_data.

• Copy those files somewhere safe
• Change constants.json so that DATA_DIR_PATH contains your data path
• Ensure that /config.json points to constants.json
• Change .json files according to your own company structure

Execution

Simply start main.py in your Python environment.

To start the app in test mode, you can add the arg -test . When you do that, the application will backup all your data files and start running using this backup as the database.

Trivia

Kifu is the scoreboard of the ancient game Go. As a freelancer, I found it appropriate to name my time tracker after that. After all, I'm keeping "score" with this app, right?

kifu's Issues

file - exit doesnt work

date_time.py: 4 6 9 11 is repeated in many places

Many classes may use getter / setters instead of methods

activity window close

after saving an activity, the window doesn't close.

Completed payment double click

On the notification window, I can't double click completed payments.

auto stock value update

• finish #80
• find source
• implement
• run on startup (like currency)

recurrence select error

Excerpt from the terminal:

DrKKs-MacBook-Pro:~ kerem$ /Users/kerem/Dropbox/Software/Kerem/Development/Kifu/venv2/bin/python3 /Users/kerem/Dropbox/Software/Kerem/Development/Kifu/main.py
Exception in Tkinter callback
Traceback (most recent call last):
File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/tkinter/init.py", line 1705, in call
return self.func(*args)
TypeError: _recurrence_select() takes 1 positional argument but 2 were given

ECZ_DAHA_USER and PASS may be read from Kutapada

work days missing activity

• report: work days missing activity (prev month, this month)
• make this report part of month end closing

Cache old exchange rate

currency_update.py
get_old_currencies
cache & read from cache

default currency accounts

gold = GB

notification double click doesnt work

change excel name format

current: 2020 7 1e1.xlsx
wanted: 2020.07 1e1.xlsx

1E1 can be replaced as ACTIVITY_COMPANY

Pay credit cards before investment

yatırım yapacağın zaman önce kart borçlarını öde (vergiden tasarruf ettiysen de öyle)

Test - live data split

The app needs the ability to run in test or live mode.

• Add startup parameter for test mode
• On test mode, app should copy data files somewhere safe and change CONSTANTS accordingly
• Make obvious that the user is in test mode
• Debug profile should start with test data
• Live execution should start with live data
• Add distinction & configuration to readme.md

tk gui components should be a separate project and shared with other projects

Run project wide pylint

hosts.py: file path is hard coded, can be pulled from constants

notification.py: Icons may be enums

reconciliation report fail on multiple incoming payments

bank and credit card files may be merged

• bank
  -- accounts
  -- credit cards

HTML reports may include javascript charts

auto print invoice mails

constants.py needs to be converted to a config file

auto currency update

• make option in config (test mode, live mode separate)
• test mode -> update currency on startup if requested
• live mode -> (same)
• default: disabled on tests, enabled on live

update currency on startup means: the first execution of the day. therefore, we need to understand somewhere (backups? new file?) when the program was last executed.

auto mail activity XLS

When an activity XLS is generated, an E-Mail window can be opened automatically.

• JSON field: Billing contacts
• When an activity Excel is generated, E-Mail windows to corresponding billing contacts should be opened (if present)

auto-close app after inactivity

report: asset evaluation

Data:

• new asset field: purchase date

Report:

• get usd currency at asset date
• calculate usd price
• List: asset, purchase price, purchase USD, todays price, resale
• list non-home currency assets directly

Notion:

• year end closing step: re-evaluate assets

implement dark mode

in the payment detail window, reconciliaton or balance report button(s) would be nice.

many payment constants may be turned into enums

Income tax investment

rent: open amount appears as zero

open invoice folder automatically

while creating an invoice, the invoice attachment directory can be opened automatically.

book cash movement with iphone didnt work

applescript check period can be increased

investment decision shouldnt pay credit cards first

otherwise, i'll never be able to invest.
this payment decision may be an option somewhere (constants?)
but currently, it should skip credit cards.

notif refresh

after deleting completed payments, refresh notification list.
there might be other events to refresh this list as well, check.

Currency investment ratio

• New JSON field: Foreign currency investment percentage
• Foreign currency purchase should act accordingly
• New foreign currency + update code: BTC
• Plan BTC IRL
• Add BTC % to foreign currency file

easy credit card bank statement

• credit card master data: payment day
• new window for credit card bank statement: ask for card and amount
• auto-book transfer payment for the selected card

Make public on GitHub

• Ensure that there are no other issues present
• Ensure that no sensitive data is present
• Update readme
• Make public
• Plan to tweet

some graphics are too big

gui should be rewritten with qt

refresh notifications

refresh notifications on the gui after:

• saving an activity
• paying income tax
• paying VAT
• what else?

Stock management

• Implement asset JSON as stock XLS
• New field: Asset type (stock, estate)
• Report: Asset profit
• Implement current stocks as asset
• Month end closing: Asset evaluation
• Net worth: split stock with estate
• Advance #81

readme may include a screenshot

Show addresses when issuing an invoice

fatura keserken adresleri de getirsin copy paste yapılabilecek halde

startup action

action: start with new activity
app should start with a new activity window
edit morning startup to support this action

windows should fit to smaller screens too