maghzaccount-pro v0.25.6：面向阿拉伯语市场的 ERP 会计系统
AhmedAlmaghz/MaghzAccountFlash4
maghzaccount-pro v0.25.6 发布，这是一套面向阿拉伯语中小企业的 ERP 会计系统，采用私有许可，默认阿拉伯语 RTL 界面，支持阿拉伯语与英语。
maghzaccount-pro — نظام ERP محاسبي متكامل
نظام ERP احترافي للمنشآت الصغيرة والمتوسطة في العالم العربي — محاسبة مزدوجة، مخازن، مبيعات، مشتريات، تصنيع، موارد بشرية، CRM، نقاط بيع، ووكيل ذكي — بالعربية والإنجليزية، على سطح المكتب (Electron) والمتصفح.
الإصدار: v0.25.6 · الترخيص: خاص (Private) · اللغة الافتراضية: العربية (RTL)
لماذا maghzaccount-pro؟
| المبدأ | التطبيق |
|---|---|
| الدفتر مصدر الحقيقة | كل رصيد يُشتق من القيود (SUM(journal_entries)) — لا أرصدة متراكمة تنحرف |
| القيد المزدوج دائماً | كل عملية (فاتورة، سند، راتب، إنتاج) تولّد قيداً متوازناً ذرياً |
| تعدد المستأجرين | عزل كامل بـ company_id + فحوصات دفاعية في كل استعلام |
| يعمل بلا خادم | PGlite (PostgreSQL حقيقي بتقنية WASM) في المتصفح، وPostgreSQL عبر Electron لسطح المكتب |
| الوكيل لا يخترع | كل كتابة بموافقة بشرية، وحارس deterministic يمنع ادعاءات النجاح الكاذبة |
الوحدات (14)
| الوحدة | أبرز القدرات |
|---|---|
| الحسابات | شجرة IFRS، قيود يومية (مسودة/مرحّل/معكوس)، سندات قبض/صرف، أصول ثابتة، إقفال سنوي، فترات محاسبية |
| المبيعات | فواتير نقدية/آجلة، عروض أسعار، مردودات، COGS دائم، عملات متعددة |
| المشتريات | فواتير، أوامر شراء، مردودات، كشف موردين، أعمار ذمم |
| المخازن | باركود، وحدات متعددة لكل صنف، جرد، تحويلات، تسويات، 3 طرق تقييم (متوسط/FIFO/معياري) |
| التصنيع | BOM، أوامر تشغيل (مخطط ← تنفيذ ← إكمال)، صرف خامات فعلي، فروق استهلاك |
| نقاط البيع (POS) | شاشة كاشير، ورديات، دفع مختلط، إيصال 80mm |
| الموارد البشرية | حضور، مسيرات رواتب بقيد Gross-up، إجازات بأرصدة صارمة، نهاية خدمة |
| CRM | عملاء محتملون، فرص Kanban بآلة حالات، مهام، متابعات تلقائية |
| الضرائب | محرك متعدد الدول (SA/AE/EG/YE)، فترات ضريبية، إقرار VAT من القيود |
| التقارير | Dashboard، تحليلات مبيعات/مخزون/ربحية، Report Builder |
| الوكيل الذكي «مغزى» | ~250 أداة، دفعات بموافقة واحدة، مرفقات، دعم اللهجات والتواريخ الهجرية |
| الإعدادات | شركات، فروع، عملات، مستخدمون وأدوار (RBAC)، ثيمات، نسخ احتياطي |
البنية التقنية
- الواجهة: React + TypeScript + Tailwind (وضع داكن/فاتح، RTL، خط Cairo)
- قاعدة البيانات: طبقة واحدة — PostgreSQL + Drizzle ORM
- سطح المكتب: PostgreSQL عبر Electron IPC
- المتصفح: PGlite محلي (IndexedDB)، مع خيار عامل خلفية (Worker) من الإعدادات يمنع تجميد الواجهة أثناء الاستعلامات الثقيلة
- الحالة: Zustand · الترجمة: عربي/إنجليزي بمفاتيح متوازنة · الأيقونات: Lucide
التشغيل السريع
# التبعيات npm install # قاعدة التطوير (PostgreSQL محلي) npm run db:reset:force # الويب npm run dev # سطح المكتب npm run electron:dev
| الأمر | الوظيفة |
|---|---|
npm run dev / npm run build |
تطوير / بناء الويب |
npm run electron:dev / npm run electron:build |
تطوير / بناء سطح المكتب |
npm run preflight |
الفحص الكامل: lint + tsc + tests |
npm test / npm run test:e2e |
اختبارات الوحدات / اختبارات المتصفح |
npm run db:reset:force |
إعادة بناء القاعدة من الصفر + بيانات تجريبية |
npm run db:check |
كشف الانحراف بين Drizzle schema وSQL |
خطوتان تشغيليتان من أجل قاعدة البيانات 0.26.14
Vercel: أضف متغير MAGHZ_RELAY_SECRET (32+ حرفاً عشوائياً) — بدونه الدخول مرفوض صراحة (fail-closed) الإنتاج: الخاص (localhost/شبكات داخلية) مرفوض افتراضياً — للسماح محلياً فقط: ALLOW_PRIVATE_DB=1
بوابات الجودة (إلزامية قبل أي دمج)
tsc -b— صفر أخطاءeslint --max-warnings=0— صفر أخطاء وتحذيراتvitest run— المجموعة الكاملة خضراءplaywright test— مسارات e2e الحرجة (مبيعات، مدفوعات، إعدادات، الوكيل)vite build— يبني بنجاح مع فصل chunks (pdf/excel/charts/worker)
التفاصيل المعمارية وقواعد التعديل للوكلاء: AGENTS.md · دليل المستخدم: Docs/ · تقارير JEV: docs_dev/JEV Docs/
maghzaccount-pro v0.25.6 — جميع الحقوق محفوظة.
来源：GitHub · github.com