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:

1. Project Overview — what Logidav does and where it sits in the ecosystem
2. Architecture — how bundles, queues, and data flows connect
3. Sales Import workflow — the most critical workflow in the system

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:

1. Queue Model — how async processing works
2. Stock Updates — stock mutation lifecycle
3. Coding Style — conventions and validation commands
4. DPD Integration — example carrier integration

Operator / DevOps

After completing the required reading, focus on:

1. Queue Debugging runbook — diagnosing stuck or failed queues
2. Cron Incident Triage — responding to cron failures
3. 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