عرض عملي: مخططات C4 لـ Shop Platform كشيفرة

خطوة بخطوة

1. Create workspace.dsl in Structurizr (or Mermaid/PlantUML); define the customer and the payment provider.
2. Add containers: web app, API gateway, orders, inventory, payments, Postgres, Kafka.
3. Add relationships with labels and technologies.
4. Planned mistake: unlabeled arrows and no legend; a viewer cannot tell sync from async. Fix: label each arrow and add a legend and title.
5. Add a component view of orders and render all views.
6. Commit the file and render in CI so the diagram never drifts.