# Specimen Delete Endpoint

## Overview
Add DELETE endpoint for specimens to complete CRUD operations.

## Current State
- GET /api/specimen - List specimens ✅
- GET /api/specimen/(:num) - Get single specimen ✅
- POST /api/specimen - Create specimen ✅
- PATCH /api/specimen - Update specimen ✅
- DELETE /api/specimen/(:num) - **MISSING** ❌

## Requirements

### Route

Add to `app/Config/Routes.php` in the specimen group:

```php
$routes->group('specimen', function ($routes) {
    // ... existing routes ...
    $routes->delete('(:num)', 'Specimen\SpecimenController::delete/$1');
});
```

### Controller Method

Add to `app/Controllers/Specimen/SpecimenController.php`:

```php
/**
 * Delete a specimen (soft delete)
 * DELETE /api/specimen/(:num)
 */
public function delete($id) {
    try {
        // Check if specimen exists
        $specimen = $this->model->where('SID', $id)->first();
        
        if (empty($specimen)) {
            return $this->respond([
                'status' => 'failed',
                'message' => 'Specimen not found',
                'data' => null
            ], 404);
        }
        
        // Perform soft delete (set DelDate)
        $deleted = $this->model->update($id, [
            'DelDate' => date('Y-m-d H:i:s')
        ]);
        
        if (!$deleted) {
            return $this->respond([
                'status' => 'failed',
                'message' => 'Failed to delete specimen',
                'data' => null
            ], 500);
        }
        
        return $this->respond([
            'status' => 'success',
            'message' => 'Specimen deleted successfully',
            'data' => ['SID' => $id]
        ], 200);
        
    } catch (\Exception $e) {
        log_message('error', 'SpecimenController::delete error: ' . $e->getMessage());
        return $this->respond([
            'status' => 'failed',
            'message' => 'Failed to delete specimen',
            'data' => null
        ], 500);
    }
}
```

## Expected Request/Response

### Request
```http
DELETE /api/specimen/123 HTTP/1.1
```

### Success Response (200)
```json
{
  "status": "success",
  "message": "Specimen deleted successfully",
  "data": {
    "SID": 123
  }
}
```

### Not Found Response (404)
```json
{
  "status": "failed",
  "message": "Specimen not found",
  "data": null
}
```

### Error Response (500)
```json
{
  "status": "failed",
  "message": "Failed to delete specimen",
  "data": null
}
```

## Implementation Notes

1. **Use soft delete**: Set `DelDate` field instead of hard delete
2. **Check existence first**: Return 404 if specimen doesn't exist
3. **Use SID as identifier**: The specimen ID field is `SID`, not `id`
4. **Follow existing patterns**: Match style of other delete methods in codebase