todo_correct
一个支持多用户认证的全栈待办事项应用,采用Next.js和FastAPI构建。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:todo_correct。 它的用途是:一个支持多用户认证的全栈待办事项应用,采用Next.js和FastAPI构建。 完整的 Skill 内容见:https://321skill.com/skills/todo-correct/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下这个Todo应用后端的用户注册API是如何实现密码哈希和存储的。”,它会引导你查看后端`services`目录下的认证逻辑,重点解释Argon2id哈希函数的使用和SQLModel模型的定义。或者,你可以问:“在前端如何调用创建待办项的接口?”,它会结合项目中的TypeScript类型和`lib`目录下的工具函数,说明如何发起认证后的API请求。
介绍
Todo Correct 是一个为解决个人或团队任务管理需求而生的全栈待办事项应用。它通过用户认证系统,确保每个用户的任务数据独立且安全,有效解决了传统待办应用在多用户场景下数据混杂、权限不清的问题。
使用上,用户需要分别启动后端(FastAPI)和前端(Next.js)服务。首先配置Neon PostgreSQL数据库并设置环境变量,然后通过Alembic运行数据库迁移,最后分别启动前后端开发服务器即可通过浏览器访问应用。整个过程遵循清晰的开发规范,便于部署和二次开发。
这个应用非常适合正在学习或实践全栈开发的开发者,尤其是希望了解如何将Next.js前端与FastAPI后端结合,并实现完整用户认证流程的编程爱好者。它也适用于需要一个小型、可自定义的私有任务管理工具的小团队或个人。
与同类简单的待办事项Demo或仅提供前端的项目相比,Todo Correct 的核心区别在于其完整性和生产就绪性。它不仅实现了前后端分离,还集成了专业的用户认证(Better Auth)、数据库迁移(Alembic)、密码哈希(Argon2id)等后端关键功能,提供了一个从数据库到用户界面的完整、可扩展的解决方案,而非一个玩具项目。
核心特点
核心区别在于其完整的全栈架构与生产级特性:集成了基于JWT的Better Auth认证、使用Argon2id进行密码哈希、采用SQLModel ORM与Alembic进行数据库迁移,并严格遵循前后端分离与类型安全(TypeScript),提供了一个远超基础Demo的、可直接部署或作为学习样板的全功能应用。
注意事项
由于需要独立部署数据库和前后端服务,不适合寻求即开即用、无需配置的轻量级任务管理工具的用户。
常见问题
如何部署Todo Correct应用?
需要分别部署后端FastAPI服务和前端Next.js应用,并配置Neon PostgreSQL数据库连接。详细步骤见项目Quick Start部分。
这个项目使用什么技术栈?
前端使用Next.js 16(App Router)和TypeScript,后端使用FastAPI和SQLModel,数据库为Neon PostgreSQL,认证采用Better Auth。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/todo-correct/raw/index.md 读取 todo_correct 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/todo-correct/raw/index.md(查看排版版本)