How khinya-khinev/receiving-service works
This is a warehouse goods-receiving backend. Managers maintain advance shipping notices (ASNs) and open or close goods receipts; workers join a receipt, scan handling units and contents, and complete their sessions. Receipt closure supports discrepancy reporting, while completed worker sessions support inventory put-away integration. The graph captures documented capabilities and source-visible calls; several API routes, event-listener bindings, and persistence details are represented only at subsystem level because their wiring was not shown in the excerpts.
Main entry points: ports Receiving ports · ReceivingProcessService.java Scanning sessions · GoodsReceiptService.java Receipt lifecycle · DiscrepanciesReportService.java Discrepancy calculation
Components 20
ASN management
- ASN API
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/api/AdvancedShippingNoticeController.java - ASN service
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/application/AdvancedShippingNoticeService.java - ASN records
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/domain/model/AdvancedShippingNoticeJpa.java
Receiving execution
- Receipt API
src/main/java/com/waregang/receiving_service/receiving_process/api/GoodsReceiptController.java - Worker API
src/main/java/com/waregang/receiving_service/receiving_process/api/ReceivingProcessController.java - Receipt lifecycle
src/main/java/com/waregang/receiving_service/receiving_process/application/GoodsReceiptService.java - Scanning sessions
src/main/java/com/waregang/receiving_service/receiving_process/application/ReceivingProcessService.java - Session state
src/main/java/com/waregang/receiving_service/receiving_process/domain/model/WorkerReceivingSession.java - Receiving ports
src/main/java/com/waregang/receiving_service/receiving_process/application/ports - ASN lookup adapter
src/main/java/com/waregang/receiving_service/receiving_process/infrastructure/AsnInfoProviderAdapter.java
Persistence
- ASN repositories
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/infrastructure/jpa_repositories/AdvancedShippingNoticeRepositoryJpa.java - Receipt storage
src/main/java/com/waregang/receiving_service/receiving_process/infrastructure/adapters/GoodsReceiptJpaRepoAdapter.java - Session storage
src/main/java/com/waregang/receiving_service/receiving_process/infrastructure/adapters/WorkerReceivingSessionJpaRepoAdapter.java
Downstream integrations
- Discrepancy calculation
src/main/java/com/waregang/receiving_service/integration/discrepancies_report/application/DiscrepanciesReportService.java - Report Kafka adapter
src/main/java/com/waregang/receiving_service/integration/discrepancies_report/infrastructure/KafkaDiscrepanciesReportAdapter.java - Put-away integration
src/main/java/com/waregang/receiving_service/integration/putaway/application/InventoryIntegrationService.java - Inventory Kafka adapter
src/main/java/com/waregang/receiving_service/integration/putaway/infrastrusture/KafkaInventoryAdapter.java
Other components
- Manager
- Warehouse worker
- Downstream warehouse systems
Connections 25
- Manager → ASN API: manages ASNs
- ASN API → ASN service: routes requests
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/api/AdvancedShippingNoticeController.java - ASN service → ASN repositories: reads and writes
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/application/AdvancedShippingNoticeService.java - ASN service → ASN records: maps ASN
src/main/java/com/waregang/receiving_service/advanced_shipping_notice/application/AdvancedShippingNoticeService.java - Manager → Receipt API: starts receipts
- Receipt API → Receipt lifecycle: routes receipt actions
src/main/java/com/waregang/receiving_service/receiving_process/api/GoodsReceiptController.java - Warehouse worker → Worker API: scans goods
- Worker API → Scanning sessions: routes scan actions
src/main/java/com/waregang/receiving_service/receiving_process/api/ReceivingProcessController.java - Scanning sessions → ASN lookup adapter: checks ASN
src/main/java/com/waregang/receiving_service/receiving_process/application/ReceivingProcessService.java - Scanning sessions → Receiving ports: uses repositories
src/main/java/com/waregang/receiving_service/receiving_process/application/ReceivingProcessService.java - Scanning sessions → Session state: updates session
src/main/java/com/waregang/receiving_service/receiving_process/application/ReceivingProcessService.java - Receipt lifecycle → Receiving ports: uses repositories
src/main/java/com/waregang/receiving_service/receiving_process/application/GoodsReceiptService.java - Receipt lifecycle → ASN lookup adapter: loads ASN details
src/main/java/com/waregang/receiving_service/receiving_process/application/GoodsReceiptService.java - Receiving ports → Receipt storage: persists receipts
- Receiving ports → Session storage: persists sessions
src/main/java/com/waregang/receiving_service/receiving_process/infrastructure/adapters/WorkerReceivingSessionJpaRepoAdapter.java - ASN lookup adapter → ASN service: uses ASN lookup
- Receipt lifecycle → Discrepancy calculation: publishes closure event
- Discrepancy calculation → ASN repositories: reads expected quantities
src/main/java/com/waregang/receiving_service/integration/discrepancies_report/application/DiscrepanciesReportService.java - Discrepancy calculation → Receiving ports: reads received quantities
src/main/java/com/waregang/receiving_service/integration/discrepancies_report/application/DiscrepanciesReportService.java - Discrepancy calculation → Report Kafka adapter: sends report
src/main/java/com/waregang/receiving_service/integration/discrepancies_report/application/DiscrepanciesReportService.java - Scanning sessions → Put-away integration: signals session completion
- Put-away integration → Receiving ports: reads received units
src/main/java/com/waregang/receiving_service/integration/putaway/application/InventoryIntegrationService.java - Put-away integration → Inventory Kafka adapter: forwards put-away request
src/main/java/com/waregang/receiving_service/integration/putaway/application/InventoryIntegrationService.java - Report Kafka adapter → Downstream warehouse systems: publishes report
- Inventory Kafka adapter → Downstream warehouse systems: publishes put-away