# مُصادَق (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 للمفاتيح الحساسة.