@newpeak/barista-cli 0.1.7 → 0.1.8

package/src/commands/liberica/operations/design.md

@@ -0,0 +1,587 @@
+# Liberica Operations Command Design Specification
+
+## 1. Overview
+
+This document specifies the command-line interface design for managing **Operations** (工序/工艺) in the Liberica production management system.
+
+### 1.1 Resource Description
+
+- **Resource**: Operation (工序)
+- **Chinese Name**: 工序
+- **API Path Prefix**: `/api/enterprise/manufacture/operation/*`
+- **Purpose**: Manage manufacturing operations/work steps in production processes
+
+### 1.2 Entity Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| operationId | string | Auto | Unique identifier (BigInteger) |
+| operationCode | string | Auto | Auto-generated code |
+| operationName | string | Yes | Operation name |
+| operationType | string | Yes | Operation type (EQUIPMENT/HUMAN/PACKAGE/QUALITY_TESTING/OTHER) |
+| workCenterCode | string | No | Work center code |
+| mouldCode | string | No | Mould code (if applicable) |
+| mouldType | string | No | Mould type |
+| equipmentType | string | No | Equipment type |
+| leadTime | number | No | Lead time (hours) |
+| remark | string | No | Remarks |
+| statusFlag | number | Auto | Status (1=enable, 2=disable) |
+| createTime | string | Auto | Creation timestamp |
+
+---
+
+## 2. Subcommand Structure
+
+### 2.1 Command Tree
+
+```
+barista liberica operations <subcommand> [options]
+```
+
+### 2.2 Available Subcommands
+
+| # | Subcommand | Description | CRUD Type |
+|---|------------|-------------|-----------|
+| 1 | `list` | List operations with pagination | Read |
+| 2 | `get` | Get operation details by ID | Read |
+| 3 | `create` | Create a new operation | Create |
+| 4 | `update` | Update an existing operation | Update |
+| 5 | `delete` | Delete an operation | Delete |
+| 6 | `copy` | Copy an operation (duplicate with new code) | Create |
+| 7 | `batch-delete` | Delete multiple operations at once | Delete |
+| 8 | `active` | Enable an operation (set statusFlag=1) | Update |
+| 9 | `deactive` | Disable an operation (set statusFlag=2) | Update |
+| 10 | `enable` | Alias for `active` | Update |
+
+---
+
+## 3. Subcommand Specifications
+
+### 3.1 list - List Operations
+
+**Command**:
+```bash
+barista liberica operations list [options]
+```
+
+**Options**:
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--page` | `-p` | Page number | 1 |
+| `--size` | `-s` | Page size | 20 |
+| `--status` | - | Status filter (1=enable, 2=disable) | - |
+| `--name` | - | Filter by operation name (partial match) | - |
+| `--code` | - | Filter by operation code (exact match) | - |
+| `--type` | - | Filter by operation type (EQUIPMENT/HUMAN/PACKAGE/QUALITY_TESTING/OTHER) | - |
+| `--json` | - | Output as JSON | false |
+
+**API Endpoint**: `GET /api/enterprise/manufacture/operation/page`
+
+**Parameters**:
+```typescript
+{
+  pageNo: number;      // 0-based (CLI page - 1)
+  pageSize: number;
+  status?: 1 | 2;
+  operationName?: string;
+  operationCode?: string;
+  operationType?: string;
+}
+```
+
+**Output Format**:
+- Table: ID | Code | Name | Type | Work Center | Status
+- JSON: `{ success: true, data: { items: Operation[], pagination: { pageNo, pageSize, totalRows } } }`
+
+---
+
+### 3.2 get - Get Operation Details
+
+**Command**:
+```bash
+barista liberica operations get <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Operation ID (required) |
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON |
+
+**API Endpoint**: `GET /api/enterprise/manufacture/operation/detail`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;
+}
+```
+
+**Output Format**:
+- Table: All fields displayed in key-value format
+- JSON: Full operation object
+
+---
+
+### 3.3 create - Create Operation
+
+**Command**:
+```bash
+barista liberica operations create [options]
+```
+
+**Options**:
+| Option | Alias | Required | Description |
+|--------|-------|----------|-------------|
+| `--name` | `-n` | Yes | Operation name |
+| `--type` | `-t` | Yes | Operation type (supports bilingual: 机器/EQUIPMENT, 手工/HUMAN, 包装/PACKAGE, 质检/QUALITY_TESTING, 其它/OTHER) |
+| `--work-center` | `-w` | No | Work center code |
+| `--mould-code` | - | No | Mould code |
+| `--mould-type` | - | No | Mould type |
+| `--equipment-type` | - | No | Equipment type |
+| `--lead-time` | - | No | Lead time (hours) |
+| `--remark` | - | No | Remarks |
+| `--dry-run` | - | No | Preview without API call |
+| `--json` | - | No | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/add`
+
+**Request Body**:
+```typescript
+{
+  operationName: string;
+  operationType: string;      // Converted to API enum
+  workCenterCode?: string;
+  mouldCode?: string;
+  mouldType?: string;
+  equipmentType?: string;
+  leadTime?: number;
+  remark?: string;
+}
+```
+
+**Notes**:
+- `operationCode` is auto-generated by the backend
+- `statusFlag` defaults to 1 (enabled)
+
+---
+
+### 3.4 update - Update Operation
+
+**Command**:
+```bash
+barista liberica operations update <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Operation ID (required) |
+
+**Options**:
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--name` | `-n` | Operation name |
+| `--type` | `-t` | Operation type (supports bilingual) |
+| `--work-center` | `-w` | Work center code |
+| `--mould-code` | - | Mould code |
+| `--mould-type` | - | Mould type |
+| `--equipment-type` | - | Equipment type |
+| `--lead-time` | - | Lead time (hours) |
+| `--remark` | - | Remarks |
+| `--dry-run` | - | Preview without API call |
+| `--json` | - | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/edit`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;
+  operationName?: string;
+  operationType?: string;
+  workCenterCode?: string;
+  mouldCode?: string;
+  mouldType?: string;
+  equipmentType?: string;
+  leadTime?: number;
+  remark?: string;
+}
+```
+
+---
+
+### 3.5 delete - Delete Operation
+
+**Command**:
+```bash
+barista liberica operations delete <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Operation ID (required) |
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| `--force` | Skip confirmation, delete directly |
+| `--dry-run` | Preview without API call (default) |
+| `--json` | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/delete`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;
+}
+```
+
+**Behavior**:
+- Default: Dry-run mode (shows operation details, no actual deletion)
+- With `--force`: Execute deletion
+
+---
+
+### 3.6 copy - Copy Operation
+
+**Command**:
+```bash
+barista liberica operations copy <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Source operation ID (required) |
+
+**Options**:
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--name` | `-n` | New operation name (optional, defaults to "Copy of {originalName}") |
+| `--dry-run` | - | Preview without API call |
+| `--json` | - | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/copy`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;           // Source operation ID
+  operationName?: string;        // New name (optional)
+}
+```
+
+**Notes**:
+- Creates a new operation with auto-generated code
+- Copies all fields from source except operationCode
+
+---
+
+### 3.7 batch-delete - Batch Delete Operations
+
+**Command**:
+```bash
+barista liberica operations batch-delete [options]
+```
+
+**Options**:
+| Option | Alias | Required | Description |
+|--------|-------|----------|-------------|
+| `--ids` | - | Yes | Comma-separated operation IDs |
+| `--force` | - | No | Skip confirmation |
+| `--dry-run` | - | No | Preview without API call (default) |
+| `--json` | - | No | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/batchDelete`
+
+**Parameters**:
+```typescript
+{
+  operationIdList: string[];
+}
+```
+
+**Notes**:
+- Requires at least 1 ID
+- Default: Dry-run mode
+
+---
+
+### 3.8 active - Enable Operation
+
+**Command**:
+```bash
+barista liberica operations active <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Operation ID (required) |
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| `--force` | Skip confirmation |
+| `--json` | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/active`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;
+}
+```
+
+**Status Change**: Sets `statusFlag` to `1`
+
+---
+
+### 3.9 deactive - Disable Operation
+
+**Command**:
+```bash
+barista liberica operations deactive <operation-id> [options]
+```
+
+**Arguments**:
+| Argument | Description |
+|----------|-------------|
+| `operation-id` | Operation ID (required) |
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| `--force` | Skip confirmation |
+| `--json` | Output as JSON |
+
+**API Endpoint**: `POST /api/enterprise/manufacture/operation/deActive`
+
+**Parameters**:
+```typescript
+{
+  operationId: string;
+}
+```
+
+**Status Change**: Sets `statusFlag` to `2`
+
+---
+
+### 3.10 enable - Enable Operation (Alias)
+
+**Command**:
+```bash
+barista liberica operations enable <operation-id> [options]
+```
+
+**Notes**: Alias for `active` command. See section 3.8.
+
+---
+
+## 4. Dictionary Mappings
+
+### 4.1 OPERATION_TYPE (工序类型)
+
+| English | Chinese | API Value | CLI Input Values |
+|---------|---------|-----------|------------------|
+| EQUIPMENT | 机器 | EQUIPMENT | `EQUIPMENT`, `equipment`, `机器` |
+| HUMAN | 手工 | HUMAN | `HUMAN`, `human`, `手工` |
+| PACKAGE | 包装 | PACKAGE | `PACKAGE`, `package`, `包装` |
+| QUALITY_TESTING | 质检 | QUALITY_TESTING | `QUALITY_TESTING`, `quality_testing`, `qualitytesting`, `质检` |
+| OTHER | 其它 | OTHER | `OTHER`, `other`, `其它` |
+
+**Type Conversion Logic**:
+```typescript
+function normalizeOperationType(input: string): string {
+  const mapping: Record<string, string> = {
+    // English variants
+    'EQUIPMENT': 'EQUIPMENT',
+    'equipment': 'EQUIPMENT',
+    'HUMAN': 'HUMAN',
+    'human': 'HUMAN',
+    'PACKAGE': 'PACKAGE',
+    'package': 'PACKAGE',
+    'QUALITY_TESTING': 'QUALITY_TESTING',
+    'quality_testing': 'QUALITY_TESTING',
+    'qualitytesting': 'QUALITY_TESTING',
+    'OTHER': 'OTHER',
+    'other': 'OTHER',
+    // Chinese variants
+    '机器': 'EQUIPMENT',
+    '手工': 'HUMAN',
+    '包装': 'PACKAGE',
+    '质检': 'QUALITY_TESTING',
+    '其它': 'OTHER',
+    '其他': 'OTHER',
+  };
+  
+  const normalized = input.trim().toUpperCase();
+  return mapping[normalized] || mapping[input] || input;
+}
+```
+
+---
+
+### 4.2 MOULD_TYPE (模具类型)
+
+| Code | Description |
+|------|-------------|
+| INTERNAL | 内部模具 |
+| EXTERNAL | 外部模具 |
+| STANDARD | 标准模具 |
+| CUSTOM | 定制模具 |
+
+**CLI Input**: Supports both code and Chinese description.
+
+---
+
+### 4.3 EQUIPMENT_TYPE (设备类型)
+
+| Code | Description |
+|------|-------------|
+| CNC | CNC数控机床 |
+| DRILLING | 钻孔机 |
+| MILLING | 铣床 |
+| LATHE | 车床 |
+| PRESS | 冲压机 |
+| INJECTION | 注塑机 |
+| WELDING | 焊接设备 |
+| ASSEMBLY | 装配线 |
+| TESTING | 测试设备 |
+| OTHER | 其他设备 |
+
+**CLI Input**: Supports both code and Chinese description.
+
+---
+
+## 5. Bilingual Support Design
+
+### 5.1 --type Parameter
+
+The `--type` option accepts both English and Chinese inputs:
+
+```bash
+# All valid
+barista liberica operations create -n "冲压" -t EQUIPMENT
+barista liberica operations create -n "冲压" -t 机器
+barista liberica operations create -n "包装" -t PACKAGE
+barista liberica operations create -n "包装" -t 包装
+barista liberica operations create -n "质检" -t QUALITY_TESTING
+barista liberica operations create -n "质检" -t 质检
+
+# List filter
+barista liberica operations list --type HUMAN
+barista liberica operations list --type 手工
+```
+
+### 5.2 Output Display
+
+In table output, operation types are displayed in Chinese by default:
+
+| API Value | Display |
+|-----------|---------|
+| EQUIPMENT | 机器 |
+| HUMAN | 手工 |
+| PACKAGE | 包装 |
+| QUALITY_TESTING | 质检 |
+| OTHER | 其它 |
+
+---
+
+## 6. API Mapping Summary
+
+| CLI Subcommand | HTTP Method | API Path | Notes |
+|----------------|-------------|----------|-------|
+| `list` | GET | `/operation/page` | Pagination parameters |
+| `get` | GET | `/operation/detail` | Query param: operationId |
+| `create` | POST | `/operation/add` | Request body |
+| `update` | POST | `/operation/edit` | Request body with operationId |
+| `delete` | POST | `/operation/delete` | Request body with operationId |
+| `copy` | POST | `/operation/copy` | Request body with operationId |
+| `batch-delete` | POST | `/operation/batchDelete` | Request body: { operationIdList: [] } |
+| `active` | POST | `/operation/active` | Request body with operationId |
+| `deactive` | POST | `/operation/deActive` | Request body with operationId |
+
+---
+
+## 7. Common Options
+
+All subcommands support these global options:
+
+| Option | Description |
+|--------|-------------|
+| `--env <env>` | Environment (dev/test/prod-cn/prod-jp) |
+| `--tenant <tenant>` | Tenant ID |
+| `--json` | Output as JSON |
+
+---
+
+## 8. Error Handling
+
+### 8.1 Common Error Codes
+
+| Code | Description | Handling |
+|------|-------------|----------|
+| A150001 | Operation not found | Show "Operation not found: {id}" |
+| A150002 | Duplicate operation code | Show "Operation code already exists" |
+| A150003 | Invalid operation type | Show "Invalid operation type: {type}" |
+| A150004 | Operation in use | Show "Cannot delete: operation is referenced by work orders" |
+
+### 8.2 Error Response Formats
+
+```typescript
+// Format 1: Top-level error
+{ success: false, code: "A150001", message: "查询结果不存在" }
+
+// Format 2: Nested error
+{ success: false, error: { code: "01001150001", message: "工序不存在" } }
+```
+
+---
+
+## 9. Implementation Notes
+
+1. **ID Type**: All operation IDs must be `string` type (BigInteger)
+2. **Pagination**: CLI uses 1-based page numbers, API uses 0-based
+3. **Auto-generated Code**: operationCode is auto-generated by backend
+4. **No Inquirer**: Pure CLI argument mode, no interactive prompts
+5. **Default Dry-Run**: Delete and batch-delete default to dry-run mode
+6. **Bilingual I/O**: Accept bilingual input, display Chinese in table output
+
+---
+
+## 10. File Structure
+
+```
+src/
+├── commands/liberica/
+│   ├── operations/
+│   │   ├── index.ts          # Main command aggregator
+│   │   ├── list.ts           # List command
+│   │   ├── get.ts            # Get command
+│   │   ├── create.ts         # Create command
+│   │   ├── update.ts         # Update command
+│   │   ├── delete.ts         # Delete command
+│   │   ├── copy.ts           # Copy command
+│   │   ├── batch-delete.ts   # Batch delete command
+│   │   ├── active.ts         # Enable command
+│   │   ├── deactive.ts       # Disable command
+│   │   └── types.ts          # TypeScript interfaces
+│   └── ...
+└── types/
+    └── operation.ts          # Operation type definitions
+```
+
+---
+
+*Document Version: 1.0*
+*Last Updated: 2026-04-15*

package/src/commands/liberica/operations/get.ts

@@ -0,0 +1,112 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { configManager } from '../../../core/config/manager.js';
+import { apiClient } from '../../../core/api/client.js';
+import { Environment } from '../../../types/index.js';
+import { Operation, OperationApiResponse } from '../../../types/operation.js';
+
+const OPERATION_TYPE_MAP: Record<string, string> = {
+  EQUIPMENT: '机器',
+  HUMAN: '手工',
+  PACKAGE: '包装',
+  QUALITY_TESTING: '质检',
+  OTHER: '其它',
+};
+
+function displayOperationType(operationType: string): string {
+  return OPERATION_TYPE_MAP[operationType] || operationType;
+}
+
+function displayStatus(statusFlag: number): string {
+  return statusFlag === 1 ? '启用' : '禁用';
+}
+
+export function createOperationGetCommand(): Command {
+  const getCommand = new Command('get');
+  getCommand.description('Get operation details by ID');
+  getCommand.option('--id <id>', 'Operation ID');
+  getCommand.option('--code <code>', 'Operation code');
+  getCommand.option('--json', 'Output as JSON');
+
+  getCommand.action(async (options: Record<string, unknown>) => {
+    const context = configManager.getCurrentContext();
+    const environment = (options.env as Environment) || context.environment;
+    const tenant = (options.tenant as string) || context.tenant;
+
+    const id = options.id as string | undefined;
+    const code = options.code as string | undefined;
+
+    if (!id && !code) {
+      console.error(chalk.red('\n✗ Either --id or --code is required\n'));
+      process.exit(1);
+    }
+
+    const operationId = (id || code) as string;
+
+    try {
+      const response: OperationApiResponse = await apiClient.getOperationDetail(
+        environment,
+        tenant,
+        operationId
+      );
+
+      if (!response.success) {
+        const errorCode = response.error?.code || 'UNKNOWN_ERROR';
+        const errorMessage = response.error?.message || 'Unknown error';
+
+        if (errorCode === 'A150001' || errorMessage.includes('不存在')) {
+          console.error(chalk.red(`\n✗ Operation not found: ${operationId}\n`));
+        } else {
+          console.error(chalk.red(`\n✗ Error: ${errorMessage} (${errorCode})\n`));
+        }
+        process.exit(1);
+      }
+
+      const operation = response.data as Operation | null;
+
+      if (!operation) {
+        console.error(chalk.red('\n✗ Operation not found\n'));
+        process.exit(1);
+      }
+
+      if (options.json) {
+        console.log(JSON.stringify({
+          success: true,
+          data: operation,
+        }, null, 2));
+        return;
+      }
+
+      console.log(chalk.bold('\n🔧 Operation Details\n'));
+      console.log(`  ${chalk.gray('ID:')}            ${operation.operationId}`);
+      console.log(`  ${chalk.gray('Code:')}          ${operation.operationCode}`);
+      console.log(`  ${chalk.gray('Name:')}          ${operation.operationName}`);
+      console.log(`  ${chalk.gray('Type:')}          ${displayOperationType(operation.operationType)}`);
+      if (operation.workCenterCode) {
+        console.log(`  ${chalk.gray('Work Center:')}  ${operation.workCenterCode}`);
+      }
+      if (operation.mouldCode) {
+        console.log(`  ${chalk.gray('Mould Code:')}   ${operation.mouldCode}`);
+      }
+      if (operation.mouldType) {
+        console.log(`  ${chalk.gray('Mould Type:')}   ${operation.mouldType}`);
+      }
+      if (operation.equipmentType) {
+        console.log(`  ${chalk.gray('Equipment Type:')} ${operation.equipmentType}`);
+      }
+      if (operation.leadTime !== undefined && operation.leadTime !== null) {
+        console.log(`  ${chalk.gray('Lead Time:')}    ${operation.leadTime} hours`);
+      }
+      if (operation.remark) {
+        console.log(`  ${chalk.gray('Remark:')}       ${operation.remark}`);
+      }
+      console.log(`  ${chalk.gray('Status:')}        ${displayStatus(operation.statusFlag)}`);
+      console.log();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Unexpected error: ${error instanceof Error ? error.message : 'Unknown error'}\n`));
+      process.exit(1);
+    }
+  });
+
+  return getCommand;
+}