Mizekar.Common 1.0.1

Mizekar.Common

کتابخانه مشترک برای تمام پروژه‌های بک‌اند Mizekar که شامل قابلیت‌های مشترک مانند Logging، Swagger، Middleware، Exception Handling، Authentication، Permissions، Features و Helper classes می‌باشد.

ساختار پروژه

Mizekar.Common/
├── Authentication/          # Authentication services (ICurrentUser, ICurrentWorkSpace, RequireAdminAttribute)
├── Exceptions/             # Exception classes و Global Exception Handler
├── Extensions/             # Extension methods (DateTime, IQueryable, Strings, ServiceCollection)
├── Features/               # Feature management (IFeatureService, RequireFeatureAttribute)
├── Helpers/                # Helper classes (FinancialNumberToWords, FormulaEval, ExportFiles)
├── Logging/                # Logging configuration و Middleware
├── Middleware/             # Custom middleware (Culture, ModelValidation, UserAndWorkSpaceHeader)
├── Permissions/            # Permission management (IPermissionService, RequirePermissionAttribute)
├── Security/               # Security services (ISecurityService)
└── Swagger/                # Swagger configuration extensions

نحوه استفاده

1. اضافه کردن Reference

در فایل .csproj پروژه خود:

<ItemGroup>
    <ProjectReference Include="..\..\mizekar-common\Mizekar.Common\Mizekar.Common.csproj" />
</ItemGroup>

2. استفاده در Program.cs

using Mizekar.Common.Logging;
using Mizekar.Common.Extensions;
using Mizekar.Common.Swagger;

var builder = WebApplication.CreateBuilder(args);

// Configure centralized logging
builder.Host.UseMizekarLogging("ServiceName");

// Add common services
builder.Services.AddMizekarCommonServices();

// Add Swagger
builder.Services.AddMizekarSwagger(
    title: "API Title",
    description: "API Description"
);

var app = builder.Build();

// Use Swagger
app.UseMizekarSwagger(routePrefix: "swagger");

// Use middleware
app.UseRequestHeaderLogging();
app.UseMiddleware<Mizekar.Common.Logging.RequestLoggingMiddleware>();
app.UseMiddleware<Mizekar.Common.Middleware.UserAndWorkSpaceHeaderMiddleware>();
app.UseCultureMiddleware();
app.UseExceptionHandler();

قابلیت‌ها

Authentication

• ICurrentUser و CurrentUser: مدیریت اطلاعات کاربر فعلی
• ICurrentWorkSpace و CurrentWorkSpace: مدیریت workspace فعلی
• RequireAdminAttribute: Attribute برای محدود کردن دسترسی به admin

Permissions

• IPermissionService: سرویس برای بررسی permissions از header X-Permissions
• RequirePermissionAttribute: Attribute برای اعمال permission check

Features

• IFeatureService: سرویس برای بررسی features و limits از header X-Features
• RequireFeatureAttribute: Attribute برای اعمال feature check

Security

• ISecurityService: سرویس برای hash و GUID generation

Helpers

• FinancialNumberToWords: تبدیل عدد به کلمات فارسی
• FormulaEval: ارزیابی فرمول‌های ریاضی به صورت امن
• ExportFiles: Export به Excel و PDF

Extensions

• DateTimeExtensions: Parse تاریخ شمسی/میلادی
• DateTimeOffsetExtensions: تبدیل به زمان ایران
• IQueryableExtensions: WhereIf و OrderBy2
• StringsExtensions: تبدیل اعداد فارسی/انگلیسی، GenerateCode، GenerateSlug

Dependencies

• Microsoft.AspNetCore.App
• Serilog.AspNetCore (8.0.1)
• Swashbuckle.AspNetCore (7.3.1)
• MiniExcelLibs (1.38.0)
• DynamicExpresso.Core (2.19.2)

License

Proprietary - Mizekar