bizley/timeclock

简单的工时记录项目

资助包维护!
bizley

安装: 298

依赖: 0

建议者: 0

安全: 0

星级: 30

关注者: 3

分支: 11

开放问题: 3

类型:项目

2.4.1 2020-12-14 13:08 UTC

This package is auto-updated.

Last update: 2024-09-10 07:22:20 UTC


README

Latest Stable Version Total Downloads Yii2

基于 Yii 2 框架 的简单工时记录服务。

screen

安装

  1. 使用 Composer 安装 TimeClock

    composer create-project --prefer-dist bizley/timeclock timeclock

  2. 准备指向 /public 目录的虚拟主机。

  3. 准备你选择的数据库配置。将其放在 /src/config/db.php

  4. 修改 /src/config/web.php 文件以更改

    • timeZone(默认 UTC),
    • language(默认 en-USplde 翻译提供在 /src/messages/ 文件夹中),
    • components > mailer 配置以实际发送电子邮件(用于密码重置),
    • components > formatter 日期和时间格式配置,
    • params > company(默认 公司名称;在页脚和其他布局位置显示),
    • params > email(默认 email@company.com;用作电子邮件发送者地址),
    • params > allowedDomains(默认 ['@company.com'];允许注册的电子邮件域数组)。
  5. /public/index.php 文件更改为将 YII_DEBUG 模式设置为 falseYII_ENV 环境设置为 prod

  6. 在控制台中运行 php yii migrate 以应用迁移。

  7. 启动 web 服务器并注册第一个账户。

  8. 如果您想创建一个管理员账户,请在控制台中运行 php yii admin/set ID,其中 ID 是要设置的账户的数据库标识符(通常是第一个 1)。

基本规则

  • 注册账户需要其电子邮件地址位于提供的域之一。如果您想更改此行为,您必须准备自己的代码。当前实现位于 /src/models/RegisterForm.php/src/views/site/register.php
  • 会话可以在任何时候开始,但必须结束,不得与其他结束的会话重叠。
  • 一天中可以有多个会话。
  • 会话不能超过午夜。
  • 未结束的会话不计入工作时间。
  • 休息时间不能与其他休息时间重叠。
  • 假期自动从 https://www.kalendarzswiat.pl 获取,该网站是波兰假日列表。如果您想使用其他内容,您必须为此准备自己的代码。当前实现位于 /src/models/Holiday.php

功能

  • 账户注册
  • 密码重置
  • 更新个人资料
  • 主题
  • 使用登录名或 PIN 登录
  • 会话时间带备注
  • 休息时间带备注
  • 会话和休息时间历史记录
  • 日历
  • 假期
  • 管理员部分
  • REST API
  • Bootstrap 4 布局

2.3.0 中的新功能

  • 休假请求
  • 项目
  • 为管理员提供会话时间 CSV 下载
  • 管理员停用账户

从 2.2.1 升级到 2.3.0

  1. 更新所有项目文件以匹配存储库。
  2. 在控制台中运行 php yii migrate 以应用迁移。

一般帮助

首先阅读 TimeClock Wiki

有关与 Yii 相关的所有内容,请参阅 Yii 2 指南
我真的不想指向那些显然带有解决方案的链接。

本项目使用方法

只要提及来源,您可以使用本项目以任何您喜欢的方式。

屏幕截图

screen2

screen3

screen4

screen5