Panduan Diagram Use Case PlantUML

Pendahuluan

Gunakan kasus diagram menyediakan sebuah jelas cara untuk mendeskripsikan bagaimana pengguna, eksternal sistem, dan lain aktor berinteraksi dengan sebuah perangkat lunak sistem. Mereka membantu tim mendefinisikan sistem ruang lingkup, mengidentifikasi fungsional persyaratan, dan komunikasikan yang diharapkan perilaku sebelum implementasi dimulai.

PlantUML membuat penggunaan kasus pemodelan praktis melalui sebuah berbasis teks sintaks yang dapat disimpan, disimpan, ditinjau, diversi, dan dibuat ulang bersama proyek dokumentasi atau sumber kode. Dengan beberapa beberapa perintah, Anda dapat mendefinisikan aktor, gunakan kasus, sistem batas, asosiasi, <<include>> relasi, <<extend>> relasi, generalisasi, catatan, dan tata letak preferensi.

Panduan ini panduan ini menjelaskan kunci utama PlantUML gunakan kasus notasi ditampilkan di lembar referensi dan menunjukkan bagaimana untuk menerapkannya itu dalam realistis contoh. Ini juga memperkenalkan sebuah lebih luas perangkat alur kerja menggunakan Visual Paradigm UML, dibantu AI pemodelan, dan VPasCode. Bersama, alat-alat ini alat mendukung suatu lengkap proses: mengubah persyaratan menjadi sebuah awal model, memvalidasi UML hubungan, memperhalus model diagram, dan mempertahankan model akhir model sebagai dapat dibaca diagram sumber.

Diagram kasus penggunaan UML menggambarkan bagaimana pengguna eksternal atau sistem berinteraksi dengan suatu sistem. Diagram ini berfokus pada apa yang dilakukan sistem, bukan bagaimana sistem tersebut diimplementasikan.

PlantUML memungkinkan Anda membuat diagram kasus penggunaan menggunakan notasi berbasis teks yang sederhana.

1. Struktur dasar PlantUML

Setiap diagram PlantUML dimulai dengan @startuml dan diakhiri dengan @enduml.

@startuml

' Isi diagram ada di sini

@enduml

Komentar dimulai dengan tanda kutip tunggal:

' Ini adalah komentar

Anda juga dapat menggunakan komentar multi baris:

/'
Ini adalah
komentar multi-baris
'/

2. Mendefinisikan aktor

Sebuah aktor mewakili seseorang, peran, organisasi, perangkat, atau sistem eksternal yang berinteraksi dengan sistem Anda.

Aktor dasar

aktor User

Ini membuat sebuah aktor berupa figur tongkat bernama Pengguna.

Aktor dengan nama samaran

Nama samaran berguna ketika nama yang ditampilkan mengandung spasi atau ketika Anda menginginkan pengidentifikasi yang lebih pendek untuk relasi.

actor "Payment Gateway" as payment
actor "System Administrator" as admin

Anda kemudian dapat merujuk ke nama samaran:

pembayaran --> ProsesPembayaran
admin --> KelolaPengguna

Aktor menggunakan gaya visual yang berbeda

PlantUML mendukung beberapa gaya aktor. Gaya default biasanya sudah cukup, tetapi Anda dapat menggunakan aktor bergaya ikon:

skinparam actorStyle awesome

actor Pelanggan

Anda juga dapat menggunakan aktor bergaya persegi panjang polos:

skinparam actorStyle hollow

actor Customer

Tampilan yang tepat bergantung pada mesin perender PlantUML dan parameter kulit.

3. Mendefinisikan kasus penggunaan

Kasus penggunaan mewakili layanan, tujuan, atau fungsi yang disediakan oleh sistem.

Kasus penggunaan dasar

usecase "Log In"

PlantUML merender ini sebagai elips berlabel Masuk.

Use case dengan alias

usecase "Proses Pembayaran Kartu Kredit" sebagai ProcessPayment

Label yang terlihat adalah Proses Pembayaran Kartu Kredit, sementara ProcessPayment digunakan dalam relasi.

