# attendance

**Repository Path**: big_peng/attendance

## Basic Information

- **Project Name**: attendance
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工厂班组考勤系统

## 本地开发

```powershell
$env:JAVA_HOME = 'D:\Java\jdk-17'
$env:MAVEN_HOME = 'D:\apache-maven-3.9.12'
$env:Path = "$env:JAVA_HOME\bin;$env:MAVEN_HOME\bin;$env:Path"
docker compose up -d mysql
mvn -f backend/pom.xml spring-boot:run -Dspring-boot.run.profiles=local
npm.cmd --prefix frontend run dev
```

管理端默认地址为 `http://127.0.0.1:5173`，后端默认地址为 `http://localhost:8080`。本地管理员账号为 `admin` / `admin123`，部署到非本地环境前必须修改默认密码。

## 验证命令

```powershell
mvn -f backend/pom.xml verify
npm.cmd --prefix frontend run test
npm.cmd --prefix frontend run build
docker compose config
```

## REST 身份认证

`POST /api/v1/auth/login` 接收 `{"username":"admin","password":"admin123"}` 并返回 Bearer 令牌。访问 `/api/v1/*` 接口时需要携带该令牌，`GET /api/v1/auth/me` 用于获取当前已认证用户。

## MCP

`POST /mcp` 使用 JSON-RPC 协议，并通过 `X-MCP-API-Key` 独立认证。请在环境变量中设置 `MCP_API_KEY`，本地开发的默认值为 `local-mcp-key`。

系统提供 `search_employees`、`get_teams`、`get_attendance_results`、`get_attendance_summary` 和 `get_absence_records` 五个只读工具。`get_attendance_summary` 必须提供包含起止日的 ISO 日期 `from` 和 `to`，且查询范围不能超过 366 天。