🚀 Initialize Musadaq SaaS: Full Backend + AI + React Dashboard + Docker Setup

README.md

@@ -0,0 +1,40 @@
+# مُصادَق (Musadaq) — Financial Automation SaaS
+
+منصة برمجية متكاملة (SaaS) لأتمتة دورة حياة الفواتير الضريبية في الأردن، مدمجة بذكاء اصطناعي لاستخراج البيانات وربطها مباشرة ببوابة "جو فوترة" (JoFotara).
+
+---
+
+## 🏛️ المجلدات الرئيسية
+
+| المجلد | الوظيفة | التقنيات |
+|---------|---------|----------|
+| `backend/` | محرك المعالجة، التحقق الضريبي، AI، والربط الحكومي | NestJS, TypeORM, PostgreSQL, Bull, Gemini AI |
+| `frontend/` | لوحة تحكم مكاتب المحاسبة والشركات | React, Vite, Tailwind CSS, React Query |
+| `musadaq/` | تطبيق الموبايل للمسح الضوئي (Scanner) | Flutter, GetX |
+
+---
+
+## 🚀 التشغيل السريع (Docker)
+
+لتشغيل البيئة بالكامل:
+
+```bash
+docker compose up -d --build
+```
+
+---
+
+## 🔄 المزامنة والنشر (Sync to Server)
+
+تم إعداد ملف `sync-to-server.sh` لأتمتة عملية الرفع والبناء على خادم الإنتاج (Contabo) بضغطة واحدة:
+
+```bash
+sh sync-to-server.sh "وصف التعديلات هنا"
+```
+
+---
+
+## 🔒 الميزات الأمنية والقانونية
+- **التحقق الضريبي**: تطبيق قواعد المحاسبة الأردنية (Rules 001-004).
+- **جو فوترة**: توليد ملفات XML بمعيار **UBL 2.1**.
+- **حماية البيانات**: تشفير AES-256 للمفاتيح الحساسة.