doc

server/.ai-specs/doc-dict/book_process_status.md

@@ -0,0 +1,11 @@
+# 书籍处理状态
+
+- 模块：book
+- 字典编码：`book_process_status`
+
+| Label | Value | Sort | Status | Desc |
+|:---|:---|:---|:---|:---|
+| 文件准备 | `file_ready` | 10 | true | 原始整本书文件已准备好，可进入拆分流程 |
+| 拆分章节 | `chapter_splitting` | 20 | true | 系统正在把整本书拆分成多个章节文件 |
+| 验证章节 | `chapter_verifying` | 30 | true | 系统正在校验章节拆分结果与内容完整性 |
+| 完成 | `process_completed` | 40 | true | 章节文件已生成并通过校验，可对外提供阅读 |

server/.ai-specs/logic-specs/book.md

@@ -1,25 +1,37 @@
-书名: 
-子标题
-书籍类型:字典
-书籍标签 : 字典 ,标签是多个 要考虑用标签搜索书籍的性能问题
-书有系列:第一部 第二部,  上部 下部 , 所以有排序功能
-章节名: 章节是否能观看
-文件路径:oss url
-封面图片: url
-作者名(非id): 多个名字用,隔开
-出版社:
-出版时间:
-简介:
-热度:
-评分: 0-10分
-点评数:
-字数:
-书籍完结状态: 字典, 完结/连载
+# 书籍信息表
+- 书名: 
+- 子标题
+- 书籍类型:字典
+- 书籍标签 : 字典 ,标签是多个 要考虑用标签搜索书籍的性能问题
+- 书有系列:第一部 第二部,  上部 下部 , 所以有排序功能
+- 封面图片: url
+- 出版社:
+- 出版时间:
+- 简介:
+- 热度:
+- 评分: 0-10分
+- 点评数:
+- 字数:
+- 书籍完结状态: 字典, 完结/连载
+- 书籍处理状态: 字典, 文件准备 / 拆分章节 / 验证章节 / 完成
 - 书籍系列Id
+- 系列内排序: 用于同系列书籍排序
+- 作者: 通过书籍作者关联表维护, 支持多个作者和排序
+- 原始书籍文件: 保存整本书文件存储地址
+- 内容存储: 原始整本书文件保存后, 系统再拆分成多个章节文件保存
 
 # 书籍系列表
 - 名字
 - 封面图片
+- 书籍通过 系列Id + 系列内排序 挂到系列下
+
+# 书籍章节表
+- 书籍Id
+- 章节标题
+- 章节排序
+- 是否可观看
+- 章节文件存储地址
+- 阅读历史和评论都通过 章节Id + 行号 定位
 
 # 书籍作者表
 - 名字
@@ -27,21 +39,51 @@
 - 简介
 - 封面图片： url
 
+# 书籍作者关联表
+- 书籍Id
+- 作者Id
+- 作者排序
+- 一本书可关联多个作者, 一个作者可关联多本书
+
 # 用户观看书籍历史表
 - 会员用户Id
+- 书籍Id
 - 观看书籍进度 : 前端显示 50%
 - 观看章节Id
 - 观看章节行数 
+- 主定位以 章节Id + 行号 为准
 
-
-# 用户收藏书籍历
+# 用户收藏书籍历史表
 - 会员用户Id
 - 书籍Id
 
 # 书籍评论表
-- 评论书籍id
-- 评论章节id
+- 评论用户Id
+- 评论书籍Id
+- 评论章节Id
 - 评论章节行数 ： 比如第二章第5行
 - 评论内容
 - 评论点赞数
 - 作者是否点赞
+- 主定位以 章节Id + 行号 为准
+
+# 关系图
+```mermaid
+flowchart LR
+    Book["书籍"] --> Series["书籍系列"]
+    Book --> SourceFile["整本原始文件"]
+    Book --> Chapter["书籍章节"]
+    Book --> BookAuthorRel["书籍作者关联"]
+    BookAuthorRel --> Author["书籍作者"]
+    SourceFile -.拆分生成.-> Chapter
+
+    User["用户"] --> History["观看书籍历史"]
+    User --> Favorite["收藏书籍历史"]
+    User --> Comment["书籍评论"]
+
+    History --> Book
+    History --> Chapter
+    Favorite --> Book
+    Comment --> Book
+    Comment --> Chapter
+```

server/AGENTS.md

@@ -133,6 +133,7 @@ flowchart LR
 |:---|:---|:---|
 | `.ai-specs\doc-dict\book_author_status.md` | 定义作者状态的标准值域 | 涉及作者状态的存储、校验、展示和接口出入参时必读 |
 | `.ai-specs\doc-dict\book_completion_status.md` | 定义书籍完结状态的标准值域 | 涉及书籍完结状态的存储、校验、展示和接口出入参时必读 |
+| `.ai-specs\doc-dict\book_process_status.md` | 定义书籍文件处理状态的标准值域 | 涉及原始文件准备、章节拆分、章节校验、处理完成等流程状态时必读 |
 
 
 ## 可复用代码/组件