نسخه ۱.۰.۰

معماری فنی موتور تیغ

موتور مستقل، فوق‌سریع و بدون وابستگی خارجی برای پردازش و بازیابی داده‌های ادبیات فارسی با ساختار داده Radix Tree، حافظه پنهان پیش‌ساخته، محدودکننده نرخ GCRA و استانداردهای نوین وب.

ساختار موتور

نمودار کامل معماری و جریان داده

ساختار موتور تیغ
۸ پکیج
پکیج‌های مونورپو
۴ محیط
اداپتورها
۲۱۶+
تست‌های گذرانده
۰
وابستگی هسته

ماژول‌ها

هر ماژول مستقل و قابل توسعه

RadixRouter
مسیریاب Radix

مسیریاب Radix Tree کامپایل‌شده برای نگاشت دقیق با استخراج پارامتر پویا بدون تخصیص حافظه و پشتیبانی کامل از کاراکترهای فارسی با استاندارد NFC.

Radix TreeO(1) StaticZero-alloc Params
PrebuiltCache
حافظه پنهان پیش‌ساخته

کش پیشرفته مبتنی بر S3-FIFO و W-TinyLFU با ذخیره بافر بایت‌های پاسخ. بدون نیاز به تبدیل مکرر JSON در مسیرهای پرترافیک و همراه با ادغام همزمان درخواست‌ها.

S3-FIFOW-TinyLFUSingle-FlightStale-While-Revalidate
GcraLimiter
محدودساز نرخ GCRA

پیاده‌سازی الگوریتم سلول عمومی (GCRA) بر اساس پنجره پیوسته با سربار ثابت و پشتیبانی از هدرهای استاندارد IETF RateLimit و سازگاری با کلاینت‌های پیشین.

GCRAIETF RateLimitPer-Client Bounded
CircuitBreaker
مدار شکن خودترمیم

ماشین حالت سه‌گانه برای وابستگی‌های خارجی با ردیابی نرخ خطا در پنجره لغزان و بازگشت خودکار به محتوای پایدار کش هنگام قطعی سرویس‌های خارجی.

Closed/Open/HalfStale FallbackError-rate Trip
DDSketchMetrics
متریک DDSketch

موتور تله‌متری با ساختار DDSketch با مصرف حافظه محدود و قابلیت ترکیب، برای محاسبه دقیق صدک‌های P50 تا P99 بدون رشد نامحدود حافظه.

DDSketchP50-P99Bounded Memory
HttpPipeline
پایپلاین پردازش HTTP

زنجیره پردازش سبک با شناسه درخواست یکتا، ردیابی استاندارد، تنظیم خودکار CORS، هدر Server-Timing، و مدیریت خطای استاندارد RFC 9457.

RFC 9457Server-TimingCORS

چرخه درخواست

مسیر یک درخواست از ورود تا پاسخ

۱
درخواست ورودی
کلاینت درخواست HTTP استاندارد ارسال می‌کند
۲
بررسی هویت و محدودسازی نرخ
بررسی نرخ با الگوریتم GCRA و تزریق هدرهای استاندارد RateLimit
۳
پایپلاین و ردیابی
تولید شناسه درخواست، بررسی CORS و ثبت Server-Timing
۴
جستجوی حافظه پنهان
بررسی بافر پیش‌ساخته پاسخ و ادغام درخواست‌های همزمان (Single-flight)
۵
مسیریاب Radix
شناسایی مسیر و استخراج پارامترهای پویا با نرمال‌سازی NFC
۶
مدار شکن
پایش وضعیت سلامت سرویس‌های جانبی و فعال‌سازی بازگشت به کش پایدار در صورت بروز خطا
۷
اجرا و بازیابی
اجرای هندلر و بازیابی داده‌های ساختاریافته ادبیات فارسی
۸
ذخیره در کش و ارسال
ذخیره پاسخ در حافظه پنهان و ارسال پاسخ بهینه همراه با هدر ETag
چرخه حیات درخواست

متریک زنده

داده لحظه‌ای از موتور — بروزرسانی خودکار

در حال بارگذاری...

بنچمارک

اندازه‌گیری واقعی عملکرد ماژول‌ها

در حال اجرای بنچمارک...

ساختار فایل‌ها

ماژول‌های TypeScript · بدون وابستگی خارجی در موتور · مجوز MIT

فایل‌ها
packages/core/src/
router/radix-router.tsمسیریاب Radix Tree
cache/prebuilt-cache.tsکش S3-FIFO و W-TinyLFU
rate-limiter/gcra.tsمحدودساز نرخ GCRA
circuit-breaker/circuit-breaker.tsمدار شکن خودترمیم
telemetry/ddsketch.tsمحاسبه صدک با DDSketch
server.tsهسته سرور HTTP استاندارد
routes.tsتعریف مسیرهای REST v1 و سازگاری
packages/schema/src/
models/poem.tsطرح داده ساختاریافته شعر
generators/openapi.tsسازنده خودکار OpenAPI 3.1
packages/persian/src/
normalizer.tsنرمال‌سازی نمایش و جستجو
calendar.tsتبدیل تقویم جلالی و میلادی
packages/poem/src/
colophon.tsاستخراج شناسنامه و ترقیمه شعر
excerpt.tsانتخاب هوشمند برش‌های شعر
packages/search/src/
search/search-engine.tsموتور جستجوی هیبریدی BM25F
packages/widget/src/
index.tsکامپوننت وب persian-quote
ساختار پکیج
نحوه استفاده
import { createTighApp } from "@persian-quote/core"

const app = createTighApp({
  enableCache: true,
  enableRateLimit: true,
  rateLimit: { requestsPerMinute: 120 },
})

export const GET = (req: Request) => app.fetch(req)
اطلاعات پروژه
پکیج‌های مونورپو۸ پکیج
انواع داده Zod۳۰+
وابستگی هسته۰
LicenseMIT
اداپتورهاNext.js, Bun, Node, Workers
نسخه موتور۱.۰.۰

نقشه راه

مسیر توسعه موتور تیغ

v۰.۰.۱-beta
انجام شد
مسیریاب Trie پایهکش LRU اولیهمحدودساز نرخ اولیهمدار شکن
v۱.۰.۰
نسخه پایدار جاری
مسیریاب Radixکش پیش‌ساخته S3-FIFOمحدودساز GCRAموتور جستجوی BM25Fکامپوننت وبسرور MCPطرح داده ساختاریافته
v۱.۱.۰
برنامه آتی
پوشش بیشتر قالب‌های سنتیبهینه‌سازی نمایه برداری بر خط

تیغ

موتور API متن‌باز فارسی. طراحی و پیاده‌سازی توسط آرسام آدینه. مجوز MIT.