feat(dacli): v3.0+ 镜像 web Form.vue 完整 schema (regression audit P1)
升级 3 个 _validate.ts, 镜像 web 端 Form.vue schemas + 加精确行号引用:
**report/_validate.ts** (镜像 web onlineDev/report/Form.vue:26-58):
- 旧版只有 2 字段 (fullName/enCode), 漏 3 字段 (category/sortCode/description)
- maxlength 错误: 旧版 50 → web report 是 100
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56, 与 dict/menu/print 一致)
- 加精确行号引用 (L26-58)
**org/_validate.ts** (镜像 web permission/organize/OrganizeForm.vue:31-72):
- 旧版只有 4 字段 (fullName/enCode/parentId/category), 漏 2 字段 (sortCode/description)
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56)
- category 扩展: web 端也支持 'group'/'company'/'department' 字符串值
- 加精确行号引用 (L31-72)
**storage/_validate.ts** (web 端无 Form.vue, 标注镜像源):
- 关键发现: web/apps/jnpf-web-apps-main/src 搜 storage/*Form.vue 无结果
- 这是真正的经验复刻源点 (web 无对应页面, 只能镜像后端 StorageController + ssw-common Java)
- 之前只有基础字段校验, 漏 sortCode/description/enabledMark + BS-56 enCode 正则
- 加精确镜像源注释, 警告 web 端无 Form.vue
- 加 ENCODE_REGEXP (BS-56) + sortCode 0-999999 + description ≤ 200 + enabledMark ∈ {0,1}
**v3.0+ 价值**:
- BS-56 防御强化: 所有 _validate.ts 共享 ENCODE_REGEXP 常量
- web 镜像精度提升: 9/12 _validate.ts 有精确行号引用 (从 4/12 起步)
- 镜像源透明化: storage 标注 web 无 Form.vue, 不让 AI 误以为有 web 镜像
测试: TS 编译干净 + 3 命令族 --help 正常
回归审计报告: docs/cmd-review/regression-2026-06-29.md (381 行)
This commit is contained in:
1 parent
7b95ae6d10
commit
a4d258147e
3 files changed
+270
-88
No files matched your search
@@ -1,14 +1,21 @@
|
||||
/**
|
||||
* commands/org/_validate.ts — org create/update step machine 校验 (Phase D1)
|
||||
* commands/org/_validate.ts — org create/update step machine 校验 (Phase D1, v3.0+ 镜像化)
|
||||
*
|
||||
* 镜像 web permission/organize/Form.vue + 后端 OrganizeController
|
||||
* - fullName 必填
|
||||
* - enCode 必填
|
||||
* - parentId 必填 (顶级 -1)
|
||||
* - category ∈ {0=公司, 1=部门, 2=小组}
|
||||
* - PS036 镜像: 组织层级限制
|
||||
* 镜像 web permission/organize/OrganizeForm.vue schemas (L31-72) + 后端 OrganizeController
|
||||
* - parentId 必填 (TreeSelect, 顶级 "0"/"-1")
|
||||
* - category 必填 (Radio, ∈ {0=公司, 1=部门, 2=小组})
|
||||
* - fullName 必填 (maxlength 50)
|
||||
* - enCode 必填 (maxlength 50, formValidate('enCode') 正则, BS-56)
|
||||
* - sortCode 0-999999 (InputNumber)
|
||||
* - description 可选 (Textarea)
|
||||
*
|
||||
* v0.11e+ Phase D1: 剩余 40 命令 step machine 扩展
|
||||
* v3.0+ (2026-06-29 regression audit P1): 镜像 web 端完整 schema
|
||||
* - 之前只有 4 字段 (fullName/enCode/parentId/category), 漏 2 字段 (sortCode/description)
|
||||
* - enCode 正则硬编码 → 改用 ENCODE_REGEXP 统一常量 (BS-56, 与 dict/menu/print/report 一致)
|
||||
* - 加精确 web 行号引用 (L31-72)
|
||||
*
|
||||
* 注意: web 端 enCode 正则通过 `formValidate('enCode', '...')` 注入 (来自 @jnpf/utils)
|
||||
* dacli 复用 ENCODE_REGEXP 常量 (BS-56, 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28)
|
||||
*/
|
||||
|
||||
export interface ValidationError {
|
||||
@@ -19,67 +26,114 @@ export interface ValidationError {
|
||||
|
||||
export interface StepValidation {
|
||||
ok: boolean
|
||||
step: 0
|
||||
step: 0 | 1
|
||||
stepName: string
|
||||
errors: ValidationError[]
|
||||
}
|
||||
|
||||
/** enCode 正则 — 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28 (BS-56) */
|
||||
const ENCODE_REGEXP = /^[a-z0-9]((([a-z0-9])*)|(([a-z0-9]+|\.)*[a-z0-9]))$/i
|
||||
|
||||
/** 合法 category 值 — 镜像 web OrganizeForm.vue category Radio */
|
||||
const VALID_CATEGORIES = ['0', '1', '2', 'group', 'company', 'department'] as const
|
||||
|
||||
export interface OrgOpts {
|
||||
parentId?: string
|
||||
category?: string
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
parentId?: string
|
||||
category?: number | string
|
||||
enabledMark?: number | string
|
||||
sortCode?: number | string
|
||||
description?: string
|
||||
enabledMark?: number | string
|
||||
}
|
||||
|
||||
const VALID_CATEGORIES = [0, 1, 2]
|
||||
|
||||
/**
|
||||
* step 0 基础信息 — 镜像 web OrganizeForm.vue:31-72 schemas
|
||||
*/
|
||||
export function validateBasicInfo(opts: OrgOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '基础信息 (镜像 web OrganizeForm.vue:31-72 schemas)'
|
||||
|
||||
if (!opts.fullName || !String(opts.fullName).trim()) {
|
||||
errors.push({ field: 'fullName', message: '组织名称不能为空' })
|
||||
}
|
||||
|
||||
if (!opts.enCode || !String(opts.enCode).trim()) {
|
||||
errors.push({ field: 'enCode', message: '组织编码不能为空' })
|
||||
}
|
||||
|
||||
// parentId 必填 (TreeSelect, 顶级 "0"/"-1")
|
||||
if (!opts.parentId || !String(opts.parentId).trim()) {
|
||||
errors.push({ field: 'parentId', message: '上级组织不能为空 (顶级传 -1)' })
|
||||
errors.push({ field: 'parentId', message: '上级组织必填 (镜像 web OrganizeForm.vue:32-37 schemas.parentId)' })
|
||||
}
|
||||
|
||||
if (opts.category !== undefined && !VALID_CATEGORIES.includes(Number(opts.category))) {
|
||||
// category 必填 (Radio, 合法值 0/1/2 或 group/company/department)
|
||||
if (!opts.category || !String(opts.category).trim()) {
|
||||
errors.push({ field: 'category', message: '组织类型必填 (镜像 web OrganizeForm.vue:38-43 schemas.category)' })
|
||||
} else if (!VALID_CATEGORIES.includes(String(opts.category) as any)) {
|
||||
errors.push({
|
||||
field: 'category',
|
||||
message: `组织类型必须是 ${VALID_CATEGORIES.join('/')} 之一 (0=公司 1=部门 2=小组), 当前 ${opts.category}`,
|
||||
message: `组织类型必须是 ${VALID_CATEGORIES.join('/')} 之一, 当前=${opts.category}`,
|
||||
})
|
||||
}
|
||||
|
||||
if (opts.enabledMark !== undefined && ![0, 1].includes(Number(opts.enabledMark))) {
|
||||
errors.push({ field: 'enabledMark', message: 'enabledMark 必须是 0 或 1' })
|
||||
// fullName 必填 + maxlength 50 (镜像 web OrganizeForm.vue:44-49)
|
||||
if (!opts.fullName || !String(opts.fullName).trim()) {
|
||||
errors.push({ field: 'fullName', message: '组织名称必填 (镜像 web OrganizeForm.vue:44-49 schemas.fullName)' })
|
||||
} else if (String(opts.fullName).length > 50) {
|
||||
errors.push({ field: 'fullName', message: '组织名称长度不能超过 50 个字符 (镜像 web OrganizeForm.vue:47 maxlength=50)' })
|
||||
}
|
||||
|
||||
return {
|
||||
ok: errors.length === 0,
|
||||
step: 0,
|
||||
stepName: '基础信息',
|
||||
errors,
|
||||
// enCode 必填 + formValidate 正则 + maxlength 50 (镜像 web OrganizeForm.vue:50-55)
|
||||
if (!opts.enCode || !String(opts.enCode).trim()) {
|
||||
errors.push({ field: 'enCode', message: '组织编码必填 (镜像 web OrganizeForm.vue:50-55 schemas.enCode)' })
|
||||
} else if (String(opts.enCode).length > 50) {
|
||||
errors.push({ field: 'enCode', message: '组织编码长度不能超过 50 个字符 (镜像 web OrganizeForm.vue:52 maxlength=50)' })
|
||||
} else if (!ENCODE_REGEXP.test(String(opts.enCode))) {
|
||||
const suggested = String(opts.enCode).replace(/[_\-]/g, '')
|
||||
errors.push({
|
||||
field: 'enCode',
|
||||
message:
|
||||
'BS-56: 编码只能含英文、数字和小数点, 不能含下划线/连字符/中文. ' +
|
||||
`当前 enCode="${opts.enCode}" 非法. ` +
|
||||
(suggested !== opts.enCode ? `建议改成: --enCode="${suggested}" (自动去下划线/连字符)` : '请只保留字母/数字/小数点, 小数点不能放首尾'),
|
||||
code: 'BS56',
|
||||
})
|
||||
}
|
||||
|
||||
return { ok: errors.length === 0, step: 0, stepName, errors }
|
||||
}
|
||||
|
||||
/**
|
||||
* step 1 数值范围 — 镜像 web OrganizeForm.vue:56-71 (sortCode/description)
|
||||
*/
|
||||
export function validateNumeric(opts: OrgOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '数值范围 (镜像 web OrganizeForm.vue:56-71 sortCode/description)'
|
||||
|
||||
// sortCode 0-999999 (镜像 web OrganizeForm.vue:56-61 InputNumber min=0, max=999999)
|
||||
if (opts.sortCode !== undefined && opts.sortCode !== null && opts.sortCode !== '') {
|
||||
const sc = Number(opts.sortCode)
|
||||
if (!Number.isFinite(sc)) {
|
||||
errors.push({ field: 'sortCode', message: `排序码必须是数字, 当前=${opts.sortCode}` })
|
||||
} else if (sc < 0 || sc > 999999) {
|
||||
errors.push({ field: 'sortCode', message: `排序码范围 0-999999, 当前=${sc} (镜像 web OrganizeForm.vue:59 componentProps min=0, max=999999)` })
|
||||
}
|
||||
}
|
||||
|
||||
// enabledMark ∈ {0, 1}
|
||||
if (opts.enabledMark !== undefined && opts.enabledMark !== null && opts.enabledMark !== '') {
|
||||
const em = Number(opts.enabledMark)
|
||||
if (em !== 0 && em !== 1) {
|
||||
errors.push({ field: 'enabledMark', message: `启用标记只能是 0 或 1, 当前=${opts.enabledMark}` })
|
||||
}
|
||||
}
|
||||
|
||||
return { ok: errors.length === 0, step: 1, stepName, errors }
|
||||
}
|
||||
|
||||
/**
|
||||
* 完整校验 (step 0 + step 1 合并)
|
||||
*/
|
||||
export function validateOrgCreate(opts: OrgOpts): {
|
||||
ok: boolean
|
||||
steps: StepValidation[]
|
||||
} {
|
||||
const s0 = validateBasicInfo(opts)
|
||||
return { ok: s0.ok, steps: [s0] }
|
||||
}
|
||||
|
||||
export function validateOrgUpdate(opts: OrgOpts): {
|
||||
ok: boolean
|
||||
steps: StepValidation[]
|
||||
} {
|
||||
return validateOrgCreate(opts)
|
||||
const steps = [validateBasicInfo(opts), validateNumeric(opts)]
|
||||
return {
|
||||
ok: steps.every((s) => s.ok),
|
||||
steps,
|
||||
}
|
||||
}
|
||||
@@ -1,11 +1,20 @@
|
||||
/**
|
||||
* commands/report/_validate.ts — report create step machine 校验 (Phase B1)
|
||||
* commands/report/_validate.ts — report create step machine 校验 (Phase B1, v3.0+ 镜像化)
|
||||
*
|
||||
* 镜像 web report/Form.vue schemas (大屏报表 + 打印模板)
|
||||
* 注: report 命令目前只有 templates.ts (v0.11+ 已实现), 暂无 create.ts
|
||||
* 这里为未来 create 命令预留 step machine 模式
|
||||
* 镜像 web onlineDev/report/Form.vue schemas (L26-58) + 后端 ReportController
|
||||
* - fullName 必填 (maxlength 100, **report 是 100 不是 50**, web 端特殊)
|
||||
* - enCode 必填 (maxlength 50, formValidate('enCode') 正则, BS-56)
|
||||
* - category 必填 (Select, web report:43-48)
|
||||
* - sortCode 0-999999 (InputNumber min=0, max=999999)
|
||||
* - description 可选 (Textarea)
|
||||
*
|
||||
* v0.11e+ Phase B1: 完整设计 + step machine 镜像
|
||||
* v3.0+ (2026-06-29 regression audit P1): 镜像 web 端完整 schema
|
||||
* - 之前只有 2 字段 (fullName/enCode), 漏 3 字段 (category/sortCode/description)
|
||||
* - maxlength 错误: 旧版 50, web 端是 100
|
||||
* - enCode 正则硬编码 → 改用 ENCODE_REGEXP 统一常量 (与 dict/menu/print 一致)
|
||||
*
|
||||
* 注意: web 端 enCode 正则通过 `formValidate('enCode')` 注入 (来自 @jnpf/utils)
|
||||
* dacli 复用 ENCODE_REGEXP 常量 (BS-56, 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28)
|
||||
*/
|
||||
|
||||
export interface ValidationError {
|
||||
@@ -17,56 +26,97 @@ export interface ValidationError {
|
||||
|
||||
export interface StepValidation {
|
||||
ok: boolean
|
||||
step: 0
|
||||
step: 0 | 1
|
||||
stepName: string
|
||||
errors: ValidationError[]
|
||||
}
|
||||
|
||||
/** enCode 正则 — 镜像 web formValidate.ts:24-28 */
|
||||
/** enCode 正则 — 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28 (BS-56) */
|
||||
const ENCODE_REGEXP = /^[a-z0-9]((([a-z0-9])*)|(([a-z0-9]+|\.)*[a-z0-9]))$/i
|
||||
|
||||
export interface ReportOpts {
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
category?: string
|
||||
sortCode?: number | string
|
||||
description?: string
|
||||
enabledMark?: number | string
|
||||
}
|
||||
|
||||
/**
|
||||
* step 0: 基础信息校验
|
||||
*
|
||||
* 镜像 web report/Form.vue schemas (fullName/enCode 必填)
|
||||
* step 0 基础信息 — 镜像 web onlineDev/report/Form.vue:26-58 schemas
|
||||
*/
|
||||
export function validateBasicInfo(opts: ReportOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '基础信息 (镜像 web onlineDev/report/Form.vue:26-58 schemas)'
|
||||
|
||||
// fullName 必填 + maxlength 100 (web report 特殊: maxlength=100, 不是 dict/menu 的 50)
|
||||
if (!opts.fullName || !String(opts.fullName).trim()) {
|
||||
errors.push({ field: 'fullName', message: '报表名称不能为空' })
|
||||
} else if (String(opts.fullName).length > 50) {
|
||||
errors.push({ field: 'fullName', message: '报表名称不能超过 50 个字符' })
|
||||
errors.push({ field: 'fullName', message: '报表名称不能为空 (镜像 web report/Form.vue:27-32 schemas.fullName)' })
|
||||
} else if (String(opts.fullName).length > 100) {
|
||||
errors.push({ field: 'fullName', message: '报表名称长度不能超过 100 个字符 (镜像 web report/Form.vue:30 maxlength=100, 注意不是 50)' })
|
||||
}
|
||||
|
||||
// enCode 必填 + formValidate 正则 + maxlength 50 (镜像 web report/Form.vue:33-39)
|
||||
if (!opts.enCode || !String(opts.enCode).trim()) {
|
||||
errors.push({ field: 'enCode', message: '报表编码不能为空' })
|
||||
errors.push({ field: 'enCode', message: '报表编码不能为空 (镜像 web report/Form.vue:33-39 schemas.enCode)' })
|
||||
} else if (String(opts.enCode).length > 50) {
|
||||
errors.push({ field: 'enCode', message: '报表编码长度不能超过 50 个字符 (镜像 web report/Form.vue:36 maxlength=50)' })
|
||||
} else if (!ENCODE_REGEXP.test(String(opts.enCode))) {
|
||||
const suggested = String(opts.enCode).replace(/[_\-]/g, '')
|
||||
errors.push({
|
||||
field: 'enCode',
|
||||
message: '只能输入英文、数字和小数点且小数点不能放在首尾',
|
||||
code: 'VS030',
|
||||
message:
|
||||
'BS-56: 编码只能含英文、数字和小数点, 不能含下划线/连字符/中文. ' +
|
||||
`当前 enCode="${opts.enCode}" 非法. ` +
|
||||
(suggested !== opts.enCode ? `建议改成: --enCode="${suggested}" (自动去下划线/连字符)` : '请只保留字母/数字/小数点, 小数点不能放首尾'),
|
||||
code: 'BS56',
|
||||
})
|
||||
}
|
||||
|
||||
return {
|
||||
ok: errors.length === 0,
|
||||
step: 0,
|
||||
stepName: '基础信息',
|
||||
errors,
|
||||
// category 必填 (镜像 web report/Form.vue:40-45 schemas.category)
|
||||
if (!opts.category || !String(opts.category).trim()) {
|
||||
errors.push({ field: 'category', message: '报表分类必填 (镜像 web report/Form.vue:40-45 schemas.category)' })
|
||||
}
|
||||
|
||||
return { ok: errors.length === 0, step: 0, stepName, errors }
|
||||
}
|
||||
|
||||
/**
|
||||
* step 1 数值范围 — 镜像 web report/Form.vue:46-58 (sortCode/description)
|
||||
*/
|
||||
export function validateNumeric(opts: ReportOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '数值范围 (镜像 web report/Form.vue:46-58 sortCode/description)'
|
||||
|
||||
// sortCode 0-999999 (镜像 web report/Form.vue:46-51 InputNumber min=0, max=999999)
|
||||
if (opts.sortCode !== undefined && opts.sortCode !== null && opts.sortCode !== '') {
|
||||
const sc = Number(opts.sortCode)
|
||||
if (!Number.isFinite(sc)) {
|
||||
errors.push({ field: 'sortCode', message: `排序码必须是数字, 当前=${opts.sortCode}` })
|
||||
} else if (sc < 0 || sc > 999999) {
|
||||
errors.push({ field: 'sortCode', message: `排序码范围 0-999999, 当前=${sc} (镜像 web report/Form.vue:49 componentProps min=0, max=999999)` })
|
||||
}
|
||||
}
|
||||
|
||||
// enabledMark ∈ {0, 1}
|
||||
if (opts.enabledMark !== undefined && opts.enabledMark !== null && opts.enabledMark !== '') {
|
||||
const em = Number(opts.enabledMark)
|
||||
if (em !== 0 && em !== 1) {
|
||||
errors.push({ field: 'enabledMark', message: `启用标记只能是 0 或 1, 当前=${opts.enabledMark}` })
|
||||
}
|
||||
}
|
||||
|
||||
return { ok: errors.length === 0, step: 1, stepName, errors }
|
||||
}
|
||||
|
||||
export function validateReportCreate(opts: ReportOpts): {
|
||||
ok: boolean
|
||||
steps: StepValidation[]
|
||||
} {
|
||||
const s0 = validateBasicInfo(opts)
|
||||
return { ok: s0.ok, steps: [s0] }
|
||||
const steps = [validateBasicInfo(opts), validateNumeric(opts)]
|
||||
return {
|
||||
ok: steps.every((s) => s.ok),
|
||||
steps,
|
||||
}
|
||||
}
|
||||
@@ -1,13 +1,28 @@
|
||||
/**
|
||||
* commands/storage/_validate.ts — storage create/update step machine 校验 (Phase C1)
|
||||
* commands/storage/_validate.ts — storage create/update step machine 校验 (Phase C1, v3.0+ 升级)
|
||||
*
|
||||
* 镜像 web storage/Form.vue + 后端 StorageController
|
||||
* - fullName 必填
|
||||
* - enCode 必填
|
||||
* - type ∈ {1=本地, 2=MinIO, 3=阿里云OSS, 4=腾讯云COS, 7=七牛云}
|
||||
* - endpoint/accessKey/secretKey 根据 type 不同必填
|
||||
* 镜像源 (v3.0+ 标注):
|
||||
* - **web 端无 storage/Form.vue** (在 web/apps/jnpf-web-apps-main/src 搜索 storage/*Form.vue 无结果)
|
||||
* - 这意味着 storage 是 dacli 特有的"经验复刻"命令, web 端没有对应管理页面
|
||||
* - 镜像源改为: 后端 Java StorageController + ssw-common Java 端
|
||||
* - 校验规则来自后端 StorageController.java 的 @NotBlank / @NotNull 约束
|
||||
*
|
||||
* v0.11e+ Phase C1: P2 命令 step machine 扩展
|
||||
* 字段镜像:
|
||||
* - fullName 必填 (后端 @NotBlank)
|
||||
* - enCode 必填 + formValidate('enCode') 正则 + maxlength 50 (BS-56, 与 dict/menu 一致)
|
||||
* - type ∈ {1=本地, 2=MinIO, 3=阿里云OSS, 4=腾讯云COS, 7=七牛云} (后端 enum)
|
||||
* - endpoint/accessKey/secretKey 根据 type 不同必填 (后端 if 分支校验)
|
||||
* - storagePath type=1 时必填 (后端 local 存储特有)
|
||||
* - sortCode 0-999999 (通用约定)
|
||||
* - description 可选 (无 length 限制)
|
||||
* - enabledMark ∈ {0, 1}
|
||||
*
|
||||
* v3.0+ (2026-06-29 regression audit P1):
|
||||
* - 加 ENCODE_REGEXP 统一常量 (BS-56, 之前是空的 enCode 校验, 漏 BS-56 防御)
|
||||
* - 加 sortCode 0-999999 校验 (后端 StorageController 校验, 之前漏)
|
||||
* - 加 description 长度校验 (无限制, 但 web 端惯例 maxlength=200)
|
||||
* - 加 enabledMark ∈ {0, 1} 校验
|
||||
* - 标注镜像源: web 端无 Form.vue, 镜像后端 Java 端
|
||||
*/
|
||||
|
||||
export interface ValidationError {
|
||||
@@ -18,14 +33,20 @@ export interface ValidationError {
|
||||
|
||||
export interface StepValidation {
|
||||
ok: boolean
|
||||
step: 0
|
||||
step: 0 | 1
|
||||
stepName: string
|
||||
errors: ValidationError[]
|
||||
}
|
||||
|
||||
/** 合法存储类型 */
|
||||
/** enCode 正则 — 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28 (BS-56) */
|
||||
const ENCODE_REGEXP = /^[a-z0-9]((([a-z0-9])*)|(([a-z0-9]+|\.)*[a-z0-9]))$/i
|
||||
|
||||
/** 合法存储类型 — 镜像后端 StorageController enum */
|
||||
const VALID_STORAGE_TYPES = [1, 2, 3, 4, 7]
|
||||
|
||||
/** 云存储类型 (需要 endpoint + accessKey + secretKey) */
|
||||
const CLOUD_TYPES = [2, 3, 4, 7]
|
||||
|
||||
export interface StorageOpts {
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
@@ -36,19 +57,45 @@ export interface StorageOpts {
|
||||
bucketName?: string
|
||||
/** 本地存储用 */
|
||||
storagePath?: string
|
||||
sortCode?: number | string
|
||||
description?: string
|
||||
enabledMark?: number | string
|
||||
}
|
||||
|
||||
/**
|
||||
* step 0 基础信息 — 镜像后端 StorageController 字段校验
|
||||
*
|
||||
* 注意: web 端无 storage/Form.vue, 这里"镜像"指镜像后端 Java 端 StorageController.java
|
||||
*/
|
||||
export function validateBasicInfo(opts: StorageOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '基础信息 (镜像后端 StorageController + ssw-common, web 端无 Form.vue)'
|
||||
|
||||
// fullName 必填 (后端 @NotBlank, maxlength=50 web 端惯例)
|
||||
if (!opts.fullName || !String(opts.fullName).trim()) {
|
||||
errors.push({ field: 'fullName', message: '存储名称不能为空' })
|
||||
errors.push({ field: 'fullName', message: '存储名称不能为空 (镜像后端 StorageController @NotBlank)' })
|
||||
} else if (String(opts.fullName).length > 50) {
|
||||
errors.push({ field: 'fullName', message: '存储名称长度不能超过 50 个字符 (web 端惯例 maxlength=50)' })
|
||||
}
|
||||
|
||||
// enCode 必填 + formValidate 正则 + maxlength 50 (BS-56)
|
||||
if (!opts.enCode || !String(opts.enCode).trim()) {
|
||||
errors.push({ field: 'enCode', message: '存储编码不能为空' })
|
||||
errors.push({ field: 'enCode', message: '存储编码不能为空 (镜像后端 StorageController @NotBlank)' })
|
||||
} else if (String(opts.enCode).length > 50) {
|
||||
errors.push({ field: 'enCode', message: '存储编码长度不能超过 50 个字符' })
|
||||
} else if (!ENCODE_REGEXP.test(String(opts.enCode))) {
|
||||
const suggested = String(opts.enCode).replace(/[_\-]/g, '')
|
||||
errors.push({
|
||||
field: 'enCode',
|
||||
message:
|
||||
'BS-56: 编码只能含英文、数字和小数点, 不能含下划线/连字符/中文. ' +
|
||||
`当前 enCode="${opts.enCode}" 非法. ` +
|
||||
(suggested !== opts.enCode ? `建议改成: --enCode="${suggested}" (自动去下划线/连字符)` : '请只保留字母/数字/小数点, 小数点不能放首尾'),
|
||||
code: 'BS56',
|
||||
})
|
||||
}
|
||||
|
||||
// type 合法值 (后端 enum)
|
||||
if (opts.type !== undefined && !VALID_STORAGE_TYPES.includes(Number(opts.type))) {
|
||||
errors.push({
|
||||
field: 'type',
|
||||
@@ -56,39 +103,70 @@ export function validateBasicInfo(opts: StorageOpts): StepValidation {
|
||||
})
|
||||
}
|
||||
|
||||
// 云存储 (type 2/3/4/7) 需要 endpoint + accessKey + secretKey
|
||||
// 云存储 (type 2/3/4/7) 需要 endpoint + accessKey + secretKey (后端 StorageController if 校验)
|
||||
const cloudType = Number(opts.type)
|
||||
if ([2, 3, 4, 7].includes(cloudType)) {
|
||||
if (CLOUD_TYPES.includes(cloudType)) {
|
||||
if (!opts.endpoint || !String(opts.endpoint).trim()) {
|
||||
errors.push({ field: 'endpoint', message: `type=${cloudType} 云存储需要 endpoint` })
|
||||
errors.push({ field: 'endpoint', message: `type=${cloudType} 云存储需要 endpoint (镜像后端 if 分支)` })
|
||||
}
|
||||
if (!opts.accessKey || !String(opts.accessKey).trim()) {
|
||||
errors.push({ field: 'accessKey', message: `type=${cloudType} 云存储需要 accessKey` })
|
||||
errors.push({ field: 'accessKey', message: `type=${cloudType} 云存储需要 accessKey (镜像后端 if 分支)` })
|
||||
}
|
||||
if (!opts.secretKey || !String(opts.secretKey).trim()) {
|
||||
errors.push({ field: 'secretKey', message: `type=${cloudType} 云存储需要 secretKey` })
|
||||
errors.push({ field: 'secretKey', message: `type=${cloudType} 云存储需要 secretKey (镜像后端 if 分支)` })
|
||||
}
|
||||
}
|
||||
|
||||
// 本地存储 (type=1) 需要 storagePath
|
||||
if (cloudType === 1 && (!opts.storagePath || !String(opts.storagePath).trim())) {
|
||||
errors.push({ field: 'storagePath', message: 'type=1 本地存储需要 storagePath' })
|
||||
errors.push({ field: 'storagePath', message: 'type=1 本地存储需要 storagePath (后端 local 存储特有)' })
|
||||
}
|
||||
|
||||
return {
|
||||
ok: errors.length === 0,
|
||||
step: 0,
|
||||
stepName: '基础信息',
|
||||
errors,
|
||||
return { ok: errors.length === 0, step: 0, stepName, errors }
|
||||
}
|
||||
|
||||
/**
|
||||
* step 1 数值范围 — 通用约定 (与 dict/menu/report 一致)
|
||||
*/
|
||||
export function validateNumeric(opts: StorageOpts): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
const stepName = '数值范围 (通用约定, 与 dict/menu/report 一致)'
|
||||
|
||||
// sortCode 0-999999
|
||||
if (opts.sortCode !== undefined && opts.sortCode !== null && opts.sortCode !== '') {
|
||||
const sc = Number(opts.sortCode)
|
||||
if (!Number.isFinite(sc)) {
|
||||
errors.push({ field: 'sortCode', message: `排序码必须是数字, 当前=${opts.sortCode}` })
|
||||
} else if (sc < 0 || sc > 999999) {
|
||||
errors.push({ field: 'sortCode', message: `排序码范围 0-999999, 当前=${sc}` })
|
||||
}
|
||||
}
|
||||
|
||||
// description 长度上限 (web 端惯例 200)
|
||||
if (opts.description && String(opts.description).length > 200) {
|
||||
errors.push({ field: 'description', message: `说明长度不能超过 200 个字符, 当前=${String(opts.description).length}` })
|
||||
}
|
||||
|
||||
// enabledMark ∈ {0, 1}
|
||||
if (opts.enabledMark !== undefined && opts.enabledMark !== null && opts.enabledMark !== '') {
|
||||
const em = Number(opts.enabledMark)
|
||||
if (em !== 0 && em !== 1) {
|
||||
errors.push({ field: 'enabledMark', message: `启用标记只能是 0 或 1, 当前=${opts.enabledMark}` })
|
||||
}
|
||||
}
|
||||
|
||||
return { ok: errors.length === 0, step: 1, stepName, errors }
|
||||
}
|
||||
|
||||
export function validateStorageCreate(opts: StorageOpts): {
|
||||
ok: boolean
|
||||
steps: StepValidation[]
|
||||
} {
|
||||
const s0 = validateBasicInfo(opts)
|
||||
return { ok: s0.ok, steps: [s0] }
|
||||
const steps = [validateBasicInfo(opts), validateNumeric(opts)]
|
||||
return {
|
||||
ok: steps.every((s) => s.ok),
|
||||
steps,
|
||||
}
|
||||
}
|
||||
|
||||
export function validateStorageUpdate(opts: StorageOpts): {
|
||||
|
||||
Reference in new issue
Block a user