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:
@@ -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
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user