gubersail-platform-ui/公告模块字段验证规则.md

公告模块字段验证规则

API接口地址

公告管理接口

• 新增公告: POST /api/blade-factory/api/factory/notice/add
• 修改公告: POST /api/blade-factory/api/factory/notice/update

公告分类管理接口

• 新增分类: POST /api/blade-factory/api/factory/notice/category/add
• 修改分类: POST /api/blade-factory/api/factory/notice/category/update

---

1. 公告管理模块

1.1 公告标题 (title)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入公告标题"

1.2 分类 (categoryId)

• 字段类型: String (选择器)
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请选择分类"

1.3 组织名称 (orgName)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织名称"

1.4 组织ID (orgId)

• 字段类型: Number
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织ID"

1.5 组织编码 (orgCode)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织编码"
  • 格式验证: pattern: /^[A-Za-z0-9_]+$/
  • 格式错误提示: "组织编码只能包含大写字母、数字和下划线"

1.6 可见角色 (visibleRoles)

• 字段类型: Array (多选)
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请选择可见角色"
• 可选值:
  • 1: 工厂
  • 2: 经销商
  • 4: 零售商

1.7 公告内容 (content)

• 字段类型: String (富文本编辑器)
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入公告内容"

1.8 状态 (status)

• 字段类型: Number (选择器)
• 验证规则: 无强制验证
• 可选值:
  • 0: 草稿
  • 1: 已发布
  • 2: 已下架

1.9 备注 (remark)

• 字段类型: String (文本域)
• 验证规则: 无强制验证

1.10 品牌范围 (brandScope)

• 字段类型: Object (JSON)
• 验证规则: 无强制验证

1.11 客户黑名单 (customerBlacklist)

• 字段类型: Array
• 验证规则: 无强制验证

2. 公告分类管理模块

2.1 分类名称 (name)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入分类名称"
  • 长度限制: min: 2, max: 50
  • 长度错误提示: "分类名称长度在2到50个字符"

2.2 组织名称 (orgName)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织名称"

2.3 组织编码 (orgCode)

• 字段类型: String
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织编码"
  • 格式验证: pattern: /^[A-Z0-9_]+$/
  • 格式错误提示: "组织编码只能包含大写字母、数字和下划线"

2.4 组织ID (orgId)

• 字段类型: Number
• 验证规则:
  • 必填项: required: true
  • 错误提示: "请输入组织ID"

2.5 排序 (sortOrder)

• 字段类型: Number
• 验证规则:
  • 数值类型: type: "number"
  • 数值范围: min: 0, max: 9999
  • 错误提示: "排序值范围为0-9999"
• 默认值: 0

2.6 状态 (status)

• 字段类型: Number (选择器)
• 验证规则: 无强制验证
• 可选值:
  • 0: 禁用
  • 1: 启用
• 默认值: 1

2.7 备注 (remark)

• 字段类型: String (文本域)
• 验证规则:
  • 最大长度: max: 100
  • 错误提示: "备注不能超过100个字符"

2.8 分类类型 (isSystem)

• 字段类型: Number
• 验证规则: 无强制验证
• 说明: 仅显示，新增和编辑时不显示
• 可选值:
  • 0: 否
  • 1: 是