نظام فوترة وإدارة حسابات لمنشأة أبحاث دوائية — .NET + Next.js

نظام ويب متكامل (Full-Stack) لإدارة الفوترة والحسابات المالية لمركز أبحاث صيدلانية جامعي، يشمل واجهة خلفية (Backend API) وواجهة أمامية (Frontend Dashboard).

ملخص المشروع

تم بناء نظام متكامل لإدارة عمليات الفوترة والمحاسبة لمركز أبحاث صيدلانية، يتعامل مع الدينار الأردني (JOD) بثلاث خانات عشرية. النظام يتضمن:

الوظائف الأساسية:

• إدارة الشركات العميلة — تسجيل بيانات الشركات ومعلومات التواصل مع إحصائيات مالية لكل شركة

• إدارة الدراسات البحثية — ربط الدراسات بالشركات مع تتبع الحالة (نشطة/مكتملة/ملغاة) وأكواد فريدة

• إدارة المخرجات (Deliverables) — تقارير بحثية (REP) وبروتوكولات (PRO) مع ترقيم تلقائي وتتبع التسليم

• طرق الدفع الديناميكية — إضافة وإدارة طرق دفع مخصصة (نقدي، تحويل بنكي، شيك)

• تسجيل المدفوعات — دفعات مقدمة ودفعات مرتبطة بالمخرجات مع حساب المبالغ المتبقية تلقائياً

• إصدار الفواتير — إنشاء فواتير تلقائية مرتبطة بالمدفوعات مع ترقيم تسلسلي •

لوحة إحصائيات مالية — رسوم بيانية تفاعلية للإيرادات الشهرية وترتيب الشركات والدراسات المستحقة

المميزات التقنية — الواجهة الخلفية (Backend):

• بنية نظيفة (Clean Architecture) باستخدام .NET 10 Web API

• قاعدة بيانات PostgreSQL مع Entity Framework Core و Auto-Migration

• نظام مصادقة JWT آمن مع Fallback Policy •

RESTful API كامل مع Swagger documentation • معالجة أخطاء موحدة باللغة العربية

المميزات التقنية — الواجهة الأمامية (Frontend):

• Next.js 15 (App Router) مع TypeScript strict mode

• واجهة عربية بالكامل (RTL) بخط Cairo — تصميم احترافي هادئ ومنضبط

• مكونات shadcn/ui مع Tailwind CSS — تجربة مستخدم سلسة

• TanStack Query v5 لإدارة حالة البيانات والتخزين المؤقت

• رسوم بيانية تفاعلية بـ Recharts • نماذج ذكية مع React Hook Form + Zod validation • مصادقة JWT في الذاكرة (أكثر أماناً من localStorage)

• متجاوب بالكامل — يعمل على الحاسب والجوال

طريقة التنفيذ:

1-تحليل المتطلبات وتصميم نموذج البيانات (6 جداول مترابطة)

2-بناء Backend API بمنهجية Clean Architecture على 7 مراحل

3-كتابة مواصفات تصميم مفصلة للواجهة الأمامية (Design Spec)

4-بناء Frontend بالكامل — صفحات القوائم والتفاصيل والنماذج ولوحة التحكم

5-ربط Frontend بـ Backend وضبط CORS والمصادقة

6-اختبار شامل وإضافة بيانات تجريبية