حساباتي
نظام مالي وإداري للشركات والاستوديوهات: متابعة العملاء والمشاريع وعروض الأسعار، إصدار الفواتير وتوزيع الدفعات، تسوية مصروفات الشركاء 50/50، وحاسبة زكاة آلية (2.5%) من واقع الأرصدة والديون الفعلية
- الدور
- تصميم وتطوير كامل
- السنة
- 2026
- المنصات
- Web · Windows · Server
- عملاء ومشاريع
- متابعة مراحل العمل والتسليمات
- فواتير وخزينة
- توزيع الدفعات وكشوف الحساب
- 2.5%
- حاسبة زكاة آلية من الأرصدة
- 50 / 50
- تسوية مصروفات وحصص الشركاء
فكرة المشروع
المشكلة واحتياج السوق
الاستوديوهات والشركات الخدمية بتعاني من تشتت الحسابات بين عروض الأسعار، دفعات العملاء المقسطة على أكتر من فاتورة، مصروفات الشركاء المشتركة، وحساب الزكاة السنوية بدقة من واقع السيولة والذمم الفعلية
معمارية النظام
مكونات وطبقات النظام
نظام تشغيل مالي وإداري مبني بـ Next.js 16 (App Router + Server Actions) و React 19 و TypeScript فوق قاعدة SQLite/Drizzle ORM محلية سريعة، مع محرك مالي يتعامل بالقروش الصحيحة (Integer Minor Units) ويجتاز 26/26 فحص قبول آلي
Arabic-First Studio UI · Next.js 16 + React 19
لوحة التحكم، العملاء، المشاريع، المالية، والزكاة
- Daily Action Dashboard (S01)
- Clients, Agreements & Milestones
- Treasury, Invoices & Allocations
- Zakat Calculator & PDF/CSV Export
Accounting & Allocation Engine · TypeScript
محرك القروش، تخصيص الدفعات، وتسوية الشركاء
- Integer Piastre Money Engine
- Multi-Invoice Payment Allocation
- Unallocated Customer Credit Ledger
- 50/50 Partner Split Settlement
Persistence & Security · Drizzle ORM + SQLite
تخزين محلي سريع مع تشفير scrypt وسجل تدقيق
- Drizzle ORM Relational Schema
- Frozen Agreement Snapshots
- scrypt Password Hashing + Sessions
- 26/26 Automated Acceptance Checks
قاعدة البيانات
هيكل البيانات وأهم الجداول
مخطط مالي يضمن عدم ضياع أي قرش: كل دفعة إما تخصص لفاتورة أو أكثر، أو تحفظ كرصيد دائن للعميل (`unallocated_credit`) يظهر في كشف الحساب ويخصم تلقائيا من وعاء الزكاة
| الجدول | الدور داخل النظام |
|---|---|
clients / agreements / projects | العملاء، الاتفاقيات المجمدة (Snapshots)، والمشاريع ومهامها |
invoices / payments / payment_allocations | الفواتير، التحصيلات، وجدول ربط الدفعة بأكثر من فاتورة |
accounts / expenses / partner_settlements | الخزائن والحسابات البنكية، المصروفات، وتسويات الشركاء 50/50 |
zakat_assessments / audit_logs | تقييمات الزكاة المحفوظة (لقطة الحول) وسجل التدقيق الإلزامي |
تفاصيل التنفيذ
أهم الحلول والقرارات التقنية
تمثيل جميع المبالغ المالية كأعداد صحيحة بالقروش (Minor Units)
لمنع أخطاء الكسور العشرية (`Floating-Point Drift`) في توزيع الدفعات وحساب النسب، تخزن وتحسب كل القيم المالية بالقروش الصحيحة مع التحقق الصارم من عدم قبول أي مبالغ سالبة أو صفرية
تخصيص دفعة واحدة على عدة فواتير مع حفظ الفائض كمقدم عميل
عندما يدفع العميل مبلغا يغطي فاتورة قديمة وجزءا من فاتورة جديدة أو يزيد عنها، يوزع النظام المبلغ بدقة ويسجل أي فائض كـ «مقدمات عملاء غير مخصصة» تخصم كالتزام عند حساب الزكاة
حاسبة زكاة شرعية آلية (2.5%) مرتبطة بالأرصدة الحية
تحسب الزكاة تلقائيا من أرصدة النقد الفعلي + الذمم المدينة المرجوة + أرصدة الشركاء مطروحا منها مقدمات العملاء والديون المستحقة والذمم المشكوك فيها، مع حفظ لقطة التقييم في السجل
الأمان والصلاحيات
تأمين البيانات والصلاحيات
- تشفير كلمات المرور بـ `scrypt` مع جلسات HTTP-only وتوجيه محمي لجميع الصفحات
- تجميد بنود وأسعار الاتفاقية (`Frozen Agreement Snapshot`) لحظة التعاقد حتى لا تتأثر الفواتير السابقة بتغيير أسعار الباقات لاحقا
- سكربت تحقق آلي شامل (`scripts/verify.ts`) يختبر 26 معيار قبول (`AC02–AC14`) بالبيانات الفعلية
من داخل الكود
معادلة حساب وعاء الزكاة الصافي بالقروش الصحيحة
export function calculateZakatBase(input: ZakatLedgerInput): ZakatResult {
const grossAssetsMinor =
input.cashBalancesMinor +
input.collectibleReceivablesMinor +
input.inventoryGoodsMinor +
input.partnerReceivableMinor;
const deductibleLiabilitiesMinor =
input.unallocatedCustomerCreditsMinor +
input.partnerPayableMinor +
input.manualDebtsMinor +
input.doubtfulReceivablesMinor;
const netBaseMinor = Math.max(0, grossAssetsMinor - deductibleLiabilitiesMinor);
const zakatDueMinor = Math.round(netBaseMinor * 0.025); // 2.5% (ربع العشر)
return { netBaseMinor, zakatDueMinor };
} واجهات النظام
لقطات شاشة من داخل النظام
واجهات الويب ولوحات الإدارة
شاشات تطبيق الموبايل
ملخص المشروع
النتيجة وحالة التشغيل
نظام مالي وإداري متكامل يجتاز 26/26 فحص قبول آلي ويغطي دورة العمل من عرض السعر حتى التسوية وحساب الزكاة