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
+26 -48
View File
@@ -9,14 +9,15 @@
### ۱.۱ معماری ساده‌شده (Shopify-style)
```
قبل (پیچیده):
SitePage → SitePageSetting → SitePageContent → Template → ... (7 جدول)
```mermaid
flowchart LR
subgraph BEFORE["قبل — پیچیده"]
X1["SitePage"] --> X2["SitePageSetting"] --> X3["SitePageContent"] --> X4["Template\n... 7 جدول"]
end
بعد (ساده):
SitePage (PageType, JsonSettings, IsPublished)
└─→ هر PageType → یک typed editor در BackOffice
subgraph AFTER["بعد ساده ✅"]
Y1["SitePage\nPageType + JsonSettings"] --> Y2["هر PageType\nیک typed editor"]
end
```
### ۱.۲ انواع صفحات
@@ -97,21 +98,14 @@ message GetBlogPostsRequest {
### ۳.۱ معماری
```mermaid
flowchart TD
A["آپلود فایل\nتصویر / سند"] --> B["FileManagementService"]
B --> C["ذخیره در فایل‌سیستم\n+ ثبت در DB"]
C --> D["مسیر: /app/uploads/year/month/guid.ext\nURL: /api/files/guid"]
```
آپلود فایل (تصویر/سند)
FileManagementService → ذخیره در فایل‌سیستم + ثبت در DB
مسیر فیزیکی: /app/uploads/{year}/{month}/{guid}.{ext}
مسیر URL: /api/files/{guid}
محدودیت‌ها:
• حداکثر حجم: 10MB (configurable)
• فرمت‌های مجاز: jpg, png, webp, pdf, doc, docx
• تصاویر: resize خودکار به 800×800 (محصولات)
```
> محدودیت: حداکثر 10MB • jpg, png, webp, pdf, doc, docx • Resize: 800×800 (محصولات)
### ۳.۲ Storage Strategy
@@ -198,20 +192,12 @@ CREATE TABLE SystemConfigurations (
### ۶.۱ معماری
```
Hangfire Recurring Job (هر ۵ دقیقه)
ChatikaJob → بررسی پیام‌های جدید کاربران
ارسال به Chatika API (با Polly retry ×3)
دریافت پاسخ → ذخیره در ChatMessages
نمایش در UI باشگاه (real-time via SignalR planned)
```mermaid
flowchart TD
A["Hangfire Recurring Job\nهر ۵ دقیقه"] --> B["ChatikaJob\nبررسی پیام‌های جدید"]
B --> C["ارسال به Chatika API\nPolly retry ×3"]
C --> D["دریافت پاسخ\nذخیره در ChatMessages"]
D --> E["نمایش در UI باشگاه\nSignalR planned"]
```
### ۶.۲ فعلی vs آینده
@@ -228,20 +214,12 @@ ChatikaJob → بررسی پیام‌های جدید کاربران
### ۷.۱ ساختار
```
Hero Section (انیمیشن fade-in)
ویژگی‌ها (Features Grid — 3 ستونه)
محصولات ویژه (Carousel)
آمار (Counter animation — اصلاح‌شده)
CTA — Call to Action (ثبت‌نام / ورود)
```mermaid
flowchart TD
A["🎨 Hero Section\nانیمیشن fade-in"] --> B["✨ ویژگی‌ها\nFeatures Grid — 3 ستونه"]
B --> C["📦 محصولات ویژه\nCarousel"]
C --> D["📊 آمار\nCounter animation\nlinear interpolation"]
D --> E["🚀 CTA\nثبت‌نام / ورود"]
```
### ۷.۲ اصلاح انیمیشن Counter