@newpeak/barista-cli 0.1.7 → 0.1.9

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

@@ -0,0 +1,128 @@
+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 } from '../../../types/operation.js';
+
+export function createOperationsDeleteCommand(): Command {
+  const deleteCommand = new Command('delete');
+  deleteCommand
+    .description('Delete an operation')
+    .option('--id <id>', 'Operation ID')
+    .option('--force', 'Skip confirmation and delete directly')
+    .option('--dry-run', 'Preview without making API call')
+    .option('--json', 'Output as JSON')
+    .action(async (options: Record<string, unknown>) => {
+      const context = configManager.getCurrentContext();
+      const environment = context.environment as Environment;
+      const tenant = context.tenant;
+      const dryRun = options.dryRun === true;
+      const jsonOutput = options.json === true;
+      
+      const operationId = options.id as string | undefined;
+      if (!operationId) {
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: false, error: { code: 'MISSING_ID', message: '--id is required' } }));
+        } else {
+          console.error(chalk.red('\n✗ --id is required\n'));
+        }
+        process.exit(1);
+      }
+
+      if (!jsonOutput) {
+        console.log(chalk.bold(`\n🗑️  Delete Operation (${environment})\n`));
+        console.log(chalk.gray(`  Operation ID: ${operationId}`));
+      }
+
+      let operation: Operation | undefined;
+      try {
+        const operationResponse = await apiClient.getOperationDetail(environment, tenant, operationId);
+        if (!operationResponse.success || !operationResponse.data || !('operationId' in operationResponse.data)) {
+          const errMsg = `Operation not found: ${operationId}`;
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: { code: 'NOT_FOUND', message: errMsg } }));
+          } else {
+            console.error(chalk.red(`\n✗ ${errMsg}\n`));
+          }
+          process.exit(1);
+        }
+        operation = operationResponse.data as Operation;
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : 'Unknown error';
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: false, error: { code: 'FETCH_ERROR', message: `Failed to fetch operation: ${errMsg}` } }));
+        } else {
+          console.error(chalk.red(`\n✗ Failed to fetch operation: ${errMsg}\n`));
+        }
+        process.exit(1);
+      }
+
+      if (!jsonOutput) {
+        console.log(chalk.gray(`  Name: ${operation.operationName}`));
+        console.log(chalk.gray(`  Code: ${operation.operationCode}`));
+        console.log(chalk.gray(`  Type: ${operation.operationType}`));
+        if (operation.workCenterCode) {
+          console.log(chalk.gray(`  Work Center: ${operation.workCenterCode}`));
+        }
+        if (operation.leadTime) {
+          console.log(chalk.gray(`  Lead Time: ${operation.leadTime}h`));
+        }
+      }
+
+      if (dryRun) {
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: true, dryRun: true, operation }));
+        } else {
+          console.log(chalk.cyan('\n🔍 Dry-Run Mode: No actual deletion will be made\n'));
+          console.log(chalk.yellow('  To delete, add: --force\n'));
+        }
+        return;
+      }
+
+      if (!options.force) {
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: true, dryRun: true, operation }));
+        } else {
+          console.log(chalk.cyan('\n🔍 Dry-Run Mode: No actual deletion will be made\n'));
+          console.log(chalk.yellow('  To delete, add: --force\n'));
+        }
+        return;
+      }
+
+      try {
+        const response = await apiClient.deleteOperation(environment, tenant, operationId);
+
+        if (response.success) {
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, operationId, name: operation.operationName }));
+          } else {
+            console.log(chalk.green(`\n✓ Operation "${operation.operationName}" (ID: ${operationId}) deleted\n`));
+          }
+        } else {
+          const errorMsg = response.error?.message || 'Unknown error';
+          const errorCode = response.error?.code || 'DELETE_ERROR';
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: { code: errorCode, message: errorMsg } }));
+          } else {
+            console.error(chalk.red(`\n✗ Failed to delete operation: ${errorMsg}`));
+            if (response.error?.code) {
+              console.error(chalk.gray(`  Error code: ${response.error.code}`));
+            }
+            console.error();
+          }
+          process.exit(1);
+        }
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : 'Unknown error';
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: false, error: { code: 'ERROR', message: errMsg } }));
+        } else {
+          console.error(chalk.red(`\n✗ Error: ${errMsg}\n`));
+        }
+        process.exit(1);
+      }
+    });
+
+  return deleteCommand;
+}

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*