写在前面

这篇文章本来是我给自己写的"项目复盘"。写着写着发现——好家伙，这字数快赶上毕业论文了。

既然都写这么多了不如发出来给大伙看看。

如果你正打算用 Flutter + NestJS 做个全栈项目，这篇文章大概能帮你省下几个踩坑的夜晚。如果你只是闲着没事点进来看看…，那也行，就当听一个失业人员吹牛。

一、项目背景：为什么我要自己造轮子？

痛点1：市面上App没有词组功能 想背词组，市面上的App没有。问客服，说"以后可能会加"。至于翻译一下，"以后" ≈ "下辈子"。不过，

痛点2：现成方法不满足需求 再加上正好失业在家。闲着也是闲着，不如自己干一个。

方法：佳禾英语 于是就有了佳禾英语——一个名字听起来像补习班、但确实能用的单词学习App。

• 前端Flutter .x
• 后端NestJS + TypeORM + MySQL
• 通信方式RESTful API，HTTP协议
• 部署树莓派

"从单词怎么存到单词怎么学再到学了怎么记全链路自己撸了一遍"

为什么叫"佳禾"?

二、后端架构：3600行代码，10个模块。9张表

• 约,行 TypeScript 代码;
• 个源文件;
• 采用 NestJS 的模块化架构;

至于数据模型，9张表的关系网

"先来个关系图。感受一下这9张表是怎么串起来的:"

┌──────────────┐ ┌──────────────────┐ ┌──────────────┐
│ users │────►│ usersettings │ │ words │
└──────────────┘ └──────────────────┘ └───────────
│ │
│ │
├───► ┌─► ┌─► ┌─► ┌─► ┌─► ┌───►
userwordprogress dailyrecords search_history wordbooks

wordbook_words admins

主要两条线:

1. 单词线: words → wordbook_words → wordbooks
2. 学习线: users → user_word_progress → daily_records

其他表都是辅助——user_settings存个人偏好,search_history存搜索记录,admins给管理后台用。说起来，

说到主要表，user_word_progress 的设计

typescript // user_word_progress 主要字段 easiness_factor: decimal // 初始,SM- 主要参数 correct_streak: int // 连续正确次数,达到5次就"掌握" review_count: int // 复习总次数 next_review_at: datetime // 下次复习时间。靠它决定今天该学啥 last_interval_days: int // 上次间隔天数 说到status，tinyint // =未学 =学习中 =已掌握 source这方面，varchar // 'new' | 'review' | 'simple'

简单说一下这些字段是干嘛的: - easinessfactor: SM-2算法关键参数,影响下次复习间隔。不过，- correctstreak:连续答对5次才算掌握。- nextreviewat决定每日任务内容。

SM-2间隔重复算法:

ini // 回答正确时的处理IF correctstreak == : interval = 天ELIF correctstreak == : interval = 天ELSE: interval = lastintervaldays * easiness_factor

easiness_factor += - * * )

// 质量取值范围 -,由使用者回答决定质量为表示完美答案;为错误答案，按理说，拼写模式正确为;错误为

// 质量如何决定?话说回来，质量取决于使用者选择: • 使用者点"认识" → quality = • 使用者点"不认识" → quality = • 拼写模式正确 → quality = • 拼写模式错误 → quality =

关键细节: 连续正确达到5次时状态标记为已掌握。

再看每日学习任务，

getDailyWords方法工作流程: