Fusionنمای کلی معماری
ساختار Fusion Framework — هسته Rust، باندینگ‌های زبانی و FMA
Fusion چیست؟
Fusion Framework یک فریم‌ورک HTTP کلاس‌محور است. ماژول‌های API را به‌صورت کلاس (FusionBaseApi) تعریف می‌کنید، با decorator یا attribute مسیر ثبت می‌کنید، و FusionApp را اجرا می‌کنید. هستهٔ مشترک Rust (fusion-core) مسئول سرو کردن HTTP، مسیریابی، تنظیمات، کمک‌کننده‌های header و سریالایز پاسخ است. باندینگ‌های زبانی (Python، TypeScript/Node.js، C#) نازک می‌مانند و روی تجربهٔ توسعه‌دهنده تمرکز دارند.
نسخهٔ فعلی پکیج‌های فریم‌ورک در مخزن متن‌باز: 1.2.6 (ریپوی fusion-framework).
فلسفهٔ طراحی
| اصل | معنا در عمل |
|---|---|
| هستهٔ مشترک | توکن‌های مسیر، تنظیمات، کدهای وضعیت و کمک‌کننده‌های header یک‌بار در Rust پیاده می‌شوند |
| API کلاس‌محور | Handlerها روی کلاس‌ها هستند، نه توابع آزاد — هر ماژول سطح یک resource را مالک است |
| باندینگ نازک | Python / Node / C# همان معنای HTTP را با syntax بومی خود نشان می‌دهند |
| ثبت صریح | Import کردن ماژول route (یا Route.Register) آن را ثبت می‌کند؛ اسکن جادویی فایل‌سیستم وجود ندارد |
| پکیج‌های قابل ترکیب | کتابخانه‌های قابل استفادهٔ مجدد پکیج‌های عادی‌اند که با Fusion Tool نصب می‌شوند (fusion add) |
معماری سطح بالا
flowchart TB
subgraph app [اپلیکیشن شما]
Main[main / نقطهٔ ورود Program]
RouteMods[ماژول‌های route — FusionBaseApi]
Libs[پکیج‌های کتابخانه‌ای نصب‌شده]
end
subgraph binding [باندینگ زبانی]
Decorators[route / http_* / attributes]
MW[زنجیرهٔ middleware]
App[FusionApp]
end
subgraph core [fusion-core — Rust]
Settings[Settings]
Router[Router]
Hyper[سرور Hyper]
Headers[کمک‌کننده‌های Header]
OpenAPI[دادهٔ OpenAPI]
end
Main --> RouteMods
Main --> App
Libs --> RouteMods
RouteMods --> Decorators
Decorators --> Router
App --> MW
MW --> Router
App --> Settings
App --> Hyper
Router --> Hyper
Headers --> binding
OpenAPI --> Appلایه‌هایی که با آن‌ها کار می‌کنید
| لایه | مسئولیت |
|---|---|
| Application | main.py / فایل ورود، JSON محیط، لیست middleware، import ماژول‌ها |
| Route module | کلاس FusionBaseApi با @route / route() / [Route] — مالک handlerهای HTTP یک resource |
| Library package | پکیج قابل انتشار با fusion module init و نصب با fusion add — کد قابل import عادی، نه پلاگین خاص runtime |
| Binding | API مخصوص زبان روی هستهٔ Rust |
| fusion-core | سرور HTTP، router، settings، توکن‌های نام‌گذاری، fingerprint، سریالایز |
FMA (Fusion Module Architecture)
FMA مدل ماژولاریتی Fusion است: اپلیکیشن از ماژول‌های route و اختیاری پکیج‌های قابل استفادهٔ مجدد تشکیل می‌شود، با مرز واضح بین سطح HTTP و کتابخانه‌های مشترک.
→ جزئیات: معماری ماژول Fusion (FMA)
مسیر یادگیری
- Fusion چیست و چه نیست — مرز دامنه (بدون ORM، بدون DI container، …)
- Workspace و crateها — جای هسته در برابر باندینگ‌ها
- ساختار پروژه — آنچه
fusion initمی‌سازد - Fusion Tool — scaffold اپ و محیط‌ها
- شروع زبان: Python · TypeScript · C#
- ماژول‌های route اپلیکیشن
- پکیج‌های قابل استفادهٔ مجدد · ماژول‌های CLI
- چرخهٔ عمر اپلیکیشن · تنظیمات و پیکربندی · چرخهٔ عمر درخواست
- بهترین شیوه‌ها · ضدالگوها
ابزارهای مرتبط
- Fusion Tool — scaffold اپ، محیط‌ها، دستورات، پکیج‌ها
- Fusion Desktop — GUI برای مدیریت بک‌اندهای Fusion