feat(smoke): enhance smoke profile area management with new features

2026-03-24 18:26:20 +08:00
parent 515fba0b55
commit 47874a8769
2 changed files with 1108 additions and 0 deletions
@@ -0,0 +1,19 @@
+# 阅读打卡模块文档
+
+## 文档清单
+
+- `PRD.md`：产品需求文档（数据模型、API 设计、业务流程、前后端结构）
+
+## 说明
+
+- 小程序端接口前缀：`/api/reading`
+- 管理后台接口前缀：`/api/admin/reading`
+- 鉴权方式：`Authorization: Bearer <session_key>`
+- 业务语义：书单浏览、阅读计划、每日打卡、读书感悟、分享海报
+
+## 核心设计要点
+
+1. **阅读时长由 AI 预估**：每日导读中的 `estimated_minutes` 由 AI 在生成阅读计划时自动预估，前端仅展示，用户无需手动输入
+2. **模块命名**：后端 `internal/reading/`，前端 `apps/reading-checkin/`
+3. **表前缀**：`fa_reading_`，共 7 张表
+4. **存储前缀**：前端 localStorage 使用 `reading_checkin_` 前缀