agentworkshop 0.7.65 → 0.7.70

package/server/api/workshop/eda/charts/index.post.ts

@@ -0,0 +1,33 @@
+/**
+ * POST /api/workshop/eda/charts —— 保存图表(按用户持久化,plan1 需求 #9)。
+ * body: { title, viz_type, datasource?, encoding?, transform?, options?, line_id?, visibility? }
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { createChart } from '@/server/services/workshop/eda/chart-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  if (!String(body.title ?? '').trim()) throw new AppError(400, 'VALIDATION_ERROR' as never, 'title 必填。')
+  try {
+    const chart = createChart(user, {
+      title: String(body.title).trim().slice(0, 200),
+      vizType: String(body.viz_type ?? 'trend'),
+      datasource: (body.datasource ?? {}) as Record<string, unknown>,
+      encoding: (body.encoding ?? {}) as Record<string, unknown>,
+      transform: (body.transform ?? {}) as Record<string, unknown>,
+      options: (body.options ?? {}) as Record<string, unknown>,
+      lineId: body.line_id ? String(body.line_id) : null,
+      visibility: String(body.visibility ?? 'private'),
+    })
+    return { chart }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    const status = /仅 owner/.test(msg) ? 403 : /不存在/.test(msg) ? 404 : 400
+    throw new AppError(status, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/commonality.get.ts

@@ -0,0 +1,27 @@
+/**
+ * GET /api/workshop/eda/commonality?line_id=&factor=node|chamber|recipe|hour
+ * —— E5 坏批共性分析(lift 降序;bad 集=特征违例涉及批次)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { commonality, CommonalityError, type CommonalityFactor } from '@/server/services/workshop/eda/commonality'
+
+const FACTORS: CommonalityFactor[] = ['node', 'chamber', 'recipe', 'hour']
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const q = getQuery(event)
+  const lineId = String(q.line_id ?? '')
+  const factor = String(q.factor ?? 'node') as CommonalityFactor
+  if (!lineId) throw new AppError(400, 'VALIDATION_ERROR' as never, 'line_id 必填。')
+  if (!FACTORS.includes(factor)) throw new AppError(400, 'VALIDATION_ERROR' as never, `factor 只支持 ${FACTORS.join('/')}`)
+  try {
+    return commonality(user, { lineId, factor })
+  }
+  catch (err) {
+    if (err instanceof CommonalityError) throw new AppError(err.status, 'SCOPE_VIOLATION' as never, err.message)
+    throw err
+  }
+})

package/server/api/workshop/eda/dashboards/[id].delete.ts

@@ -0,0 +1,22 @@
+/**
+ * DELETE /api/workshop/eda/dashboards/:id(见 [id].get.ts;方法分文件)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { deleteDashboard } from '@/server/services/workshop/eda/dashboard-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  try {
+    const ok = deleteDashboard(user, id)
+    if (!ok) throw new AppError(404, 'NOT_FOUND' as never, `看板不存在: ${id}`)
+    return { deleted: true }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    throw new AppError(/仅 owner/.test(msg) ? 403 : 404, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/dashboards/[id].get.ts

@@ -0,0 +1,17 @@
+/**
+ * GET /api/workshop/eda/dashboards/:id —— 详情(内嵌 chart 逐个 B4 判定,不可见标 inaccessible)。
+ * PATCH/DELETE 走 [id].patch.ts / [id].delete.ts(Nitro 方法分文件)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { dashboardById } from '@/server/services/workshop/eda/dashboard-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const detail = dashboardById(user, id)
+  if (!detail) throw new AppError(404, 'NOT_FOUND' as never, `看板不存在或不可见: ${id}`)
+  return detail
+})

package/server/api/workshop/eda/dashboards/[id].patch.ts

@@ -0,0 +1,28 @@
+/**
+ * PATCH /api/workshop/eda/dashboards/:id —— 标题/筛选/布局/可见性(见 [id].get.ts;方法分文件)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { updateDashboard } from '@/server/services/workshop/eda/dashboard-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  try {
+    const dashboard = updateDashboard(user, id, {
+      title: body.title == null ? undefined : String(body.title).trim().slice(0, 200),
+      filters: body.filters as Record<string, unknown> | undefined,
+      layout: body.layout,
+      visibility: body.visibility == null ? undefined : String(body.visibility),
+      lineId: body.line_id === undefined ? undefined : (body.line_id ? String(body.line_id) : null),
+    })
+    return { dashboard }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    throw new AppError(/仅 owner/.test(msg) ? 403 : 400, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/dashboards/index.get.ts

@@ -0,0 +1,30 @@
+/**
+ * GET  /api/workshop/eda/dashboards?mine=1 —— 看板清单。
+ * POST /api/workshop/eda/dashboards —— 创建 {title, filters?, layout?, line_id?, visibility?}。
+ */
+import { getQuery, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { listDashboards, createDashboard } from '@/server/services/workshop/eda/dashboard-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  if (event.method === 'GET') {
+    const q = getQuery(event)
+    return { dashboards: listDashboards(user, { mine: String(q.mine ?? '') === '1' }) }
+  }
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  try {
+    return { dashboard: createDashboard(user, {
+      title: String(body.title ?? '').trim(),
+      filters: (body.filters ?? {}) as Record<string, unknown>,
+      layout: body.layout,
+      lineId: body.line_id ? String(body.line_id) : null,
+      visibility: String(body.visibility ?? 'private'),
+    }) }
+  }
+  catch (err) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, err instanceof Error ? err.message : String(err))
+  }
+})

