# attendance

**Repository Path**: hngcadmin/attendance

## Basic Information

- **Project Name**: attendance
- **Description**: python员工考勤
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-28
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 员工考勤管理系统（Flask + MySQL）

一个用于课程设计的简易考勤管理系统，包含出勤、加班、请假信息的录入、修改、查询与删除功能，同时提供初始化 SQL 脚本和示例数据。

## 1. 环境准备
1. 安装 Python 3.10+ 和 MySQL 8+。
2. 创建虚拟环境并安装依赖：
   ```bash
   python -m venv .venv
   source .venv/bin/activate  # Windows 使用 .venv\Scripts\activate
   pip install -r requirements.txt
   ```

## 2. 初始化数据库
1. 登录 MySQL（默认用户名 `root`、密码 `12345678`）：
   ```bash
   mysql -u root -p
   ```
2. 导入初始化脚本：
   ```sql
   SOURCE /Users/ljd/Desktop/db/员工考勤/python/init.sql;
   ```
   这会创建 `attendance_db` 库、基础表以及示例数据。

## 3. 运行应用
应用默认连接配置：
- 主机：`127.0.0.1`
- 端口：`3306`
- 数据库：`attendance_db`
- 用户：`root`
- 密码：`12345678.`

如需修改，可设置环境变量：
```bash
export DB_HOST=127.0.0.1
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=12345678.
export DB_NAME=attendance_db
export APP_SECRET_KEY=dev-secret-key
```

启动：
```bash
export FLASK_APP=app.py
flask run  # 或 python app.py
```
然后访问 http://127.0.0.1:5000 查看系统。

## 4. 功能说明
- **出勤**：录入/修改/删除每日出勤（日期、上/下班时间、工时、状态、确认信息）。
- **加班**：按年月记录加班类型与小时数。
- **请假**：按年月记录请假类型与天数，可填写备注。
- **查询筛选**：按员工、起止日期过滤出勤、加班、请假数据。

## 5. 目录结构
- `app.py`：Flask 主程序与路由。
- `templates/`：页面模板（总览、出勤/加班/请假表单）。
- `init.sql`：数据库建表与示例数据。
- `requirements.txt`：依赖列表。

## 6. 自测说明
- 已通过 `python3 -m py_compile app.py` 检查语法。
- 需确保本地 MySQL 已导入 `init.sql` 后再访问页面完成手动功能验证（添加、编辑、删除、条件查询）。