feat: Add Chatika integration and Club Features system documentation
- Implement Chatika account activation via background job - Create IChatikaApiService interface and its implementation - Add Club Features system documentation detailing features and entities - Introduce ClubFeatureType enum to replace hardcoded IDs - Update SQL scripts for Club Membership migration - Fix various bugs in BackOffice UI and improve Products page functionality
This commit is contained in:
masoodafar-web
+24
-8
@@ -1,7 +1,7 @@
|
||||
# 📚 FourSat Project - فهرست جامع مستندات
|
||||
|
||||
> **نسخه**: 2.1
|
||||
> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴ (December 19, 2025)
|
||||
> **نسخه**: 2.3
|
||||
> **آخرین بروزرسانی**: ۳ دی ۱۴۰۴ (December 23, 2025)
|
||||
> **وضعیت**: ✅ تجمیع و بازسازی کامل
|
||||
|
||||
---
|
||||
@@ -28,7 +28,7 @@
|
||||
### Backend Services:
|
||||
| سرویس | وضعیت | تکمیل | فایل مرجع |
|
||||
|-------|------|------|-----------|
|
||||
| **CMS Microservice** | ✅ Production Ready | 95% | [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md) |
|
||||
| **CMS Microservice** | ✅ Production Ready | 96% | [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md) |
|
||||
| **BackOffice.BFF** | ✅ Production Ready | 100% | [`03-BACKEND/BackOffice.BFF/handlers-status.md`](03-BACKEND/BackOffice.BFF/handlers-status.md) |
|
||||
| **FrontOffice.BFF** | 🚧 In Progress | 60% | [`03-BACKEND/FrontOffice.BFF/README.md`](03-BACKEND/FrontOffice.BFF/README.md) |
|
||||
|
||||
@@ -38,11 +38,12 @@
|
||||
| **BackOffice UI** | ✅ Production Ready | 100% | [`04-FRONTEND/BackOffice/ui-status.md`](04-FRONTEND/BackOffice/ui-status.md) |
|
||||
| **FrontOffice UI** | 🚧 In Progress | 75% | [`04-FRONTEND/FrontOffice/README.md`](04-FRONTEND/FrontOffice/README.md) |
|
||||
|
||||
### آخرین دستاوردها (۱۴ آذر):
|
||||
- ✅ **FrontOffice UI**: 7 صفحه جدید (Club, Network, Commission)
|
||||
- ✅ **FrontOffice.BFF**: 3 ماژول جدید (ClubMembership, NetworkMembership, Commission)
|
||||
- ✅ **Build**: موفق با 0 خطا
|
||||
- ✅ **Documentation**: بازسازی کامل ساختار
|
||||
### آخرین دستاوردها (۳ دی):
|
||||
- ✅ **Chatika Integration**: Worker خودکار فعالسازی حساب چتیکا
|
||||
- ✅ **ClubFeatureType Enum**: جایگزینی hardcoded IDs با Enum
|
||||
- ✅ **LegPosition**: تنظیم خودکار دست چپ/راست در ثبتنام شبکه
|
||||
- ✅ **AcceptClubMembershipContract**: همگامسازی کامل با ActivateClubMembership
|
||||
- ✅ **SQL Scripts**: اصلاح اسکریپتهای مهاجرت باشگاه
|
||||
|
||||
---
|
||||
|
||||
@@ -95,6 +96,8 @@
|
||||
| [`payment-gateway.md`](03-BACKEND/CMS/payment-gateway.md) | درگاه پرداخت | ZarinPal, Daya Integration |
|
||||
| [`daya-api-implementation.md`](03-BACKEND/CMS/daya-api-implementation.md) | ✨ Daya API Guide | Complete Real API Implementation (Dec 6) |
|
||||
| [`club-membership-migration.md`](03-BACKEND/CMS/club-membership-migration.md) | ✨ Migration Scripts | اسکریپتهای مهاجرت باشگاه مشتریان (Dec 9) |
|
||||
| [`chatika-integration.md`](03-BACKEND/CMS/chatika-integration.md) | 🤖 Chatika Integration | Worker خودکار فعالسازی حساب AI (Dec 23) |
|
||||
| [`club-features-system.md`](03-BACKEND/CMS/club-features-system.md) | 🎁 Club Features | Enum، Handler ها، UserClubFeatures (Dec 23) |
|
||||
|
||||
**Key Stats**:
|
||||
- **Entities**: 50+ Domain Entities
|
||||
@@ -274,6 +277,19 @@
|
||||
|
||||
## 📝 تاریخچه تغییرات
|
||||
|
||||
### نسخه 2.3 (۳ دی ۱۴۰۴ / Dec 23, 2025):
|
||||
- ✅ **Chatika Integration**: Worker خودکار فعالسازی حساب چتیکا
|
||||
- ✅ **ClubFeatureType Enum**: جایگزینی hardcoded IDs با Enum قابل نگهداری
|
||||
- ✅ **LegPosition Logic**: تنظیم خودکار دست چپ/راست در ثبتنام شبکه
|
||||
- ✅ **Handler Sync**: همگامسازی AcceptContract و ActivateMembership
|
||||
- ✅ مستندات جدید: `chatika-integration.md`, `club-features-system.md`
|
||||
- ✅ Changelog جدید: `CHANGELOG-2025-12-23.md`
|
||||
|
||||
### نسخه 2.2 (۳۰ آذر ۱۴۰۴ / Dec 20, 2025):
|
||||
- ✅ رفع باگهای /network/balances, /club/members, /club/statistics
|
||||
- ✅ فعالسازی Products: CreateNew, Update, Gallery, Tags
|
||||
- ✅ Changelog جدید: `CHANGELOG-2025-12-20.md`
|
||||
|
||||
### نسخه 2.0 (۱۴ آذر ۱۴۰۴):
|
||||
- ✅ بازسازی کامل ساختار مستندات
|
||||
- ✅ تجمیع اسناد تکراری
|
||||
|
||||
@@ -1,9 +1,24 @@
|
||||
# BackOffice Development Plan - Network & Commission System
|
||||
|
||||
**Date**: 2025-12-01
|
||||
**Version**: 2.3
|
||||
**Date**: ۳۰ آذر ۱۴۰۴ (2025-12-20)
|
||||
**Version**: 2.4
|
||||
**Status**: 🟢 **Production Ready - 100% Complete**
|
||||
**Last Updated**: 2025-12-01
|
||||
**Last Updated**: 2025-12-20
|
||||
|
||||
---
|
||||
|
||||
## 🆕 آخرین تغییرات (۳۰ آذر ۱۴۰۴)
|
||||
|
||||
### رفع باگهای Mapster:
|
||||
- ✅ `CommissionProfile.cs`: اضافه شدن mapping برای `GetUserWeeklyBalancesRequest`
|
||||
- ✅ `ClubMembershipProfile.cs`: بازنویسی کامل با mappings جدید
|
||||
|
||||
### اضافه شدن Service Override:
|
||||
- ✅ `ClubMembershipService.cs`: اضافه شدن `GetClubStatistics` override
|
||||
|
||||
### اضافه شدن فیلد RemainingCount:
|
||||
- ✅ `CreateNewProductsCommand.cs`: اضافه شدن `RemainingCount`
|
||||
- ✅ `UpdateProductsCommand.cs`: اضافه شدن `RemainingCount`
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,424 @@
|
||||
# 🤖 Chatika Integration Guide
|
||||
|
||||
> **آخرین بروزرسانی**: ۳ دی ۱۴۰۴ (23 December 2025)
|
||||
> **وضعیت**: ✅ Production Ready
|
||||
|
||||
---
|
||||
|
||||
## 📋 فهرست
|
||||
|
||||
1. [معرفی](#معرفی)
|
||||
2. [معماری](#معماری)
|
||||
3. [API چتیکا](#api-چتیکا)
|
||||
4. [پیادهسازی](#پیادهسازی)
|
||||
5. [تنظیمات](#تنظیمات)
|
||||
6. [نحوه کار Worker](#نحوه-کار-worker)
|
||||
7. [Troubleshooting](#troubleshooting)
|
||||
|
||||
---
|
||||
|
||||
## معرفی
|
||||
|
||||
چتیکا یک سرویس هوش مصنوعی است که به عنوان اولین فیچر باشگاه مشتریان به کاربران ارائه میشود. هنگام فعالسازی باشگاه، به صورت خودکار یک حساب در چتیکا برای کاربر ایجاد میشود.
|
||||
|
||||
### ویژگیها:
|
||||
- ✅ فعالسازی خودکار حساب
|
||||
- ✅ جلوگیری از ثبت تکراری
|
||||
- ✅ Retry با Exponential Backoff
|
||||
- ✅ Logging کامل
|
||||
|
||||
---
|
||||
|
||||
## معماری
|
||||
|
||||
```
|
||||
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
|
||||
│ User Activates │───▶│ ClubMembership │───▶│ UserClubFeature │
|
||||
│ Club Package │ │ (IsActive=true) │ │ (Chatika, Id=1)│
|
||||
└─────────────────┘ └──────────────────┘ │ Notes = NULL │
|
||||
└────────┬────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ Hangfire Scheduler │
|
||||
│ Cron: */5 * * * * (Every 5 minutes) │
|
||||
└─────────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ ChatikaAccountActivationJob │
|
||||
│ │
|
||||
│ Query: SELECT * FROM UserClubFeatures │
|
||||
│ WHERE ClubFeatureId = 1 (Chatika) │
|
||||
│ AND ClubMembership.IsActive = true │
|
||||
│ AND Notes IS NULL │
|
||||
└─────────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ ChatikaApiService │
|
||||
│ POST https://api.chatika.ir/api/v1/organizations/register-user │
|
||||
│ Header: X-API-Key: {ApiKey} │
|
||||
│ Body: { "mobile_number": "09123456789" } │
|
||||
└─────────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ Update UserClubFeature │
|
||||
│ Notes = "🎉 تبریک! حساب هوش مصنوعی چتیکا شما فعال شد..." │
|
||||
│ IsActive = true │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## API چتیکا
|
||||
|
||||
### Endpoint
|
||||
|
||||
```
|
||||
POST /api/v1/organizations/register-user
|
||||
```
|
||||
|
||||
### Headers
|
||||
|
||||
| Header | Value |
|
||||
|--------|-------|
|
||||
| `X-API-Key` | Organization API Key |
|
||||
| `Content-Type` | `application/json` |
|
||||
|
||||
### Request Body
|
||||
|
||||
```json
|
||||
{
|
||||
"mobile_number": "09123456789"
|
||||
}
|
||||
```
|
||||
|
||||
### Success Response (200 OK)
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"mobile_number": "09123456789",
|
||||
"organization_id": 1,
|
||||
"organization_title": "FourSat",
|
||||
"wallet_balance": 100.0,
|
||||
"is_new_user": true,
|
||||
"credit_charged": 100.0
|
||||
}
|
||||
```
|
||||
|
||||
### Error Responses
|
||||
|
||||
| Status | Error Code | Description |
|
||||
|--------|-----------|-------------|
|
||||
| 401 | `INVALID_API_KEY` | API Key نامعتبر |
|
||||
| 403 | `ORGANIZATION_DISABLED` | سازمان غیرفعال شده |
|
||||
| 403 | `ORGANIZATION_EXPIRED` | سازمان منقضی شده |
|
||||
| 400 | `INVALID_MOBILE_FORMAT` | فرمت شماره موبایل نامعتبر |
|
||||
|
||||
---
|
||||
|
||||
## پیادهسازی
|
||||
|
||||
### 1. Interface
|
||||
|
||||
**فایل**: `CMSMicroservice.Application/Common/Interfaces/IChatikaApiService.cs`
|
||||
|
||||
```csharp
|
||||
public interface IChatikaApiService
|
||||
{
|
||||
Task<ChatikaAccountResult> CreateAccountAsync(
|
||||
string mobileNumber,
|
||||
string fullName,
|
||||
CancellationToken cancellationToken = default);
|
||||
}
|
||||
|
||||
public class ChatikaAccountResult
|
||||
{
|
||||
public bool IsSuccess { get; set; }
|
||||
public string? ErrorMessage { get; set; }
|
||||
public string? ChatikaUserId { get; set; }
|
||||
public string? AccessUrl { get; set; }
|
||||
|
||||
public static ChatikaAccountResult Success(...) => ...;
|
||||
public static ChatikaAccountResult Failure(string error) => ...;
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Service Implementation
|
||||
|
||||
**فایل**: `CMSMicroservice.Infrastructure/Services/ChatikaApiService.cs`
|
||||
|
||||
```csharp
|
||||
public class ChatikaApiService : IChatikaApiService
|
||||
{
|
||||
private readonly HttpClient _httpClient;
|
||||
private readonly ILogger<ChatikaApiService> _logger;
|
||||
|
||||
public async Task<ChatikaAccountResult> CreateAccountAsync(
|
||||
string mobileNumber,
|
||||
string fullName,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
var request = new { mobile_number = mobileNumber };
|
||||
|
||||
var response = await _httpClient.PostAsJsonAsync(
|
||||
"/api/v1/organizations/register-user",
|
||||
request,
|
||||
cancellationToken);
|
||||
|
||||
if (response.IsSuccessStatusCode)
|
||||
{
|
||||
var result = await response.Content.ReadFromJsonAsync<ChatikaRegisterResponse>();
|
||||
return ChatikaAccountResult.Success(result?.Id.ToString(), "https://chatika.ir");
|
||||
}
|
||||
|
||||
return ChatikaAccountResult.Failure($"Error: {response.StatusCode}");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Background Job
|
||||
|
||||
**فایل**: `CMSMicroservice.Infrastructure/BackgroundJobs/ChatikaAccountActivationJob.cs`
|
||||
|
||||
```csharp
|
||||
public class ChatikaAccountActivationJob
|
||||
{
|
||||
private const string ChatikaFeatureDescription =
|
||||
"🎉 تبریک! حساب هوش مصنوعی چتیکا شما فعال شد.\n\n" +
|
||||
"برای استفاده از امکانات رایگان چتیکا:\n" +
|
||||
"1️⃣ به وبسایت chatika.ir مراجعه کنید\n" +
|
||||
"2️⃣ شماره موبایل خود را وارد کنید\n" +
|
||||
"3️⃣ از دستیار هوشمند چتیکا لذت ببرید!\n\n" +
|
||||
"🔗 لینک ورود: https://chatika.ir";
|
||||
|
||||
public async Task ExecuteAsync(CancellationToken cancellationToken = default)
|
||||
{
|
||||
// 1. پیدا کردن کاربران در انتظار
|
||||
var pendingUsers = await _context.UserClubFeatures
|
||||
.Include(ucf => ucf.User)
|
||||
.Include(ucf => ucf.ClubMembership)
|
||||
.Where(ucf =>
|
||||
ucf.ClubFeatureId == (long)ClubFeatureType.Chatika &&
|
||||
ucf.ClubMembership.IsActive &&
|
||||
!ucf.IsDeleted &&
|
||||
ucf.IsActive &&
|
||||
(ucf.Notes == null || ucf.Notes == ""))
|
||||
.ToListAsync(cancellationToken);
|
||||
|
||||
// 2. پردازش هر کاربر
|
||||
foreach (var userFeature in pendingUsers)
|
||||
{
|
||||
var user = userFeature.User;
|
||||
var fullName = $"{user.FirstName} {user.LastName}".Trim();
|
||||
|
||||
// 3. کال API با Retry
|
||||
var result = await _retryPipeline.ExecuteAsync(
|
||||
async ct => await _chatikaApiService.CreateAccountAsync(
|
||||
user.Mobile, fullName, ct),
|
||||
cancellationToken);
|
||||
|
||||
// 4. آپدیت فیچر
|
||||
if (result.IsSuccess)
|
||||
{
|
||||
userFeature.Notes = ChatikaFeatureDescription;
|
||||
userFeature.IsActive = true;
|
||||
await _context.SaveChangesAsync(cancellationToken);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## تنظیمات
|
||||
|
||||
### appsettings.json
|
||||
|
||||
```json
|
||||
{
|
||||
"Chatika": {
|
||||
"BaseUrl": "https://api.chatika.ir",
|
||||
"ApiKey": "YOUR_ORGANIZATION_API_KEY"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### DI Registration
|
||||
|
||||
**فایل**: `ConfigureServices.cs`
|
||||
|
||||
```csharp
|
||||
// Chatika API Service
|
||||
services.AddHttpClient<IChatikaApiService, ChatikaApiService>()
|
||||
.SetHandlerLifetime(TimeSpan.FromMinutes(5))
|
||||
.ConfigureHttpClient((sp, client) =>
|
||||
{
|
||||
client.Timeout = TimeSpan.FromSeconds(30);
|
||||
});
|
||||
|
||||
// Background Job
|
||||
services.AddScoped<ChatikaAccountActivationJob>();
|
||||
```
|
||||
|
||||
### Hangfire Registration
|
||||
|
||||
**فایل**: `Program.cs`
|
||||
|
||||
```csharp
|
||||
// Chatika Account Activation: Every 5 minutes
|
||||
recurringJobManager.AddOrUpdate<ChatikaAccountActivationJob>(
|
||||
recurringJobId: "chatika-account-activation",
|
||||
methodCall: job => job.ExecuteAsync(CancellationToken.None),
|
||||
cronExpression: "*/5 * * * *",
|
||||
options: new RecurringJobOptions { TimeZone = TimeZoneInfo.Utc });
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## نحوه کار Worker
|
||||
|
||||
### Flowchart
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────┐
|
||||
│ START (Every 5 min) │
|
||||
└──────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌──────────────────────────────────────────────────────────────┐
|
||||
│ Query: Users with Chatika feature & Notes = NULL │
|
||||
└──────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Any Users? │
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌────────────┴────────────┐
|
||||
│ NO │ YES
|
||||
▼ ▼
|
||||
┌──────────┐ ┌───────────────┐
|
||||
│ END │ │ For each user │
|
||||
└──────────┘ └───────┬───────┘
|
||||
│
|
||||
▼
|
||||
┌────────────────────┐
|
||||
│ Call Chatika API │
|
||||
│ (with 3x Retry) │
|
||||
└────────┬───────────┘
|
||||
│
|
||||
┌─────────┴─────────┐
|
||||
│ SUCCESS │ FAILURE
|
||||
▼ ▼
|
||||
┌───────────────┐ ┌───────────────┐
|
||||
│ Update Notes │ │ Log Warning │
|
||||
│ IsActive=true │ │ Continue │
|
||||
└───────────────┘ └───────────────┘
|
||||
│
|
||||
▼
|
||||
┌────────────────┐
|
||||
│ Next User │
|
||||
└────────────────┘
|
||||
```
|
||||
|
||||
### Retry Policy
|
||||
|
||||
```csharp
|
||||
// Polly Retry: 3 attempts with exponential backoff
|
||||
_retryPipeline = new ResiliencePipelineBuilder()
|
||||
.AddRetry(new RetryStrategyOptions
|
||||
{
|
||||
MaxRetryAttempts = 3,
|
||||
Delay = TimeSpan.FromSeconds(30),
|
||||
BackoffType = DelayBackoffType.Exponential,
|
||||
UseJitter = true
|
||||
})
|
||||
.Build();
|
||||
```
|
||||
|
||||
**Retry Timeline:**
|
||||
- Attempt 1: Immediate
|
||||
- Attempt 2: ~30 seconds later
|
||||
- Attempt 3: ~60 seconds later
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### 1. API Key Invalid
|
||||
|
||||
**خطا**: `INVALID_API_KEY`
|
||||
|
||||
**راهحل**:
|
||||
1. بررسی `appsettings.json`
|
||||
2. تأیید API Key در داشبورد چتیکا
|
||||
3. چک کردن header name: باید `X-API-Key` باشد
|
||||
|
||||
### 2. Users Not Being Processed
|
||||
|
||||
**علت احتمالی**:
|
||||
1. `ClubMembership.IsActive = false`
|
||||
2. `UserClubFeature.Notes` قبلاً پر شده
|
||||
3. `ClubFeatureId != 1`
|
||||
|
||||
**Debug Query**:
|
||||
```sql
|
||||
SELECT ucf.*, u.Mobile, cm.IsActive
|
||||
FROM UserClubFeatures ucf
|
||||
JOIN Users u ON ucf.UserId = u.Id
|
||||
JOIN ClubMemberships cm ON ucf.ClubMembershipId = cm.Id
|
||||
WHERE ucf.ClubFeatureId = 1
|
||||
AND ucf.IsDeleted = 0
|
||||
AND (ucf.Notes IS NULL OR ucf.Notes = '')
|
||||
```
|
||||
|
||||
### 3. Hangfire Job Not Running
|
||||
|
||||
**راهحل**:
|
||||
1. چک کردن Hangfire Dashboard: `/hangfire`
|
||||
2. بررسی لاگها در Seq
|
||||
3. تأیید ثبت Job در `Program.cs`
|
||||
|
||||
### 4. Network Timeout
|
||||
|
||||
**علت**: سرور چتیکا در دسترس نیست
|
||||
|
||||
**راهحل**:
|
||||
- Retry Policy خودکار 3 بار تلاش میکند
|
||||
- بررسی لاگها برای خطای دقیق
|
||||
- تماس با پشتیبانی چتیکا
|
||||
|
||||
---
|
||||
|
||||
## 📊 Monitoring
|
||||
|
||||
### Logs to Watch
|
||||
|
||||
```
|
||||
🚀 Starting Chatika account activation job
|
||||
📋 Found {Count} users pending Chatika activation
|
||||
🤖 Creating Chatika account for mobile: 0912***
|
||||
✅ Chatika account activated for user {UserId}
|
||||
⚠️ Failed to create Chatika account for user {UserId}: {Error}
|
||||
❌ Network error calling Chatika API
|
||||
🏁 Chatika activation job completed. Success: {X}, Failed: {Y}
|
||||
```
|
||||
|
||||
### Seq Query
|
||||
|
||||
```
|
||||
ApplicationName = "CMSMicroservice" AND Message LIKE "%Chatika%"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 مستندات مرتبط
|
||||
|
||||
- [Club Features System](./club-features-system.md)
|
||||
- [Hangfire Jobs Guide](./hangfire-jobs.md)
|
||||
- [Commission System](./commission-system.md)
|
||||
@@ -0,0 +1,340 @@
|
||||
# 🎁 Club Features System
|
||||
|
||||
> **آخرین بروزرسانی**: ۳ دی ۱۴۰۴ (23 December 2025)
|
||||
> **وضعیت**: ✅ Production Ready
|
||||
|
||||
---
|
||||
|
||||
## 📋 فهرست
|
||||
|
||||
1. [معرفی](#معرفی)
|
||||
2. [فیچرهای باشگاه](#فیچرهای-باشگاه)
|
||||
3. [Entity ها](#entity-ها)
|
||||
4. [Enum ClubFeatureType](#enum-clubfeaturetype)
|
||||
5. [فرآیند فعالسازی](#فرآیند-فعالسازی)
|
||||
6. [API ها](#api-ها)
|
||||
|
||||
---
|
||||
|
||||
## معرفی
|
||||
|
||||
سیستم فیچرهای باشگاه مشتریان، امکانات ویژهای را برای اعضای باشگاه فراهم میکند. هر کاربر با فعالسازی باشگاه، به تمام 4 فیچر دسترسی پیدا میکند.
|
||||
|
||||
---
|
||||
|
||||
## فیچرهای باشگاه
|
||||
|
||||
| Id | نام | عنوان فارسی | توضیح |
|
||||
|----|-----|-------------|-------|
|
||||
| 1 | **Chatika** | چتیکا | دستیار هوش مصنوعی - حساب خودکار ایجاد میشود |
|
||||
| 2 | **Bime** | بیمه | خدمات بیمهای |
|
||||
| 3 | **Trip** | تریپ | خدمات سفر و گردشگری |
|
||||
| 4 | **Learn** | لرن | آموزش و یادگیری |
|
||||
|
||||
---
|
||||
|
||||
## Entity ها
|
||||
|
||||
### ClubFeature (تعریف فیچرها)
|
||||
|
||||
```csharp
|
||||
public class ClubFeature : BaseAuditableEntity
|
||||
{
|
||||
public string Title { get; set; }
|
||||
public string? Description { get; set; }
|
||||
public bool IsActive { get; set; }
|
||||
public int SortOrder { get; set; }
|
||||
|
||||
public virtual ICollection<UserClubFeature>? UserClubFeatures { get; set; }
|
||||
}
|
||||
```
|
||||
|
||||
### UserClubFeature (فیچرهای کاربر)
|
||||
|
||||
```csharp
|
||||
public class UserClubFeature : BaseAuditableEntity
|
||||
{
|
||||
public long UserId { get; set; }
|
||||
public virtual User User { get; set; }
|
||||
|
||||
public long ClubMembershipId { get; set; }
|
||||
public virtual ClubMembership ClubMembership { get; set; }
|
||||
|
||||
public long ClubFeatureId { get; set; }
|
||||
public virtual ClubFeature ClubFeature { get; set; }
|
||||
|
||||
public DateTime GrantedAt { get; set; }
|
||||
public bool IsActive { get; set; } = true;
|
||||
public string? Notes { get; set; } // توضیحات اختیاری یا وضعیت فعالسازی
|
||||
}
|
||||
```
|
||||
|
||||
### Database Schema
|
||||
|
||||
```sql
|
||||
CREATE TABLE ClubFeatures (
|
||||
Id BIGINT PRIMARY KEY IDENTITY,
|
||||
Title NVARCHAR(200) NOT NULL,
|
||||
Description NVARCHAR(MAX),
|
||||
IsActive BIT DEFAULT 1,
|
||||
SortOrder INT DEFAULT 0,
|
||||
-- BaseAuditableEntity fields
|
||||
Created DATETIME2,
|
||||
CreatedBy NVARCHAR(100),
|
||||
LastModified DATETIME2,
|
||||
LastModifiedBy NVARCHAR(100),
|
||||
IsDeleted BIT DEFAULT 0
|
||||
);
|
||||
|
||||
CREATE TABLE UserClubFeatures (
|
||||
Id BIGINT PRIMARY KEY IDENTITY,
|
||||
UserId BIGINT NOT NULL FOREIGN KEY REFERENCES Users(Id),
|
||||
ClubMembershipId BIGINT NOT NULL FOREIGN KEY REFERENCES ClubMemberships(Id),
|
||||
ClubFeatureId BIGINT NOT NULL FOREIGN KEY REFERENCES ClubFeatures(Id),
|
||||
GrantedAt DATETIME2 NOT NULL,
|
||||
IsActive BIT DEFAULT 1,
|
||||
Notes NVARCHAR(MAX),
|
||||
-- BaseAuditableEntity fields
|
||||
Created DATETIME2,
|
||||
CreatedBy NVARCHAR(100),
|
||||
LastModified DATETIME2,
|
||||
LastModifiedBy NVARCHAR(100),
|
||||
IsDeleted BIT DEFAULT 0
|
||||
);
|
||||
|
||||
-- Seed Data
|
||||
INSERT INTO ClubFeatures (Id, Title, Description, IsActive, SortOrder)
|
||||
VALUES
|
||||
(1, N'چتیکا', N'دستیار هوش مصنوعی', 1, 1),
|
||||
(2, N'بیمه', N'خدمات بیمهای', 1, 2),
|
||||
(3, N'تریپ', N'خدمات سفر و گردشگری', 1, 3),
|
||||
(4, N'لرن', N'آموزش و یادگیری', 1, 4);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Enum ClubFeatureType
|
||||
|
||||
برای جلوگیری از hardcoded IDs، از Enum استفاده میشود:
|
||||
|
||||
**فایل**: `CMSMicroservice.Domain/Enums/ClubFeatureType.cs`
|
||||
|
||||
```csharp
|
||||
namespace CMSMicroservice.Domain.Enums;
|
||||
|
||||
/// <summary>
|
||||
/// انواع ویژگیهای باشگاه مشتریان
|
||||
/// </summary>
|
||||
public enum ClubFeatureType
|
||||
{
|
||||
/// <summary>
|
||||
/// چتیکا - دستیار هوش مصنوعی
|
||||
/// </summary>
|
||||
Chatika = 1,
|
||||
|
||||
/// <summary>
|
||||
/// بیمه - خدمات بیمهای
|
||||
/// </summary>
|
||||
Bime = 2,
|
||||
|
||||
/// <summary>
|
||||
/// تریپ - خدمات سفر و گردشگری
|
||||
/// </summary>
|
||||
Trip = 3,
|
||||
|
||||
/// <summary>
|
||||
/// لرن - آموزش و یادگیری
|
||||
/// </summary>
|
||||
Learn = 4
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Extension methods برای ClubFeatureType
|
||||
/// </summary>
|
||||
public static class ClubFeatureTypeExtensions
|
||||
{
|
||||
/// <summary>
|
||||
/// دریافت تمام مقادیر ClubFeatureType به صورت آرایه long
|
||||
/// </summary>
|
||||
public static long[] GetAllFeatureIds()
|
||||
{
|
||||
return Enum.GetValues<ClubFeatureType>()
|
||||
.Select(f => (long)f)
|
||||
.ToArray();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// دریافت عنوان فارسی ویژگی
|
||||
/// </summary>
|
||||
public static string GetPersianTitle(this ClubFeatureType featureType)
|
||||
{
|
||||
return featureType switch
|
||||
{
|
||||
ClubFeatureType.Chatika => "چتیکا",
|
||||
ClubFeatureType.Bime => "بیمه",
|
||||
ClubFeatureType.Trip => "تور و سفر",
|
||||
ClubFeatureType.Learn => "آموزش",
|
||||
_ => featureType.ToString()
|
||||
};
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### استفاده در کد
|
||||
|
||||
```csharp
|
||||
// ❌ قبل - Hardcoded
|
||||
var featureIds = new long[] { 1, 2, 3, 4 };
|
||||
|
||||
// ✅ بعد - با Enum
|
||||
var featureIds = ClubFeatureTypeExtensions.GetAllFeatureIds();
|
||||
|
||||
// دسترسی به یک فیچر خاص
|
||||
var chatikaId = (long)ClubFeatureType.Chatika; // = 1
|
||||
var title = ClubFeatureType.Bime.GetPersianTitle(); // = "بیمه"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## فرآیند فعالسازی
|
||||
|
||||
هنگام فعالسازی باشگاه مشتریان، فیچرها به این ترتیب اختصاص داده میشوند:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ ActivateClubMembershipCommandHandler │
|
||||
│ یا │
|
||||
│ AcceptClubMembershipContractCommandHandler │
|
||||
└─────────────────────────────┬───────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ // 8. اختصاص فیچرهای باشگاه │
|
||||
│ var featureIds = ClubFeatureTypeExtensions.GetAllFeatureIds(); │
|
||||
│ foreach (var featureId in featureIds) │
|
||||
│ { │
|
||||
│ _context.UserClubFeatures.Add(new UserClubFeature │
|
||||
│ { │
|
||||
│ UserId = user.Id, │
|
||||
│ ClubMembershipId = membership.Id, │
|
||||
│ ClubFeatureId = featureId, │
|
||||
│ GrantedAt = DateTime.Now, │
|
||||
│ IsActive = true, │
|
||||
│ Notes = null // برای چتیکا بعداً توسط Worker پر میشود │
|
||||
│ }); │
|
||||
│ } │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 4 UserClubFeature Records │
|
||||
│ ┌─────────────┬──────────────┬────────────┬─────────────┐ │
|
||||
│ │ ClubFeatureId │ GrantedAt │ IsActive │ Notes │ │
|
||||
│ ├─────────────┼──────────────┼────────────┼─────────────┤ │
|
||||
│ │ 1 (Chatika) │ 2025-12-23 │ true │ NULL → پر │ │
|
||||
│ │ 2 (Bime) │ 2025-12-23 │ true │ NULL │ │
|
||||
│ │ 3 (Trip) │ 2025-12-23 │ true │ NULL │ │
|
||||
│ │ 4 (Learn) │ 2025-12-23 │ true │ NULL │ │
|
||||
│ └─────────────┴──────────────┴────────────┴─────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼ (برای چتیکا)
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ ChatikaAccountActivationJob (Worker) │
|
||||
│ - هر 5 دقیقه اجرا میشود │
|
||||
│ - کاربران با Notes = NULL و ClubFeatureId = 1 را پیدا میکند │
|
||||
│ - API چتیکا را کال میکند │
|
||||
│ - Notes را با توضیحات فارسی پر میکند │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## API ها
|
||||
|
||||
### GetUserClubFeatures
|
||||
|
||||
دریافت لیست فیچرهای فعال کاربر:
|
||||
|
||||
```protobuf
|
||||
rpc GetUserClubFeatures (GetUserClubFeaturesRequest) returns (GetUserClubFeaturesResponse);
|
||||
|
||||
message GetUserClubFeaturesRequest {
|
||||
int64 user_id = 1;
|
||||
}
|
||||
|
||||
message GetUserClubFeaturesResponse {
|
||||
repeated UserClubFeatureModel features = 1;
|
||||
}
|
||||
|
||||
message UserClubFeatureModel {
|
||||
int64 id = 1;
|
||||
int64 club_feature_id = 2;
|
||||
string feature_title = 3;
|
||||
string feature_description = 4;
|
||||
google.protobuf.Timestamp granted_at = 5;
|
||||
bool is_active = 6;
|
||||
string notes = 7;
|
||||
}
|
||||
```
|
||||
|
||||
### ToggleUserClubFeature
|
||||
|
||||
فعال/غیرفعال کردن فیچر توسط ادمین:
|
||||
|
||||
```protobuf
|
||||
rpc ToggleUserClubFeature (ToggleUserClubFeatureRequest) returns (ToggleUserClubFeatureResponse);
|
||||
|
||||
message ToggleUserClubFeatureRequest {
|
||||
int64 user_club_feature_id = 1;
|
||||
bool is_active = 2;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Query های مفید
|
||||
|
||||
### تعداد فیچرهای فعال هر کاربر
|
||||
|
||||
```sql
|
||||
SELECT u.Mobile, COUNT(ucf.Id) as FeatureCount
|
||||
FROM Users u
|
||||
JOIN UserClubFeatures ucf ON u.Id = ucf.UserId
|
||||
WHERE ucf.IsActive = 1 AND ucf.IsDeleted = 0
|
||||
GROUP BY u.Mobile
|
||||
```
|
||||
|
||||
### کاربران بدون فیچر چتیکا فعال
|
||||
|
||||
```sql
|
||||
SELECT u.Id, u.Mobile
|
||||
FROM Users u
|
||||
JOIN ClubMemberships cm ON u.Id = cm.UserId
|
||||
WHERE cm.IsActive = 1
|
||||
AND NOT EXISTS (
|
||||
SELECT 1 FROM UserClubFeatures ucf
|
||||
WHERE ucf.UserId = u.Id
|
||||
AND ucf.ClubFeatureId = 1
|
||||
AND ucf.IsActive = 1
|
||||
)
|
||||
```
|
||||
|
||||
### وضعیت فعالسازی چتیکا
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
CASE WHEN Notes IS NOT NULL THEN 'Activated' ELSE 'Pending' END as Status,
|
||||
COUNT(*) as Count
|
||||
FROM UserClubFeatures
|
||||
WHERE ClubFeatureId = 1 AND IsDeleted = 0
|
||||
GROUP BY CASE WHEN Notes IS NOT NULL THEN 'Activated' ELSE 'Pending' END
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 مستندات مرتبط
|
||||
|
||||
- [Chatika Integration](./chatika-integration.md)
|
||||
- [Club Membership Migration](./club-membership-migration.md)
|
||||
- [Commission System](./commission-system.md)
|
||||
@@ -1,7 +1,7 @@
|
||||
# گزارش وضعیت UI پنل مدیریت (BackOffice)
|
||||
|
||||
تاریخ گزارش: 2024-12-04
|
||||
وضعیت کلی: **آماده برای Production - 95% کامل** 🎉
|
||||
تاریخ گزارش: ۳۰ آذر ۱۴۰۴ (2025-12-20)
|
||||
وضعیت کلی: **آماده برای Production - 100% کامل** 🎉
|
||||
|
||||
---
|
||||
|
||||
@@ -14,8 +14,30 @@
|
||||
| Services Backend | 8 فایل (4 Interface + 4 Implementation) | ✅ کامل |
|
||||
| Dialog Components | 6 کامپوننت | ✅ کامل |
|
||||
| اتصالات CRUD | همه عملیات | ✅ کامل |
|
||||
| گزارشها و نمودارهای مالی | 2 صفحه | 🟡 تکمیل پایه (PDF باقیمانده) |
|
||||
| **جمع کل** | **60 صفحه + 8 سرویس + 6 دیالوگ** | **95% آماده** 🎉 |
|
||||
| گزارشها و نمودارهای مالی | 2 صفحه | ✅ کامل |
|
||||
| **جمع کل** | **60 صفحه + 8 سرویس + 6 دیالوگ** | **100% آماده** 🎉 |
|
||||
|
||||
---
|
||||
|
||||
## 🆕 آخرین تغییرات (۳۰ آذر ۱۴۰۴)
|
||||
|
||||
### باگهای رفع شده:
|
||||
- ✅ `/network/balances` - ValidationException برطرف شد (Mapster mapping)
|
||||
- ✅ `/club/members` - مشکل لود دادهها برطرف شد (ClubMembershipProfile)
|
||||
- ✅ `/club/statistics` - خطای Unimplemented برطرف شد (GetClubStatistics override)
|
||||
|
||||
### قابلیتهای فعال شده در Products:
|
||||
- ✅ `CreateNew()` - ایجاد محصول جدید با CreateDialog
|
||||
- ✅ `Update()` - ویرایش محصول با UpdateDialog
|
||||
- ✅ `OpenGallery()` - مدیریت گالری با GalleryDialog
|
||||
- ✅ `OpenTagAssignment()` - اختصاص تگ با AssignTagsDialog
|
||||
|
||||
### فیلد موجودی محصولات:
|
||||
- ✅ فیلد "تعداد موجودی" در CreateDialog و UpdateDialog
|
||||
- ✅ ستون موجودی در لیست با نمایش رنگی:
|
||||
- 🔴 **ناموجود** (موجودی ≤ 0)
|
||||
- 🟡 **کم موجود** (موجودی < 10)
|
||||
- 🟢 **موجود** (موجودی ≥ 10)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,180 @@
|
||||
# 📝 Changelog - ۳۰ آذر ۱۴۰۴ (20 December 2025)
|
||||
|
||||
> **Session**: رفع باگهای BackOffice UI و فعالسازی قابلیتهای Products
|
||||
|
||||
---
|
||||
|
||||
## 🎯 خلاصه Session
|
||||
|
||||
این session شامل رفع چندین باگ در صفحات BackOffice و فعالسازی قابلیتهای صفحه Products بود.
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Bug Fixes
|
||||
|
||||
### 1. صفحه `/network/balances` - ValidationException ✅
|
||||
|
||||
**مشکل**: خطای ValidationException هنگام لود صفحه بالانسهای هفتگی
|
||||
|
||||
**علت**: Mapster mapping برای `GetUserWeeklyBalancesRequest` → `GetUserWeeklyBalancesQuery` وجود نداشت
|
||||
|
||||
**راهحل**: اضافه کردن mapping در `CommissionProfile.cs`:
|
||||
```csharp
|
||||
config.NewConfig<GetUserWeeklyBalancesRequest, GetUserWeeklyBalancesQuery>()
|
||||
.Map(dest => dest.PaginationState, src => src.PaginationState);
|
||||
```
|
||||
|
||||
**فایل**: `BackOffice.BFF/src/BackOffice.BFF.WebApi/Common/Mappings/CommissionProfile.cs`
|
||||
|
||||
---
|
||||
|
||||
### 2. صفحه `/club/members` - دادهها لود نمیشدند ✅
|
||||
|
||||
**مشکل**: صفحه خالی بود و هیچ دادهای نمایش نمیداد
|
||||
|
||||
**علت**: Mapster mappings برای `GetAllClubMemberships` در CMS و BFF وجود نداشت
|
||||
|
||||
**راهحل**: ایجاد `ClubMembershipProfile.cs` در هر دو لایه
|
||||
|
||||
**فایلهای جدید/تغییر یافته**:
|
||||
- `CMS/src/CMSMicroservice.WebApi/Common/Mappings/ClubMembershipProfile.cs` (NEW)
|
||||
- `BackOffice.BFF/src/BackOffice.BFF.WebApi/Common/Mappings/ClubMembershipProfile.cs` (REWRITTEN)
|
||||
|
||||
**Mappings اضافه شده**:
|
||||
```csharp
|
||||
// CMS
|
||||
GetAllClubMembershipsRequest → GetAllClubMembershipsQuery
|
||||
GetAllClubMembershipsResponseDto → GetAllClubMembershipsResponse
|
||||
|
||||
// BFF
|
||||
BFF.GetAllClubMembershipsRequest → GetAllClubMembershipsQuery
|
||||
CMS.GetAllClubMembershipsResponse → BFF.GetAllClubMembershipsResponse
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. صفحه `/club/statistics` - Unimplemented Error ✅
|
||||
|
||||
**مشکل**: خطای `Status(StatusCode="Unimplemented", Detail="Method cms.ClubMembershipContract/GetClubStatistics is unimplemented")`
|
||||
|
||||
**علت**: متد `GetClubStatistics` در BFF Service override نشده بود
|
||||
|
||||
**راهحل**:
|
||||
1. اضافه کردن override در `ClubMembershipService.cs`:
|
||||
```csharp
|
||||
public override async Task<GetClubStatisticsResponse> GetClubStatistics(
|
||||
GetClubStatisticsRequest request, ServerCallContext context)
|
||||
{
|
||||
return await _dispatchRequestToCQRS.Handle<GetClubStatisticsRequest, GetClubStatisticsQuery, GetClubStatisticsResponse>(request, context);
|
||||
}
|
||||
```
|
||||
|
||||
2. اضافه کردن mappings برای Statistics در هر دو Profile
|
||||
|
||||
**فایلهای تغییر یافته**:
|
||||
- `BackOffice.BFF/src/BackOffice.BFF.WebApi/Services/ClubMembershipService.cs`
|
||||
- `CMS/src/CMSMicroservice.WebApi/Common/Mappings/ClubMembershipProfile.cs`
|
||||
- `BackOffice.BFF/src/BackOffice.BFF.WebApi/Common/Mappings/ClubMembershipProfile.cs`
|
||||
|
||||
---
|
||||
|
||||
## ✨ New Features
|
||||
|
||||
### 4. فعالسازی قابلیتهای صفحه Products ✅
|
||||
|
||||
**قبل**: همه دکمهها پیام "در حال توسعه" نشان میدادند (کد comment شده بود)
|
||||
|
||||
**بعد**: همه قابلیتها فعال شدند
|
||||
|
||||
**متدهای فعال شده در `ProductsMainPage.razor.cs`**:
|
||||
- ✅ `CreateNew()` - ایجاد محصول جدید با CreateDialog
|
||||
- ✅ `Update()` - ویرایش محصول با UpdateDialog
|
||||
- ✅ `OpenGallery()` - مدیریت گالری تصاویر با GalleryDialog
|
||||
- ✅ `OpenTagAssignment()` - اختصاص تگ به محصول با AssignTagsDialog
|
||||
|
||||
**فایل**: `BackOffice/src/BackOffice/Pages/Products/ProductsMainPage.razor.cs`
|
||||
|
||||
---
|
||||
|
||||
### 5. فیلد "تعداد موجودی" در Products ✅
|
||||
|
||||
**اضافات در UI**:
|
||||
|
||||
| فایل | تغییر |
|
||||
|------|-------|
|
||||
| `CreateDialog.razor` | اضافه شدن فیلد `RemainingCount` |
|
||||
| `UpdateDialog.razor` | اضافه شدن فیلد `RemainingCount` |
|
||||
| `ProductsMainPage.razor` | اضافه شدن ستون موجودی با رنگبندی |
|
||||
|
||||
**نمایش موجودی در لیست**:
|
||||
- 🔴 **ناموجود** - اگر موجودی `0` یا کمتر (Chip قرمز)
|
||||
- 🟡 **کم موجود** - اگر موجودی کمتر از `10` (Chip زرد)
|
||||
- 🟢 **موجود** - اگر موجودی `10` یا بیشتر (Chip سبز)
|
||||
|
||||
**فیکس در BFF** (مهم!):
|
||||
فیلد `RemainingCount` در BFF Application Commands نبود و باعث میشد مقدار ارسال/دریافت نشه:
|
||||
|
||||
```csharp
|
||||
// BackOffice.BFF.Application/ProductsCQ/Commands/CreateNewProducts/CreateNewProductsCommand.cs
|
||||
public int RemainingCount { get; init; } // ← اضافه شد
|
||||
|
||||
// BackOffice.BFF.Application/ProductsCQ/Commands/UpdateProducts/UpdateProductsCommand.cs
|
||||
public int RemainingCount { get; init; } // ← اضافه شد
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 لیست کامل فایلهای تغییر یافته
|
||||
|
||||
### BackOffice.BFF (5 فایل)
|
||||
| فایل | تغییر |
|
||||
|------|-------|
|
||||
| `WebApi/Common/Mappings/CommissionProfile.cs` | اضافه شدن mapping برای GetUserWeeklyBalances |
|
||||
| `WebApi/Common/Mappings/ClubMembershipProfile.cs` | بازنویسی کامل با mappings جدید |
|
||||
| `WebApi/Services/ClubMembershipService.cs` | اضافه شدن GetClubStatistics override |
|
||||
| `Application/.../CreateNewProductsCommand.cs` | اضافه شدن RemainingCount |
|
||||
| `Application/.../UpdateProductsCommand.cs` | اضافه شدن RemainingCount |
|
||||
|
||||
### CMS (1 فایل جدید)
|
||||
| فایل | تغییر |
|
||||
|------|-------|
|
||||
| `WebApi/Common/Mappings/ClubMembershipProfile.cs` | فایل جدید با mappings کامل |
|
||||
|
||||
### BackOffice UI (4 فایل)
|
||||
| فایل | تغییر |
|
||||
|------|-------|
|
||||
| `Pages/Products/ProductsMainPage.razor.cs` | فعالسازی CreateNew, Update, OpenGallery, OpenTagAssignment |
|
||||
| `Pages/Products/ProductsMainPage.razor` | اضافه شدن ستون موجودی |
|
||||
| `Pages/Products/Components/CreateDialog.razor` | اضافه شدن فیلد موجودی |
|
||||
| `Pages/Products/Components/UpdateDialog.razor` | اضافه شدن فیلد موجودی |
|
||||
|
||||
---
|
||||
|
||||
## 📊 Build Status
|
||||
|
||||
```
|
||||
✅ BackOffice.BFF: Build succeeded (0 errors)
|
||||
✅ CMS: Build succeeded (0 errors)
|
||||
✅ BackOffice UI: Build succeeded (0 errors)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 نکات فنی
|
||||
|
||||
### Mapster با Proto Types
|
||||
برای proto types که immutable هستند، از `MapWith` استفاده کنید:
|
||||
```csharp
|
||||
config.NewConfig<SourceDto, ProtoResponse>()
|
||||
.MapWith(src => new ProtoResponse
|
||||
{
|
||||
Field1 = src.Field1,
|
||||
RepeatedField = { src.List?.Select(...) ?? Enumerable.Empty<...>() }
|
||||
});
|
||||
```
|
||||
|
||||
### Alias Imports برای Proto Disambiguation
|
||||
```csharp
|
||||
using BffProtos = BackOffice.BFF.ClubMembership.Protobuf.Protos.ClubMembership;
|
||||
using CmsProtos = CMSMicroservice.Protobuf.Protos.ClubMembership;
|
||||
```
|
||||
@@ -0,0 +1,310 @@
|
||||
# 📝 Changelog - ۳ دی ۱۴۰۴ (23 December 2025)
|
||||
|
||||
> **Session**: فعالسازی چتیکا، اصلاح ثبتنام شبکه، بهبود فرایند باشگاه مشتریان
|
||||
|
||||
---
|
||||
|
||||
## 🎯 خلاصه Session
|
||||
|
||||
این session شامل موارد زیر بود:
|
||||
1. اصلاح SQL Scripts برای مهاجرت باشگاه مشتریان
|
||||
2. اضافه کردن `LegPosition` در ثبتنام کاربران جدید
|
||||
3. همگامسازی `AcceptClubMembershipContractCommandHandler` با `ActivateClubMembershipCommandHandler`
|
||||
4. ایجاد `ClubFeatureType` Enum برای جایگزینی hardcoded IDs
|
||||
5. **پیادهسازی Worker چتیکا** - فعالسازی خودکار حساب هوش مصنوعی
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Bug Fixes
|
||||
|
||||
### 1. SQL Script - `IsActive` Column Missing ✅
|
||||
|
||||
**مشکل**: خطای `Invalid column name 'IsActive'` در stage database
|
||||
|
||||
**علت**: ستون `IsActive` در جدول `ClubMemberships` وجود نداشت
|
||||
|
||||
**راهحل**: اجرای migration script یا حذف ستون از INSERT
|
||||
|
||||
**فایل**: `dbbkup/MigrateUsersToClubMembership.sql`
|
||||
|
||||
---
|
||||
|
||||
### 2. SQL Script - `WeekNumber` → `WeekDefinitionId` Migration ✅
|
||||
|
||||
**مشکل**: خطای `Invalid column name 'WeekNumber'` در `WeeklyCommissionPools`
|
||||
|
||||
**علت**: ستون قبلاً به `WeekDefinitionId` تغییر نام داده شده بود
|
||||
|
||||
**راهحل**: تغییر Query برای استفاده از `WeekDefinitions` table:
|
||||
```sql
|
||||
-- قبل
|
||||
INSERT INTO WeeklyCommissionPools (WeekNumber, ...) VALUES (1, ...)
|
||||
|
||||
-- بعد
|
||||
DECLARE @CurrentWeekId BIGINT
|
||||
SELECT @CurrentWeekId = Id FROM WeekDefinitions
|
||||
WHERE StartDate <= GETDATE() AND EndDate >= GETDATE()
|
||||
|
||||
INSERT INTO WeeklyCommissionPools (WeekDefinitionId, ...) VALUES (@CurrentWeekId, ...)
|
||||
```
|
||||
|
||||
**فایل**: `dbbkup/MigrateSpecificUsersToClubMembership.sql`
|
||||
|
||||
---
|
||||
|
||||
### 3. SQL Script - `DECLARE/SET` Syntax Error ✅
|
||||
|
||||
**مشکل**: خطای syntax در `DECLARE @var = value`
|
||||
|
||||
**علت**: FreeTDS/older SQL Server syntax نیاز به جداسازی DECLARE و SET دارد
|
||||
|
||||
**راهحل**:
|
||||
```sql
|
||||
-- قبل
|
||||
DECLARE @CurrentWeekId BIGINT = (SELECT ...)
|
||||
|
||||
-- بعد
|
||||
DECLARE @CurrentWeekId BIGINT
|
||||
SET @CurrentWeekId = (SELECT ...)
|
||||
```
|
||||
|
||||
**فایل**: `dbbkup/MigrateSpecificUsersToClubMembership.sql`
|
||||
|
||||
---
|
||||
|
||||
## ✨ New Features
|
||||
|
||||
### 4. اضافه کردن `LegPosition` در ثبتنام کاربران جدید ✅
|
||||
|
||||
**مشکل**: کاربران جدید بدون `LegPosition` در درخت شبکه ثبت میشدند
|
||||
|
||||
**راهحل**: اضافه کردن منطق تعیین دست چپ/راست:
|
||||
|
||||
```csharp
|
||||
// تعیین موقعیت در دست چپ یا راست
|
||||
var existingChildren = await _context.Users
|
||||
.Where(x => x.NetworkParentId == parent.Id && !x.IsDeleted)
|
||||
.Select(x => x.LegPosition)
|
||||
.ToListAsync(cancellationToken);
|
||||
|
||||
NetworkLeg newUserLegPosition;
|
||||
if (!existingChildren.Any(x => x == NetworkLeg.Left))
|
||||
newUserLegPosition = NetworkLeg.Left;
|
||||
else if (!existingChildren.Any(x => x == NetworkLeg.Right))
|
||||
newUserLegPosition = NetworkLeg.Right;
|
||||
else
|
||||
return Error("Parent already has both legs filled");
|
||||
|
||||
user = new User { ..., LegPosition = newUserLegPosition };
|
||||
```
|
||||
|
||||
**فایل**: `CMS/src/CMSMicroservice.Application/OtpTokenCQ/Commands/VerifyOtpToken/VerifyOtpTokenCommandHandler.cs`
|
||||
|
||||
---
|
||||
|
||||
### 5. همگامسازی `AcceptClubMembershipContractCommandHandler` ✅
|
||||
|
||||
**مشکل**: منطق فعالسازی باشگاه در `AcceptClubMembershipContractCommandHandler` ناقص بود
|
||||
|
||||
**راهحل**: کپی کامل منطق از `ActivateClubMembershipCommandHandler`:
|
||||
|
||||
**اضافات**:
|
||||
- خواندن `GiftValue` و `ActivationFee` از Configuration
|
||||
- ثبت `ClubMembershipHistory`
|
||||
- ثبت در `WeeklyCommissionPool`
|
||||
- اختصاص `UserClubFeatures` (همه 4 فیچر)
|
||||
|
||||
```csharp
|
||||
// 6. ثبت تاریخچه
|
||||
var history = new ClubMembershipHistory
|
||||
{
|
||||
ClubMembershipId = membership.Id,
|
||||
ActionType = ClubMembershipActionType.Activated,
|
||||
PerformedBy = _currentUserService.UserId ?? membership.UserId,
|
||||
...
|
||||
};
|
||||
|
||||
// 7. ثبت در استخر کمیسیون هفتگی
|
||||
var currentWeek = _weekRepository.GetCurrentWeek();
|
||||
var pool = new WeeklyCommissionPool { ... };
|
||||
|
||||
// 8. اختصاص فیچرهای باشگاه
|
||||
var featureIds = ClubFeatureTypeExtensions.GetAllFeatureIds();
|
||||
foreach (var featureId in featureIds) { ... }
|
||||
```
|
||||
|
||||
**فایل**: `CMS/src/CMSMicroservice.Application/ClubMembershipCQ/Commands/AcceptClubMembershipContract/AcceptClubMembershipContractCommandHandler.cs`
|
||||
|
||||
---
|
||||
|
||||
### 6. ایجاد `ClubFeatureType` Enum ✅
|
||||
|
||||
**مشکل**: استفاده از آرایه hardcoded `new long[] { 1, 2, 3, 4 }` در کد
|
||||
|
||||
**راهحل**: ایجاد Enum با Extension Method:
|
||||
|
||||
```csharp
|
||||
public enum ClubFeatureType
|
||||
{
|
||||
Chatika = 1, // چتیکا - دستیار هوش مصنوعی
|
||||
Bime = 2, // بیمه - خدمات بیمهای
|
||||
Trip = 3, // تریپ - خدمات سفر و گردشگری
|
||||
Learn = 4 // لرن - آموزش و یادگیری
|
||||
}
|
||||
|
||||
public static class ClubFeatureTypeExtensions
|
||||
{
|
||||
public static long[] GetAllFeatureIds() =>
|
||||
Enum.GetValues<ClubFeatureType>().Select(f => (long)f).ToArray();
|
||||
|
||||
public static string GetPersianTitle(this ClubFeatureType featureType) => featureType switch
|
||||
{
|
||||
ClubFeatureType.Chatika => "چتیکا",
|
||||
ClubFeatureType.Bime => "بیمه",
|
||||
ClubFeatureType.Trip => "تور و سفر",
|
||||
ClubFeatureType.Learn => "آموزش",
|
||||
_ => featureType.ToString()
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
**فایل جدید**: `CMS/src/CMSMicroservice.Domain/Enums/ClubFeatureType.cs`
|
||||
|
||||
**فایلهای آپدیت شده**:
|
||||
- `ActivateClubMembershipCommandHandler.cs`
|
||||
- `AcceptClubMembershipContractCommandHandler.cs`
|
||||
|
||||
---
|
||||
|
||||
### 7. 🤖 پیادهسازی Worker چتیکا (Chatika Account Activation) ✅
|
||||
|
||||
**نیاز**: فعالسازی خودکار حساب چتیکا برای اعضای جدید باشگاه
|
||||
|
||||
**معماری**:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Hangfire Scheduler │
|
||||
│ (Every 5 minutes) │
|
||||
└─────────────────────┬───────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ChatikaAccountActivationJob │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 1. Find users with: │ │
|
||||
│ │ - ClubMembership.IsActive = true │ │
|
||||
│ │ - ClubFeatureId = 1 (Chatika) │ │
|
||||
│ │ - Notes IS NULL (not processed yet) │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 2. For each user: │ │
|
||||
│ │ - Call Chatika API │ │
|
||||
│ │ - Update Notes with description │ │
|
||||
│ │ - Set IsActive = true │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Chatika External API │
|
||||
│ POST /api/v1/organizations/register-user │
|
||||
│ Header: X-API-Key │
|
||||
│ Body: { "mobile_number": "09..." } │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**فایلهای جدید**:
|
||||
|
||||
| فایل | توضیح |
|
||||
|------|-------|
|
||||
| `IChatikaApiService.cs` | Interface سرویس چتیکا |
|
||||
| `ChatikaApiService.cs` | پیادهسازی با HttpClient |
|
||||
| `ChatikaAccountActivationJob.cs` | Hangfire Background Job |
|
||||
|
||||
**تنظیمات** (`appsettings.json`):
|
||||
```json
|
||||
"Chatika": {
|
||||
"BaseUrl": "https://api.chatika.ir",
|
||||
"ApiKey": "tIukvL8dnV4cB3yVWcCD9Xyfbj8rBxm5wPt2mLyJCgTsBBoMTWjt6mFEqQwpw-er"
|
||||
}
|
||||
```
|
||||
|
||||
**توضیحات فیچر چتیکا** (در `Notes` ذخیره میشود):
|
||||
```
|
||||
🎉 تبریک! حساب هوش مصنوعی چتیکا شما فعال شد.
|
||||
|
||||
برای استفاده از امکانات رایگان چتیکا:
|
||||
1️⃣ به وبسایت chatika.ir مراجعه کنید
|
||||
2️⃣ شماره موبایل خود را وارد کنید
|
||||
3️⃣ از دستیار هوشمند چتیکا لذت ببرید!
|
||||
|
||||
🔗 لینک ورود: https://chatika.ir
|
||||
```
|
||||
|
||||
**جلوگیری از تکرار**: با چک کردن `Notes != null` از کال مجدد API جلوگیری میشود
|
||||
|
||||
---
|
||||
|
||||
## 📁 فایلهای تغییر یافته
|
||||
|
||||
### CMS Microservice
|
||||
|
||||
| فایل | نوع تغییر | توضیح |
|
||||
|------|----------|-------|
|
||||
| `Domain/Enums/ClubFeatureType.cs` | **NEW** | Enum برای فیچرهای باشگاه |
|
||||
| `Application/Common/Interfaces/IChatikaApiService.cs` | **NEW** | Interface سرویس چتیکا |
|
||||
| `Infrastructure/Services/ChatikaApiService.cs` | **NEW** | پیادهسازی API چتیکا |
|
||||
| `Infrastructure/BackgroundJobs/ChatikaAccountActivationJob.cs` | **NEW** | Hangfire Job |
|
||||
| `Infrastructure/ConfigureServices.cs` | Modified | رجیستر سرویسها |
|
||||
| `WebApi/Program.cs` | Modified | ثبت Recurring Job |
|
||||
| `WebApi/appsettings.json` | Modified | تنظیمات چتیکا |
|
||||
| `OtpTokenCQ/.../VerifyOtpTokenCommandHandler.cs` | Modified | اضافه شدن LegPosition |
|
||||
| `ClubMembershipCQ/.../AcceptClubMembershipContractCommandHandler.cs` | **REWRITTEN** | منطق کامل فعالسازی |
|
||||
| `ClubMembershipCQ/.../ActivateClubMembershipCommandHandler.cs` | Modified | استفاده از Enum |
|
||||
|
||||
### SQL Scripts
|
||||
|
||||
| فایل | نوع تغییر | توضیح |
|
||||
|------|----------|-------|
|
||||
| `dbbkup/MigrateUsersToClubMembership.sql` | Modified | اضافه شدن PerformedBy, GiftValue |
|
||||
| `dbbkup/MigrateSpecificUsersToClubMembership.sql` | Modified | تغییر WeekNumber به WeekDefinitionId |
|
||||
|
||||
---
|
||||
|
||||
## 🔧 تنظیمات جدید
|
||||
|
||||
### appsettings.json
|
||||
```json
|
||||
{
|
||||
"Chatika": {
|
||||
"BaseUrl": "https://api.chatika.ir",
|
||||
"ApiKey": "YOUR_API_KEY_HERE"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Build Status
|
||||
|
||||
```bash
|
||||
cd /home/masoud/Apps/project/FourSat/CMS/src
|
||||
dotnet build CMSMicroservice.WebApi/CMSMicroservice.WebApi.csproj --no-restore
|
||||
|
||||
# Result: Build succeeded. 0 Error(s)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 آمار Session
|
||||
|
||||
| متریک | مقدار |
|
||||
|-------|-------|
|
||||
| فایلهای جدید | 4 |
|
||||
| فایلهای تغییر یافته | 8 |
|
||||
| خطاهای رفع شده | 3 |
|
||||
| قابلیتهای جدید | 4 |
|
||||
| خطوط کد اضافه شده | ~400 |
|
||||
+20
-3
@@ -1,14 +1,31 @@
|
||||
# 🎉 وضعیت نهایی پروژه - FourSat
|
||||
|
||||
**تاریخ تکمیل**: ۱۷ آذر ۱۴۰۴ (December 8, 2025)
|
||||
**نسخه**: 3.1 - PRODUCTION READY ✅
|
||||
**آخرین بروزرسانی**: ۳۰ آذر ۱۴۰۴ (December 20, 2025)
|
||||
**نسخه**: 3.2 - PRODUCTION READY ✅
|
||||
**وضعیت**: 100% COMPLETE - ALL SYSTEMS OPERATIONAL 🚀
|
||||
|
||||
---
|
||||
|
||||
## 🏆 پروژه 100% تکمیل شد!
|
||||
|
||||
### آخرین دستاوردها (December 8, 2025):
|
||||
### آخرین دستاوردها (۳۰ آذر - December 20, 2025):
|
||||
- ✅ **BackOffice UI**: 100% Complete - همه صفحات کاملاً عملیاتی
|
||||
- ✅ **رفع باگ صفحات**:
|
||||
- `/network/balances`: ValidationException fix (Mapster mapping)
|
||||
- `/club/members`: Data loading fix (ClubMembershipProfile)
|
||||
- `/club/statistics`: Unimplemented fix (GetClubStatistics override)
|
||||
- ✅ **Products Module**: کاملاً فعال شد
|
||||
- CreateNew, Update, Gallery, Tags dialogs فعال
|
||||
- فیلد "تعداد موجودی" (RemainingCount) اضافه شد
|
||||
- نمایش رنگی موجودی: 🔴 ناموجود، 🟡 کم موجود، 🟢 موجود
|
||||
- ✅ **CMS**: اضافه شدن ClubMembershipProfile.cs
|
||||
- ✅ **BackOffice.BFF**:
|
||||
- اصلاح CommissionProfile (GetUserWeeklyBalances mapping)
|
||||
- بازنویسی ClubMembershipProfile (mappings کامل)
|
||||
- اضافه شدن GetClubStatistics override
|
||||
- اضافه شدن RemainingCount به Commands
|
||||
|
||||
### دستاوردهای قبلی (December 8-19, 2025):
|
||||
- ✅ **BackOffice UI**: 97% Complete (65+ pages) - Advanced features added
|
||||
- ✅ **BackOffice.BFF**: 100% Complete - Architecture refactored
|
||||
- ✅ **Daya Loan Integration**: 100% Complete - Real API Fully Implemented
|
||||
|
||||
+18
-19
@@ -1,28 +1,28 @@
|
||||
# 🎯 FourSat - مرجع سریع (Quick Reference)
|
||||
|
||||
> **برای دسترسی فوری به مستندات مهم**
|
||||
> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴
|
||||
> **آخرین بروزرسانی**: ۳۰ آذر ۱۴۰۴
|
||||
|
||||
---
|
||||
|
||||
## 🆕 آخرین تغییرات
|
||||
|
||||
### ۲۹ آذر - مایگریشن WeekNumber به WeekDefinitionId ✨
|
||||
### ۳۰ آذر - رفع باگهای BackOffice و فعالسازی Products ✨
|
||||
- **3 باگ رفع شدند**: /network/balances, /club/members, /club/statistics
|
||||
- **Products فعال شد**: CreateNew, Update, Gallery, Tags dialogs
|
||||
- **فیلد موجودی اضافه شد**: RemainingCount با نمایش رنگی
|
||||
- **Mapster Profiles**: اصلاح CommissionProfile، بازنویسی ClubMembershipProfile
|
||||
- **CMS**: ایجاد ClubMembershipProfile.cs جدید
|
||||
|
||||
**📄 جزئیات**: [CHANGELOG-2025-12-20.md](CHANGELOG-2025-12-20.md)
|
||||
|
||||
### ۲۹ آذر - مایگریشن WeekNumber به WeekDefinitionId
|
||||
- **5 Entity** در CMS آپدیت شدند
|
||||
- **Proto Files** در CMS و BFF آپدیت شدند
|
||||
- **Blazor Components** در FrontOffice آپدیت شدند
|
||||
- **فیلدهای جدید**: `WeekDefinitionId` (long), `WeekDisplayName` (string)
|
||||
- **فیلدهای حذف شده**: `WeekNumber`, `WeekLabel`, `GregorianWeekNumber`, `PersianWeekNumber`
|
||||
|
||||
**📄 جزئیات**: [CHANGELOG-2025-12-19.md](CHANGELOG-2025-12-19.md)
|
||||
|
||||
### ۲۸ آذر - بهبودات FrontOffice
|
||||
- سیستم مدیریت موجودی محصولات
|
||||
- ویژگیهای باشگاه مشتریان
|
||||
- رفع باگ آدرسها
|
||||
|
||||
**📄 جزئیات**: [CHANGELOG-2025-12-18.md](CHANGELOG-2025-12-18.md)
|
||||
|
||||
---
|
||||
|
||||
## 📚 لینکهای کلیدی
|
||||
@@ -77,17 +77,16 @@
|
||||
|-----------|----------|--------|
|
||||
| CMS | 96% ✅ | +1% (Network Info) |
|
||||
| BackOffice.BFF | 100% ✅ | Updated (DTO) |
|
||||
| BackOffice UI | 98% ✅ | +1% (Persian Date) |
|
||||
| BackOffice UI | 100% ✅ | Products Complete |
|
||||
| FrontOffice.BFF | 60% 🚧 | - |
|
||||
| FrontOffice UI | 75% 🚧 | - |
|
||||
|
||||
### تغییرات اخیر:
|
||||
- ✅ **امروز (22 آذر)**: تاریخ شمسی + اطلاعات کامل شبکه + رفع Bug هفته
|
||||
- ✅ BackOffice.BFF: رفع Anti-Pattern معماری (Protobuf اختصاصی)
|
||||
- ✅ HTTP Annotations: 33 endpoint برای Swagger
|
||||
- ✅ Network Tree: نمایش درختی D3.js با zoom/pan
|
||||
- ✅ User AutoComplete: جستجوی چند فیلدی
|
||||
- ✅ Multi-Role Authorization: پشتیبانی از JWT آرایهای
|
||||
- ✅ **امروز (۳۰ آذر)**: رفع باگهای BackOffice + فعالسازی Products + فیلد موجودی
|
||||
- ✅ BackOffice.BFF: اصلاح Mappings و GetClubStatistics
|
||||
- ✅ CMS: اضافه شدن ClubMembershipProfile
|
||||
- ✅ Products: CreateNew, Update, Gallery, Tags فعال شدند
|
||||
- ✅ RemainingCount: نمایش رنگی موجودی در لیست محصولات
|
||||
|
||||
---
|
||||
|
||||
@@ -117,4 +116,4 @@ grep -r "Wallet" 01-BUSINESS/ 04-FRONTEND/
|
||||
|
||||
---
|
||||
|
||||
**تاریخ بروزرسانی**: ۲۲ آذر ۱۴۰۴ (12 دسامبر 2025)
|
||||
**تاریخ بروزرسانی**: ۳۰ آذر ۱۴۰۴ (20 دسامبر 2025)
|
||||
|
||||
Reference in New Issue
Block a user