FS-WPC-001: Work Piece Carrier Functions¶
| Property | Value |
|---|---|
| ID | FS-WPC-001 |
| Version | 1.0 |
| Corresponding URS | URS-WPC-001 |
| Status | Draft |
| Author | |
| Approved By | |
| Date |
Architecture Reference¶
Functional Specifications¶
FS-WPC-001.1: Create Work Piece Carrier¶
Covers URS: URS-WPC-001.1
Input Specification:
| Parameter | Type | Constraints | Required |
|---|---|---|---|
| Name | string | Max 100 chars | Yes |
| RfidTag | string | RFID identifier | Yes |
| Type | string | Carrier type | Yes |
| Creator | string | Max 30 chars | Yes |
Output Specification:
| Field | Type | Description |
|---|---|---|
| Uid | long | Auto-generated WPC UID |
| Name | string | WPC name |
| RfidTag | string | RFID tag |
| Type | string | Carrier type |
| Crc | long | Integrity checksum |
Business Rules: - UID via AUTO_INCREMENT, CRC via two-phase insert - RFID tag stored for physical tracking on the factory floor
FS-WPC-001.2: Query Work Piece Carriers¶
Covers URS: URS-WPC-001.2
Input Specification:
| Parameter | Type | Constraints | Required |
|---|---|---|---|
| Uid | long | For single lookup | Conditional |
| RfidTag | string | For RFID lookup | Conditional |
| Type | string | For type filtering | Conditional |
Output Specification: List of WpcDto or single WpcDto.
Error Handling:
| Error Condition | Response | HTTP Status |
|---|---|---|
| WPC not found (by UID) | "WPC not found" | 404 |
| No results (by filter) | Empty array | 200 |
FS-WPC-001.3: Update and Delete Work Piece Carriers¶
Covers URS: URS-WPC-001.3
Update Input:
| Parameter | Type | Required |
|---|---|---|
| Uid | long | Yes |
| Name | string | No |
| RfidTag | string | No |
| Type | string | No |
Business Rules: - CRC recalculated on any update - Delete removes the record permanently
CQRS Handler Mapping¶
| FS Item | Command/Query | Handler |
|---|---|---|
| FS-WPC-001.1 | CreateWorkPieceCarrierCommand | CreateWorkPieceCarrierHandler |
| FS-WPC-001.2 | GetWpcByIdQuery / GetWpcByRfidQuery | GetWpcByIdHandler / GetWpcByRfidHandler |
| FS-WPC-001.3 | UpdateWorkPieceCarrierCommand / DeleteWorkPieceCarrierCommand | UpdateWpcHandler / DeleteWpcHandler |