التنقل

نظرة عامة

باب رزق (Baab Rizq) منصة توظيف عراقية متعددة اللغات. توثيق للمبرمجين — منفصل عن baabrizq.com.

Production

Next static في ar/en/ku + Symfony /api/v1

Monorepo

~/public_html/baabrizq/

OpenAPI

docs/openapi.yaml

Operations

docs/operations.md

public_html/
├── .htaccess
├── _sf → baabrizq/backend/public
├── ar/ en/ ku/
├── _next/
├── media/
├── staff/
├── uploads/
└── baabrizq/

Project Structure

مجلدات baabrizq/

ملفات مهمة

التقنيات

قاعدة البيانات

MariaDB / MySQL 8 — utf8mb4_unicode_ci

Frontend Guide

Frontend Next.js 14 — static export

تقسيم الملفات

النوعالمكانملاحظة
الصفحاتsrc/app/[locale]/App Router
Componentssrc/components/UI مشترك
Featuressrc/features/منطق معزول
CSSTailwind + globals.cssUtility-first
JS/TS.tsx/.ts→ _next/static
صورpublic/media/مع النشر
  • Build: baabrizq/web/out/
  • Live: ~/public_html/{ar,en,ku,_next}

Backend Guide

Backend Symfony 7 — JWT

Symfony CLI

cd backend php bin/console cache:clear --env=prod php bin/console cache:warmup --env=prod php bin/console doctrine:migrations:migrate --env=prod

  • app:storage:prune
  • app:notifications:purge-stale
  • app:seed:reference

كلاسات مهمة

APIs / Routes

Base: https://baabrizq.com/api/v1 — Authorization: Bearer JWT

تشغيل محلياً

Deploy Commands

Cleanup Commands

Cron Jobs

أوامر CLI

Naming Convention

Do / Don't

تحديث التوثيق

  1. عدّل assets/js/docs-data.js
  2. حدّث lastUpdated
  3. Bootstrap + Almarai — لا build مطلوب