初始化

2026-08-08 18:28:49 +08:00
parent 9bef4420e0
commit f082037a6e
854 changed files with 217171 additions and 11 deletions
@@ -0,0 +1,125 @@
+<?php
+/**
+ * 工位业务配置辅助文件
+ * 
+ * 将所有工位的特殊业务逻辑抽象为配置驱动。
+ * 每个内置工位在此定义其业务配置，FrontController 的 __call 统一读取并执行。
+ * 
+ * 新增/修改工位只需：
+ *   1. 在 Admin 后台添加/编辑 workstation 记录
+ *   2. 如有特殊业务逻辑（如独立数据表、自定义提交），在此文件中添加配置
+ *   3. 无需修改 FrontController 或创建新视图文件
+ */
+
+/**
+ * 从 SysConfig 动态生成 codePrefix 验证规则
+ * 
+ * 配置格式（在工位配置中）：
+ *   'codePrefixFields' => [
+ *       '字段名' => '产品类型',  // 如 'serial_no' => 'PCBA'
+ *   ]
+ * 
+ * 运行时从 sys_config.code_prefix_rules 读取产品类型对应的前缀，
+ * 自动生成 codePrefix 验证规则。如果该产品类型未配置前缀（空字符串），则跳过验证。
+ * 
+ * @param array|null $fieldMappings 字段到产品类型的映射
+ * @return array 格式化后的 codePrefix 规则
+ */
+function buildCodePrefixRules($fieldMappings, $prefixTypeMap = null) {
+    if (empty($fieldMappings)) return [];
+    
+    // 如果未传入前缀映射，从 SysConfig 读取（兼容旧用法）
+    if ($prefixTypeMap === null) {
+        try {
+            $config = new \app\models\SysConfig();
+            $prefixTypeMap = $config->getCodePrefixRules();
+        } catch (\Throwable $e) {
+            error_log('[buildCodePrefixRules] getCodePrefixRules failed: ' . $e->getMessage());
+            $prefixTypeMap = [];
+        }
+    }
+    if (!is_array($prefixTypeMap)) $prefixTypeMap = [];
+    
+    $rules = [];
+    foreach ($fieldMappings as $fieldName => $productType) {
+        // 动态前缀：*dynamic* 标记表示根据提交时的 product_type 动态匹配
+        if ($productType === '*dynamic*') {
+            $rules[$fieldName] = ['*dynamic*', '序列号前缀与产品类型不匹配'];
+            continue;
+        }
+        $prefix = $prefixTypeMap[$productType] ?? '';
+        // 原则：所有工位序列号都受前缀管控。类型已配置但前缀为空时，
+        // 自动回退为产品类型名拼音首字母（如 外壳→WK、包装→BZ、半成品→BCP、配件→PJ）。
+        if ($prefix === '') {
+            try {
+                $sc = new \app\models\SysConfig();
+                $prefix = $sc->pinyinInitials($productType);
+            } catch (\Throwable $e) {
+                error_log('[buildCodePrefixRules] pinyinInitials failed: ' . $e->getMessage());
+                $prefix = '';
+            }
+        }
+        if ($prefix === '') continue; // 实在无法解析（如类型根本未配置）才跳过
+        
+        $rules[$fieldName] = [$prefix, "{$productType}序列号必须以 {$prefix} 开头"];
+    }
+    return $rules;
+}
+
+/**
+ * 获取指定工位的业务配置
+ * @param string $stationType 工位类型标识
+ * @return array|null 业务配置数组，null 表示使用通用 station_records 存储
+ */
+function getStationBusinessConfig($stationType) {
+    // ========== 所有工位统一走自动生成路径 ==========
+    // 
+    // 之前的内置工位配置（inbound, pcb_test, battery, assembly, finished_test, 
+    // delivery, warehouse）已全部移除。
+    // 
+    // 现在所有工位（包括内置和动态）都通过 FrontController::buildGenericBizConfig()
+    // 自动生成业务配置，确保与 aging/semi_finished 等已验证正常的工位使用完全相同的代码路径。
+    // 
+    // 特殊业务逻辑（如 delivery 的箱序列号、inbound 的成品入库切换等）
+    // 将逐步在 FrontController::handleBuiltinSubmit() 中按 stationType 判断实现。
+    // 
+    // 如需恢复某个工位的特殊配置，请以 aging/semi_finished 的自动生成配置为基准，
+    // 在此基础上增量添加，避免重写整个配置导致不一致。
+    
+    $configs = [
+        // ========== 成品入库工位（已合并到入库） ==========
+        // warehouse 重定向到 inbound，保留此逻辑
+        'warehouse' => [
+            'model' => 'StationDefinition',
+            'redirect' => 'inbound',
+        ],
+    ];
+
+    if (!isset($configs[$stationType])) {
+        return null;
+    }
+    
+    $bizConfig = $configs[$stationType];
+    
+    // 动态构建 codePrefix：从 codePrefixFields 映射到实际前缀规则
+    if (!empty($bizConfig['codePrefixFields'])) {
+        $bizConfig['codePrefix'] = buildCodePrefixRules($bizConfig['codePrefixFields']);
+    }
+    
+    return $bizConfig;
+}
+
+/**
+ * 获取工位的测试状态颜色映射（用于 labelFields 动态颜色）
+ */
+function getTestStatusColor($status) {
+    $map = [
+        'passed'  => 'success',
+        'failed'  => 'danger',
+        'pending' => 'warning',
+        '通过'    => 'success',
+        '失败'    => 'danger',
+        '待测试'  => 'warning',
+    ];
+    return $map[$status] ?? 'default';
+}