AI Assistants
Yy
By Aden Marina
Yyy
Install
openclaw plugins install @akaknele/aihubmix-authConfiguration Example
import fs from 'fs';
import path from 'path';
// Read the video file and convert it to base64
const videoPath = 'generated_video.mp4';
const videoData = fs.readFileSync(videoPath);
const videoBase64 = videoData.toString('base64');
const videoExt = path.extname(videoPath).slice(1);
const videoUrl = `data:video/${videoExt};base64,${videoBase64}`;
// Send the request
const response = await fetch('https://aihubmix.com/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-Fc3xHF8snIaHKrMy788b290a6a424904B4Fc034c333d036d', // Replace with the key you generated on AiHubMix
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kimi-k2.5',
messages: [
{ role: 'system', content: 'You are Kimi.' },
{
role: 'user',
content: [
{
type: 'video_url',
video_url: {
url: videoUrl
}
},
{
type: 'text',
text: 'Please describe the content of this video.'
}
]
}
],
max_tokens: 4000
})
});
const data = await response.json();
console.log(data.choices[0].message.content);README
# 🏨 Marina Hotel - نظام إدارة الفنادق المتكامل
[](https://github.com/Nassaralshabi/marina-hotel-wit-app/actions)
[](https://flutter.dev/)
[](https://dart.dev/)
[](https://developer.android.com/)
[](LICENSE)
**نظام إدارة فندقي عربي شامل ومتكامل** - مصمم خصيصاً للسوق العربي مع دعم كامل للغة العربية واتجاه RTL. يدعم العمل دون إنترنت مع مزامنة ذكية عند الاتصال.
---
## 🚀 المميزات الأساسية
### 🏨 **إدارة فندقية شاملة (8 وحدات رئيسية)**
| الوحدة | الوصف | الحالة |
|--------|--------|---------|
| 📊 **Dashboard** | لوحة تحكم بالإحصائيات المباشرة والتقارير | ✅ مكتملة 95% |
| 🏨 **إدارة الغرف** | نظام طوابق تفاعلي مع حالات الغرف المختلفة | ✅ مكتملة 90% |
| 📅 **الحجوزات** | إدارة شاملة مع Check-in/Check-out ديناميكي | ✅ مكتملة 85% |
| 💳 **نظام الدفع** | 5 طرق دفع + إيصالات PDF احترافية | ✅ مكتملة 100% |
| 👥 **إدارة الموظفين** | بيانات الموظفين وتتبع الرواتب | ✅ مكتملة 80% |
| 💰 **تتبع المصروفات** | تصنيف وتتبع جميع مصروفات الفندق | ✅ مكتملة 75% |
| 🏦 **التمويل والخزينة** | إدارة مالية وتقارير نقدية يومية | ✅ مكتملة 70% |
| 📊 **التقارير والإعدادات** | تقارير شاملة وإعدادات النظام | ✅ مكتملة 85% |
### 🌍 **واجهة عربية أصيلة**
- **دعم RTL كامل** - تصميم من اليمين لليسار
- **تصميم Bootstrap متطابق** - يطابق تماماً إدارة PHP الموجودة
- **Material Design 3** - تصميم حديث وأنيق
- **تخطيط متجاوب** - شريط جانبي للكمبيوتر + درج للهاتف
- **ألوان عربية متناسقة** - نظام ألوان مُصمم للراحة
### ⚡ **تقنيات متقدمة**
- **Offline-First Architecture** - عمل كامل دون إنترنت
- **مزامنة ذكية تلقائية** - مع الخادم عند توفر الاتصال
- **قاعدة بيانات SQLite محلية** - أداء سريع وموثوق
- **تشفير البيانات** - حماية متقدمة للمعلومات الحساسة
- **Multi-Architecture Support** - ARM64, ARMv7, x86_64
---
## 📱 لقطات الشاشة
<div align="center">
### Dashboard الرئيسية
### إدارة الغرف - نظام الطوابق
### نظام المدفوعات المتقدم
### الحجوزات والـ Checkout
</div>
---
## 🚀 البدء السريع
### المتطلبات
- **Flutter**: 3.24.3+
- **Dart**: 3.4.0+
- **Android Studio** أو **VS Code**
- **Java**: 17 (للأندرويد)
- **Git**: لاستنساخ المشروع
### التثبيت
```bash
# 1. استنساخ المشروع
git clone https://github.com/Nassaralshabi/marina-hotel-wit-app.git
cd marina-hotel-wit-app/mobile
# 2. تثبيت dependencies
flutter pub get
# 3. إنشاء قاعدة البيانات
flutter packages pub run build_runner build --delete-conflicting-outputs
# 4. تشغيل التطبيق
flutter run
```
### بناء APK/AAB
```bash
# بناء سريع للاختبار
flutter build apk --debug
# بناء للإنتاج (متعدد المعماريات)
flutter build apk --release --target-platform android-arm,android-arm64,android-x64 --split-per-abi
# بناء لمتجر Google Play
flutter build appbundle --release
```
📖 [تعليمات البناء الكاملة](mobile/BUILD_INSTRUCTIONS.md)
---
## 🏗️ معمارية المشروع
### البنية العامة
```
marina-hotel-wit-app/
├── 📱 mobile/ # تطبيق Flutter الأساسي
│ ├── lib/
│ │ ├── screens/ # شاشات التطبيق (15+ شاشة)
│ │ ├── components/ # مكونات الواجهة (20+ مكون)
│ │ ├── services/ # خدمات البيانات والAPI
│ │ ├── models/ # نماذج البيانات
│ │ └── utils/ # أدوات مساعدة
│ ├── android/ # إعدادات الأندرويد
│ └── build_apk.sh # سكريبت البناء المتقدم
├── 🌐 admin/ # نظام إدارة PHP (مرجع للتصميم)
├── ⚙️ .github/workflows/ # GitHub Actions للCI/CD
├── 📁 releases/ # مجلد الإصدارات والAPK
└── 📚 docs/ # التوثيق والمرفقات
```
### قاعدة البيانات (8 جداول رئيسية)
```sql
📊 Rooms # الغرف والطوابق
📅 Bookings # الحجوزات والنزلاء
📝 BookingNotes # ملاحظات الحجوزات
👥 Employees # بيانات الموظفين
💰 Expenses # المصروفات والتصنيفات
🏦 CashTransactions # المعاملات النقدية
💳 Payments # المدفوعات (5 أنواع)
📤 Outbox # للمزامنة مع الخادم
```
---
## 💳 نظام المدفوعات المتطور
### 5 طرق دفع مدمجة
| نوع الدفع | الرمز | المميزات |
|-----------|------|----------|
| 💵 نقدي | `CASH` | دفع مباشر، إيصال فوري |
| 💳 بطاقة ائتمانية | `CREDIT_CARD` | رقم بطاقة، CVV، تاريخ انتهاء |
| 🏦 تحويل بنكي | `BANK_TRANSFER` | رقم مرجع، بيانات بنك |
| 📄 شيك | `CHECK` | رقم شيك، بنك، تاريخ استحقاق |
| 📅 تقسيط | `INSTALLMENT` | عدد أقساط، مواعيد دفع |
### مميزات الدفع
- ✅ **إيصالات PDF احترافية** - تصميم A4 كامل
- ✅ **فواتير مفصلة** - مع جداول وإجماليات
- ✅ **أزرار دفع سريع** - 50%, 75%, 100%
- ✅ **نظام استرداد** - إدارة المدفوعات المسترجعة
- ✅ **تتبع شامل** - سجل كامل لجميع المعاملات
---
## 🔄 GitHub Actions - CI/CD متقدم
### Workflow مُحسّن للإنتاج
```yaml
🚀 المميزات المدمجة:
├── 🔨 بناء متعدد المعماريات (ARM64, ARMv7, x86_64)
├── 🧪 فحوصات جودة وأمان شاملة
├── 📦 تعبئة تلقائية مع metadata
├── 🏷️ إصدارات GitHub تلقائية
├── 📊 تقارير حجم وأداء
└── 🔐 دعم signing للإنتاج
```
### تشغيل تلقائي
- ✅ **عند push للـ main** - إصدار تلقائي
- ✅ **عند push لأي فرع capy/** - بناء للاختبار
- ✅ **تشغيل يدوي** - من Actions tab
- ✅ **Pull Requests** - فحص الكود
- 🔄 **تحديث 2025-10-23** - تم تنفيذ دفع اختباري لتأكيد تشغيل سير العمل
- ✅ **تشغيل 2025-11-17** - تم اختبار بناء Release APK من الفرع A1
**📥 [أحدث إصدار](https://github.com/Nassaralshabi/marina-hotel-wit-app/releases)**
---
## 📊 الإحصائيات والأداء
### حجم المشروع
- **57+ ملف Dart** عالي الجودة
- **~8,000+ سطر كود** مُوثق ومُختبر
- **15+ شاشة** متكاملة ومتناسقة
- **20+ مكون UI** قابل لإعادة الاستخدام
### أداء التطبيق
- **حجم APK**: 15-25 MB (مضغوط)
- **وقت البدء**: أقل من 3 ثواني
- **استهلاك الذاكرة**: 60-120 MB
- **نسبة نجاح المزامنة**: 99.5%
### المتطلبات النهائية
- **نظام التشغيل**: Android 5.0+ (API 21)
- **المعالج**: ARM أو x86 (32/64 bit)
- **الذاكرة**: 2GB RAM (4GB مُوصى به)
- **المساحة**: 100MB حرة
---
## 🛠️ للمطورين
### تطوير محلي
```bash
# استنساخ للتطوير
git clone https://github.com/Nassaralshabi/marina-hotel-wit-app.git
cd marina-hotel-wit-app
# إنشاء فرع جديد
git checkout -b feature/new-feature
# تطوير مع hot reload
cd mobile && flutter run --hot
# اختبار
flutter test
flutter analyze
```
### إعداد Nhost السحابي
1. ضمن لوحة Nhost افتح **Settings → Git** واضبط `Repository` على هذا المشروع، و`Base directory` على `/`، و`Deployment branch` على `Ali`.
2. تأكد من وجود ملف `nhost.toml` في الجذر وحدّث قيم الأسرار من **Settings → Secrets** (`HASURA_ADMIN_SECRET`, `HASURA_WEBHOOK_SECRET`, `HASURA_GRAPHQL_JWT_SECRET`).
3. بعد كل push على الفرع Ali ستعمل عملية نشر تلقائية وتطبّق المزامنة (المخططات، الميتاداتا، الوظائف) وفق إعدادات `nhost.toml`.
### المساهمة
1. **Fork** المشروع
2. إنشاء فرع feature (`git checkout -b feature/AmazingFeature`)
3. Commit التغييرات (`git commit -m 'Add some AmazingFeature'`)
4. Push للفرع (`git push origin feature/AmazingFeature`)
5. فتح Pull Request
### معايير الكود
- اتباع [Flutter Style Guide](https://dart.dev/guides/language/effective-dart/style)
- تعليق الكود باللغة العربية والإنجليزية
- اختبار جميع الميزات الجديدة
- توثيق التغييرات في CHANGELOG.md
---
## 🔮 خارطة الطريق
### الإصدار القادم (v1.2) - Q1 2026
- [ ] **تقارير متقدمة** مع رسوم بيانية تفاعلية
- [ ] **نظام إشعارات Push** للتنبيهات المهمة
- [ ] **تكامل مع بوابات الدفع** الإلكترونية العربية
- [ ] **نسخ احتياطي سحابي** تلقائي
- [ ] **واجهة تخصيص الألوان** والثيمات
### المدى الطويل (v2.0) - 2026
- [ ] **نسخة Web Dashboard** متكاملة
- [ ] **تطبيق iPad/Tablet** محسن للشاشات الكبيرة
- [ ] **ذكاء اصطناعي** للتنبؤات وتحليل البيانات
- [ ] **تكامل مع أنظمة محاسبية** خارجية
- [ ] **نظام حجوزات أونلاين** للعملاء
- [ ] **تطبيق للعملاء** منفصل
---
## 🤝 الدعم والمجتمع
### الحصول على المساعدة
- 📖 **الوثائق**: [تصفح الدلائل الكاملة](docs/)
- 🐛 **الإبلاغ عن خطأ**: [GitHub Issues](https://github.com/Nassaralshabi/marina-hotel-wit-app/issues/new?template=bug_report.md)
- 💡 **اقتراح ميزة**: [Feature Request](https://github.com/Nassaralshabi/marina-hotel-wit-app/issues/new?template=feature_request.md)
- 💬 **مناقشات**: [GitHub Discussions](https://github.com/Nassaralshabi/marina-hotel-wit-app/discussions)
### للشركات والفنادق
- 🏨 **دعم تقني متخصص** للتنصيب والتخصيص
- 🔧 **تطوير ميزات مخصصة** حسب احتياجاتك
- 📊 **تدريب الموظفين** على استخدام النظام
- 🔄 **نقل البيانات** من الأنظمة السابقة
**📧 للتواصل التجاري**: [إنشاء Issue جديد](https://github.com/Nassaralshabi/marina-hotel-wit-app/issues/new)
---
## 📜 الترخيص والحقوق
هذا المشروع مرخص تحت رخصة **MIT License** - انظر ملف [LICENSE](LICENSE) للتفاصيل.
```
MIT License
Copyright (c) 2024-2025 Marina Hotel Development Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...
```
---
## 🙏 شكر وتقدير
### المساهمون الأساسيون
- **فريق Marina Hotel** - التطوير الأساسي والتصميم
- **مجتمع Flutter العربي** - الدعم والتوجيه
- **مطوري المكتبات المفتوحة** - الأدوات والحلول
### التقنيات المستخدمة
شكر خاص للمشاريع مفتوحة المصدر التالية:
| تقنية | الاستخدام | الرابط |
|--------|-----------|--------|
| 🐦 **Flutter** | إطار العمل الأساسي | [flutter.dev](https://flutter.dev) |
| 🎯 **Dart** | لغة البرمجة | [dart.dev](https://dart.dev) |
| 🗄️ **Drift** | قاعدة البيانات المحلية | [drift.simonbinder.eu](https://drift.simonbinder.eu) |
| 🔄 **Riverpod** | إدارة الحالة | [riverpod.dev](https://riverpod.dev) |
| 📄 **PDF** | إنشاء الإيصالات | [pub.dev/packages/pdf](https://pub.dev/packages/pdf) |
|
... (truncated)
Comments
Sign in to leave a comment