feat: 安全回写档口入库码并支持核验恢复 (#234)

admin/repository/inner_code.go

@@ -274,6 +274,102 @@ func scanInnerCodeRecord(scanner innerCodeRowScanner) (model.InnerCodeRecord, er
 	return row, nil
 }
 
+// ClaimInnerCodeForApply 原子领取一条 ready 记录。返回 claimed=false 表示状态已变化。
+func ClaimInnerCodeForApply(db *sql.DB, id int64, actorUserID, now string) (*model.InnerCodeRecord, bool, error) {
+	tx, err := db.Begin()
+	if err != nil {
+		return nil, false, fmt.Errorf("开始领取档口入库码事务失败: %w", err)
+	}
+	defer tx.Rollback()
+	record, err := scanInnerCodeRecord(tx.QueryRow(`SELECT `+innerCodeListColumns+
+		` FROM syb_inner_code_records WHERE id=? FOR UPDATE`, id))
+	if errors.Is(err, sql.ErrNoRows) {
+		return nil, false, nil
+	}
+	if err != nil {
+		return nil, false, err
+	}
+	if record.Status != model.InnerCodeReady {
+		return &record, false, nil
+	}
+	result, err := tx.Exec(`UPDATE syb_inner_code_records
+		SET status='applying',applied_by_user_id=?,apply_started_at=?,updated_at=?
+		WHERE id=? AND status='ready'`, actorUserID, now, now, id)
+	if err != nil {
+		return nil, false, fmt.Errorf("领取档口入库码记录失败: %w", err)
+	}
+	if affected, err := result.RowsAffected(); err != nil || affected != 1 {
+		return &record, false, nil
+	}
+	if err := tx.Commit(); err != nil {
+		return nil, false, fmt.Errorf("提交档口入库码领取失败: %w", err)
+	}
+	record.Status = model.InnerCodeApplying
+	record.AppliedByUserID = actorUserID
+	record.ApplyStartedAt = now
+	record.UpdatedAt = now
+	return &record, true, nil
+}
+
+// FinishInnerCodeApply 保存一条已领取记录的最终结果。
+func FinishInnerCodeApply(q Execer, id int64, status model.InnerCodeStatus, message, remoteCode, finishedAt string) error {
+	result, err := q.Exec(`UPDATE syb_inner_code_records
+		SET status=?,result_message=?,remote_inner_code=?,
+		    applied_at=CASE WHEN ? IN ('updated','already_filled') THEN ? ELSE applied_at END,
+		    updated_at=?
+		WHERE id=? AND status='applying'`, status, message, nullableString(remoteCode), status, finishedAt, finishedAt, id)
+	if err != nil {
+		return fmt.Errorf("保存档口入库码回写结果失败: %w", err)
+	}
+	if affected, err := result.RowsAffected(); err != nil || affected != 1 {
+		return fmt.Errorf("档口入库码记录 %d 已不在回写中，拒绝覆盖结果", id)
+	}
+	return nil
+}
+
+// GetInnerCodeForRecheck 读取一条需核对记录。
+func GetInnerCodeForRecheck(q Execer, id int64) (*model.InnerCodeRecord, error) {
+	record, err := scanInnerCodeRecord(q.QueryRow(`SELECT `+innerCodeListColumns+
+		` FROM syb_inner_code_records WHERE id=?`, id))
+	if errors.Is(err, sql.ErrNoRows) {
+		return nil, nil
+	}
+	if err != nil {
+		return nil, err
+	}
+	return &record, nil
+}
+
+// SaveInnerCodeRecheck 保存只读重新核对的远端结果，不执行状态领取或写入。
+func SaveInnerCodeRecheck(q Execer, id int64, status model.InnerCodeStatus, message, remoteCode, checkedAt string) error {
+	result, err := q.Exec(`UPDATE syb_inner_code_records
+		SET status=?,result_message=?,remote_inner_code=?,
+		    applied_at=CASE WHEN ?='updated' THEN ? ELSE applied_at END,updated_at=?
+		WHERE id=? AND status='needs_check'`, status, message, nullableString(remoteCode), status, checkedAt, checkedAt, id)
+	if err != nil {
+		return fmt.Errorf("保存档口入库码核对结果失败: %w", err)
+	}
+	if affected, err := result.RowsAffected(); err != nil || affected != 1 {
+		return fmt.Errorf("档口入库码记录 %d 已不需要核对", id)
+	}
+	return nil
+}
+
+// InterruptApplyingInnerCodes 在启动时把未知结果的 applying 收敛为 needs_check。
+func InterruptApplyingInnerCodes(q Execer, interruptedAt string) (int, error) {
+	result, err := q.Exec(`UPDATE syb_inner_code_records
+		SET status='needs_check',result_message='Admin 在回写完成前退出，请重新核对远端结果；系统不会自动重写',
+		    updated_at=? WHERE status='applying'`, interruptedAt)
+	if err != nil {
+		return 0, fmt.Errorf("恢复中断的档口入库码回写失败: %w", err)
+	}
+	affected, err := result.RowsAffected()
+	if err != nil {
+		return 0, fmt.Errorf("读取中断档口入库码数量失败: %w", err)
+	}
+	return int(affected), nil
+}
+
 func nullablePositiveInt(value int) any {
 	if value <= 0 {
 		return nil