签入版本

EasyGoAdmin_GoFrame_AntdVue/zh/modules/article.md

@@ -0,0 +1,75 @@
+# 6.7 文章管理
+
+:::tip 概述
+文章模块（goframe_article，租户级表）是文件/富文本字段的代表模块：cover 单图、images 多图、content 富文本（[IMG_URL] 持久化契约），配合分类关联与状态/点击量/排序。
+:::
+
+## 接口清单
+
+```text
+七件套 + PUT /api/article/status（sys:article:status）
+sys:article:{page|list|detail|add|update|delete|batchDelete|status}
+```
+
+## 表特征列
+
+```text
+category_id   所属分类（逻辑外键 → goframe_category）
+cover         封面单图（FileFields）
+images        多图（MultiFileFields，逗号分隔）
+content       富文本（ContentFields，[IMG_URL] 占位符契约）
+status        0-正常 1-下架（注释枚举）
+click         点击量
+sort          排序
+```
+
+## 声明式文件/富文本处理（spec 模式）
+
+```go
+// articleSpec 关键声明（模式示意）
+var articleSpec = ModuleSpec[...]{ ...,
+    FileFields:     []string{"cover"},           // 单图
+    MultiFileFields: []string{"images"},         // 逗号多图
+    ContentFields:  []string{"content"},         // 富文本
+    FileSaveDir:    "article",                   // 转正目录
+}
+```
+
+基座自动完成：
+
+```text
+写侧（saveTransform）：
+  cover/images：temp 路径 → SaveFromTemp 转正到 article/{日期}/
+  content：LocalizeContentFields —— 本站 /temp/ 引用转正、
+           本站正式引用剥离域名 → "[IMG_URL]/相对路径"
+           外站 URL 不处理（防 SSRF）
+
+读侧（readTransform）：
+  cover/images：GetFileUrl 补域名（domainUrl 或 /upload/）
+  content：ExpandContentFields —— "[IMG_URL]" 还原为访问基址
+```
+
+详见 [7.3 富文本处理](../tools/rich-text) 与 [7.1 文件上传全流程](../tools/upload)。
+
+## 分类关联
+
+```text
+article.category_id → category.id（树形模块，见 6.10 分类管理）
+列表可按分类筛选（EqFields）；分类删除有引用守卫意识（避免文章悬挂）
+```
+
+## 状态与展示
+
+```text
+status 0-正常 1-下架：前端列表按状态过滤展示
+SerializeMaps: status → article_status（字典驱动 {field}Text）
+click 点击量：详情阅读累加（业务自定义）
+sort 排序：OrderBy "sort asc" 或前端排序白名单
+```
+
+## 管理建议
+
++ 富文本图片会被自动本地化（temp → 正式目录）——编辑器直传的图片安全落库
++ 外站图片链接保持原样不抓取（设计边界：防 SSRF）
++ content 字段含 [IMG_URL] 占位符是库内格式契约——content 不供第三方系统直接消费，读取必须走 Detail/List（基座自动还原）
++ cover/images 字段入库为相对 uploadDir 路径，展示层经 GetFileUrl（基座已处理，勿手拼）