docs/business/BUSINESS-05-CONTENT-MANAGEMENT.md

# 📄 محتوا، صفحات، بلاگ و ایمیل/SMS

> **منابع ادغام‌شده:** `SITE-PAGES-SIMPLIFICATION.md`, `system-constants.md`, `email-sms-configuration.md`, `chatika-integration.md`, `CMS-README.md`  
> **آخرین بروزرسانی:** اسفند ۱۴۰۴

---

## ۱. مدیریت صفحات سایت (Site Pages)

### ۱.۱ معماری ساده‌شده (Shopify-style)

```
قبل (پیچیده):
    SitePage → SitePageSetting → SitePageContent → Template → ... (7 جدول)

بعد (ساده):
    SitePage (PageType, JsonSettings, IsPublished)
    │
    └─→ هر PageType → یک typed editor در BackOffice
```

### ۱.۲ انواع صفحات

| PageType | Route | Editor | وضعیت |
|----------|-------|--------|--------|
| `Home` | `/` | HomePageEditor | ✅ |
| `About` | `/about` | AboutPageEditor | ✅ |
| `Contact` | `/contact` | ContactPageEditor | ✅ |
| `Landing` | `/landing` | LandingPageEditor | ✅ |
| `Licenses` | `/licenses` | LicensesPageEditor | ✅ |
| `FAQ` | `/faq` | FAQPageEditor | ✅ |
| `Terms` | `/terms` | MarkdownEditor | ✅ |
| `Privacy` | `/privacy` | MarkdownEditor | ✅ |

### ۱.۳ SitePageSettingsService

```csharp
public interface ISitePageSettingsService {
    Task<T> GetSettingsAsync<T>(string pageType) where T : class, new();
    Task SaveSettingsAsync<T>(string pageType, T settings) where T : class;
}

// ذخیره‌سازی: JSON serialization در فیلد Settings
// Cache: MemoryCache با Expiry 15 دقیقه
```

### ۱.۴ مثال — تنظیمات صفحه اصلی

```json
{
    "heroTitle": "کارا بازار سلامت",
    "heroSubtitle": "سلامتی در دستان شما",
    "heroImageUrl": "/images/hero.jpg",
    "featuredCategories": ["guid1", "guid2"],
    "showPromotionBanner": true,
    "promotionText": "تخفیف ویژه زمستانه"
}
```

---

## ۲. سیستم بلاگ

### ۲.۱ Entity

```csharp
public class BlogPost {
    public Guid Id { get; set; }
    public string Title { get; set; }
    public string Slug { get; set; }           // URL-friendly
    public string Content { get; set; }         // HTML/Markdown
    public string Summary { get; set; }
    public string FeaturedImageUrl { get; set; }
    public Guid AuthorId { get; set; }
    public Guid? CategoryId { get; set; }
    public bool IsPublished { get; set; }
    public DateTime PublishedAt { get; set; }
    public List<string> Tags { get; set; }
    public int ViewCount { get; set; }
}
```

### ۲.۲ Pagination (gRPC)

```protobuf
message GetBlogPostsRequest {
    PaginationState pagination = 1;
    string categoryId = 2;
    string searchTerm = 3;
    bool publishedOnly = 4;
}
```

---

## ۳. مدیریت فایل (File Management)

### ۳.۱ معماری

```
آپلود فایل (تصویر/سند)
    │
    ▼
FileManagementService → ذخیره در فایل‌سیستم + ثبت در DB
    │
    ▼
مسیر فیزیکی: /app/uploads/{year}/{month}/{guid}.{ext}
مسیر URL: /api/files/{guid}

محدودیت‌ها:
    • حداکثر حجم: 10MB (configurable)
    • فرمت‌های مجاز: jpg, png, webp, pdf, doc, docx
    • تصاویر: resize خودکار به 800×800 (محصولات)
```

### ۳.۲ Storage Strategy

| محیط | ذخیره‌سازی |
|------|------------|
| Development | Local filesystem |
| Staging | Local filesystem (server) |
| Production | Local filesystem (server) |
| آینده | MinIO / S3 compatible (planned) |

---

## ۴. تنظیمات ایمیل و SMS

### ۴.۱ SMS (Kavenegar)