actor Customer
Customer --> ProcessPayment

Nama use-case multi-baris

Anda dapat menyisipkan jeda baris menggunakan n:

usecase "ProsesnPembayaran Kartu Kredit" sebagai ProcessPayment

Ini berguna ketika diagram berisi label yang panjang.

4. Batas sistem

Batas sistem mengelompokkan kasus penggunaan yang termasuk dalam sistem tertentu.

rectangle "Sistem Belanja Online" {
    usecase "Jelajahi Produk" sebagai Browse
    usecase "Checkout" sebagai Checkout
}

Persegi panjang mewakili sistem, dan kasus penggunaan di dalamnya mewakili fungsionalitas yang disediakan oleh sistem tersebut.

Anda juga dapat menggunakan alias bernama untuk batas:

rectangle "Sistem Belanja Online" sebagai OnlineStore {
    usecase "Jelajahi Produk" sebagai Browse
    usecase "Checkout" sebagai Checkout
}

Batas sistem berguna saat membedakan perilaku sistem dari aktor eksternal dan layanan.

5. Menghubungkan aktor dan kasus penggunaan

Asosiasi menunjukkan bahwa seorang aktor berpartisipasi dalam atau berinteraksi dengan sebuah kasus penggunaan.

Asosiasi tanpa arah

Customer -- Browse

Ini membuat garis solid tanpa kepala panah.

Arah asosiasi

Customer --> Browse

Ini membuat garis solid dengan kepala panah yang mengarah ke kasus penggunaan.

Kedua bentuk ini umum digunakan. Arah panah harus dipilih secara konsisten sesuai dengan komunikasi atau tanggung jawab yang ingin Anda tekankan.

Asosiasi dengan label

Pelanggan --> Checkout : dimulai

Label tersebut menggambarkan interaksi.

Pelanggan --> LihatPesanan : melihat riwayat pesanan

Untuk tata letak yang lebih mudah dibaca, Anda dapat menggunakan panah yang lebih panjang:

Pelanggan ---> Checkout : memulai

6. The <<include>> relasi

Sebuah termasuk relasi merepresentasikan perilaku yang selalu diperlukan oleh kasus penggunaan lain.

Sebagai contoh, pemesanan pesanan mungkin selalu memerlukan validasi pembayaran:

PlaceOrder ..> ValidatePayment : <<include>>

Arahnya penting:

Kasus penggunaan dasar ..> Kasus penggunaan yang disertakan : <<include>>

Panah mengarah dari kasus penggunaan yang memerlukan perilaku ke kasus penggunaan yang menyediakan perilaku yang dapat digunakan kembali.

Contoh

usecase "Checkout" sebagai Checkout
usecase "Validasi Detail Pelanggan" sebagai ValidateCustomer
usecase "Hitung Total Pesanan" sebagai CalculateTotal
usecase "Lakukan Pembayaran" sebagai MakePayment

Checkout ..> ValidateCustomer : <<include>>
Checkout ..> CalculateTotal : <<include>>
Checkout ..> MakePayment : <<include>>

Ini berarti:

1. Checkout selalu memvalidasi detail pelanggan.

2. Checkout selalu menghitung total pesanan.

3. Checkout selalu melakukan pembayaran.

Gunakan <<include>> ketika perilaku yang disertakan bersifat wajib atau dapat digunakan kembali.

7. The <<extend>> hubungan

Sebuah perluasan hubungan merepresentasikan perilaku opsional, kondisional, atau pengecualian yang ditambahkan ke kasus penggunaan dasar.

Sebagai contoh, pemberian diskon mungkin hanya terjadi ketika pelanggan memiliki kupon yang valid:

ApplyDiscount ..> Checkout : <<extend>>

Arahnya adalah:

Kasus penggunaan ekstensi opsional ..> Kasus penggunaan dasar : <<extend>>

Panah menunjuk dari perilaku opsionalke kasus penggunaan dasar.

Contoh yang benar

usecase "Checkout" sebagai Checkout
usecase "Apply Discount Coupon" sebagai ApplyDiscount

ApplyDiscount ..> Checkout : <<extend>>

Ini berarti bahwaTerapkan Kupon Diskonsecara opsional memperluasPembayaran proses.

Perbandingan antara include dan extend

Contoh:

Checkout ..> ValidatePayment : <<include>>
ApplyDiscount ..> Checkout : <<extend>>

Hindari membalikkan hubungan-hubungan ini karena arah mengubah maknanya.

8. Generalisasi kasus penggunaan

Generalisasi menunjukkan bahwa satu kasus penggunaan adalah bentuk khusus dari kasus penggunaan lainnya.

usecase "Cari Produk" sebagai SearchProducts
usecase "Jelajahi Produk" sebagai BrowseProducts

SearchProducts -|> BrowseProducts

Segitiga kosong mengarah ke kasus penggunaan yang lebih umum.

Ini berarti bahwa Cari Produk adalah variasi khusus dari Jelajahi Produk.

Generalisasi lebih jarang daripada include dan extend, sehingga gunakan hanya ketika terdapat hubungan induk-anak yang sah antara kasus penggunaan.

9. Generalisasi aktor

Aktor juga dapat memiliki hubungan generalisasi.

actor Customer
actor "Pelanggan Premium" sebagai PremiumCustomer

PremiumCustomer -|> Customer

Ini menunjukkan bahwa pelanggan premium adalah jenis pelanggan yang terspesialisasi dan mewarisi interaksi dari aktor umum.

Sebagai contoh:

PremiumCustomer --> TerapkanDiskon

10. Catatan dan anotasi

Catatan menambahkan penjelasan atau batasan pada sebuah diagram.

Catatan yang melekat pada sebuah kasus penggunaan

note kanan dari Checkout
  Pelanggan harus menyediakan
  informasi penagihan yang valid.
end note

Posisi lainnya meliputi:

note kiri dari Checkout
  Proses yang berhadapan dengan pelanggan
end note

note atas dari Checkout
  Alur kerja bisnis utama
end note

note bawah dari Checkout
  Termasuk pemrosesan pembayaran
end note

Sintaks catatan singkat

catatan di sebelah kanan Login : Autentikasi pengguna diperlukan

Catatan mandiri dengan alias

catatan "Pembayaran harus diotorisasinsebelum pesanan dikonfirmasi" sebagai PaymentNote

Hubungkan catatan ke elemen dengan garis putus-putus:

PaymentNote .. MakePayment

Catatan untuk kendala

Catatan berguna untuk mendokumentasikan kondisi:

catatan di kanan ApplyDiscount
  Perilaku opsional:
  digunakan hanya ketika
  kupon yang valid
  disediakan.
akhiran catatan

11. Arah tata letak

Secara default, PlantUML memilih tata letak secara otomatis. Anda dapat memengaruhi arahnya.

Tata letak kiri ke kanan

arah kiri ke kanan

Ini sering berguna untuk diagram kasus penggunaan karena aktor muncul di sebelah kiri dan sistem eksternal di sebelah kanan.

Tata letak dari atas ke bawah

arah dari atas ke bawah

Ini dapat berguna untuk diagram yang ringkas atau alur kerja yang terorganisir secara vertikal.

Tautan tata letak yang tidak terlihat

Tautan yang tidak terlihat dapat mempengaruhi penempatan tanpa menampilkan hubungan yang terlihat:

Pelanggan -[hidden]-> Checkout

Ini berguna untuk meningkatkan tata letak diagram.

12. Menggaya diagram

Hapus bayangan

skinparam shadowing false

Gunakan paket dan batas berbentuk persegi panjang

skinparam packageStyle rectangle

Atur warna

skinparam usecase {
    BackgroundColor #FDFDFD
    BorderColor #333333
}

skinparam actor {
    BorderColor #333333
}

Atur warna panah

skinparam ArrowColor #555555

Atur ukuran font default

skinparam defaultFontSize 14

Bagian styling lengkap mungkin terlihat seperti ini:

skinparam shadowing false
skinparam packageStyle rectangle
skinparam actorStyle awesome
skinparam defaultFontSize 14

skinparam usecase {
    BackgroundColor #F9FBFF
    BorderColor #234
}

skinparam ArrowColor #555555

13. Paket dan pengelompokan

Paket dapat mengelompokkan kasus penggunaan yang terkait.

package "Fitur Pelanggan" {
    usecase "Daftar Akun" as Register
    usecase "Masuk" as Login
    usecase "Jelajahi Produk" as Browse
}

package "Fitur Administrasi" {
    usecase "Kelola Produk" as ManageProducts
    usecase "Hasilkan Laporan Penjualan" as SalesReport
}

Package bermanfaat ketika diagram berisi banyak use case.

Anda juga dapat menggunakan persegi panjang sebagai grup:

rectangle "Manajemen Pesanan" {
    usecase "Tempel Pesanan" as PlaceOrder
    usecase "Lacak Pesanan" as TrackOrder
    usecase "Batalkan Pesanan" as CancelOrder
}

14. Sistem eksternal

Aplikasi atau layanan eksternal dapat direpresentasikan sebagai aktor.

actor "Payment Gateway" as PaymentGateway
actor "Email Service" as EmailService
actor "External CRM" as CRM

Hubungkan mereka ke kasus penggunaan sistem:

PaymentGateway --> MakePayment
EmailService --> SendConfirmation
CRM --> SynchronizeCustomer

Hal ini dengan jelas memisahkan fungsionalitas sistem dari layanan di luar batas sistem.

15. Contoh lengkap

Contoh berikut menggabungkan notasi utama dari lembar referensi.

@startuml
title Sistem Belanja Online - Diagram Use Case

arah dari kiri ke kanan

skinparam shadowing false
skinparam packageStyle rectangle
skinparam actorStyle awesome

skinparam usecase {
    BackgroundColor #F9FBFF
    BorderColor #333333
}

skinparam ArrowColor #555555

' Aktor
actor Customer as customer
actor "Pelanggan Premium" as premium
actor Administrator as admin
actor "Gerbang Pembayaran" as payment
actor "Layanan Email" as email

' Generalisasi aktor
premium -|> customer

' Batas sistem
rectangle "Sistem Belanja Online" {

    ' Use case pelanggan
    usecase "Daftar Akun" as Register
    usecase "Masuk" as Login
    usecase "Jelajahi Produk" as Browse
    usecase "Cari Produk" as Search
    usecase "Lihat Detail Produk" as ViewProduct
    usecase "Tambah Produk ke Keranjang" as AddToCart
    usecase "Lihat Keranjang Belanja" as ViewCart
    usecase "Checkout" as Checkout
    usecase "Tempatkan Pesanan" as PlaceOrder
    usecase "Lacak Pesanan" as TrackOrder
    usecase "Batalkan Pesanan" as CancelOrder

    ' Perilaku bersama yang disertakan
    usecase "Validasi Detail Pelanggan" as ValidateCustomer
    usecase "Hitung Total Pesanan" as CalculateTotal
    usecase "Lakukan Pembayaran" as MakePayment
    usecase "Kirim Konfirmasi Pesanan" as SendConfirmation

    ' Perilaku opsional
    usecase "Terapkan Kupon Diskon" as ApplyDiscount
    usecase "Minta Pengembalian Dana" as RequestRefund

    ' Use case administrasi
    usecase "Kelola Produk" as ManageProducts
    usecase "Hasilkan Laporan Penjualan" as SalesReport
}

' Asosiasi aktor
customer --> Register
customer --> Login
customer --> Browse
customer --> Search
customer --> ViewProduct
customer --> AddToCart
customer --> ViewCart
customer --> Checkout
customer --> TrackOrder
customer --> CancelOrder

premium --> ApplyDiscount
premium --> RequestRefund

admin --> ManageProducts
admin --> SalesReport

payment --> MakePayment
email --> SendConfirmation

