First Day Reading
This page provides a prioritized reading list for your first days on the Logidav project. Follow the required reading in order, then branch into the path that matches your role.
Required reading
Read these pages in order to build your mental model of the system:
- Project Overview — what Logidav does and where it sits in the ecosystem
- Architecture — how bundles, queues, and data flows connect
- Sales Import workflow — the most critical workflow in the system
:::tip Why Sales Import first? Sales Import touches every major subsystem — Magento API, order normalization, stock mutations, queue entries, and carrier handoff. Understanding this workflow gives you a working knowledge of how the entire system operates. :::
Role-specific paths
Backend developer
After completing the required reading, continue with:
- Queue Model — how async processing works
- Stock Updates — stock mutation lifecycle
- Coding Style — conventions and validation commands
- DPD Integration — example carrier integration
Operator / DevOps
After completing the required reading, focus on:
- Queue Debugging runbook — diagnosing stuck or failed queues
- Cron Incident Triage — responding to cron failures
- System Crontab — the full production crontab
Quick reference
| Question | Where to find the answer |
|---|---|
| How do I run the project locally? | Local Setup |
| Where is the code for a specific cronjob? | Repository Map |
| How do Magento orders get into Logidav? | Sales Import |
| How do I debug a stuck queue? | Queue Debugging |
| Which cronjobs are critical? | Cronjob Reference |
| How is stock updated? | Stock Updates |
| What are the coding conventions? | Coding Style |