[toc]

Clock In is a simple tool for personal clocking in.

It is mainly developed in C++. It uses the EeayX to draw the UI and store and access the historical data with the help of LevelDB.

The original intention of this tool is mainly for self-use and, by the way, to learn how to use LevelDB.

Authors: Sean ([email protected])

Features

• Clocking in;
• Showing the information of clocking in (including the current date and the historical data);

Documentation

The documents is online and bundled with the source code.

Building

It is currently limited to the Windows platform.

You can use Visual Studio to open the project file .sln or .vcxproj directly and compile and run it.

Development related:

• C++；
• Visual Studio 2019;
• EasyX 20220116;
• LevelDB

Note:

• leveldb-r.lib: the release version of leveldb.lib. Make a copy of it and rename it to "leveldb.lib when you are in a release mode.
• leveldb-d.lib: the debug version of leveldb.lib. Make a copy of it and rename it to leveldb.lib when you are in a debug mode.

Usage

• Clocking in：

  • Select the corresponding task and click the button after it to clock in.
  • After clocking in, a tick will appear in front of the task, indicating that you have completed this task.

• Reset:

  You cannot clock in the same task repeatedly. If you want to change the result, you can click the Reset button to clear all the clocked-in tasks. Note that this function is available only for the current date.

• Display historical data：

  After starting the tool, it will display the historical information, if there is any.

  The history data is stored in the "db" folder. You can copy and move the "db" folder and

• Make-up:

  If you completed several tasks but forgot to lock in, you can make up for it by clicking the MakeUp button. By typing into the date and tasks with the format of 20220411;0x1101, you can clock-in the specific date again. Note that 0x1101 means that you have finished the first, second, and fourth tasks.

Note:

• If you want to redefine the names of the tasks, a better way is to directly modify the names of "Health, English, Programming, Reading" in the beginning of the UI::Draw() function in clock_in.cpp file, and to rebuild the whole project.

Screenshots

Please refer to the pictures in the ./screenshots/ directory for other screenshots.

Changelogs

• Updated 01/04/2022
  • Add the project；
  • Finish the main interface；
• Updated 02/04/2022
  • Finish the base function of clocking in；
  • Finish the function of a calendar;
• Updated 03/04/2022
  • Add database function and useLevelDB to store & access historical information;
• Updated 04/04/2022
  • Optimize the display of historical information
  • UpdateREADME.md；
  • Add page flip function;
• Updated 04/05/2022
  • Add date numbers;
• Updated 04/11/2022
  • Add make-up function;
• Updated 11/18/2022
  • Change the locations of the "Reset" and "MakeUp" buttonsto the bottom of the tool.
  • Add checking Clock-In info function: move the mouse on the specified grid block and right click; relevant info will show at the bottom of the tool.
  • Add modifying Clock-In info function:
    • way #1: by clicking the "MakeUp" button and inputting the new info with the form of "20221118;0x1101".
    • way #2: by double clicking on a grid and inputting the new info with the form of "0x1101".
• Updated 11/19/2022
  • Show the year information before the month. (old: Nov; new: 2022 Nov)

Upcoming Changes

Some of the goals for 2022 are:

• Code optimizing;
• Add a new function for showing the past task info and modifying them by clicking on the date. [Done at 11/18/2022]

Postscripts

This tool is mainly designed for self-use. There are still a lot of places to optimize. Frequently updates are not guaranteed. It may be updated if encountering bugs or new features during use.