' Hubungan include
Checkout ..> ValidateCustomer : <<include>>
Checkout ..> CalculateTotal : <<include>>
Checkout ..> PlaceOrder : <<include>>

PlaceOrder ..> MakePayment : <<include>>
PlaceOrder ..> SendConfirmation : <<include>>

' Hubungan extend
ApplyDiscount ..> Checkout : <<extend>>
RequestRefund ..> CancelOrder : <<extend>>

' Generalisasi use case
Search -|> Browse

' Catatan
note right of Checkout
    Proses pembelian utama pelanggan
end note

note right of ApplyDiscount
    Perilaku opsional:
    hanya digunakan ketika
    kupon yang valid tersedia
end note

note bottom of MakePayment
    Pembayaran ditangani oleh
    gerbang pembayaran eksternal
end note

@enduml

16. Membaca contoh lengkap

Diagram ini menyampaikan hal berikut:

• Pelanggan dapat menjelajahi produk, menambahkan produk ke keranjang, dan melakukan checkout.

• Pelanggan Premium adalah bentuk khusus dari Pelanggan.

• Pembayaran selalu mencakup validasi pelanggan, perhitungan total, dan penempatan pesanan.

• Tempatkan Pesanan selalu mencakup pembayaran dan konfirmasi.

• Terapkan Kupon Diskon bersifat opsional dan memperpanjang proses pembayaran.

• Minta Pengembalian Dana merupakan perpanjangan opsional dari pembatalan.

• Gerbang pembayaran menangani pemrosesan pembayaran.

• Layanan email mengirimkan konfirmasi pesanan.

• Administrator mengelola produk dan menghasilkan laporan.

17. Kesalahan umum

Membatalkan termasuk

Salah:

ValidateCustomer ..> Checkout : <<termasuk>>

Benar:

Checkout ..> ValidateCustomer : <<termasuk>>

Kasus penggunaan dasar mengarah pada perilaku yang disertakan yang diperlukan.

Membalikkanperluasan

Salah:

Checkout ..> TerapkanDiskon : <<perluasan>>

Benar:

ApplyDiscount ..> Checkout : <<extend>>

Use case ekstensi opsional mengarah ke use case dasar.

Menggunakan include untuk perilaku opsional

Jika suatu perilaku hanya terjadi dalam kondisi tertentu, gunakan <<extend>>:

ApplyDiscount ..> Checkout : <<extend>>

Jika hal ini selalu terjadi, gunakan <<include>>:

Checkout ..> ValidateCustomer : <<include>>

Menempatkan aktor eksternal di dalam batas sistem

Pengguna dan layanan eksternal seharusnya biasanya berada di luar persegi panjang:

actor Customer

rectangle "Sistem Belanja" {
    usecase "Checkout" sebagai Checkout
}

Customer --> Checkout

Membuat kasus penggunaan yang terlalu rinci

Sebuah kasus penggunaan seharusnya menggambarkan tujuan pengguna yang bermakna, seperti:

usecase "Tempatkan Pesanan"

Hindari mengubah setiap langkah implementasi kecil menjadi use case terpisah kecuali langkah tersebut digunakan kembali, bersifat opsional, atau penting bagi model.

18. Templat praktis minimal

Untuk diagram yang lebih kecil, gunakan templat ini:

@startuml

arah dari kiri ke kanan

actor User

rectangle "Sistem Saya" {
    usecase "Tujuan Utama Pengguna" as MainGoal
    usecase "Perilaku Bersama yang Diperlukan" as SharedBehavior
    usecase "Perilaku Opsional" as OptionalBehavior
}

User --> MainGoal

MainGoal ..> SharedBehavior : <<include>>
OptionalBehavior ..> MainGoal : <<extend>>

note kanan dari MainGoal
    Fungsi utama sistem
end note

@enduml

Templat ini berisi notasi esensial:

• Aktor

• Batas sistem

• Kasus penggunaan

• Asosiasi

• Termasuk

• Perluas

• Catatan

• Arah tata letak

