TimeCraft: Track Your Time and Productivity

If you would like to read about the process of making this project: https://www.linkedin.com/pulse/timecraft-tale-obsession-creating-solutions-your-own-benoni-esckinder-fcr8e

My LInkedIn: https://www.linkedin.com/in/benoni-esckinder-929220269/

Table of Contents

• Project Goal
• Features
• Instructions
  • Start TimeCraft
  • Create a User
  • Manage Tasks
    • Create a new task
    • View all tasks
    • Total time on task
    • Delete a task
  • Create a Log
  • Generate Reports
    • Daily report
    • Weekly report
    • Monthly report
  • Time Metrics
    • Total productive time
    • Total wasted time
  • Exit
• Contributions

Project Goal:

This project is intended to track your time by keeping track of how much time you spend on specific tasks, helping you identify areas for improvement and optimize your workflow.

Features:

• Multi-user support: Accommodates multiple users to personalize their time tracking experiences.
• Task management: Create and manage tasks, including daily goal for time on task.
• Task logging: Record the time spent and wasted time for each task, providing valuable insights into your work habits.
• Reporting: Generate comprehensive reports on daily, weekly, and monthly activity, helping you assess your progress and identify trends.
• Time metrics: Gain insights into your total productive and wasted time, allowing you to make informed decisions about your time usage.

Instructions:

1. Start TimeCraft:

   • Open your terminal and navigate to the project directory.
   • Run ./timecraft.py to initiate.

2. Create a User:

   • Use the new User command to set up your user profile.
   • Provide your name, weekly work hour goals, and number of work days per week.
   • The command will return your unique User ID, essential for task management and logging.

3. Manage Tasks:

   • Create a new task:

     • Use the new Task command, specifying your User ID (from step 2).
     • Enter the task name and how much you'd like to dedicate to the task.
     • The command will return a Task ID that'll come in handy later.

   • View all tasks:

     • Use the all_tasks command, provide your User ID, to list all tasks associated with a user.

   • Total time on task:

     • Use the total_time_on_task command, along with the Task ID, to retrieve the total time spent on a task.

   • Delete a task:

     • Use the delete_task command, specifying the Task ID, to permanently remove the task.

4. Create a Log:

   • Use the new Log command to record your activity for the day. Provide your Task ID (from step 3) and specify how much time you've spent on and how much time you've wasted

5. Generate Reports:

   • Daily report:

     • Use the daily_report command with your User ID.
     • You can either enter "today" for the current day, or a specific date in the format "Month-Day-Year" (e.g., "February 29, 2024").

   • Weekly report:

     • Use the weekly_report command with your User ID.
     • Enter one of the following options:
       • "this_week" for a report on the current week.
       • "last_week" for a report on the previous week.
       • "custom" followed by a date in "Month Day Year" format (e.g., "February 24 2024") to get a report for the week containing that date.

   • Monthly report:

     • Use the monthly_report command with your User ID to generate a report for the entire month.

6. Time Metrics:

   • Total productive time:

     • Use the total_productive_time command with your User ID to calculate the total time spent productively across all tasks.

   • Total wasted time:

     • Use the total_wasted_time command with your User ID to determine the total time wasted across all tasks.

7. Exit:

   • To exit TimeCraft, you can either enter the quit command or press Ctrl+D.

Contributions:

TimeCraft welcomes contributions from the community! Feel free to report bugs, suggest improvements, or create pull requests to enhance the project's functionality and user experience.

Master your time and optimize your productivity with TimeCraft!

Command List:

• new User
• new Task
• new Log
• all_tasks
• total_time_on_task
• delete_task
• daily_report
• weekly_report
• monthly_report
• total_productive_time
• total_wasted_time
• quit