fix: Fix requested changes

Author: Hossein-Fazel

content/chapter 9/creational patterns/9.1.6-builder.md

@@ -1,10 +1,11 @@
 ---
-title: '9.1.6 الگو Builder'
+title: 9.1.6 الگو Builder
 slug: go-builder-pattern
 weight: 172006
+mermaid: "true"
 ---
 
-### توضیحات
+## 9.1.6.1 توضیحات
 
 در دنیای طراحی نرم‌افزار، یکی از چالش‌های رایج، **ساخت{{< tooltip text="اشیاء" note="Objects" >}} پیچیده با پارامترهای متعدد و متنوع** است. فرض کنید قصد دارید یک شیء پیکربندی برای اتصال به {{< tooltip text="پایگاه داده" note="Database" >}} بسازید. بسته به نوع پایگاه داده ای که می خواهید (MySQL، PostgreSQL، SQLite و …)، ممکن است به مجموعه‌ای متفاوت از پارامترها نیاز داشته باشید: نام کاربری و گذرواژه، میزبان و پورت، نام پایگاه داده یا حتی مسیر فایل. اگر بخواهیم همه‌ی این موارد را با یک {{< tooltip text="سازنده" note="Constructor" >}}  ساده مدیریت کنیم، به زودی با توابعی پر از پارامترهای اختیاری و ترتیب‌های گیج‌کننده مواجه خواهیم شد.
 
@@ -14,15 +15,35 @@ weight: 172006
 الگوی بیلدر وقتی کمک کننده است که بخواهید یک شیء پیچیده با پارامترهای زیاد را مرحله به مرحله و خواناتر بسازید، بدون اینکه درگیر سازنده‌های طولانی و گیج‌کننده بشوید.
 {{< /hint >}}
 
-### دیاگرام
-
-{{< uml url="<https://mermaidchart.com/play?utm_source=mermaid_live_editor&utm_medium=share#pako:eNp9U02PmzAQ_SuW98JKNE0I2QQf9hDYVS-NVqp6qbg4eEKsgk0He_sR5b_XNhClq2Y5WB77zXvPw8yJVloAZbSHHxZUBYXkNfK2VIRwa7Sy7R4wRJXRSPJGgjI-7jgaWcmOK0O2VjYCkPCelLTYjmFJ3-JyrQ6ynmBD5FEet9MGiH6FSSOeSO-K5VOaF4zkRy4V3zdAejAGsPdpA_jD4-MIZ2QHPy8WIoHSUd7_H_kFzCfdm-joltuQF40m6txyG_K1d1K2f0-o2O54C5HY34Y8ywZeuDlGnVvu31ZlRMZjDe-e86esWLHhnLzyRgpuoCdSddbcKE3YRMHBeHZ9O3GQoWgEbeP4wrs-ir1y9onrgINzORp8n8WXjCBXNQxP4Y2ZLqVWvWuMPti8ZhkexwiCsahIFUKLIMilXULG5WlTgjM5okkEs3oW-0hBNfw0aNz1tfaBy-Zfbc8VSC_igKhD54MSpaIxrVEKygxaiGkL2HIf0pOHlNQcoYWSMrcVHL_7rj67HNf237RupzTUtj5SduDOUExt5ws1TtzlFJ0eYK6tMpQlSeCg7ER_uWiTztbJYvOQrLMke9isVzH9TdkymyWr-XyxSNN0ni0255j-CaLzmYPM3Zcs11m2SNdpTEFIN8ifh6kPw3_-CwjCWZE>" >}}
-
-### نمونه کد: ساخت پیکربندی پایگاه داده با Builder
+## 9.1.6.2 دیاگرام
+
+{{< mermaid >}}
+sequenceDiagram
+  autonumber
+  actor Client
+  participant Builder as DBBuilder
+  participant Config as DBConfig
+  Note over Client,Builder #D3E4CD: Chainable setters
+  Client->>Builder: NewDBBuilder(driver)
+  Client->>Builder: SetHost(host)
+  Client->>Builder: SetPort(port)
+  Client->>Builder: SetUser(user) / SetDBName(db) / SetFilePath(path)
+  Note over Builder,Config #FCE9D5: Build validates inputs
+  Client->>Builder: Build()
+  Builder->>Builder: validate driver rules (user/dbname or filepath)
+  Builder->>Builder: validate port range
+  alt validations pass
+    Builder->>Config: return configured DBConfig
+    Client->>Config: use config (e.g., connect)
+  else validations fail
+    Builder-->>Client: return error
+  end
+{{< /mermaid >}}
+
+## 9.1.6.3 مثال
 
 وقتش رسیده که یک نمونه‌ی واقعی را ببینیم. در کدی که در ادامه می‌آید، ما یک ساختار `DBConfig` داریم که تنظیمات اتصال به پایگاه داده را نگه می‌دارد. یک **Builder** به نام `DBBuilder` ایجاد کرده‌ایم که به ما اجازه می‌دهد با استفاده از متدهای زنجیره‌ای (`SetUser`, `SetHost`, …) تنها فیلدهای مورد نیاز خود را مقداردهی کنیم و در پایان با فراخوانی `Build()` شیء نهایی را تحویل بگیریم.
 
-<!-- markdownlint-disable MD010 MD037 MD012 -->
 {{< play >}}
 package main
 
@@ -148,7 +169,6 @@ func main() {
 }
 
 {{< /play >}}
-<!-- markdownlint-enable MD010 MD037 MD012 -->
 
 این کد، مفهوم الگوی بیلدر را در Go به شکلی بسیار ساده و شفاف پیاده‌سازی کرده است.
 ساختار `DBConfig` شامل تمام فیلدهای لازم اتصال به پایگاه داده مثل نوع درایور، نام کاربری، رمز عبور، هاست، پورت، نام پایگاه داده، مسیر فایل (برای SQLite) و SSLMode است. `DBBuilder` یک سازنده مرحله‌ای است که این فیلدها را به صورت زنجیروار مقداردهی می‌کند.
@@ -157,15 +177,15 @@ func main() {
 
 در تابع `main` دو مثال واقعی وجود دارد: یکی برای MySQL که تمام فیلدهای مرتبط پر شده و دیگری برای SQLite که تنها مسیر فایل مشخص شده است. این روش باعث می‌شود کد خوانا، قابل گسترش و ایمن باشد و ساخت پیکربندی‌های مختلف پایگاه داده ساده و منعطف انجام شود. این پیاده‌سازی در عین سادگی نشان می‌دهد که چگونه می‌توان با استفاده از الگوی Builder از پیچیدگی‌های ایجاد اشیای بزرگ و متنوع کاست.
 
-### کاربرد ها
+## 9.1.6.4 کاربرد ها
 
 در مواردی که اشیاء ما پارامترهای زیادی دارند و  پیچیده هستند، استفاده از الگوی سازنده به کمک ما می‌آید. در مواردی مثل:
 
 1. کانکشن های دیتابیس
 2. فرم یا UI‌های پیچیده
 3. {{< tooltip text="لاگر" note="Logger" >}}
 
-### چه زمانی نباید از الگوی Builder استفاده کنیم؟
+### 9.1.6.4.1 چه زمانی نباید از الگوی Builder استفاده کنیم؟
 
 1. **ساخت اشیاء ساده**