kreftjs 0.0.19-beta → 0.0.20-beta

package/book/ar/08-background-work.md

@@ -0,0 +1,250 @@
+# الفصل الثامن: العمل في الخلفية: الطوابير والبريد والذاكرة المؤقتة والجدولة
+
+لكل أداة مجلدها في `backend/app/` وأمر `kreft make:` يولّد ملفها:
+
+```js
+await dispatch(new SendWelcome(user))                   // app/Jobs: يعمل في الخلفية (محاولات، وانتظار، وfailed())
+await event(new OrderShipped(order))                    // app/Listeners
+await Mail.to(user).send(new WelcomeMail(user))         // app/Mail: موضوع، نص، html أو markdown({ … })
+await user.notify(new InvoicePaid(invoice))             // app/Notifications: قنوات 'mail' و 'database'
+await Cache.remember('stats', 600, () => loadStats())   // قاعدة بيانات أو ملف أو ذاكرة أو redis (CACHE_STORE)
+const path = await req.file('avatar').store('avatars')  // الرفع؛ Storage.url(path) هو /storage/avatars/…
+```
+
+## المهام (Jobs)
+
+```bash
+kreft make:job SendReport
+```
+
+```js
+// app/Jobs/SendReport.js
+const { Job } = require('kreftjs/server')
+
+class SendReport extends Job {
+  static tries = 3        // أعد المحاولة بعد خطأ، حتى 3 مرات
+  static backoff = 10     // ثوانٍ بين المحاولات
+
+  constructor(data) {
+    super()
+    this.data = data      // النماذج تُخزَّن كمعرّف وتُقرأ من جديد عند التشغيل
+  }
+
+  async handle() {
+    // العمل نفسه
+  }
+
+  failed(error) {
+    // بعد آخر محاولة
+  }
+}
+
+module.exports = SendReport
+```
+
+`Job.dispatch(...)` يعيد كائنًا يمكن تسلسل دوال عليه (`delay(seconds)` و`onQueue(name)`) ثم `await`:
+
+```js
+await SendReport.dispatch(user)
+await SendReport.dispatch(user).delay(60).onQueue('mail')
+```
+
+> **تحذير:** `dispatch` يرسل المهمة عندما تكتب `await` (أو `.then`). استدعاؤه ونسيان `await` لا يرسل شيئًا.
+
+المهام والمستمعون والبريد والإشعارات المضافة للطابور تعمل في الخلفية. `kreft dev` و`kreft serve` يعالجان جدول `jobs` كل ثانية. وللتحكم بالعمّال: `kreft queue:work` و`queue:failed` و`queue:retry all` و`queue:flush`. اختر المشغّل بـ `QUEUE_CONNECTION` (`database` أو `redis` أو `sync`).
+
+- **`sync`**: تشغيل فوري في نفس الطلب. ممتاز للاختبارات.
+- **`database`**: جدول `jobs`. لا شيء إضافي.
+- **`redis`**: الأسرع، ويدعم التأخير. يلزم `REDIS_URL`.
+
+## الأحداث والمستمعون
+
+```js
+// app/Events/OrderPlaced.js
+class OrderPlaced {
+  constructor(order) { this.order = order }
+}
+module.exports = OrderPlaced
+```
+
+```js
+// app/Listeners/LogOrder.js
+class LogOrder {
+  static event = 'OrderPlaced'      // كل مستمع له static event
+  // static queue = true            // شغّله لاحقًا على الطابور
+
+  async handle(event) {
+    console.log(`[order] #${event.order.id}`)
+  }
+}
+module.exports = LogOrder
+```
+
+```js
+await event(new OrderPlaced(order))      // يعمل كل المستمعين لهذا الحدث
+```
+
+الأحداث تفصل "ما حدث" عن "ماذا نفعل بعد ذلك". أضف مستمعًا جديدًا (إرسال رسالة، تحديث إحصاء) دون أن تلمس شيفرة الطلب.
+
+## البريد
+
+```bash
+kreft make:mail OrderReceipt
+```
+
+```js
+// app/Mail/OrderReceipt.js
+const { Mailable } = require('kreftjs/server')
+
+class OrderReceipt extends Mailable {
+  constructor(order) {
+    super()
+    this.order = order
+  }
+
+  build() {
+    return this.subject(`إيصال الطلب #${this.order.id}`).markdown({
+      greeting: 'شكرًا لطلبك',
+      lines: [`المجموع: ${(this.order.total_cents / 100).toFixed(2)} $`],
+      action: { text: 'افتح التطبيق', url: process.env.APP_URL || '/' },
+    })
+  }
+}
+module.exports = OrderReceipt
+```
+
+```js
+await Mail.to(user.email).send(new OrderReceipt(order))        // الآن
+await Mail.to(user.email).queue(new OrderReceipt(order))       // على الطابور
+await Mail.to(user.email).later(600, new OrderReceipt(order))  // بعد 10 دقائق
+```
+
+> **ملاحظة:** حتى تضبط `MAIL_URL` في `.env` تُطبع الرسائل في الطرفية بدل أن تُرسل. وهذا مناسب جدًا للتطوير: ترى الرسالة التي كانت ستصل.
+
+## الذاكرة المؤقتة (Cache)
+
+```js
+const stats = await Cache.remember('stats', 600, () => loadStats())   // احسب مرة كل 10 دقائق
+await Cache.put('k', 'v', 60)
+await Cache.get('k')
+await Cache.forget('k')
+```
+
+متى تُبطل الذاكرة؟ عندما يتغير ما تعتمد عليه:
+
+```js
+async store(req) {
+  const product = await Product.create(await req.validate({ name: 'required' }))
+  await Cache.forget('products:list')          // أبطل القائمة المؤقتة
+  return product
+}
+```
+
+المخازن: `database` أو `file` أو `memory` أو `redis`، بحسب `CACHE_STORE`. `memory` تخص العملية الواحدة؛ لعدة خوادم استعمل `database` أو `redis`.
+
+### الأقفال (Locks)
+
+القفل الذري يضمن أن عملية واحدة فقط تدخل المقطع الحرج:
+
+```js
+// أسلوب الدالة: يُحرَّر القفل وحده
+await Cache.lock('checkout:' + key, 15, async () => {
+  // مقطع لا يدخله إلا واحد في كل مرة (تنتهي صلاحية القفل بعد 15 ثانية)
+})
+
+// أسلوب الكائن
+const lock = await Cache.lock('report', 30)
+if (lock) {
+  try { /* العمل */ } finally { await lock.release() }
+}
+
+// انتظر حتى 5 ثوانٍ للحصول عليه
+await Cache.lock('report', 30).block(5, async () => { /* … */ })
+```
+
+استعمالها الكلاسيكي: منع النقر المزدوج على "ادفع" من إنشاء طلبين (انظر الفصل الثاني عشر).
+
+## الملفات المرفوعة
+
+```js
+const path = await req.file('avatar').store('avatars')
+```
+
+يحفظ باسم عشوائي ولا يثق بالاسم الأصلي أبدًا. فقط الامتدادات المعروفة (صور، PDF، نص، مكتب، صوت، فيديو، أرشيفات) تحتفظ بامتدادها؛ وغيرها يُخزَّن `.bin`. استعمل `file.isImage()` لتفحص ترويسة الملف الحقيقية لا اسمه فقط.
+
+الملفات في القرص العام تُخدَّم من `/storage/…` كتنزيلات بيانات خام، فلا يمكن لـ `.html` أو `.svg` مرفوع أن يشغّل سكربتات في موقعك.
+
+```js
+const url = Storage.url(path)          // /storage/avatars/xxxx.png
+```
+
+## الجدولة (Scheduling)
+
+```js
+// backend/routes/console.js
+Schedule.call(async () => { await Post.onlyTrashed().forceDelete() }).daily().name('clean-trash')
+Schedule.job(new SendReport()).weekdays().at('08:00')
+Schedule.command('send:report Daily').hourly()
+```
+
+`kreft dev` و`kreft serve` يفحصان الجدول كل دقيقة. اضبط `SCHEDULER=off` لتشغّله من cron بـ `kreft schedule:run`؛ و`kreft schedule:list` يعرض ما هو مخطط.
+
+## Redis
+
+لدى Kreft عميل Redis خاص به (RESP2 عبر TCP أو TLS) بلا حزمة إضافية. يعمل مع Redis وValkey وخدمات Redis المستضافة.
+
+```env
+CACHE_STORE=redis
+QUEUE_CONNECTION=redis
+REDIS_URL=rediss://default:secret@host:6379/0      # أو REDIS_HOST وREDIS_PORT وREDIS_USERNAME وREDIS_PASSWORD وREDIS_DB
+REDIS_PREFIX=kreft_
+```
+
+```bash
+kreft redis:ping        # PONG (1ms) — 127.0.0.1:6379/0
+```
+
+Redis يعطيك أيضًا أقفالًا ذرية (`Cache.lock('report', 30)`) والنشر والاشتراك (publish/subscribe).
+
+## الإعدادات
+
+الإعدادات تأتي من `.env` و`backend/config/*.js` والقيم الافتراضية عبر مساعد واحد:
+
+```js
+const { config } = require('kreftjs/server')
+
+config('app.name', 'My app')
+config('database.default', 'sqlite')
+config.has('redis.connections.default')
+config.set('app.debug', false)
+```
+
+## الجلسات وعدم النشاط
+
+طبقتان تخرجان المستخدم الغائب:
+
+```env
+SESSION_LIFETIME=120            # دقائق خمول قبل أن يُسقط الخادم الجلسة
+PUBLIC_SESSION_TIMEOUT=15       # دقائق قبل أن ترسل الصفحة نفسها المستخدم إلى /login
+PUBLIC_SESSION_WARNING=2        # دقائق تحذير قبل ذلك
+AUTH_TOKEN_DAYS=30              # رمز لم يُستعمل هذه الأيام يتوقف
+```
+
+قيم `PUBLIC_` تُنسخ إلى المتصفح (`Kreftjs.env`)؛ لا تضع فيها أسرارًا أبدًا.
+
+## خلف وسيط (Proxy)
+
+عنوان الزائر يأتي من الاتصال. خلف nginx أو Cloudflare أو موزّع أحمال اذكر وسطاءك:
+
+```env
+TRUSTED_PROXIES=10.0.0.1          # أو *
+TRUSTED_PROXY_HOPS=1              # مع *: كم وسيطًا أمامك
+```
+
+`X-Forwarded-For` يُقرأ من اليمين، فلا يستطيع الزائر اختيار عنوانه بنفسه.
+
+## تمارين
+
+1. اجعل تسجيل مستخدم جديد يطلق حدثًا `UserRegistered` له مستمعان: واحد يرسل بريد ترحيب على الطابور، وآخر يزيد عدّادًا في الذاكرة المؤقتة.
+2. اكتب مهمة تحذف الملفات المؤقتة وجدولها كل ليلة الساعة 03:00.
+3. استعمل `Cache.lock` لمنع تشغيل تقرير ثقيل مرتين في آن واحد.

package/book/ar/09-testing-and-deploy.md

@@ -0,0 +1,234 @@
+# الفصل التاسع: الاختبار والبناء والنشر
+
+## اختبار الواجهة الخلفية
+
+تُختبر شيفرة الخادم بمشغّل الاختبارات المدمج في Node وقاعدة SQLite في الذاكرة، فالاختبارات سريعة ولا تمس بياناتك الحقيقية.
+
+```json
+{
+  "scripts": { "test": "node --test \"tests/**/*.test.js\"" }
+}
+```
+
+```js
+// tests/models/post.test.js
+const test = require('node:test')
+const assert = require('node:assert/strict')
+const { createSchema, setConnection } = require('kreftjs/server')
+const { connect } = require('kreft/bin/db.js')
+const Post = require('../../backend/app/Models/Post')
+
+test.before(async () => {
+  const db = await connect('sqlite::memory:')       // قاعدة فارغة جديدة لهذا الملف
+  setConnection(db)
+  await createSchema(db).create('posts', (table) => {
+    table.id()
+    table.string('title')
+    table.timestamps()
+  })
+})
+
+test('a post can be created and found', async () => {
+  const post = await Post.create({ title: 'Hello' })
+  assert.equal((await Post.find(post.id)).title, 'Hello')
+})
+```
+
+لاختبار جداول مشروع كامل شغّل ترحيلاته الحقيقية بدل بناء المخطط يدويًا: `migrator.migrate(db, 'backend/database/migrations')`.
+
+اختبارات المكوّنات للمتصفح تعيش في `frontend/tests/` وتُفتح بـ `kreft dev`.
+
+## الأدوات المرافقة للتطوير
+
+كل ما هنا يأتي مع Kreft:
+
+**إعادة التحميل الفورية.** أثناء `kreft dev` احفظ ملف `.kreft` فيُبدَّل ذلك المكوّن وحده وتبقى حالته. وملف `.css` يُعاد تحميله بلا تحديث للصفحة، والخطأ يعرض طبقة فيها الملف والسطر.
+
+**أدوات Kreft (DevTools).** زر **S** في الزاوية (أو <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd>) يفتح لوحة:
+
+| التبويب | يعرض |
+|---|---|
+| Components | الشجرة الحية. اختر مكوّنًا لترى الخصائص والحالة والقيم المشتقة، وغيّر الحالة هناك. |
+| Stores | قيم كل مخزن (قابلة للتغيير) و`$reset()`. |
+| Route | المسار الحالي وكل المسارات، مع زر للذهاب إليها. |
+| Timeline | أفعال المخازن ورسائل الـ bus حال وقوعها. |
+
+الزر واللوحة موجودان تحت `kreft dev` فقط؛ التطبيقات المبنية لا تحتويهما أبدًا.
+
+### مراقب الأخطاء
+
+في التطوير، خطأ غير ملتقط على الخادم يعرض صفحة تفاعلية بدل رسالة مجردة: مستكشف مكدّس يخفي إطارات المكتبات ويبرز إطاراتك، ومعاينة للشيفرة حول السطر الفاشل، ومحرك اقتراحات للأخطاء الشائعة (خطأ إملائي في دالة نموذج، أو قراءة خاصية من `undefined`، أو جدول مفقود يحتاج `kreft migrate`)، والطلب كاملًا (مع إخفاء كلمات المرور والرموز والكوكيز). وتظهر الصفحة فقط حين `APP_ENV` ليس `production` و`APP_DEBUG` صحيح. **في الإنتاج الخطأ نفسه يجيب `Server error.` ببساطة**، بلا مكدّس أو أسماء ملفات.
+
+## البناء (Build)
+
+```bash
+npm run build      # أو: kreft build
+npm run preview    # افحص النتيجة: kreft dev dist
+```
+
+| الملف | ما هو |
+|---|---|
+| `index.html` | صفحتك، تحمّل الآن الملفات أدناه. |
+| `kreftjs.js` | الإطار. |
+| `app.js` | كل ملفات `.kreft`، مصرّفة. |
+| `app.css` | كل كتل `<style>`؛ المحصورة محصورة فعلًا. |
+| `main.js` | شيفرة `<script>` المضمنة في `index.html`. |
+| `deps/` و`vendor/` | حزم npm وملفات CSS التي تستوردها ملفاتك، مصغّرة. |
+
+ماذا تكسب:
+
+- **أول تحميل أسرع:** يحمّل المتصفح `app.js` واحدًا ولا يصرّف شيئًا.
+- **سياسة CSP صارمة تعمل:** كل تعبير يصير دالة حقيقية، فلا `eval` ولا `new Function` في التطبيق المبني.
+- **أخطاء قبل النشر:** أي خطأ في أي ملف `.kreft` يوقف البناء ويسمي الملف والسطر.
+
+خيارات: `kreft build ./site --out public` يبني مجلدًا آخر، و`--base /` يغيّر `<base href>`. و`--no-htaccess` يتخطى ملف `.htaccess`.
+
+### القاعدة (base) الصحيحة: خطأ شائع جدًا
+
+يحتفظ البناء بوسم `<base href="…">` المكتوب في `index.html` المصدر، ويضبط قواعد `.htaccess` عليه. **إن كان `index.html` المصدر يحمل قاعدة مجلد فرعي** (مثل `<base href="/demo/">` في مشروع `demo`) وأنت ترفع الموقع إلى الجذر، فالنتيجة **صفحة بيضاء**: المتصفح يطلب `/demo/app.js` فلا يجد شيئًا.
+
+الحل: اذكر القاعدة صراحة عند البناء للنشر في الجذر:
+
+```bash
+kreft build --out dist/site --base /
+```
+
+وافحص `index.html` المبني: يجب أن ترى `<base href="/">`. وإن كان موقعك في مجلد فرعي `/blog/` فابنِ بـ `--base /blog/`.
+
+### الرفع إلى استضافة
+
+**استضافة ثابتة: Hostinger وcPanel وأي استضافة Apache.** ارفع ما **داخل** `dist/` (لا المجلد نفسه) إلى المجلد الذي يخدم الموقع، وهو عادة `public_html`. في hPanel من Hostinger: **Files ← File Manager ← public_html ← Upload**، أو استعمل FTP. لا تستعمل مستورِدات "framework" أو "Node.js app" لهذا: فهي تبحث عن `package.json` وتقول *Unsupported framework or invalid project structure* لأن `dist/` فيه ملفات منتهية فقط.
+
+ويكتب `kreft build` ملف `dist/.htaccess`:
+
+```apache
+RewriteEngine On
+RewriteBase /
+RewriteRule ^index\.html$ - [L]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME}/index.html !-f
+RewriteCond %{REQUEST_URI} !^/api/
+RewriteCond %{REQUEST_URI} !\.[A-Za-z0-9]+$
+RewriteRule . /index.html [L]
+```
+
+Apache لا يعرف إلا الملفات الموجودة على القرص، فبدون هذه القواعد يعطي `/docs` أو أي عنوان نظيف خطأ 404 عند فتحه أو إعادة تحميله. ومعها، كل عنوان صفحة (بلا امتداد وليس تحت `/api/`) ليس ملفًا حقيقيًا يفتح `index.html` ويتولى الموجِّه الباقي. ارفع الملف أيضًا (يبدأ بنقطة فبعض مديري الملفات يخفونه؛ فعّل "show hidden files").
+
+ويضع `kreft build` أيضًا بصمة قصيرة في عنوان كل سكربت وملف أنماط (`app.js?v=28a965f6`)، ويطلب `.htaccess` من الاستضافة ألا تحتفظ بـ `index.html`. الاستضافات تخزّن `.js` و`.css` أيامًا، فبدون البصمة يظل الزوار يشغّلون الإطار والصفحات القديمة بعد رفع بناء جديد.
+
+> **ملاحظة:** هذا يستضيف الواجهة الأمامية فقط. تسجيل الدخول وقاعدة البيانات وكل ما تحت `/api` يحتاج خادم Node.js الذي لا يشغّله Apache.
+
+**خطة Node.js أو VPS.** ارفع المشروع كله (بلا `node_modules`)، لا `dist/`. أضف Kreft إلى اعتماداتك بـ `npm i kreftjs`، وابنِ بـ `npm run build`، وشغّل الخادم بـ `npm run serve` (يقرأ `PORT` الذي تضبطه استضافتك). سكربت `start` المولَّد يشغّل خادم التطوير فلا تستعمله في الإنتاج.
+
+على VPS أبقِه يعمل بـ PM2 وضع nginx أمامه للنطاق وHTTPS:
+
+```bash
+npm install && npm run build
+npm i -g pm2
+pm2 start "npm run serve" --name my-app && pm2 save
+```
+
+```nginx
+server {
+    server_name example.com;
+    location / {
+        proxy_pass http://127.0.0.1:8000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+ثم `sudo certbot --nginx -d example.com` يضيف HTTPS. اضبط `APP_ENV=production` و`APP_KEY` حقيقيًا في `.env` أولًا، وراجع [قائمة الفحص](07-auth-and-security.md).
+
+## تحسين محركات البحث (SEO)
+
+### صفحات HTML جاهزة: `--prerender`
+
+```bash
+npm i -D jsdom                              # مرة لكل مشروع
+kreft build --prerender                       # كل مسار بلا :params
+kreft build --prerender /users/1,/users/2     # وهذه العناوين أيضًا
+```
+
+كل صفحة تُفتح في متصفح محاكى، وتُحمَّل بياناتها، وتُحفظ النتيجة في `dist/<page>/index.html`، فيحصل الزوار ومحركات البحث على HTML منتهٍ.
+
+الوسوم التي تضعها الصفحة بـ `.seo({...})` أو `meta` (الوصف، وcanonical، وOpen Graph، وTwitter، وhreflang، وJSON-LD، و`lang` و`dir`) تُحفظ في HTML الصفحة أيضًا، فتراها معاينات الروابط والزواحف التي لا تشغّل JavaScript.
+
+### SEO لصفحات تأتي من قاعدة بياناتك: `backend/routes/seo.js`
+
+```js
+// backend/routes/seo.js
+const Post = require('../app/Models/Post')
+
+module.exports = {
+  '/': { title: 'متجري', description: 'كل ما يحتاجه البيت' },
+  '/blog/:slug': async ({ slug }) => {
+    const post = await Post.query().published().where('slug', slug).first()
+    if (!post) return null                  // 404 حقيقي مع noindex
+    return {
+      title: post.title,
+      description: String(post.body || '').slice(0, 150),
+      schema: { '@type': 'Article', headline: post.title },
+    }
+  },
+  // عناوين صفحات بياناتك، لـ `kreft sitemap`
+  urls: async () => (await Post.query().published().get()).map((p) => ({ path: '/blog/' + p.slug, lastmod: p.updated_at })),
+}
+```
+
+`kreft dev` و`kreft serve` يجيبان طلب الصفحة بـ `index.html` مع وسوم أول عنوان مطابق. واضبط `APP_URL` لتحصل كل صفحة على `canonical`.
+
+### صفحات كاملة للزواحف
+
+الزاحف أو معاينة الرابط (Googlebot وBingbot وWhatsApp وFacebook وX وTelegram …) الذي لا يشغّل JavaScript سيرى `<div id="app">` فارغًا. لهؤلاء يفتح `kreft dev` و`kreft serve` الصفحة في المتصفح المحاكى نفسه، وينتظر تحميل بياناتها، ويجيب بالصفحة مرسومة.
+
+```bash
+npm i -D jsdom        # مرة لكل مشروع
+KREFT_SSR=bots          # الافتراضي: الزواحف ومعاينات الروابط فقط
+KREFT_SSR=all           # كل زائر
+KREFT_SSR=off           # أبدًا
+KREFT_SSR_TTL=300       # ثوانٍ تحتفظ فيها بالصفحة المرسومة
+```
+
+### خريطة الموقع وrobots.txt
+
+```bash
+kreft sitemap --url https://example.com                  # public/sitemap.xml و public/robots.txt
+kreft sitemap --url https://example.com --urls urls.js   # مع العناوين في ذلك الملف
+```
+
+## نشر الواجهة الخلفية
+
+```bash
+NODE_ENV=production kreft serve dist
+```
+
+وقبلها أنجز [قائمة الفحص قبل الإنتاج](07-auth-and-security.md).
+
+## TypeScript
+
+يعمل TypeScript في المتصفح (ملفات `.kreft` ووحدات `.ts`) وعلى الخادم (`routes/api.ts` و`app/**/*.ts` والترحيلات والبذور).
+
+```bash
+kreft new my-app --ts
+```
+
+داخل ملف `.kreft` يمكنك كتابة `interface` و`type` و`enum` و`import type`، و`prop` و`state` و`derive` و`saved` بأنواعها. والتنفيذ لا يحتاج إعدادًا: يستعمل Kreft الأداة `esbuild` إن وُجدت، وإلا إزالة الأنواع المدمجة في Node (22.6+)، وإلا مزيله الخاص بلا اعتماديات.
+
+## تصحيح المشاكل الشائعة
+
+| العَرَض | السبب المرجح | الحل |
+|---|---|---|
+| صفحة بيضاء بعد الرفع | `<base href>` خاطئ في `index.html` | ابنِ بـ `--base /` وأعد الرفع |
+| `/docs` يعطي 404 عند التحديث | ملف `.htaccess` لم يُرفع | ارفعه (أظهر الملفات المخفية) |
+| بقاء النسخة القديمة بعد الرفع | تخزين المتصفح أو الاستضافة | تأكد من رفع كل الملفات الجديدة بالبصمات |
+| `no such table: …` | ترحيل جديد لم يُنفَّذ | `kreft migrate` |
+| لا شيء يتغير في الصفحة | سطر `const` في السكربت | استعمل `state` أو `derive` |
+| الإرسال لا يعمل مع `type="email"` | تحقق المتصفح الأصلي يسبق Kreft | أضف `novalidate` إلى `<form>` |
+
+## تمارين
+
+1. ابنِ تطبيقك بـ `--base /` وافتح `dist/index.html` وتحقق من وسم `<base>`.
+2. أضف `backend/routes/seo.js` لمدونتك وافتح صفحة مقال بمتصفح يحاكي زاحفًا: `curl -A Googlebot …`.
+3. اكتب اختبار نموذج لـ `Product` يتحقق من أن `scopeInStock` يستثني المنتجات التي مخزونها صفر.