Skip to content

An efficient work hour management tool | 高效的工时管理工具

License

Notifications You must be signed in to change notification settings

HeHang0/PunchPal

Repository files navigation

PunchPal

image GitHub license GitHub stars GitHub forks GitHub issues

English | 简体中文

PunchPal is an efficient work hour management tool. Whether manually adding punch-in records or configuring API data sources, PunchPal helps you track, analyze, and optimize your work schedule effortlessly.


🚀 Features

1. Manual Records or API Integration

  • Add punch-in and punch-out records manually for flexibility.
  • Configure API data sources to automatically sync daily punch records.

2. Daily Work Hour List

  • View detailed daily work hours in a clear list format.
  • Filter by date ranges to focus on specific time periods.

3. Monthly Calendar Overview

  • Visualize your work hours on a calendar view.
  • Get an at-a-glance understanding of daily work patterns.

4. Monthly Comparison Overview

  • Compare the current month with the previous month to identify trends.
  • Use comprehensive statistics to optimize your time management.

5. Interactive Dashboard

  • Explore data trends through a clean and interactive dashboard.
  • Display key metrics such as total hours, overtime, and average daily hours.

🛠️ Installation

Steps

  1. Clone the repository:

    git clone https://github.com/hehang0/PunchPal.git
  2. Navigate to the project directory:

    cd PunchPal
  3. Build and run the application:

    dotnet build
    dotnet run

🎨 Screenshots

Daily Work Hour List

Daily Work Hours

Monthly Calendar Overview

Monthly Calendar

Dashboard Overview

Dashboard


🔧 Configuration Guide

API Data Source Setup

  1. Open the Settings menu in the application.
  2. Enter the API endpoint and authentication details.
  3. Test the connection to ensure data sync works properly.

🛡️ License

PunchPal is licensed under the Anti-996 License. Please comply with the license terms when using, modifying, or distributing this software.


🤝 Contributions

We welcome contributions! Follow these steps:

  1. Fork this repository.

  2. Create a feature branch:

    git checkout -b feature-name
  3. Commit your changes and push the branch:

    git commit -m "Add new feature"
    git push origin feature-name
  4. Open a Pull Request and describe your changes.


📧 Contact

If you have any questions or feedback, feel free to contact us:

About

An efficient work hour management tool | 高效的工时管理工具

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages