kreftjs 0.0.17-beta → 0.0.20-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -0
- package/bin/build.js +13 -2
- package/bin/electron.js +61 -2
- package/bin/kreftjs.js +5 -3
- package/book/ar/01-getting-started.md +169 -0
- package/book/ar/02-language.md +330 -0
- package/book/ar/03-components-and-state.md +258 -0
- package/book/ar/04-router-data-forms.md +333 -0
- package/book/ar/05-arabic-rtl.md +175 -0
- package/book/ar/06-backend.md +247 -0
- package/book/ar/07-auth-and-security.md +157 -0
- package/book/ar/08-background-work.md +250 -0
- package/book/ar/09-testing-and-deploy.md +234 -0
- package/book/ar/10-electron-desktop.md +258 -0
- package/book/ar/11-advanced-blog.md +370 -0
- package/book/ar/12-advanced-shop.md +426 -0
- package/book/ar/13-advanced-ui.md +440 -0
- package/book/ar/14-advanced-ops.md +167 -0
- package/book/ar/15-appendix.md +81 -0
- package/book/ar/README.md +62 -0
- package/book/kreft-book-ar.docx +0 -0
- package/docs/README.md +43 -8
- package/kreftjs.d.ts +1 -1
- package/kreftjs.js +436 -74
- package/package.json +4 -3
- package/templates/app/frontend/errors/ErrorMonitor.kreft +2 -2
- package/templates/app/frontend/kreftjs.d.ts +1 -1
- package/templates/app/frontend/kreftjs.js +436 -74
- package/templates/app/frontend/pages/Dashboard.kreft +1 -1
- package/templates/errors/ErrorMonitor.kreft +1 -1
|
@@ -0,0 +1,426 @@
|
|
|
1
|
+
# الفصل الثاني عشر (متقدم): متجر إلكتروني كامل
|
|
2
|
+
|
|
3
|
+
متجر فيه منتجات وسلة ودفع آمن. التركيز على ما يفرّق التطبيق الجاد عن التجريبي: **معاملة قاعدة بيانات** (الكل أو لا شيء)، و**مفتاح عدم التكرار** (idempotency)، و**أقفال** ضد النقر المزدوج، و**أحداث** و**بريد على الطابور**، و**ذاكرة مؤقتة** للقوائم. كل ما هنا جُرِّب فعلًا بطلبات حقيقية وبمتصفح.
|
|
4
|
+
|
|
5
|
+
## تصميم المال: أعداد صحيحة
|
|
6
|
+
|
|
7
|
+
لا تخزّن الأسعار كأعداد عشرية (`0.1 + 0.2 !== 0.3`). خزّنها **بالسنتات** (أعداد صحيحة)، واقسم على 100 عند العرض فقط.
|
|
8
|
+
|
|
9
|
+
## الخطوة 1: الجداول
|
|
10
|
+
|
|
11
|
+
```js
|
|
12
|
+
module.exports = {
|
|
13
|
+
up(schema) {
|
|
14
|
+
schema.create('products', (table) => {
|
|
15
|
+
table.id()
|
|
16
|
+
table.string('name', 120)
|
|
17
|
+
table.integer('price_cents') // المال بالسنتات: أعداد صحيحة لا كسور
|
|
18
|
+
table.integer('stock').default(0)
|
|
19
|
+
table.timestamps()
|
|
20
|
+
})
|
|
21
|
+
|
|
22
|
+
schema.create('orders', (table) => {
|
|
23
|
+
table.id()
|
|
24
|
+
table.string('email', 190)
|
|
25
|
+
table.string('status', 20).default('pending')
|
|
26
|
+
table.integer('total_cents').default(0)
|
|
27
|
+
table.string('idempotency_key', 80).nullable().unique()
|
|
28
|
+
table.timestamps()
|
|
29
|
+
})
|
|
30
|
+
|
|
31
|
+
schema.create('order_items', (table) => {
|
|
32
|
+
table.id()
|
|
33
|
+
table.foreignId('order_id').constrained().cascadeOnDelete()
|
|
34
|
+
table.foreignId('product_id').constrained()
|
|
35
|
+
table.integer('qty')
|
|
36
|
+
table.integer('price_cents')
|
|
37
|
+
table.timestamps()
|
|
38
|
+
})
|
|
39
|
+
},
|
|
40
|
+
|
|
41
|
+
down(schema) {
|
|
42
|
+
schema.dropIfExists('order_items')
|
|
43
|
+
schema.dropIfExists('orders')
|
|
44
|
+
schema.dropIfExists('products')
|
|
45
|
+
},
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- `idempotency_key` فريد و`nullable`: يمنع تكرار الطلب نفسه.
|
|
50
|
+
- `price_cents` في `order_items` **نسخة** من سعر المنتج وقت الشراء؛ فتغيّر السعر لاحقًا لا يغيّر الطلبات القديمة.
|
|
51
|
+
|
|
52
|
+
## الخطوة 2: النماذج
|
|
53
|
+
|
|
54
|
+
```js
|
|
55
|
+
const { Model } = require('kreftjs/server')
|
|
56
|
+
|
|
57
|
+
class Product extends Model {
|
|
58
|
+
static fillable = ['name', 'price_cents', 'stock']
|
|
59
|
+
|
|
60
|
+
static scopeInStock(q) { q.where('stock', '>', 0) }
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
module.exports = Product
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
```js
|
|
67
|
+
const { Model } = require('kreftjs/server')
|
|
68
|
+
|
|
69
|
+
class Order extends Model {
|
|
70
|
+
static fillable = ['email', 'status', 'total_cents', 'idempotency_key']
|
|
71
|
+
|
|
72
|
+
items() { return this.hasMany(require('./OrderItem')) }
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
module.exports = Order
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
```js
|
|
79
|
+
const { Model } = require('kreftjs/server')
|
|
80
|
+
|
|
81
|
+
class OrderItem extends Model {
|
|
82
|
+
static fillable = ['order_id', 'product_id', 'qty', 'price_cents']
|
|
83
|
+
|
|
84
|
+
product() { return this.belongsTo(require('./Product')) }
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
module.exports = OrderItem
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## الخطوة 3: الحدث والمستمع والبريد
|
|
91
|
+
|
|
92
|
+
```js
|
|
93
|
+
class OrderPlaced {
|
|
94
|
+
constructor(order) {
|
|
95
|
+
this.order = order
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
module.exports = OrderPlaced
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
```js
|
|
103
|
+
class LogOrder {
|
|
104
|
+
static event = 'OrderPlaced'
|
|
105
|
+
|
|
106
|
+
async handle(event) {
|
|
107
|
+
console.log(`[order] #${event.order.id} total=${event.order.total_cents}`)
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
module.exports = LogOrder
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
```js
|
|
115
|
+
const { Mailable } = require('kreftjs/server')
|
|
116
|
+
|
|
117
|
+
class OrderReceipt extends Mailable {
|
|
118
|
+
constructor(order) {
|
|
119
|
+
super()
|
|
120
|
+
this.order = order
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
build() {
|
|
124
|
+
return this.subject(`إيصال الطلب #${this.order.id}`).markdown({
|
|
125
|
+
greeting: 'شكرًا لطلبك',
|
|
126
|
+
lines: [`المجموع: ${(this.order.total_cents / 100).toFixed(2)} $`],
|
|
127
|
+
})
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
module.exports = OrderReceipt
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
## الخطوة 4: قلب المتجر: متحكم الطلبات
|
|
135
|
+
|
|
136
|
+
```js
|
|
137
|
+
const { abort, response, DB, Cache, event, Mail } = require('kreftjs/server')
|
|
138
|
+
const Product = require('../../Models/Product')
|
|
139
|
+
const Order = require('../../Models/Order')
|
|
140
|
+
const OrderItem = require('../../Models/OrderItem')
|
|
141
|
+
const OrderPlaced = require('../../Events/OrderPlaced')
|
|
142
|
+
const OrderReceipt = require('../../Mail/OrderReceipt')
|
|
143
|
+
|
|
144
|
+
class OrderController {
|
|
145
|
+
async store(req) {
|
|
146
|
+
const data = await req.validate({
|
|
147
|
+
email: 'required|email',
|
|
148
|
+
items: 'required|array|min:1',
|
|
149
|
+
})
|
|
150
|
+
const key = req.header('idempotency-key') || null
|
|
151
|
+
|
|
152
|
+
// قفل واحد لكل مفتاح: النقر المزدوج لا يصنع طلبين
|
|
153
|
+
const { order, fresh } = await Cache.lock('checkout:' + (key || data.email), 15, async () => {
|
|
154
|
+
if (key) {
|
|
155
|
+
const old = await Order.where('idempotency_key', key).first()
|
|
156
|
+
if (old) return { order: old, fresh: false }
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
// الكل أو لا شيء: أي فشل يتراجع عن كل ما سبق
|
|
160
|
+
const created = await DB.transaction(async () => {
|
|
161
|
+
let total = 0
|
|
162
|
+
const lines = []
|
|
163
|
+
for (const row of data.items) {
|
|
164
|
+
const qty = Number(row.qty)
|
|
165
|
+
if (!Number.isInteger(qty) || qty < 1) abort(422, 'الكمية غير صالحة')
|
|
166
|
+
const product = await Product.findOrFail(row.product_id)
|
|
167
|
+
if (product.stock < qty) abort(409, `نفد من المخزون: ${product.name}`)
|
|
168
|
+
await product.decrement('stock', qty)
|
|
169
|
+
total += product.price_cents * qty
|
|
170
|
+
lines.push({ product_id: product.id, qty, price_cents: product.price_cents })
|
|
171
|
+
}
|
|
172
|
+
const made = await Order.create({ email: data.email, total_cents: total, idempotency_key: key })
|
|
173
|
+
for (const line of lines) await OrderItem.create({ ...line, order_id: made.id })
|
|
174
|
+
return made
|
|
175
|
+
})
|
|
176
|
+
return { order: created, fresh: true }
|
|
177
|
+
})
|
|
178
|
+
|
|
179
|
+
if (fresh) { // إعادة الإرسال بالمفتاح نفسه لا تكرر الحدث ولا البريد
|
|
180
|
+
await event(new OrderPlaced(order))
|
|
181
|
+
await Mail.to(order.email).queue(new OrderReceipt(order))
|
|
182
|
+
}
|
|
183
|
+
return response(await Order.query().with('items.product').findOrFail(order.id), 201)
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
async show(req, id) {
|
|
187
|
+
return Order.query().with('items.product').findOrFail(id)
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
module.exports = OrderController
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
لنقرأه بتأنٍّ:
|
|
195
|
+
|
|
196
|
+
1. **التحقق:** `email` صالح و`items` مصفوفة غير فارغة. تفاصيل كل عنصر نتحقق منها بأنفسنا لأننا نحتاج رسائل بعينها.
|
|
197
|
+
2. **القفل `Cache.lock(name, 15, callback)`:** مفتاح القفل هو `Idempotency-Key` أو البريد. إن ضغط العميل "ادفع" مرتين بسرعة يدخل المقطع الحرج واحد فقط في كل مرة، ويُحرَّر القفل تلقائيًا.
|
|
198
|
+
3. **التكرار:** داخل القفل نبحث عن طلب بالمفتاح نفسه. إن وُجد نُرجعه دون إنشاء جديد، ونضع `fresh: false`.
|
|
199
|
+
4. **المعاملة `DB.transaction`:** نخصم المخزون لكل صنف، فإن نفد صنف في منتصف السلة نرمي `abort(409)` فيتراجع **كل** ما سبق، ومنه الأصناف التي خُصمت قبله.
|
|
200
|
+
5. **بعد النجاح فقط** (`fresh`): نطلق الحدث ونضع البريد على الطابور. وهذا خطأ شائع: لو أطلقنا الحدث والبريد حتى عند إعادة الإرسال بالمفتاح نفسه لوصل الإيصال مرتين. العلامة `fresh` تمنع ذلك (اختبرنا الحالتين).
|
|
201
|
+
|
|
202
|
+
```js
|
|
203
|
+
const { order, fresh } = await Cache.lock(/* … */)
|
|
204
|
+
if (fresh) { // إعادة الإرسال بالمفتاح نفسه لا تكرر الحدث ولا البريد
|
|
205
|
+
await event(new OrderPlaced(order))
|
|
206
|
+
await Mail.to(order.email).queue(new OrderReceipt(order))
|
|
207
|
+
}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### المنتجات مع ذاكرة مؤقتة
|
|
211
|
+
|
|
212
|
+
```js
|
|
213
|
+
const { Cache } = require('kreftjs/server')
|
|
214
|
+
const Product = require('../../Models/Product')
|
|
215
|
+
|
|
216
|
+
class ProductController {
|
|
217
|
+
async index(req) {
|
|
218
|
+
return Cache.remember('products:list', 30, () => Product.query().inStock().orderBy('name').get())
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
module.exports = ProductController
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
`Cache.remember('products:list', 30, fn)` يحسب القائمة مرة كل 30 ثانية مهما كثر الزوار. احرص على إبطالها عند تغيير المنتجات: `await Cache.forget('products:list')`. (الجدير بالذكر أن المخزون المعروض قد يتأخر حتى 30 ثانية، لكن الدفع نفسه يقرأ المخزون الحقيقي من القاعدة دائمًا.)
|
|
226
|
+
|
|
227
|
+
### البذور والمسارات
|
|
228
|
+
|
|
229
|
+
```js
|
|
230
|
+
const { Seeder } = require('kreftjs/server')
|
|
231
|
+
const Product = require('../../app/Models/Product')
|
|
232
|
+
|
|
233
|
+
class DatabaseSeeder extends Seeder {
|
|
234
|
+
async run() {
|
|
235
|
+
await Product.create({ name: 'قهوة عربية', price_cents: 1500, stock: 10 })
|
|
236
|
+
await Product.create({ name: 'تمر سكري', price_cents: 2500, stock: 3 })
|
|
237
|
+
await Product.create({ name: 'عود', price_cents: 9900, stock: 0 })
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
module.exports = DatabaseSeeder
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
```js
|
|
245
|
+
// backend/routes/api.js
|
|
246
|
+
const { Route } = require('kreftjs/server')
|
|
247
|
+
const ProductController = require('../app/Http/Controllers/ProductController')
|
|
248
|
+
const OrderController = require('../app/Http/Controllers/OrderController')
|
|
249
|
+
|
|
250
|
+
Route.get('/products', [ProductController, 'index'])
|
|
251
|
+
Route.post('/orders', [OrderController, 'store']).middleware('throttle:20,1')
|
|
252
|
+
Route.get('/orders/{order}', [OrderController, 'show'])
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
## نتائج التجربة الفعلية
|
|
256
|
+
|
|
257
|
+
شغّلنا `kreft dev --seed` ثم أرسلنا هذه الطلبات:
|
|
258
|
+
|
|
259
|
+
| التجربة | النتيجة |
|
|
260
|
+
|---|---|
|
|
261
|
+
| طلب عادي | `201` مع الطلب وبنوده ومنتجاته، والمخزون نقص |
|
|
262
|
+
| إعادة الطلب بـ `Idempotency-Key` نفسه | يعيد **الطلب الأول نفسه**، لا طلب جديد، لا خصم، لا بريد |
|
|
263
|
+
| سلة: صنف متوفر + صنف الكمية فيه أكبر من المخزون | `409` برسالة `نفد من المخزون: تمر سكري` **والصنف الأول لم يُخصم** (تراجع كامل) |
|
|
264
|
+
| بريد غير صالح وسلة فارغة | `422` مع رسالتي الحقلين |
|
|
265
|
+
| كمية صفر | `422` برسالة `الكمية غير صالحة` |
|
|
266
|
+
| بعد كل طلب ناجح | سطر `[order] #N` من المستمع، وبريد الإيصال يظهر في الطرفية (مهمة على الطابور) |
|
|
267
|
+
|
|
268
|
+
## الخطوة 5: السلة في المتصفح
|
|
269
|
+
|
|
270
|
+
نعرّف مخزن السلة مرة واحدة في `index.html` ونحفظه بـ `saved: true`:
|
|
271
|
+
|
|
272
|
+
```js
|
|
273
|
+
Kreftjs.store('cart', {
|
|
274
|
+
items: [],
|
|
275
|
+
get count() { return this.items.reduce((n, i) => n + i.qty, 0) },
|
|
276
|
+
get total() { return this.items.reduce((s, i) => s + i.qty * i.price_cents, 0) },
|
|
277
|
+
add(p) {
|
|
278
|
+
const line = this.items.find((i) => i.id === p.id)
|
|
279
|
+
if (line) line.qty++
|
|
280
|
+
else this.items.push({ id: p.id, name: p.name, price_cents: p.price_cents, qty: 1 })
|
|
281
|
+
},
|
|
282
|
+
remove(id) { this.items = this.items.filter((i) => i.id !== id) },
|
|
283
|
+
clear() { this.items = [] },
|
|
284
|
+
}, { saved: true })
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
اختبرنا في المتصفح: الإضافة مرتين لنفس المنتج تزيد `qty`، والسلة تبقى بعد إعادة تحميل الصفحة.
|
|
288
|
+
|
|
289
|
+
### صفحة المتجر
|
|
290
|
+
|
|
291
|
+
```html
|
|
292
|
+
<!-- pages/Shop.kreft -->
|
|
293
|
+
use cart
|
|
294
|
+
|
|
295
|
+
load products = api.get('/api/products')
|
|
296
|
+
|
|
297
|
+
derive money = (cents) => (cents / 100).toFixed(2) + ' $'
|
|
298
|
+
|
|
299
|
+
<view>
|
|
300
|
+
<h1>المتجر</h1>
|
|
301
|
+
|
|
302
|
+
<p k-if="products.loading">جارٍ التحميل…</p>
|
|
303
|
+
<p k-elif="products.error">تعذر التحميل <button @click={products.reload}>حاول مجددًا</button></p>
|
|
304
|
+
<div k-else class="grid">
|
|
305
|
+
{for p in products.data || [] key p.id}
|
|
306
|
+
<article class="card">
|
|
307
|
+
<h3>{p.name}</h3>
|
|
308
|
+
<p>{money(p.price_cents)} · المتوفر: {p.stock}</p>
|
|
309
|
+
<button @click="cart.add(p)">أضف إلى السلة</button>
|
|
310
|
+
</article>
|
|
311
|
+
{empty}
|
|
312
|
+
<p>لا منتجات الآن.</p>
|
|
313
|
+
{/for}
|
|
314
|
+
</div>
|
|
315
|
+
</view>
|
|
316
|
+
|
|
317
|
+
<style scoped>
|
|
318
|
+
.grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(220px, 1fr)); gap: 16px; }
|
|
319
|
+
</style>
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
### صفحة السلة والدفع
|
|
323
|
+
|
|
324
|
+
```html
|
|
325
|
+
<!-- pages/Cart.kreft -->
|
|
326
|
+
use cart
|
|
327
|
+
|
|
328
|
+
state order = null
|
|
329
|
+
state failure = ''
|
|
330
|
+
state key = crypto.randomUUID() // مفتاح واحد لهذه المحاولة: النقر المزدوج لا يكرر الطلب
|
|
331
|
+
state checkout = form({ email: '' }, { email: 'required|email' })
|
|
332
|
+
|
|
333
|
+
derive money = (cents) => (cents / 100).toFixed(2) + ' $'
|
|
334
|
+
|
|
335
|
+
action pay() {
|
|
336
|
+
failure = ''
|
|
337
|
+
let result = false
|
|
338
|
+
try {
|
|
339
|
+
result = await checkout.$submit((values) =>
|
|
340
|
+
api.post('/api/orders', {
|
|
341
|
+
email: values.email,
|
|
342
|
+
items: cart.items.map((i) => ({ product_id: i.id, qty: i.qty })),
|
|
343
|
+
}, { headers: { 'Idempotency-Key': key } })
|
|
344
|
+
)
|
|
345
|
+
} catch (e) {
|
|
346
|
+
failure = e.message // مثل: نفد من المخزون
|
|
347
|
+
key = crypto.randomUUID()
|
|
348
|
+
return
|
|
349
|
+
}
|
|
350
|
+
if (result) {
|
|
351
|
+
order = result
|
|
352
|
+
cart.clear()
|
|
353
|
+
key = crypto.randomUUID()
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
|
|
358
|
+
<view>
|
|
359
|
+
<h1>السلة</h1>
|
|
360
|
+
|
|
361
|
+
<div k-if="order" class="ok">
|
|
362
|
+
تم الطلب رقم #{order.id} · المجموع {money(order.total_cents)}
|
|
363
|
+
</div>
|
|
364
|
+
|
|
365
|
+
<p k-elif="!cart.items.length">السلة فارغة.</p>
|
|
366
|
+
|
|
367
|
+
<div k-else>
|
|
368
|
+
<table>
|
|
369
|
+
<tr k-each="line in cart.items" k-key="line.id">
|
|
370
|
+
<td>{line.name}</td>
|
|
371
|
+
<td>{line.qty} × {money(line.price_cents)}</td>
|
|
372
|
+
<td><button @click="cart.remove(line.id)">حذف</button></td>
|
|
373
|
+
</tr>
|
|
374
|
+
</table>
|
|
375
|
+
<p><b>المجموع: {money(cart.total)}</b></p>
|
|
376
|
+
|
|
377
|
+
<p k-if="failure" class="error">{failure}</p>
|
|
378
|
+
<form novalidate @submit.prevent={pay}>
|
|
379
|
+
<input type="email" dir="ltr" k-model="checkout.email" placeholder="you@example.com">
|
|
380
|
+
<p k-if="checkout.$error('email')" class="error">{checkout.$error('email')}</p>
|
|
381
|
+
<button disabled={checkout.$busy}>أكمل الطلب</button>
|
|
382
|
+
</form>
|
|
383
|
+
</div>
|
|
384
|
+
</view>
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
أشياء تعلّمناها من الاختبار الفعلي:
|
|
388
|
+
|
|
389
|
+
1. **`novalidate` على النموذج.** مع `type="email"` يمنع المتصفح إرسال النموذج قبل أن تعمل قواعد Kreft، فلا تظهر رسالة الخطأ. أضف `novalidate` لتتولى `form()` التحقق.
|
|
390
|
+
2. **`key` ثابت لكل محاولة.** نولّد `crypto.randomUUID()` مرة، فالنقر المزدوج يرسل المفتاح نفسه. وبعد نجاح الدفع أو فشله نولّد مفتاحًا جديدًا.
|
|
391
|
+
3. **أخطاء الخادم غير 422** (كنفاد المخزون `409`) ترميها `$submit`، فنلتقطها بـ `try/catch` ونعرض `e.message`.
|
|
392
|
+
4. **الدفع الناجح** يعرض رقم الطلب ويفرّغ السلة.
|
|
393
|
+
|
|
394
|
+
اختبرناها في المتصفح: بريد خاطئ يعرض رسالة الحقل، ودفع صحيح يعرض "تم الطلب رقم #4 · المجموع 65.00 $" ويفرّغ السلة، وكمية أكبر من المخزون تعرض "نفد من المخزون: تمر سكري".
|
|
395
|
+
|
|
396
|
+
المسارات في `routes/web.kreft`:
|
|
397
|
+
|
|
398
|
+
```js
|
|
399
|
+
Route.view('/shop', 'pages/Shop.kreft').name('shop').title('المتجر')
|
|
400
|
+
Route.view('/cart', 'pages/Cart.kreft').name('cart').title('السلة')
|
|
401
|
+
```
|
|
402
|
+
|
|
403
|
+
## ما الذي ينقص قبل الإنتاج؟
|
|
404
|
+
|
|
405
|
+
هذا مثال تعليمي. قبل متجر حقيقي أضف:
|
|
406
|
+
|
|
407
|
+
- **الدفع الفعلي** عبر مزوّد دفع (Stripe وغيره) مع webhook، ولا تثق بمبلغ يأتي من المتصفح؛ احسبه دائمًا على الخادم كما فعلنا.
|
|
408
|
+
- **المصادقة** على الطلبات وربطها بحساب المستخدم.
|
|
409
|
+
- **قائمة الفحص** في الفصل السابع (HTTPS و`APP_KEY` و`MAIL_URL` و`QUEUE_CONNECTION`).
|
|
410
|
+
- **اختبارات** المعاملة: اختبر أن المخزون لا يتغير عند فشل صنف.
|
|
411
|
+
|
|
412
|
+
## اختبار المعاملة آليًا
|
|
413
|
+
|
|
414
|
+
```js
|
|
415
|
+
// tests/orders.test.js (فكرة)
|
|
416
|
+
const test = require('node:test')
|
|
417
|
+
const assert = require('node:assert/strict')
|
|
418
|
+
// … أعدّ قاعدة في الذاكرة كما في الفصل التاسع، وأنشئ منتجين مخزون الثاني 1
|
|
419
|
+
// ثم حاول طلب (1 من الأول، 5 من الثاني) وتوقّع الرفض، وتأكد أن مخزون الأول لم يتغير.
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
## تمارين
|
|
423
|
+
|
|
424
|
+
1. أضف حالة للطلب (`paid`, `shipped`) وحدثًا `OrderShipped` له مستمع يرسل بريدًا.
|
|
425
|
+
2. أضف مهمة مجدولة تلغي الطلبات `pending` الأقدم من 24 ساعة وتعيد مخزونها داخل معاملة.
|
|
426
|
+
3. أضف صفحة طلباتي بمسار `GET /orders` تحت `auth` وتعرض طلبات المستخدم فقط.
|