Files
dacli/src/commands/datasource/delete.ts
T
ssw df213fdfad fix(dacli-docs): 修审计报告 14 项 + 加 CI 校验防再漂 (P0/P1/P2 全清)
审计报告 docs/dacli-doc-audit-report.md 14 项全部采纳:

P0 (3 项事实错误, 直接误导 AI 执行):
- ANTI_PATTERN F_→f_ 前缀 (form update --fields 实际是小写)
- ANTI_PATTERN AP-fc-4 vs AP-fu-1 矛盾 (统一指向 form import --autoTable)
- ANTI_PATTERN form info <enCode> 误导 (改为 <id>, 加 enCode 自动解析 fallback)

P1 (3 项文档漂移):
- CLAUDE.md "含 FK 时必用 --fields" → 实际已废弃, 删除 + form/create.ts Commander 加 DEPRECATED
- doc/get.ts 引用 Java DocCommand.java → 改指 TS _parser.ts
- AP-fd-1 "--cascade 必带" 过度约束 → 改为可选

P2 (2 项衔接断裂):
- Source 路径 web/.../ → web/apps/jnpf-web-apps-main/src/ (73 文件)
- test/run TC-B 前置提示 (需 menu 挂载)

附加 (CI script 抓出的 8 条额外路径 drift, 已就近修正):
- di/create|export|copy: DataInterfaceController.java 路径补 jnpf-java-boot/ + jnpf/base/controller/
- print/delete|update: PrintDevController.java 同上
- org/create: OrganizeController.java 路径 jnpf/controller/ → jnpf/permission/controller/
- form/codegen|audit: FormGenerator/FormGenerator.vue 加 /components/ + /src/ 前缀
- workflow/create: flowEngine + FlowProcess 加 views/onlineDev/ + components/ 前缀
- workflow/syncForm: FlowableProcessDesigner.vue 不存在 → 改指 Form.vue
- msg/notice*: notice.ts 不存在 → 改指 msgMonitor.ts
- bigscreen/delete|update: 双前缀 web/.../src/jnpf-web-datascreen-vue3/ → jnpf/前端/
- app/login: api/auth.ts → api/core/auth.ts
- apis/refresh|status|info: Java ApiService 路径 → TS 化指向
- test/render: sysData/formDesign 加 views/ 前缀
- form/create: formDesign/Form.vue 加 views/onlineDev/ 前缀

Task 1.6 收尾: 删 core/help.ts legacy (~85 行 dead code):
- AI_FLAGS / getMeta / maybeInterceptAiHelp / renderAiHelp
- installAiHelpHook alias / _aiMeta 副作用 / AiHelp type alias

新增 docs/doc-drift-findings-2026-07-24.md (2 条无法自动修复的 docs 路径, 待人工)

新增 scripts/check-doc-drift.ts (scripts/check-doc-drift.ts, 218 行):
- 4 类检查: 命令引用 / arg-opt 一致性 / source 路径 / ANTI_PATTERNS 命令引用
- 接入 npm run doc:check
- 验证: 修复前 21 处 drift → 修复后 2 处 (已归档)

测试: typecheck 0 errors, 387/387 tests pass, doc:check 报告 2 known issues
2026-07-24 16:33:31 +08:00

69 lines
2.6 KiB
TypeScript

/**
* commands/datasource/delete.ts — 删除数据源
*
* v0.11+ Phase 2 (2026-06-25): 改用 webapi 镜像 (loadDataSource.delDataSource)
* 替代 v0.10 直接 c.del('/system/DataSource/{id}')
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
import { installHelpHook } from '../../core/help.ts'
import { log } from '../../core/log.ts'
import { initWebapi, loadDataSource } from '../../webapi/dataSource.ts'
import { setupOutputFilter, addOutputOptions, wrapCommand } from '../_output_filter.ts' // v2.1+ (2026-07-21): 输出过滤 + CommandLog 落盘 (delete 历史可追溯); v2.2+ wrapCommand helper 收口 5c 样板
interface DeleteOpts {
id: string
yes?: boolean
/** v2.1+ (2026-07-21): --verbose / --json (CommandLog 落盘对应字段) */
verbose?: boolean
json?: boolean
}
export function buildDatasourceDeleteCommand(): Command {
const cmd = new Command('delete')
.description('删除数据源')
.requiredOption('--id <id>', '数据源 id')
.option('--yes', '跳过确认', false)
addOutputOptions(cmd)
.action(async (opts: DeleteOpts) => {
// 输出过滤: 默认静默
setupOutputFilter(opts)
const c = await JnpfClient.fromToken()
await wrapCommand({
command: 'datasource delete',
appCode: c.appCode,
startTime: Date.now(),
verbose: opts.verbose,
json: opts.json,
fixes: [],
}, async (ctx) => {
if (!opts.yes) {
return ctx.fail(`即将删除数据源 id=${opts.id}, 加 --yes 跳过确认`, { id: opts.id })
}
await initWebapi(c)
const r = (await loadDataSource.delDataSource(opts.id)) as { code?: number; msg?: string }
if (r.code !== undefined && r.code !== 200) {
const errMsg = `datasource delete 失败: ${r.msg}`
log.error(errMsg)
ctx.fail(errMsg, { id: opts.id })
return
}
log.info(`✓ 数据源 id=${opts.id} 已删除`)
ctx.success({ id: opts.id })
})
})
installHelpHook(cmd, {
purpose: '删除数据源 (硬删, 无回收)',
required: { '--id': '数据源 id', '--yes': '跳过确认' },
example: 'dacli datasource delete --id=1234567890 --yes',
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataSource/index.vue',
api: 'DELETE /api/system/DataSource/{id}',
ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataSource.ts:24 delDataSource()',
},
notes: ['v0.11+ 改用 webapi 镜像', '删除后该数据源上的所有业务库表无法访问', '谨慎操作'],
})
return cmd
}