1.8 KiB
1.8 KiB
6.8 公告与链接管理
:::tip 概述 内容域还有两个租户级模块：通知公告（goframe_notice）与友情链接（goframe_link）。公告带状态开关，友链无状态列——两者均为标准 CRUD 的典型代表。 :::
通知公告（goframe_notice，/api/notice）
七件套 + PUT /api/notice/status（sys:notice:status）
sys:notice:{page|list|detail|add|update|delete|batchDelete|status}
| 特征 | 说明 |
|---|---|
| status | 1-正常 2-禁用（注释枚举，字典驱动 {field}Text） |
| 租户级 | 各租户独立公告 |
| 文件字段 | 支持附件（FileFields 模式） |
| 富文本 | 内容字段可按 ContentFields 声明（如启用富文本编辑） |
友情链接（goframe_link，/api/link）
七件套（无 status 接口）
sys:link:{page|list|detail|add|update|delete|batchDelete}
| 特征 | 说明 |
|---|---|
| 无 status 列 | 表结构无状态字段，不声明 Status 接口 |
| 租户级 | 各租户独立友链 |
| URL 字段 | website/site/url 等列不作模糊筛选列（生成器 isUrlField 判定） |
标准 CRUD 模式的教学价值
两个模块都是"最小差异"的标准形态——新模块开发可直接对照：
差异只体现在：
* SerializeMaps（status → notice_status）
* LikeFields/EqFields 筛选声明
* FileFields/ContentFields（如有文件/富文本列）
* 有无 Status 接口（看表有无 status 列）
其余七件套结构与 example 模块完全一致（见第 3 章）。
管理建议
- 公告状态用于"草稿/下架"语义（禁用后前端不展示）
- 友链删除无守卫（软删可恢复）；批量删除支持勾选操作
- 两者均为租户级——平台统一公告场景需在租户维度分别维护（或扩展平台共享行 tenant_id=0，需业务确认）