@newpeak/barista-cli 0.1.11 → 0.1.12

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

@@ -1,587 +0,0 @@
-# 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

@@ -1,112 +0,0 @@
-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;
-}