开源项目：员工考勤系统(Sistem Absensi Pegawai)-优快云博客

开源项目：员工考勤系统(Sistem Absensi Pegawai)

sistem_absensi_pegawai This website contains API Backend and employee data management for SiAP application. This website is built with Laravel, Tailwind CSS, Vue JS, and Inertia JS. This website also has an attendance page (QR Code) and a table to display employee attendance data. 项目地址: https://gitcode.com/gh_mirrors/si/sistem_absensi_pegawai

项目概述

Sistem Absensi Pegawai, 或简称为SiAP，是一个基于Web的应用程序，专为解决政府机关考勤记录的痛点而设计。本项目利用现代Web技术栈，包括Laravel（一个PHP框架）、Tailwind CSS、Vue.js以及Inertia.js，旨在提供一个高效的员工数据管理和自动化考勤解决方案。它支持通过二维码扫描进行签到，并提供了展示员工出勤数据的表格界面。

1. 项目目录结构及介绍

以下是项目的主要目录结构及其简介：

sistem_absensi_pegawai/
├── app                   # 包含主要的业务逻辑，如模型(Model), 控制器(Controller), 视图(View)
│   ├── ...
├── artisan               # Laravel的命令行工具
├── bootstrap             # 项目初始化和自动加载配置
├── config                # 含有所有应用配置文件，如数据库设置
│   ├── app.php           # 应用基本配置
│   ├── database.php      # 数据库连接配置
│   ┦─ ...
├── database              # 数据迁移(migrations)和种子(seeds)文件存放处
│   ├── migrations        # 数据库表创建和更新脚本
│   ├── seeds             # 数据填充文件
├── public                # 公共资源文件夹，包括入口文件index.php
│   ├── index.php         # 项目的前端入口点
│   └── assets            # 静态资源文件
├── resources              # 包括视图(view)、语言(language)文件和Vue组件等
│   ├── views              # HTML模板或Vue组件
│   ├── lang               # 应用多语言文件
│   ┦─ ...
├── routes                 # 路由定义文件夹
│   ├── api.php           # RESTful API路由
│   ├── web.php           # 前端网页路由
├── tests                  # 单元测试和功能测试文件
├── vendor                 # Composer管理的所有第三方依赖库
├── .editorconfig          # 编辑器配置文件
├── .env.example           # 环境变量示例文件，需要复制并重命名为.env来定制你的配置
├── .gitattributes         # Git属性配置
├── .gitignore             # 忽略提交的文件列表
├── README.md              # 项目说明文档
├── artisan                # Laravel命令行工具
├── composer.json          # Composer依赖文件
├── composer.lock          # 锁定当前项目具体依赖版本的文件
└── server.php             # 用于本地服务器运行的替代启动文件

2. 项目的启动文件介绍

index.php: 此文件位于public目录下，是Web应用程序的入口点。当访问应用时，所有的请求首先会被引导到这里，然后由Laravel框架处理。
artisan: 这个脚本是Laravel提供的命令行工具，可以执行各种任务，比如迁移数据库、生成模型、路由、控制器等。
server.php: 在开发环境中，如果不想使用Apache或Nginx这样的Web服务器，可以直接通过PHP内置服务器运行此文件来启动应用。

3. 项目的配置文件介绍

.env: 基于.env.example创建，这是环境变量文件，包含了数据库连接信息、秘钥以及其他重要配置。例如，数据库用户名、密码、数据库名等，还包括特定API密钥（如Calendarific和OneSignal用于推送通知）。
config/app.php: 应用的核心配置文件，包含应用程序的基本设置，如时间区域、默认语言、中间件、别名等。
config/database.php: 定义了数据库连接详情，包括SQLite、MySQL、PostgreSQL等多种数据库的支持设置。
其它配置文件: 如broadcasting, cache, cookies, filesystems, mail, queue等，分别负责应用的不同配置需求。

初始化和运行项目步骤概览:

克隆项目: 使用Git将项目clone至本地。
安装依赖: 在项目根目录下运行composer install安装PHP依赖和npm install安装前端依赖。
配置环境: 复制.env.example为.env并编辑以填入正确的数据库和环境变量信息。
生成密钥: 执行php artisan key:generate以生成应用密钥。
数据库准备: 运行数据库迁移命令php artisan migrate来创建数据库表。
安装Voyager后台管理面板: 输入php artisan voyager:install。
生成考勤相关代码: 根据需求执行特定命令，如生成考勤码(php artisan absent:code)和录入(php artisan absent:attende)。
运行服务器: 最后，运行php artisan serve即可在本地查看运行中的应用。