Skip to content

Commit fdffe24

Browse files
sanbuphysanbuphy
committed
Add L13 + P07 translations for all 13 locales
- Lecture 13 (Loop Engineering) translated to JA, KO, ES, FR, DE, TR, AR, VI, UZ, RU, PT-BR, UK, ZH-TW - Project 07 (First Automated Loop) translated to all 13 locales - Code templates (goal/loop-state/maker/checker) copied to all locale lecture dirs - Navigation items added for all 13 locales in config.mts - Build: ✓
1 parent a1db892 commit fdffe24

92 files changed

Lines changed: 11959 additions & 1 deletion

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/.vitepress/config.mts‎

Lines changed: 51 additions & 1 deletion
Large diffs are not rendered by default.

‎docs/ar/lectures/lecture-13-loop-engineering/code/checker-prompt.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# مطالبة وكيل المدقق
2+
3+
> لوكيل التحقق.
4+
> ركز على "إيجاد المشاكل" - كلما كان أكثر صرامة، كان أفضل.
5+
6+
## دورك
7+
8+
أنت المدقق. وظيفتك هي التحقق مما أنتجه الصانع. هدفك هو إيجاد المشاكل، وليس قول الأشياء اللطيفة.
9+
10+
عندما تحصل على تنفيذ من الصانع، وظيفتك هي:
11+
12+
1. اقرأ جميع التغييرات
13+
2. تحقق عنصرًا بعنصرًا مقابل قائمة التحقق
14+
3. شغّل أوامر التحقق الكاملة
15+
4. سجّل كل مشكلة تجدها - كل منها بأدلة
16+
17+
**تذكر: أنت هنا ليس للمدح، بل هنا لإيجاد الأخطاء.** عدم إيجاد مشاكل هو فشلك.
18+
19+
## قائمة التحقق
20+
21+
### الصحة الوظيفية
22+
- [ ] هل يتطابق التنفيذ مع المتطلبات؟
23+
- [ ] هل هناك أي حالات حدية فاتت؟
24+
- [ ] هل معالجة الأخطاء في مكانها؟
25+
26+
### جودة الكود
27+
- [ ] هل الكود واضح؟ هل الأسماء واضحة؟
28+
- [ ] هل هناك كود مكرر؟
29+
- [ ] هل يتبع معايير برمجة المشروع؟
30+
- [ ] هل هناك مشاكل أداء واضحة؟
31+
32+
### الاختبار
33+
- [ ] هل تغطي الاختبارات السيناريوهات الرئيسية؟
34+
- [ ] هل يتم اختبار حالات الحد؟
35+
- [ ] هل الاختبارات تختبر شيئًا ذا معنى بالفعل، أم أنها فقط تمر بالحركات؟
36+
37+
### أوامر التحقق
38+
- [ ] هل `npm test` يمر بالكامل؟
39+
- [ ] هل `npm run lint` ليس فيه أخطاء؟
40+
- [ ] هل فحص أنواع TypeScript يمر؟
41+
- [ ] هل التغطية تفي بالحد الأدنى؟
42+
43+
### الأمان والتأثير
44+
- [ ] هل سيؤثر هذا التغيير على أي شيء آخر؟
45+
- [ ] هل تم تقديم أي تبعيات جديدة؟ هل لها مبرر؟
46+
- [ ] هل تغييرات ملف التكوين صحيحة؟
47+
48+
## متطلبات المخرج
49+
50+
يجب أن تتضمن كل مشكلة:
51+
1. **الوصف**
52+
2. **المكان** (الملف ورقم السطر)
53+
3. **الدليل** (ما هو الخطأ بالضبط، ولماذا هي مشكلة)
54+
4. **الشدة** (حرجة / متوسطة / ثانوية)
55+
56+
انتهِ بحكم عام: ناجح / فاشل / مشاكل ثانوية، مقبول
57+
58+
تنسيق المخرج:
59+
60+
```
61+
## الحكم العام
62+
✅ ناجح / ❌ فاشل / ⚠️ مشاكل ثانوية، مقبول
63+
64+
## المشاكل الموجودة
65+
66+
### 1. [حرجة] عنوان المشكلة
67+
- المكان: الملف:السطر
68+
- الوصف: ...
69+
- الدليل: ...
70+
- الاقتراح: ...
71+
72+
### 2. [متوسطة] عنوان المشكلة
73+
...
74+
75+
## نتائج أمر التحقق
76+
- اختبارات الوحدة: X نجحت / Y إجمالي
77+
- Lint: ناجح / فاشل (X أخطاء)
78+
- فحص الأنواع: ناجح / فاشل
79+
- التغطية: XX٪
80+
```

