learn.aiPRO
قتيبة محمد
العودة لكافة المسارات
المسار الثاني // هندسة السياقمستوى متوسط • 50 دقيقة

هندسة السياق (Context Engineering)

الذكاء الاصطناعي لا يقرأ أفكارك ولا يعرف هيكل مشروعك إلا إذا قدمته له بطريقة منظمة. تعلّم كيف تحوّل ملفات مشروعك الحقيقية إلى دروع تمنع الهلوسة البرمجية.

ما ستتعلمه في هذه الوحدة:
كيف تمنع الوكيل من اختراع أعمدة وجداول وهمية
ربط معايير القبول (PRD) بالتحقق البرمجي
فصل معمارية الخدمات والـ Middleware بدقة
01

المختبر التفاعلي: تحدي القضاء على الهلوسة

مختبر هندسة السياق (Context Injection Lab)تحدي القضاء على الهلوسة

تغذية ملفات السياق: شاهد كيف تختفي هلوسة الوكيل

انقر على ملفات المشروع أدناه لتفعيلها في سياق الذكاء الاصطناعي، وراقب مؤشرات الدقة وكود الخدمة لحظياً!

دقة المعمارية50%
نسبة الهلوسة50%
تحليل أثر الملفات النشطة على الوكيل:
docs/PRD.md:

✔ الوكيل يلتزم بالمعايير الأربعة المحددة: زر One-Tap، فحص JWT، خطة Free Tier، وجلسة 7 أيام.

architecture/system.arch:

❌ الوكيل يضع استدعاءات Google API وقواعد البيانات مباشرة داخل الـ Route Controller في ملف واحد!

prisma/schema.prisma:

✔ الوكيل يستعلم بدقة: user.googleId و user.sessions ويراعي العلاقة onDelete: Cascade.

rules/business-rules.md:

❌ الوكيل ينشئ مستخدماً مكرراً بنفس البريد ويتسبب في تعارض (Duplicate Email Constraint Error)!

src/auth/auth.service.ts — Dynamic Context Assembly
TYPESCRIPT
// src/auth/auth.service.ts — كود معالج المصادقة
import { Injectable, UnauthorizedException } from '@nestjs/common';
// [CONTEXT: prisma/schema.prisma] - استخدام جداول User و Session الحقيقية

@Injectable()
export class AuthService {
  constructor(private readonly prisma: PrismaService) {}

  async handleGoogleOneTap(token: string) {
    const payload = await this.verifyGoogleToken(token);

    // استعلام مطابق تماماً لجداول Prisma الحقيقية
    let user = await this.prisma.user.findUnique({
      where: { email: payload.email }
    });

    // معايير القبول من PRD: منح خطة Free Tier وإنشاء Session لمدة 7 أيام
    if (!user) {
      user = await this.prisma.user.create({
        data: { email: payload.email, name: payload.name, googleId: payload.sub }
      });
      await this.assignDefaultFreeTier(user.id);
    }

    const session = await this.createSevenDaySession(user.id);
    return { user, sessionToken: session.token };
  }
}
02

مستودع ملفات السياق الحقيقية (Artifacts Library)

تصفح المستندات الستة المعيارية التي يجب أن يحتويها كل مشروع احترافي لتغذية نماذج الذكاء الاصطناعي:

شجرة ملفات المشروع (Context Files)6 مستندات
docs/PRD.md
MARKDOWN
# PRD: Google One-Tap Authentication
Status: Approved | Version: 1.2

## 1. المشكلة
المستخدمون يواجهون نسبة ارتداد 40% عند ملء نموذج التسجيل اليدوي.

## 2. الهدف
توفير تسجيل دخول بضغطة واحدة باستخدام حساب Google وتخزين البيانات فوراً.

## 3. معايير القبول (Acceptance Criteria)
- [x] إظهار زر "تسجيل الدخول باستخدام Google".
- [x] التحقق من صحة JWT Token من خوادم Google.
- [x] إذا كان المستخدم جديداً: إنشاء حساب بخطة مجانية (Free Tier).
- [x] توليد Session Token وإعادة التوجيه للوحة التحكم.
أثر هذا الملف على أداء الذكاء الاصطناعي:

الوكيل يقرأ معايير القبول والهدف، فيبني الميزة المطلوبة بالضبط دون ابتكار حلول لمشاكل غير موجودة.

اختبر فهمك: هندسة السياق

أجب لتأكيد استيعابك لكيفية حماية الكود من أخطاء التخمين:
+50 XP
السؤال 1 من 2النقاط: 0

لماذا يحتاج وكيل الذكاء الاصطناعي لملف prisma/schema.prisma قبل كتابة دوال الاستعلام؟