基础项目

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

@@ -2,6 +2,7 @@
 
 - 模块：book
 - 字典编码：`book_author_status`
+- 字典类型：`固定值域字典`
 
 | Label | Value | Sort | Status | Desc |
 |:---|:---|:---|:---|:---|

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

@@ -0,0 +1,10 @@
+# 书籍评论状态
+
+- 模块：book
+- 字典编码：`book_comment_status`
+- 字典类型：`固定值域字典`
+
+| Label | Value | Sort | Status | Desc |
+|:---|:---|:---|:---|:---|
+| 正常 | `normal` | 10 | true | 评论可正常展示，并参与书籍评论列表与详情页输出 |
+| 隐藏 | `hidden` | 20 | true | 评论因违规或运营处理被隐藏，不再对普通用户展示 |

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

@@ -2,6 +2,7 @@
 
 - 模块：book
 - 字典编码：`book_completion_status`
+- 字典类型：`固定值域字典`
 
 | Label | Value | Sort | Status | Desc |
 |:---|:---|:---|:---|:---|

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

@@ -0,0 +1,18 @@
+# 书籍时代标签
+
+- 模块：book
+- 字典编码：`book_era_tag`
+- 字典类型：`固定值域字典`
+
+| Label | Value | Sort | Status | Desc |
+|:---|:---|:---|:---|:---|
+| 未知时代 | `unknown` | 10 | true | 无法明确判断所属时代时使用的兜底值 |
+| 远古 | `ancient` | 20 | true | 远古或先秦等早期历史阶段作品 |
+| 汉 | `han` | 30 | true | 汉代背景或汉代成书作品 |
+| 唐 | `tang` | 40 | true | 唐代背景或唐代成书作品 |
+| 宋 | `song` | 50 | true | 宋代背景或宋代成书作品 |
+| 元 | `yuan` | 60 | true | 元代背景或元代成书作品 |
+| 明 | `ming` | 70 | true | 明代背景或明代成书作品 |
+| 清 | `qing` | 80 | true | 清代背景或清代成书作品 |
+| 近代 | `modern` | 90 | true | 晚清至民国等近代历史阶段作品 |
+| 现代 | `contemporary` | 100 | true | 当代或新中国以来现代阶段作品 |

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

@@ -1,11 +0,0 @@
-# 书籍处理状态
-
-- 模块：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/doc-dict/book_publish_status.md

@@ -0,0 +1,11 @@
+# 书籍上下架状态
+
+- 模块：book
+- 字典编码：`book_publish_status`
+- 字典类型：`固定值域字典`
+
+| Label | Value | Sort | Status | Desc |
+|:---|:---|:---|:---|:---|
+| 草稿 | `draft` | 10 | true | 书籍资料仍在整理，后台可维护但不对 `app` 端开放 |
+| 下架 | `off_shelf` | 20 | true | 书籍已停止对外展示，历史阅读和收藏可保留但不再新增访问 |
+| 上架 | `on_shelf` | 30 | true | 书籍可在 `app` 端正常展示、收藏和参与评论 |

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

@@ -0,0 +1,9 @@
+# 书籍类型
+
+- 模块：book
+- 字典编码：`book_type`
+- 字典类型：`动态值域字典`
+- 数据来源：`系统字典`
+- 业务用途：用于书籍筛选、聚合和展示
+- 逻辑约束：不参与业务状态流转、默认值判断和分支逻辑；业务侧只校验值存在性，并通过独立封装入口读写
+- 升级条件：如果后续 `book_type` 参与默认值、状态流转、业务分支或稳定接口 contract，必须改为 `固定值域字典` 并补齐字典项清单