package/server/api/workshop/eda/dashboards/index.post.ts

@@ -0,0 +1,25 @@
+/**
+ * POST /api/workshop/eda/dashboards —— 创建看板(见 index.get.ts 头注)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { createDashboard } from '@/server/services/workshop/eda/dashboard-repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  try {
+    return { dashboard: createDashboard(user, {
+      title: String(body.title ?? '').trim(),
+      filters: (body.filters ?? {}) as Record<string, unknown>,
+      layout: body.layout,
+      lineId: body.line_id ? String(body.line_id) : null,
+      visibility: String(body.visibility ?? 'private'),
+    }) }
+  }
+  catch (err) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, err instanceof Error ? err.message : String(err))
+  }
+})

package/server/api/workshop/eda/derived/index.post.ts

@@ -0,0 +1,41 @@
+/**
+ * POST /api/workshop/eda/derived —— 创建派生数据集(M3 自动数据处理落点)。
+ * body: { title?, line_id?, node_ids[], from, to, bucket_ms?, agg?, ops:[{kind,window?,period?}] }
+ * 产物 CSV/manifest 经 GET /api/workshop/daq/export-file?job=<jobId>&path=data.csv 下载。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { createDerivedDataset, DERIVED_OPS, type DerivedOp } from '@/server/services/workshop/eda/derived'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  const nodeIds = Array.isArray(body.node_ids) ? body.node_ids.map(String) : String(body.node_ids ?? '').split(',').map(s => s.trim()).filter(Boolean)
+  if (!nodeIds.length) throw new AppError(400, 'VALIDATION_ERROR' as never, 'node_ids 必填。')
+  const toMs = Number(body.to) || Date.now()
+  const fromMs = Number(body.from) || toMs - 3600_000
+  const ops = (Array.isArray(body.ops) ? body.ops : []) as DerivedOp[]
+  for (const o of ops) {
+    if (!DERIVED_OPS.includes(o.kind as never)) {
+      throw new AppError(400, 'VALIDATION_ERROR' as never, `算子 ${String(o.kind)} 不在白名单(${DERIVED_OPS.join('/')})。`)
+    }
+  }
+  try {
+    const r = await createDerivedDataset(user, {
+      lineId: body.line_id ? String(body.line_id) : undefined,
+      nodeIds,
+      fromMs,
+      toMs,
+      bucketMs: body.bucket_ms == null ? undefined : Number(body.bucket_ms),
+      agg: body.agg === 'min' || body.agg === 'max' ? body.agg : 'avg',
+      ops,
+    }, String(body.title ?? `派生集 ${new Date().toISOString().slice(0, 16)}`))
+    return r
+  }
+  catch (err) {
+    const e = err as { status?: number, message?: string }
+    throw new AppError(e.status ?? 400, 'VALIDATION_ERROR' as never, e.message ?? '派生失败')
+  }
+})

package/server/api/workshop/eda/features/index.get.ts

@@ -0,0 +1,29 @@
+/**
+ * GET /api/workshop/eda/features —— 特征仓库查询(query: run_id?/node_id?/violated?/limit?)。
+ * 无 run_id 时按产线可见性过滤(join eda_runs)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { lineMode } from '@/server/services/workshop/permissions'
+import { defineApiHandler } from '@/server/utils/response'
+import { listFeatures } from '@/server/services/workshop/eda/features'
+import { edaRunById } from '@/server/services/workshop/eda/eda-run.repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const q = getQuery(event)
+  let rows = listFeatures({
+    runId: q.run_id ? String(q.run_id) : undefined,
+    nodeId: q.node_id ? String(q.node_id) : undefined,
+    violated: q.violated == null || q.violated === '' ? undefined : String(q.violated) === '1',
+    chamber: q.chamber ? String(q.chamber) : undefined,
+    limit: Number(q.limit) || 100,
+  })
+  if (!q.run_id) {
+    rows = rows.filter((f) => {
+      const run = edaRunById(f.runId)
+      return run && lineMode(user, run.lineId) !== 'none'
+    })
+  }
+  return { features: rows, count: rows.length }
+})

package/server/api/workshop/eda/features/jobs.get.ts

@@ -0,0 +1,13 @@
+/**
+ * GET /api/workshop/eda/features/jobs —— 特征任务账本(eda_feature_jobs)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { listFeatureJobs } from '@/server/services/workshop/eda/features'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const q = getQuery(event)
+  return { jobs: listFeatureJobs(Number(q.limit) || 50) }
+})

package/server/api/workshop/eda/features/run.post.ts

@@ -0,0 +1,28 @@
+/**
+ * POST /api/workshop/eda/features/run —— 手动重算一次批次的特征
+ * (body: {run_id, grace_ms?};关账钩子之外的运维/测试入口;产线可读即可)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { lineMode } from '@/server/services/workshop/permissions'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { computeRunFeatures } from '@/server/services/workshop/eda/features'
+import { edaRunById } from '@/server/services/workshop/eda/eda-run.repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<{ run_id?: string, grace_ms?: number | string }>(event) ?? {}
+  const runId = String(body.run_id ?? '').trim()
+  const run = edaRunById(runId)
+  if (!run) throw new AppError(404, 'NOT_FOUND' as never, `批次不存在: ${runId}`)
+  if (lineMode(user, run.lineId) === 'none') throw new AppError(403, 'SCOPE_VIOLATION' as never, '批次不在你的可读产线上。')
+  try {
+    const features = await computeRunFeatures(runId, { graceMs: Number(body.grace_ms) || 0 })
+    return { runId, features }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    throw new AppError(400, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/golden/[id].delete.ts

@@ -0,0 +1,22 @@
+/**
+ * DELETE /api/workshop/eda/golden/:id —— 删除 golden(创建者/admin)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { deleteGolden, GoldenError } from '@/server/services/workshop/eda/golden'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  try {
+    const ok = deleteGolden(user, id)
+    if (!ok) throw new AppError(404, 'NOT_FOUND' as never, `golden 不存在: ${id}`)
+    return { deleted: true }
+  }
+  catch (err) {
+    if (err instanceof GoldenError) throw new AppError(err.status, err.code as never, err.message)
+    throw err
+  }
+})

package/server/api/workshop/eda/golden/deviation.get.ts

@@ -0,0 +1,21 @@
+/**
+ * GET /api/workshop/eda/golden/deviation?run_id=&node_id= —— 批次 vs golden 偏差分。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { deviationScore, GoldenError } from '@/server/services/workshop/eda/golden'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const q = getQuery(event)
+  try {
+    const r = await deviationScore(user, { runId: String(q.run_id ?? ''), nodeId: String(q.node_id ?? '') })
+    return r
+  }
+  catch (err) {
+    if (err instanceof GoldenError) throw new AppError(err.status, err.code as never, err.message)
+    throw err
+  }
+})

package/server/api/workshop/eda/golden/index.get.ts

@@ -0,0 +1,21 @@
+/**
+ * GET /api/workshop/eda/golden —— golden 参考轨迹清单(query: recipe_id?)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { listGolden } from '@/server/services/workshop/eda/golden'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const q = getQuery(event)
+  const all = listGolden(q.recipe_id ? String(q.recipe_id) : undefined)
+  // 摘要面:profile 体积大,列表只回元数据+指纹(画像走单条 GET?——前端叠加时经 recipe+node 取单条)
+  return {
+    golden: all.map(g => ({
+      id: g.id, recipeId: g.recipeId, nodeId: g.nodeId, sourceRunId: g.sourceRunId,
+      nBins: g.nBins, fingerprint: g.fingerprint, createdBy: g.createdBy, createdAt: g.createdAt,
+    })),
+    count: all.length,
+  }
+})

package/server/api/workshop/eda/golden/index.post.ts

@@ -0,0 +1,29 @@
+/**
+ * POST /api/workshop/eda/golden —— 从 good 批次生成 golden 参考轨迹。
+ * body: { run_id, node_id, n_bins? }(批次须已关账且 outcome=good)
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { buildGolden, GoldenError } from '@/server/services/workshop/eda/golden'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<{ run_id?: string, node_id?: string, n_bins?: number | string }>(event) ?? {}
+  if (!String(body.run_id ?? '').trim() || !String(body.node_id ?? '').trim()) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, 'run_id 与 node_id 必填。')
+  }
+  try {
+    const golden = await buildGolden(user, {
+      runId: String(body.run_id),
+      nodeId: String(body.node_id),
+      nBins: body.n_bins == null ? undefined : Number(body.n_bins),
+    })
+    return { golden }
+  }
+  catch (err) {
+    if (err instanceof GoldenError) throw new AppError(err.status, err.code as never, err.message)
+    throw err
+  }
+})

package/server/api/workshop/eda/golden/single.get.ts

@@ -0,0 +1,16 @@
+/**
+ * GET /api/workshop/eda/golden/single?recipe_id=&node_id= —— 单条 golden 画像(叠加用)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getGolden } from '@/server/services/workshop/eda/golden'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const q = getQuery(event)
+  const g = getGolden(String(q.recipe_id ?? ''), String(q.node_id ?? ''))
+  if (!g) throw new AppError(404, 'NOT_FOUND' as never, '该配方/节点尚无 golden 参考轨迹。')
+  return { golden: g }
+})

package/server/api/workshop/eda/ocap/[id].get.ts

@@ -0,0 +1,39 @@
+/**
+ * GET   /api/workshop/eda/ocap/:id —— 处置单详情(弱关联存在性校验随行)。
+ * PATCH /api/workshop/eda/ocap/:id —— 追加步骤 {step} / 关单 {status:'closed'|'void', linked_exploration_id?, linked_rollback_anchor?}。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { ocapById, addOcapStep, closeOcap } from '@/server/services/workshop/eda/ocap'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  if (event.method === 'GET') {
+    const row = ocapById(user, id)
+    if (!row) throw new AppError(404, 'NOT_FOUND' as never, `OCAP 不存在或不可见: ${id}`)
+    return { record: row }
+  }
+  const body = await readBody<{ step?: string, status?: string, linked_exploration_id?: string, linked_rollback_anchor?: string }>(event) ?? {}
+  try {
+    if (body.step != null) {
+      return { record: await addOcapStep(user, id, String(body.step)) }
+    }
+    const status = String(body.status ?? '') as 'closed' | 'void'
+    if (status !== 'closed' && status !== 'void') {
+      throw new AppError(400, 'VALIDATION_ERROR' as never, 'status 只支持 \'closed\' | \'void\'(追加处置步骤请传 {step})。')
+    }
+    return { record: closeOcap(user, id, {
+      status,
+      linkedExplorationId: body.linked_exploration_id ? String(body.linked_exploration_id) : undefined,
+      linkedRollbackAnchor: body.linked_rollback_anchor ? String(body.linked_rollback_anchor) : undefined,
+    }) }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    const status = /不存在或不可见/.test(msg) ? 404 : /仅 owner/.test(msg) ? 403 : 400
+    throw new AppError(status, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/ocap/[id].patch.ts

@@ -0,0 +1,33 @@
+/**
+ * PATCH /api/workshop/eda/ocap/:id —— 追加处置步骤 {step} / 关单 {status:'closed'|'void', ...}。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { addOcapStep, closeOcap } from '@/server/services/workshop/eda/ocap'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ step?: string, status?: string, linked_exploration_id?: string, linked_rollback_anchor?: string }>(event) ?? {}
+  try {
+    if (body.step != null) {
+      return { record: addOcapStep(user, id, String(body.step)) }
+    }
+    const status = String(body.status ?? '') as 'closed' | 'void'
+    if (status !== 'closed' && status !== 'void') {
+      throw new Error('status 只支持 \'closed\' | \'void\'(追加处置步骤请传 {step})。')
+    }
+    return { record: closeOcap(user, id, {
+      status,
+      linkedExplorationId: body.linked_exploration_id ? String(body.linked_exploration_id) : undefined,
+      linkedRollbackAnchor: body.linked_rollback_anchor ? String(body.linked_rollback_anchor) : undefined,
+    }) }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    const status = /不存在或不可见/.test(msg) ? 404 : /仅 owner/.test(msg) ? 403 : 400
+    throw new AppError(status, 'VALIDATION_ERROR' as never, msg)
+  }
+})

package/server/api/workshop/eda/ocap/index.get.ts

@@ -0,0 +1,13 @@
+/**
+ * GET /api/workshop/eda/ocap?status=open —— OCAP 处置单清单(开单走 index.post.ts)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { listOcap } from '@/server/services/workshop/eda/ocap'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const q = getQuery(event)
+  return { records: listOcap(user, { status: q.status ? String(q.status) : undefined, limit: Number(q.limit) || 100 }) }
+})

package/server/api/workshop/eda/ocap/index.post.ts

@@ -0,0 +1,27 @@
+/**
+ * POST /api/workshop/eda/ocap —— 开 OCAP 处置单(见 index.get.ts 头注;方法分文件)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { createOcap } from '@/server/services/workshop/eda/ocap'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<Record<string, unknown>>(event) ?? {}
+  const alarmId = String(body.alarm_id ?? '').trim()
+  const title = String(body.title ?? '').trim()
+  if (!alarmId || !title) throw new AppError(400, 'VALIDATION_ERROR' as never, 'alarm_id 与 title 必填。')
+  try {
+    return { record: createOcap(user, {
+      alarmId,
+      title,
+      runId: body.run_id ? String(body.run_id) : undefined,
+      nodeId: body.node_id ? String(body.node_id) : undefined,
+    }) }
+  }
+  catch (err) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, err instanceof Error ? err.message : String(err))
+  }
+})

package/server/api/workshop/eda/run-segments/index.get.ts

@@ -0,0 +1,39 @@
+/**
+ * GET  /api/workshop/eda/run-segments?recipe_id= —— run 内相位段定义(FDC 按段特征)。
+ * POST /api/workshop/eda/run-segments —— {recipe_id, seq, name?, phase_from, phase_to}(phase ∈ [0,1])。
+ */
+import { getQuery, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { requireLineMode } from '@/server/services/workshop/permissions'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { edaDb } from '@/server/services/workshop/eda/eda-db'
+
+function listByRecipe(recipeId: string): Array<Record<string, unknown>> {
+  return edaDb().prepare('SELECT * FROM run_segments WHERE recipe_id = ? ORDER BY seq ASC').all(recipeId) as Array<Record<string, unknown>>
+}
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  if (event.method === 'GET') {
+    const q = getQuery(event)
+    return { segments: listByRecipe(String(q.recipe_id ?? '')) }
+  }
+  const body = await readBody<{ recipe_id?: string, seq?: number, name?: string, phase_from?: number, phase_to?: number }>(event) ?? {}
+  const recipeId = String(body.recipe_id ?? '')
+  const recipe = getDcwController().listRecipes().find(r => r.id === recipeId)
+  if (!recipe) throw new AppError(404, 'NOT_FOUND' as never, `配方不存在: ${recipeId}`)
+  requireLineMode(user, recipe.lineId, 'readonly')
+  const from = Number(body.phase_from)
+  const to = Number(body.phase_to)
+  if (!Number.isFinite(from) || !Number.isFinite(to) || from < 0 || to > 1 || from >= to) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, 'phase_from/phase_to 必须满足 0 ≤ from < to ≤ 1。')
+  }
+  const seq = Math.max(Math.round(Number(body.seq)) || 1, 1)
+  edaDb().prepare(`INSERT INTO run_segments (id, recipe_id, seq, name, phase_from, phase_to)
+    VALUES ('rseg-' || lower(hex(randomblob(4))), ?, ?, ?, ?, ?)
+    ON CONFLICT(recipe_id, seq) DO UPDATE SET name = excluded.name, phase_from = excluded.phase_from, phase_to = excluded.phase_to`)
+    .run(recipeId, seq, String(body.name ?? `seg${seq}`), from, to)
+  return { segments: listByRecipe(recipeId) }
+})

