فِهرِسي

فِهرِس المكتبات الشخصية

🚀 تجهيز بيئة التطوير

المتطلبات الأساسية

1. ثبّت Docker حسب نظام تشغيلك من خلال هذا الرابط
2. ثبّت Mise حسب نظام تشغيلك من خلال هذا الرابط
3. ثبّت مكتبة gpg حسب نظام تشغيلك. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS:

brew install gnupg

4. ثبّت مكتبة libpq حسب نظام تشغيلك. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS:

brew install libpq

5. أضِف مكتبة libpq إلى متغير PATH حسب نظام تشغيلك باتباع التعليمات الموضّحة بعد تثبيت المكتبة. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS مع Zsh:

echo 'export PATH="/opt/homebrew/opt/libpq/bin:$PATH"' >> /Users/{user}/.zshrc

إعداد المشروع

1. نفّذ الأمر التالي لنسخ مستودع المشروع إلى حاسبك:

git clone [email protected]:ieasybooks/fehresi-web-app.git

2. افتح سطر الأوامر داخل مجلد المشروع ونفّذ الأمر التالي لتثبيت الأدوات المطلوبة للتطوير من خلال Mise:

mise install

3. نفّذ الأمر التالي لتثبيت اعتماديات المشروع وتشغيل خادم التطوير المحلّي:

mise dev

4. افتح الرابط http://localhost:3000 في متصفحك للوصول إلى الصفحة الرئيسية للمشروع

الأدوات المُثبتة

ستحصل على الأدوات التالية باتباعك للخطوات المذكورة أعلاه:

• Docker
• Mise
• gnupg
• libpq
• Ruby (3.4.4)
• Rails (8.0.2)
• Node.js (24.1.0)
• Yarn (4.9.1)
• PostgreSQL (17.5)
• Meilisearch (1.15.2)
• Redis (Valkey) (8.1)

المنافذ والخدمات

يمكنك الوصول إلى الخدمات من خلال المنافذ التالية:

• PostgreSQL → 5433 (localhost:5433)
• Meilisearch → 7701 (localhost:7701)
• Redis → 6380 (localhost:6380)

وبمجرّد إيقاف تشغيل خادم التطوير المحلّي من خلال الضغط على Cmd+C أو Ctrl+C، ستتوقف خدمات Docker (PostgreSQL و Meilisearch و Redis) عن العمل تلقائيًا.

⚙️ تجهيز المحرر

أُعِدّ هذا المشروع ليعمل مع محرر VSCode أو ما يشبهه من المحررات مثل Cursor و Windsurf وغيرهما. بمجرّد فتح المشروع في أحد هذه المحررات سيظهر لك إشعار يسألك "هل تريد تثبيت الإضافات المُوصى بها؟"، وإذا ضغطت على زر Install ستبدأ عملية تثبيت الإضافات الموجودة في ملف .vscode/extensions.json.

الإضافات المُوصى بها:

• Ruby LSP
• Rails DB Schema
• Rails I18n
• Tailwind CSS IntelliSense
• vscode-gemfile
• GitLens — Git supercharged
• Mise VSCode
• Stimulus LSP
• Live Preview
• SQLTools
• SQLTools PostgreSQL/Cockroach Driver
• vscode-icons
• Git Blame

كما أن إعدادات جميع هذه الإضافات موجودة مسبقًا في ملف .vscode/settings.json، لذا لا داعي لإعدادها يدويًّا.

💎 المكتبات المستخدمة للغة Ruby

ملاحظة: جميع المكتبات يجب أن تكون مُحددة بإصدار مُعيّن لضمان الاستقرار والتوافق.

المصادقة والأمان

• devise
• devise-i18n
• rack-attack
• rails_cloudflare_turnstile

البحث والأداء والتحسين

• goldiloader
• meilisearch-rails
• oj
• pagy
• sitemap_generator

واجهة المستخدم

• phlex-icons
• phlex-rails
• rails-i18n
• ruby_ui
• tailwind_merge

التطوير والاختبار

• active_record_doctor
• annotaterb
• better_errors
• binding_of_caller
• factory_bot_rails
• hotwire-spark
• i18n-tasks
• rspec-rails
• rubocop-rake
• rubocop-rspec
• rubocop-rspec_rails
• shoulda-matchers
• simplecov-json
• simplecov
• webmock

الإنتاج والمراقبة

• avo
• cloudflare-rails
• memory_profiler
• mission_control-jobs
• pg_query
• pghero
• rack-mini-profiler
• rails_performance
• solid_errors
• stackprof
• strict_ivars

بالإضافة إلى مكتبات إطار عمل Ruby on Rails الأساسية.

🟨 المكتبات المستخدمة للغة JavaScript

ملاحظة: جميع المكتبات يجب أن تكون مُحددة بإصدار مُعيّن لضمان الاستقرار والتوافق.

• @tailwindcss/forms
• @tailwindcss/typography
• tw-animate-css

بالإضافة إلى مكتبات إطار عمل Ruby on Rails الأساسية.

🧪 تشغيل حالات الاختبار

ملاحظة: نسعى في هذا المشروع إلى المحافظة على تغطية كاملة (100%) للشيفرة المصدرية بحالات اختبار دقيقة ومفيدة.

1. شغّل خادم التطوير من خلال تنفيذ الأمر mise dev أو ابدأ تشغيل خدمات Docker الخاصة بالمشروع من خلال تنفيذ الأمر mise docker:start
2. نفّذ الأمر CI=1 bundle exec rspec لتشغيل حالات الاختبار
3. ستحصل على تقرير بنسبة تغطية الشيفرة المصدرية بحالات الاختبار ويمكنك تصفّح التقرير المُفصّل الموجود في coverage/index.html
4. أوقف تشغيل خادم التطوير أو أوقف خدمات Docker إذا كنت شغّلتها من خلال تنفيذ الأمر mise docker:stop