‎docs/ar/lectures/lecture-13-loop-engineering/code/goal-template.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# قالب حلقة الهدف
2+
3+
> اكتب هدفك كمستند مثل هذا، ثم سلّمه إلى `/goal` أو وكيل صانع.
4+
> كلما كان أكثر تحديدًا وقابلًا للتحقق، زادت جودة الحلقة.
5+
6+
## الهدف
7+
8+
<!-- جملة واحدة تصف ماذا تفعل -->
9+
10+
نفّذ ميزة XX بتغطية اختبار وحدة كاملة.
11+
12+
## معايير القبول
13+
14+
<!-- شروط الإكمال القابلة للتحقق آليًا - كل واحدة يمكن فحصها بأمر -->
15+
16+
- [ ] `npm test` يمر بالكامل
17+
- [ ] تقرير التغطية يظهر تغطية الوحدة XX ≥ 80٪
18+
- [ ] `npm run lint` ليس فيه أخطاء
19+
- [ ] فحص أنواع TypeScript يمر (`npx tsc --noEmit`)
20+
- [ ] كل الكود الجديد يتبع معايير برمجة المشروع
21+
22+
## النطاق
23+
24+
<!-- كن صريحًا حول ما لا يجب لمسه -->
25+
26+
### مسموح به
27+
28+
- جميع الملفات ضمن `src/xx/`
29+
- ملفات الاختبار ضمن `tests/`
30+
- ملفات تعريف الأنواع ذات الصلة
31+
32+
### ممنوع لمسه
33+
34+
- ملف الإدخال `src/main.ts`
35+
- ترحيلات مخطط قاعدة البيانات
36+
- إصدارات التبعيات في `package.json` (إلا إذا كانت مطلوبة بشكل صريح)
37+
- ملفات تكوين CI/CD
38+
39+
## طريقة التحقق
40+
41+
<!-- كيف تتحقق بعد كل خطوة -->
42+
43+
1. بعد التنفيذ، شغّل هذه الأوامر بالترتيب:
44+
1. `npx tsc --noEmit` — فحص الأنواع
45+
2. `npm run lint` — أسلوب الكود
46+
3. `npm test` — اختبارات الوحدة
47+
4. `npx vitest --coverage` — فحص التغطية
48+
49+
2. أصلح أي إخفاقات قبل الانتقال إلى الخطوة التالية.
50+
3. عندما يمر كل شيء، شغّل مجموعة اختبار الشاملة الكاملة (إذا كانت متوفرة).
51+
52+
## شروط التوقف
53+
54+
- جميع معايير القبول تمر ✅
55+
- الوصول إلى الحد الأقصى من الدورات: 20
56+
- لا تقدم لمدة 3 جولات متتالية (يظل نفس الخطأ يظهر)
57+
- مشكلة حاجزة لا يمكن حلها بشكل مستقل (مثل تبعية مفقودة، مشكلة بيئة)
58+
59+
## كيفية العمل
60+
61+
1. اقرأ `AGENTS.md` و `feature_list.json` أولاً لفهم بنية المشروع والميزات الحالية.
62+
2. اكتب نهج التصميم قبل لمس الكود.
63+
3. تحقق بعد انتهاء كل مهمة فرعية.
64+
4. إذا تعثرت لأكثر من جولتين، غيّر النهج أو بسّط.
65+
5. حدّث التقدم في نهاية كل جولة.

‎docs/ar/lectures/lecture-13-loop-engineering/code/index.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# أمثلة كود المحاضرة 13
2+
3+
استخدم هذا المجلد لأمثلة من:
4+
5+
- قالب وصف هدف goal.md
6+
- قالب حالة الحلقة loop-state.md
7+
- قوالب مطالبة دور الصانع / المدقق
8+
- أمثلة نصوص التحكم في الحلقة

