docs(business): 生成业务契约文档并重构MES客户端代码

- 创建案例.md文档，包含业务场景清单、业务流程、案例和回归测试三份完整文档
- WMS库房管理系统涵盖入库、出库、库存、检验、盘点等24个业务场景
- MES产线控制系统包含工单、排产、BOM、备料、质检、追溯等23个业务场景
- 工位终端系统支持上线、报工、下线、领料、巡检等15个现场作业场景
- 主链路从合同到成品入库，异常链路处理不合格、数量不符、退料等情况
- 删除MES客户端中的ScanRecord相关代码，精简客户端结构
- 更新客户端初始化逻辑，移除扫描记录相关的依赖注入配置

bj_power_mes/internal/logic/seed.go

@@ -12,7 +12,7 @@ import (
 	"golang.org/x/crypto/bcrypt"
 )
 
-// Seed 初始化：超级管理员、默认角色、默认菜单权限、12 道工序与工位派工
+// Seed 初始化：超级管理员、默认角色、默认菜单权限、产线工位（内置只读主数据；工艺流程由用户自建不预置）
 func (s *Service) Seed(ctx context.Context) error {
 	// 1. 默认角色（已存在则合并权限码，保证新按钮权限能落到已有角色上）
 	roles := []struct{ name, code string }{
@@ -168,37 +168,23 @@ func (s *Service) Seed(ctx context.Context) error {
 	// 清掉存量角色里的旧码与旧菜单定义行（幂等）；新菜单 produce.qty 在 1. 的 seedMenus 中定义。
 	migrateLegacyQtyReport(ctx, s)
 
-	// 4. 初始化工位与默认工艺流程（工位绑定流程，流程承载步骤）
-	seedFlowsAndStations(ctx, s)
+	// 4. 初始化产线工位（内置只读主数据）；工艺流程/工序步骤由用户在「工艺流程」页自建，不预置
+	seedStations(ctx, s)
 	return nil
 }
 
-func seedFlowsAndStations(ctx context.Context, s *Service) {
-	// 初始数据：12 个工位（工位数量以数据库为准，这里只做首次初始化；要 13 个就往 station 表插一行）
-	// 初始化的工位一律为「内置工位」：需连 PLC、必须按工位号顺序流转、不可改类型、不可删除；
-	// 其中 1~10 号工位对应实体接驳台，11/12 为产线末端无接驳台。
+func seedStations(ctx context.Context, s *Service) {
+	// 工位是产线固定物理工位，一律「内置工位」：需连 PLC、按工位号顺序流转、不可改类型、不可删除、仅可改名，
+	// 属系统内置只读主数据（同 WMS 接驳台），故由种子初始化。12 个装配工位（1~10 带接驳台，11/12 产线末端无接驳台）；
+	// 工位数量以数据库为准，要 13 个就往 station 表插一行。
+	// 工艺流程/工序步骤不在此预置：流程可在「工艺流程」页新建/编辑/删除/启停，是用户可维护的业务数据，
+	// 由实施按产品工艺自建、并在「关联工位」页绑定到工位（station.flow_id），不硬编码进种子。
 	for i := 1; i <= 12; i++ {
-		st, err := s.ctx.EntClient.Station.Query().Where(station.StationNo(i)).First(ctx)
-		if err != nil {
-			st, _ = s.ctx.EntClient.Station.Create().
+		if _, err := s.ctx.EntClient.Station.Query().Where(station.StationNo(i)).First(ctx); err != nil {
+			_, _ = s.ctx.EntClient.Station.Create().
 				SetStationNo(i).SetName("装配工位" + strconv.Itoa(i)).SetStatus("ENABLED").
 				SetIsBuiltin(true).SetHasDock(i <= 10).Save(ctx)
 		}
-		if st == nil || st.FlowId > 0 {
-			continue
-		}
-		flow, err := s.ctx.EntClient.ProcessFlow.Create().
-			SetName("工位" + strconv.Itoa(i) + "_默认").
-			SetStatus("ACTIVE").SetRemark("默认工艺流程").Save(ctx)
-		if err != nil {
-			continue
-		}
-		if _, err := s.ctx.EntClient.ProcessStep.Create().
-			SetFlowId(flow.ID).SetSeq(1).SetName("装配完成").SetCollectType("NONE").Save(ctx); err == nil && i == 3 {
-			_, _ = s.ctx.EntClient.ProcessStep.Create().
-				SetFlowId(flow.ID).SetSeq(2).SetName("拧紧扭矩").SetCollectType("AUTO").SetIsTorque(true).Save(ctx)
-		}
-		_, _ = s.ctx.EntClient.Station.UpdateOneID(st.ID).SetFlowId(flow.ID).Save(ctx)
 	}
 	// 0 号(上线位) / 13 号(下线位) 虚拟工位：OFFLINE 类型，用 PAD 操作，不连 PLC、
 	// 不叫料、不进入产线组合排序；仅做上下线登记，不参与物理工位计数。