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 格式),按其中说明在我的环境里完成安装和配置。