Perangkat lunak: Visual Paradigm UML, AI, dan VPasCode

PlantUML sangat ideal untuk membuat diagram dalam bentuk teks, namun alat pemodelan visual dapat membuat alur kerja yang sama lebih mudah untuk ditinjau, disempurnakan, dan dibagikan. Visual Paradigm menyediakan kemampuan pemodelan UML bersama dengan pemodelan yang dibantu AI dan ruang kerja berbasis teks VPasCode. Platformnya mendukung diagram UML standar, termasuk diagram kasus penggunaan, kelas, urutan, aktivitas, komponen, penempatan, mesin keadaan, paket, dan objek.

Pemodelan UML Visual Paradigm

Visual Paradigm dapat digunakan ketika Anda ingin membuat diagram kasus penggunaan secara visual daripada menulis semua sintaks secara manual. Alur kerja tipikal adalah:

1. Buat proyek UML.

2. Tambahkan diagram kasus penggunaan.

3. Tempatkan aktor dan kasus penggunaan pada kanvas.

4. Gambar batas sistem.

5. Hubungkan aktor ke kasus penggunaan.

6. Tambahkan termasuk, memperluas, dan hubungan generalisasi.

7. Tambahkan catatan dan batasan.

8. Atur dan ekspor diagram yang sudah selesai.

Pemodelan visual sangat berguna ketika pemangku kepentingan perlu meninjau diagram secara interaktif. Anggota tim dapat memeriksa simbol, mendiskusikan elemen tertentu, dan mengannotasi diagram secara kolaboratif.

Diagram kasus penggunaan yang dibuat secara manual mungkin berisi:

• Aktor seperti Pelanggan, Administrator, dan Gerbang Pembayaran

• Batas sistem seperti Sistem Belanja Online

• Kasus penggunaan seperti Pembayaran, Tempel Pesanan, dan Lacak Pesanan

• <<include>> hubungan untuk perilaku yang wajib dapat digunakan kembali

• <<extend>> hubungan untuk perilaku opsional

• Hubungan generalisasi untuk aktor atau kasus penggunaan yang terspesialisasi

Model visual harus mempertahankan aturan semantik yang sama yang digunakan dalam PlantUML:

Checkout ..> ValidatePayment : <<include>>
ApplyDiscount ..> Checkout : <<extend>>
PremiumCustomer -|> Customer

Perbedaan penting adalah bahwa mengubah alat tidak mengubah makna UML. Baik diagram dibuat secara manual, dihasilkan oleh AI, atau ditulis dalam PlantUML, arah hubungan harus tetap benar.

Pemodelan yang dibantu AI

Kemampuan AI Visual Paradigm dapat membantu mengubah persyaratan dalam bahasa alami menjadi elemen model dan diagram. Platform ini menggambarkan fitur AI-nya sebagai kemampuan untuk mengubah persyaratan menjadi diagram dan menghasilkan artefak pengembangan perangkat lunak dari deskripsi teks.

Sebagai contoh, Anda dapat memberikan persyaratan berikut:

Buat diagram kasus penggunaan untuk sistem belanja online.

Aktor:
- Pelanggan
- Pelanggan Premium
- Administrator
- Gerbang Pembayaran
- Layanan Email

Pelanggan dapat mendaftar, masuk, menelusuri produk, menambahkan produk ke keranjang,
melakukan checkout, melacak pesanan, dan membatalkan pesanan.

Checkout harus mencakup validasi pelanggan, perhitungan total, pembayaran,
dan konfirmasi pesanan.

Menerapkan kupon diskon bersifat opsional dan memperluas Checkout.
Pelanggan Premium adalah jenis khusus dari Pelanggan.

Alat yang dibantu AI mungkin menggunakan deskripsi ini untuk mengusulkan:

• Definisi aktor

• Nama kasus penggunaan

• Batas sistem

• Asosiasi

• Kasus penggunaan yang disertakan

• Kasus penggunaan yang diperluas

• Generalisasi aktor

• Catatan yang menjelaskan aturan bisnis