```json
{
    "Kavenegar": {
        "ApiKey": "***",
        "SenderNumber": "10008663",
        "Templates": {
            "OTP": "verify-foursat",
            "ContractOTP": "contract-verify",
            "WelcomeClub": "club-welcome",
            "OrderConfirm": "order-confirm"
        }
    }
}
```

### ۴.۲ ایمیل

```json
{
    "Email": {
        "SmtpHost": "smtp.example.com",
        "SmtpPort": 587,
        "Username": "noreply@foursat.ir",
        "FromName": "کارا بازار سلامت",
        "UseSsl": true,
        "Templates": {
            "WelcomeEmail": "welcome.html",
            "OrderReceipt": "order-receipt.html"
        }
    }
}
```

> ⚠️ ایمیل فعلاً فقط برای اطلاع‌رسانی ادمین استفاده می‌شود — SMS کانال اصلی کاربران

---

## ۵. ثوابت سیستمی (SystemConstants)

### ۵.۱ جدول اصلی

```sql
CREATE TABLE SystemConfigurations (
    [Key] NVARCHAR(200) PRIMARY KEY,
    [Value] NVARCHAR(MAX),
    [Description] NVARCHAR(500),
    [Category] NVARCHAR(100),
    [LastModified] DATETIME2
);
```

### ۵.۲ مقادیر کلیدی

| Category | Key | Value | توضیح |
|----------|-----|-------|--------|
| Club | `Club.ActivationFee` | 25000000 | هزینه فعالسازی |
| Club | `Club.GiftValue` | 25200000 | واریز Pool |
| Club | `GoldenPackageAmount` | 56000000 | قیمت پکیج طلایی |
| Club | `MaxNetworkLevel` | 15 | حداکثر عمق درخت |
| Club | `MaxWeeklyBalance` | 300 | سقف هفتگی |
| Payment | `VAT.Percentage` | 10 | مالیات ارزش افزوده |
| Payment | `DayaLoanAmount` | 56000000 | مبلغ وام |
| Store | `DiscountPercentage` | 30 | تخفیف باشگاه |
| Store | `ProductsPerPage` | 12 | تعداد در صفحه |
| System | `SmsProvider` | Kavenegar | ارائه‌دهنده SMS |
| System | `MaintenanceMode` | false | حالت تعمیر |

---

## ۶. Chatika AI Integration

### ۶.۱ معماری

```
Hangfire Recurring Job (هر ۵ دقیقه)
    │
    ▼
ChatikaJob → بررسی پیام‌های جدید کاربران
    │
    ▼
ارسال به Chatika API (با Polly retry ×3)
    │
    ▼
دریافت پاسخ → ذخیره در ChatMessages
    │
    ▼
نمایش در UI باشگاه (real-time via SignalR planned)
```

### ۶.۲ فعلی vs آینده

| آیتم | فعلی | آینده |
|------|-------|-------|
| ارتباط | Polling (Hangfire) | SignalR real-time |
| دسترسی | فقط اعضای باشگاه | تعمیم به همه؟ |
| نوع پیام | متنی | متنی + تصویری |

---

## ۷. Landing Page

### ۷.۱ ساختار

```
Hero Section (انیمیشن fade-in)
    │
    ▼
ویژگی‌ها (Features Grid — 3 ستونه)
    │
    ▼
محصولات ویژه (Carousel)
    │
    ▼
آمار (Counter animation — اصلاح‌شده)
    │
    ▼
CTA — Call to Action (ثبت‌نام / ورود)
```

### ۷.۲ اصلاح انیمیشن Counter

```
مشکل: اعداد به صورت exponential افزایش پیدا می‌کردند
راه‌حل: linear interpolation با requestAnimationFrame
    start → target در ۲ ثانیه، مساوی‌الفاصله
```

---

## ۸. خلاصه وضعیت

| ماژول | وضعیت | درصد |
|-------|--------|------|
| Site Pages (Shopify-style) | ✅ | 100% |
| بلاگ + Pagination | ✅ | 100% |
| مدیریت فایل | ✅ | 100% |
| SMS (Kavenegar) | ✅ | 100% |
| ایمیل | ⚠️ محدود | 50% |
| Chatika AI | ✅ | 100% |
| Landing Page | ✅ | 100% |
| SystemConstants | ✅ | 100% |
| SEO Meta Tags | ⬜ | 20% |