Reyhan Commerce | Reyhan Framework

🛡

Strict Core vs. User-Land Boundary

Clean Composer package architecture. Extend models and inject pipelines with zero fear of breaking vendor code during framework updates.

🎯

Action & DTO Architecture

Follows Farshid's premier Laravel Constitution with final Action classes, typed DTOs, native Eloquent queries, and strictly zero repository bloat.

🔌

Dynamic Model Extensibility

Swap or augment core Eloquent models (Product, Order, Variant) at runtime using Reyhan::useModel() with automatic polymorphic resolution.

🔒

Two-Tier Concurrency Protection

Prevents overselling during high-traffic flash sales using fast atomic Redis memory mutexes paired with PostgreSQL pessimistic row locks.

⚖️

Double-Entry Financial Ledger

Strictly balanced accounting entries (debit == credit) for all monetary transactions, customer wallets, and invoice records.

💳

Multi-Driver Payments & Iranian SMS

Driver-based integration with Shetabit banking gateways (Zarinpal, SEP, Mellat) and pattern-based transactional SMS engines.

Headless Architecture & Decoupled Ecosystem

Reyhan Commerce is an architecturally pure, headless backend e-commerce framework designed for engineering teams building resilient, scalable commerce platforms.

Architecture Overview

text

┌─────────────────────────────────────────────────────────────┐
│                 reyhan-commerce/installer                    │
│      Composer Global CLI Scaffolder: `reyhan new my-store`  │
└──────────────────────────────┬──────────────────────────────┘
                               │ provisions
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                   reyhan-commerce/reyhan                    │
│   Starter Application Skeleton (Standard Laravel 13 Layout) │
│       app/, config/, database/, extensions/, routes/        │
└──────────────────────────────┬──────────────────────────────┘
                               │ consumes
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                    reyhan-commerce/core                     │
│  Sovereign Commerce Engine Package (vendor/reyhan-commerce) │
│  - First-Class Domain Facades (Cart, Pricing, Ledger)       │
│  - Commercial Calculation & Order Fulfillment Pipelines     │
│  - Dynamic Model Resolution & Extension Service Provider    │
│  - Filament 5 Admin Backoffice & OpenAPI Documentation      │
└──────────────────────────────┬──────────────────────────────┘
                               │
               RESTful JSON APIs & WebSockets
                               │
       ┌───────────────────────┴───────────────────────┐
       ▼                                               ▼
┌──────────────────────────────┐        ┌──────────────────────────────┐
│    Custom Client Layers      │        │  Official Nuxt 4 Storefront  │
│  - Flutter / React Native    │        │  - reyhan-commerce/          │
│  - Telegram Mini Apps        │        │    storefront-nuxt           │
│  - Next.js / Svelte / Remix  │        │  - 🚀 Coming Soon / In Dev   │
└──────────────────────────────┘        └──────────────────────────────┘

Reyhan CommerceThe Sovereign Headless E-Commerce Backend Framework