إطار العمل

إطار TypeScript محكوم على واصفات JSON


إطار عمل DEX ليس صندوقاً أسوداً. إنه طبقة TypeScript قياسية مفتوحة ومقروءة، مصممة ليفهمها ويوسّعها أي مطور TypeScript. تحت الغطاء، تعمل واصفات JSON كمصدر الحقيقة لكل شاشة وسير عمل.

البنية

طبقات واضحة، مسؤوليات محددة

01

طبقة الواصفات

ملفات JSON تحدد الشاشات والحقول والقواعد وسير العمل. قابلة للمراجعة، وقابلة للإصدار، وقابلة للتعديل دون لمس كود TypeScript.

02

طبقة المعالجات

كود TypeScript منمّط ينفذ المنطق الذي تشير إليه الواصفات. معالجات التحقق والأحداث والحفظ، كلها مكتوبة بوضوح.

03

طبقة البنية التحتية

Node.js و REST API، والتحقق من الوصول، والتدقيق، والتسجيل. تعمل على أي بيئة تدعم Node.js.

مثال

شاشة كاملة، في 20 سطراً من JSON

customers.desc.json
{
  "type": "form",
  "entity": "customers",
  "layout": "two-column",
  "fields": [
    { "id": "custId", "label": "رقم العميل", "readonly": true },
    { "id": "name", "label": "الاسم", "required": true },
    { "id": "taxId", "label": "الرقم الضريبي", "onValidate": "validateTaxId" },
    { "id": "country", "label": "الدولة", "lov": "countries" }
  ],
  "actions": ["save", "cancel", "delete"],
  "access": {
    "read": ["sales", "admin"],
    "write": ["admin"]
  },
  "audit": true
}
لماذا الواصفات

مصدر حقيقة واحد للواجهة والمنطق والتكاملات

  • الواصفات قابلة للمراجعة من قبل المحللين والمدققين، لا المطورين وحدهم.
  • الذكاء الاصطناعي يولّد JSON، لا كود مجاني — أسرع في المراجعة، أعلى في الجودة.
  • ضوابط RBAC والتدقيق إقرارية داخل الواصف، لا مبعثرة عبر الكود.
  • التغييرات عبر ملفات JSON قابلة للتتبع في Git مع سجل واضح للمراجعات.

إطار عمل مفتوح، كود مملوك

TypeScript قياسي، في مستودع Git تملكونه بالكامل.