BHD R

منصة عمانية ثنائية اللغة لإدارة العقارات، الوحدات، العقود، المستأجرين، التحصيل، الصيانة، والإعلانات العامة. الحرف R يعني Real Estate Management — إدارة العقارات.

الحزمة التشغيلية (مرجع المنتج): docs/OPERATIONS_SUITE_AR.md

تقرير اكتمال V1: docs/V1-COMPLETION-REPORT-AR.md
جرد مساحة Codex 2026-08-11: docs/CODEX_WORKSPACE_2026-08-11_AR.md
التوثيق المفصل: docs/PROJECT_DOCUMENTATION_AR.md

تقنيات المنصة ومقارنتها بـ bhd-om: docs/TECH_STACK_AR.md

واجهة عُمانية 2026-08-23: docs/OMANI_UI_2026-08-23.md

مصفوفة الأمن: docs/SECURITY_CHECKLIST_MATRIX_AR.md

ربط Vercel: docs/VERCEL_DEPLOYMENT_AR.md — Root Directory = apps/web

معالج إضافة عقار (0.2.25): docs/implementation/PROPERTY-WIZARD-AR.md — رفع وسائط + إصلاح بناء Render: RELEASE-0.2.25-AR.md

أداء التنقل والحفظ (0.2.31): docs/implementation/PORTAL-PERF-AR.md — دروس وازن: WAZEN-SPEED-LESSONS-AR.md

لوحة التحكم ورفع أقسام البوابة (0.2.23): docs/implementation/PORTAL-DASHBOARD-AR.md — تجاوب الجوال ودرج القائمة: PORTAL-CHROME-AR.md

استضافة Nest API: docs/implementation/NEST-API-HOSTING.md

Cloudflare Workers bhd-r (ليس مسار النشر): docs/implementation/CLOUDFLARE-NOT-DEPLOY-PATH-AR.md — فشل البناء هناك متوقع؛ النشر = Vercel + Render.

هوية BHD: docs/BHD-R-IDENTITY-SETUP.md

مزامنة الحزمة 0.1.6: docs/RELEASE_SYNC_0.1.6.md

خريطة مجلد العمل الأب: docs/PARENT_FOLDER_SYNC_AR.md

لقطات النظام: docs/screenshots/2026-08-23/

مراجعات BHD-OM: docs/legacy-reviews/

الحالة

هذا المستودع هو الجيل الجديد المستقل لمنظومة BHD. بُني كـ modular monolith لتقليل التعقيد التشغيلي مع إبقاء حدود الوحدات واضحة وقابلة للفصل لاحقاً. المستودع المستهدف: ainoamn/BHD-R.

المتطلبات

• Node.js 24+
• pnpm 10+
• Docker 28+ (لبيئة التطوير المتكاملة)

تشغيل سريع

cp .env.example .env
docker compose up -d postgres redis minio minio-init mailpit clamav
pnpm install --frozen-lockfile
pnpm db:migrate
pnpm db:seed
pnpm dev

للتطوير عبر HTTP المحلي غيّر COOKIE_SECURE=false في .env. اتركه true في staging والإنتاج. ويمكن تشغيل المنظومة كلها بالحاويات عبر docker compose --profile app up -d --build؛ عندها تطبق خدمة migration المخطط، ثم تنشئ حسابات التشغيل غير فائقة الصلاحية قبل بدء التطبيقات.

• الواجهة: http://localhost:3000
• API: http://localhost:4000/v1
• توثيق API: docs/API_OVERVIEW.md
• Health: http://localhost:4000/health/ready

راجع docs/ للتصميم، الأمان، التشغيل، النشر، والهجرة.

التطبيقات

• apps/web: الموقع العام واللوحات الأربع:
  • المنصة (/admin) — إدارة الموقع والجذر (قوالب الإشعارات، العبارات، الخطط…).
  • المالك (/owner) — عقارات، حجوزات، عقود، تحصيل، فريق.
  • المطور (/developer) — مشاريع ووحدات تحت التطوير.
  • المستأجر (/tenant) — عقود وطلبات ومدفوعات للطرف المستأجر.
• apps/api: الـ API المركزية، الدخول الموحد، الصلاحيات، والمعاملات.
• apps/worker: الصور والعلامة المائية وPDF والإشعارات والمهام الخلفية.

الأمن (لا تكتفِ بـ README): SECURITY.md · docs/SECURITY_CONTROLS.md · docs/SECURITY_CHECKLIST_MATRIX_AR.md · docs/implementation/ENV-MANIFEST.md. كلمات المرور: scrypt؛ الحقول الحساسة: AES-256-GCM؛ عزل المؤسسات عبر org context + صلاحيات (مع RLS كدفاع ثانٍ).

فحوص التسليم

pnpm format:check
pnpm check
pnpm test:coverage
pnpm test:e2e
pnpm audit --audit-level=high

شرح الوحدات التشغيلية الجديدة وتدفقاتها موجود في الحزمة التشغيلية المتكاملة، وتفاصيل النشر والأمان في docs/DEPLOYMENT.md وdocs/SECURITY_CONTROLS.md وdocs/RUNBOOKS.md.

لا تُنسخ أسرار الإنتاج إلى المستودع. ابدأ من .env.example واستخدم مدير أسرار في بيئة النشر.