تسلط بر نمودارهای کلاس UML: یک مطالعه موردی عملی در طراحی سیستم با استفاده از PlantUML

@startuml
class Order {
  -orderId: String
  -orderDate: Date
  +calculateTotal(): Double
  +addItem(item: Product, qty: int): void
}
@enduml

@startuml
title مدل مفهومی: حوزه تجارت الکترونیکی

class مشتری {
  نام
  ایمیل
  آدرس تحویل
}

class محصول {
  نام
  توضیحات
  قیمت پایه
}

class دسته‌بندی {
  نام
  توضیحات
}

class سفارش {
  شماره‌ی سفارش
  تاریخ سفارش
  وضعیت
  مبلغ کل
}

class آیتم‌ی سفارش {
  تعداد
  قیمت واحد
  مبلغ جزئی
}

class پرداخت {
  روش پرداخت
  شناسه‌ی تراکنش
  مبلغ
  زمان‌چین
}

' روابط
مشتری "۱" -- "۰..*" سفارش : می‌گذارد >
سفارش "۱" *-- "۱..*" آیتم‌ی سفارش : شامل است >
محصول "۱" -- "۰..*" آیتم‌ی سفارش : در آن ظاهر می‌شود >
محصول "۰..*" -- "۱" دسته‌بندی : به آن تعلق دارد >
سفارش "۱" -- "۱..*" پرداخت : تسویه شده توسط >

note right of سفارش
  یک سفارش نماینده‌ی قصد خرید و تراکنش مشتری است
end note

@enduml

@startuml
title مدل مشخصات: رابط‌های سرویس

interface IOrderService {
  +createOrder(customerId: String, items: List<OrderItemDTO>): OrderDTO
  +getOrder(orderId: String): OrderDTO
  +updateOrderStatus(orderId: String, status: OrderStatus): boolean
  +calculateOrderTotal(orderId: String): Money
}

interface IPaymentProcessor {
  +processPayment(orderId: String, paymentDetails: PaymentDTO): PaymentResult
  +refundPayment(transactionId: String, amount: Money): RefundResult
}

interface IInventoryService {
  +checkAvailability(productId: String, quantity: int): boolean
  +reserveItems(orderId: String, items: List<ReservationItem>): boolean
  +releaseReservation(orderId: String): void
}

class OrderDTO {
  +orderId: String
  +customerId: String
  +items: List<OrderItemDTO>
  +total: Money
  +status: OrderStatus
}

class OrderItemDTO {
  +productId: String
  +quantity: int
  +unitPrice: Money
}

' وابستگی‌ها
IOrderService ..> IInventoryService : استفاده می‌کند >
IOrderService ..> IPaymentProcessor : هماهنگی می‌کند >
IOrderService ..> OrderDTO : بازگشت می‌دهد >

note bottom of IOrderService
  قرارداد مدیریت سفارش را تعریف می‌کند.
  پیاده‌سازی‌ها می‌توانند متفاوت باشند (سرویس‌های کوچک، برنامه یکپارچه و غیره)
end note

@enduml

@startuml
title مدل پیاده‌سازی: کلاس‌های جاوا/اسپرینگ بوت

package com.ecommerce.order.entity {
  class Order {
    -@Id orderId: UUID
    -@ManyToOne customer: Customer
    -@OneToMany(cascade=ALL) items: List<OrderItem>
    -orderDate: LocalDateTime
    -status: OrderStatus
    -totalAmount: BigDecimal
    
    +addItem(product: Product, qty: int): void
    +calculateTotal(): BigDecimal
    +markAsShipped(): void
  }
  
  class OrderItem {
    -@Id itemId: UUID
    -@ManyToOne order: Order
    -@ManyToOne product: Product
    -quantity: int
    -unitPrice: BigDecimal
    
    +getSubtotal(): BigDecimal
  }
  
  enum OrderStatus {
    PENDING
    CONFIRMED
    SHIPPED
    DELIVERED
    CANCELLED
  }
}

package com.ecommerce.payment.service {
  class PaymentService {
    -@Autowired paymentGateway: PaymentGateway
    -@Autowired orderRepository: OrderRepository
    
    +processPayment(orderId: UUID, dto: PaymentRequest): PaymentResponse
    -validatePaymentDetails(dto: PaymentRequest): void
    -updateOrderPaymentStatus(orderId: UUID, status: PaymentStatus): void
  }
  
  interface PaymentGateway {
    +charge(amount: BigDecimal, card: CardDetails): TransactionResult
    +refund(transactionId: String, amount: BigDecimal): RefundResult
  }
}

' روابط
Order "1" *-- "1..*" OrderItem : ترکیب >
Order ..> PaymentService : وابسته به >
PaymentService ..> PaymentGateway : اجرا از طریق >

note right of OrderItem
  نشانه @Entity به جدول پایگاه داده مربوط می‌شود.
  Cascade=ALL اطمینان می‌دهد که آیتم‌ها با سفارش ذخیره شوند.
end note

@enduml

@startuml
class BankAccount {
  +accountNumber: String
  +getBalance(): BigDecimal
  -balance: BigDecimal
  -transactionHistory: List<Transaction>
  #calculateInterest(rate: double): BigDecimal
  ~internalAudit(): void
}

note right of BankAccount
  + عمومی: API برای مشتریان خارجی
  - خصوصی: وضعیت داخلی، دسترسی خارجی ندارد
  # محافظت‌شده: برای گسترش زیرکلاس
  ~ بسته: قابل دیدن در محدوده یک ماژول
end note
@enduml

@startuml
class ShoppingCart {
  +addItem(product: Product, qty: int): void
  +removeItem(productId: String): boolean
}

class Product {
  +name: String
  +price: BigDecimal
  +inStock: boolean
}

' یک سبد خرید می‌تواند 0 تا چند مورد داشته باشد
' هر مورد دقیقاً به یک محصول اشاره می‌کند
ShoppingCart "1" *-- "0..*" Product : شامل >

note bottom
  قوانین چندگانگی:
  • 0..* = اختیاری، چند (بیشترین مورد)
  • 1 = دقیقاً یکی (ضروری)
  • 0..1 = اختیاری، تکی (مثلاً عکس پروفایل)
  • 1..* = حداقل یکی (مثلاً موارد سفارش)
end note
@enduml

@startuml
abstract class Notification {
  #recipient: String
  #message: String
  +abstract send(): boolean
  +logDelivery(): void
}

interface EmailNotification {
  +subject: String
  +send(): boolean
}

interface SMSNotification {
  +phoneNumber: String
  +send(): boolean
}

Notification <|-- EmailNotification
Notification <|-- SMSNotification

note right of Notification
  کلاس مجرد: حالت مشترک + پیاده‌سازی جزئی
  رابط: قرارداد خالص، پشتیبانی از ارث‌گیری چندگانه
end note
@enduml