How abdulrahman-alholo/syrian-souq works
Syrian-Souq is a Laravel multi-vendor marketplace. Customers browse products, manage a multi-vendor cart, check out, and pay; orders can then be split into vendor-specific fulfillment records. The wider product includes vendor and platform-admin panels, order state enforcement, a financial ledger and payout lifecycle, and payment webhooks. The graph emphasizes documented capabilities and relationships visible in excerpts or the source index; some administrative and finance links are intentionally left unconnected because their implementation was not sampled.
Main entry points: CheckoutService.php Checkout · CartController.php Cart endpoints · PaymentService.php Payment service · ProcessPaymentWebhookJob.php Webhook processing
Components 22
Storefront commerce
- Product catalog
app/Modules/Catalog/Services/CatalogQueryService.php - Product variants
app/Modules/Catalog/Models/ProductVariant.php - Cart endpoints
app/Modules/Cart/Controllers/CartController.php - Cart management
app/Modules/Cart/Services/CartService.php - Checkout
app/Modules/Cart/Services/CheckoutService.php
Orders and fulfillment
- Order service
app/Modules/Order/Services/OrderService.php - Vendor order splitting
app/Jobs/SplitOrderIntoVendorOrdersJob.php - Vendor orders
app/Modules/Order/Models/VendorOrder.php - Order state workflow
app/Modules/Order/Services/OrderWorkflowService.php - Vendor order observer
app/Modules/Order/Observers/VendorOrderObserver.php
Payments and finance
- Payment service
app/Modules/Payment/Services/PaymentService.php - Gateway selection
app/Modules/Payment/Factories/PaymentGatewayFactory.php - Stripe gateway
app/Modules/Payment/Gateways/StripeGateway.php - Webhook intake
app/Modules/Payment/Controllers/WebhookController.php - Webhook processing
app/Jobs/ProcessPaymentWebhookJob.php - Payment and webhook records
app/Modules/Payment/Models/Payment.php - Financial ledger
app/Modules/Finance/Services/LedgerService.php - Payout lifecycle
app/Modules/Finance/Services/PayoutService.php
Marketplace operations
- Admin and vendor panels
app/Providers/Filament - Marketplace management
app/Filament/Resources
Other components
- Customer
- Stripe
Connections 23
- Customer → Product catalog: browses
README.md - Customer → Cart endpoints: manages cart
README.md - Cart endpoints → Cart management: delegates to
app/Modules/Cart/Controllers/CartController.php - Cart endpoints → Checkout: starts checkout
app/Modules/Cart/Controllers/CartController.php - Cart endpoints → Payment service: initiates payment
app/Modules/Cart/Controllers/CartController.php - Cart management → Product variants: uses
app/Modules/Cart/Services/CartService.php - Checkout → Product variants: locks and checks
app/Modules/Cart/Services/CheckoutService.php - Checkout → Vendor order splitting: dispatches
app/Modules/Cart/Services/CheckoutService.php - Checkout → Order service: delegates cancellation
app/Modules/Cart/Services/CheckoutService.php - Vendor order splitting → Vendor orders: creates via splitter
app/Jobs/SplitOrderIntoVendorOrdersJob.php - Vendor order observer → Order state workflow: invokes
app/Modules/Order/Observers/VendorOrderObserver.php - Payment service → Gateway selection: selects gateway
app/Modules/Payment/Services/PaymentService.php - Gateway selection → Stripe gateway: creates gateway
app/Modules/Payment/Factories/PaymentGatewayFactory.php - Payment service → Payment and webhook records: creates and updates
app/Modules/Payment/Services/PaymentService.php - Stripe gateway → Stripe: calls
- Stripe → Webhook intake: sends events
- Webhook intake → Webhook processing: dispatches
app/Modules/Payment/Controllers/WebhookController.php - Webhook processing → Gateway selection: selects gateway
app/Jobs/ProcessPaymentWebhookJob.php - Webhook processing → Payment and webhook records: reads and updates
app/Jobs/ProcessPaymentWebhookJob.php - Vendor orders → Financial ledger: ledger inputs
app/Modules/Finance/Services/LedgerService.php - Admin and vendor panels → Marketplace management: provides dashboards
README.md - Customer → Checkout: places order
README.md - Admin and vendor panels → Payout lifecycle: manages payouts
README.md