AI paling bermanfaat selama tahap pemodelan pertama. AI dapat dengan cepat menghasilkan draf dari persyaratan, mengidentifikasi aktor kandidat, dan menyarankan perilaku yang dapat digunakan kembali. Model yang dihasilkan tetap harus ditinjau oleh pengembang, analis, atau pakar bidang.

Daftar periksa tinjauan AI yang direkomendasikan

Setelah membuat diagram, periksa:

• Setiap aktor berada di luar batas sistem.

• Setiap kasus penggunaan menggambarkan tujuan pengguna yang bermakna atau layanan sistem.

• Perilaku yang dapat digunakan kembali secara wajib menggunakan <<include>>.

• Perilaku opsional atau kondisional menggunakan <<extend>>.

• Panah include menunjuk dari kasus penggunaan dasar ke kasus penggunaan yang disertakan.

• Panah perluaspanah menunjuk dari use case yang memperluas ke use case dasar.

• Panah generalisasi menunjuk ke aktor atau use case yang lebih umum.

• Use case yang duplikat atau terlalu detail telah dihapus.

• Nama-nama dinyatakan secara konsisten sebagai frasa verba.

• Diagram ini mengkomunikasikan ruang lingkup sistem dengan jelas.

VPasCode: pemodelan dengan teks

VPasCode menyediakan ruang kerja teks-ke-diagram dalam ekosistem Visual Paradigm. Platform resmi mendeskripsikannya sebagai editor online teks-ke-diagram gratis dan juga menyajikannya sebagai cara untuk mengubah kode menjadi diagram.

Hal ini membuat VPasCode berguna bagi pengguna yang lebih menyukai presisi dan keterulangan diagram-sebagai-kode sambil tetap bekerja dalam lingkungan pemodelan visual.

Diagram use case PlantUML dapat ditulis sebagai berikut:

@startuml
title Sistem Belanja Online

arah dari kiri ke kanan

actor Pelanggan sebagai customer
actor "Pelanggan Premium" sebagai premium
actor Administrator sebagai admin
actor "Gerbang Pembayaran" sebagai payment
actor "Layanan Email" sebagai email

premium -|> customer

rectangle "Sistem Belanja Online" {
    usecase "Daftar Akun" sebagai Register
    usecase "Masuk" sebagai Login
    usecase "Jelajahi Produk" sebagai Browse
    usecase "Checkout" sebagai Checkout
    usecase "Tempel Pesanan" sebagai PlaceOrder
    usecase "Lacak Pesanan" sebagai TrackOrder
    usecase "Batalkan Pesanan" sebagai CancelOrder

    usecase "Validasi Detail Pelanggan" sebagai ValidateCustomer
    usecase "Hitung Total Pesanan" sebagai CalculateTotal
    usecase "Lakukan Pembayaran" sebagai MakePayment
    usecase "Kirim Konfirmasi Pesanan" sebagai SendConfirmation

    usecase "Terapkan Kupon Diskon" sebagai ApplyDiscount
    usecase "Minta Pengembalian Dana" sebagai RequestRefund

    usecase "Kelola Produk" sebagai ManageProducts
}

customer --> Register
customer --> Login
customer --> Browse
customer --> Checkout
customer --> TrackOrder
customer --> CancelOrder

premium --> ApplyDiscount
premium --> RequestRefund

admin --> ManageProducts
payment --> MakePayment
email --> SendConfirmation

Checkout ..> ValidateCustomer : <<include>>
Checkout ..> CalculateTotal : <<include>>
Checkout ..> PlaceOrder : <<include>>

PlaceOrder ..> MakePayment : <<include>>
PlaceOrder ..> SendConfirmation : <<include>>

ApplyDiscount ..> Checkout : <<extend>>
RequestRefund ..> CancelOrder : <<extend>>

@enduml

Model yang sama dapat disempurnakan dengan beberapa cara:

• Ubah arah tata letak dengan arah dari kiri ke kanan.

• Tambahkan catatan untuk menjelaskan aturan bisnis.

• Kelompokkan kasus penggunaan ke dalam paket.

