全栈项目工程:和 AI 做出一个完整应用
这本小册面向零基础的技术新人、独立开发者和小微企业用户。不是先学完一套大厂工程体系再做项目,而是第一章就运行自己的网页,每一部分增加一个看得见的能力。
贯穿项目是 TaskBoard 任务清单:普通用户添加和完成自己的任务,管理员在后台查看并处理测试任务。最终作品包括前端、后端、API、数据库、登录、管理后台、验证方法和部署说明。不包含团队组织、计费、微服务或集群。
八部分、二十四章
| 部分 | 三章内容 | 阶段成果 |
|---|---|---|
| 1. 做出能操作的前端 | 启动任务清单;页面与交互;Git保存结果 | 一个能添加、完成和筛选任务的页面 |
| 2. 写出能调用的后端API | 健康接口;增删改查;前后端联调 | 页面真正请求自己的API |
| 3. 让数据真正保存下来 | SQLite建表;替换内存;备份与加字段 | 重启后任务仍在 |
| 4. 接入登录与用户权限 | 托管注册登录;后端验身份;用户数据隔离 | 两个账号互相看不到私有任务 |
| 5. 做出真正的管理后台 | 后台授权;搜索分页列表;管理操作 | 管理员能够处理数据,普通用户被拒绝 |
| 6. 理解小项目系统设计 | 画请求路径;整理代码与API文档;模拟外部服务 | 能解释、维护和扩展自己的应用 |
| 7. 验证功能并学会排错 | 输入测试;两账号完整流程;定位报错 | 能证明功能可用,也能复现失败 |
| 8. 低成本上线并交付 | 分清运行环境;发布与恢复;作品交付 | 一个有运行说明、权限和备份的项目 |
学习顺序就是开发顺序。不会要求先提交大量概念笔记才开始写页面。前五部分完成前台、后端、后台的实际功能,后三部分帮助你把它交给真实用户。
技术路线与费用
主线使用 Vue 3 + Vite、JavaScript、Express、SQLite、Supabase Auth。前端框架只选一种,不同时教React和Vue;数据库先用本地文件,登录复用成熟服务而不自己实现密码系统。
本地部分免费。准备 Node.js 22.13+、Git、编辑器和Codex等工具,按工具安装提示核对最低版本;实际AI工具费用由所用套餐决定。
上线可复用已有小服务器,同域提供页面与API、SQLite放持久磁盘。如果不想付常驻服务器费用,可以选择静态托管加Supabase,或Workers+D1,但要完成对应的数据与运行时适配。本地SQLite不能直接放在临时函数磁盘中当永久数据库。 免费额度、商业用途和超额规则以开通当天的平台说明为准,不预先购买高级服务。
每章的学习方式
- 先读“本章结果”,知道今天要看到什么。
- 按指定目录创建或修改文件,一次只增加一个功能。
- 使用Codex解释已有代码、补组件或写测试,保留当前技术栈。
- 亲自运行命令,完成成功与失败两种验证。
- 保存代码、脱敏截图和简短心得,再进入下一章。
代码片段标明需要替换或插入的位置;未定义的业务变量需要沿用前章,不把每个片段当成独立应用。章节中的AI任务用于补齐明确范围的实现,不替代执行和验收。
贯穿全书的AI约束
先阅读我的README、目录与相关代码。每次只实现当前章节的一项功能,说明修改文件、启动命令和验收方法。不要更换框架、引入额外数据库或付费服务,不删除已有数据,不打印密钥。涉及身份和管理员权限,必须在可信后端验证。遇到失败先复现,不通过移除校验来让测试通过。
第一次读不懂所有语法很正常,先理解“输入什么、经过哪里、返回什么”。命令行与网络问题查计算机基础,SQL与数据备份查数据库册,具体平台部署查云服务册。
毕业标准
能演示普通用户操作和管理员处理;刷新与重启不丢数据;未登录和越权请求被拒绝;有一次备份恢复、一组测试和运行说明。最后选择一个小需求自行增加,例如截止日期,从字段、API到页面完成闭环。这比背完架构术语更能说明你已经迈入全栈开发。