مين بيقرا التقرير؟

أهلاً بيك. قبل ما تكتب أي حرف في التقرير، اسأل نفسك سؤال واحد: مين اللي هيقرا الكلام ده؟

عندنا تلات أنواع من القرّاء: الإدارة، زي الـ CEO: عايز يعرف الخطر على البيزنس، والفلوس، والوقت. المطورين: عايزين يعرفوا المشكلة فين بالزبط في الـ code، ويصلّحوها إزاي. وفريق الأمن: عايزين التفاصيل التقنية، وإزاي يكتشفوا الهجوم لو حصل. المدير مش هيفهم كلمة زي UNION SELECT. بس هيفهم كويس جملة زي: بيانات العملا ممكن تتسرق. والمطور مش محتاج قصة طويلة، محتاج اسم الملف ورقم السطر. نشوف نفس الـ Finding، مكتوب لكل قارئ بلغته. نشغّل… نفس المشكلة، بس كل واحد خد الكلام اللي يهمه.

finding = "SQL Injection"

readers = {
    "CEO": "Customer data can be stolen. Fix within 7 days.",
    "Developer": "Use parameterized queries in login.php line 42.",
    "Security team": "CVSS 9.8, exploit with sqlmap, check logs for UNION.",
}

for who, message in readers.items():
    print(who, "->", message)

CEO -> Customer data can be stolen. Fix within 7 days.
Developer -> Use parameterized queries in login.php line 42.
Security team -> CVSS 9.8, exploit with sqlmap, check logs for UNION.

علشان كده التقرير بيتقسم: جزء للإدارة في الأول، اسمه Executive Summary. وجزء تقني بعده، فيه كل Finding بالتفصيل. والقاعدة: اكتب بوضوح، ومن غير مصطلحات مالهاش لازمة. دورك: ضيف قارئ رابع اسمه Auditor، يعني المراجع، واكتب له رسالة عن الـ compliance.

الحل: نشغّل…

finding = "SQL Injection"

readers = {
    "CEO": "Customer data can be stolen. Fix within 7 days.",
    "Developer": "Use parameterized queries in login.php line 42.",
    "Security team": "CVSS 9.8, exploit with sqlmap, check logs for UNION.",
    "Auditor": "Violates PCI DSS requirement 6.",
}

for who, message in readers.items():
    print(who, "->", message)

CEO -> Customer data can be stolen. Fix within 7 days.
Developer -> Use parameterized queries in login.php line 42.
Security team -> CVSS 9.8, exploit with sqlmap, check logs for UNION.
Auditor -> Violates PCI DSS requirement 6.

الدرس الجاي: نبدأ من أول خطوة فعلاً… الـ Notes اللي بتكتبها وإنت شغال. يلا بينا.