🧬 أخبر Lagune بطبيعة مشروعك، فيحوّل ذلك إلى قواعد الأمان الخاصة بك (أو يستنتجها من المشروع وحده إن لم تقدّم وصفًا).
ميثاق الأمان هو الطبقة الحاكمة: مجموعة من المبادئ التي تضع الأمان أولًا وتلتزم بها كل مرحلة لاحقة. اعتبره فحص وقت الترجمة للوضع الأمني لمشروعك.
طريقة الاستخدام
- صِف مشروعك
- دع Lagune يقترح
/lagune-charter مشروعي متجر إلكتروني يبيع ألعاب الفيديو. يضيف العملاء المنتجات إلى سلة التسوق ويدفعون ببطاقة الائتمان أو بقسيمة دفع بنكية. ويمكنهم الاطلاع على طلباتهم وحالة كل طلب.
/lagune-charter
أرى مكتبة دفع، وإعدادًا لتسجيل الدخول، ونموذج طلبات مرتبطًا بالعميل. يبدو هذا متجرًا إلكترونيًا يبيع شيئًا ما. يدفع العملاء ويتابعون طلباتهم... ☁️
ما يستنتجه
يأخذ Lagune وصفك أو مستند PRD كاتجاه، ويستنتج ما يعنيه للأمان، ثم يقرأ المشروع ليتجاوز ما ذكرته. على سبيل المثال:
- سلة تحفظ الطلبات تعني وجود قاعدة بيانات:
- مثل
"أين تُخزَّن البيانات؟"و"من يستطيع الوصول إليها؟"و"هل تتسرّب؟".
- مثل
- عملاء يرون طلباتهم الخاصة يعني وجود نوع من تسجيل الدخول أو التحكم في الوصول:
- مثل
"هل يستطيع عميل الوصول إلى طلبات عميل آخر؟"و"هل الجلسات محمية؟".
- مثل
- قبول الدفع بالبطاقات والقسائم البنكية يعني وجود أموال وبيانات حساسة:
- مثل
"هل تُخزَّن بيانات البطاقات؟"و"هل يُتحقق من المدفوعات؟".
- مثل
وصفك والمشروع يكمّل أحدهما الآخر: وصفك يحدد الغاية، وقراءة الاعتماديات وملف README والإعدادات تكشف ما لم تذكره. وإن بقي أمر مهم غير واضح، يطرح Lagune سؤالًا قصيرًا وبسيطًا بدلًا من التخمين.
ومن هنا يبني Lagune مجموعة قواعد أمان مصممة للمشروع، يمكنك مراجعتها وتعديلها متى احتجت.
- يمكنك أيضًا تحديد قواعد الأمان الخاصة بك للمشروع.
- كلما قدّمت تفاصيل أكثر صلة، كان التقرير النهائي أفضل:
- اشرح المشروع، وكيف يعمل، وما يحدث في الخلفية.
- من المستخدم النهائي؟ ما الذي يستطيع المستخدمون فعله، وما الذي لا يستطيعون؟
- تفاصيل السلوك لا تقل قيمة عن التفاصيل التقنية.
- تُحفظ ذاكرة ميثاق الأمان في
.lagune/memory/charter.md.
الفئات التي يسجّلها
تنضم التخصصات، وهي المعرفة الأمنية التي تحمّلها المراحل اللاحقة عند الحاجة، إلى كتالوج مشروعك حسب الفئة. وما دام مشروعك بلا فئة مسجّلة، يسجّل ميثاق الأمان كل فئة تدعمها قراءته، مثل لغة مشروعك أو استدعاءات LLM أو الحاويات، ويذكرها في ملخصه.
وبعد تسجيل الفئات، يتركها ميثاق الأمان كما هي ولا يذكر إلا فئة لا يستخدمها مشروعك بعد. غيّرها بنفسك في أي وقت:
npx lagune write add --categories python
npx lagune write remove --categories python
المجلدات التي يقترح استثناءها
حين تجد قراءة ميثاق الأمان مجلدات مُضافة إلى المستودع ليست من كود مشروعك الذي يجب الدفاع عنه، مثل بيانات الاختبار المكتوبة لتبدو ضعيفة، يسردها بأرقام في نهاية ملخصه. ولا يستثني أيًا منها من تلقاء نفسه أبدًا، لأن المستودع العدائي قد يجعل كوده يبدو كبيانات اختبار، لذلك لا يُسجَّل إلا الأرقام التي ترد بها. وتشرح صفحة إعداد hooks كيف تغيّرها بنفسك.
التالي
بعد وضع القواعد، ارصد ما يفعله نظامك فعلًا: /lagune-detect.
الأسئلة الشائعة
ميثاق الأمان هو الطبقة الحاكمة في Lagune، وهو مجموعة من المبادئ التي تضع الأمان أولًا وتلتزم بها كل مرحلة لاحقة. اعتبره فحص وقت الترجمة للوضع الأمني لمشروعك.
في .lagune/memory/charter.md.
نعم. يقترح Lagune القواعد من وصفك ومن الكود، ويمكنك إعادة صياغتها أو حذفها أو إضافة غيرها أو تضييق نطاقها.
فقط ما دامت لا توجد فئة مسجّلة. حينها يسجّل كل فئة تدعمها قراءته، مثل لغتك أو استدعاءات LLM. وبعد تسجيل الفئات، لا يغيّرها أبدًا.