System Workflows
This section documents the core business processes that drive Logidav. Each workflow page follows a consistent template so that any developer can quickly understand what a process does, how it connects to other systems, what triggers it, and how to debug it when things go wrong.
Documented Workflows
| Workflow | Criticality | Description | Key Command |
|---|---|---|---|
| Sales Import | Critical | Ingests and synchronizes orders from Magento 2 | menzzo:v2:sales |
| Stock Updates | Critical | Journals every stock mutation and propagates to marketplaces | ProductQtyLogService::productChangeLog() |
| Shipment Generation | High | Generates carrier labels and syncs tracking numbers | sale:expedition:import |
| Refunds & SAV | Critical | Processes returns, refunds, and after-sales complaints | Refund commands |
| Product Sync | High | Pushes catalog data to marketplaces and keeps availability in sync | menzzo:v2:products |
Page Template
Every workflow page follows this structure:
- What it does -- one-paragraph summary of the workflow's purpose
- How it connects -- mermaid diagram showing all systems involved
- Trigger -- what starts the workflow (cron schedule, event, manual action)
- Components -- table listing every command, service, and entity with file paths
- Step-by-step flow -- mermaid flowchart with decision points
- Side effects -- what changes in the database and external systems
- Failure modes -- what can go wrong, with severity admonitions
- Debugging path -- numbered steps to investigate issues
- Related commands -- CLI commands involved
Cross-References
- Queue Model -- how asynchronous processors dispatch work
- Data Flow -- high-level data movement across the platform
- Queue Debugging Runbook -- step-by-step queue troubleshooting