job.current_step_id 设计

目标

job.currentStepIndex (int) → job.currentStepId (string)，以 stepId 为 job 当前步骤的运行时标识，消除 AdvanceStep 中 stepId↔stepIndex 的来回转换。

动机

recipe_step 已采用 stepId 为主的设计：nextStepDefault 和 nextStepBranches 存储的都是 stepId（如 "OP20"），但 job 表仍用 currentStepIndex (int)。导致 AdvanceStep 中存在冗余转换：

nextStepDefault(stepId) → 二次查表转 stepIndex → 写 currentStepIndex
resolveBranch(stepId)   → GetStepIndexByStepID   → 写 currentStepIndex

同时 stepIndex 不稳定：工序重排时 index 会变，运行中的 job 会指错步骤。stepId（OP10-OP120）是稳定的业务标识。

设计

Schema

job 表 (schema/job.go)：

新增 field.String("currentStepId").MaxLen(20).Default("")，替代 currentStepIndex 作为运行时步骤标识
旧字段 currentStepIndex 暂保留但不写入（默认 0），给前端平滑过渡窗口
新字段不需要额外索引（仅作为数据列读取，不作为查询条件）

stepId 排序

12 个步骤加载到内存按 stepIndex 排序（数量少，开销可忽略），必要时用辅助函数提取 stepId 中的数字：

func sortedStepIDs(ctx, recipeID) []string {
    // SELECT stepId FROM recipe_step WHERE recipeId=? ORDER BY stepIndex
}

AdvanceStep 简化

旧流程：

nextStepDefault(stepId) → 二次查表转 stepIndex → 写 currentStepIndex
resolveBranch(stepId)   → GetStepIndexByStepID  → 写 currentStepIndex
线性推进                 → currentStepIndex + 1

新流程：

nextStepDefault → 本身就是 stepId → 直接写 currentStepId
resolveBranch   → 本身就是 stepId → 直接写 currentStepId
线性推进         → 当前 stepId 的 stepIndex + 1 → 按 stepIndex 找回 stepId

"是否最后一步"：取 currentStepId 对应的 stepIndex 与 maxStepIndex 比较。

DBState 方法调整

需修改的方法：

AdvanceStep (dbstate.go:162) — SetCurrentStepIndex → SetCurrentStepId，resolveBranch 传 stepId
CompleteStep (dbstate.go:34) — 同上

旧方法	新方法	说明
`GetRecipeStep(recipeID, stepIndex)`	保留，Generator 遍历用	按 stepIndex 依次取
—	`GetRecipeStepByID(recipeID, stepID)`	核心读路径用 stepId
`GetNextStepIndex`	废弃	nextStepDefault 即 stepId
`resolveBranch(recipeID, stepIndex, ctxMap)`	`resolveBranch(recipeID, stepID, ctxMap)`	分支目标即 stepId
`GetStepIndexByStepID`	保留	排序/比较
—	`GetStepIDByIndex(recipeID, stepIndex)`	线性推进用
—	`getSortedStepIDs(recipeID)`	加载全步骤排序

对外类型

type JobView struct {
    CurrentStepIndex int    `json:"currentStepIndex"` // deprecated
    CurrentStepId    string `json:"currentStepId"`
}

RuntimeSnapshot 同理加 StepID，StepIndex 保留。

消费方改动

位置	改动
`internal/eventloop/dbstate.go`	`AdvanceStep` + `CompleteStep`：`SetCurrentStepIndex` → `SetCurrentStepId`
`internal/eventloop/scheduler_bridge.go`	`GetRecipeStep(stepIndex)` → `GetRecipeStepByID(stepId)`
`internal/eventloop/candidate_handlers.go`	同上
`internal/eventloop/loop.go`	`RuntimeSnapshot` 加 `StepID` 字段
`internal/scheduler/generator.go`	遍历全步骤用 stepIndex（不变），候选任务用 stepId
`internal/processor/job_processor.go:254`	`SetCurrentStepIndex` → `SetCurrentStepId`（恢复/跳步场景）
`internal/processor/recipe_runtime.go`	`GetNextStepIndex` 标记废弃（processor 层作为兜底）
`internal/types/types.go`	`JobView`/`RuntimeSnapshot`/API 响应类型加 `CurrentStepId`
`cmd/mockrun/main.go:110`	`SetCurrentStepIndex` → `SetCurrentStepId`
`frontend/src/api/temp-station/index.ts:9`	类型加 `currentStepId`
`frontend/src/api/dock/index.ts:9`	类型加 `currentStepId`

迁移

UPDATE job SET currentStepId = rs.stepId
FROM recipe_step rs
WHERE job.recipeId = rs.recipeId AND job.currentStepIndex = rs.stepIndex;

迁移脚本放入 schema/tools/，在 EnsureDataInitialized 中执行。

4.2 KiB Raw Blame History Unescape Escape