docs: convert all ASCII charts to Mermaid diagrams

Converted 40+ ASCII art diagrams across 12 files to Mermaid:
- flowchart TD/LR for process flows and architecture
- erDiagram for entity relationships
- graph TD for tree structures (binary tree, categories)
- gantt for roadmap sprints

Files: BUSINESS-01 to 05, TECH-01/03/04/05, OVERVIEW-01/02/05
Directory tree structures kept as plain code blocks (Mermaid N/A)
This commit is contained in:
masoodafar-web
2026-02-18 23:36:39 +03:30
parent aef6861e21
commit 1b04ba5326
12 changed files with 544 additions and 739 deletions
+45 -37
View File
@@ -22,30 +22,38 @@
## ۲. معماری لایه‌ای CMS
```
┌──────────────────────────────────────────────────────┐
Presentation Layer
FrontOffice (Blazor Server) ←─gRPC─→ CMS │
BackOffice (Blazor WASM) ←─gRPC─→ CMS │
├──────────────────────────────────────────────────────┤
│ Application Layer │
│ Commands (MediatR IRequest<T>) │
│ Queries (MediatR IRequest<T>) │
Validators (FluentValidation) │
│ Handlers (IRequestHandler<TReq, TRes>) │
├──────────────────────────────────────────────────────┤
│ Domain Layer │
│ Entities, Enums, Value Objects │
│ Domain Events, Interfaces │
├──────────────────────────────────────────────────────┤
│ Infrastructure Layer │
│ EF Core DbContext (CMSDbContext) │
│ Repositories, External Services │
│ Hangfire Jobs, File Storage │
├──────────────────────────────────────────────────────┤
│ Database │
│ SQL Server — Schema: [CMS] │
└──────────────────────────────────────────────────────┘
```mermaid
flowchart TD
subgraph PRES["💻 Presentation Layer"]
FO["FrontOffice\nBlazor Server"]
BO["BackOffice\nBlazor WASM"]
end
FO & BO -->|gRPC| APP
subgraph APP["⚙️ Application Layer"]
CMD["Commands\nMediatR IRequest"]
QRY["Queries\nMediatR IRequest"]
VAL["Validators\nFluentValidation"]
HND["Handlers\nIRequestHandler"]
end
APP --> DOM
subgraph DOM["📦 Domain Layer"]
ENT["Entities, Enums\nValue Objects\nDomain Events"]
end
DOM --> INF
subgraph INF["🔧 Infrastructure Layer"]
EF["EF Core DbContext"]
SVC["External Services"]
HF["Hangfire Jobs"]
FS["File Storage"]
end
INF --> DB[("🗄️ SQL Server\nSchema: CMS")]
```
---
@@ -191,22 +199,22 @@ Engine: MSSQL 2022-CU16, Collation=Arabic_CI_AS
### ۶.۱ قبل vs بعد
```
قبل:
FrontOffice → BFF (REST) → CMS (gRPC)
BackOffice → BFF (REST) → CMS (gRPC)
```mermaid
flowchart LR
subgraph BEFORE["قبل"]
F1["FrontOffice"] -->|REST| BFF1["BFF"]
B1["BackOffice"] -->|REST| BFF1
BFF1 -->|gRPC| C1["CMS"]
end
بعد (فعلی):
FrontOffice → CMS (gRPC مستقیم)
BackOffice → CMS (gRPC مستقیم)
مزایا:
✅ حذف لایه واسط → کاهش latency
✅ حذف maintenance اضافی
✅ Type-safe از proto تا UI
✅ کاهش ۱ سرویس در deployment
subgraph AFTER["بعد فعلی ✅"]
F2["FrontOffice"] -->|gRPC| C2["CMS"]
B2["BackOffice"] -->|gRPC| C2
end
```
> مزایا: حذف لایه واسط → کاهش latency • Type-safe از proto تا UI • کاهش ۱ سرویس در deployment
### ۶.۲ سازگاری API
```