• Tambahkan gaya dengan skinparam.

• Ganti nama alias tanpa mengubah label yang terlihat.

• Jaga sumber diagram tetap dalam kontrol versi.

• Regenerasi diagram setiap kali model berubah.

Pemodelan visual versus diagram-sebagai-kode

Sebuah alur kerja gabungan yang praktis

Alur kerja yang produktif adalah menggunakan setiap alat untuk tugas yang paling dihadapinya dengan baik:

1. Tangkap persyaratan dalam bahasa alami.
   Deskripsikan pengguna, tujuan, ruang lingkup sistem, dan aturan bisnis.

2. Gunakan AI untuk membuat model awal.
   Minta AI untuk mengidentifikasi aktor dan kasus penggunaan, lalu buat draf pertama.

3. Tinjau draf tersebut di Visual Paradigm UML.
   Periksa apakah model tersebut secara akurat mencerminkan domain dan apakah diagramnya mudah dipahami.

4. Ekspor atau tulis ulang model tersebut dalam PlantUML.
   Gunakan alias, nama yang konsisten, dan sintaks relasi yang eksplisit.

5. Jaga sumber di VPasCode atau kontrol versi.
   Simpan .puml file bersama dokumentasi proyek atau kode sumber.

6. Validasi semantik UML.
   Perhatikan secara khusus include, extend, dan arah generalisasi.

7. Terbitkan diagram akhir.
   Ekspor sebagai gambar atau dokumen untuk persyaratan, arsitektur, tinjauan desain, dan dokumentasi proyek.

Perintah untuk menghasilkan diagram kasus penggunaan PlantUML

Perintah berikut dapat digunakan dengan asisten pemodelan AI:

Buat diagram kasus penggunaan PlantUML untuk sistem belanja online.

Gunakan tata letak dari kiri ke kanan dan tempatkan semua kasus penggunaan sistem di dalam
persegi panjang bernama "Sistem Belanja Online".

Aktor:
- Pelanggan
- Pelanggan Premium
- Administrator
- Gerbang Pembayaran
- Layanan Email

Kasus penggunaan Pelanggan:
- Daftar Akun
- Masuk
- Jelajahi Produk
- Tambah Produk ke Keranjang
- Checkout
- Lacak Pesanan
- Batalkan Pesanan

Checkout harus menyertakan:
- Validasi Detail Pelanggan
- Hitung Total Pesanan
- Tempatkan Pesanan

Tempatkan Pesanan harus menyertakan:
- Lakukan Pembayaran
- Kirim Konfirmasi Pesanan

Perilaku opsional:
- Terapkan Kupon Diskon memperluas Checkout
- Minta Pengembalian Dana memperluas Batalkan Pesanan

Pelanggan Premium adalah spesialisasi dari Pelanggan.

Gunakan sintaks PlantUML standar dan sertakan:
- Alias aktor
- Alias kasus penggunaan
- Batas sistem
- Asosiasi aktor
- Hubungan <<include>>
- Hubungan <<extend>>
- Generalisasi aktor
- Minimal satu catatan penjelas

Pastikan panah include mengarah dari kasus penggunaan dasar ke kasus penggunaan yang disertakan,
dan panah extend mengarah dari kasus penggunaan opsional yang memperluas ke kasus penggunaan dasar.

Poin utama

Visual Paradigm UML sangat cocok untuk pemodelan dan tinjauan interaktif, AI dapat mempercepat transisi dari persyaratan ke draf pertama, dan VPasCode dengan PlantUML menyediakan alur kerja berbasis teks yang dapat diulang. Jika digunakan bersama, ketiganya mendukung seluruh siklus hidup pemodelan: mendeskripsikan persyaratan, menghasilkan draf, memvalidasi UML, menyempurnakan sumber, dan menerbitkan diagram yang dapat dipelihara.

This post is also available in Deutsch, English, Español, فارسی, Français, 日本語, Polski, Portuguese, Ру́сский, Việt Nam, 简体中文 and 繁體中文.