mirror of
https://github.com/Cccc-owo/CheckInApp.git
synced 2026-06-17 05:56:29 +00:00
82 lines
1.6 KiB
Markdown
82 lines
1.6 KiB
Markdown
# CheckIn App V2
|
|
|
|
[](https://fastapi.tiangolo.com/)
|
|
[](https://vuejs.org/)
|
|
[](https://www.python.org/)
|
|
|
|
接龙自动打卡系统，通过 QQ 登录实现每日自动考勤提交。
|
|
|
|
## 特性
|
|
|
|
- QQ 扫码登录
|
|
- 用户任务分离（一人多任务）
|
|
- 任务模板系统
|
|
- 定时自动打卡
|
|
- 邮件通知
|
|
- 用户审批机制
|
|
- 管理后台
|
|
|
|
## 技术栈
|
|
|
|
**后端**: FastAPI + SQLAlchemy + APScheduler + Selenium
|
|
**前端**: Vue 3 + Ant Design Vue + Pinia
|
|
**数据库**: SQLite
|
|
|
|
## 快速开始
|
|
|
|
### 环境要求
|
|
|
|
- Python 3.9+
|
|
- Node.js 16+
|
|
- Chrome 浏览器
|
|
|
|
### 安装运行
|
|
|
|
```bash
|
|
# 后端
|
|
python -m venv venv
|
|
venv\Scripts\activate # Windows
|
|
source venv/bin/activate # Linux/Mac
|
|
pip install -r backend/requirements.txt
|
|
python3 run.py
|
|
|
|
# 前端
|
|
cd frontend
|
|
npm install
|
|
npm run dev
|
|
|
|
# 创建管理员
|
|
python backend/scripts/create_admin.py
|
|
```
|
|
|
|
### 访问地址
|
|
|
|
- 前端: <http://localhost:3000>
|
|
- API 文档: <http://localhost:8000/docs>
|
|
|
|
## 进程管理
|
|
|
|
```bash
|
|
# Windows
|
|
manage.bat start [all/backend/fronted]
|
|
manage.bat stop [all/backend/fronted]
|
|
manage.bat status
|
|
|
|
# Linux/Mac
|
|
./manage.sh start [all/backend/fronted]
|
|
./manage.sh stop [all/backend/fronted]
|
|
./manage.sh status
|
|
```
|
|
|
|
## 配置
|
|
|
|
复制 `.env.example` 到 `.env`
|
|
|
|
nginx 与 systemd 的配置文件参考已给出，见 `.example`
|
|
|
|
## 文档
|
|
|
|
- [架构设计](docs/architecture.md)
|
|
- [部署指南](docs/deployment.md)
|
|
- [开发指南](docs/development.md)
|