package/server/api/workshop/eda/run-segments/index.post.ts

@@ -0,0 +1,30 @@
+/**
+ * POST /api/workshop/eda/run-segments —— 定义 run 内相位段(见 index.get.ts;方法分文件)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { requireLineMode } from '@/server/services/workshop/permissions'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { edaDb } from '@/server/services/workshop/eda/eda-db'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<{ recipe_id?: string, seq?: number, name?: string, phase_from?: number, phase_to?: number }>(event) ?? {}
+  const recipeId = String(body.recipe_id ?? '')
+  const recipe = getDcwController().listRecipes().find(r => r.id === recipeId)
+  if (!recipe) throw new AppError(404, 'NOT_FOUND' as never, `配方不存在: ${recipeId}`)
+  requireLineMode(user, recipe.lineId, 'readonly')
+  const from = Number(body.phase_from)
+  const to = Number(body.phase_to)
+  if (!Number.isFinite(from) || !Number.isFinite(to) || from < 0 || to > 1 || from >= to) {
+    throw new AppError(400, 'VALIDATION_ERROR' as never, 'phase_from/phase_to 必须满足 0 ≤ from < to ≤ 1。')
+  }
+  const seq = Math.max(Math.round(Number(body.seq)) || 1, 1)
+  edaDb().prepare(`INSERT INTO run_segments (id, recipe_id, seq, name, phase_from, phase_to)
+    VALUES ('rseg-' || lower(hex(randomblob(4))), ?, ?, ?, ?, ?)
+    ON CONFLICT(recipe_id, seq) DO UPDATE SET name = excluded.name, phase_from = excluded.phase_from, phase_to = excluded.phase_to`)
+    .run(recipeId, seq, String(body.name ?? `seg${seq}`), from, to)
+  return { segments: edaDb().prepare('SELECT * FROM run_segments WHERE recipe_id = ? ORDER BY seq ASC').all(recipeId) }
+})

package/server/api/workshop/eda/runs/[id]/labels.patch.ts

@@ -0,0 +1,25 @@
+/**
+ * PATCH /api/workshop/eda/runs/:id/labels —— 批次标签(E8③:lot/wafer/operator 等 KV)。
+ * body: { labels: Record<string,unknown> }(整体覆盖;GET /eda/runs?label=key:value 检索)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { lineMode } from '@/server/services/workshop/permissions'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { setRunLabels, edaRunById } from '@/server/services/workshop/eda/eda-run.repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const run = edaRunById(id)
+  if (!run) throw new AppError(404, 'NOT_FOUND' as never, `批次不存在: ${id}`)
+  // 标注=产线数据治理动作,需可操控(admin/editor/授权 operate 用户)
+  if (lineMode(user, run.lineId) !== 'operate') {
+    throw new AppError(403, 'SCOPE_VIOLATION' as never, '批次标签需产线可操控权限。')
+  }
+  const body = await readBody<{ labels?: Record<string, unknown> }>(event) ?? {}
+  const labels = body.labels ?? {}
+  setRunLabels(id, labels)
+  return { run: edaRunById(id) }
+})