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

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 دقیقه

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

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

---

۲. سیستم بلاگ

۲.۱ Entity

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)

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)

{
    "Kavenegar": {
        "ApiKey": "***",
        "SenderNumber": "1000001110100",
        "DefaultTemplate": "Afrino",
        "_note": "تمام OTPها با قالب Afrino ارسال می‌شوند"
    }
}

۴.۲ ایمیل

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

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

---

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

۵.۱ جدول اصلی

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

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

Category	Key	Value	توضیح
Club	ClubActivationFee	25200000	هزینه فعالسازی (ریال)
Club	ClubMembershipGiftValue	25200000	واریز Pool
Club	BasePackageAmount	56000000	قیمت پکیج طلایی (ریال)
Club	CommissionMaxNetworkLevel	15	عمق محاسبه کمیسیون
Club	CommissionMaxWeeklyBalancesPerLeg	300	سقف هفتگی
Payment	ShopVAT	0.1 (10%)	مالیات (فروشگاه تخفیفی: 9%)
Payment	DayaLoanAmount	56000000	مبلغ وام (ریال)
Payment	MinimumWithdrawAmount	1000000	حداقل برداشت (ریال)
Store	MaxDiscountPercent	per-product	0-100، هر محصول جداگانه
Store	ProductsPerPage	12 (FO) / 10 (CMS)	تعداد در صفحه
System	CommissionCalculationMethod	"SP"	Stored Procedure
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%