إضافة واجهة أداة الاستشراف الذكي (MVP)

.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Streamlit
+.streamlit/

README.md

@@ -1,6 +1,211 @@
-# Welcome to Streamlit!
+# 🔮 أداة الاستشراف الذكي - MVP
 
-Edit `/streamlit_app.py` to customize this app to your heart's desire. :heart:
+**النسخة الأولية (Minimum Viable Product)**
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+واجهة احترافية لتجربة استشراف مستقبلي واحدة - أداة ذكية تساعدك على تنظيم تفكيرك حول المستقبل قبل اتخاذ القرار.
+
+---
+
+## 📋 نظرة عامة
+
+أداة الاستشراف الذكي هي منصة تفاعلية مصممة لمساعدة رواد الأعمال، موظفي المؤسسات، وصناع القرار على:
+- **تحليل المشاريع والقرارات** من منظور استشرافي
+- **توليد سيناريوهات مستقبلية** (متفائلة، واقعية، متشائمة)
+- **تحديد الفرص والمخاطر** بشكل منظم
+- **طرح أسئلة استشرافية** للتفكير العميق
+
+---
+
+## ✨ المزايا الرئيسية
+
+### 🎯 واجهة بسيطة وسهلة الاستخدام
+- تصميم عربي احترافي ونظيف
+- لا حاجة للتسجيل أو إنشاء حساب
+- تجربة واحدة مباشرة وفعالة
+
+### 📊 داشبورد احترافي
+- عرض منظم للنتائج
+- سيناريوهات تفصيلية مع خيار العرض المختصر
+- رسوم بيانية تفاعلية للاحتماليات
+- بطاقات ملونة حسب نوع السيناريو
+
+### 🧠 تحليل ذكي
+- توليد سيناريوهات مخصصة حسب القطاع
+- تحليل الفرص والمخاطر بناءً على المدخلات
+- أسئلة استشرافية ذكية للتفكير العميق
+- ملخص تنفيذي شامل
+
+### 💾 تصدير النتائج
+- تحميل التقرير بصيغة JSON
+- إمكانية حفظ التحليل للمراجعة لاحقاً
+
+---
+
+## 🚀 التثبيت والتشغيل
+
+### المتطلبات
+- Python 3.8 أو أحدث
+- pip (مدير الحزم)
+
+### خطوات التثبيت
+
+1. **استنساخ المشروع**
+```bash
+git clone <repository-url>
+cd streamlit-example
+```
+
+2. **تثبيت المكتبات المطلوبة**
+```bash
+pip install -r requirements.txt
+```
+
+3. **تشغيل التطبيق**
+```bash
+streamlit run streamlit_app.py
+```
+
+4. **فتح المتصفح**
+- سيفتح التطبيق تلقائياً في المتصفح
+- أو افتح: `http://localhost:8501`
+
+---
+
+## 📖 كيفية الاستخدام
+
+### 1️⃣ إدخال معلومات المشروع
+قم بملء النموذج بالمعلومات التالية:
+- **نوع المشروع أو القرار**: مثل افتتاح مطعم، تطوير تطبيق، إلخ
+- **الموقع**: المدينة أو المنطقة
+- **القطاع**: اختر من القائمة (تقنية المعلومات، الخدمات الغذائية، إلخ)
+- **الأفق الزمني**: قصير، متوسط، أو طويل المدى
+- **المخاوف**: أكبر قلق لديك بخصوص المستقبل
+
+### 2️⃣ بدء التحليل
+- اضغط على زر **"ابدأ التحليل الاستشرافي"**
+- انتظر بضع ثوانٍ لتوليد النتائج
+
+### 3️⃣ استكشاف النتائج
+ستحصل على:
+- **ملخص تنفيذي** شامل
+- **ثلاثة سيناريوهات**:
+  - 🌟 متفائل
+  - ⚖️ واقعي (مرجح)
+  - ⚠️ متشائم
+- **الفرص والمخاطر** المحددة
+- **أسئلة استشرافية** للتفكير العميق
+
+### 4️⃣ تحميل التقرير
+- اضغط على **"تحميل التقرير"** لحفظ النتائج
+- أو ابدأ تحليل مشروع جديد
+
+---
+
+## 🎨 القطاعات المدعومة
+
+التطبيق يوفر تحليلاً متخصصاً للقطاعات التالية:
+- 💻 تقنية المعلومات
+- 🍽️ الخدمات الغذائية
+- 📚 التعليم والتدريب
+- 🛒 التجارة الإلكترونية
+- 🏥 الصحة والعافية
+- 💼 الخدمات المهنية
+- 🏭 التصنيع
+- 🏢 العقارات
+- ✈️ السياحة والضيافة
+- 🚚 النقل واللوجستيات
+
+---
+
+## 🛠️ التقنيات المستخدمة
+
+- **Streamlit**: إطار عمل بناء تطبيقات الويب التفاعلية
+- **Plotly**: رسوم بيانية تفاعلية
+- **Pandas**: معالجة البيانات
+- **Python**: لغة البرمجة الأساسية
+
+---
+
+## 📌 ملاحظات مهمة
+
+### ⚠️ تنويه قانوني
+هذه الأداة تقدم تحليلاً استشرافياً للمساعدة في التفكير الاستراتيجي فقط. **لا تتنبأ بالمستقبل** ولا تقدم:
+- توصيات استثمارية
+- توصيات قانونية
+- توصيات مالية ملزمة
+
+يُنصح باستشارة خبراء متخصصين قبل اتخاذ قرارات مصيرية.
+
+### 🎯 حدود النسخة الأولية (MVP)
+هذه النسخة مصممة كـ **Proof of Concept** وتركز على:
+- ✅ تجربة واحدة ممتازة
+- ✅ واجهة احترافية
+- ✅ سيناريوهات ذكية
+
+**لا تشمل:**
+- ❌ نظام حسابات مستخدمين
+- ❌ حفظ التحليلات في قاعدة بيانات
+- ❌ خصائص مؤسسية متقدمة
+- ❌ تكامل مع أنظمة خارجية
+
+---
+
+## 🎯 الجمهور المستهدف
+
+- 👔 **موظفو المؤسسات**: للتخطيط الاستراتيجي
+- 🚀 **رواد الأعمال**: لتقييم أفكار المشاريع
+- 💼 **المستشارون**: كأداة مساعدة في الاستشارات
+- 📊 **القيادات**: لاتخاذ قرارات مبنية على تحليل شامل
+
+---
+
+## 📈 التطوير المستقبلي
+
+### خطط محتملة للنسخ القادمة:
+- 🤖 دمج الذكاء الاصطناعي (OpenAI, Claude) لتحليلات أكثر ذكاءً
+- 💾 حفظ التحليلات في قاعدة بيانات
+- 👥 نظام حسابات وتسجيل دخول
+- 📧 مشاركة التقارير عبر البريد الإلكتروني
+- 📊 مقارنة بين عدة تحليلات
+- 📑 تصدير بصيغ PDF و Word
+- 🌐 دعم لغات إضافية
+- 📱 تطبيق محمول
+
+---
+
+## 🤝 المساهمة
+
+هذا المشروع مفتوح للتطوير والتحسين. نرحب بأي اقتراحات أو ملاحظات.
+
+---
+
+## 📝 الترخيص
+
+هذا المشروع مفتوح المصدر ومتاح للاستخدام التعليمي والتجريبي.
+
+---
+
+## 📞 الدعم
+
+للأسئلة أو الاستفسارات، يرجى:
+- فتح Issue في المستودع
+- التواصل مع فريق التطوير
+
+---
+
+## 🎉 شكر خاص
+
+تم تطوير هذه الأداة لتكون **POC مقنع للقيادات** في مجال الاستشراف الاستراتيجي.
+
+**النسخة**: 1.0.0 (MVP)
+**تاريخ الإصدار**: يناير 2026
+**اللغة**: العربية 🇸🇦
+
+---
+
+<div align="center">
+
+### 🔮 أداة الاستشراف الذكي
+**نظّم تفكيرك حول المستقبل قبل اتخاذ القرار**
+
+</div>

requirements.txt

@@ -1,3 +1,3 @@
-altair
-pandas
-streamlit
+streamlit>=1.28.0
+pandas>=2.0.0
+plotly>=5.17.0