Files
musadeq/README.md

41 lines
1.6 KiB
Markdown

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