README.md

metadata

title: 高级 Python 后端项目 (FastAPI + SQLite)
emoji: 🚀
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
short_description: 高级 Python 后端项目 (FastAPI + SQLite)

🚀 高级 Python 后端项目 (FastAPI + SQLite)

这是一个功能强大的经典后端项目，展示了如何使用 FastAPI 构建一个具备持久化存储、CRUD、分类管理、搜索及响应式前端的完整应用。

🌟 核心功能

• 持久化存储：使用 SQLAlchemy ORM + SQLite 数据库。
• 分类管理：支持对笔记进行分类（工作、生活、灵感、学习等）。
• 全局搜索：支持对标题和内容的关键词搜索。
• 实时编辑：通过 Modal 弹窗实现无需刷新的在线编辑功能。
• 防重复提交：前后端双重校验，彻底修复重复保存的 Bug。
• 现代化 UI：基于 Tailwind CSS 的精致侧边栏布局，支持交互动画。
• 自动化文档：内置 Swagger UI (/docs)。

🛠️ 技术栈

• 后端: FastAPI (Python 3.10+)
• 数据库: SQLite + SQLAlchemy
• 前端: HTML5 + Tailwind CSS + FontAwesome + Vanilla JS
• 部署: Docker (Hugging Face Spaces 适配)

🚀 快速开始

本地运行

1. 安装依赖：

   pip install -r requirements.txt
   

2. 启动应用：

   python app.py
   

3. 访问：

   • 首页：http://localhost:7860
   • 文档：http://localhost:7860/docs

📝 修复说明 (v3.0)

• Bug 修复：解决了用户反馈的“新建一条保存两条”的问题。通过前端禁用按钮和后端 1s 内内容去重逻辑彻底解决。
• 功能升级：新增了搜索、分类筛选和 Modal 编辑功能。
• 视觉优化：重构了布局，采用侧边栏设计，增加了列表加载动画和按钮交互。

📄 协议

本项目基于 MIT 协议开源。