أحمد الصعيديProduct & Systems Engineer
← كل المشاريع البرمجية
نظام إدارة العملاء والمشاريع والحسابات والزكاة
مشروع عميل

حساباتي

نظام مالي وإداري للشركات والاستوديوهات: متابعة العملاء والمشاريع وعروض الأسعار، إصدار الفواتير وتوزيع الدفعات، تسوية مصروفات الشركاء 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 فحص قبول آلي

L1

Arabic-First Studio UI · Next.js 16 + React 19

لوحة التحكم، العملاء، المشاريع، المالية، والزكاة

  • Daily Action Dashboard (S01)
  • Clients, Agreements & Milestones
  • Treasury, Invoices & Allocations
  • Zakat Calculator & PDF/CSV Export
L2

Accounting & Allocation Engine · TypeScript

محرك القروش، تخصيص الدفعات، وتسوية الشركاء

  • Integer Piastre Money Engine
  • Multi-Invoice Payment Allocation
  • Unallocated Customer Credit Ledger
  • 50/50 Partner Split Settlement
L3

Persistence & Security · Drizzle ORM + SQLite

تخزين محلي سريع مع تشفير scrypt وسجل تدقيق

  • Drizzle ORM Relational Schema
  • Frozen Agreement Snapshots
  • scrypt Password Hashing + Sessions
  • 26/26 Automated Acceptance Checks
التقنيات — الأدوات والتقنيات المستخدمة:
  • Next.js
  • React
  • TypeScript
  • Tailwind CSS
  • SQLite / Drizzle
  • Playwright E2E

قاعدة البيانات

هيكل البيانات وأهم الجداول

مخطط مالي يضمن عدم ضياع أي قرش: كل دفعة إما تخصص لفاتورة أو أكثر، أو تحفظ كرصيد دائن للعميل (`unallocated_credit`) يظهر في كشف الحساب ويخصم تلقائيا من وعاء الزكاة

الجدول الدور داخل النظام
clients / agreements / projects العملاء، الاتفاقيات المجمدة (Snapshots)، والمشاريع ومهامها
invoices / payments / payment_allocations الفواتير، التحصيلات، وجدول ربط الدفعة بأكثر من فاتورة
accounts / expenses / partner_settlements الخزائن والحسابات البنكية، المصروفات، وتسويات الشركاء 50/50
zakat_assessments / audit_logs تقييمات الزكاة المحفوظة (لقطة الحول) وسجل التدقيق الإلزامي

تفاصيل التنفيذ

أهم الحلول والقرارات التقنية

01

تمثيل جميع المبالغ المالية كأعداد صحيحة بالقروش (Minor Units)

لمنع أخطاء الكسور العشرية (`Floating-Point Drift`) في توزيع الدفعات وحساب النسب، تخزن وتحسب كل القيم المالية بالقروش الصحيحة مع التحقق الصارم من عدم قبول أي مبالغ سالبة أو صفرية

02

تخصيص دفعة واحدة على عدة فواتير مع حفظ الفائض كمقدم عميل

عندما يدفع العميل مبلغا يغطي فاتورة قديمة وجزءا من فاتورة جديدة أو يزيد عنها، يوزع النظام المبلغ بدقة ويسجل أي فائض كـ «مقدمات عملاء غير مخصصة» تخصم كالتزام عند حساب الزكاة

03

حاسبة زكاة شرعية آلية (2.5%) مرتبطة بالأرصدة الحية

تحسب الزكاة تلقائيا من أرصدة النقد الفعلي + الذمم المدينة المرجوة + أرصدة الشركاء مطروحا منها مقدمات العملاء والديون المستحقة والذمم المشكوك فيها، مع حفظ لقطة التقييم في السجل

الأمان والصلاحيات

تأمين البيانات والصلاحيات

  • تشفير كلمات المرور بـ `scrypt` مع جلسات HTTP-only وتوجيه محمي لجميع الصفحات
  • تجميد بنود وأسعار الاتفاقية (`Frozen Agreement Snapshot`) لحظة التعاقد حتى لا تتأثر الفواتير السابقة بتغيير أسعار الباقات لاحقا
  • سكربت تحقق آلي شامل (`scripts/verify.ts`) يختبر 26 معيار قبول (`AC02–AC14`) بالبيانات الفعلية

من داخل الكود

معادلة حساب وعاء الزكاة الصافي بالقروش الصحيحة

studio-manager/src/lib/zakat.ts · TS
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 فحص قبول آلي ويغطي دورة العمل من عرض السعر حتى التسوية وحساب الزكاة

المشروع التالي نكسوس كلاس (Nexus Class) → منصة إدارة باشتراك للمدرسين والسناتر

جلسة تقييم تقنية · مصر / الخليج / عن بُعد

محتاج تبني نظام تشغيل، تنقذ مشروع AI، أو تبدأ عقد تطوير شهــــــــــري؟

حدد نوع المطلوب ومرحلة المشروع والميزانية التقريبية في نموذج التقييم خلال 30 ثانية عشان نبدأ الكلام بخطة معمارية عملية مباشرة.