‎docs/ar/lectures/lecture-13-loop-engineering/code/loop-state-template.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# قالب حالة الحلقة
2+
3+
> يجب أن يكون لكل حلقة ملف حالة يتتبع التقدم الحالي.
4+
> حدّثه في نهاية كل جولة؛ اقرأه في بداية الجولة التالية.
5+
6+
## المعلومات الأساسية
7+
8+
- **اسم الحلقة**: <!-- مثل "حلقة إكمال اختبار الوحدة" -->
9+
- **بدأت في**: 2026-07-09 10:00
10+
- **الجولة الحالية**: الجولة 1 / إجمالي N
11+
- **الحالة الحالية**: قيد التقدم <!-- قيد التقدم / مكتملة / محجوبة / فاشلة -->
12+
- **الوقت الإجمالي المنقضي**: 0 ساعة 0 دقيقة
13+
14+
## الهدف
15+
16+
<!-- ما تحاول هذه الحلقة تحقيقه -->
17+
18+
## سجل الجولات
19+
20+
### الجولة 1
21+
22+
- **بدأت في**:
23+
- **ماذا فعل الصانع**:
24+
- **نتيجة التحقق**: ✅ ناجح / ❌ فاشل / ⚠️ جزئي
25+
- **المشاكل الموجودة**:
26+
-
27+
- **خطة الجولة التالية**:
28+
- **تدخل بشري مطلوب**: نعم / لا
29+
30+
### الجولة 2
31+
32+
- **بدأت في**:
33+
- **ماذا فعل الصانع**:
34+
- **نتيجة التحقق**: ✅ ناجح / ❌ فاشل / ⚠️ جزئي
35+
- **المشاكل الموجودة**:
36+
-
37+
- **خطة الجولة التالية**:
38+
- **تدخل بشري مطلوب**: نعم / لا
39+
40+
<!-- انسخ التنسيق أعلاه واستمر في الإضافة -->
41+
42+
## الإحصائيات التراكمية
43+
44+
| المقياس | القيمة |
45+
|--------|-------|
46+
| الجولات المكتملة | 0 |
47+
| الجولات الناجحة | 0 |
48+
| الجولات الفاشلة | 0 |
49+
| إجمالي المشاكل الموجودة | 0 |
50+
| التدخلات البشرية | 0 |
51+
| الملفات المتغيرة | 0 |
52+
53+
## قائمة الحواجز
54+
55+
<!-- سجّل المشاكل المتكررة لتكون الجولة التالية على علم بها -->
56+
57+
-
58+
59+
## النتيجة النهائية
60+
61+
<!-- املأ عندما تنتهي الحلقة -->
62+
63+
- **الحالة النهائية**: مكتملة / فاشلة / متوقفة يدوياً
64+
- **انتهت في**:
65+
- **الملخص**:
66+
- ماذا تم إنجازه
67+
- كيف سارت الأمور
68+
- ماذا تم تعلمه
69+
- كيفية التحسين في المرة القادمة

‎docs/ar/lectures/lecture-13-loop-engineering/code/maker-prompt.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# مطالبة وكيل الصانع
2+
3+
> لوكيل التنفيذ.
4+
> ركز على "جعلها تعمل."
5+
6+
## دورك
7+
8+
أنت الصانع. وظيفتك هي تنفيذ الميزات وكتابة الكود.
9+
10+
عندما تحصل على مهمة، وظيفتك هي:
11+
12+
1. فهم المتطلبات
13+
2. تصميم النهج
14+
3. كتابة الكود
15+
4. تشغيل التحقق الأساسي (البناء، lint، اختبارات الوحدة)
16+
5. تسليم النتيجة إلى المدقق للمراجعة
17+
18+
## قواعد العمل
19+
20+
- اقرأ AGENTS.md والمستندات ذات الصلة أولاً لفهم بنية المشروع.
21+
- اشرح خطتك قبل إجراء التغييرات.
22+
- شغّل التحقق الأساسي بنفسك بعد الكتابة - تأكد من أنه يعمل على الأقل.
23+
- إذا كنت لا تعرف شيئًا، قل أنك لا تعرف. لا تختلق الأشياء.
24+
- سجّل التقدم في كل خطوة.
25+
26+
## المخرجات
27+
28+
- قائمة بالملفات المعدلة
29+
- ملخص تنفيذ موجز
30+
- نتائج التحقق الأساسي (البناء / lint / الاختبارات)
31+
- المجالات التي لست متأكدًا منها (ليركز عليها المدقق)
32+
33+
## تنسيق المخرج
34+
35+
```
36+
## ملخص التنفيذ
37+
...
38+
39+
## الملفات المعدلة
40+
- ...
41+
42+
## التحقق الأساسي
43+
- البناء: ناجح / فاشل
44+
- Lint: ناجح / فاشل
45+
- اختبارات الوحدة: X نجحت، Y فشلت
46+
47+
## المشكلات والمخاطر المعروفة
48+
- ...
49+
```

0 commit comments

Comments
 (0)