# سجل التغييرات — CHANGELOG

كل التغييرات الجوهرية في المنصة مُوثَّقة هنا.  
التنسيق: [v23.x.x] - YYYY-MM-DD

---

## [v23.0.0] - 2026-04-28 — الإصدار الرئيسي

### ✨ مُضاف (Added)

#### نظام التسعير المتكامل
- `engine/PricingEngine.php` — محرك الأسعار الجديد (305L)
  - getAll(), updateRate(), flushCache(), toSDG(), getDocumentPrice()
  - cache 5 دقائق (file-based)
- `api/public/pricing.php` — API عام لجميع الأسعار بالجنيه
- `api/admin/exchange_rate.php` — تحكم Admin في سعر الصرف
- `api/admin/pricing_control.php` — تحكم شامل في الأسعار

#### نظام حلول الشركات
- `engine/CorporateAgent.php` — محرك تحليل B2B (220L)
  - analyze(), estimateROI(), generateProposalPrompt()
- `app/corporate-solutions.php` — wizard 5 مراحل (495L)
- `api/corporate/intake.php` — حفظ تدريجي للمراحل
- `api/corporate/analyze.php` — تحليل CorporateAgent
- `api/corporate/proposal.php` — توليد الدراسة بالـ AI
- `api/corporate/submit.php` — الإرسال النهائي + CRM
- `api/admin/corporate_action.php` — إجراءات الإدارة

#### نظام المقترحات
- `engine/SuggestionsAgent.php` — محرك التحليل (273L)
  - analyze(), findSimilar() (Jaccard), awardPoints()
- `app/suggestions.php` — شاشة المقترحات (303L)
- `api/suggestions/create.php` — إنشاء + تحليل تلقائي
- `api/suggestions/vote.php` — تصويت
- `api/suggestions/list.php` — قائمة مع filter

#### قاعدة البيانات (12 جدول جديد)
- `platform_settings` — 26 إعداد لكل أسعار المنصة
- `exchange_rates` — سجل سعر الصرف التاريخي
- `document_prices` — 10 أنواع × 3 خطط
- `subscription_credits` — رصيد وثائق Plus/Pro الشهري
- `corporate_inquiries` — طلبات الشركات (30 حقل)
- `corporate_proposals` — الدراسات المولَّدة
- `corporate_services_catalog` — 8 خدمات
- `user_suggestions` — مقترحات (30 حقل)
- `suggestion_votes` — تصويت
- `fraud_flags` — مكافحة الاحتيال
- `achievement_badges` — 10 شارات
- `neighborhood_zones` — 18 ولاية سودانية

#### بيانات البذر (seed.sql)
- 26 platform_setting بالقيم الافتراضية
- سعر الصرف: 1 USD = 4,100 SDG
- خطط: free/plus/pro/corp
- 10 أسعار وثائق
- 10 achievement_badges
- 18 neighborhood_zones

#### Admin Panel (39 tab الآن)
- `tab=pricing_exchange` — سعر الصرف + سجل تاريخي
- `tab=pricing_plans` — أسعار الاشتراكات
- `tab=pricing_documents` — أسعار الوثائق (inline editing)
- `tab=pricing_corporate` — أسعار الشركات
- `tab=pricing_policies` — العمولة والسياسات
- `tab=corporate` — طلبات الشركات + CRM
- `tab=suggestions` — مقترحات + تحليل Agent + قبول/رفض
- `tab=fraud` — مكافحة الاحتيال

#### APIs أخرى
- `api/subscription/credits.php` — رصيد الوثائق
- `api/wallet/topup.php` — شحن المحفظة
- `api/notifications/mark_read.php` — تحديد كمقروء

#### Error Pages
- `500.html` — صفحة خطأ السيرفر (جديدة)

### 🔧 تحسينات (Improved)

#### BillingEngine
- إضافة `getDocumentCost()` — يقرأ من document_prices via PricingEngine
- إضافة `chargeDocument()` — يخصم من credits أولاً ثم wallet
- الحجم: 291L → 543L

#### AssistantEngine
- تغيير اسم enterprise domain: مساعد المؤسسات → مساعد حلول الشركات
- حذف: 'government integrations' → 'corporate integrations'

#### PolicyEngine
- إضافة 7 cases: corporate.intake, doc_issuance.paid, doc_issuance.credit_check,
  corporate.proposal_view, suggestion.submit, suggestion.spam, suggestion.vote
- الإجمالي: 21 → 28 case

#### FlowEngine
- enterprise → corporate_solutions_v1

#### Config.php
- إصلاح: AI_DAILY_LIMIT_FREE (تكرار: 10 → 20)
- إضافة: USD_TO_SDG_RATE, SUB_PLUS_PRICE_SDG, SUB_PRO_PRICE_SDG
- إضافة: PricingEngine auto-load

#### Frontend
- `index.html`: بطاقة Corporate Solutions في قسم التسعير
- `index.html`: JS يقرأ الأسعار من API (لا hardcoded)
- `hub.html`: رابط حلول الشركات في Enterprise section
- `hub.html`: إصلاح 3,000/8,000 SDG → 20,000/50,000 SDG
- `app/services.php`: 14 فئة (+pharmacy, jobs, market, suggestions)
- `app/flow.php`: إضافة @media + gradient
- `app/services.php`: إضافة @media responsive
- `404.html`: إضافة animation
- `500.html`: صفحة جديدة

#### Security
- `api/visitor_ask.php`: CORS headers
- `api/auth/login.php`: session_start()
- `api/payment/create_invoice.php`: BillingEngine require

### 🗑️ محذوف (Removed)
- الأرقام القديمة: 521, 554, 597 من كل الصفحات
- 'government integrations' من AssistantEngine
- Hardcoded prices (3,000, 8,000, 40, 70 SDG) — استُبدِلت بـ API

---

## [v22.0.0] - 2026-03-01

### ✨ مُضاف
- InferenceEngine: 610 قاعدة × 19 sector (كان 554)
- developer.html: 13 tab كاملة (sandbox + providers + logs)
- hub.html: 65 ELEMENT_MAP + ترجمة ثنائية كاملة
- AssistantEngine: 14 domain + isOutOfDomain()
- ProviderDecisionEngine: REAL/AI_FIRST/AI
- BillingEngine: hold model + commitFunds + rollbackFunds
- FinancialAgent: double-entry + receipt_no
- PolicyEngine: DSL + hot reload

### 🔧 تحسينات
- Gateway: HARD GATE للقطاعات الحساسة
- app/medical + legal + pharmacy + education + jobs: gradient + skeleton + responsive

---

## [v21.0.0] - 2026-01-15

- الإصدار الأولي
- 97 جدول أساسي
- 7 flows في StepController
- API basic endpoints
