Repository navigation
Releases
Releases · miaokela/fastapi-tpl
v1.4.1
v1.4.0
v1.2.0
v1.1.0
Release v1.1.0
✨ 新特性
🎯 优化定时任务调度精度
- 将触发时间阈值从 10秒 调整为 1秒
- 大幅提升定时任务执行的时间精确度
- 确保任务在准确的时刻触发执行
- 改进调度器的响应性能
🎨 更新 Admin 管理后台界面
- 优化 Glassmorphism(玻璃态)视觉效果
- 改进管理后台整体布局和样式
- 提升 UI/UX 用户体验
- 增强界面的现代感和科技感
📝 更新详情
定时任务优化
- 修改文件:
celery_app/scheduler.py - 优化
is_due()方法的触发时间判断逻辑 - 提高任务调度的时间精度
Admin 界面更新
- 修改文件:
static/admin/css/glassmorphism.cssstatic/admin/css/style.cssstatic/admin/index.html
- 共修改 332 行,新增内容,删除 93 行
🔧 技术改进
- 提升定时任务调度器的精确性
- 优化前端样式代码结构
- 改善用户界面的响应性和交互体验
📦 安装使用
# 拉取最新版本
git fetch --tags
# 切换到 v1.1.0 版本
git checkout v1.1.0v1.0.1 - 管理界面优化与功能增强
🎉 FastAPI TPL v1.0.1 发布
本次更新主要优化了管理界面的视觉效果,提升了用户体验,并修复了一些已知问题。
✨ 新特性
- 管理界面采用全新的玻璃态设计风格,带来更现代的视觉体验
- 优化了界面布局和交互细节,提升操作流畅度
🔧 改进
- 优化了管理后台的响应速度
- 改进了错误处理机制
- 完善了代码文档和注释
🐛 修复
- 修复了管理界面在某些浏览器上的显示问题
- 解决了部分边缘情况下的数据处理错误
📦 技术栈
- FastAPI - 现代高性能 Python Web 框架
- Tortoise ORM - 异步 ORM,支持 SQLite/PostgreSQL/MySQL
- Celery + Redis - 分布式任务队列
- 数据库定时任务调度 - 类似 django-celery-beat,支持动态管理定时任务
- JWT 认证 - 完整的用户注册、登录、权限控制
- Admin 管理 API - 用户管理、定时任务管理
- Docker 支持 - 容器化部署
🚀 快速开始
- 克隆项目:
git clone https://github.com/miaokela/fastapi-tpl.git - 安装依赖:
pip install -r requirements.txt - 配置环境变量:
cp .env.example .env - 初始化数据库:
sqlite3 default_db.sqlite3 < init_schema.sql - 启动服务:
./run_dev.sh
感谢所有贡献者的支持!欢迎提交 Issue 和 PR。
v1.0.0 - 功能完整的 FastAPI 基础项目模板
🎉 首次发布
这是一个功能完整的 FastAPI 基础项目模板,集成了企业级应用所需的核心功能。
✨ 核心特性
- FastAPI - 现代高性能 Python Web 框架
- Tortoise ORM - 异步 ORM,支持 SQLite/PostgreSQL/MySQL
- Celery + Redis - 分布式任务队列,支持分布式部署
- 数据库定时任务调度 - 类似 django-celery-beat,支持动态管理定时任务
- 任务结果自动记录 - 自动记录任务执行结果,支持配置保留天数
- JWT 认证 - 完整的用户注册、登录、权限控制
- Admin 管理 API - 用户管理、定时任务管理、任务执行记录查询
- Admin 管理后台 - 纯静态科技感 UI,无需额外前端框架
- Docker 支持 - 容器化部署
- 嵌入式单体部署 - 使用 PyInstaller 打包成单个可执行文件,适用于嵌入式设备
📋 主要功能模块
认证系统
- 用户注册/登录(邮箱或用户名)
- JWT Token 认证
- 权限控制(is_superuser/is_staff)
定时任务管理
- 动态创建/编辑/删除定时任务
- 支持 Interval 调度和 Crontab 调度
- 任务启用/禁用控制
- 手动立即执行任务
- 任务执行结果自动记录(成功/失败/撤销)
- 自动清理过期任务结果(默认7天)
Admin 管理后台
- 仪表盘(用户统计、任务统计、系统概览)
- 用户管理(CRUD 操作、权限管理)
- 定时任务管理(创建、编辑、启用/禁用、手动执行)
- 执行结果查看(状态查看、错误追踪)
🚀 快速开始
# 克隆项目
git clone https://github.com/miaokela/fastapi-tpl.git
cd fastapi-tpl
# 环境设置
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# 初始化数据库
sqlite3 default_db.sqlite3 < init_schema.sql
# 启动服务
./run_dev.sh # FastAPI 应用
./run_celery.sh worker # Celery Worker(新终端)
./run_celery.sh beat # Celery Beat(新终端)
# 访问应用
# API 文档: http://localhost:8000/docs
# Admin 后台: http://localhost:8000/admin