서열 출고와 시뮬레이션

매장별 출고 단위를 서열대로 팔레트에 묶어 로봇 셀로 보내고, 시뮬레이터 워커의 응답과 매니페스트, 실패 경로, 가정 시나리오를 확인합니다.

무엇을 · 왜#

출고는 매장별로 쌓는 순서가 중요합니다. 이 화면은 출고 단위에 서열 위치와 목표 팔레트를 정하고, 같은 팔레트로 묶인 항목을 한 번의 PALLETIZE 명령으로 로봇 셀에 보냅니다. 설비가 없어도 끝까지 돌려 볼 수 있도록 저장소에 시뮬레이터 워커가 들어 있습니다. 워커는 게이트웨이 계정으로 로그인해 실제 설비와 똑같은 함수로 결과를 보고합니다.

따라 하기#

처음 상태에서 시작합니다: cd supabase && supabase db reset. WCS Equipment 에서 wh-manager-a@demo.local 로 CELL-01, CELL-02(Type ROBOT_CELL, Zone ZONE-PACK)를 등록하고, 앞 장처럼 게이트웨이 보고로 IDLE 로 만듭니다.

1. 시뮬레이션 켜기. WCS Simulation 을 엽니다. 두 대 모두 REAL 입니다. CELL-01 의 Simulate 를 누르면 SIMULATED 가 되고 Source 는 기본값 입니다. 기본값은 ack 500ms~1.5s, progress 1.0s~3.0s, completion 2.0s~5.0s, 실패율 5% 입니다.

   

2. 프로파일. 결과가 흔들리지 않도록 Ack 500~800, Progress 800~1200, Completion 1200~1800, Failure rate 0 을 넣고 Save Profile 을 누릅니다. Source 가 등록 프로파일 로 바뀝니다.

   

3. 출고 단위 등록. WCS Sequencing 에서 Open Wave 를 누르고 아래 세 건을 Create Outbound Order 로 넣습니다. | Order Number | Store Code | Product | Qty | Weight (kg) | Volume (L) | |---|---|---|---|---|---| | OB-0001 | STORE-042 | SKU-A-001 | 10 | 4.2 | 3.1 | | OB-0002 | STORE-042 | SKU-A-002 | 4 | 6 | 5 | | OB-0003 | STORE-077 | SKU-A-003 | 2 | 240 | 10 |

   

4. 서열 배정. Assign Sequence 로 OB-0001 은 위치 1, OB-0002 는 위치 2, 둘 다 팔레트 PLT-042-01 에, OB-0003 은 위치 3, 팔레트 PLT-077-01 에 넣습니다. 팔레트 현황에서 PLT-042-01 의 선언 중량 합계는 10.2 kg, 용적은 8.1 L 입니다.

   

5. 상한 확인. Robot Cell CELL-01, Target Pallet PLT-077-01, Max Weight 100 으로 Dispatch PALLETIZE 를 누릅니다. INVALID: declared weight 240 kg exceeds max_weight_kg 100 for pallet PLT-077-01 로 거부되고 아무것도 나가지 않습니다.

   

6. 명령 보내기. Target Pallet PLT-042-01, Max Weight 250, Max Volume 500 으로 Dispatch PALLETIZE 를 누릅니다. 「CELL-01에 2건 (선언 10.2kg / 8.1L)」이 보이고, 두 항목이 명령 하나에 실려 DISPATCHED 가 됩니다.

   

7. 워커 실행. mcp 폴더에서 워커를 돌립니다. --once 는 밀린 명령을 끝까지 진행하고 끝납니다. 계속 띄워 두려면 --loop --interval 1 을 씁니다.

   .venv/bin/python -m wms_mcp.simulator.wcs_gateway_simulator --once
   

   PALLETIZE … -> ACKNOWLEDGED, -> IN_PROGRESS, -> COMPLETED 로그가 차례로 나옵니다.

   

8. 매니페스트. WCS Sequencing 을 새로 고칩니다. 위치 1, 2 가 COMPLETED, Load Pos 1, 2 입니다. 팔레트 매니페스트 의 PLT-042-01 은 SUCCESS, 두 항목 모두 LOADED 입니다. 실측 중량은 시뮬레이터가 선언값을 그대로 돌려준 것입니다.

   

9. 실패 경로. WCS Simulation 에서 Failure rate 를 1 로 저장합니다. WCS Sequencing 에서 PLT-077-01 을 Max Weight 300 으로 보냅니다. 워커를 --tick 으로 한 번 돌리면 진행 중인 계획 에 Planned outcome FAILED / ABORTED 가 보입니다. 결과는 계획을 세울 때 이미 정해집니다.

   

10. 실패 결과. 워커를 --once 로 돌립니다. PLT-077-01 은 FAILED / ABORTED, 항목은 SKIPPED(SIMULATED_ABORT), 서열 3 은 FAILED 입니다.

    

11. 가정 시나리오. WCS Simulation 의 what-if 에서 Name 야간 축소 운전, Command count 10, Linked entity dispatch_wave, CELL-01 과 CELL-02 를 고르고 Create Scenario 후 Run 을 누릅니다. 이 실행에서는 「5회전 · 20.1s · 실패 5건」이 나왔습니다. CELL-01 의 실패율을 1 로 바꿔 둔 상태라 실패가 많고, 값은 프로파일에 따라 달라집니다. CELL-02 는 프로파일이 없어 DEFAULT_PROFILE_APPLIED 경고가 붙습니다. 이 동안 설비 명령은 한 건도 늘지 않습니다.

    

같은 영역의 다른 화면#

이 장은 합성 데이터 없이 끝까지 돌아가는 서열 출고와 시뮬레이션을 골랐습니다. 다른 세 화면도 저장소에 있고, 흐름은 frontend/playwright/e2e/ 의 스펙이 그대로 보여 줍니다.

확인 문제#